@xyo-network/xl1-protocol 5.8.3 → 5.8.5

package/dist/neutral/modules/protocol-lib/providers/XyoClient.d.ts

@@ -11,7 +11,11 @@ export interface XyoGatewayConfig {
 }
 /** @deprecated */
 export interface XyoRpcGatewayConfig extends XyoGatewayConfig {
-    /** `dataLakeEndpoint` value exposed by this contract. */
+    /**
+     * @deprecated Build the lake with `createRestDataLakeViewer(url)` and
+     * `createRestDataLakeRunner(url)`. Bind `DataLakeViewer` and `DataLakeRunner`
+     * through the locator. This field/method/option is removed in 6.0.
+     */
     dataLakeEndpoint: string;
     /** `networkEndpoint` value exposed by this contract. */
     networkEndpoint: string;

package/dist/neutral/modules/protocol-lib/providers/XyoClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"XyoClient.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/providers/XyoClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,kBAAkB;AAClB,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,kBAAkB;AAClB,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,yDAAyD;IACzD,gBAAgB,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,iDAAiD;IACjD,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAClE,iDAAiD;IACjD,WAAW,EAAE,cAAc,CAAA;IAC3B,0FAA0F;IAC1F,aAAa,CAAC,EAAE,mBAAmB,CAAA;IAEnC,kBAAkB;IAClB,UAAU,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACvG,kBAAkB;IAClB,aAAa,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD"}
+{"version":3,"file":"XyoClient.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/providers/XyoClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,kBAAkB;AAClB,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,kBAAkB;AAClB,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,iDAAiD;IACjD,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAClE,iDAAiD;IACjD,WAAW,EAAE,cAAc,CAAA;IAC3B,0FAA0F;IAC1F,aAAa,CAAC,EAAE,mBAAmB,CAAA;IAEnC,kBAAkB;IAClB,UAAU,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GAAG,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACvG,kBAAkB;IAClB,aAAa,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD"}

package/dist/neutral/modules/protocol-lib/transaction/elevatedPayloads.d.ts

@@ -1,6 +1,11 @@
 import type { WithHashMeta } from '@xyo-network/sdk';
 import type { AllowedBlockPayload, HydratedTransactionWithHashMeta } from '../../protocol-model/index.js';
-/** Returns all elevated payloads referenced by a transaction script, or undefined if any of them cannot be resolved. */
+/**
+ * Returns payloads named by canonical elevate operations.
+ *
+ * Non-canonical `elevate|` operations are skipped. Returns undefined when a
+ * canonical hash does not resolve to an allowed payload.
+ */
 export declare function tryElevatedPayloads([tx, payloads]: HydratedTransactionWithHashMeta): WithHashMeta<AllowedBlockPayload>[] | undefined;
 /** Returns all elevated payloads referenced by a transaction script. */
 export declare function elevatedPayloads(tx: HydratedTransactionWithHashMeta): WithHashMeta<AllowedBlockPayload>[];

package/dist/neutral/modules/protocol-lib/transaction/elevatedPayloads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elevatedPayloads.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/transaction/elevatedPayloads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AAG3F,wHAAwH;AACxH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,+BAA+B,GAAG,YAAY,CAAC,mBAAmB,CAAC,EAAE,GAAG,SAAS,CAWpI;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,+BAA+B,GAAG,YAAY,CAAC,mBAAmB,CAAC,EAAE,CAMzG"}
+{"version":3,"file":"elevatedPayloads.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/transaction/elevatedPayloads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AAK3F;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,+BAA+B,GAAG,YAAY,CAAC,mBAAmB,CAAC,EAAE,GAAG,SAAS,CAUpI;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,+BAA+B,GAAG,YAAY,CAAC,mBAAmB,CAAC,EAAE,CAMzG"}

package/dist/neutral/modules/protocol-lib/transaction/script.d.ts

@@ -1,17 +1,29 @@
 import { type Hash } from '@ariestools/sdk';
 import type { WithHashMeta } from '@xyo-network/sdk';
 import type { AllowedBlockPayload, HydratedTransactionWithHashMeta } from '../../protocol-model/index.js';
-/** Extracts valid elevated payload hashes from a script without throwing. */
-export declare const tryExtractElevatedHashesFromScript: (strings: string[]) => Hash[];
-/** Extracts elevated payload hashes from a script and throws on invalid hashes. */
-export declare const extractElevatedHashesFromScript: (strings: string[]) => Hash[];
-/** Resolves valid elevated payloads from a transaction without throwing on invalid script hashes. */
-export declare const tryExtractElevatedHashes: (tx: HydratedTransactionWithHashMeta) => WithHashMeta<AllowedBlockPayload>[];
+/**
+ * Parses one script operation.
+ *
+ * Accepts only `elevate|` followed by 64 lowercase hex characters. Every other
+ * string, including non-canonical `elevate|` forms, returns undefined. Never throws.
+ */
+export declare function parseElevateOperation(op: string): Hash | undefined;
+/** Returns hashes from canonical `elevate|` operations. Skips every other operation and never throws. */
+export declare function tryExtractElevatedHashesFromScript(strings: string[]): Hash[];
+/** Returns elevate hashes and throws when any `elevate|` operation is not canonical. */
+export declare function extractElevatedHashesFromScript(strings: string[]): Hash[];
+/** Resolves payloads named by canonical elevate operations. Skips every other operation and never throws. */
+export declare function tryExtractElevatedHashes(tx: HydratedTransactionWithHashMeta): WithHashMeta<AllowedBlockPayload>[];
 /**
  * Returns a copy of the transaction that excludes non-elevated payloads — i.e. only what ends up on chain.
  * The payloads must carry hash meta so the elevated script hashes can be resolved.
+ * Non-canonical elevate operations are omitted rather than throwing.
+ */
+export declare function elevatedTransaction<T extends HydratedTransactionWithHashMeta>(tx: T): T;
+/**
+ * Resolves elevated payloads and throws when any `elevate|` operation is not
+ * canonical or does not resolve to an allowed payload. The count is the raw
+ * number of `elevate|` operations.
  */
-export declare const elevatedTransaction: <T extends HydratedTransactionWithHashMeta>(tx: T) => T;
-/** Resolves elevated payloads from a transaction and throws if script references are invalid. */
-export declare const extractElevatedHashes: (tx: HydratedTransactionWithHashMeta) => WithHashMeta<AllowedBlockPayload>[];
+export declare function extractElevatedHashes(tx: HydratedTransactionWithHashMeta): WithHashMeta<AllowedBlockPayload>[];
 //# sourceMappingURL=script.d.ts.map

package/dist/neutral/modules/protocol-lib/transaction/script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/transaction/script.ts"],"names":[],"mappings":"AAAA,OAAO,EACuB,KAAK,IAAI,EACtC,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAGpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AAG3F,6EAA6E;AAC7E,eAAO,MAAM,kCAAkC,GAAI,SAAS,MAAM,EAAE,KAAG,IAAI,EAK1E,CAAA;AAED,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,GAAI,SAAS,MAAM,EAAE,KAAG,IAAI,EAOvE,CAAA;AAED,qGAAqG;AACrG,eAAO,MAAM,wBAAwB,GAAI,IAAI,+BAA+B,KAAG,YAAY,CAAC,mBAAmB,CAAC,EAQ/G,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,+BAA+B,EAAE,IAAI,CAAC,KAAG,CAEhC,CAAA;AAEvD,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,GAAI,IAAI,+BAA+B,KAAG,YAAY,CAAC,mBAAmB,CAAC,EAU5G,CAAA"}
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/transaction/script.ts"],"names":[],"mappings":"AAAA,OAAO,EACK,KAAK,IAAI,EACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAGpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AAK3F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAIlE;AAYD,yGAAyG;AACzG,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAO5E;AAED,wFAAwF;AACxF,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAEzE;AAED,6GAA6G;AAC7G,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,+BAA+B,GAAG,YAAY,CAAC,mBAAmB,CAAC,EAAE,CAOjH;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,+BAA+B,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAGvF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,+BAA+B,GAAG,YAAY,CAAC,mBAAmB,CAAC,EAAE,CAS9G"}

package/dist/neutral/modules/protocol-lib/viewers/Block.d.ts

@@ -41,7 +41,7 @@ export interface BlockViewerMethods {
     blocksByStep(stepLevel: number, stepIndex: number): Promisable<SignedHydratedBlockWithHashMeta[]>;
     /** Returns the current signed and hydrated chain head. */
     currentBlock(): Promisable<SignedHydratedBlockWithHashMeta>;
-    /** Returns hydrated payloads for the supplied hashes, omitting hashes that cannot be resolved. */
+    /** Returns payloads from the gateway store for the supplied hashes, omitting hashes the store cannot resolve. Does not consult a datalake. */
     payloadsByHash(hashes: Hash[]): Promisable<WithHashMeta<Payload>[]>;
 }
 /** Moniker identifier for the BlockViewer provider. */

package/dist/neutral/modules/protocol-lib/viewers/Block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAC1C,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D,OAAO,KAAK,EACV,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,eAAe,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAC3H,MAAM,iBAAiB,CAAA;AAExB,uDAAuD;AACvD,MAAM,WAAW,2BAA2B;IAC1C,0CAA0C;IAC1C,KAAK,EAAE,+BAA+B,CAAA;CACvC;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD;;;;OAIG;IACH,WAAW,EAAE,2BAA2B,CAAA;CACzC;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,sBAAsB,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACjG;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACvF;;;;;;;;;;OAUG;IACH,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACpG,0EAA0E;IAC1E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACjG,0DAA0D;IAC1D,YAAY,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAA;IAC3D,kGAAkG;IAClG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CACpE;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,eAAe,GAAG,kBAAkB,CAChF,SAAQ,kBAAkB,EAAE,YAAY,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAClF,8EAA8E;IAC9E,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IAC3E,uEAAuE;IACvE,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACxF,4CAA4C;IAC5C,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAA;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,WAAW,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACzD,wDAAwD;IACxD,OAAO,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACnD,kDAAkD;IAClD,gBAAgB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACpC,oDAAoD;IACpD,kBAAkB,IAAI,UAAU,CAAC,cAAc,CAAC,CAAA;IAChD,8EAA8E;IAC9E,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACnE,2DAA2D;IAC3D,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IACjF,8EAA8E;IAC9E,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAC7H,sEAAsE;IACtE,gBAAgB,CACd,UAAU,EAAE,gBAAgB,EAC5B,gBAAgB,CAAC,EAAE,cAAc,EACjC,QAAQ,CAAC,EAAE,MAAM,aAAa,EAC9B,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,UAAU,CAAC,SAAS,CAAC,CAAA;CACzB"}
+{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAC1C,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D,OAAO,KAAK,EACV,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,eAAe,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAC3H,MAAM,iBAAiB,CAAA;AAExB,uDAAuD;AACvD,MAAM,WAAW,2BAA2B;IAC1C,0CAA0C;IAC1C,KAAK,EAAE,+BAA+B,CAAA;CACvC;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAqB,SAAQ,SAAS;IACrD;;;;OAIG;IACH,WAAW,EAAE,2BAA2B,CAAA;CACzC;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,sBAAsB,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACjG;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACvF;;;;;;;;;;OAUG;IACH,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACpG,0EAA0E;IAC1E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACjG,0DAA0D;IAC1D,YAAY,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAA;IAC3D,8IAA8I;IAC9I,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CACpE;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,+CAA+C;AAC/C,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,eAAe,GAAG,kBAAkB,CAChF,SAAQ,kBAAkB,EAAE,YAAY,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAClF,8EAA8E;IAC9E,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IAC3E,uEAAuE;IACvE,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACxF,4CAA4C;IAC5C,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAA;IAC9B,6DAA6D;IAC7D,OAAO,CAAC,WAAW,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACzD,wDAAwD;IACxD,OAAO,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACnD,kDAAkD;IAClD,gBAAgB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACpC,oDAAoD;IACpD,kBAAkB,IAAI,UAAU,CAAC,cAAc,CAAC,CAAA;IAChD,8EAA8E;IAC9E,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IACnE,2DAA2D;IAC3D,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IACjF,8EAA8E;IAC9E,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAA;IAC7H,sEAAsE;IACtE,gBAAgB,CACd,UAAU,EAAE,gBAAgB,EAC5B,gBAAgB,CAAC,EAAE,cAAc,EACjC,QAAQ,CAAC,EAAE,MAAM,aAAa,EAC9B,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,UAAU,CAAC,SAAS,CAAC,CAAA;CACzB"}

package/dist/neutral/modules/protocol-lib/viewers/Transaction.d.ts

@@ -2,7 +2,7 @@ import type { Hash, Promisable } from '@ariestools/sdk';
 import type { Provider, ProviderMoniker, SignedHydratedTransaction, SignedHydratedTransactionWithHashMeta } from '../../protocol-model/index.js';
 /** Operations exposed by the Transaction Viewer contract. */
 export interface TransactionViewerMethods {
-    /** Returns the result of the by hash query. */
+    /** Returns the transaction from the gateway store. Off-chain bodies are not read from a datalake. */
     byHash(transactionHash: Hash): Promisable<SignedHydratedTransactionWithHashMeta | null>;
     /** @deprecated use .byBlockHashAndIndex instead */
     transactionByBlockHashAndIndex(blockHash: Hash, transactionIndex: number): Promisable<SignedHydratedTransaction | null>;

package/dist/neutral/modules/protocol-lib/viewers/Transaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/Transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,KAAK,EACV,QAAQ,EAAE,eAAe,EAAE,yBAAyB,EAAE,qCAAqC,EAC5F,MAAM,iBAAiB,CAAA;AAExB,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,+CAA+C;IAC/C,MAAM,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAA;IAEvF,mDAAmD;IACnD,8BAA8B,CAAC,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IACvH,qDAAqD;IACrD,gCAAgC,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IAC7H,sCAAsC;IACtC,iBAAiB,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;CACvF;AAED,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,EAAG,mBAA4B,CAAA;AACpE,+DAA+D;AAC/D,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAA;AAEtE,qDAAqD;AACrD,MAAM,WAAW,iBAAiB,CAAC,QAAQ,SAAS,eAAe,GAAG,wBAAwB,CAAE,SAAQ,wBAAwB,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAClJ,+DAA+D;IAC/D,mBAAmB,CAAC,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAA;IACxH,iEAAiE;IACjE,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAA;CAC/H"}
+{"version":3,"file":"Transaction.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/viewers/Transaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,KAAK,EACV,QAAQ,EAAE,eAAe,EAAE,yBAAyB,EAAE,qCAAqC,EAC5F,MAAM,iBAAiB,CAAA;AAExB,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,qGAAqG;IACrG,MAAM,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAA;IAEvF,mDAAmD;IACnD,8BAA8B,CAAC,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IACvH,qDAAqD;IACrD,gCAAgC,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;IAC7H,sCAAsC;IACtC,iBAAiB,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;CACvF;AAED,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,EAAG,mBAA4B,CAAA;AACpE,+DAA+D;AAC/D,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAA;AAEtE,qDAAqD;AACrD,MAAM,WAAW,iBAAiB,CAAC,QAAQ,SAAS,eAAe,GAAG,wBAAwB,CAAE,SAAQ,wBAAwB,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAClJ,+DAA+D;IAC/D,mBAAmB,CAAC,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAA;IACxH,iEAAiE;IACjE,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,qCAAqC,GAAG,IAAI,CAAC,CAAA;CAC/H"}

package/dist/neutral/modules/validation/block/validators/BlockCumulativeBalanceValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockCumulativeBalanceValidator.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/block/validators/BlockCumulativeBalanceValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EACV,oCAAoC,EACpC,yBAAyB,EACzB,mCAAmC,EACpC,MAAM,eAAe,CAAA;AAoCtB,yFAAyF;AACzF,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,mCAAmC,EAAE,EACnD,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACrC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAiB5B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,mCAAmC,EAAE,EACnD,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACrC,yBAAyB,CAAC,CAAC,CAAC,CAM9B;AAED,oHAAoH;AACpH,wBAAgB,sCAAsC,IAAI,oCAAoC,CA0D7F"}
+{"version":3,"file":"BlockCumulativeBalanceValidator.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/block/validators/BlockCumulativeBalanceValidator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,KAAK,EACV,oCAAoC,EACpC,yBAAyB,EACzB,mCAAmC,EACpC,MAAM,eAAe,CAAA;AAqCtB,yFAAyF;AACzF,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,mCAAmC,EAAE,EACnD,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACrC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAiB5B;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,mCAAmC,EAAE,EACnD,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACrC,yBAAyB,CAAC,CAAC,CAAC,CAM9B;AAED,oHAAoH;AACpH,wBAAgB,sCAAsC,IAAI,oCAAoC,CA8D7F"}

package/dist/neutral/modules/validation/block/validators/BlockTransactionUniquenessValidator.d.ts

@@ -18,6 +18,10 @@ import type { HydratedBlockStateValidationFunction } from '../../../protocol-lib
  *
  * Chain engines must inject this alongside `BlockCumulativeBalanceValidatorFactory` — see the
  * note on `validateTransaction` about `additionalValidators`.
+ *
+ * Payloads the block bound witness does not reference are ignored, matching `_hash` or
+ * `_dataHash`. A caller that attaches extra transactions cannot force a duplicate or
+ * high-S finding for a transaction the block did not include.
  */
 export declare function BlockTransactionUniquenessValidatorFactory(): HydratedBlockStateValidationFunction;
 //# sourceMappingURL=BlockTransactionUniquenessValidator.d.ts.map

package/dist/neutral/modules/validation/block/validators/BlockTransactionUniquenessValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockTransactionUniquenessValidator.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/block/validators/BlockTransactionUniquenessValidator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,eAAe,CAAA;AAOzE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,0CAA0C,IAAI,oCAAoC,CA2CjG"}
+{"version":3,"file":"BlockTransactionUniquenessValidator.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/block/validators/BlockTransactionUniquenessValidator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,eAAe,CAAA;AAQzE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,0CAA0C,IAAI,oCAAoC,CA2CjG"}

package/dist/neutral/modules/validation/block/validators/transactionsReferencedByBlock.d.ts

@@ -0,0 +1,4 @@
+import type { HydratedBlockWithHashMeta, TransactionBoundWitnessWithHashMeta } from '../../../protocol-lib/index.js';
+/** Transactions the block bound witness references, matching `_hash` or `_dataHash`. */
+export declare function transactionsReferencedByBlock(block: HydratedBlockWithHashMeta[0], payloads: HydratedBlockWithHashMeta[1]): TransactionBoundWitnessWithHashMeta[];
+//# sourceMappingURL=transactionsReferencedByBlock.d.ts.map

package/dist/neutral/modules/validation/block/validators/transactionsReferencedByBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactionsReferencedByBlock.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/block/validators/transactionsReferencedByBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,mCAAmC,EAAE,MAAM,eAAe,CAAA;AAGnG,wFAAwF;AACxF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,yBAAyB,CAAC,CAAC,CAAC,EACnC,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GACrC,mCAAmC,EAAE,CAKvC"}

package/dist/neutral/protocol-lib.mjs

@@ -164,18 +164,67 @@ import {
 var StepSummarySchema = asSchema3("network.xyo.step.summary", true);
 
 // src/modules/protocol-lib/transaction/elevatedPayloads.ts
+import { isAllowedBlockPayload as isAllowedBlockPayload2 } from "#protocol-model";
+
+// src/modules/protocol-lib/transaction/script.ts
+import {
+  assertEx,
+  isHash
+} from "@ariestools/sdk";
+import { isHashMeta } from "@xyo-network/sdk";
 import { ELEVATE_OPCODE, isAllowedBlockPayload } from "#protocol-model";
+var elevatePrefix = `${ELEVATE_OPCODE}|`;
+function parseElevateOperation(op) {
+  if (!op.startsWith(elevatePrefix)) return void 0;
+  const hash = op.slice(elevatePrefix.length);
+  return isHash(hash) ? hash : void 0;
+}
+function strictElevateHashes(strings) {
+  const hashes = [];
+  for (const op of strings) {
+    if (!op.startsWith(elevatePrefix)) continue;
+    hashes.push(assertEx(parseElevateOperation(op), () => "Invalid elevated hashes"));
+  }
+  return hashes;
+}
+function tryExtractElevatedHashesFromScript(strings) {
+  const hashes = [];
+  for (const op of strings) {
+    const hash = parseElevateOperation(op);
+    if (hash !== void 0) hashes.push(hash);
+  }
+  return hashes;
+}
+function extractElevatedHashesFromScript(strings) {
+  return strictElevateHashes(strings);
+}
+function tryExtractElevatedHashes(tx) {
+  const [bw, payloads] = tx;
+  const hashes = bw.script ? tryExtractElevatedHashesFromScript(bw.script) : [];
+  return payloads.filter((payload) => hashes.includes(payload._hash)).filter(isAllowedBlockPayload).filter(isHashMeta);
+}
+function elevatedTransaction(tx) {
+  return [tx[0], tryExtractElevatedHashes(tx)];
+}
+function extractElevatedHashes(tx) {
+  const [bw, payloads] = tx;
+  const hashes = bw.script ? strictElevateHashes(bw.script) : [];
+  const filtered = payloads.filter((payload) => hashes.includes(payload._hash)).filter(isAllowedBlockPayload).filter(isHashMeta);
+  assertEx(filtered.length === hashes.length, () => "Invalid elevated hashes");
+  return filtered;
+}
+
+// src/modules/protocol-lib/transaction/elevatedPayloads.ts
 function tryElevatedPayloads([tx, payloads]) {
-  const opCodes = (tx.script ?? []).filter((operation) => operation.startsWith(`${ELEVATE_OPCODE}|`));
   const elevatedPayloads2 = [];
-  for (const opCode of opCodes) {
-    const [, hash] = opCode.split("|", 2);
+  for (const operation of tx.script ?? []) {
+    const hash = parseElevateOperation(operation);
+    if (hash === void 0) continue;
     const elevatedPayload = payloads.find((payload) => payload._hash === hash);
-    if (isAllowedBlockPayload(elevatedPayload)) {
-      elevatedPayloads2.push(elevatedPayload);
-    }
+    if (!isAllowedBlockPayload2(elevatedPayload)) return void 0;
+    elevatedPayloads2.push(elevatedPayload);
   }
-  return opCodes.length === elevatedPayloads2.length ? elevatedPayloads2 : void 0;
+  return elevatedPayloads2;
 }
 function elevatedPayloads(tx) {
   const result = tryElevatedPayloads(tx);
@@ -185,43 +234,6 @@ function elevatedPayloads(tx) {
   throw new Error("Not all elevated payloads could be found in the transaction payloads");
 }
 
-// src/modules/protocol-lib/transaction/script.ts
-import {
-  asHash,
-  assertEx,
-  filterAs
-} from "@ariestools/sdk";
-import { isHashMeta } from "@xyo-network/sdk";
-import { isAllowedBlockPayload as isAllowedBlockPayload2 } from "#protocol-model";
-var tryExtractElevatedHashesFromScript = (strings) => {
-  const hashes = strings.filter((str) => str.startsWith("elevate|")).map((str) => str.split("|", 2)[1]);
-  return filterAs(hashes, (h) => asHash(h));
-};
-var extractElevatedHashesFromScript = (strings) => {
-  const hashes = strings.filter((str) => str.startsWith("elevate|")).map((str) => str.split("|", 2)[1]);
-  const filtered = filterAs(hashes, (h) => asHash(h));
-  assertEx(filtered.length === hashes.length, () => "Invalid elevated hashes");
-  return filtered;
-};
-var tryExtractElevatedHashes = (tx) => {
-  const [bw, payloads] = tx;
-  const { script } = bw;
-  const hashes = script ? tryExtractElevatedHashesFromScript(script) : [];
-  return payloads.filter((p) => hashes.includes(p._hash)).filter(isAllowedBlockPayload2).filter(isHashMeta);
-};
-var elevatedTransaction = (tx) => (
-  // The cast bridges the loose-object payload typing; the elevated payloads are a subset of the originals.
-  [tx[0], tryExtractElevatedHashes(tx)]
-);
-var extractElevatedHashes = (tx) => {
-  const [bw, payloads] = tx;
-  const { script } = bw;
-  const hashes = script ? tryExtractElevatedHashesFromScript(script) : [];
-  const filtered = payloads.filter((p) => hashes.includes(p._hash)).filter(isAllowedBlockPayload2).filter(isHashMeta);
-  assertEx(filtered.length === hashes.length, () => "Invalid elevated hashes");
-  return filtered;
-};
-
 // src/modules/protocol-lib/validation/block/error.ts
 import {
   HashZod as HashZod2,
@@ -714,6 +726,7 @@ export {
   isTransactionValidationConfig,
   isValidationError,
   isXyoJwtSignerMethods,
+  parseElevateOperation,
   requireRuleActive,
   resolveChainIdAtBlockNumber,
   resolveRuleParams,