Burn Authorized Tokens

Burns the tokens from the amount that the spender is authorized to send, as specified by the owner. The remaining balance of the tokens that the sender is allowed to send can be found via Get Token Balance.

Spender

The account that sends the transaction.

You can omit the KRN if the spender address is managed by the KIP-7 or Wallet Service account-pool.
Otherwise you have to provide the KRN object in the header (x-krn: krn:{chain-id}:wallet:{account-id}:account-pool:{pool name}).

Request
Security:
basic
path Parameters
contract-address-or-alias
required
string

Contract address (in hex.) or alias.

header Parameters
x-chain-id
required
string

Kaia Network Chain ID (1001 or 8217)

Request Body schema: application/json
owner
required
string

The Kaia account address of the owner of the tokens to be burned.

spender
required
string

The Kaia account address whose authorized tokens will be burned.

amount
required
string

The amount of tokens to burn (in hex.)

Responses
200

Your request was successful.

400

Your request is not valid.

401

The credential you entered is invalid.

404

The resource you requested doesn't exist.

delete/v1/contract/{contract-address-or-alias}/burn-from
Request samples
application/json
{
  • "owner": "0x1eb15b3ccb2add3bfe132a4f6ad21ca62cf94e6d",
  • "spender": "{wrong address}",
  • "amount": "0x100"
}
Response samples
application/json

Your request was successful.

{
  • "status": "Submitted",
  • "transactionHash": "0x60412f876bfb8ae9953caa47be11cd5961a591198e09c25bb8cc3b26e416a862"
}