Mint API

Overview

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

How Minting Works

Create Deposit Address: Request a deposit address for a specific token and destination chain
Receive Deposit Address: The API returns a unique deposit address
Send Tokens: Transfer native tokens to the deposit address
Automatic Processing: The system detects the deposit and automatically mints universal tokens to your EVM wallet
Track Status: Monitor the operation through the Orders API

1:1 Conversion - Zero Fees: The amount of native tokens you send equals the amount of universal tokens you receive. If you send 10 SOL, you receive 10 uSOL. No platform fees, no gas fees - completely free.

Important Concepts

Deposit Address Reusability

Key Point: Deposit addresses for mint operations can be reused without additional API interaction.

Once created, a deposit address remains valid for the specific token and destination chain combination
You can send multiple deposits to the same address
Each deposit automatically triggers a new mint workflow
No need to create a new deposit address for subsequent mints

Example: If you create an XRP deposit address for minting to Base:

The XRP address remains the same for all future mints
Simply send XRP to that address whenever you want to mint uXRP on Base
The API automatically detects each new deposit and processes it

Wallet Address Correlation

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

Universal tokens (uSOL, uXRP, etc.) are minted to this EVM address
All deposit addresses created with a specific JWT token are associated with that wallet
To mint to a different EVM address, create a new JWT token for that address

Endpoints

Create Mint Wallet (Deposit Address)

Creates a new deposit address for receiving native tokens.

Endpoint: POST /mint/wallets

Headers:

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

Request Body:

{
  "chain": "sol",
  "destinationChain": "base"
}

Parameters:

chain (string, required): Source chain symbol
- Valid values: sol, xrp, sui, doge, zec
destinationChain (string, required): Destination EVM chain symbol
- Valid values: base, arbitrum, katana, world, unichain

Response (201 Created):

{
  "success": true,
  "data": {
    "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "chain": "sol",
    "destinationChain": "base"
  }
}

Response Fields:

address: The deposit address where you should send native tokens
chain: Source chain symbol
destinationChain: Destination EVM chain symbol

cURL Example:

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

Get Mint Wallets

Retrieves all deposit addresses created for the authenticated wallet.

Endpoint: GET /mint/wallets

Headers:

Authorization: Bearer <jwt_token>

Response (200 OK):

{
  "success": true,
  "data": [
    {
      "address": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "chain": "sol",
      "destinationChain": "base"
    },
    {
      "address": "rN7n7otQDd6FczFgLdlqtyMVUXWqzp1GE1",
      "chain": "xrp",
      "destinationChain": "arbitrum"
    }
  ]
}

cURL Example:

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

Supported Combinations

Production Mainnet Only

Source Chain

Token

Destination Chains

Universal Token

sol

SOL