Skip to content

Latest commit

 

History

History
70 lines (58 loc) · 10.3 KB

TransactionResponse.md

File metadata and controls

70 lines (58 loc) · 10.3 KB

TransactionResponse

Properties

Name Type Description Notes
id String ID of the transaction. [optional]
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]
status String The primary status of the transaction. For details, see Primary transaction statuses. [optional]
subStatus String See Transaction substatuses for the list of transaction sub statuses. [optional]
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]
operation GetTransactionOperation [optional]
note String Custom note, not sent to the blockchain, that describes the transaction at your Fireblocks workspace. [optional]
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]
source SourceTransferPeerPathResponse [optional]
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]
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]
destination DestinationTransferPeerPathResponse [optional]
destinations List<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]
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]
destinationAddressDescription String Description of the address. [optional]
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]
contractCallDecodedData TransactionResponseContractCallDecodedData [optional]
amountInfo AmountInfo [optional]
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's asset is a base asset, such as ETH or MATIC. If the asset can'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]
feeInfo FeeInfo [optional]
feeCurrency String The asset which was withdrawn to pay the transaction fee, for example ETH for EVM-based blockchains, BTC for Tether Omni. [optional]
networkRecords List<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]
createdAt BigDecimal The transaction’s creation date and time, in unix timestamp. [optional]
lastUpdated BigDecimal The transaction’s last update date and time, in unix timestamp. [optional]
createdBy String User ID of the initiator of the transaction. [optional]
signedBy List<String> User ID’s of the signers of the transaction. [optional]
rejectedBy String User ID of the user that rejected the transaction (in case it was rejected). [optional]
authorizationInfo AuthorizationInfo [optional]
exchangeTxId String If the transaction originated from an exchange, this is the ID of this transaction at the exchange. [optional]
customerRefId String The ID for AML providers to associate the owner of funds with transactions. [optional]
amlScreeningResult AmlScreeningResult [optional]
complianceResult ComplianceResult [optional]
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]
signedMessages List<SignedMessage> [optional]
numOfConfirmations BigDecimal The number of confirmations of the transaction. The number will increase until the transaction will be considered completed according to the confirmation policy. [optional]
blockInfo BlockInfo [optional]
index BigDecimal 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]
rewardInfo RewardInfo [optional]
systemMessages SystemMessageInfo [optional]
addressType AddressTypeEnum [optional]
requestedAmount BigDecimal The amount requested by the user. Deprecated - please use the `amountInfo` field for accuracy. [optional]
amount BigDecimal 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]
netAmount BigDecimal The net amount of the transaction, after fee deduction. Deprecated - please use the `amountInfo` field for accuracy. [optional]
amountUSD BigDecimal The USD value of the requested amount. Deprecated - please use the `amountInfo` field for accuracy. [optional]
serviceFee BigDecimal The total fee deducted by the exchange from the actual requested amount (`serviceFee` = `amount` - `netAmount`). Deprecated - please use the `feeInfo` field for accuracy. [optional]
fee BigDecimal Deprecated - please use the `feeInfo` field for accuracy. [optional]
networkFee BigDecimal The fee paid to the network. Deprecated - please use the `feeInfo` field for accuracy. [optional]
errorDescription String The transaction's revert reason. This field will be returned when `subStatus` = 'SMART_CONTRACT_EXECUTION_FAILED'. [optional]

Enum: AddressTypeEnum

Name Value
EMPTY ""
WHITELISTED "WHITELISTED"
ONE_TIME "ONE_TIME"