Burn Token

Burns tokens. The contract's totalSupply will be reduced accordingly. You can find the totalSupply by using Get Contract.

From

The account that sends the transaction to burn tokens. If you leave it blank, it will automatically be set to the deployer address as default . You can find the deployer address by KIP7Deployer.

You can omit the KRN if the from 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
from
string

The Kaia account address whose tokens will be burned. The default value is the deployer's address'.`

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
Request samples
application/json
{
  • "from": "0x1eb15b3ccb2add3bfe132a4f6ad21ca62cf94e6d",
  • "amount": "{wrong value}"
}
Response samples
application/json

Your request was successful.

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