Skip to content

Reference

lookupAnsEntryByName

GET scan-proxy ANS lookup keyed by registered human-visible application name.

lookupAnsEntryByName resolves catalogue rows identical to lookupAnsEntryByParty but keyed lexically.

Setup

import { Canton } from '@fairmint/canton-node-sdk';

const canton = new Canton({
  network: 'devnet',
  provider: '5n',
  partyId: 'OWN_PARTY_ID',
});

Import and receiver

import { Canton } from '@fairmint/canton-node-sdk';

Receiver: canton.validator.lookupAnsEntryByName.

Minimal example

const entry = await canton.validator.lookupAnsEntryByName({ name: 'my-app' });

Parameters

  • name (required, string) — Exact advertised alias inserted URL-encoded into the REST route.

Returns

Scan-proxy JSON exposing resolved metadata for the given name.

Errors and pitfalls

  • Missing registrations bubble HTTP failures surfaced via usual SDK exception wrappers.

Auth and party

Bearer token authorized against validator scan-proxy GET endpoints.

See also

Source

src/clients/validator-api/operations/v0/ans/lookup-by-name.ts on GitHub.