Auth - Wallet

Link a Web3 wallet to the authenticated user's account.

Requirements:

  • Valid signature proving wallet ownership (EIP-191 personal_sign)
  • Wallet not already linked to any other account
  • Valid, unexpired nonce from POST /wallet/nonce

Note: Users can link multiple wallets to their account. Each wallet can only be linked to ONE account in the entire system.

post/api/v1/auth/wallet/link

Request

  • The document declares no server URL.
  • Auth
    • OAuth 2
      Authorization codehttps://auth.mor.org/oauth2/authorize
      Token URLhttps://auth.mor.org/oauth2/token
      Scopesaws.cognito.signin.user.admin, openid, email, profile
    • or HTTP bearer

Request body

wallet_addressstring required

Ethereum wallet address (0x prefixed, 40 hex characters)

signaturestring required

EIP-191 signature of the message (0x prefixed hex string)

messagestring required

The exact message that was signed

noncestring required

The nonce received from POST /wallet/nonce

timestampstring required

ISO 8601 timestamp when the message was constructed

Response

Successful Response

idinteger required

Wallet link ID

wallet_addressstring required

The linked wallet address (checksummed)

staked_amountstring

Staked MOR amount in wei (as string for precision)

linked_atstring date-time required

Timestamp when the wallet was linked

updated_atstring date-time required

Timestamp when the wallet was last updated

Changes