Skip to main content
Every Tempo feature in this section is in beta and available through the API only. To get access, contact your Customer Success Manager (CSM).
Set 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
This transfers 1,000 OpenUSD and pays the fee in PathUSD. The source vault account must hold enough PathUSD to cover the fee.

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.
  1. Transaction. The transaction’s fee_token field, which Fireblocks sets from feeCurrency. It overrides every other level.
  2. 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.
  3. TIP-20 contract. If the transaction is a transfer of a USD TIP-20 token, that token pays the fee.
  4. Stablecoin DEX. For a swap, the input token pays the fee. Fireblocks doesn’t send DEX swaps on Tempo today.
  5. Fallback. pathUSD. On newer network versions, Tempo tries pathUSD and then OUSD, and uses the first one that covers the fee.
In practice, a TIP-20 transfer with no 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.
When the fee is paid in the asset being transferred, the source must hold the amount plus the fee. Set treatAsGrossAmount: true to have the fee deducted from the amount instead.