Verifier ID: wallet-link
Use cases
- Multi-wallet identity
- Secondary ↔ primary binding (e.g. agent + controller wallets)
- Account portability
Flow Type
Instant. The secondary wallet signs the linking payload.
Browser UX
For end-user browser flows, prefer Hosted Verify at /verify. The hosted flow now stages wallet linking first:
- Connect the secondary wallet
- Sign the wallet-link payload
- Show Linked
- Continue to create the proof
Use direct/API mode only for advanced integrations that already control the secondary-wallet signature step.
Required Fields
| Field | Required | Notes |
|---|
primaryWalletAddress | Yes | Primary wallet |
secondaryWalletAddress | Yes | Secondary wallet |
signature | Yes | Secondary wallet signature |
chain | Yes | CAIP-2 chain |
signedTimestamp | Yes | Unix ms timestamp |
Example
Advanced direct/API payload after the secondary wallet has already signed:
{
"primaryWalletAddress": "0x...",
"secondaryWalletAddress": "0x...",
"signature": "0x...",
"chain": "eip155:84532",
"signedTimestamp": 1730000000000
}
Last modified on June 4, 2026
