Wallet Attestation

Wallet ownership verification via message signing

Generate wallet attestation challenge

post

Generate a challenge message for the given wallet address. The user must sign this message to prove ownership.

Authorizations

BearerAuthOAuth2

AuthorizationstringRequired

Clerk authentication token (session JWT or Clerk OAuth access token) used by Credit Coop

Body

application/json

addressstring · max: 42Required

EVM wallet address to attest.

Pattern: ^0x[0-9a-fA-F]{40}$

namespacestring · enumRequired

Address namespace. Currently only "eip155" (EVM) is supported.

Possible values:

Responses

200

Default Response

application/json

messagestringRequired

Challenge message to sign

noncestringRequired

Challenge nonce

expiresInintegerRequired

Nonce TTL in seconds

400

Default Response

application/json

401

Default Response

application/json

post/v3/users/me/wallets/challenge

HTTPcURLJavaScriptPython

POST /v3/users/me/wallets/challenge HTTP/1.1
Host: api.creditcoop.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "address": "text",
  "namespace": "eip155"
}

{
  "message": "text",
  "nonce": "text",
  "expiresIn": 1
}

Verify wallet attestation

post

Submit the signed attestation message to prove wallet ownership and link the address to your account.

Authorizations

BearerAuthOAuth2

AuthorizationstringRequired

Clerk authentication token (session JWT or Clerk OAuth access token) used by Credit Coop

Body

application/json

addressstring · max: 42Required

EVM wallet address being attested.

Pattern: ^0x[0-9a-fA-F]{40}$

namespacestring · enumRequired

Network namespace the user is attesting under. The signature is NOT chain-bound — for EVM ('eip155'), the same attestation covers all eip155 chains.

Possible values:

signaturestringRequired

The signed message signature from the wallet.

messagestringRequired

The attestation message that was signed (returned from the challenge endpoint).

Responses

201

Default Response

application/json

idstring · uuidRequired

addressstringRequired

networkNamespacestringRequired

verifiedAtstring · date-timeRequired

createdAtstring · date-timeRequired

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

409

Default Response

application/json

post/v3/users/me/wallets/attest

HTTPcURLJavaScriptPython

POST /v3/users/me/wallets/attest HTTP/1.1
Host: api.creditcoop.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "address": "text",
  "namespace": "eip155",
  "signature": "text",
  "message": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "address": "text",
  "networkNamespace": "text",
  "verifiedAt": "2026-07-12T06:00:52.661Z",
  "createdAt": "2026-07-12T06:00:52.661Z",
  "subscriptions": [
    {
      "type": "wallet_transactional",
      "enabled": true
    }
  ]
}

List the user's wallets (optionally including org multisigs)

get

List the user's attested EOAs. Pass ?include=multisigs to also include org-owned multisigs the user has access to.

Authorizations

BearerAuthOAuth2

AuthorizationstringRequired

Clerk authentication token (session JWT or Clerk OAuth access token) used by Credit Coop

Query parameters

includestring · enumOptional

Optional extras to include in the response. Currently only multisigs is supported.

Possible values:

Responses

200

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

get/v3/users/me/wallets

HTTPcURLJavaScriptPython

GET /v3/users/me/wallets HTTP/1.1
Host: api.creditcoop.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "wallets": [
    {
      "type": "eoa",
      "id": "text",
      "address": "text",
      "networkNamespace": "text",
      "verifiedAt": "2026-07-12T06:00:52.661Z",
      "createdAt": "2026-07-12T06:00:52.661Z",
      "networkId": "text",
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "organizationName": "text",
      "subscriptions": [
        {
          "type": "wallet_transactional",
          "enabled": true
        }
      ]
    }
  ]
}

Update email subscription preferences for the authenticated user

put

Subscribe or unsubscribe in bulk. Each change is identified by (address, networkId, type); enabled: true inserts a row, enabled: false deletes one. All cells are user-editable; defaults at wallet-create / org-join time are managed server-side.

Authorizations

BearerAuthOAuth2

AuthorizationstringRequired

Clerk authentication token (session JWT or Clerk OAuth access token) used by Credit Coop

Body

application/json

Responses

200

Default Response

application/json

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

put/v3/users/me/email-subscriptions

HTTPcURLJavaScriptPython

PUT /v3/users/me/email-subscriptions HTTP/1.1
Host: api.creditcoop.xyz
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "changes": [
    {
      "address": "text",
      "networkId": "text",
      "type": "wallet_transactional",
      "enabled": true
    }
  ]
}

{
  "wallets": [
    {
      "type": "eoa",
      "id": "text",
      "address": "text",
      "networkNamespace": "text",
      "verifiedAt": "2026-07-12T06:00:52.661Z",
      "createdAt": "2026-07-12T06:00:52.661Z",
      "networkId": "text",
      "organizationId": "123e4567-e89b-12d3-a456-426614174000",
      "organizationName": "text",
      "subscriptions": [
        {
          "type": "wallet_transactional",
          "enabled": true
        }
      ]
    }
  ]
}