Send Transactions

This guide explains how to send a gasless transaction, estimate fees, cap transaction fees, reuse a recent quote, and use a custom paymaster token.

Send a Gasless Transaction

You can send a transaction with gas fees paid in the paymaster token using account.sendTransaction():

const result = await account.sendTransaction({
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000n // 0.001 ETH in wei
})
console.log('Transaction hash:', result.hash)
console.log('Fee paid in paymaster token:', result.fee)

Estimate Fees

You can estimate the fee for a transaction without broadcasting it using account.quoteSendTransaction():

const quote = await account.quoteSendTransaction({
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000n
})
console.log('Estimated fee:', quote.fee)

Cap Transaction Fees

Set transactionMaxFee to reject non-sponsored sendTransaction() and signTransaction() operations when the estimated UserOperation fee is above your cap. Use transferMaxFee separately for token transfers.

const result = await account.sendTransaction({
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000n
}, {
  transactionMaxFee: 100000
})

Reuse a Recent Quote

Quotes are cached for up to 2 minutes. If you call sendTransaction() with the same transaction during that window, the account checks the current on-chain nonce before reusing the cached UserOperation. If the nonce has moved, it builds a fresh quote before sending.

const tx = {
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000n
}

const quote = await account.quoteSendTransaction(tx)
console.log('Estimated fee:', quote.fee)

const result = await account.sendTransaction(tx)
console.log('Transaction hash:', result.hash)

Send Rapid Transactions

When you call sendTransaction() or transfer() rapidly from the same account instance, the wallet reserves local nonces so concurrent UserOperations use sequential nonces. If submission fails before bundler acceptance, the reserved nonce is released. If the failure is ambiguous, such as a transport error after submission, the wallet keeps the nonce reserved to avoid accidental reuse.

Send with Custom Paymaster Token

You can override the default paymaster token for a specific transaction by passing a config object to account.sendTransaction():

const result = await account.sendTransaction({
  to: '0x742d35Cc6634C0532925a3b8D4C9db96C4b4d8b6',
  value: 1000000000000000n
}, {
  paymasterToken: {
    address: '0x68749665FF8D2d112Fa859AA293F07A622782F38' // XAUT
  }
})

Next Steps

Learn how to transfer ERC-20 tokens.