JUjubjubapp
v2 - Profiles

Add Wallet

Add a wallet address to a profile.

Validates EVM format (0x + 40 hex chars). Appends if not already present. Only the profile owner can modify their wallets, and only for a wallet they sign for (SIWE: signature + nonce from GET /v2/auth/wallet-nonce).

Why the proof (security fix, 2026-10-22): wallet_addresses is what register-viewer's SIWE re-login, x402 identity and the Farcaster FID ownership check resolve a wallet to. An address added with no signature let a caller claim a wallet they do not control: a later SIWE sign-in by its real owner landed in the caller's account, and connect-fid accepted the caller as the owner of that wallet's FID. Same rule as /wallet-rails' SIWE path, including its cross-profile 409.

post/v2/profiles/{profile_id}/wallets

Request

  • Base URL
    https://api.jubjubapp.com (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

profile_idstring required

Headers

Authorizationstring
X-JubJub-Service-Keystring
X-JubJub-Agent-Keystring
X-JubJub-Platform-Keystring
Originstring
Refererstring
X-JubJub-Trial-Tokenstring

Request body

wallet_addressstring required

EVM wallet address (0x + 40 hex chars)

signaturestring nullable
noncestring nullable

Response

Successful Response

wallet_addressesstring[] required

Changes

No recorded changes to this operation across all 1 revision of this API.