Skip to main content

Documentation Index

Fetch the complete documentation index at: https://fireblocks-43c4b3ee-chore-add-cli.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

InputsSelection

ParameterTypeDescription
inputsToSpendArray of InputsInputs that should be used in the transaction
inputsToExcludeArray of InputsInputs that shouldn’t be used in the transaction

Input

ParameterTypeDescription
txHashstringtxHash
indexstringvOut of the txHash

DestinationTransferPeerPath

ParameterTypeDescription
typestring[ VAULT_ACCOUNT, EXCHANGE_ACCOUNT, INTERNAL_WALLET, EXTERNAL_WALLET, UNMANAGED_WALLET, ONE_TIME_ADDRESS, NETWORK_CONNECTION, FIAT_ACCOUNT ]
idstringThe peer ID (not needed for ONE_TIME_ADDRESS)
oneTimeAddressOneTimeAddressDestination address

OneTimeAddress

ParameterTypeDescription
addressstringTransfer destination address
tagstringUsed as destination tag for XRP;memo for ATOM, EOS, HBAR, LUNA, LUNC, XDB, XEM;memo_textfor XLM;notes` for ALGO; Bank Transfer Description for fiat providers.

BlockInfo

ParameterTypeDescription
blockHeightstringThe height (number) of the block the transaction was mined in
blockHashstringThe hash of the block the transaction was mined in

RewardsInfo

ParameterTypeDescription
srcRewardsstringThe ALGO rewards acknowledged by the source account of the transaction
destRewardsstringThe ALGO rewards acknowledged by the destination account of the transaction

BlockchainInfo

BlockchainParameterTypeDescription
HBAR
hbarTxHashstringHBAR transaction hash
EVM
evmTransferTypeenumType of transfer: NATIVE for native transfer. TOKEN for token transfers that are reflected via the transaction’s logs. INTERNAL for internal transfers that are reflected via the transaction’s traces.
TON
messageCommentstringContains the payload of the internal message (see TON internal message docs). This field represents the smart contract input or data sent to the wallet. Unlike structured blockchains (e.g. EVM, Solana, Stellar), TON allows arbitrary message bodies. Fireblocks exposes this raw data so you can apply custom parsing logic for non-standard formats if needed.
tonTransferTypeenumType of transfer: NATIVE for native transfer. JETTON for Jetton transfer.
hashesTonHashesAdditional hashes of ton transfers
CANTON
transactionTypeenumTypes of transactions: - OFFER - Transfer initiated. Sender has created a transfer offer awaiting the recipient’s action. This is the first step in a 2-step transfer flow. - ACCEPT - Transfer completed. The recipient has accepted the pending transfer offer. Funds have been transferred successfully. - REJECT - Transfer failed. Recipient has rejected the pending transfer offer. No funds were transferred. - WITHDRAW - Transfer cancelled. Sender has withdrawn/cancelled their pending transfer offer before recipient took action. No funds were transferred. - PRE_APPROVAL - Transfer completed instantly. Recipient had pre-approved incoming transfers, enabling a 1-step transfer flow (e.g., transfers from external sources like Kraken).
traceableIdstringUpdateId of the original transfer offer or auto-approved transaction. The hash that could be used to locate the transaction in Canton explorers.
hashesCantonHashesAdditional hashes of Canton transfers.
DOT
substrateExtrinsicIdstringThe extrinsic ID of the transaction.
SUI
gasUsedGasUsedDetailed breakdown of the costs incurred. The total gas cost and gas rebate can be calculated from these values.
For ACCEPT, REJECT, and WITHDRAW transaction types, the offerUpdateId links back to the original OFFER transaction, enabling full transaction lifecycle tracking.

TonHashes

ParameterTypeDescription
externalIncomingstringHash of the external incoming message
tonTransferstringHash of the ton transfer
jettonTransferstringHash of the jetton transfer

CantonHashes

ParameterTypeDescription
offerUpdateIdstringUpdateId of the original transfer offer transaction. Present in transaction types such as OFFER, ACCEPT, REJECT, and WITHDRAW.
acceptUpdateIdstringUpdateId of the accept action transaction. Present in transaction types like ACCEPT.
rejectUpdateIdstringUpdateId of the reject action transaction. Present in transaction types like REJECT.
withdrawUpdateIdstringUpdateId of the withdraw action transaction. Present in transaction types like WITHDRAW.
preApprovalUpdateIdstringUpdateId of the pre-approval transfer transaction. Present in transaction types like PRE_APPROVAL.

GasUsed

ParameterTypeDescription
storageCoststringGas units consumed for data storage.
storageRebatestringGas units refunded due to storage cleanup.
computationCoststringGas units consumed for computation.
nonRefundableStorageFeestringA portion of the storage fee that is non-refundable.

feeInfo

ParameterTypeDescription
networkFeestringThe fee paid to the network
serviceFeestringThe total fee deducted by the exchange from the actual requested amount (serviceFee = amount - netAmount)
gasPricestringThe amount of gas required by/paid to the network to process the transaction
paidByRelaybooleantrue or false; indicates whether the relay paid the fee
relayTypestringIndicates whether the relay is the same tenant (LOCAL) or another tenant (THIRD_PARTY)
relayIdstringThe Vault account ID of the relay
relayNamestringThe name of the tenant hosting the third-party relay

NetworkRecord

ParameterTypeDescription
sourceTransferPeerPathResponseSource of the transaction
destinationTransferPeerPathResponseDestination of the transaction
txHashstringBlockchain hash of the transaction
networkFeenumberThe fee paid to the network
assetIdstringTransaction asset
netAmountnumberThe net amount of the transaction, after fee deduction
statusNetworkStatus objectStatus of the blockchain transaction
typestringType of the operation
destinationAddressstringDestination address
sourceAddressstringFor account-based assets only, the source address of the transaction

NetworkStatus

ParameterTypeDescription
networkStatusenumDROPPED - The transaction was dropped by the network (Typically due to a low fee, or if the mempool is full). \nBROADCASTING - Broadcasting to the blockchain. \nCONFIRMING - Pending confirmations. \nFAILED - The transaction has failed to complete on the blockchain. \nCONFIRMED - Confirmed on the blockchain.

TransactionRequestDestination

ParameterTypeDescription
amountstringThe amount to be sent to this destination
destinationDestinationTransferPeerPathThe specific destination

DropTransactionRequest

ParameterTypeDescription
txIdstringThe ID of the transaction being dropped.
feeLevelstringThe fee level for the replacement of non-ETH transactions.
gasPricestringThe network fee level for the replacement of ETH transactions.

DropTransactionResponse

ParameterTypeDescription
successbooleanTrue if the transaction dropped or the replacement succeeded.
transactionsarrayDropped Transaction replacement Transaction ID(s).

SetConfirmationsThresholdResponse

ParameterTypeDescription
successboolean
transactionsarray of stringstxIds of the transactions

NodeControls

ParameterTypeDescription
typestring (enum)Transaction routing type. \nEnum Values: \n \n- NODE_ROUTER\n- MEVFor routing transactions to a custom node set - NODE_ROUTER \n For MEV protection routing set - MEV
tagstringUsed for NODE_ROUTER type only. The pre-configured tag of the node to route the transaction to

Index

ParameterTypeDescription
Indexinteger(Optional) Fireblocks’ internal identifier for a specific transfer within a transaction. - For UTXO-based assets, this field corresponds to the UTOX’s vOut index. - For other blockchains, like EVM, Tron, Solana, etc., this field is derived from the sequential position of the event within the transaction’s transfer list. The field is not returned when the transaction includes multiple destinations.

logIndex

ParameterTypeDescription
logIndexintegerApplicable to EVM blockchains only. Represents the EVM log index that indicates the order of the log within the block. This information can be verified directly on the blockchain.

blockchainIndex

ParameterTypeDescription
blockchainIndexstringBlockchain-native transfer identifier showing the transfer’s exact position within the block data (e.g. log entry, trace path, or nested array index). - EVM token transfers: Uses logIndex. - EVM internal transfers: Uses traceAddress (e.g., [0,1,2] → “0_1_2”). - Solana: Refers to the nested instruction position in the instruction array.

nonce

ParameterTypeDescription
noncestringBlockchain nonce for the transaction (EVM only)