Skip to content

Latest commit

 

History

History
70 lines (57 loc) · 11.4 KB

TransactionResponse.md

File metadata and controls

70 lines (57 loc) · 11.4 KB

TransactionResponse

Properties

Name Type Description Notes
id string ID of the transaction. [optional] [default to undefined]
externalTxId string Unique transaction ID provided by the user. Fireblocks highly recommends setting an `externalTxId` for every transaction created, to avoid submitting the same transaction twice. [optional] [default to undefined]
status string The primary status of the transaction. For details, see Primary transaction statuses. [optional] [default to undefined]
subStatus string See Transaction substatuses for the list of transaction sub statuses. [optional] [default to undefined]
txHash string The hash of the transaction on the blockchain. * This parameter exists if at least one of the following conditions is met: 1. The transaction’s source type is `UNKNOWN`, `WHITELISTED_ADDRESS`, `NETWORK_CONNECTION`, `ONE_TIME_ADDRESS`, `FIAT_ACCOUNT` or `GAS_STATION`. 2. The transaction’s source type is `VAULT` and the status is either: `CONFIRMING`, `COMPLETED`, or was in any of these statuses prior to changing to `FAILED` or `REJECTED`. In some instances, transactions in status `BROADCASTING` will include the txHash as well. 3. The transaction’s source type is `EXCHANGE_ACCOUNT` and the transaction’s destination type is `VAULT`, and the status is either: `CONFIRMING`, `COMPLETED`, or was in any of these status prior to changing to `FAILED`. * In addition, the following conditions must be met: 1. The asset is a crypto asset (not fiat). 2. The transaction operation is not RAW or `TYPED_MESSAGE`. [optional] [default to undefined]
operation GetTransactionOperation [optional] [default to undefined]
note string Custom note, not sent to the blockchain, that describes the transaction at your Fireblocks workspace. [optional] [default to undefined]
assetId string The ID of the asset to transfer, for `TRANSFER`, `MINT`, `BURN`, `ENABLE_ASSET`,`STAKE` ,`UNSTAKE` or `WITHDRAW` operations. See the list of supported assets and their IDs on Fireblocks. [optional] [default to undefined]
source SourceTransferPeerPathResponse [optional] [default to undefined]
sourceAddress string For account based assets only, the source address of the transaction. Note: If the status is `CONFIRMING`, `COMPLETED`, or has been `CONFIRMING`; then moved forward to `FAILED` or `REJECTED`, then this parameter will contain the source address. In any other case, this parameter will be empty. [optional] [default to undefined]
tag string Source address tag for XRP, used as memo for EOS/XLM, or Bank Transfer Description for the fiat provider BLINC (by BCB Group). [optional] [default to undefined]
destination DestinationTransferPeerPathResponse [optional] [default to undefined]
destinations Array<TransactionResponseDestination> The transaction’s destinations. Note: In case the transaction is sent to a single destination, the `destination` parameter is used instead of this. [optional] [default to undefined]
destinationAddress string Address where the asset were transferred. Notes: - For Multi destination transactions, this parameter will be empty. In this case, you should refer to the destinations field. - If the status is `CONFIRMING`, `COMPLETED`, or has been `CONFIRMING`; then moved forward to `FAILED` or `REJECTED`, then this parameter will contain the destination address. In any other case, this parameter will be empty. [optional] [default to undefined]
destinationAddressDescription string Description of the address. [optional] [default to undefined]
destinationTag string Destination address tag for XRP, used as memo for EOS/XLM, or Bank Transfer Description for the fiat provider BLINC (by BCB Group). [optional] [default to undefined]
contractCallDecodedData TransactionResponseContractCallDecodedData [optional] [default to undefined]
amountInfo AmountInfo [optional] [default to undefined]
treatAsGrossAmount boolean For transactions initiated via this Fireblocks workspace, when set to `true`, the fee is deducted from the requested amount. Note: This parameter can only be considered if a transaction&#39;s asset is a base asset, such as ETH or MATIC. If the asset can&#39;t be used for transaction fees, like USDC, this parameter is ignored and the fee is deducted from the relevant base asset wallet in the source account. [optional] [default to undefined]
feeInfo FeeInfo [optional] [default to undefined]
feeCurrency string The asset which was withdrawn to pay the transaction fee, for example ETH for EVM-based blockchains, BTC for Tether Omni. [optional] [default to undefined]
networkRecords Array<NetworkRecord> In case a single transaction resulted with multiple transfers, for example a result of a contract call, then this parameter specifies each transfer that took place on the blockchain. In case of a single transfer transaction, this parameter is empty. [optional] [default to undefined]
createdAt number The transaction’s creation date and time, in unix timestamp. [optional] [default to undefined]
lastUpdated number The transaction’s last update date and time, in unix timestamp. [optional] [default to undefined]
createdBy string User ID of the initiator of the transaction. [optional] [default to undefined]
signedBy Array<string> User ID’s of the signers of the transaction. [optional] [default to undefined]
rejectedBy string User ID of the user that rejected the transaction (in case it was rejected). [optional] [default to undefined]
authorizationInfo AuthorizationInfo [optional] [default to undefined]
exchangeTxId string If the transaction originated from an exchange, this is the ID of this transaction at the exchange. [optional] [default to undefined]
customerRefId string The ID for AML providers to associate the owner of funds with transactions. [optional] [default to undefined]
amlScreeningResult AmlScreeningResult [optional] [default to undefined]
complianceResult ComplianceResult [optional] [default to undefined]
extraParameters object Additional protocol / operation specific key-value parameters: For UTXO-based blockchain input selection, add the key `inputsSelection` with the value set the input selection structure. The inputs can be retrieved from the Retrieve Unspent Inputs endpoint. For `RAW` operations, add the key `rawMessageData` with the value set to the raw message data structure. For `CONTRACT_CALL` operations, add the key `contractCallData` with the value set to the Ethereum smart contract Application Binary Interface (ABI) payload. The Fireblocks development libraries are recommended for building contract call transactions. [optional] [default to undefined]
signedMessages SignedMessages [optional] [default to undefined]
numOfConfirmations number The number of confirmations of the transaction. The number will increase until the transaction will be considered completed according to the confirmation policy. [optional] [default to undefined]
blockInfo BlockInfo [optional] [default to undefined]
index number For UTXO based assets this is the vOut, for Ethereum based, this is the index of the event of the contract call. Note: This field is not returned if a transaction uses the `destinations` object with more than one value. [optional] [default to undefined]
rewardInfo RewardInfo [optional] [default to undefined]
systemMessages SystemMessageInfo [optional] [default to undefined]
addressType string [optional] [default to undefined]
requestedAmount number The amount requested by the user. Deprecated - please use the `amountInfo` field for accuracy. [optional] [default to undefined]
amount number If the transfer is a withdrawal from an exchange, the actual amount that was requested to be transferred. Otherwise, the requested amount. Deprecated - please use the `amountInfo` field for accuracy. [optional] [default to undefined]
netAmount number The net amount of the transaction, after fee deduction. Deprecated - please use the `amountInfo` field for accuracy. [optional] [default to undefined]
amountUSD number The USD value of the requested amount. Deprecated - please use the `amountInfo` field for accuracy. [optional] [default to undefined]
serviceFee number The total fee deducted by the exchange from the actual requested amount (`serviceFee` = `amount` - `netAmount`). Deprecated - please use the `feeInfo` field for accuracy. [optional] [default to undefined]
fee number Deprecated - please use the `feeInfo` field for accuracy. [optional] [default to undefined]
networkFee number The fee paid to the network. Deprecated - please use the `feeInfo` field for accuracy. [optional] [default to undefined]
errorDescription string The transaction&#39;s revert reason. This field will be returned when `subStatus` = &#39;SMART_CONTRACT_EXECUTION_FAILED&#39;. [optional] [default to undefined]

Enum: TransactionResponseAddressTypeEnum

  • Empty (value: '')

  • Whitelisted (value: 'WHITELISTED')

  • OneTime (value: 'ONE_TIME')

[Back to top] [Back to API list] [Back to Model list] [Back to README]