Stacks Transfers
Native currency transfer
Recall that on Stacks chains, the gas is paid using native currency. A transfer of the entire native currency holdings will be rejected since there are not enough funds to pay for the fee. Consequently, choosing the maximum amount will empty the entire vault, transferring the entire amount, except for the fee.
Following is an example of the body of a Create Transaction.
The general details of creating the request appear here.
Example of native transfer:
{
"vault_id": "432b199b-1f71-42bf-ba0b-33d512afa9de",
"note": "note",
"signer_type": "initiator",
"sign_mode": "auto",
"dapp_info": {
"url": "string",
"name": "string"
},
"type": "stacks_transaction",
"details": {
"type": "stacks_transfer",
"fail_on_prediction_failure": true,
"skip_prediction": false,
"push_mode": "auto",
"fee": {
"type": "custom",
"total_fee": "1000000000000000000"
},
"to": {
"type": "hex",
"address": "SP3J4NWQXC312DK0GXVRZKSRFBZG8S5FG1D2160E9"
},
"value": {
"type": "value",
"value": "1000000000000000000"
},
"asset_identifier": {
"type": "stacks",
"details": {
"type": "native",
"chain": "stacks_mainnet"
}
},
"memo": "string"
}
}
Token transfer
This procedure transfers the entire holding amount.
Following is an example of the body of a Create Transaction request for a token transfer. The general details of creating the request appear here.
{
"vault_id": "432b199b-1f71-42bf-ba0b-33d512afa9de",
"note": "string",
"signer_type": "initiator",
"sign_mode": "auto",
"type": "stacks_transaction",
"details": {
"type": "stacks_transfer",
"fail_on_prediction_failure": true,
"push_mode": "auto",
"to": {
"type": "hex",
"address": "SP3J4NWQXC312DK0GXVRZKSRFBZG8S5FG1D2160E9"
},
"value": {
"type": "value",
"value": "1000000000000000000"
},
"asset_identifier": {
"type": "stacks",
"details": {
"type": "sip-10",
"sip-10": {
"chain": "stacks_mainnet",
"address": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token",
}
}
},
"skip_prediction": false
}
}Fees
On Stacks chains, the gas is paid using native currency, hence, the lack of native currency in a wallet will prevent you from doing any transaction. Transferring native currency should be done cautiously, to leave enough funds for future transactions, and in case of emptying the vault of funds, transferring native currency out of the vault should be done as the last transaction.
The fees on a native Stacks transaction are taken separately from the Stacks amount sent, so the user should make sure to have enough funds on the vault for transfer amount and expected fee.