Burn Tokens

Burns specified tokens minted from a KIP-37 contract. You can select the number and the amount of tokens burn.

From

The account that sends the transaction.

You can omit the KRN if the from address is managed by KIP-37 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}).

Batch Items

It is possible to send different tokens in different amounts. Different functions will be called according to the number of Batch Items (ids, amounts) in the request.

  • One element: the burn function
  • Multiple elements: the burnBatch function
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)

x-krn
string

The KRN (KAS Resource Name) unique to an Account Pool

Request Body schema: application/json
from
string

The owner of the token or the Kaia account address authorized to burn. The default value is the address that deployed the contract.

ids
required
Array of strings

ID of the token to burn.

amounts
required
Array of strings

Number of the token to burn (in hex.)

Responses
200

Your request was successful.

400

The request is not valid.

404

The resource you requested does not exist.

delete/v2/contract/{contract-address-or-alias}/token
Request samples
application/json
{
  • "from": "0xDc277E2D89b92336A4ee80be3c7142443FDaDE47",
  • "ids": [
    ],
  • "amounts": [
    ]
}
Response samples
application/json

Your request was successful.

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