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 EIP-7702 Authorization

Sign an EIP-7702 authorization that delegates an EOA to a smart contract implementation. This is used to temporarily upgrade an EOA into a smart wallet for a transaction bundle, enabling features like batched calls and gas sponsorship.
cURL
curl -X POST 'https://tee.express.magiclabs.com/v1/wallet/sign/eip7702' \
  -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 '{
    "chain_id": 84532,
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "nonce": 0
  }'
Response: 
{
  "r": "12345678901234567890123456789012345678901234567890123456789012345678",
  "s": "98765432109876543210987654321098765432109876543210987654321098765432",
  "y_parity": 0
}

​
Request Parameters

​
X-Magic-Chain
string
required
Header
The blockchain to sign for. Available values: ETH
​
chain_id
number
required
Body
The chain ID for the authorization (e.g., 84532 for Base Sepolia).
​
address
string
required
Body
The smart contract address to delegate to (20-byte hex string).
​
nonce
number
required
Body
The authorization nonce.

​
Response Fields

​
r
string
The r component of the ECDSA signature (decimal string).
​
s
string
The s component of the ECDSA signature (decimal string).
​
y_parity
number
The y-parity bit (0 or 1) used for EIP-7702 signature recovery.

​
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.