--- title: "Create Transaction" method: POST path: "/api/v1/swaps" tags: ["Swaps"] --- # Create Transaction `POST /api/v1/swaps` Create a new spot swap. ## Headers - `x-signature` string — Signature of the body. Base64 encoded string. If the request is made programatically by an API user, signing of the request is required and is intended to protect you from malicious backends. `x_signature` is valid for 120 seconds. - `x-timestamp` integer — Timestamp of the signature. Integer. Specify an Epoch date. If the request is made programatically by an API user, the timestamp of the request is required and is intended to protect you from replay attacks. ## Request body - CreateSpotSwapRequest - `quote_id` string, uuid, required — The ID of the quote. - `vault_id` string, uuid, required — The unique identifier of the vault. - `input_asset_identifier` union, required - AptosAssetIdentifierRequest - `type` 'aptos', required — Aptos asset identifier type. - `details` union, required - AptosNativeAssetIdentifierRequest - `type` 'native', required — Aptos asset identifier type. - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - AptosCoinAssetIdentifierRequest - `type` 'coin', required — Legacy coin asset identifier type. - `coin_type` AptosCoinTypeRequest, required — Coin type represents a blockchain legacy coin type. - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - `coin_type_str` string, required — Coin type string representation. - AptosNewCoinAssetIdentifierRequest - `type` 'new_coin', required — New coin asset identifier type. - `new_coin_type` AptosNewCoinTypeRequest, required — New coin type represents a blockchain new coin type. - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - `metadata_address` string, required — New coin's metadata address. - ArchAssetIdentifierRequest - `type` 'arch', required — Arch asset identifier type. - `details` union, required - ArchNativeAssetIdentifierRequest - `type` 'native', required — Arch asset identifier type. - `chain` 'arch_mainnet' | 'arch_testnet', required - ArchAplTokenAssetIdentifierRequest - `type` 'apl_token', required — APL token asset identifier type. - `token` ArchAddressRequest, required — Address represents a blockchain address. - `chain` 'arch_mainnet' | 'arch_testnet', required - `base58_repr` string, required — Base58 representation of the address in the chain. - CantonAssetIdentifierRequest - `type` 'canton', required — Canton asset identifier type. - `details` union, required - CantonNativeAssetIdentifierRequest - `type` 'native', required — Canton asset identifier type. - `chain` 'canton_mainnet' | 'canton_testnet', required - CantonCip56TokenAssetIdentifierRequest - `type` 'cip56_token', required — CIP56 token asset identifier type. - `token` CantonInstrumentIdRequest, required — Instrument ID represents a Canton instrument identifier (address + id). - `address` CantonAddressRequest, required — Address represents a blockchain address. - … - `id` string, required — The instrument ID within the provider's namespace. - CosmosAssetIdentifierRequest - `type` 'cosmos', required — Cosmos asset identifier type. - `details` union, required - CosmosNativeAssetIdentifierRequest - `type` 'native', required — Cosmos asset identifier type. - `chain` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required - CosmosTokenAssetIdentifierRequest - `type` 'token', required — Token asset identifier type. - `chain` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required - `denom` string, required — The denom of the asset. - EvmAssetIdentifierRequest - `type` 'evm', required — Asset identifier type. - `details` union, required - EvmNativeAssetIdentifierRequest - `type` 'native', required — EVM asset identifier type. - `chain` string, required — The details of the chain of the native asset. - EvmErc20AssetIdentifierRequest - `type` 'erc20', required — EVM asset identifier type. - `token` EvmAddressRequest, required — Address represents a blockchain address. - `chain` string, required — The chain details this address is of. - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - EvmErc721AssetIdentifierRequest - `type` 'erc721', required — EVM asset identifier type. - `token` EvmAddressRequest, required — Address represents a blockchain address. - `chain` string, required — The chain details this address is of. - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - `token_id` string, required — The token id of the ERC-721 token. - EvmErc1155AssetIdentifierRequest - `type` 'erc1155', required — EVM asset identifier type. - `token` EvmAddressRequest, required — Address represents a blockchain address. - `chain` string, required — The chain details this address is of. - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - `token_id` string, required — The token id of the ERC-1155 token. - EvmHyperLiquidAssetIdentifierRequest - `type` 'hyperliquid', required — EVM asset identifier type. - `chain` string, required — Currently artificially set to Arbitrum. - `token_id` string, required — The token id of the asset on Hyperliquid. - `index` integer, required — The index of the asset on Hyperliquid. - ExchangeAssetIdentifierRequest - `type` 'exchange', required — Asset identifier type. - `exchange_type` 'binance' | 'bybit' | 'coinbase_international' | 'coinbase_us' | 'okx' | 'kraken' | 'paxos', required - `asset_symbol` string, required — The symbol of the asset on the exchange. - SolanaAssetIdentifierRequest - `type` 'solana', required — Solana asset identifier type. - `details` union, required - SolanaNativeAssetIdentifierRequest - `type` 'native', required — Solana asset identifier type. - `chain` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required - SolanaSplTokenAssetIdentifierRequest - `type` 'spl_token', required — SPL token asset identifier type. - `token` SolanaAddressRequest, required — Address represents a blockchain address. - `chain` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required - `base58_repr` string, required — Base58 representation of the address in the chain. - StacksAssetIdentifierRequest - `type` 'stacks', required — Stacks asset identifier type. - `details` union, required - StacksNativeAssetIdentifierRequest - `type` 'native', required — Stacks asset identifier type. - `chain` 'stacks_mainnet', required - StacksSip10AssetIdentifierRequest - `type` 'sip10', required — Sip10 asset identifier type. - `sip10` StacksAddressRequest, required — Address represents a blockchain address. - `chain` 'stacks_mainnet', required - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - StellarAssetIdentifierRequest - `type` 'stellar', required — Stellar asset identifier type. - `details` union, required - StellarNativeAssetIdentifierRequest - `type` 'native', required — Stellar asset identifier type. - `chain` 'stellar_mainnet' | 'stellar_testnet', required - StellarClassicAssetIdentifierRequest - `type` 'classic_asset', required — Stellar asset identifier type. - `code` string, required — The 1-4 character asset code. - `issuer` StellarAddressRequest, required — Address represents a blockchain address. - `chain` 'stellar_mainnet' | 'stellar_testnet', required - `base32_repr` string, required — Hexadecimal representation of the address in the chain. - `chain` 'stellar_mainnet' | 'stellar_testnet', required - StellarSorobanAssetIdentifierRequest - `type` 'soroban_asset', required — Stellar asset identifier type. - `address` string, required — The Soroban asset address. - `chain` 'stellar_mainnet' | 'stellar_testnet', required - StarknetAssetIdentifierRequest - `type` 'starknet', required — Starknet asset identifier type. - `details` union, required - StarknetNativeAssetIdentifierRequest - `type` 'native', required — Starknet asset identifier type. - `chain` 'starknet_mainnet', required - StarknetErc20AssetIdentifierRequest - `type` 'erc20', required — Erc20 asset identifier type. - `erc20` StarknetAddressRequest, required — Address represents a blockchain address. - `chain` 'starknet_mainnet', required - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - SuiAssetIdentifierRequest - `type` 'sui', required — Sui asset identifier type. - `details` union, required - SuiNativeAssetIdentifierRequest - `type` 'native', required — Sui asset identifier type. - `chain` 'sui_mainnet' | 'sui_testnet', required - SuiCoinAssetIdentifierRequest - `type` 'coin', required — Coin asset identifier type. - `coin_type` SuiCoinTypeRequest, required — Coin type represents a blockchain coin type. - `chain` 'sui_mainnet' | 'sui_testnet', required - `coin_type_str` string, required — Coin type string representation. - TonAssetIdentifierRequest - `type` 'ton', required — TON asset identifier type. - `details` union, required - TonNativeAssetIdentifierRequest - `type` 'native', required — TON asset identifier type. - `chain` 'ton_mainnet' | 'ton_testnet', required - TonJettonAssetIdentifierRequest - `type` 'jetton', required — Jetton asset identifier type. - `jetton` TonAddressRequest, required — Address represents a blockchain address. - `chain` 'ton_mainnet' | 'ton_testnet', required - `address` string, required — Contract address in a raw format. - TronAssetIdentifierRequest - `type` 'tron', required — TRON asset identifier type. - `details` union, required - TronNativeAssetIdentifierRequest - `type` 'native', required — TRON asset identifier type. - `chain` 'tron_mainnet' | 'tron_shasta', required - TronTrc20AssetIdentifierRequest - `type` 'trc20', required — Trc20 asset identifier type. - `trc20` TronAddressRequest, required — Address represents a blockchain address. - `chain` 'tron_mainnet' | 'tron_shasta', required - `base58_repr` string, required — Base58 representation of the address in the chain. - UtxoAssetIdentifierRequest - `type` 'utxo', required — Utxo asset identifier type. - `details` UtxoNativeAssetIdentifierRequest, required - `type` 'native', required — Utxo asset identifier type. - `chain` 'bitcoin_mainnet' | 'bitcoin_testnet' | 'bitcoin_testnet_v4' | 'dogecoin_mainnet' | 'bitcoin_cash_mainnet' | 'pearl_testnet' | 'pearl_mainnet', required - `output_asset_identifier` union, required - AptosAssetIdentifierRequest - `type` 'aptos', required — Aptos asset identifier type. - `details` union, required - AptosNativeAssetIdentifierRequest - `type` 'native', required — Aptos asset identifier type. - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - AptosCoinAssetIdentifierRequest - `type` 'coin', required — Legacy coin asset identifier type. - `coin_type` AptosCoinTypeRequest, required — Coin type represents a blockchain legacy coin type. - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - `coin_type_str` string, required — Coin type string representation. - AptosNewCoinAssetIdentifierRequest - `type` 'new_coin', required — New coin asset identifier type. - `new_coin_type` AptosNewCoinTypeRequest, required — New coin type represents a blockchain new coin type. - `chain` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - `metadata_address` string, required — New coin's metadata address. - ArchAssetIdentifierRequest - `type` 'arch', required — Arch asset identifier type. - `details` union, required - ArchNativeAssetIdentifierRequest - `type` 'native', required — Arch asset identifier type. - `chain` 'arch_mainnet' | 'arch_testnet', required - ArchAplTokenAssetIdentifierRequest - `type` 'apl_token', required — APL token asset identifier type. - `token` ArchAddressRequest, required — Address represents a blockchain address. - `chain` 'arch_mainnet' | 'arch_testnet', required - `base58_repr` string, required — Base58 representation of the address in the chain. - CantonAssetIdentifierRequest - `type` 'canton', required — Canton asset identifier type. - `details` union, required - CantonNativeAssetIdentifierRequest - `type` 'native', required — Canton asset identifier type. - `chain` 'canton_mainnet' | 'canton_testnet', required - CantonCip56TokenAssetIdentifierRequest - `type` 'cip56_token', required — CIP56 token asset identifier type. - `token` CantonInstrumentIdRequest, required — Instrument ID represents a Canton instrument identifier (address + id). - `address` CantonAddressRequest, required — Address represents a blockchain address. - … - `id` string, required — The instrument ID within the provider's namespace. - CosmosAssetIdentifierRequest - `type` 'cosmos', required — Cosmos asset identifier type. - `details` union, required - CosmosNativeAssetIdentifierRequest - `type` 'native', required — Cosmos asset identifier type. - `chain` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required - CosmosTokenAssetIdentifierRequest - `type` 'token', required — Token asset identifier type. - `chain` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required - `denom` string, required — The denom of the asset. - EvmAssetIdentifierRequest - `type` 'evm', required — Asset identifier type. - `details` union, required - EvmNativeAssetIdentifierRequest - `type` 'native', required — EVM asset identifier type. - `chain` string, required — The details of the chain of the native asset. - EvmErc20AssetIdentifierRequest - `type` 'erc20', required — EVM asset identifier type. - `token` EvmAddressRequest, required — Address represents a blockchain address. - `chain` string, required — The chain details this address is of. - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - EvmErc721AssetIdentifierRequest - `type` 'erc721', required — EVM asset identifier type. - `token` EvmAddressRequest, required — Address represents a blockchain address. - `chain` string, required — The chain details this address is of. - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - `token_id` string, required — The token id of the ERC-721 token. - EvmErc1155AssetIdentifierRequest - `type` 'erc1155', required — EVM asset identifier type. - `token` EvmAddressRequest, required — Address represents a blockchain address. - `chain` string, required — The chain details this address is of. - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - `token_id` string, required — The token id of the ERC-1155 token. - EvmHyperLiquidAssetIdentifierRequest - `type` 'hyperliquid', required — EVM asset identifier type. - `chain` string, required — Currently artificially set to Arbitrum. - `token_id` string, required — The token id of the asset on Hyperliquid. - `index` integer, required — The index of the asset on Hyperliquid. - ExchangeAssetIdentifierRequest - `type` 'exchange', required — Asset identifier type. - `exchange_type` 'binance' | 'bybit' | 'coinbase_international' | 'coinbase_us' | 'okx' | 'kraken' | 'paxos', required - `asset_symbol` string, required — The symbol of the asset on the exchange. - SolanaAssetIdentifierRequest - `type` 'solana', required — Solana asset identifier type. - `details` union, required - SolanaNativeAssetIdentifierRequest - `type` 'native', required — Solana asset identifier type. - `chain` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required - SolanaSplTokenAssetIdentifierRequest - `type` 'spl_token', required — SPL token asset identifier type. - `token` SolanaAddressRequest, required — Address represents a blockchain address. - `chain` 'solana_mainnet' | 'solana_devnet' | 'solana_eclipse_mainnet' | 'solana_fogo_mainnet' | 'solana_fogo_testnet', required - `base58_repr` string, required — Base58 representation of the address in the chain. - StacksAssetIdentifierRequest - `type` 'stacks', required — Stacks asset identifier type. - `details` union, required - StacksNativeAssetIdentifierRequest - `type` 'native', required — Stacks asset identifier type. - `chain` 'stacks_mainnet', required - StacksSip10AssetIdentifierRequest - `type` 'sip10', required — Sip10 asset identifier type. - `sip10` StacksAddressRequest, required — Address represents a blockchain address. - `chain` 'stacks_mainnet', required - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - StellarAssetIdentifierRequest - `type` 'stellar', required — Stellar asset identifier type. - `details` union, required - StellarNativeAssetIdentifierRequest - `type` 'native', required — Stellar asset identifier type. - `chain` 'stellar_mainnet' | 'stellar_testnet', required - StellarClassicAssetIdentifierRequest - `type` 'classic_asset', required — Stellar asset identifier type. - `code` string, required — The 1-4 character asset code. - `issuer` StellarAddressRequest, required — Address represents a blockchain address. - `chain` 'stellar_mainnet' | 'stellar_testnet', required - `base32_repr` string, required — Hexadecimal representation of the address in the chain. - `chain` 'stellar_mainnet' | 'stellar_testnet', required - StellarSorobanAssetIdentifierRequest - `type` 'soroban_asset', required — Stellar asset identifier type. - `address` string, required — The Soroban asset address. - `chain` 'stellar_mainnet' | 'stellar_testnet', required - StarknetAssetIdentifierRequest - `type` 'starknet', required — Starknet asset identifier type. - `details` union, required - StarknetNativeAssetIdentifierRequest - `type` 'native', required — Starknet asset identifier type. - `chain` 'starknet_mainnet', required - StarknetErc20AssetIdentifierRequest - `type` 'erc20', required — Erc20 asset identifier type. - `erc20` StarknetAddressRequest, required — Address represents a blockchain address. - `chain` 'starknet_mainnet', required - `hex_repr` string, required — Hexadecimal representation of the address in the chain. - SuiAssetIdentifierRequest - `type` 'sui', required — Sui asset identifier type. - `details` union, required - SuiNativeAssetIdentifierRequest - `type` 'native', required — Sui asset identifier type. - `chain` 'sui_mainnet' | 'sui_testnet', required - SuiCoinAssetIdentifierRequest - `type` 'coin', required — Coin asset identifier type. - `coin_type` SuiCoinTypeRequest, required — Coin type represents a blockchain coin type. - `chain` 'sui_mainnet' | 'sui_testnet', required - `coin_type_str` string, required — Coin type string representation. - TonAssetIdentifierRequest - `type` 'ton', required — TON asset identifier type. - `details` union, required - TonNativeAssetIdentifierRequest - `type` 'native', required — TON asset identifier type. - `chain` 'ton_mainnet' | 'ton_testnet', required - TonJettonAssetIdentifierRequest - `type` 'jetton', required — Jetton asset identifier type. - `jetton` TonAddressRequest, required — Address represents a blockchain address. - `chain` 'ton_mainnet' | 'ton_testnet', required - `address` string, required — Contract address in a raw format. - TronAssetIdentifierRequest - `type` 'tron', required — TRON asset identifier type. - `details` union, required - TronNativeAssetIdentifierRequest - `type` 'native', required — TRON asset identifier type. - `chain` 'tron_mainnet' | 'tron_shasta', required - TronTrc20AssetIdentifierRequest - `type` 'trc20', required — Trc20 asset identifier type. - `trc20` TronAddressRequest, required — Address represents a blockchain address. - `chain` 'tron_mainnet' | 'tron_shasta', required - `base58_repr` string, required — Base58 representation of the address in the chain. - UtxoAssetIdentifierRequest - `type` 'utxo', required — Utxo asset identifier type. - `details` UtxoNativeAssetIdentifierRequest, required - `type` 'native', required — Utxo asset identifier type. - `chain` 'bitcoin_mainnet' | 'bitcoin_testnet' | 'bitcoin_testnet_v4' | 'dogecoin_mainnet' | 'bitcoin_cash_mainnet' | 'pearl_testnet' | 'pearl_mainnet', required - `amount` string, required — The amount to swap. - `slippage_bps` string — The slippage tolerance in basis points. - `fee` union - EvmSpotSwapFeeRequest - `type` 'evm', required — EVM fee type. - `details` GasPriorityRequest, required - `gas_limit` string — Specifies the maximum number of gas units to be used for mining the transaction. If omitted, Fordefi will automatically estimate the required gas and apply that value. - `type` 'priority', required - `priority_level` 'low' | 'medium' | 'high', required - SolanaSpotSwapFeeRequest - `type` 'solana', required — Solana fee type. - `details` union, required — The fee configuration for the transaction, including broadcast mode selection. - SolanaPriorityFeeTypeRequest - `type` 'priority_fee', required — Priority fee broadcast mode. - `details` union, required — The fee configuration for the transaction. - SolanaCustomFeeRequest - … - SolanaPriorityFeeRequest - … - SolanaJitoFeeTypeRequest - `type` 'jito', required — Jito broadcast mode. - `details` union, required — The details of the Jito fee. - JitoCustomFeeRequest - … - JitoPriorityFeeRequest - … - `fee_payer` TransactionFeePayerVault - `type` 'vault', required - `vault_id` string, uuid, required — The unique identifier of the vault that pays the fee. - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user' - `fail_on_prediction_failure` boolean — `True` if transaction creation should fail in case prediction failed, `False` otherwise.
In case simulation has failed upon continuation, the expected result of the transaction will be partial and policy will be applied on information that can be extracted statically from the transaction only. This might result in falling back to the default policy rule. - `use_secure_node` boolean — Use a secure node to send the transaction. By using a secure node, you avoid maximal extractable value (MEV) attacks. - `use_mev_protected_node` boolean — Use an MEV protected node to send the transaction. By using an MEV protected node, you avoid maximal extractable value (MEV) attacks. - `dapp_info` DappInfo - `url` string, required — The URL of the dapp. - `name` string, required — The name of the dapp. ## Response `201` Successful Response - SpotSwap - `transactions` CreateTransactionResponse[], required — The created transactions. - union - AptosMessage - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by' | 'ripple_cash_of' | 'ripple_cashed_by' | 'ripple_cash_trustline' | 'ripple_trustline_for' | 'ripple_trustline_for_check', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped', required - `state_changes` NonPushableTransactionStateChange[], required — The state changes of the message. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped', required - `type` 'aptos_message', required — Aptos message type. - `aptos_message_type` 'personal_message_type', required - `raw_original_message_to_sign` string, required — The original message that was requested to be signed, encoded in base64. - `string_original_message_to_sign` string, required — The original message that was requested to be signed. - `raw_full_message_to_sign` string, required — The full message to be signed, encoded in base64. - `string_full_message_to_sign` string, required — The full message to be signed. - `chain` EnrichedAptosChain, required - `chain_type` 'aptos', required — The type of the chain. - `unique_id` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `sender` EnrichedAptosAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'aptos', required - `address` string, required — The Aptos address represented in hex format. - AptosTransaction - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by' | 'ripple_cash_of' | 'ripple_cashed_by' | 'ripple_cash_trustline' | 'ripple_trustline_for' | 'ripple_trustline_for_check', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `block` Block - `number` integer, required — The block number. - `hash` string — The block hash. - `mined_at` string, date-time, required — The date and time when this block was mined. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `state_changes` PushableTransactionStateChange[], required — The state changes of the transaction. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `aml_check` AmlCheck - `results` AmlResults - `scan_status` 'error' | 'timeout' | 'skipped' | 'completed' | 'unsupported_chain' | 'pending', required - `error_message` string — The error message if the scan failed. - `scan_results` ChainalysisScanResult - … - `incoming_aml_check` IncomingAmlCheck - `policy_match` AmlPolicyMatchIncoming - … - `users_eligible_to_unfreeze` RequestApprover[] — list of possible approvers - … - `frozen` boolean — Whether the transaction is frozen. - `mined_result_status` 'success' | 'missing' | 'potentially_partial' - `simulation_status_result` SimulationStatusResult - `simulation_status` 'success' | 'failed' | 'reverted' | 'skipped' - `details` string, required — Details about transaction reversion if occurred. - `type` 'aptos_transaction', required — Aptos transaction type. - `aptos_transaction_type_details` union, required — Details of the Aptos transaction based on its type. - AptosNativeTransferDetails - `type` 'native_transfer', required — A transaction involving the transfer of APT coin from one address to another. - `sender` EnrichedAptosAddress, required - … - `recipient` EnrichedAptosAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - AptosCoinTransferDetails - `type` 'coin_transfer', required — A transaction involving the transfer of non-APT coin from one address to another. - `sender` EnrichedAptosAddress, required - … - `recipient` EnrichedAptosAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - AptosEntryPointDetails - `type` 'entry_point', required — A transaction with an entry point function. - `recipient` EnrichedAptosAddress, required - … - AptosScriptDetails - `type` 'script', required — A transaction with running a move script. - `code` string, required — The code of the script. - `chain` EnrichedAptosChain, required - `chain_type` 'aptos', required — The type of the chain. - `unique_id` 'aptos_mainnet' | 'aptos_testnet' | 'aptos_movement_mainnet' | 'aptos_movement_testnet', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `version` integer — The version of the transaction. - `nonce` integer — The nonce of the transaction. - `sender` EnrichedAptosAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'aptos', required - `address` string, required — The Aptos address represented in hex format. - `payload` union, required — The payload of the transaction. - AptosEntryFunctionPayload - `typed_arguments` string[], required — The typed arguments of the transaction. - `arguments` string[], required — The arguments of the transaction. - `type` 'entry_point', required - `function_id` string, required — The entry function of the transaction. - `address` EnrichedAptosAddress, required - … - `module` string, required — The module of the entry function. - `function_name` string, required — The name of the entry function. - ScriptPayload - `typed_arguments` string[], required — The typed arguments of the transaction. - `arguments` string[], required — The arguments of the transaction. - `type` 'script', required - `code` string, required — The script code of the transaction. - `hash` string — The hash of the transaction. - `gas_submitted` AptosGasData, required - `gas_limit` string, required — The gas limit of the transaction. - `price` AptosGasPrice, required - `priority_level` 'custom' | 'low' | 'medium' | 'high', required - `price` string, required — The price per gas unit (in Octa). - `fiat_price` Price — Price represents a price in a given FiatCurrency. - … - `with_external_fee_payer` boolean — If true, the transaction's Authenticator will be configured to support an external fee payer. After Fordefi signs the transaction, the client is responsible for forwarding it to the designated fee payer for final signing and broadcasting. - `fee_payer` EnrichedAptosAddress - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'aptos', required - `address` string, required — The Aptos address represented in hex format. - `serialized_signed_transaction` string — The serialized signed transaction. - `expected_result` AptosTransactionResult - `reversion` AptosReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'contract_asserted' | 'insufficient_funds_gas_and_value', required - `reason` string — The reason for the reversion (additional information). - `fee_statement` AptosFeeStatement, required - `execution_gas_units` string, required - `io_gas_units` string, required - `storage_fee_octas` string, required - `storage_fee_refund_octas` string, required - `total_charge_gas_units` string, required - `total_gas` string, required — The total gas fee of the transaction (in Octa). - `priced_asset` PricedAsset, required - … - `effects` AptosEffects, required - `balance_changes` AptosBalanceChangeEffect[], required - … - `transfers` AptosTransferEffect[], required - … - `raw_result` string — The raw result of the transaction. - `mined_result` AptosTransactionResult - `reversion` AptosReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'contract_asserted' | 'insufficient_funds_gas_and_value', required - `reason` string — The reason for the reversion (additional information). - `fee_statement` AptosFeeStatement, required - `execution_gas_units` string, required - `io_gas_units` string, required - `storage_fee_octas` string, required - `storage_fee_refund_octas` string, required - `total_charge_gas_units` string, required - `total_gas` string, required — The total gas fee of the transaction (in Octa). - `priced_asset` PricedAsset, required - … - `effects` AptosEffects, required - `balance_changes` AptosBalanceChangeEffect[], required - … - `transfers` AptosTransferEffect[], required - … - `raw_result` string — The raw result of the transaction. - `explorer_url` string, uri — The URL of this transaction in a blockchain explorer. For example, explorer.aptoslabs.com - ArchTransaction - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by' | 'ripple_cash_of' | 'ripple_cashed_by' | 'ripple_cash_trustline' | 'ripple_trustline_for' | 'ripple_trustline_for_check', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `block` Block - `number` integer, required — The block number. - `hash` string — The block hash. - `mined_at` string, date-time, required — The date and time when this block was mined. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `state_changes` PushableTransactionStateChange[], required — The state changes of the transaction. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `aml_check` AmlCheck - `results` AmlResults - `scan_status` 'error' | 'timeout' | 'skipped' | 'completed' | 'unsupported_chain' | 'pending', required - `error_message` string — The error message if the scan failed. - `scan_results` ChainalysisScanResult - … - `incoming_aml_check` IncomingAmlCheck - `policy_match` AmlPolicyMatchIncoming - … - `users_eligible_to_unfreeze` RequestApprover[] — list of possible approvers - … - `frozen` boolean — Whether the transaction is frozen. - `mined_result_status` 'success' | 'missing' | 'potentially_partial' - `simulation_status_result` SimulationStatusResult - `simulation_status` 'success' | 'failed' | 'reverted' | 'skipped' - `details` string, required — Details about transaction reversion if occurred. - `type` 'arch_transaction', required — The type of the transaction. - `arch_transaction_type_details` union, required — Details of the Arch transaction based on its type. - ArchNativeTransferDetails - `type` 'native_transfer', required — A transaction involving the transfer of native currency from one address to another. - `recipient` EnrichedArchAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - ArchTokenTransferDetails - `type` 'token_transfer', required — A transaction involving the transfer of native currency from one address to another. - `recipient` EnrichedArchAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - ArchRawTransactionDetails - `type` 'raw_transaction', required — A transaction capable of any operation. - `recipients` EnrichedArchAddress[], required — The recipients of the tokens. - … - `chain` EnrichedArchChain, required - `chain_type` 'arch', required — The type of the chain. - `unique_id` 'arch_mainnet' | 'arch_testnet', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `instructions` ArchCompiledInstruction[], required — The instructions of the transaction. - `program_index` integer, required — The program index. - `data` string, required — The instruction data in Base64 format. - `account_indexes` integer[], required — The indexes of the instruction accounts in the transaction accounts list. - `program` EnrichedArchAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - … - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - … - `type` 'arch', required - `address` string, required — The Arch address represented in Base58 format. - `base58_data` string — The instruction data encoded in Base58 format. - `accounts` ArchTransactionAccount[], required — Accounts used in the transaction. - `address` EnrichedArchAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - … - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - … - `type` 'arch', required - `address` string, required — The Arch address represented in Base58 format. - `writable` boolean, required — Indicates if this account is writable in the context of the transaction. - `signer` boolean, required — Indicates if this account is a signer of the transaction. - `sender` EnrichedArchAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'arch', required - `address` string, required — The Arch address represented in Base58 format. - `raw_transaction` string — The serialized transaction encoded as a base64 string - `hash` string — The hash of the transaction. - `recent_blockhash` string — The transaction nonce (last block hash). - `expected_result` ArchTransactionResult - `reversion` ArchReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'contract_asserted' | 'insufficient_funds_gas_and_value' | 'insufficient_funds_for_rent', required - `reason` string — The reason for the reversion (additional information). - `transaction_error` string — The description of the error of the transaction. - `fee` ArchFee, required - `base_fee` string, required — The base fee of the transaction (in lamports). - `total_fee` string, required — The total fee of the transaction (in lamports). - `priced_asset` PricedAsset, required - … - `effects` ArchEffects, required - `balance_changes` ArchBalanceChangeEffect[], required — The aggregated balance changes of addresses. - … - `transfers` ArchTransferEffect[], required — The transfer events of the transaction. - … - `mined_result` ArchTransactionResult - `reversion` ArchReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'contract_asserted' | 'insufficient_funds_gas_and_value' | 'insufficient_funds_for_rent', required - `reason` string — The reason for the reversion (additional information). - `transaction_error` string — The description of the error of the transaction. - `fee` ArchFee, required - `base_fee` string, required — The base fee of the transaction (in lamports). - `total_fee` string, required — The total fee of the transaction (in lamports). - `priced_asset` PricedAsset, required - … - `effects` ArchEffects, required - `balance_changes` ArchBalanceChangeEffect[], required — The aggregated balance changes of addresses. - … - `transfers` ArchTransferEffect[], required — The transfer events of the transaction. - … - `explorer_url` string, uri — The URL of this transaction in a blockchain explorer. For example, gomaestro - BlackBoxSignature - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData, required - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by' | 'ripple_cash_of' | 'ripple_cashed_by' | 'ripple_cash_trustline' | 'ripple_trustline_for' | 'ripple_trustline_for_check', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped', required - `state_changes` NonPushableTransactionStateChange[], required — The state changes of the message. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'sent_to_provider' | 'completed' | 'error_signing' | 'aborted' | 'error_submitting_to_provider' | 'dropped', required - `type` 'black_box_signature', required — Black Box signature type. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `details` union, required - BlackBoxSignatureEcdsaStarkDetails - `type` 'ecdsa_stark', required — ECDSA over the Stark curve signature. - `signature` EcdsaSignature - … - `hash_binary` string, required — The payload to sign, encoded in base64 format. - BlackBoxSignatureEcdsaSecp256k1Details - `type` 'ecdsa_secp256k1', required — ECDSA over the secp256k1 curve signature. - `signature` EcdsaSignature - … - `hash_binary` string, required — The payload to sign, encoded in base64 format. - BlackBoxSignatureEddsaEd25519Details - `type` 'eddsa_ed25519', required — EDDSA signature. - `signature` string — The signature, encoded in base64 format. - `hash_binary` string, required — The payload to sign, encoded in base64 format. - BlackBoxSignatureSchnorrSecp256k1Details - `type` 'schnorr_secp256k1', required — Schnorr over the secp256k1 curve signature. - `signature` string — The signature, encoded in base64 format. - `hash_binary` string, required — The payload to sign, encoded in base64 format. - CantonTransaction - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by' | 'ripple_cash_of' | 'ripple_cashed_by' | 'ripple_cash_trustline' | 'ripple_trustline_for' | 'ripple_trustline_for_check', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `block` Block - `number` integer, required — The block number. - `hash` string — The block hash. - `mined_at` string, date-time, required — The date and time when this block was mined. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `state_changes` PushableTransactionStateChange[], required — The state changes of the transaction. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `aml_check` AmlCheck - `results` AmlResults - `scan_status` 'error' | 'timeout' | 'skipped' | 'completed' | 'unsupported_chain' | 'pending', required - `error_message` string — The error message if the scan failed. - `scan_results` ChainalysisScanResult - … - `incoming_aml_check` IncomingAmlCheck - `policy_match` AmlPolicyMatchIncoming - … - `users_eligible_to_unfreeze` RequestApprover[] — list of possible approvers - … - `frozen` boolean — Whether the transaction is frozen. - `mined_result_status` 'success' | 'missing' | 'potentially_partial' - `simulation_status_result` SimulationStatusResult - `simulation_status` 'success' | 'failed' | 'reverted' | 'skipped' - `details` string, required — Details about transaction reversion if occurred. - `type` 'canton_transaction', required — Canton transaction type. - `canton_transaction_type_details` union, required — Details of the Canton transaction based on its type. - CantonNativeTransferDetails - `type` 'native_transfer', required — A transaction involving the transfer of native Canton currency from one address to another. - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the recipient is unknown. - CantonTokenTransferDetails - `type` 'token_transfer', required — A transaction involving the transfer of a CIP-56 token from one address to another. - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the recipient is unknown. - CantonPartyAllocationDetails - `type` 'party_allocation', required — A transaction that allocates an external party on a Canton node. - CantonApproveTransferDetails - `type` 'approve_transfer', required — A transaction that approves pending incoming transfers. - CantonPreApprovalSetupDetails - `type` 'pre_approval_setup', required — A transaction that sets up a transfer pre-approval for auto-accepting incoming transfers. - `asset` PricedAsset, required - … - `chain` EnrichedCantonChain, required - `chain_type` 'canton', required — The type of the chain. - `unique_id` 'canton_mainnet' | 'canton_testnet', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `sender` EnrichedCantonAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'canton', required - `address` string, required — The Canton address. - `recipient` EnrichedCantonAddress - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'canton', required - `address` string, required — The Canton address. - `expected_result` CantonTransactionResult - `reversion` CantonReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'insufficient_funds_gas_and_value' | 'unknown_recipient' | 'already_pre_approved', required - `reason` string — The reason for the reversion (additional information). - `effects` CantonEffects, required - `balance_changes` CantonBalanceChangeEffect[], required - … - `transfers` CantonTransferEffect[], required - … - `mined_result` CantonTransactionResult - `reversion` CantonReversion, required - `state` 'not_reverted' | 'unknown_revert' | 'insufficient_funds_gas_and_value' | 'unknown_recipient' | 'already_pre_approved', required - `reason` string — The reason for the reversion (additional information). - `effects` CantonEffects, required - `balance_changes` CantonBalanceChangeEffect[], required - … - `transfers` CantonTransferEffect[], required - … - `memo` string — Optional memo attached to the transfer. - `approval_status` 'requires_approval' | 'approved' | 'expired' - `approval_expires_at` string, date-time — Only set when `approval_status` is `requires_approval`. The sender's `executeBefore` on the pending TransferInstruction — the receiver must accept before this time or the transfer expires. - `hash` string — The on-ledger update id of the transaction. - `explorer_url` string, uri — Link to view the transaction on the block explorer. - CosmosTransaction - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - `created_by` union, required — Represents a reference to a user in the Fordefi platform - … - `signers` ActionSigner[], required — A list of required signers. A signer can be a person or an API Signer. - … - `approval_request` ApprovalRequest — Represents an approval request for an action in the Fordefi platform - `state` 'created' | 'approved' | 'insufficient_approvers' | 'auto_approved' | 'failed', required — Represents the whole approval request state - `required_groups` integer, required — The number of required approval groups. - `approval_groups` ApprovalRequestGroup[], required — A list of the possible approvers from different groups. - … - `error_message` string — The error message if the request failed. - `aml_policy_match` AmlPolicyMatchOutgoing - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval' | 'skip', required - `policy_match` PolicyMatch - `is_default` boolean, required — `True` if this is the default rule, `False` otherwise. - `rule_id` string, uuid, required — The unique identifier of the rule. - `rule_name` string, required — The name of the rule. - `action_type` 'allow' | 'block' | 'require_approval', required - `signer_type` 'initiator' | 'api_signer' | 'end_user' | 'multiple_signers' | 'api_user', required - `risks` TransactionRisk[], required — The list of risks associated with this transaction. - `type` 'transfer_to_erc20_contract' | 'organization_not_interacted_with_address' | 'vault_not_interacted_with_address' | 'allowance_to_eoa' | 'unlimited_allowance' | 'contract_not_verified' | 'bridge_dest_differ_from_sender' | 'nft_approve_for_all' | 'missing_simulation' | 'unsupported_simulation' | 'post_conditions_allow_mode' | 'safe_sensitive_operation', required - `severity` 'low' | 'medium' | 'high', required - `title` string, required — The title of the risk. - `description` string, required — A detailed description of the risk. - `error_pushing_to_blockchain_message` string — The translated error message received from the node if it was rejected by it. - `original_error_pushing_to_blockchain_message` string — The error message received from the node if it was rejected by it. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `idempotence_id` string, uuid — Optional idempotence ID of a transaction. - `has_current_user_vault_permissions` boolean, required — Does current user have permissions to the origin vault according to its vault group permissions. - `batch_data` BatchData - `batch_id` string, uuid, required — The unique identifier of the batch. - `index_in_batch` integer, required — Index of transaction in the batch. - `batch_size` integer, required — The number of transactions in the batch. - `matched_policies` PolicyMatch[], required — List of policies matched by this message. - … - `push_mode` 'auto' | 'manual' | 'deferred' - `last_pushed_at` string, date-time — The last time the transaction was pushed to the node. - `sign_mode` 'auto' | 'triggered' - `fee_paid_by` FeePaidByVault - `type` 'vault', required — The type of fee payer. - `vault` VaultRef, required — Represents a reference to a vault in the Fordefi platform - … - `attested_payload_for_signing` string — JWS attestation for the payload (external signer). Set after finalize-for-signing. - `tx_policy_explanation_id` string, uuid — The id of the transaction policy explanation produced for this transaction, if any. - `signatures` Signature[], required — The transaction signatures. - `data` string, required — Signature on the transaction, encoded in base64 format. - `signed_by` union — The user who created this signature, `null` if the signature wasn't created by a Fordefi user. - PersonRef - … - ApiSignerRef - … - EndUserRef - … - ApiUserRef - … - `note` string — An optional transaction note. - `spam_state` 'unset' | 'manually_set' | 'automatically_set' - `direction` 'outgoing' | 'incoming', required - `signed_externally` boolean — Whether the transaction was signed by an external user (for example in case of imported vault). - `interacted_vaults` VaultRef[], required — The vaults that interacted with the transaction. - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - `id` string, uuid, required — The unique identifier of the user in the Fordefi platform. - `user_type` 'end_user', required — The type of the user. - `external_id` string, required — External id of the user. - `state` 'active' | 'deleted', required — The state of the user. - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `related_transactions` RelatedTransaction[] — The related transactions. - `type` 'swap_fulfilled_by' | 'swap_fulfilling' | 'bridge_intent' | 'bridge_source' | 'bridge_destination' | 'stellar_claim_of' | 'stellar_claimed_by' | 'canton_accept_of' | 'canton_accepted_by' | 'ripple_cash_of' | 'ripple_cashed_by' | 'ripple_cash_trustline' | 'ripple_trustline_for' | 'ripple_trustline_for_check', required - `hash` string — The hash of the related transaction. - `id` string, uuid — The id of the related transaction. - `chain` union, required — A blockchain with metadata. - EnrichedAptosChain - … - EnrichedArchChain - … - EnrichedCantonChain - … - EnrichedCosmosChain - … - EnrichedEvmChain - … - EnrichedExchangeChain - … - EnrichedSolanaChain - … - EnrichedStacksChain - … - EnrichedStarknetChain - … - EnrichedStellarChain - … - EnrichedSuiChain - … - EnrichedTonChain - … - EnrichedTronChain - … - EnrichedUtxoChain - … - `explorer_url` string, uri — The URL of the related transaction in a blockchain explorer. - `organization_id` string, uuid, required — The organization that the transaction belongs to. - `block` Block - `number` integer, required — The block number. - `hash` string — The block hash. - `mined_at` string, date-time, required — The date and time when this block was mined. - `state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `state_changes` PushableTransactionStateChange[], required — The state changes of the transaction. - `changed_at` string, date-time, required — The date and time when the state was changed. - `reason` 'failed_to_verify_signature' | 'original_transaction_was_completed' | 'stale_nonce' | 'quote_expired' | 'another_dlc_transaction_was_completed' | 'fee_limit_exceeded' | 'not_in_mempool_or_chain' | 'exchange_withdraw_address_not_whitelisted' | 'exchange_invalid_api_key_permissions' | 'exchange_funds_pending_settlement' | 'exchange_withdrawal_limit_exceeded' | 'exchange_security_and_policy_holds' | 'exchange_service_unavailable' - `previous_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds' - `new_state` 'waiting_for_approval' | 'waiting_for_signing_trigger' | 'approved' | 'finalized_for_signing' | 'signed' | 'pushed_to_blockchain' | 'mined' | 'completed' | 'aborted' | 'error_pushing_to_blockchain' | 'mined_reverted' | 'completed_reverted' | 'error_signing' | 'stuck' | 'dropped' | 'queued' | 'accelerating' | 'canceling' | 'accelerated' | 'cancelled' | 'insufficient_funds', required - `aml_check` AmlCheck - `results` AmlResults - `scan_status` 'error' | 'timeout' | 'skipped' | 'completed' | 'unsupported_chain' | 'pending', required - `error_message` string — The error message if the scan failed. - `scan_results` ChainalysisScanResult - … - `incoming_aml_check` IncomingAmlCheck - `policy_match` AmlPolicyMatchIncoming - … - `users_eligible_to_unfreeze` RequestApprover[] — list of possible approvers - … - `frozen` boolean — Whether the transaction is frozen. - `mined_result_status` 'success' | 'missing' | 'potentially_partial' - `simulation_status_result` SimulationStatusResult - `simulation_status` 'success' | 'failed' | 'reverted' | 'skipped' - `details` string, required — Details about transaction reversion if occurred. - `cosmos_transaction_type_details` union, required - CosmosMultipleMessagesTransactionDetails - `transaction_data` union, required - … - `type` 'messages', required — A transaction of multiple messages. - CosmosNativeTransferDetails - `transaction_data` union, required - … - `sender` EnrichedCosmosBechAddress, required - … - `recipient` EnrichedCosmosBechAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - `type` 'native_transfer', required — A transaction involving a native transfer from one address to another. - CosmosTokenTransferDetails - `transaction_data` union, required - … - `sender` EnrichedCosmosBechAddress, required - … - `recipient` EnrichedCosmosBechAddress, required - … - `is_internal` boolean — Is this transfer an internal transfer between two vaults. None if the transaction is incoming. - `type` 'token_transfer', required — A transaction involving a token transfer from one address to another. - `memo` string — Transaction memo. - `chain` EnrichedCosmosChain, required - `chain_type` 'cosmos', required — The type of the chain. - `unique_id` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required - `name` string, required — The full blockchain name. - `native_currency_symbol` string, required — The native currency symbol. - `native_currency_name` string, required — The native currency name. - `blockchain_explorer` BlockchainExplorer — A blockchain explorer entry point. - `transaction_url` string, uri, required - `address_url` string, uri, required - `root_url` string, uri, required - `transaction_format_url` string, uri - `address_format_url` string, uri - `asset_format_url` string, uri - `logo_url` string, uri, required — The logo URL of the chain. - `is_testnet` boolean, required — Whether the chain is on a testnet. - `is_enabled` boolean, required — Whether the chain is enabled. - `base_denom` string, required — The base denom of the chain. - `bech32_prefix` 'agoric' | 'akash' | 'archway' | 'axelar' | 'bbn' | 'celestia' | 'cosmos' | 'dydx' | 'dym' | 'inj' | 'neutron' | 'nillion' | 'noble' | 'osmo' | 'saga' | 'sei' | 'stride' | 'thor' | 'mantra', required - `sender` EnrichedCosmosBechAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - `id` string, uuid, required — The unique identifier of the vault in the Fordefi platform. - `vault_group_id` string, uuid — The unique identifier of the vault group this vault belongs to. - `vault_group_ids` string[], required — The unique identifiers of the vault groups this vault belongs to. - `name` string, required — The name of the vault. - `address` string — The address of the vault. - `state` 'active' | 'archived' | 'deleted' | 'pending' | 'aborted', required - `type` 'aptos' | 'arch' | 'black_box' | 'canton' | 'cosmos' | 'evm' | 'safe' | 'solana' | 'stacks' | 'starknet' | 'stellar' | 'sui' | 'ton' | 'tron' | 'utxo' | 'exchange', required - `logo_url` string, uri — The logo of the vault. Supported for exchange and Safe vaults. - `end_user` EndUserRef - … - `is_external_signer` boolean — Whether the vault uses an externally imported key (external signer). - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - `id` string, uuid, required — The unique identifier of the address book contact in the Fordefi platform. - `name` string, required — The name of the contact. - `address_ref` union, required - … - `type` 'cosmos', required - `address` CosmosBechAddress, required - `type` 'cosmos', required - `chain` 'cosmos_agoric-3' | 'cosmos_akashnet-2' | 'cosmos_archway-1' | 'cosmos_axelar-dojo-1' | 'cosmos_bbn-1' | 'cosmos_celestia' | 'cosmos_cosmoshub-4' | 'cosmos_dydx-mainnet-1' | 'cosmos_dydx-testnet-4' | 'cosmos_dymension_1100-1' | 'cosmos_injective-1' | 'cosmos_neutron-1' | 'cosmos_nillion-1' | 'cosmos_noble-1' | 'cosmos_osmosis-1' | 'cosmos_provider' | 'cosmos_ssc-1' | 'cosmos_pacific-1' | 'cosmos_stride-1' | 'cosmos_thorchain-1' | 'cosmos_mantra-1', required - `address` string, required — The address as bech32. - `hex_repr` string — The hex representation of the address. - `key_type` 'secp256k1' | 'ethsecp256k1' - `type` 'cosmos_transaction', required — The type of the transaction. - `hash` string — The hash of the transaction. - `explorer_url` string, uri — The URL of this transaction in a blockchain explorer. - `signers_info` SignerInfo[], required — List of signers info. - `signer_address` EnrichedCosmosBechAddress, required - `vault` VaultRef — Represents a reference to a vault in the Fordefi platform - … - `explorer_url` string, uri — The URL of a blockchain explorer that provides real-time information about the address. - `contact` ContactRef — Represents a reference to an address book contact in the Fordefi platform. - … - `type` 'cosmos', required - `address` CosmosBechAddress, required - … - `public_key` string, required — Public key in its compressed format - `account` string, required — The account number assigned by the chain. - `sequence` string, required — The sequence of this transaction. - `expected_result` CosmosTransactionResult - `message` string — In case of error, the message describes what failed. - `gas_debit` CosmosGasDebit, required - `gas_used` string, required — Gas used while processing the transaction. - `total_fee` CosmosCoinWithAmount[], required — The total fee paid. - … - `fiat_prices` Price[], required — The prices of the coins used to pay the fee. - … - `effects` CosmosEffects, required - `balance_changes` CosmosBalanceChangeEffect[], required — The aggregated balance changes of addresses. - … - `transfers` CosmosTransferEffect[], required — The transfer events of the transaction. - … - `mined_result` CosmosTransactionResult - `message` string — In case of error, the message describes what failed. - `gas_debit` CosmosGasDebit, required - `gas_used` string, required — Gas used while processing the transaction. - `total_fee` CosmosCoinWithAmount[], required — The total fee paid. - … - `fiat_prices` Price[], required — The prices of the coins used to pay the fee. - … - `effects` CosmosEffects, required - `balance_changes` CosmosBalanceChangeEffect[], required — The aggregated balance changes of addresses. - … - `transfers` CosmosTransferEffect[], required — The transfer events of the transaction. - … - `sign_doc` union - AminoSignDoc - `format` 'amino', required - `sign_doc` StdSignDoc, required - … - DirectSignDoc - `format` 'direct', required - `body` string, required — Body bytes, encoded in base64 format. - `auth_info` string, required — Auth info bytes, encoded in base64 format. - `chain` EnrichedCosmosChain, required - … - `account_number` string, required — The account number. - `signed_body` string, required — Actual body bytes that were used when signing the transaction, encoded in base64 format. - `signed_auth_info` string, required — Actual auth info that was used when signing the transaction, encoded in base64 format. - MinedSignDoc - `format` 'mined', required - `messages` string, required — The messages of the transaction. - `chain` EnrichedCosmosChain, required - … - CosmosMessage - `id` string, uuid, required — The unique identifier of the object in the Fordefi platform. - `created_at` string, date-time, required — The date and time when the object was created. - `modified_at` string, date-time, required — The date and time when the object was last modified. Any change to any field of the resource is considered a modification. - `managed_transaction_data` ManagedTransactionData - `created_by` union, required — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `aborted_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `finalized_for_signing_by` union — Represents a reference to a user in the Fordefi platform - PersonRef - … - ApiUserRef - … - ApiSignerRef - … - EndUserRef - … - SystemUserRef - … - `device_signing_request` ActionSigningRequest — Represents a device sign request for an action in the Foredefi platform - … truncated; see the full OpenAPI document linked below ## Other responses - `400` — Bad Request - `401` — Unauthorized User - `403` — Forbidden User - `408` — Request Timeout - `422` — Validation Error - `429` — Rate Limit Exceeded - `500` — Unexpected Error --- [API](https://skmtc.net/fordefi/apis/fordefi-api.md) · [All operations](https://skmtc.net/fordefi/apis/fordefi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fordefi/fordefi-api/versions/c4c28d233105/schema)