Some Mesh implementations require support for destination tags or memos. You can add this support to the Data API and Construction API implementations for your blockchain.
Use the memo
field under the metadata
object in the Data API or Construction API endpoints shown below to add the information. Enter a destination tag or memo value for the memo
field.
Read the ConstructionPreprocessRequest documentation for properties information.
/construction/preprocess
Request Schema{
"network_identifier":{
//...
},
"intent":[
//...
],
"metadata":{
//...
"memo":"SAMPLE MEMO"
//...
}
}
/construction/preprocess
Request Example{
"network_identifier":{
"blockchain":"stacks",
"network":"testnet"
},
"intent":[
{
"operation_identifier":{
"index":0
},
"type":"fee",
"account":{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
},
"amount":{
"value":"-180",
"currency":{
"symbol":"STX",
"decimals":6
}
}
},
{
"operation_identifier":{
"index":1
},
"type":"token_transfer",
"account":{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
},
"amount":{
"value":"-50",
"currency":{
"symbol":"STX",
"decimals":6
}
}
},
{
"operation_identifier":{
"index":2
},
"type":"token_transfer",
"account":{
"address":"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
},
"amount":{
"value":"50",
"currency":{
"symbol":"STX",
"decimals":6
}
}
}
],
"metadata":{
"memo":"testing"
}
}
Read the ConstructionPreprocessResponse documentation for properties information.
/construction/preprocess
Response Schema{
"options": {
//…
"memo": "SAMPLE MEMO"
//…
},
"required_public_keys": [
//…
]
}
/construction/preprocess
Response Example{
"options":{
"amount":"50",
"decimals":6,
"fee":"-180",
"memo":"testing",
"sender_address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y",
"size":180,
"symbol":"STX",
"token_transfer_recipient_address":"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6",
"type":"token_transfer"
},
"required_public_keys":[
{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
}
]
}
Read the ConstructionMetadataRequest documentation for properties information.
/construction/metadata
Request Schema{
"network_identifier": {
//…
},
"metadata": {
//…
"memo": "SAMPLE MEMO"
//…
},
"public_keys": [
//…
]
}
/construction/metadata
Request Example{
"network_identifier":{
"blockchain":"stacks",
"network":"testnet"
},
"metadata":{
"amount":"50",
"decimals":6,
"fee":"-180",
"memo":"testing",
"sender_address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y",
"size":180,
"symbol":"STX",
"token_transfer_recipient_address":"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6",
"type":"token_transfer"
},
"public_keys":[
{
"hex_bytes":"02b087ca52f40fdfdf4b16a0bbf7e91e4db2e183ac5c6491a5f60a5450e25de7d0",
"curve_type":"secp256k1"
}
]
}
Read the ConstructionMetadataResponse documentation for properties information.
/construction/metadata
Response Schema{
"metadata": {
//…
"memo": "SAMPLE MEMO"
//…
},
"suggested_fee": [
//…
]
}
/construction/metadata
Response Example{
"metadata":{
"account_sequence":8,
"amount":"50",
"decimals":6,
"fee":"-180",
"memo":"testing",
"recent_block_hash":"0x4f4a5ccf2a85e42951dbc039e4aab4f71be710957cc278135c68818a38645adb",
"sender_address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y",
"size":180,
"symbol":"STX",
"token_transfer_recipient_address":"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6",
"type":"token_transfer"
},
"suggested_fee":[
{
"value":"180",
"currency":{
"symbol":"STX",
"decimals":6
}
}
]
}
Read the ConstructionPayloadsRequest documentation for properties information.
/construction/payloads
Request Schema{
"network_identifier": {
//…
},
"intent": [
//…
],
"metadata": {
//…
"memo": "SAMPLE MEMO"
//…
},
"public_keys": [
//…
]
}
/construction/payloads
Request Example{
"network_identifier":{
"blockchain":"stacks",
"network":"testnet"
},
"intent":[
{
"operation_identifier":{
"index":0
},
"type":"fee",
"account":{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
},
"amount":{
"value":"-180",
"currency":{
"symbol":"STX",
"decimals":6
}
}
},
{
"operation_identifier":{
"index":1
},
"type":"token_transfer",
"account":{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
},
"amount":{
"value":"-50",
"currency":{
"symbol":"STX",
"decimals":6
}
}
},
{
"operation_identifier":{
"index":2
},
"type":"token_transfer",
"account":{
"address":"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
},
"amount":{
"value":"50",
"currency":{
"symbol":"STX",
"decimals":6
}
}
}
],
"metadata":{
"account_sequence":8,
"amount":"50",
"decimals":6,
"fee":"-180",
"memo":"testing",
"recent_block_hash":"0x4f4a5ccf2a85e42951dbc039e4aab4f71be710957cc278135c68818a38645adb",
"sender_address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y",
"size":180,
"symbol":"STX",
"token_transfer_recipient_address":"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6",
"type":"token_transfer"
},
"public_keys":[
{
"hex_bytes":"02b087ca52f40fdfdf4b16a0bbf7e91e4db2e183ac5c6491a5f60a5450e25de7d0",
"curve_type":"secp256k1"
}
]
}
Read the ConstructionPayloadsResponse documentation for properties information.
/construction/payloads
Response SchemaThe unsigned_transaction
field (type: string) includes the destination tag or memo value in the unsigned_transaction
hash.
{
"unsigned_transaction":"abcdef1234",
"payloads":[
{
//..
}
]
}
/construction/payloads
Response Example{
"unsigned_transaction":"0x8080000000040043596b5386f466863e25658ddf94bd0fadab0048000000000000000800000000000000b400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003020000000000051a164247d6f2b425ac5771423ae6c80c754f7172b0000000000000003274657374696e67000000000000000000000000000000000000000000000000000000",
"payloads":[
{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y",
"hex_bytes":"a29c75ebde36ebb6aa8ef3e54b1195b53ec840f8f71babbae820e9f4f3ab82ff",
"account_identifier":{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
},
"signature_type":"ecdsa_recovery"
}
]
}
Read the ConstructionParseRequest documentation for properties information.
/construction/parse
Request SchemaThe transaction
field (type:string) includes the destination tag or memo value in the unsigned (since signed
is false) transaction
hash.
{
"network_identifier": {
"blockchain": "stacks",
"network": "testnet",
"sub_network_identifier": {
"network": "shard 1",
"metadata": {
"producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
}
}
},
"signed": false,
"transaction": "abcdef1234"
}
/construction/parse
Request Example{
"network_identifier":{
"blockchain":"stacks",
"network":"testnet"
},
"signed":false,
"transaction":"0x8080000000040043596b5386f466863e25658ddf94bd0fadab0048000000000000000800000000000000b400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003020000000000051a164247d6f2b425ac5771423ae6c80c754f7172b0000000000000003274657374696e67000000000000000000000000000000000000000000000000000000"
}
Read the ConstructionParseaResponse documentation for properties information.
/construction/parse
Response Schema{
"operations": [
],
"signers": null,
"metadata": {
//…
"memo": "SAMPLE MEMO"
//…
}
}
/construction/parse
Response Example{
"operations":[
{
"operation_identifier":{
"index":0
},
"type":"fee",
"status":"",
"account":{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
},
"amount":{
"value":"-180",
"currency":{
"symbol":"STX",
"decimals":6
}
}
},
{
"operation_identifier":{
"index":1
},
"type":"token_transfer",
"status":"",
"account":{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
},
"amount":{
"value":"-50",
"currency":{
"symbol":"STX",
"decimals":6
}
},
"coin_change":{
"coin_identifier":{
"identifier":"0x7601dd2c00b4da4394c6568111ad722a9d35f675f987690bcee1086ea34ade92:1"
},
"coin_action":"coin_spent"
}
},
{
"operation_identifier":{
"index":2
},
"related_operations":[
{
"index":1
}
],
"type":"token_transfer",
"status":"",
"account":{
"address":"STB44HYPYAT2BB2QE513NSP81HTMYWBJP02HPGK6"
},
"amount":{
"value":"50",
"currency":{
"symbol":"STX",
"decimals":6
}
},
"coin_change":{
"coin_identifier":{
"identifier":"0x7601dd2c00b4da4394c6568111ad722a9d35f675f987690bcee1086ea34ade92:2"
},
"coin_action":"coin_created"
}
}
],
"signers":null,
"metadata":{
"memo":"testing"
}
}
Read the Block documentation for properties information.
/block
Response Schema{
"block":{
"block_identifier":{
//...
},
"parent_block_identifier":{
//...
},
"timestamp":"time",
"transactions":[
{
"transaction_identifier":{
//...
},
"operations":[
//...
],
"metadata":{
"memo":"SAMPLE MEMO"
}
}
]
}
}
/block
Response Example{
"block":{
"block_identifier":{
"index":16359,
"hash":"0x0dc231285c2ddc74c4c9e93e9ce754aed04368306069d15b47938308049c473c"
},
"parent_block_identifier":{
"index":16358,
"hash":"0x49048b0c1eceb626012c911b61f5250ff6073f44ef8c9bf5800ee76aa270d96d"
},
"timestamp":1634820076000,
"transactions":[
{
"transaction_identifier":{
"hash":"0x5b4146351bf941ffb12b66ea0f14dc8b21f4b119d2adbaf8bdf6e8bc3582c0e0"
},
"operations":[
{
"operation_identifier":{
"index":0
},
"type":"fee",
"status":"success",
"account":{
"address":"ST2QKZ4FKHAH1NQKYKYAYZPY440FEPK7GZ1R5HBP2"
},
"amount":{
"value":"-180",
"currency":{
"decimals":6,
"symbol":"STX"
}
}
},
{
"operation_identifier":{
"index":1
},
"type":"token_transfer",
"status":"success",
"account":{
"address":"ST2QKZ4FKHAH1NQKYKYAYZPY440FEPK7GZ1R5HBP2"
},
"amount":{
"value":"-500000000",
"currency":{
"decimals":6,
"symbol":"STX"
}
},
"coin_change":{
"coin_action":"coin_spent",
"coin_identifier":{
"identifier":"0x5b4146351bf941ffb12b66ea0f14dc8b21f4b119d2adbaf8bdf6e8bc3582c0e0:1"
}
}
},
{
"operation_identifier":{
"index":2
},
"related_operations":[
{
"index":1
}
],
"type":"token_transfer",
"status":"success",
"account":{
"address":"ST11NJTTKGVT6D1HY4NJRVQWMQM7TVAR091EJ8P2Y"
},
"amount":{
"value":"500000000",
"currency":{
"decimals":6,
"symbol":"STX"
}
},
"coin_change":{
"coin_action":"coin_created",
"coin_identifier":{
"identifier":"0x5b4146351bf941ffb12b66ea0f14dc8b21f4b119d2adbaf8bdf6e8bc3582c0e0:2"
}
}
}
],
"metadata":{
"memo":"Faucet"
}
}
]
}
}
Was this page helpful?