Create Badge

Create a new badge

Creates a new badge with specified metadata.

Endpoint: /game/badge/create Method: POST

Request Parameters

{
    name: string;             // Name of the badge
    symbol: string;           // Symbol of the badge
    description?: string;     // Optional description of the badge
    image?: string;          // Optional image URL for the badge
    attributes?: object[];    // Optional array of attributes
    chainId?: string;        // Optional chain ID (defaults to configured chain ID)
}

Success Response

{
    taskId: string;
    data: {
        contractAddress: string; // The address of the created badge contract
        transactionHash: string; // The hash of the creation transaction
    }
    status: string;
}

Error Response

{
  error: string;
  details?: any;
}

Example Usage

// Setup request parameters
const timestamp = Date.now().toString();
const body = {
    name: 'Game Achievement Badge',
    symbol: 'GAB',
    description: 'Badge awarded for game achievements',
    image: 'https://example.com/badge.png',
    attributes: [
        { trait_type: 'Type', value: 'Achievement' },
        { trait_type: 'Version', value: '1.0' }
    ],
    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/create', body, {
    headers: {
        apikey: apiKey,
        signature: hmac,
        timestamp: timestamp
    }
});

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