auth v2

Verify and link SIWE wallet.

Changed on

Verifies the SIWE signature and links the wallet to the currently authenticated user. Requires active session.

post/link-siwe/verify

Request

  • Base URL: https://api.openfort.io/iam/v2/auth
  • URL: https://api.openfort.io/iam/v2/auth/link-siwe/verify
  • Auth: HTTP bearer and API key in header x-project-key

Request body

messagestring required

The SIWE message string that was signed

signaturestring required

The signature from the user's wallet

walletAddressstring required

Ethereum wallet address (must be 42 characters starting with 0x)

chainIdnumber

Blockchain network chain ID (must match the Chain ID in SIWE message, default: 1)

walletClientTypestring

Type of wallet client used (e.g., 'Phantom', 'MetaMask')

connectorTypestring

Type of connector used (e.g., 'injected', 'walletConnect')

Response

Wallet linked successfully

successboolean required

Whether the wallet was successfully linked

walletAddressstring required

The checksummed Ethereum address that was linked

chainIdnumber required

The blockchain network chain ID

isPrimaryboolean required

Whether this is the user's primary wallet (first wallet linked)

connectorTypestring

Type of connector used (e.g., 'injected', 'walletConnect')

walletClientTypestring

Type of wallet client used (e.g., 'Phantom', 'MetaMask')

ensNamestring

ENS name associated with the wallet (if available)

ensAvatarstring

ENS avatar URL (if available)

messagestring

Optional informational message

Changes