Wallet Resolver

GET /api/wallets/resolver returns the managed Solana wallets assigned to the authenticated user. Used by MCP tools, the frontend, and connectors to establish wallet context.

Request

URL: https://api.dexter.cash/api/wallets/resolver

Headers:

Authorization: Bearer <supabase_access_token>

Also accepts Dexter MCP JWTs (verified with MCP_JWT_SECRET).

Response (200)

{
  "ok": true,
  "user": { "id": "550e8400-e29b-41d4-a716-446655440000" },
  "wallets": [
    {
      "publicKey": "BRANCHVDL53igBiYuvrEfZazXJm24qKQJhyXBUm7z7V",
      "label": "Main",
      "status": "assigned",
      "metadata": null,
      "isDefault": true,
      "permissions": { "trade": true, "view": true }
    }
  ]
}

Field	Type	Description
`user.id`	string	Supabase user UUID
`wallets[].publicKey`	string	Solana public key
`wallets[].label`	string	Wallet label (nullable)
`wallets[].status`	string	Always `"assigned"` for active wallets
`wallets[].isDefault`	boolean	Primary wallet for the user
`wallets[].permissions`	object	`{ trade: boolean, view: boolean }`

If the user has no wallets, wallets is an empty array.

Errors

Status	Error	When
401	`authentication_required`	No valid token provided
500	`internal_error`	Server-side failure

Wallet Resolver

Request

Response (200)

Errors

On this page