Wallets

Where it lives

Wallet management is on /dashboard/wallets. You can have multiple wallets linked to a single account; one is designated primary and is used for payment attribution.

What you see on each wallet card

• Truncated address (0x1234...abcd).
• Embedded badge — appears if the wallet was created for you by Privy (when you signed in with email or Google). External wallets you connected explicitly don't carry this badge.
• Primary badge — shown on the wallet designated as your primary.
• Linked date.
• Set primary button — re-designates which wallet is primary.
• Unlink button — disabled when only one wallet is linked (you can't unlink your last wallet).

Linking another wallet

Click Connect another wallet. The flow has two steps — both must succeed for the link to land:

• Step 1 — Privy. Privy opens its modal so you can pick a wallet provider (MetaMask, Coinbase Wallet, WalletConnect, etc.) and connect. Privy returns the wallet address.
• Step 2 — Backend verification. Verdict asks the new wallet to sign an EIP-191 message proving control of the private key. The message is shaped:

Link this wallet to Verdict account <user_id> at <unix_timestamp>

The signature plus the timestamp are POSTed to /api/v1/wallets. Once the backend verifies the signature, the wallet appears on your dashboard.

Error states

• privy_failed — Privy's linking modal errored or you cancelled it. Click Connect another wallet again to retry.
• verification_failed — Privy returned the address but the signature step didn't complete (you cancelled the signature, the message was malformed, or the backend rejected). A banner appears with Retry signature — the wallet address is remembered, so retrying re-asks for the signature without going back through Privy's wallet picker.

Setting a primary wallet

Click Set primary on any non-primary wallet card. The previous primary is demoted automatically; you'll always have exactly one primary. The primary wallet is used to attribute incoming USDC payments to your account — see Subscription & Plans for the payment flow.

Unlinking a wallet

Click Unlink on any wallet card (other than your last). You'll be asked to confirm. After unlinking, that wallet can no longer:

• Sign in to this account.
• Pay for renewals on this account.
• Be re-linked without going through the full link flow again.

The unlinked wallet can be re-linked any time — the address itself isn't "consumed", just the link record is removed. Note: the same wallet can only be linked to one Verdict account at a time, so if you've linked it elsewhere, unlink there first.