Burn API

Overview

The Burn API enables you to convert universal EVM tokens (uSOL, uXRP, uSUI, uDOGE, uZEC) back into their native equivalents on the original chains (SOL, XRP, SUI, DOGE, ZEC).

How Burning Works

Create Burn Configuration: Specify destination chain and address for receiving native tokens
Receive Transfer Address: The API returns the EVM address where you should send your universal tokens
Transfer Universal Tokens: Send uAssets to the provided address on the EVM chain
Automatic Processing: The system detects the transfer and automatically initiates redemption
Receive Native Tokens: Native tokens are sent to your specified destination address

⚠️ CRITICAL WARNING: You MUST create a destination address configuration (Step 1) BEFORE sending any universal tokens to the merchant controller address. If you send tokens without first creating a burn configuration, your funds will remain locked at the merchant address and cannot be redeemed. Always call POST /burn/wallets first to set up your destination address, then send your tokens.

Important Concepts

Wallet Address Correlation

All burn operations are correlated with the EVM wallet address specified in your JWT token:

Burn configurations are associated with your EVM wallet
The system tracks which universal tokens belong to which wallet
To burn from a different EVM address, create a new JWT token for that address

Transfer Address

The uAsset transfer address (merchant address) is where you send your universal tokens for burning:

This is a centralized merchant-controlled address
Same address for all users (e.g., 0x5A6e781104b057C558f4CAed97915B67f5e71b78 on mainnet)
The system identifies your transaction by your wallet address and routes accordingly
Provided in the burn wallet creation response

Endpoints

Create Burn Wallet Configuration

Creates a burn configuration specifying where to receive redeemed native tokens.

Endpoint: POST /burn/wallets

Headers:

Authorization: Bearer <jwt_token>
Content-Type: application/json

Request Body:

{
  "destinationChain": "sol",
  "destinationAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "memo": null
}

Parameters:

destinationChain (string, required): Destination chain symbol
- Production mainnet values: sol, xrp, sui, doge, zec
destinationAddress (string, required): Your address on the destination chain where native tokens will be sent
memo (string, optional): Destination tag/memo
- Required for XRP/TXRP: Numeric destination tag (max 10 digits, max value: 4294967295)
- Optional for other chains

Response (201 Created):

{
  "success": true,
  "data": {
    "uAssetTransferAddress": "0x5A6e781104b057C558f4CAed97915B67f5e71b78",
    "destinationChain": "sol",
    "destinationAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "memo": null
  }
}

Response Fields:

uAssetTransferAddress: The EVM address where you should send universal tokens for burning
destinationChain: The chain where you'll receive native tokens
destinationAddress: Your address on the destination chain
memo: Destination tag/memo (for XRP)

cURL Example:

curl -X POST https://api.universal.xyz/issuance-redemption/burn/wallets \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "destinationChain": "sol",
    "destinationAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
  }'

XRP Example with Memo:

curl -X POST https://api.universal.xyz/issuance-redemption/burn/wallets \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "destinationChain": "xrp",
    "destinationAddress": "rN7n7otQDd6FczFgLdlqtyMVUXWqzp1GE1",
    "memo": "2740406962"
  }'

Get Burn Wallet Configurations

Retrieves all burn configurations for the authenticated wallet.

Endpoint: GET /burn/wallets

Headers:

Authorization: Bearer <jwt_token>

Response (200 OK):

{
  "success": true,
  "data": [
    {
      "uAssetTransferAddress": "0x5A6e781104b057C558f4CAed97915B67f5e71b78",
      "destinationChain": "sol",
      "destinationAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "memo": null
    },
    {
      "uAssetTransferAddress": "0x5A6e781104b057C558f4CAed97915B67f5e71b78",
      "destinationChain": "xrp",
      "destinationAddress": "rN7n7otQDd6FczFgLdlqtyMVUXWqzp1GE1",
      "memo": "2740406962"
    }
  ]
}

cURL Example:

curl -X GET https://api.universal.xyz/issuance-redemption/burn/wallets \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9..."

Update Burn Destination Address

Updates the destination address for an existing burn configuration.

Endpoint: PUT /burn/wallets

Headers:

Authorization: Bearer <jwt_token>
Content-Type: application/json

Request Body:

{
  "destinationChain": "sol",
  "destinationAddress": "5VzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtDEF",
  "memo": null
}

Response (200 OK):

{
  "success": true,
  "data": {
    "uAssetTransferAddress": "0x5A6e781104b057C558f4CAed97915B67f5e71b78",
    "destinationChain": "sol",
    "destinationAddress": "5VzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtDEF",
    "memo": null
  }
}

Supported Combinations

Source Chain (EVM)

Universal Token

Destination Chains

Native Token