Guides
SupportStatusSign UpLogin

Withdrawing From a Gas Pump Address

Withdrawing From a Gas Pump Address assigned as a Virtual Account Deposit Address

Suggest Edits

Withdrawing from a "Slave GP Contract Address" follows the steps as described in the guide Creating a Manual Withdrawal

Steps

Step_1: Transfer an asset from a "Slave GP Contract Address"

Because you are using GP, you do not have to send funds to pay for the gas. The funds required to pay for the transaction will automatically be deducted from your "Master GP Address".

Example request:

  • The response returns the transaction ID (hash)
curl -i -X POST \
  https://api.tatum.io/v3/blockchain/sc/custodial/transfer \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {YOUR_API_KEY}' \
  -d '{
    "chain": "ETH",
    "custodialAddress": "0x5c6079c14e9cd3d2ea8cb76aed9c5e336ef96126", //The deposit address from the VA as "Slave GP Contract Address"
    "recipient": "0x42952e30fB119e0683607Ef6D5A7E8A97dBB7314", //Destination blockchain address, outside your Exchange or Application
    "contractType": 0, // zero for ERC-20 tokens
    "tokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", //The Token of the Virtual Account as "currency"
    "amount": "1",
    "fromPrivateKey": "####" // The PrivateKey of your "Master GP Address"
  }'
//Response:

{
  "txId": "0xa1bdc0008b6cce138cec38336a3cbbf1117cc56bcfe0004e14d6789a9d099b72"
}

Step_2: Create a Withdrawal in the VA ledger

This will register a VA transaction from the source account in the ledger. It debits the amount from the source VA. In the request, specify:

  • The ID of the VA to withdraw the assets from (the senderAccountId parameter)
  • The blockchain address to send the assets to (the address parameter).
  • Creating a withdrawal request to the virtual account will debit the withdrawn balance from the virtual account. This operation is done within the virtual account and is not written to the underlying blockchain.

Example request:

  • The response returns the VA log transaction reference and the ID of the withdrawal.
curl -i -X POST \
  https://api.tatum.io/v3/offchain/withdrawal \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {YOUR_API_KEY}' \
  -d '{
    "senderAccountId": "5fb7bdf6e96d9ab593e191a6", // Virtual Account ID associated with the "Slave GP Contract Address" you transferred out in step_1 
    "address": "0x42952e30fB119e0683607Ef6D5A7E8A97dBB7314", //The deposit address from the VA as "Slave GP Contract Address"
    "amount": "1",
    "fee": "0.0005"
  }'
//Response:

{
  "reference": "5e6be8e9e6aa436299950c41",
  "id": "5e68c66581f2ee32bc354087"
}

Step_3: Mark the withdrawal transaction as completed "Done"

Mark the withdrawal as successful and store the transaction hash/ID of the blockchain transaction to the withdrawal operation in the VA ledger. This step must be completed; otherwise, there will be inconsistencies within the virtual account state.

Example request:

//PUT: https://api.tatum.io/v3/offchain/withdrawal/{id}/{txId}
curl --request PUT \
     --url https://api.tatum.io/v3/offchain/withdrawal/5e68c66581f2ee32bc354087/0xa1bdc0008b6cce138cec38336a3cbbf1117cc56bcfe0004e14d6789a9d099b72 \
     --header 'accept: application/json' \
     --header 'x-api-key: {YOUR_API_KEY}'

Good to Know

  • Should the blockchain transaction fail and you already executed Step_2, you may delete the withdrawal from the VA ledger via the following v3 REST API endpoint

❗️

Virtual Accounts where the withdrawal currency is a token, it is recommended to use “revert=false".

Updated 2 months ago