Badge

Overview of Badge API endpoints

The Badge API provides endpoints for managing game badges (ERC-721 tokens) in the system. These endpoints allow you to create, mint, transfer, burn, and query badge information.

Available Endpoints

Creation

• Create Badge - Create a new badge

• Create Badge by Signature - Create a badge using a signature

Minting

• Mint Badge - Mint a badge to a recipient

Management

• Remove Badge - Remove a badge

• Remove Badge by Signature - Remove a badge using a signature

• Burn Badge - Burn a badge

• Transfer Badge - Transfer a badge to another address

Queries

• Get Badge Balance - Get badge balance for an address

• List Badges - List badges owned by an address

• Get Badge Info - Get detailed information about a badge

• Get Badge Count - Get total count of badges

• Get Badge by ID - Get badge information by ID

• Get Badge Owner - Get the owner of a badge

• Check Badge Burn Status - Check if a badge is burnt

Authentication

All endpoints require HMAC authentication using the hmacAuth('user') middleware. Make sure to include the following headers in your requests:

• apikey: Your API key

• signature: HMAC signature

• timestamp: Current timestamp

Chain ID

Most endpoints require a chain ID to be specified. This can be done either in the request body or through the checkChainId middleware.