Skip to content

Reference

getFeaturedAppRightContractDetails

Resolve featured-app disclosure blobs plus synchronizer IDs for the configured validator acting party.

Flow:

  1. validatorApi.getPartyId() → party under test.
  2. lookupFeaturedAppRight({ partyId }) — must succeed with non-null contract.
  3. getAmuletRules() supplies domain_id fallback because featured-apps endpoint may omit synchronizer IDs.

Throws OperationError MISSING_CONTRACT when lookup absent.

Setup

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

const canton = new Canton({
  network: 'NETWORK_NAME',
  partyId: 'PARTY_ID',
});

Minimal example

const disclosed = await getFeaturedAppRightContractDetails(canton.validator);

console.log(disclosed.contractId, disclosed.synchronizerId);

Parameters

  • validatorApiValidatorApiClient exposing lookupFeaturedAppRight + getAmuletRules.

Returns

Promise<DisclosedContract> — Fields contractId, templateId, createdEventBlob, synchronizerId.

Errors

Throws OperationError MISSING_CONTRACT when featured contract absent.

Auth and party

Uses validatorApi.getPartyId() automatically — configure partyId on Canton instance beforehand.

Source

src/utils/contracts/featuredAppRight.ts