Skip to main content
Use wallet-link when a user needs to prove that multiple wallets belong to the same identity or workflow.

​
Best For

  • multi-wallet identity
  • agent and controller relationships
  • app account portability

​
Flow Type

Instant. The secondary wallet signs the linking payload.

​
Required Fields

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

​
Example

{
  "primaryWalletAddress": "0x...",
  "secondaryWalletAddress": "0x...",
  "signature": "0x...",
  "chain": "eip155:8453",
  "signedTimestamp": 1730000000000
}