@layerzerolabs/common-canton 0.2.107 → 0.2.109

package/dist/senderPlaceholder.d.ts

@@ -1,41 +0,0 @@
-/**
- * Sentinel emitted in place of the sender `Party` when the sender is unknown at
- * create time; substituted for the real party at sign time.
- */
-export declare const CANTON_SENDER_PLACEHOLDER = "<<CANTON_SENDER_PLACEHOLDER>>";
-/**
- * Returns true if `value` is the Canton sender placeholder.
- */
-export declare const isCantonSenderPlaceholder: (value: string) => boolean;
-/** Replace every {@link CANTON_SENDER_PLACEHOLDER} in a command tree with the actual sender party ID. */
-export declare const replaceCantonSenderPlaceholders: <T>(value: T, senderParty: string) => T;
-/** Returns true if the command tree contains the sender placeholder anywhere. */
-export declare const containsCantonSenderPlaceholder: (value: unknown) => boolean;
-/**
- * Sentinel emitted as the sole element of the `amuletCids` array
- * (`amuletCids: [CANTON_AMULET_CIDS_PLACEHOLDER]`); substituted for the resolved
- * sender's Amulet contract IDs at sign time.
- */
-export declare const CANTON_AMULET_CIDS_PLACEHOLDER = "<<CANTON_AMULET_CIDS_PLACEHOLDER>>";
-/**
- * Returns true if the command tree contains an amulet-cids placeholder array
- * anywhere — i.e. an array `[CANTON_AMULET_CIDS_PLACEHOLDER]`.
- */
-export declare const containsCantonAmuletCidsPlaceholder: (value: unknown) => boolean;
-/**
- * Recursively walks a JSON-serializable value and replaces every
- * `[CANTON_AMULET_CIDS_PLACEHOLDER]` array with the supplied list of resolved
- * Amulet contract IDs.
- */
-export declare const replaceCantonAmuletCidsPlaceholder: <T>(value: T, amuletCids: string[]) => T;
-/** Sentinel for a choice's `extraArgs.context`, replaced with the freshly-fetched
- *  amulet choice context at sign time. */
-export declare const CANTON_AMULET_CONTEXT_PLACEHOLDER = "<<CANTON_AMULET_CONTEXT_PLACEHOLDER>>";
-/** Sentinel for the exercised ExternalPartyAmuletRules contract id, re-pinned to the
- *  freshly-fetched amulet fee bundle at sign time. */
-export declare const CANTON_AMULET_RULES_CID_PLACEHOLDER = "<<CANTON_AMULET_RULES_CID_PLACEHOLDER>>";
-/** Returns true if any scalar leaf in the tree equals `placeholder`. */
-export declare const containsPlaceholderValue: (value: unknown, placeholder: string) => boolean;
-/** Replace every scalar sentinel leaf equal to `placeholder` with `replacement`. */
-export declare const replacePlaceholderValue: <T>(value: T, placeholder: string, replacement: unknown) => T;
-//# sourceMappingURL=senderPlaceholder.d.ts.map

package/dist/senderPlaceholder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"senderPlaceholder.d.ts","sourceRoot":"","sources":["../src/senderPlaceholder.ts"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,eAAO,MAAM,yBAAyB,kCAAkC,CAAC;AAEzE;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM,KAAG,OACnB,CAAC;AAExC,yGAAyG;AACzG,eAAO,MAAM,+BAA+B,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,MAAM,KAAG,CAG9E,CAAC;AAEN,iFAAiF;AACjF,eAAO,MAAM,+BAA+B,GAAI,OAAO,OAAO,KAAG,OACI,CAAC;AAMtE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,uCAAuC,CAAC;AAKnF;;;GAGG;AACH,eAAO,MAAM,mCAAmC,GAAI,OAAO,OAAO,KAAG,OAChB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,MAAM,EAAE,KAAG,CAGlF,CAAC;AAEN;0CAC0C;AAC1C,eAAO,MAAM,iCAAiC,0CAA0C,CAAC;AAEzF;sDACsD;AACtD,eAAO,MAAM,mCAAmC,4CAA4C,CAAC;AAU7F,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,EAAE,aAAa,MAAM,KAAG,OACxB,CAAC;AAExD,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,GAAI,CAAC,EACrC,OAAO,CAAC,EACR,aAAa,MAAM,EACnB,aAAa,OAAO,KACrB,CAAwF,CAAC"}

package/dist/senderPlaceholder.js

@@ -1,4 +0,0 @@
-export { CANTON_AMULET_CIDS_PLACEHOLDER, CANTON_AMULET_CONTEXT_PLACEHOLDER, CANTON_AMULET_RULES_CID_PLACEHOLDER, CANTON_SENDER_PLACEHOLDER, containsCantonAmuletCidsPlaceholder, containsCantonSenderPlaceholder, containsPlaceholderValue, isCantonSenderPlaceholder, replaceCantonAmuletCidsPlaceholder, replaceCantonSenderPlaceholders, replacePlaceholderValue } from './YVZO3C4U.js';
-import './VUOMXK5T.js';
-//# sourceMappingURL=senderPlaceholder.js.map
-//# sourceMappingURL=senderPlaceholder.js.map

package/dist/senderPlaceholder.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"senderPlaceholder.js"}

package/src/senderPlaceholder.ts

@@ -1,119 +0,0 @@
-import { mapValues } from 'es-toolkit';
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Generic JSON-tree visitors
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * Result of a leaf check: either the leaf has been replaced (with `value`),
- * or `undefined` to leave it alone and recurse into its children.
- */
-type LeafResult = { value: unknown } | undefined;
-
-/** Walk a JSON value and rewrite leaves matched by `replace`; recursion stops at a swapped leaf. */
-const visit = <T>(value: T, replace: (leaf: unknown) => LeafResult): T => {
-    const result = replace(value);
-    if (result) return result.value as T;
-    if (Array.isArray(value)) {
-        return value.map((item) => visit(item, replace)) as T;
-    }
-    if (value !== null && typeof value === 'object') {
-        return mapValues(value as Record<string, unknown>, (item) => visit(item, replace)) as T;
-    }
-    return value;
-};
-
-/** True if `predicate` matches any leaf or sub-value in the tree. */
-const containsLeaf = (value: unknown, predicate: (leaf: unknown) => boolean): boolean => {
-    if (predicate(value)) return true;
-    if (Array.isArray(value)) return value.some((item) => containsLeaf(item, predicate));
-    return (
-        value !== null &&
-        typeof value === 'object' &&
-        Object.values(value).some((item) => containsLeaf(item, predicate))
-    );
-};
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Sender placeholder
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * Sentinel emitted in place of the sender `Party` when the sender is unknown at
- * create time; substituted for the real party at sign time.
- */
-export const CANTON_SENDER_PLACEHOLDER = '<<CANTON_SENDER_PLACEHOLDER>>';
-
-/**
- * Returns true if `value` is the Canton sender placeholder.
- */
-export const isCantonSenderPlaceholder = (value: string): boolean =>
-    value === CANTON_SENDER_PLACEHOLDER;
-
-/** Replace every {@link CANTON_SENDER_PLACEHOLDER} in a command tree with the actual sender party ID. */
-export const replaceCantonSenderPlaceholders = <T>(value: T, senderParty: string): T =>
-    visit(value, (leaf) =>
-        leaf === CANTON_SENDER_PLACEHOLDER ? { value: senderParty } : undefined,
-    );
-
-/** Returns true if the command tree contains the sender placeholder anywhere. */
-export const containsCantonSenderPlaceholder = (value: unknown): boolean =>
-    containsLeaf(value, (leaf) => leaf === CANTON_SENDER_PLACEHOLDER);
-
-// ─────────────────────────────────────────────────────────────────────────────
-// AmuletCids placeholder
-// ─────────────────────────────────────────────────────────────────────────────
-
-/**
- * Sentinel emitted as the sole element of the `amuletCids` array
- * (`amuletCids: [CANTON_AMULET_CIDS_PLACEHOLDER]`); substituted for the resolved
- * sender's Amulet contract IDs at sign time.
- */
-export const CANTON_AMULET_CIDS_PLACEHOLDER = '<<CANTON_AMULET_CIDS_PLACEHOLDER>>';
-
-const isAmuletCidsPlaceholderArray = (value: unknown): value is [string] =>
-    Array.isArray(value) && value.length === 1 && value[0] === CANTON_AMULET_CIDS_PLACEHOLDER;
-
-/**
- * Returns true if the command tree contains an amulet-cids placeholder array
- * anywhere — i.e. an array `[CANTON_AMULET_CIDS_PLACEHOLDER]`.
- */
-export const containsCantonAmuletCidsPlaceholder = (value: unknown): boolean =>
-    containsLeaf(value, isAmuletCidsPlaceholderArray);
-
-/**
- * Recursively walks a JSON-serializable value and replaces every
- * `[CANTON_AMULET_CIDS_PLACEHOLDER]` array with the supplied list of resolved
- * Amulet contract IDs.
- */
-export const replaceCantonAmuletCidsPlaceholder = <T>(value: T, amuletCids: string[]): T =>
-    visit(value, (leaf) =>
-        isAmuletCidsPlaceholderArray(leaf) ? { value: amuletCids } : undefined,
-    );
-
-/** Sentinel for a choice's `extraArgs.context`, replaced with the freshly-fetched
- *  amulet choice context at sign time. */
-export const CANTON_AMULET_CONTEXT_PLACEHOLDER = '<<CANTON_AMULET_CONTEXT_PLACEHOLDER>>';
-
-/** Sentinel for the exercised ExternalPartyAmuletRules contract id, re-pinned to the
- *  freshly-fetched amulet fee bundle at sign time. */
-export const CANTON_AMULET_RULES_CID_PLACEHOLDER = '<<CANTON_AMULET_RULES_CID_PLACEHOLDER>>';
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Generic placeholder helpers (sentinel-agnostic)
-//
-// Used by the sign-time refresh executor, which receives the sentinel to match as
-// data (from the transaction's refreshSpec, or a known amulet sentinel) instead of
-// hardcoding it here — keeping these helpers free of any contract knowledge.
-// ─────────────────────────────────────────────────────────────────────────────
-
-/** Returns true if any scalar leaf in the tree equals `placeholder`. */
-export const containsPlaceholderValue = (value: unknown, placeholder: string): boolean =>
-    containsLeaf(value, (leaf) => leaf === placeholder);
-
-/** Replace every scalar sentinel leaf equal to `placeholder` with `replacement`. */
-export const replacePlaceholderValue = <T>(
-    value: T,
-    placeholder: string,
-    replacement: unknown,
-): T => visit(value, (leaf) => (leaf === placeholder ? { value: replacement } : undefined));