@fairmint/canton-node-sdk 0.0.268 → 0.0.269

package/build/src/da-registry/api-client.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Digital Asset's off-ledger Registry API (`https://api.utilities.digitalasset[-staging|-dev].com`).
+ *
+ * The registry's transfer rule, factories, credentials and receivers' preapprovals are not visible to every submitter,
+ * so a transaction first fetches them here as a choice context plus disclosed contracts.
+ *
+ * The API is public and unauthenticated, so this client does not use the SDK's runtime configuration; pass the base URL
+ * for the network (and optionally a pre-configured axios instance for tests or custom transports).
+ */
+import { type AxiosInstance } from 'axios';
+import { type DisclosedContract } from '../utils/ledger';
+import { type TokenStandardV1Transfer } from '../utils/token-standard';
+export interface DaRegistryChoiceContext {
+    choiceContextData: {
+        values: Record<string, unknown>;
+    };
+    disclosedContracts: DisclosedContract[];
+}
+export interface DaRegistryFactoryWithContext {
+    factoryId: string;
+    choiceContext: DaRegistryChoiceContext;
+}
+/** `direct`: the receiver's preapproval lands the transfer in one step. `offer`: a two-step instruction. */
+export type DaRegistryTransferKind = 'direct' | 'offer' | 'self';
+export interface DaRegistryTransferFactoryWithContext extends DaRegistryFactoryWithContext {
+    transferKind: DaRegistryTransferKind;
+}
+export interface DaRegistryInstrumentId {
+    admin: string;
+    id: string;
+}
+export interface DaRegistryApi {
+    operatorParty: () => Promise<string>;
+    /** `null` when DA does not know the registrar (404). */
+    registryInfo: (registrar: string) => Promise<Record<string, unknown> | null>;
+    /** `null` when DA does not know the instrument (404). */
+    instrumentMetadata: (registrar: string, instrumentId: string) => Promise<Record<string, unknown> | null>;
+    /** `null` while DA has not indexed the registrar's factory or the instrument (404). */
+    mintOfferFactory: (holder: string, instrumentId: DaRegistryInstrumentId) => Promise<DaRegistryFactoryWithContext | null>;
+    /** The factory a sender exercises `TransferFactory_Transfer` on, and its context. Read only. */
+    transferFactory: (admin: string, transfer: TokenStandardV1Transfer) => Promise<DaRegistryTransferFactoryWithContext>;
+}
+/** The ledger rejects disclosed contracts with extra fields, and DA's responses carry debug fields. */
+export declare function parseDaRegistryDisclosedContract(raw: unknown): DisclosedContract;
+export declare function parseDaRegistryChoiceContext(raw: unknown): DaRegistryChoiceContext;
+export declare function createDaRegistryApi(baseUrl: string, http?: AxiosInstance): DaRegistryApi;
+//# sourceMappingURL=api-client.d.ts.map

package/build/src/da-registry/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../../src/da-registry/api-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAc,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAGlD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACvD,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,uBAAuB,CAAC;CACxC;AAED,4GAA4G;AAC5G,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,oCAAqC,SAAQ,4BAA4B;IACxF,YAAY,EAAE,sBAAsB,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,wDAAwD;IACxD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7E,yDAAyD;IACzD,kBAAkB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACzG,uFAAuF;IACvF,gBAAgB,EAAE,CAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,sBAAsB,KACjC,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAClD,gGAAgG;IAChG,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,KAAK,OAAO,CAAC,oCAAoC,CAAC,CAAC;CACtH;AAID,uGAAuG;AACvG,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAchF;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,uBAAuB,CAalF;AAQD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,aAAqD,GAC1D,aAAa,CAsEf"}

package/build/src/da-registry/api-client.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDaRegistryDisclosedContract = parseDaRegistryDisclosedContract;
+exports.parseDaRegistryChoiceContext = parseDaRegistryChoiceContext;
+exports.createDaRegistryApi = createDaRegistryApi;
+/**
+ * Digital Asset's off-ledger Registry API (`https://api.utilities.digitalasset[-staging|-dev].com`).
+ *
+ * The registry's transfer rule, factories, credentials and receivers' preapprovals are not visible to every submitter,
+ * so a transaction first fetches them here as a choice context plus disclosed contracts.
+ *
+ * The API is public and unauthenticated, so this client does not use the SDK's runtime configuration; pass the base URL
+ * for the network (and optionally a pre-configured axios instance for tests or custom transports).
+ */
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("../core/errors");
+const utils_1 = require("../core/utils");
+const TIMEOUT_MS = 30000;
+/** The ledger rejects disclosed contracts with extra fields, and DA's responses carry debug fields. */
+function parseDaRegistryDisclosedContract(raw) {
+    const c = raw;
+    const fields = ['templateId', 'contractId', 'createdEventBlob', 'synchronizerId'];
+    for (const field of fields) {
+        if (typeof c[field] !== 'string' || c[field] === '') {
+            throw new errors_1.ValidationError(`DA API returned a disclosed contract without ${field}`);
+        }
+    }
+    return {
+        templateId: c['templateId'],
+        contractId: c['contractId'],
+        createdEventBlob: c['createdEventBlob'],
+        synchronizerId: c['synchronizerId'],
+    };
+}
+function parseDaRegistryChoiceContext(raw) {
+    const c = (raw ?? {});
+    const values = c.choiceContextData?.values;
+    if (values !== undefined && !(0, utils_1.isRecord)(values)) {
+        throw new errors_1.ValidationError('DA API returned a choice context whose values are not a record');
+    }
+    if (c.disclosedContracts !== undefined && !Array.isArray(c.disclosedContracts)) {
+        throw new errors_1.ValidationError('DA API returned disclosed contracts that are not a list');
+    }
+    return {
+        choiceContextData: { values: values ?? {} },
+        disclosedContracts: (c.disclosedContracts ?? []).map(parseDaRegistryDisclosedContract),
+    };
+}
+function toFactoryWithContext(raw, what) {
+    const r = (raw ?? {});
+    if (typeof r.factoryId !== 'string')
+        throw new errors_1.ValidationError(`DA API ${what} response has no factoryId`);
+    return { factoryId: r.factoryId, choiceContext: parseDaRegistryChoiceContext(r.choiceContext) };
+}
+function createDaRegistryApi(baseUrl, http = axios_1.default.create({ timeout: TIMEOUT_MS })) {
+    const tokenStandard = (registrar) => `${baseUrl}/api/token-standard/v0/registrars/${encodeURIComponent(registrar)}`;
+    async function getOrNull(url) {
+        try {
+            const { data } = await http.get(url);
+            // A successful body must be a record; a `null` body would masquerade as the 404 sentinel below.
+            if (!(0, utils_1.isRecord)(data))
+                throw new errors_1.ValidationError(`DA API GET ${url} returned a malformed body`);
+            return data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error) && error.response?.status === 404)
+                return null;
+            throw describe(error, `GET ${url}`);
+        }
+    }
+    async function post(url, body) {
+        try {
+            const { data } = await http.post(url, body);
+            // A successful body must be a record; anything else would fail later with a raw TypeError.
+            if (!(0, utils_1.isRecord)(data))
+                throw new errors_1.ValidationError(`DA API POST ${url} returned a malformed body`);
+            return data;
+        }
+        catch (error) {
+            throw describe(error, `POST ${url}`);
+        }
+    }
+    async function postOrNull(url, body) {
+        try {
+            const { data } = await http.post(url, body);
+            // A successful body must be a record; a `null` body would masquerade as the 404 sentinel below.
+            if (!(0, utils_1.isRecord)(data))
+                throw new errors_1.ValidationError(`DA API POST ${url} returned a malformed body`);
+            return data;
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error) && error.response?.status === 404)
+                return null;
+            throw describe(error, `POST ${url}`);
+        }
+    }
+    return {
+        async operatorParty() {
+            const data = await getOrNull(`${baseUrl}/api/utilities/v0/operator`);
+            const partyId = data?.['partyId'];
+            if (typeof partyId !== 'string')
+                throw new errors_1.ValidationError('DA API did not return its operator party');
+            return partyId;
+        },
+        registryInfo: async (registrar) => getOrNull(`${tokenStandard(registrar)}/registry/metadata/v1/info`),
+        instrumentMetadata: async (registrar, instrumentId) => getOrNull(`${tokenStandard(registrar)}/registry/metadata/v1/instruments/${encodeURIComponent(instrumentId)}`),
+        async mintOfferFactory(holder, instrumentId) {
+            const raw = await postOrNull(`${baseUrl}/api/utilities/v0/registry/mint/v0/offer`, { holder, instrumentId });
+            return raw === null ? null : toFactoryWithContext(raw, 'mint offer');
+        },
+        async transferFactory(admin, transfer) {
+            const raw = await post(`${tokenStandard(admin)}/registry/transfer-instruction/v1/transfer-factory`, {
+                choiceArguments: {
+                    expectedAdmin: admin,
+                    // The V1 choice argument requires `meta`; the public transfer input lets callers omit it.
+                    transfer: { ...transfer, meta: transfer.meta ?? { values: {} } },
+                    extraArgs: { context: { values: {} }, meta: { values: {} } },
+                },
+                excludeDebugFields: true,
+            });
+            const { transferKind } = raw;
+            if (transferKind !== 'direct' && transferKind !== 'offer' && transferKind !== 'self') {
+                throw new errors_1.ValidationError(`DA API transfer factory returned transferKind ${String(transferKind)}`);
+            }
+            return { ...toFactoryWithContext(raw, 'transfer factory'), transferKind };
+        },
+    };
+}
+function describe(error, request) {
+    if (axios_1.default.isAxiosError(error)) {
+        const body = error.response?.data === undefined ? '' : ` ${JSON.stringify(error.response.data)}`;
+        const status = error.response?.status;
+        return new errors_1.ApiError(`${request} failed: ${status ?? error.code ?? 'no response'}${body}`, status, error.response?.statusText, error.response?.data);
+    }
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=api-client.js.map

package/build/src/da-registry/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../../src/da-registry/api-client.ts"],"names":[],"mappings":"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"}

package/build/src/da-registry/choice-context.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Choice contexts for Digital Asset's Registry.
+ *
+ * The registry's transfer rule, factories and credentials are not visible to every submitter, so a transaction supplies
+ * the contracts it references as a choice context (`extraArgs.context.values`) plus disclosed contracts fetched from
+ * DA's off-ledger API (see `api-client.ts`).
+ */
+/** Keys of a DA Registry choice context (`extraArgs.context.values`). */
+export declare const DA_REGISTRY_CONTEXT_KEYS: {
+    readonly instrumentConfiguration: 'utility.digitalasset.com/instrument-configuration';
+    readonly issuerCredentials: 'utility.digitalasset.com/issuer-credentials';
+};
+/** Splice `ExtraArgs` with an empty `meta`. */
+export declare function daRegistryExtraArgs(context: {
+    values: Record<string, unknown>;
+}): Record<string, unknown>;
+/**
+ * The context a registrar-side mint needs, built from the registrar's own contracts: the registrar signs the
+ * configuration and its issuer-held credentials, so no disclosure or DA lookup is needed.
+ */
+export declare function mintChoiceContext(instrumentConfigurationCid: string, credentialCids: string[]): {
+    values: Record<string, unknown>;
+};
+//# sourceMappingURL=choice-context.d.ts.map

package/build/src/da-registry/choice-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice-context.d.ts","sourceRoot":"","sources":["../../../src/da-registry/choice-context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yEAAyE;AACzE,eAAO,MAAM,wBAAwB;aACnC,uBAAuB,EAAE,mDAAmD;aAC5E,iBAAiB,EAAE,6CAA6C;CACxD,CAAC;AAEX,+CAA+C;AAC/C,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,0BAA0B,EAAE,MAAM,EAClC,cAAc,EAAE,MAAM,EAAE,GACvB;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAUrC"}

package/build/src/da-registry/choice-context.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Choice contexts for Digital Asset's Registry.
+ *
+ * The registry's transfer rule, factories and credentials are not visible to every submitter, so a transaction supplies
+ * the contracts it references as a choice context (`extraArgs.context.values`) plus disclosed contracts fetched from
+ * DA's off-ledger API (see `api-client.ts`).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DA_REGISTRY_CONTEXT_KEYS = void 0;
+exports.daRegistryExtraArgs = daRegistryExtraArgs;
+exports.mintChoiceContext = mintChoiceContext;
+/** Keys of a DA Registry choice context (`extraArgs.context.values`). */
+exports.DA_REGISTRY_CONTEXT_KEYS = {
+    instrumentConfiguration: 'utility.digitalasset.com/instrument-configuration',
+    issuerCredentials: 'utility.digitalasset.com/issuer-credentials',
+};
+/** Splice `ExtraArgs` with an empty `meta`. */
+function daRegistryExtraArgs(context) {
+    return { context, meta: { values: {} } };
+}
+/**
+ * The context a registrar-side mint needs, built from the registrar's own contracts: the registrar signs the
+ * configuration and its issuer-held credentials, so no disclosure or DA lookup is needed.
+ */
+function mintChoiceContext(instrumentConfigurationCid, credentialCids) {
+    return {
+        values: {
+            [exports.DA_REGISTRY_CONTEXT_KEYS.instrumentConfiguration]: { tag: 'AV_ContractId', value: instrumentConfigurationCid },
+            [exports.DA_REGISTRY_CONTEXT_KEYS.issuerCredentials]: {
+                tag: 'AV_List',
+                value: credentialCids.map((cid) => ({ tag: 'AV_ContractId', value: cid })),
+            },
+        },
+    };
+}
+//# sourceMappingURL=choice-context.js.map

package/build/src/da-registry/choice-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"choice-context.js","sourceRoot":"","sources":["../../../src/da-registry/choice-context.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;AAEH,yEAAyE;AAC5D,QAAA,wBAAwB,GAAG;IACtC,uBAAuB,EAAE,mDAAmD;IAC5E,iBAAiB,EAAE,6CAA6C;CACxD,CAAC;AAEX,+CAA+C;AAC/C,6BAAoC,OAA4C;IAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,2BACE,0BAAkC,EAClC,cAAwB;IAExB,OAAO;QACL,MAAM,EAAE;YACN,CAAC,QAAA,wBAAwB,CAAC,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,0BAA0B,EAAE;YAC/G,CAAC,QAAA,wBAAwB,CAAC,iBAAiB,CAAC,EAAE;gBAC5C,GAAG,EAAE,SAAS;gBACd,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;aAC3E;SACF;KACF,CAAC;AACJ,CAAC"}

package/build/src/da-registry/commands.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Typed Ledger API command builders for Digital Asset's Registry: provider and registrar onboarding, instrument
+ * configuration, credentials, transfer preapprovals, minting and transfers.
+ *
+ * Names and argument shapes come from DA's published Daml models (bundle 0.14.4, see {@link DA_REGISTRY_PACKAGES}); DA's
+ * terms make the source confidential, so nothing here copies it.
+ */
+import { type LedgerCommand } from '../utils/ledger';
+import { type TokenStandardV1Transfer } from '../utils/token-standard';
+import { type DaRegistryTemplateKey } from './templates';
+import { type ClaimSpec, type PartyCredentialRequirement, partySet } from './readers';
+export declare function requestProviderService(operator: string, provider: string): LedgerCommand;
+export declare function createProviderConfiguration(providerServiceCid: string): LedgerCommand;
+export declare function archiveAndCreateProviderConfiguration(providerServiceCid: string, cid: string): LedgerCommand;
+/** Creates the registrar request and accepts it as provider in one transaction, when one party holds both roles. */
+export declare function requestAndAcceptRegistrarService(operator: string, registrarAndProvider: string, providerConfigurationCid: string): LedgerCommand;
+export declare function acceptRegistrarServiceRequest(requestCid: string, providerConfigurationCid: string): LedgerCommand;
+export declare function deleteRejectedRegistrarServiceRequest(cid: string): LedgerCommand;
+export declare function createTransferRule(registrarServiceCid: string): LedgerCommand;
+export declare function createAllocationFactory(registrarServiceCid: string): LedgerCommand;
+export interface InstrumentConfigurationPayload {
+    instrumentId: string;
+    /**
+     * Additional `InstrumentIdentifier` records for the instrument, in DA's Daml JSON encoding (an identifier carries at
+     * least `id` and `scheme`; `DA_REGISTRAR_INTERNAL_SCHEME` is the scheme for registrar-defined instruments). Empty
+     * when the instrument has a single identifier.
+     */
+    additionalIdentifiers: Array<Record<string, unknown>>;
+    issuerRequirements: PartyCredentialRequirement[];
+    holderRequirements: PartyCredentialRequirement[];
+    useBlockList: boolean;
+}
+export declare function createInstrumentConfiguration(registrarServiceCid: string, payload: InstrumentConfigurationPayload): LedgerCommand;
+export declare function archiveAndCreateInstrumentConfiguration(registrarServiceCid: string, cid: string, payload: InstrumentConfigurationPayload): LedgerCommand;
+export declare function archiveInstrumentConfiguration(registrarServiceCid: string, cid: string): LedgerCommand;
+export declare function createTransferPreapproval(operator: string, receiver: string, instrumentAdmin: string, instrumentIds: string[]): LedgerCommand;
+export interface CredentialPayload {
+    issuer: string;
+    holder: string;
+    id: string;
+    description: string;
+    validFrom: null;
+    validUntil: string;
+    claims: Array<{
+        subject: string;
+        property: string;
+        value: string;
+    }>;
+    observers: ReturnType<typeof partySet>;
+}
+/**
+ * An issuer-held credential: issuer and holder are both the registrar and the allowlisted party appears only as the
+ * claims' subject, so it signs nothing. DA's operator observes it so DA's API can disclose it in choice contexts.
+ */
+export declare function issuerHeldCredential(params: {
+    registrar: string;
+    operator: string;
+    subject: string;
+    claims: ClaimSpec[];
+    id: string;
+    description: string;
+    validUntil: string;
+}): CredentialPayload;
+export declare function createCredential(payload: CredentialPayload): LedgerCommand;
+/** The `Archive` choice every DA Registry template carries. */
+export declare function archiveDaRegistryContract(templateKey: DaRegistryTemplateKey, contractId: string): LedgerCommand;
+export interface MintPayload {
+    instrumentId: {
+        admin: string;
+        id: string;
+    };
+    amount: string;
+    holder: string;
+    reference: string;
+    requestedAt: string;
+    executeBefore: string;
+    meta: {
+        values: Record<string, string>;
+    };
+}
+export declare function offerMint(allocationFactoryCid: string, admin: string, mint: MintPayload, context: {
+    values: Record<string, unknown>;
+}): LedgerCommand;
+export declare function cancelMintOffer(mintOfferCid: string): LedgerCommand;
+export declare function acceptMintOffer(mintOfferCid: string, context: {
+    values: Record<string, unknown>;
+}): LedgerCommand;
+/**
+ * A transfer through the registry's transfer factory (the Token Standard V1 `TransferFactory_Transfer` choice). The
+ * factory contract id and its choice context come from DA's API (`transferFactory`); the builder itself is the
+ * token-standard one, so the payload is validated the same way as any other Token Standard transfer.
+ */
+export declare function transferViaFactory(factoryCid: string, admin: string, transfer: TokenStandardV1Transfer, context: {
+    values: Record<string, unknown>;
+}): LedgerCommand;
+//# sourceMappingURL=commands.d.ts.map

package/build/src/da-registry/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/da-registry/commands.ts"],"names":[],"mappings":"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"}

package/build/src/da-registry/commands.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestProviderService = requestProviderService;
+exports.createProviderConfiguration = createProviderConfiguration;
+exports.archiveAndCreateProviderConfiguration = archiveAndCreateProviderConfiguration;
+exports.requestAndAcceptRegistrarService = requestAndAcceptRegistrarService;
+exports.acceptRegistrarServiceRequest = acceptRegistrarServiceRequest;
+exports.deleteRejectedRegistrarServiceRequest = deleteRejectedRegistrarServiceRequest;
+exports.createTransferRule = createTransferRule;
+exports.createAllocationFactory = createAllocationFactory;
+exports.createInstrumentConfiguration = createInstrumentConfiguration;
+exports.archiveAndCreateInstrumentConfiguration = archiveAndCreateInstrumentConfiguration;
+exports.archiveInstrumentConfiguration = archiveInstrumentConfiguration;
+exports.createTransferPreapproval = createTransferPreapproval;
+exports.issuerHeldCredential = issuerHeldCredential;
+exports.createCredential = createCredential;
+exports.archiveDaRegistryContract = archiveDaRegistryContract;
+exports.offerMint = offerMint;
+exports.cancelMintOffer = cancelMintOffer;
+exports.acceptMintOffer = acceptMintOffer;
+exports.transferViaFactory = transferViaFactory;
+const token_standard_1 = require("../utils/token-standard");
+const choice_context_1 = require("./choice-context");
+const templates_1 = require("./templates");
+const readers_1 = require("./readers");
+// ── Provider onboarding ─────────────────────────────────────────────────────────────────────────────────────────────
+function requestProviderService(operator, provider) {
+    return {
+        CreateCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.providerServiceRequest,
+            createArguments: { operator, provider },
+        },
+    };
+}
+function createProviderConfiguration(providerServiceCid) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.providerService,
+            contractId: providerServiceCid,
+            choice: 'ProviderService_CreateProviderConfiguration',
+            // No credential is needed to request a registrar seat; this provider serves only itself.
+            choiceArgument: { registrarRequirements: [], holderRequirements: [] },
+        },
+    };
+}
+function archiveAndCreateProviderConfiguration(providerServiceCid, cid) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.providerService,
+            contractId: providerServiceCid,
+            choice: 'ProviderService_ArchiveAndCreateProviderConfiguration',
+            choiceArgument: { cid, payload: { registrarRequirements: [], holderRequirements: [] } },
+        },
+    };
+}
+// ── Registrar onboarding ────────────────────────────────────────────────────────────────────────────────────────────
+/** Creates the registrar request and accepts it as provider in one transaction, when one party holds both roles. */
+function requestAndAcceptRegistrarService(operator, registrarAndProvider, providerConfigurationCid) {
+    return {
+        CreateAndExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.registrarServiceRequest,
+            createArguments: {
+                operator,
+                provider: registrarAndProvider,
+                registrar: registrarAndProvider,
+                createTransferRule: true,
+                createAllocationFactory: true,
+            },
+            choice: 'RegistrarServiceRequest_Accept',
+            choiceArgument: { providerConfigurationCid, credentialCids: [] },
+        },
+    };
+}
+function acceptRegistrarServiceRequest(requestCid, providerConfigurationCid) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.registrarServiceRequest,
+            contractId: requestCid,
+            choice: 'RegistrarServiceRequest_Accept',
+            choiceArgument: { providerConfigurationCid, credentialCids: [] },
+        },
+    };
+}
+function deleteRejectedRegistrarServiceRequest(cid) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.rejectedRegistrarServiceRequest,
+            contractId: cid,
+            choice: 'RejectedRegistrarServiceRequest_Delete',
+            choiceArgument: {},
+        },
+    };
+}
+function createTransferRule(registrarServiceCid) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.registrarService,
+            contractId: registrarServiceCid,
+            choice: 'RegistrarService_CreateTransferRule',
+            choiceArgument: {},
+        },
+    };
+}
+function createAllocationFactory(registrarServiceCid) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.registrarService,
+            contractId: registrarServiceCid,
+            choice: 'RegistrarService_CreateAllocationFactory',
+            choiceArgument: {},
+        },
+    };
+}
+function createInstrumentConfiguration(registrarServiceCid, payload) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.registrarService,
+            contractId: registrarServiceCid,
+            choice: 'RegistrarService_CreateInstrumentConfiguration',
+            choiceArgument: { ...payload },
+        },
+    };
+}
+function archiveAndCreateInstrumentConfiguration(registrarServiceCid, cid, payload) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.registrarService,
+            contractId: registrarServiceCid,
+            choice: 'RegistrarService_ArchiveAndCreateInstrumentConfiguration',
+            choiceArgument: { cid, payload },
+        },
+    };
+}
+function archiveInstrumentConfiguration(registrarServiceCid, cid) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.registrarService,
+            contractId: registrarServiceCid,
+            choice: 'RegistrarService_ArchiveInstrumentConfiguration',
+            choiceArgument: { cid },
+        },
+    };
+}
+// ── Transfer preapprovals ───────────────────────────────────────────────────────────────────────────────────────────
+function createTransferPreapproval(operator, receiver, instrumentAdmin, instrumentIds) {
+    return {
+        CreateCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.transferPreapproval,
+            createArguments: {
+                operator,
+                receiver,
+                instrumentAdmin,
+                instrumentAllowances: instrumentIds.map((id) => ({ id })),
+            },
+        },
+    };
+}
+/**
+ * An issuer-held credential: issuer and holder are both the registrar and the allowlisted party appears only as the
+ * claims' subject, so it signs nothing. DA's operator observes it so DA's API can disclose it in choice contexts.
+ */
+function issuerHeldCredential(params) {
+    return {
+        issuer: params.registrar,
+        holder: params.registrar,
+        id: params.id,
+        description: params.description,
+        // Unset: a not-yet-valid credential anywhere in a transaction's supplied set aborts it.
+        validFrom: null,
+        validUntil: params.validUntil,
+        claims: params.claims.map((c) => ({ subject: params.subject, property: c.property, value: c.value })),
+        observers: (0, readers_1.partySet)([params.operator]),
+    };
+}
+function createCredential(payload) {
+    return { CreateCommand: { templateId: templates_1.DA_REGISTRY_TEMPLATES.credential, createArguments: { ...payload } } };
+}
+/** The `Archive` choice every DA Registry template carries. */
+function archiveDaRegistryContract(templateKey, contractId) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES[templateKey],
+            contractId,
+            choice: 'Archive',
+            choiceArgument: {},
+        },
+    };
+}
+function offerMint(allocationFactoryCid, admin, mint, context) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.allocationFactory,
+            contractId: allocationFactoryCid,
+            choice: 'AllocationFactory_OfferMint',
+            choiceArgument: { expectedAdmin: admin, mint, extraArgs: (0, choice_context_1.daRegistryExtraArgs)(context) },
+        },
+    };
+}
+function cancelMintOffer(mintOfferCid) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.mintOffer,
+            contractId: mintOfferCid,
+            choice: 'MintOffer_Cancel',
+            choiceArgument: { extraArgs: null },
+        },
+    };
+}
+function acceptMintOffer(mintOfferCid, context) {
+    return {
+        ExerciseCommand: {
+            templateId: templates_1.DA_REGISTRY_TEMPLATES.mintOffer,
+            contractId: mintOfferCid,
+            choice: 'MintOffer_Accept',
+            choiceArgument: { extraArgs: (0, choice_context_1.daRegistryExtraArgs)(context) },
+        },
+    };
+}
+// ── Transfers ─────────────────────────────────────────────────────────────────────────────────────────────────────
+/**
+ * A transfer through the registry's transfer factory (the Token Standard V1 `TransferFactory_Transfer` choice). The
+ * factory contract id and its choice context come from DA's API (`transferFactory`); the builder itself is the
+ * token-standard one, so the payload is validated the same way as any other Token Standard transfer.
+ */
+function transferViaFactory(factoryCid, admin, transfer, context) {
+    return (0, token_standard_1.buildTokenStandardV1TransferCommand)({
+        transferFactoryContractId: factoryCid,
+        expectedAdmin: admin,
+        transfer,
+        extraArgs: { context, meta: { values: {} } },
+    });
+}
+//# sourceMappingURL=commands.js.map

package/build/src/da-registry/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/da-registry/commands.ts"],"names":[],"mappings":"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"}

package/build/src/da-registry/index.d.ts

@@ -0,0 +1,8 @@
+export * from './api-client';
+export * from './choice-context';
+export * from './commands';
+export * from './ledger';
+export * from './packages';
+export * from './readers';
+export * from './templates';
+//# sourceMappingURL=index.d.ts.map

package/build/src/da-registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/da-registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}