Every Tempo feature in this section is in beta and available through the API only. To get access, contact your Customer Success Manager (CSM).
feeCurrency to the Fireblocks asset ID of the stablecoin that should pay the network fee. Leave it out and Tempo picks the fee token itself, using its fee-token preference rules. Fireblocks checks that feeCurrency is a TIP-20 token on the same Tempo network as the transfer, and rejects anything else, including ERC-20 tokens. Tempo enforces the rest on-chain.
POST /v1/operations/tempo/transfer
How Tempo chooses the fee token
Tempo checks the levels below in order and stops at the first one that names a token. See Tempo’s fee specification for the full rules.- Transaction. The transaction’s
fee_tokenfield, which Fireblocks sets fromfeeCurrency. It overrides every other level. - Account. A default the paying account set on-chain. Fireblocks doesn’t set this for vault accounts yet, so this level doesn’t apply today.
- TIP-20 contract. If the transaction is a transfer of a USD TIP-20 token, that token pays the fee.
- Stablecoin DEX. For a swap, the input token pays the fee. Fireblocks doesn’t send DEX swaps on Tempo today.
- Fallback. pathUSD. On newer network versions, Tempo tries pathUSD and then OUSD, and uses the first one that covers the fee.
feeCurrency pays its fee in the token being transferred. An ERC-20 transfer can’t pay fees in its own token, so it falls back to pathUSD and the source must hold pathUSD. To pay the fee for an ERC-20 transfer with another stablecoin, set feeCurrency.
Which tokens are eligible
The fee token must pass these checks at broadcast, or the transaction fails. Tempo doesn’t fall back to a lower level when a check fails.- It’s a TIP-20 token whose currency is USD.
- The paying account holds enough of it to cover the gas limit at the gas price.
- Tempo’s Fee AMM has enough liquidity to convert it into the token the validator accepts. The conversion rate is fixed at 0.9970 per hop, so a converted fee costs about 0.3% more than the same fee paid directly in the validator’s token.
treatAsGrossAmount: true to have the fee deducted from the amount instead.