Documentation Index
Fetch the complete documentation index at: https://docs.handcash.io/llms.txt
Use this file to discover all available pages before exploring further.
Create embedded wallets with the Wallet API REST endpoints. Generate a secp256k1 access key pair on your server before starting.
Base URL: https://cloud.handcash.io
Headers (account steps): app-id, app-secret, Content-Type: application/json
Wallet creation must be enabled for your App ID. Contact sales@handcash.io if account creation fails with a feature or limit error. Step 1: Request email verification
POST /v1/waas/account/requestEmailCode
{ "email": "user@example.com" }
Step 2: Generate an access key pair
import { secp256k1 } from '@noble/curves/secp256k1';
const privateKey = secp256k1.utils.randomPrivateKey();
const privateKeyHex = Buffer.from(privateKey).toString('hex');
const publicKeyHex = Buffer.from(secp256k1.getPublicKey(privateKey, false)).toString('hex');
// Store privateKeyHex securely for this user — it signs all wallet API calls.
@noble/curves only for key generation; Wallet API wallet calls do not require @handcash/sdk.
Step 3: Check alias availability (optional)
GET /v1/waas/account/aliasAvailability/{alias}
Step 4: Create the wallet account
{
"email": "user@example.com",
"alias": "myuser",
"accessPublicKey": "<hex-public-key>"
}
wallet-depositInfoSchema.
const res = await fetch('https://cloud.handcash.io/v1/waas/account', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'app-id': process.env.HANDCASH_APP_ID,
'app-secret': process.env.HANDCASH_APP_SECRET,
},
body: JSON.stringify({
email: 'user@example.com',
alias: 'myuser',
accessPublicKey: publicKeyHex,
}),
});
const depositInfo = await res.json();
Step 5: Wallet operations
Use the access private key to sign requests for /v1/waas/wallet/* — balances, pay, transactions, etc. See Wallet operations.
Sequence diagram
