Native TRX Transactions

The Tron GasFree wallet module is for gas-free TRC20 token transfers. It does not support native TRX transaction execution or native transaction fee quotes.

For gas-free TRC20 transfers, use transfer(options) and quoteTransfer(options). If you need native TRX transactions, use the base @tetherto/wdk-wallet-tron module instead.

Unsupported Methods

The following native transaction methods exist on the public surface for wallet-interface compatibility, but they throw on Tron GasFree accounts:

• account.sendTransaction(tx) throws "Method 'sendTransaction(tx)' not supported on tron gasfree."
• account.quoteSendTransaction(tx) throws "Method 'quoteSendTransaction(tx)' not supported on tron gasfree."
• account.signTransaction(tx) throws "Method 'signTransaction(tx)' not supported on tron gasfree."

Use Gas-Free Token Transfers Instead

Use quoteTransfer() before executing a gas-free TRC20 transfer:

const quote = await account.quoteTransfer({
  token: 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t',
  recipient: 'TLyqzVGLV1srkB7dToTAEqgDSfPtXRJZYH',
  amount: 1000000
})
console.log('Gas-free transfer fee estimate:', quote.fee, 'token units')

The fee estimate includes the token transfer fee and, when the GasFree account is inactive, the token activation fee returned by the provider.

Next Steps

To transfer TRC20 tokens with gas-free fees, see Transfer TRC20 Tokens.