Burn Badge

Burn a badge

Permanently burns a badge, removing it from circulation.

Endpoint: /game/badge/burn Method: POST

Request Parameters

{
    nft: string;              // Badge contract address
    tokenId: string;          // ID of the badge to burn
    chainId?: string;         // Optional chain ID (defaults to configured chain ID)
}

Success Response

{
    taskId: string;
    data: {
        transactionHash: string; // The hash of the burn transaction
    }
    status: string;
}

Error Response

{
  error: string;
  details?: any;
}

Example Usage

// Setup request parameters
const timestamp = Date.now().toString();
const body = {
    nft: '0x1234567890123456789012345678901234567890', // Badge contract address
    tokenId: '123', // Badge ID to burn
    chainId: '43114' // Avalanche C-Chain
};

// Generate HMAC signature
const hmac = generateHmacSignature(timestamp, body, secretKey);

// Make the API request
const response = await axios.post(apiEndpoint + '/game/badge/burn', body, {
    headers: {
        apikey: apiKey,
        signature: hmac,
        timestamp: timestamp
    }
});

// Process the response
console.log('Burn Task ID:', response.data.taskId);
console.log('Transaction Hash:', response.data.data.transactionHash);