Skip to main content
Verifier ID: wallet-link

​
Best For

  • Multi-wallet identity
  • Secondary ↔ primary binding (e.g. agent + controller wallets)
  • Account portability

​
Flow Type

Instant. The secondary wallet signs the linking payload. For end-user browser flows, prefer Hosted Verify at /verify. The hosted flow now stages wallet linking first:
  1. Connect the secondary wallet
  2. Sign the wallet-link payload
  3. Show Linked
  4. Continue to create the proof
Use direct/API mode only for advanced integrations that already control the secondary-wallet signature step.

​
Required Fields

FieldRequiredNotes
primaryWalletAddressYesPrimary wallet
secondaryWalletAddressYesSecondary wallet
signatureYesSecondary wallet signature
chainYesCAIP-2 chain
signedTimestampYesUnix ms timestamp

​
Example

Advanced direct/API payload after the secondary wallet has already signed: 
{
  "primaryWalletAddress": "0x...",
  "secondaryWalletAddress": "0x...",
  "signature": "0x...",
  "chain": "eip155:8453",
  "signedTimestamp": 1730000000000
}