@fairmint/canton-node-sdk 0.0.269 → 0.0.271

package/README.md

@@ -57,7 +57,7 @@ npm run build
 ### LocalNet (owned by `@fairmint/canton-dev-tools`)
 
 LocalNet lifecycle and shared test helpers live in
-[`@fairmint/canton-dev-tools@0.1.11`](https://www.npmjs.com/package/@fairmint/canton-dev-tools) (see
+[`@fairmint/canton-dev-tools@0.1.13`](https://www.npmjs.com/package/@fairmint/canton-dev-tools) (see
 its [COMPATIBILITY.md](https://github.com/Fairmint/canton-dev-tools/blob/main/COMPATIBILITY.md)).
 This SDK does not publish a LocalNet CLI or `scripts/localnet-cloud.sh`.
 

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

@@ -4,5 +4,6 @@ export * from './commands';
 export * from './ledger';
 export * from './packages';
 export * from './readers';
+export * from './setup';
 export * from './templates';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

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

@@ -20,5 +20,6 @@ __exportStar(require("./commands"), exports);
 __exportStar(require("./ledger"), exports);
 __exportStar(require("./packages"), exports);
 __exportStar(require("./readers"), exports);
+__exportStar(require("./setup"), exports);
 __exportStar(require("./templates"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/da-registry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,mDAAiC;AACjC,6CAA2B;AAC3B,2CAAyB;AACzB,6CAA2B;AAC3B,4CAA0B;AAC1B,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/da-registry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,mDAAiC;AACjC,6CAA2B;AAC3B,2CAAyB;AACzB,6CAA2B;AAC3B,4CAA0B;AAC1B,0CAAwB;AACxB,8CAA4B"}

package/build/src/da-registry/setup/decimal.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Exact decimal arithmetic for registry amounts (Daml `Decimal`, 10 fractional digits), on scaled `bigint`s so sums and
+ * deficits never lose precision.
+ */
+/** An amount scaled by 10^10. */
+export type ScaledDecimal = bigint;
+/** Parses a decimal string (as the ledger and configs encode amounts); throws on anything else or on lost precision. */
+export declare function parseDecimal(value: string): ScaledDecimal;
+/** Plain notation with no trailing zeros: `10.50` → `10.5`, `1000.0000000000` → `1000`. */
+export declare function formatDecimal(value: ScaledDecimal): string;
+export declare function sumDecimals(values: readonly ScaledDecimal[]): ScaledDecimal;
+//# sourceMappingURL=decimal.d.ts.map

package/build/src/da-registry/setup/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../../../src/da-registry/setup/decimal.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,wHAAwH;AACxH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAQzD;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAM1D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,CAE3E"}

package/build/src/da-registry/setup/decimal.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Exact decimal arithmetic for registry amounts (Daml `Decimal`, 10 fractional digits), on scaled `bigint`s so sums and
+ * deficits never lose precision.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDecimal = parseDecimal;
+exports.formatDecimal = formatDecimal;
+exports.sumDecimals = sumDecimals;
+const SCALE = 10;
+const FACTOR = 10n ** BigInt(SCALE);
+const DECIMAL_PATTERN = /^([+-]?)(\d+)(?:\.(\d+))?$/;
+/** Drops trailing `0`s with a scan, not a regex, so input with long runs of zeros stays linear. */
+function trimTrailingZeros(digits) {
+    let end = digits.length;
+    while (end > 0 && digits[end - 1] === '0')
+        end--;
+    return digits.slice(0, end);
+}
+/** Parses a decimal string (as the ledger and configs encode amounts); throws on anything else or on lost precision. */
+function parseDecimal(value) {
+    const match = DECIMAL_PATTERN.exec(value.trim());
+    if (!match)
+        throw new Error(`not a decimal: ${JSON.stringify(value)}`);
+    const [, sign = '', whole = '0', fraction = ''] = match;
+    const significant = trimTrailingZeros(fraction);
+    if (significant.length > SCALE)
+        throw new Error(`more than ${SCALE} decimal places: ${value}`);
+    const scaled = BigInt(whole) * FACTOR + BigInt(significant.padEnd(SCALE, '0'));
+    return sign === '-' ? -scaled : scaled;
+}
+/** Plain notation with no trailing zeros: `10.50` → `10.5`, `1000.0000000000` → `1000`. */
+function formatDecimal(value) {
+    const negative = value < 0n;
+    const magnitude = negative ? -value : value;
+    const whole = (magnitude / FACTOR).toString();
+    const fraction = trimTrailingZeros((magnitude % FACTOR).toString().padStart(SCALE, '0'));
+    return `${negative ? '-' : ''}${whole}${fraction ? `.${fraction}` : ''}`;
+}
+function sumDecimals(values) {
+    return values.reduce((total, v) => total + v, 0n);
+}
+//# sourceMappingURL=decimal.js.map

package/build/src/da-registry/setup/decimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.js","sourceRoot":"","sources":["../../../../src/da-registry/setup/decimal.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAEH,MAAM,KAAK,GAAG,EAAE,CAAC;AACjB,MAAM,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AACpC,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAErD,mGAAmG;AACnG,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,OAAO,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG;QAAE,GAAG,EAAE,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAKD,wHAAwH;AACxH,sBAA6B,KAAa;IACxC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvE,MAAM,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,GAAG,GAAG,EAAE,QAAQ,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IACxD,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,aAAa,KAAK,oBAAoB,KAAK,EAAE,CAAC,CAAC;IAC/F,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/E,OAAO,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACzC,CAAC;AAED,2FAA2F;AAC3F,uBAA8B,KAAoB;IAChD,MAAM,QAAQ,GAAG,KAAK,GAAG,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACzF,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC3E,CAAC;AAED,qBAA4B,MAAgC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC"}

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

@@ -0,0 +1,4 @@
+export * from './runner';
+export * from './steps';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/da-registry/setup/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/build/src/da-registry/setup/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./runner"), exports);
+__exportStar(require("./steps"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/build/src/da-registry/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/da-registry/setup/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB"}

package/build/src/da-registry/setup/runner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Runs the DA Registry setup steps in order.
+ *
+ * - `plan` assesses every step and prints its status, evidence and the exact commands `apply` would submit. It never
+ *   writes.
+ * - `apply` assesses each step; while it is pending, submits its actions and re-assesses, and while it is waiting on
+ *   another party, polls for as long as the step allows. It stops at the first step that is not done afterwards.
+ *
+ * A step that builds on an earlier one reports `blocked` (a dependency) until that one is done; steps that stand alone,
+ * such as the allowlist, can be pending while earlier ones are. A step that throws, or whose submission the ledger
+ * rejects, is reported as `blocked` with the error, so every run ends with a summary.
+ */
+import { type LedgerSubmission } from '../../utils/ledger';
+import { type DaRegistrySetupStep, type DaRegistrySetupStepStatus } from './types';
+/** `plan` reads and prints every step; `apply` also submits the pending ones. */
+export type DaRegistrySetupRunMode = 'plan' | 'apply';
+/** What one step ended as, and what `apply` submitted for it. */
+export interface DaRegistrySetupStepResult {
+    id: string;
+    title: string;
+    status: DaRegistrySetupStepStatus;
+    summary: string;
+    dependency: boolean;
+    evidence: Record<string, string>;
+    notes: string[];
+    /** Descriptions of the actions `apply` submitted, with their update ids. */
+    applied: string[];
+}
+/** One run: each step's result, the overall outcome, and whether a person must act. */
+export interface DaRegistrySetupRunResult {
+    mode: DaRegistrySetupRunMode;
+    steps: DaRegistrySetupStepResult[];
+    /** `done` when every step is done; otherwise the status of the first step that is not. */
+    outcome: DaRegistrySetupStepStatus;
+    /** Some step is blocked on something a person must fix, not merely on an earlier step. */
+    needsAttention: boolean;
+}
+/** Side effects the runner needs, injected so a run is testable with a fake clock and ledger. */
+export interface DaRegistrySetupRunnerDeps {
+    submit: (submission: LedgerSubmission) => Promise<{
+        updateId: string;
+    }>;
+    log: (line: string) => void;
+    sleep: (ms: number) => Promise<void>;
+    now: () => number;
+}
+/** Guards against a step whose actions never change what it reads; the step is left pending for the next run. */
+export declare const DA_REGISTRY_SETUP_MAX_ROUNDS_PER_STEP = 25;
+/** JSON for the plan output, with disclosed-contract blobs shortened so the plan stays readable. */
+export declare function formatDaRegistrySetupSubmission(submission: LedgerSubmission): string;
+/** Runs `steps` in order in `mode`; see the module documentation for how `plan` and `apply` differ. */
+export declare function runDaRegistrySetupSteps(steps: DaRegistrySetupStep[], mode: DaRegistrySetupRunMode, deps: DaRegistrySetupRunnerDeps): Promise<DaRegistrySetupRunResult>;
+//# sourceMappingURL=runner.d.ts.map

package/build/src/da-registry/setup/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../src/da-registry/setup/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAGL,KAAK,mBAAmB,EAExB,KAAK,yBAAyB,EAC/B,MAAM,SAAS,CAAC;AAEjB,iFAAiF;AACjF,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtD,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,uFAAuF;AACvF,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,yBAAyB,EAAE,CAAC;IACnC,0FAA0F;IAC1F,OAAO,EAAE,yBAAyB,CAAC;IACnC,0FAA0F;IAC1F,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,iGAAiG;AACjG,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,CAAC,UAAU,EAAE,gBAAgB,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAUD,iHAAiH;AACjH,eAAO,MAAM,qCAAqC,KAAK,CAAC;AAGxD,oGAAoG;AACpG,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CASpF;AAkFD,uGAAuG;AACvG,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,mBAAmB,EAAE,EAC5B,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CA+FnC"}

package/build/src/da-registry/setup/runner.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DA_REGISTRY_SETUP_MAX_ROUNDS_PER_STEP = void 0;
+exports.formatDaRegistrySetupSubmission = formatDaRegistrySetupSubmission;
+exports.runDaRegistrySetupSteps = runDaRegistrySetupSteps;
+const types_1 = require("./types");
+const STATUS_ICON = {
+    done: '✅ done',
+    pending: '⏳ pending',
+    waiting: '🕒 waiting',
+    blocked: '⛔ blocked',
+};
+const WAIT_POLL_MS = 10000;
+/** Guards against a step whose actions never change what it reads; the step is left pending for the next run. */
+exports.DA_REGISTRY_SETUP_MAX_ROUNDS_PER_STEP = 25;
+const MAX_BLOB_CHARS = 48;
+/** JSON for the plan output, with disclosed-contract blobs shortened so the plan stays readable. */
+function formatDaRegistrySetupSubmission(submission) {
+    return JSON.stringify(submission, (key, value) => key === 'createdEventBlob' && typeof value === 'string' && value.length > MAX_BLOB_CHARS
+        ? `${value.slice(0, MAX_BLOB_CHARS)}…(${value.length} chars)`
+        : value, 2);
+}
+function indent(text, prefix) {
+    return text
+        .split('\n')
+        .map((line) => `${prefix}${line}`)
+        .join('\n');
+}
+/** What a command acts on: the contract and choice it exercises, or the template it creates. */
+function commandTarget(command) {
+    if ('ExerciseCommand' in command) {
+        return ['exercise', command.ExerciseCommand.contractId, command.ExerciseCommand.choice];
+    }
+    if ('CreateAndExerciseCommand' in command) {
+        return [
+            'create-and-exercise',
+            command.CreateAndExerciseCommand.templateId,
+            command.CreateAndExerciseCommand.choice,
+        ];
+    }
+    return ['create', command.CreateCommand.templateId];
+}
+/** A round's identity: each action's description and the contracts and templates its commands act on. */
+function roundFingerprint(actions) {
+    return JSON.stringify(actions.map((a) => [a.description, a.submission.commands.map(commandTarget)]));
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function printAssessment(log, assessment, showActions) {
+    log(`      ${STATUS_ICON[assessment.status]}  ${assessment.summary}`);
+    for (const [key, value] of Object.entries(assessment.evidence ?? {})) {
+        log(`      · ${key}: ${value}`);
+    }
+    for (const note of assessment.notes ?? []) {
+        log(`      ! ${note}`);
+    }
+    if (!showActions)
+        return;
+    for (const action of assessment.actions ?? []) {
+        log(`      → ${action.description}`);
+        log(indent(formatDaRegistrySetupSubmission(action.submission), '        '));
+    }
+}
+async function safeAssess(step) {
+    try {
+        return await step.assess();
+    }
+    catch (error) {
+        if (error instanceof types_1.DaRegistrySetupDependencyError) {
+            return { status: 'blocked', summary: `needs ${error.stepId}`, dependency: true, notes: [error.message] };
+        }
+        return { status: 'blocked', summary: 'the step failed to read its state', notes: [errorMessage(error)] };
+    }
+}
+/** Submits a pending step's actions; returns an error message instead of throwing, so the run still summarises. */
+async function applyActions(assessment, deps, applied) {
+    for (const action of assessment.actions ?? []) {
+        deps.log(`      ▶ ${action.description}`);
+        try {
+            const { updateId } = await deps.submit(action.submission);
+            applied.push(`${action.description} (update ${updateId})`);
+            deps.log(`        submitted, update ${updateId}`);
+        }
+        catch (error) {
+            return `${action.description} failed: ${errorMessage(error)}`;
+        }
+    }
+    return null;
+}
+/** Runs `steps` in order in `mode`; see the module documentation for how `plan` and `apply` differ. */
+async function runDaRegistrySetupSteps(steps, mode, deps) {
+    const results = [];
+    let outcome = 'done';
+    for (const [index, step] of steps.entries()) {
+        deps.log('');
+        deps.log(`[${index + 1}/${steps.length}] ${step.id} — ${step.title}`);
+        deps.log(indent(step.why, '      '));
+        let assessment = await safeAssess(step);
+        const applied = [];
+        if (mode === 'apply') {
+            // Some steps take several rounds: a mint is an offer then an accept, and each delivery spends the change of
+            // the one before. Each round re-reads the ledger, so a round only ever acts on current state.
+            let rounds = 0;
+            let waitDeadline;
+            // A round that plans exactly what the round before it just submitted means the step does not read back its own
+            // write (for example a reader that does not match the ledger's encoding); repeating it would only churn. Rounds
+            // are compared by what they act on, not by their timestamps, which every round regenerates.
+            let lastRound;
+            for (;;) {
+                if (assessment.status === 'pending' && rounds < exports.DA_REGISTRY_SETUP_MAX_ROUNDS_PER_STEP) {
+                    const descriptions = (assessment.actions ?? []).map((a) => a.description);
+                    const round = roundFingerprint(assessment.actions ?? []);
+                    if (round === lastRound) {
+                        assessment = {
+                            status: 'blocked',
+                            summary: 'the step does not read back its own write',
+                            ...(assessment.evidence ? { evidence: assessment.evidence } : {}),
+                            notes: [`planned again after it was applied: ${descriptions.join('; ')}`],
+                        };
+                        break;
+                    }
+                    lastRound = round;
+                    rounds++;
+                    printAssessment(deps.log, assessment, true);
+                    const failure = await applyActions(assessment, deps, applied);
+                    if (failure) {
+                        assessment = { status: 'blocked', summary: 'a submission failed', notes: [failure] };
+                        break;
+                    }
+                    waitDeadline = undefined;
+                }
+                else if (assessment.status === 'waiting' && step.awaitMs && assessment.poll !== false) {
+                    if (waitDeadline === undefined) {
+                        waitDeadline = deps.now() + step.awaitMs;
+                        deps.log(`      🕒 polling up to ${Math.ceil(step.awaitMs / 60000)} min: ${assessment.summary}`);
+                    }
+                    const left = waitDeadline - deps.now();
+                    if (left <= 0)
+                        break;
+                    lastRound = undefined;
+                    // The last poll waits only until the deadline, so polling never outlasts awaitMs.
+                    await deps.sleep(Math.min(WAIT_POLL_MS, left));
+                }
+                else {
+                    break;
+                }
+                assessment = await safeAssess(step);
+            }
+            if (assessment.status === 'pending' && rounds === exports.DA_REGISTRY_SETUP_MAX_ROUNDS_PER_STEP) {
+                assessment = {
+                    ...assessment,
+                    notes: [
+                        ...(assessment.notes ?? []),
+                        `still pending after ${exports.DA_REGISTRY_SETUP_MAX_ROUNDS_PER_STEP} rounds; run again`,
+                    ],
+                };
+            }
+        }
+        // Plan prints the commands for every pending step; apply prints them for whatever is left undone.
+        printAssessment(deps.log, assessment, mode === 'plan' || assessment.status !== 'done');
+        results.push({
+            id: step.id,
+            title: step.title,
+            status: assessment.status,
+            summary: assessment.summary,
+            dependency: assessment.status === 'blocked' && assessment.dependency === true,
+            evidence: assessment.evidence ?? {},
+            notes: assessment.notes ?? [],
+            applied,
+        });
+        if (assessment.status !== 'done' && outcome === 'done') {
+            outcome = assessment.status;
+            // apply stops here: later steps build on this one. plan keeps going to show the whole picture.
+            if (mode === 'apply')
+                break;
+        }
+    }
+    return {
+        mode,
+        steps: results,
+        outcome,
+        needsAttention: results.some((r) => r.status === 'blocked' && !r.dependency),
+    };
+}
+//# sourceMappingURL=runner.js.map

package/build/src/da-registry/setup/runner.js.map

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

package/build/src/da-registry/setup/steps.d.ts

@@ -0,0 +1,13 @@
+import { type InstrumentConfigurationPayload } from '../commands';
+import { type DaRegistrySetupConfig, type DaRegistrySetupContext, type DaRegistrySetupStep } from './types';
+/** Mint offers the setup creates carry this prefix in `reference`; it never touches anyone else's. */
+export declare const DA_REGISTRY_SETUP_MINT_REFERENCE_PREFIX = "da-registry-setup";
+/** The instrument configuration the declared state requires: the registrar's two claims, and the blocklist setting. */
+export declare function desiredDaRegistryInstrumentConfiguration(config: DaRegistrySetupConfig): InstrumentConfigurationPayload;
+/**
+ * The ordered steps that converge a ledger to `ctx.config`: ledger access, DA packages, provider service and
+ * configuration, registrar service, instrument configuration, credentials (the allowlist), transfer preapprovals, test
+ * supply, DA's API, and test deliveries. Run them with {@link runDaRegistrySetupSteps}.
+ */
+export declare function buildDaRegistrySetupSteps(ctx: DaRegistrySetupContext): DaRegistrySetupStep[];
+//# sourceMappingURL=steps.d.ts.map

package/build/src/da-registry/setup/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../../src/da-registry/setup/steps.ts"],"names":[],"mappings":"AAUA,OAAO,EAoBL,KAAK,8BAA8B,EACpC,MAAM,aAAa,CAAC;AAarB,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAEzB,MAAM,SAAS,CAAC;AAwBjB,sGAAsG;AACtG,eAAO,MAAM,uCAAuC,sBAAsB,CAAC;AAgY3E,uHAAuH;AACvH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,qBAAqB,GAC5B,8BAA8B,CAWhC;AAm1BD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,sBAAsB,GAAG,mBAAmB,EAAE,CAc5F"}