Skip to main content

​
Wallet Management

​
Get or Create Wallet

Get or create a wallet for the given chain and return its public address. If a wallet doesn’t exist for the user and chain combination, one will be created automatically.
cURL
curl -X POST 'https://tee.express.magiclabs.com/v1/wallet' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -H 'X-Magic-API-Key: YOUR_MAGIC_API_KEY' \
  -H 'X-OIDC-Provider-ID: YOUR_OIDC_PROVIDER_ID' \
  -H 'X-Magic-Chain: ETH'
Response: 
{
  "public_address": "0x1234567890abcdef1234567890abcdef12345678"
}

​
Request Parameters

​
X-Magic-Chain
string
required
Header
The blockchain to create the wallet for. Available values: ETH, SOL, BTC

​
Response Fields

​
public_address
string
The wallet’s public address on the specified blockchain.
Each user can have one wallet per blockchain. Calling this endpoint multiple times with the same user and chain will return the same wallet address.

​
Signing Operations

​
Sign Data

Sign a hash of arbitrary data using the wallet’s private key. This is useful for signing transaction data, typed data, or any structured information.
cURL
curl -X POST 'https://tee.express.magiclabs.com/v1/wallet/sign/data' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -H 'X-Magic-API-Key: YOUR_MAGIC_API_KEY' \
  -H 'X-OIDC-Provider-ID: YOUR_OIDC_PROVIDER_ID' \
  -H 'X-Magic-Chain: ETH' \
  -d '{
    "raw_data_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
  }'
Response: 
{
  "message_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "signature": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "r": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "s": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef12345678",
  "v": "27"
}

​
Request Parameters

​
X-Magic-Chain
string
required
Header
The blockchain to sign for. Available values: ETH, SOL, BTC
​
raw_data_hash
string
required
Body
The keccak256 hash of the data to sign (hex string with 0x postfix).

​
Response Fields

​
message_hash
string
The hash that was signed.
​
signature
string
The complete signature in hex format.
​
r
string
The r component of the ECDSA signature.
​
s
string
The s component of the ECDSA signature.
​
v
string
The recovery parameter of the ECDSA signature.

​
Sign Message

Sign an arbitrary message using the wallet’s private key. Useful for authentication, off-chain verification, and personal signatures.
cURL
curl -X POST 'https://tee.express.magiclabs.com/v1/wallet/sign/message' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -H 'X-Magic-API-Key: YOUR_MAGIC_API_KEY' \
  -H 'X-OIDC-Provider-ID: YOUR_OIDC_PROVIDER_ID' \
  -H 'X-Magic-Chain: ETH' \
  -d '{
    "message_base64": "SGVsbG8gV29ybGQ="
  }'
Response: 
{
  "signature": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef12",
  "r": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "s": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef12345678",
  "v": "27"
}

​
Request Parameters

​
X-Magic-Chain
string
required
Header
The blockchain to sign for. Available values: ETH, SOL, BTC
​
message_base64
string
required
Body
The message to sign, encoded as base64.

​
Response Fields

​
signature
string
The complete signature in hex format.
​
r
string
The r component of the ECDSA signature.
​
s
string
The s component of the ECDSA signature.
​
v
string
The recovery parameter of the ECDSA signature.
⌘I