POST
/
register
cURL
# Example 1: Managed wallet (automatic signing)
curl -X POST 'https://core-api-server.onrender.com/register' \
  -H 'Content-Type: application/json' \
  -d '{
    "contentTitle": "My Important Document",
    "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "walletType": "managed",
    "contentHash": "a7b2c3d4e5f6789abcdef0123456789abcdef0123456789abcdef0123456789"
  }'

# Example 2: Self wallet with action link (recommended)
curl -X POST 'https://core-api-server.onrender.com/register' \
  -H 'Content-Type: application/json' \
  -d '{
    "contentTitle": "My Important Document",
    "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "walletType": "self",
    "contentHash": "a7b2c3d4e5f6789abcdef0123456789abcdef0123456789abcdef0123456789",
    "returnActionLink": true
  }'
{
  "message": "✅ Success! Your file has been registered and confirmed on-chain.",
  "details": {
    "status": "submitted",
    "transactionId": "5J7X2vK8mWzNfEtY2jDw5mVpL1WzNfEtYKJH2mNqR3pB",
    "contentRegistrationPDA": "8kQv2gFhgRmHq7ZPBx4N9TqJbSx3jDw5mVpL1WzNfEtY",
    "contentHash": "a1b2c3d4e5f6789012345678901234567890abcdef123456789012345678901234",
    "ipfsCid": "QmX7Rt8VBgKdNzF4mP6YvWzNfEtY2jDw5mVpL1WzNfEtYz",
    "explorerUrl": "https://explorer.solana.com/address/8kQv2gFhgRmHq7ZPBx4N9TqJbSx3jDw5mVpL1WzNfEtY?cluster=devnet"
  }
}

​
What This Endpoint Does

1

Input Validation

Validates wallet address, content hash, and required parameters
2

IPFS Upload

Uploads file metadata to IPFS and generates Content Identifier (CID)
3

Identity Check

Automatically checks for recent identity verification and includes verified data if available
4

Blockchain Registration

Creates immutable proof record on Solana blockchain (signed automatically for managed wallets, or returns transaction for self wallets)

​
Wallet Type Flows

For Trust Engine-created wallets onlyUse "walletType": "managed" only for wallets created via /create-wallet✅ Immediate completion - Returns 200 with confirmed transaction
✅ No user action needed - Trust Engine handles all signing
✅ Instant result - Registration is complete when API call returns

Body

application/json

Response

200
application/json

Registration confirmed - Managed wallet transaction completed

The response is of type object.