> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proofable.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Linked wallets

> Bind a secondary wallet to your primary Proofable account. Reuse the link across gates and apps without re-signing every time.

**Verifier ID:** `wallet-link`

## Use cases

* Multi-wallet identity
* Agent and 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`](https://proofable.me/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

| Field | Required | Notes |
| - | - | - |
| `primaryWalletAddress` | Yes | Primary wallet |
| `secondaryWalletAddress` | Yes | Secondary wallet |
| `signature` | Yes | Secondary wallet signature |
| `signatureMethod` | Yes | `eip191` for EVM, `ed25519` for non-EVM |
| `chain` | Yes | CAIP-2 chain |
| `signedTimestamp` | Yes | Unix ms timestamp |
| `relationshipType` | No | `linked` (default), `controller`, or `delegate` |
| `label` | No | Display label for the link |

Instead of `primaryWalletAddress` / `secondaryWalletAddress` + `chain`, you may pass CAIP-10 `primaryAccountId` and `secondaryAccountId`.

## Example

Advanced direct/API payload after the secondary wallet has already signed:

```json theme={"system"}
{
  "primaryWalletAddress": "0x...",
  "secondaryWalletAddress": "0x...",
  "signature": "0x...",
  "signatureMethod": "eip191",
  "chain": "eip155:8453",
  "signedTimestamp": 1730000000000
}
```

Full schema: [`wallet-link.json`](https://github.com/proofable/docs/blob/main/verifiers/schemas/wallet-link.json).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.