Proxy Burn

Burns (destroys) currency token allowances on behalf of a user. All wallets involved in this transaction shall be the currency members of the involved currency.


Call URL

/currencies/(currencyAddress)/proxy-burns

Type : POST


Call request header parameters

Field Type Required/Optional Description Accepted values
wallet-address string Required The sender's wallet address. Any valid wallet address
wallet-key string Required The key of the sender's wallet. Any valid wallet key that unlocks the sender's wallet

Call request URL parameters

Field Type Required/Optional Description Accepted values
currencyAddress string Required The address of the involved currency. Any valid currency address

Call request body parameters

Field Type Required/Optional Description Accepted values
principalWalletAddress string Required The wallet address of the principal who has previously given allowance to a user to transact on his/her behalf. Any valid wallet address which is also a currency member of the involved currency
amountToBurn number (in string) Required The amount of currency tokens to burn Any number in a string format and is bigger than "0".

Sample Call Request

https://api.tetrium.io/tokenize/currencies/0x29341b674091d600c227B137a457b0573515A7A8/proxy-burns

Parameters:

{
   "principalWalletAddress":"0xc7731ba1b2cfb4e5fdbce6492928a7c7787e211e",
   "amountToBurn":"3"
}

Call responses

Success response

Field Type Description Respond Values
status string Status of the API call. "success"
message string Information about the status. "proxy-burn initiated"
transactionHash string The hash of the transaction. To be used to verify the transaction's sealing status. Any string

Error response

Field Type Description Respond Values
status string Status of the API call. "fail"
error string Information about the error. (See below)

Information contained in error:

Error Messages Description
"missing principalWalletAddress" principalWalletAddress was not provided as a parameter in the API call body.
"invalid principalWalletAddress" principalWalletAddress provided was not in the correct format.
"principalWalletAddress not a currency member" principalWalletAddress involved in the transaction is not a currency member.
"missing amountToBurn" amountToBurn was not provided as a parameter in the API call body.
"invalid amountToBurn" amountToBurn provided was not in the correct format.

For any other errors, please refer to List of Common Error Messages

Sample Call Response

{
   "status":"success",
   "message":"proxy-burn initiated",
   "transactionHash":"0x28d98f12f98abea8d482d93b0836b07597f487ebad5a0777ea5520ca87f53fc0"
}

results matching ""

    No results matching ""