Resolve handle against Identity Registry

GET/api/v1/resolve/{handle}

Direct registry read with no database: which wallet does the Identity Registry say owns this handle? Returns 404 when unbound, 503 unavailable when unconfigured or simulation errors.

Parameters

Parameters
Name	In	Type	Description
handle	path	string	Handle to resolve (case-insensitive).

Example request

curl example

curl -s -H "Accept: application/json" "https://signet-web-pearl.vercel.app/api/v1/resolve/alice"

@signet/sdk example

import { SignetClient } from '@signet/sdk';

const signet = new SignetClient({ baseUrl: 'https://signet-web-pearl.vercel.app' });
const result = await signet.resolveHandle('alice');

Responses

200 · The bound wallet information.

Headers: Cache-Control

Fields of a 200 response
Field	Type	Description
data	object
archived?	boolean	Whether the handle entry is currently archived on chain.
handle	string	Resolved handle in canonical lowercase.
network	string	The Stellar network this deployment is configured for.
registryContract	string	Configured Identity Registry contract address.
restorePreamble?	object	Restore preamble details from RPC simulation when archived.
wallet	string	Stellar address (G… or C…) bound to the handle, or empty if archived.

400 · Malformed handle.

404 · Handle is not bound in the registry.

429 · Rate limit exceeded.

503 · Registry unavailable or unconfigured.

Example response

Generated from the schema; real values differ.

example response

{
  "data": {
    "archived": false,
    "handle": "alice",
    "network": "string",
    "registryContract": "string",
    "restorePreamble": {},
    "wallet": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"
  }
}