@xyo-network/xl1-protocol 4.0.11 → 4.0.14

package/dist/neutral/modules/protocol-lib/repository/TransactionWriteRepository.d.ts

@@ -0,0 +1,6 @@
+import type { SignedHydratedTransaction } from '../../protocol-model/index.js';
+import type { WriteRepository } from './Repository.js';
+/** TransactionWriteRepository interface. */
+export interface TransactionWriteRepository extends WriteRepository<SignedHydratedTransaction, boolean> {
+}
+//# sourceMappingURL=TransactionWriteRepository.d.ts.map

package/dist/neutral/modules/protocol-lib/repository/TransactionWriteRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionWriteRepository.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/repository/TransactionWriteRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEtD,4CAA4C;AAC5C,MAAM,WAAW,0BAA2B,SAAQ,eAAe,CAAC,yBAAyB,EAAE,OAAO,CAAC;CAAG"}

package/dist/neutral/modules/protocol-lib/repository/index.d.ts

@@ -0,0 +1,6 @@
+export * from './Repository.js';
+export * from './TransactionReadRepository.js';
+export * from './TransactionRepository.js';
+export * from './TransactionRepositoryIterator.js';
+export * from './TransactionWriteRepository.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/protocol-lib/repository/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/repository/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oCAAoC,CAAA;AAClD,cAAc,iCAAiC,CAAA"}

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

@@ -0,0 +1,16 @@
+import type { WithHashMeta } from '@xyo-network/sdk';
+import type { BlockBoundWitness, Provider, SignedBlockBoundWitnessWithHashMeta, SignedHydratedBlockWithHashMeta } from '../../protocol-model/index.js';
+/** BlockRunnerMethods interface. */
+export interface BlockRunnerMethods {
+    produceNextBlock(head: SignedBlockBoundWitnessWithHashMeta, force: true): Promise<SignedHydratedBlockWithHashMeta>;
+    produceNextBlock(head: SignedBlockBoundWitnessWithHashMeta, force?: boolean): Promise<SignedHydratedBlockWithHashMeta | undefined>;
+}
+/** Moniker identifier for the BlockRunner provider. */
+export declare const BlockRunnerMoniker: "BlockRunner";
+/** Type literal for the BlockRunner provider moniker. */
+export type BlockRunnerMoniker = typeof BlockRunnerMoniker;
+/** Runner interface for executing Block operations. */
+export interface BlockRunner extends BlockRunnerMethods, Provider<BlockRunnerMoniker> {
+    next(head: WithHashMeta<BlockBoundWitness>): Promise<SignedHydratedBlockWithHashMeta | undefined>;
+}
+//# sourceMappingURL=Block.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EACV,iBAAiB,EAAE,QAAQ,EAC3B,mCAAmC,EAAE,+BAA+B,EACrE,MAAM,iBAAiB,CAAA;AAExB,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,CAAC,IAAI,EAAE,mCAAmC,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAA;IAClH,gBAAgB,CAAC,IAAI,EAAE,mCAAmC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,+BAA+B,GAAG,SAAS,CAAC,CAAA;CACnI;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,uDAAuD;AACvD,MAAM,WAAW,WAAY,SAAQ,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IACnF,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,+BAA+B,GAAG,SAAS,CAAC,CAAA;CAClG"}

package/dist/neutral/modules/protocol-lib/runners/BlockPublish.d.ts

@@ -0,0 +1,30 @@
+import type { Provider, SignedHydratedBlockWithHashMeta, XL1BlockNumber, XL1BlockRange } from '../../protocol-model/index.js';
+/** BlockPublishRunnerMethods interface. */
+export interface BlockPublishRunnerMethods {
+    /**
+     * Finds where a catch-up sync should start: walks backwards from the source head until
+     * it finds an already published block (never probing below `floor`, default genesis) and
+     * returns the block after it. Lets a publisher resume behind an external importer or a
+     * stale head pointer without republishing what is already there. Only the topmost
+     * contiguous gap is healed — holes below the first published block found are not probed.
+     */
+    findCatchUpStart(floor?: XL1BlockNumber): Promise<XL1BlockNumber>;
+    /** True when the block is already published at its by-number path. */
+    hasBlock(block: XL1BlockNumber): Promise<boolean>;
+    /** Publishes one finalized block and its payloads; null when the source has no such block. */
+    publishBlock(block: XL1BlockNumber): Promise<SignedHydratedBlockWithHashMeta | null>;
+    /**
+     * Publishes every block from `from` (inclusive, default genesis) through the source head.
+     * Returns the published range, or null when already up to date. Idempotent — republishing
+     * any range is safe.
+     */
+    sync(from?: XL1BlockNumber): Promise<XL1BlockRange | null>;
+}
+/** Moniker identifier for the BlockPublishRunner provider. */
+export declare const BlockPublishRunnerMoniker: "BlockPublishRunner";
+/** Type literal for the BlockPublishRunner provider moniker. */
+export type BlockPublishRunnerMoniker = typeof BlockPublishRunnerMoniker;
+/** Runner interface for publishing finalized blocks. */
+export interface BlockPublishRunner extends BlockPublishRunnerMethods, Provider<BlockPublishRunnerMoniker> {
+}
+//# sourceMappingURL=BlockPublish.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/BlockPublish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockPublish.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/BlockPublish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EAAE,+BAA+B,EAAE,cAAc,EAAE,aAAa,EACzE,MAAM,iBAAiB,CAAA;AAExB,2CAA2C;AAC3C,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,gBAAgB,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IACjE,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjD,8FAA8F;IAC9F,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACpF;;;;OAIG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CAC3D;AAED,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,EAAG,oBAA6B,CAAA;AACtE,gEAAgE;AAChE,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,wDAAwD;AACxD,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB,CAAC;CAAG"}

package/dist/neutral/modules/protocol-lib/runners/ChainStatePublish.d.ts

@@ -0,0 +1,18 @@
+import type { Provider, SignedHydratedBlockWithHashMeta } from '../../protocol-model/index.js';
+/** ChainStatePublishRunnerMethods interface. */
+export interface ChainStatePublishRunnerMethods {
+    /**
+     * Publishes the source's current head to the mutable chain state. Callers must ensure the
+     * finalized files for that head are published first, so readers never see a head that
+     * references missing files.
+     */
+    publishHead(): Promise<SignedHydratedBlockWithHashMeta>;
+}
+/** Moniker identifier for the ChainStatePublishRunner provider. */
+export declare const ChainStatePublishRunnerMoniker: "ChainStatePublishRunner";
+/** Type literal for the ChainStatePublishRunner provider moniker. */
+export type ChainStatePublishRunnerMoniker = typeof ChainStatePublishRunnerMoniker;
+/** Runner interface for publishing the mutable chain state (the current head). */
+export interface ChainStatePublishRunner extends ChainStatePublishRunnerMethods, Provider<ChainStatePublishRunnerMoniker> {
+}
+//# sourceMappingURL=ChainStatePublish.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/ChainStatePublish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainStatePublish.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/ChainStatePublish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AAEhF,gDAAgD;AAChD,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,+BAA+B,CAAC,CAAA;CACxD;AAED,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,EAAG,yBAAkC,CAAA;AAChF,qEAAqE;AACrE,MAAM,MAAM,8BAA8B,GAAG,OAAO,8BAA8B,CAAA;AAElF,kFAAkF;AAClF,MAAM,WAAW,uBAAwB,SAAQ,8BAA8B,EAAE,QAAQ,CAAC,8BAA8B,CAAC;CAAG"}

package/dist/neutral/modules/protocol-lib/runners/DataLakePublish.d.ts

@@ -0,0 +1,27 @@
+import type { Provider } from '../../protocol-model/index.js';
+import type { DataLakeData } from '../providers/DataLake/Provider.js';
+/**
+ * DataLakePublishRunnerMethods interface.
+ *
+ * Bespoke write-only surface for publishing datalake payloads. Deliberately does not
+ * derive from the archivist interfaces (`WriteArchivistFunctions`), but `insert` is
+ * signature-compatible with the archivist `insert`, so an implementation can also
+ * back a `DataLakeRunner` where one is required.
+ */
+export interface DataLakePublishRunnerMethods {
+    /**
+     * Publishes the given payloads and returns the published items (with hash meta).
+     * Items filtered out (non-payloads, disallowed schemas) are omitted from the result.
+     * Idempotent — keys are content-addressed and contents immutable, so re-inserting
+     * any item is safe.
+     */
+    insert(items: DataLakeData[]): Promise<DataLakeData[]>;
+}
+/** Moniker identifier for the DataLakePublishRunner provider. */
+export declare const DataLakePublishRunnerMoniker: "DataLakePublishRunner";
+/** Type literal for the DataLakePublishRunner provider moniker. */
+export type DataLakePublishRunnerMoniker = typeof DataLakePublishRunnerMoniker;
+/** Runner interface for publishing datalake payloads. */
+export interface DataLakePublishRunner extends DataLakePublishRunnerMethods, Provider<DataLakePublishRunnerMoniker> {
+}
+//# sourceMappingURL=DataLakePublish.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/DataLakePublish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataLakePublish.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/DataLakePublish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAErE;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CACvD;AAED,iEAAiE;AACjE,eAAO,MAAM,4BAA4B,EAAG,uBAAgC,CAAA;AAC5E,mEAAmE;AACnE,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAE9E,yDAAyD;AACzD,MAAM,WAAW,qBAAsB,SAAQ,4BAA4B,EAAE,QAAQ,CAAC,4BAA4B,CAAC;CAAG"}

package/dist/neutral/modules/protocol-lib/runners/DeadLetterQueue.d.ts

@@ -0,0 +1,22 @@
+import type { BlockRejection, Provider, TransactionRejection } from '../../protocol-model/index.js';
+/** DeadLetterQueueRunnerMethods interface. */
+export interface DeadLetterQueueRunnerMethods {
+    rejectBlock(rejection: BlockRejection): Promise<boolean>;
+    rejectTransaction(rejection: TransactionRejection): Promise<boolean>;
+}
+/** Moniker identifier for the DeadLetterQueueRunner provider. */
+export declare const DeadLetterQueueRunnerMoniker: "DeadLetterQueueRunner";
+/** Type literal for the DeadLetterQueueRunner provider moniker. */
+export type DeadLetterQueueRunnerMoniker = typeof DeadLetterQueueRunnerMoniker;
+/** Options for DeadLetterQueue pruning. */
+export interface DeadLetterQueuePruneOptions {
+    batchSize?: number;
+    maxCheck?: number;
+    maxPrune?: number;
+}
+/** Runner interface for executing DeadLetterQueue write operations. */
+export interface DeadLetterQueueRunner extends DeadLetterQueueRunnerMethods, Provider<DeadLetterQueueRunnerMoniker> {
+    pruneRejectedBlocks(options?: DeadLetterQueuePruneOptions): Promise<[number, number]>;
+    pruneRejectedTransactions(options?: DeadLetterQueuePruneOptions): Promise<[number, number]>;
+}
+//# sourceMappingURL=DeadLetterQueue.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/DeadLetterQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeadLetterQueue.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/DeadLetterQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAAE,QAAQ,EAAE,oBAAoB,EAC/C,MAAM,iBAAiB,CAAA;AAExB,8CAA8C;AAC9C,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACxD,iBAAiB,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACrE;AAED,iEAAiE;AACjE,eAAO,MAAM,4BAA4B,EAAG,uBAAgC,CAAA;AAC5E,mEAAmE;AACnE,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAE9E,2CAA2C;AAC3C,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,qBAAsB,SAAQ,4BAA4B,EAAE,QAAQ,CAAC,4BAA4B,CAAC;IACjH,mBAAmB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACrF,yBAAyB,CAAC,OAAO,CAAC,EAAE,2BAA2B,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAC5F"}

package/dist/neutral/modules/protocol-lib/runners/Finalization.d.ts

@@ -0,0 +1,15 @@
+import type { Hash } from '@ariestools/sdk';
+import type { Provider, SignedHydratedBlockWithHashMeta } from '../../protocol-model/index.js';
+/** FinalizationRunnerMethods interface. */
+export interface FinalizationRunnerMethods {
+    finalizeBlocks(blocks: SignedHydratedBlockWithHashMeta[]): Promise<Hash[]>;
+}
+/** Moniker identifier for the FinalizationRunner provider. */
+export declare const FinalizationRunnerMoniker: "FinalizationRunner";
+/** Type literal for the FinalizationRunner provider moniker. */
+export type FinalizationRunnerMoniker = typeof FinalizationRunnerMoniker;
+/** Runner interface for executing Finalization operations. */
+export interface FinalizationRunner extends FinalizationRunnerMethods, Provider<FinalizationRunnerMoniker> {
+    finalizeBlock(block: SignedHydratedBlockWithHashMeta): Promise<Hash>;
+}
+//# sourceMappingURL=Finalization.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/Finalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Finalization.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/Finalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AAEhF,2CAA2C;AAC3C,MAAM,WAAW,yBAAyB;IACxC,cAAc,CAAC,MAAM,EAAE,+BAA+B,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;CAC3E;AAED,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,EAAG,oBAA6B,CAAA;AACtE,gEAAgE;AAChE,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,8DAA8D;AAC9D,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB,CAAC;IACxG,aAAa,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrE"}

package/dist/neutral/modules/protocol-lib/runners/IndexPublish.d.ts

@@ -0,0 +1,35 @@
+import type { Hash } from '@ariestools/sdk';
+import type { Provider, XL1BlockNumber } from '../../protocol-model/index.js';
+/** The summary families the index publishes, one path tree each. */
+export type IndexSummaryFamily = 'balances' | 'blocks' | 'schemas' | 'transfers';
+/** The indexer's progress: how far the index is complete, and how much it has published. */
+export interface IndexWatermark {
+    /** Highest block the index is complete through (never above the finalized head). */
+    block: XL1BlockNumber;
+    /** Completed frame counts published per family. */
+    families: Record<IndexSummaryFamily, number>;
+    /** Hash of that block. */
+    hash: Hash;
+}
+/** IndexPublishRunnerMethods interface. */
+export interface IndexPublishRunnerMethods {
+    /**
+     * Builds and publishes every family's frames completed at or below `ceiling` — resuming from
+     * the published watermark so already-published frames are skipped — then rewrites the index
+     * manifest and the watermark last. Returns the new watermark.
+     */
+    publishCompletedFramesUpTo(ceiling: XL1BlockNumber): Promise<IndexWatermark>;
+    /**
+     * Publishes one completed frame for a family (building any missing sub-frames it depends on);
+     * rejects for an incomplete (in-flight) frame. A no-op when the frame is already published.
+     */
+    publishFrame(family: IndexSummaryFamily, stepLevel: number, stepIndex: number): Promise<void>;
+}
+/** Moniker identifier for the IndexPublishRunner provider. */
+export declare const IndexPublishRunnerMoniker: "IndexPublishRunner";
+/** Type literal for the IndexPublishRunner provider moniker. */
+export type IndexPublishRunnerMoniker = typeof IndexPublishRunnerMoniker;
+/** Runner interface for publishing step summaries (the chain index). */
+export interface IndexPublishRunner extends IndexPublishRunnerMethods, Provider<IndexPublishRunnerMoniker> {
+}
+//# sourceMappingURL=IndexPublish.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/IndexPublish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexPublish.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/IndexPublish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE/D,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;AAEhF,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,KAAK,EAAE,cAAc,CAAA;IACrB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAA;IAC5C,0BAA0B;IAC1B,IAAI,EAAE,IAAI,CAAA;CACX;AAED,2CAA2C;AAC3C,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,0BAA0B,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAC5E;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9F;AAED,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,EAAG,oBAA6B,CAAA;AACtE,gEAAgE;AAChE,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,wEAAwE;AACxE,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB,CAAC;CAAG"}

package/dist/neutral/modules/protocol-lib/runners/Mempool.d.ts

@@ -0,0 +1,25 @@
+import type { Hash } from '@ariestools/sdk';
+import type { Provider, SignedHydratedBlock, SignedHydratedTransaction } from '../../protocol-model/index.js';
+/** MempoolRunnerMethods interface. */
+export interface MempoolRunnerMethods {
+    submitBlocks(blocks: SignedHydratedBlock[]): Promise<Hash[]>;
+    submitTransactions(transactions: SignedHydratedTransaction[]): Promise<Hash[]>;
+}
+/** Moniker identifier for the MempoolRunner provider. */
+export declare const MempoolRunnerMoniker: "MempoolRunner";
+/** Type literal for the MempoolRunner provider moniker. */
+export type MempoolRunnerMoniker = typeof MempoolRunnerMoniker;
+/** DEFAULT_MAX_EXP_AHEAD constant. */
+export declare const DEFAULT_MAX_EXP_AHEAD = 1000;
+/** Options for MempoolPrune. */
+export interface MempoolPruneOptions {
+    batchSize?: number;
+    maxCheck?: number;
+    maxPrune?: number;
+}
+/** Runner interface for executing Mempool operations. */
+export interface MempoolRunner extends MempoolRunnerMethods, Provider<MempoolRunnerMoniker> {
+    prunePendingBlocks(options?: MempoolPruneOptions): Promise<[number, number]>;
+    prunePendingTransactions(options?: MempoolPruneOptions): Promise<[number, number]>;
+}
+//# sourceMappingURL=Mempool.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/Mempool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mempool.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/Mempool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,KAAK,EACV,QAAQ,EAAE,mBAAmB,EAAE,yBAAyB,EACzD,MAAM,iBAAiB,CAAA;AAExB,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5D,kBAAkB,CAAC,YAAY,EAAE,yBAAyB,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;CAC/E;AAED,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,EAAG,eAAwB,CAAA;AAC5D,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAA;AAE9D,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,OAAO,CAAA;AAEzC,gCAAgC;AAChC,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAc,SAAQ,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB,CAAC;IACzF,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5E,wBAAwB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACnF"}

package/dist/neutral/modules/protocol-lib/runners/index.d.ts

@@ -0,0 +1,9 @@
+export * from './Block.js';
+export * from './BlockPublish.js';
+export * from './ChainStatePublish.js';
+export * from './DataLakePublish.js';
+export * from './DeadLetterQueue.js';
+export * from './Finalization.js';
+export * from './IndexPublish.js';
+export * from './Mempool.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/protocol-lib/runners/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/runners/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA"}

package/dist/neutral/modules/protocol-lib/status/SystemStatus.d.ts

@@ -0,0 +1,84 @@
+import type { CreatableName, CreatableStatus, CreatableStatusReporter } from '@ariestools/sdk';
+import type { Provider } from '../../protocol-model/index.js';
+/**
+ * Readiness of an actor's warm-pass, orthogonal to the lifecycle `CreatableStatus`.
+ * Mirrors the orchestration-layer `ReadyState` so actors can report it verbatim.
+ */
+export type SystemReadyState = 'failed' | 'pending' | 'ready';
+/** A single component's combined lifecycle + readiness record (a serializable view). */
+export interface SystemStatusRecord {
+    error?: string;
+    lifecycle: CreatableStatus;
+    name: string;
+    progress?: number;
+    readiness?: SystemReadyState;
+    updatedAt: number;
+}
+/** Point-in-time view of the whole system's status. */
+export interface SystemStatusSnapshot {
+    components: SystemStatusRecord[];
+    globalStatus: CreatableStatus;
+    isReady: boolean;
+    isShuttingDown: boolean;
+}
+/** Filter for a global (aggregate) status transition. */
+export interface SystemStatusGlobalTransitionMatch {
+    from?: CreatableStatus;
+    to?: CreatableStatus;
+}
+/** Filter for a named component status transition. */
+export interface SystemStatusTransitionMatch {
+    from?: CreatableStatus;
+    name: string;
+    to?: CreatableStatus;
+}
+/** Callback fired on a matched status transition. */
+export type SystemStatusTransitionListener = (from: CreatableStatus, to: CreatableStatus) => void;
+/** Moniker identifier for the SystemStatusRunner provider. */
+export declare const SystemStatusRunnerMoniker: "SystemStatusRunner";
+/** Type literal for the SystemStatusRunner provider moniker. */
+export type SystemStatusRunnerMoniker = typeof SystemStatusRunnerMoniker;
+/** Moniker identifier for the SystemStatusViewer provider. */
+export declare const SystemStatusViewerMoniker: "SystemStatusViewer";
+/** Type literal for the SystemStatusViewer provider moniker. */
+export type SystemStatusViewerMoniker = typeof SystemStatusViewerMoniker;
+/** Moniker identifier for the SystemStatusPublisher provider. */
+export declare const SystemStatusPublisherMoniker: "SystemStatusPublisher";
+/** Type literal for the SystemStatusPublisher provider moniker. */
+export type SystemStatusPublisherMoniker = typeof SystemStatusPublisherMoniker;
+/** Read-only query surface over system status, shared by the Viewer and the Runner. */
+export interface SystemStatusViewerMethods {
+    getGlobalStatus(): CreatableStatus;
+    getStatus(name: CreatableName): CreatableStatus | undefined;
+    isReady(): boolean;
+    isShuttingDown(): boolean;
+    snapshot(): SystemStatusSnapshot;
+}
+/** Read-only viewer of system status. */
+export interface SystemStatusViewer extends SystemStatusViewerMethods, Provider<SystemStatusViewerMoniker> {
+}
+/**
+ * Reporting + subscription surface on top of the read-only viewer methods.
+ * `report` is inherited from `CreatableStatusReporter`, which is what the
+ * lifecycle base (`AbstractCreatable`) calls on every status transition.
+ */
+export interface SystemStatusRunnerMethods extends SystemStatusViewerMethods {
+    onGlobalTransition(match: SystemStatusGlobalTransitionMatch, handler: SystemStatusTransitionListener): void;
+    onTransition(match: SystemStatusTransitionMatch, handler: SystemStatusTransitionListener): void;
+    reportReady(name: CreatableName, readiness: SystemReadyState, error?: Error | string): void;
+    setShuttingDown(shuttingDown: boolean): void;
+}
+/**
+ * The process-wide status hub. Actors and providers report lifecycle status
+ * (via `report`) and readiness (via `reportReady`) into it; it holds the live
+ * state, computes the global status, and fires transition callbacks.
+ */
+export interface SystemStatusRunner extends SystemStatusRunnerMethods, CreatableStatusReporter, Provider<SystemStatusRunnerMoniker> {
+}
+/**
+ * Publishes system status outward (console, HTTP, etc.). The publishing work
+ * happens in the provider's start/stop handlers; the interface is a marker.
+ */
+export interface SystemStatusPublisher extends Provider<SystemStatusPublisherMoniker> {
+}
+//# sourceMappingURL=SystemStatus.d.ts.map

package/dist/neutral/modules/protocol-lib/status/SystemStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemStatus.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/status/SystemStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAAE,eAAe,EAAE,uBAAuB,EACxD,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7D,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,eAAe,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,kBAAkB,EAAE,CAAA;IAChC,YAAY,EAAE,eAAe,CAAA;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,OAAO,CAAA;CACxB;AAED,yDAAyD;AACzD,MAAM,WAAW,iCAAiC;IAChD,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,EAAE,CAAC,EAAE,eAAe,CAAA;CACrB;AAED,sDAAsD;AACtD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,eAAe,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,CAAC,EAAE,eAAe,CAAA;CACrB;AAED,qDAAqD;AACrD,MAAM,MAAM,8BAA8B,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,KAAK,IAAI,CAAA;AAEjG,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,EAAG,oBAA6B,CAAA;AACtE,gEAAgE;AAChE,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,EAAG,oBAA6B,CAAA;AACtE,gEAAgE;AAChE,MAAM,MAAM,yBAAyB,GAAG,OAAO,yBAAyB,CAAA;AAExE,iEAAiE;AACjE,eAAO,MAAM,4BAA4B,EAAG,uBAAgC,CAAA;AAC5E,mEAAmE;AACnE,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAE9E,uFAAuF;AACvF,MAAM,WAAW,yBAAyB;IACxC,eAAe,IAAI,eAAe,CAAA;IAClC,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,SAAS,CAAA;IAC3D,OAAO,IAAI,OAAO,CAAA;IAClB,cAAc,IAAI,OAAO,CAAA;IACzB,QAAQ,IAAI,oBAAoB,CAAA;CACjC;AAED,yCAAyC;AACzC,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB,EAAE,QAAQ,CAAC,yBAAyB,CAAC;CAAG;AAE7G;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,yBAAyB;IAC1E,kBAAkB,CAAC,KAAK,EAAE,iCAAiC,EAAE,OAAO,EAAE,8BAA8B,GAAG,IAAI,CAAA;IAC3G,YAAY,CAAC,KAAK,EAAE,2BAA2B,EAAE,OAAO,EAAE,8BAA8B,GAAG,IAAI,CAAA;IAC/F,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAA;IAC3F,eAAe,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAA;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,yBAAyB,EAAE,uBAAuB,EAAE,QAAQ,CAAC,yBAAyB,CAAC;CAAG;AAEtI;;;GAGG;AACH,MAAM,WAAW,qBAAsB,SAAQ,QAAQ,CAAC,4BAA4B,CAAC;CAAG"}

package/dist/neutral/modules/protocol-lib/status/index.d.ts

@@ -0,0 +1,2 @@
+export * from './SystemStatus.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/protocol-lib/status/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/status/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA"}

package/dist/neutral/modules/protocol-lib/summary/BlocksStepSummary.d.ts

@@ -0,0 +1,26 @@
+import type { WithStorageMeta } from '@xyo-network/sdk';
+import type { SignedHydratedBlockWithHashMeta } from '../../protocol-model/index.js';
+import type { StepSummary } from './StepSummary.js';
+/** Schema identifier for blocks step summary payloads */
+export declare const BlocksStepSummarySchema: "network.xyo.step.summary.blocks" & {
+    readonly __schema: true;
+};
+/** Schema type for BlocksStepSummary payloads. */
+export type BlocksStepSummarySchema = typeof BlocksStepSummarySchema;
+/** Step summary payload containing every block in the step frame */
+export type BlocksStepSummary = StepSummary<{
+    blocks: SignedHydratedBlockWithHashMeta[];
+}, BlocksStepSummarySchema>;
+/**
+ * Identity function for determining if an object is a BlocksStepSummary
+ */
+export declare const isBlocksStepSummary: (x?: unknown) => x is BlocksStepSummary;
+/** Type assertion factory for BlocksStepSummary payloads */
+export declare const asBlocksStepSummary: import("@ariestools/sdk").AsTypeFunction<BlocksStepSummary>;
+/**
+ * Identity function for determining if an object is a BlocksStepSummary with Storage Meta
+ */
+export declare const isBlocksStepSummaryWithStorageMeta: (value: unknown) => value is WithStorageMeta<BlocksStepSummary>;
+/** Type assertion factory for BlocksStepSummary with storage metadata */
+export declare const asBlocksStepSummaryWithStorageMeta: import("@ariestools/sdk").AsTypeFunction<WithStorageMeta<BlocksStepSummary>>;
+//# sourceMappingURL=BlocksStepSummary.d.ts.map

package/dist/neutral/modules/protocol-lib/summary/BlocksStepSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlocksStepSummary.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/summary/BlocksStepSummary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKvD,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAA;AAEtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,yDAAyD;AACzD,eAAO,MAAM,uBAAuB;;CAAoD,CAAA;AACxF,kDAAkD;AAClD,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,oEAAoE;AACpE,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC;IAC1C,MAAM,EAAE,+BAA+B,EAAE,CAAA;CAC1C,EAAE,uBAAuB,CAAC,CAAA;AAE3B;;GAEG;AACH,eAAO,MAAM,mBAAmB,yCAAoE,CAAA;AACpG,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,6DAAiE,CAAA;AAEjG;;GAEG;AACH,eAAO,MAAM,kCAAkC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAAe,CAAC,iBAAiB,CAE7G,CAAA;AACD,yEAAyE;AACzE,eAAO,MAAM,kCAAkC,8EAAiG,CAAA"}

package/dist/neutral/modules/protocol-lib/summary/StepSummary.d.ts

@@ -0,0 +1,16 @@
+import type { EmptyObject, Hash } from '@ariestools/sdk';
+import { type Payload, type Schema } from '@xyo-network/sdk';
+/** Schema identifier for step summary payloads */
+export declare const StepSummarySchema: "network.xyo.step.summary" & {
+    readonly __schema: true;
+};
+/** Schema type for StepSummary payloads. */
+export type StepSummarySchema = typeof StepSummarySchema;
+/** Fields common to all step summary payloads */
+export interface StepSummaryFields {
+    hash: Hash;
+    stepSize: number;
+}
+/** Payload type for a step summary with optional additional fields and schema */
+export type StepSummary<TAdditionalFields extends EmptyObject | void = void, TSchema extends Schema | void = void> = Payload<TAdditionalFields extends void ? StepSummaryFields : TAdditionalFields & StepSummaryFields, TSchema extends void ? StepSummarySchema : TSchema>;
+//# sourceMappingURL=StepSummary.d.ts.map

package/dist/neutral/modules/protocol-lib/summary/StepSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepSummary.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/summary/StepSummary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EACK,KAAK,OAAO,EAAE,KAAK,MAAM,EACpC,MAAM,kBAAkB,CAAA;AAEzB,kDAAkD;AAClD,eAAO,MAAM,iBAAiB;;CAA6C,CAAA;AAC3E,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAA;AAExD,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,iFAAiF;AACjF,MAAM,MAAM,WAAW,CAAC,iBAAiB,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EACzE,OAAO,SAAS,MAAM,GAAG,IAAI,GAAG,IAAI,IAAI,OAAO,CAAC,iBAAiB,SAAS,IAAI,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,iBAAiB,EAC1I,OAAO,SAAS,IAAI,GAAG,iBAAiB,GAAG,OAAO,CAAC,CAAA"}

package/dist/neutral/modules/protocol-lib/summary/index.d.ts

@@ -0,0 +1,4 @@
+export * from './BlocksStepSummary.js';
+export * from './stepPlacement.js';
+export * from './StepSummary.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/protocol-lib/summary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/summary/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA"}

package/dist/neutral/modules/protocol-lib/summary/stepPlacement.d.ts

@@ -0,0 +1,21 @@
+import type { Hash } from '@ariestools/sdk';
+import type { BlockViewer } from '../viewers/Block.js';
+/** A completed step frame's placement in the index: which family file it lives in. */
+export interface StepPlacement {
+    stepIndex: number;
+    stepLevel: number;
+}
+/**
+ * Resolves a step frame's head block number + frame size to its `(stepLevel, stepIndex)`
+ * placement in the index. Returns undefined when `stepSize` isn't a recognized step size, or the
+ * resulting index isn't a whole, non-negative step — i.e. the frame isn't a real completed step.
+ */
+export declare function stepPlacementForBlockNumber(blockNumber: number, stepSize: number): StepPlacement | undefined;
+/**
+ * Resolves a step frame's head hash + frame size (the `${hash}|${stepSize}` cache key shared by
+ * every `*StepSummaryFromRange` builder) to its `(stepLevel, stepIndex)` placement in the index,
+ * by looking up the frame's head block number via `blockViewer`. Returns undefined when the hash
+ * can't be resolved to a block, or `stepPlacementForBlockNumber` does.
+ */
+export declare function resolveStepPlacement(blockViewer: BlockViewer, hash: Hash, stepSize: number): Promise<StepPlacement | undefined>;
+//# sourceMappingURL=stepPlacement.d.ts.map

package/dist/neutral/modules/protocol-lib/summary/stepPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepPlacement.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/summary/stepPlacement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAI3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAK5G;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAIpC"}

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

@@ -0,0 +1,5 @@
+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. */
+export declare function elevatedPayloads([tx, payloads]: HydratedTransactionWithHashMeta): WithHashMeta<AllowedBlockPayload>[];
+//# sourceMappingURL=elevatedPayloads.d.ts.map

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

@@ -0,0 +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;AAK3F,wEAAwE;AACxE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,+BAA+B,uCAgB/E"}

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

@@ -0,0 +1,3 @@
+export * from './elevatedPayloads.js';
+export * from './script.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol-lib/transaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA"}

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

@@ -0,0 +1,17 @@
+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>[];
+/**
+ * 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.
+ */
+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>[];
+//# sourceMappingURL=script.d.ts.map

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

@@ -0,0 +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"}

package/dist/neutral/modules/protocol-lib/validation/block/BlockValidationFunction.d.ts

@@ -0,0 +1,6 @@
+import type { Promisable } from '@ariestools/sdk';
+import type { BaseContext, BlockBoundWitness, ChainId } from '../../../protocol-model/index.js';
+import type { BlockValidationError } from './error.js';
+/** Function type for BlockValidator operations. */
+export type BlockValidatorFunction = (context: BaseContext, block: BlockBoundWitness, chainId?: ChainId) => Promisable<BlockValidationError[]>;
+//# sourceMappingURL=BlockValidationFunction.d.ts.map

package/dist/neutral/modules/protocol-lib/validation/block/BlockValidationFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockValidationFunction.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/protocol-lib/validation/block/BlockValidationFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EACV,WAAW,EAAE,iBAAiB,EAAE,OAAO,EACxC,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEtD,mDAAmD;AACnD,MAAM,MAAM,sBAAsB,GAAG,CACnC,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,OAAO,KACd,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAA"}

package/dist/neutral/modules/protocol-lib/validation/block/HydratedBlockStateValidationFunction.d.ts

@@ -0,0 +1,19 @@
+import type { Promisable } from '@ariestools/sdk';
+import type { AccountBalanceViewer, BaseContext, ChainId, HydratedBlockWithHashMeta, XL1BlockNumber } from '../../../protocol-model/index.js';
+import type { HydratedBlockStateValidationError } from './error.js';
+/** Function type for ChainAtBlockNumber operations. */
+export type ChainAtBlockNumberFunction = (blockNumber: XL1BlockNumber) => Promisable<ChainId>;
+/** Context for HydratedBlockStateValidationFunction operations. */
+export interface HydratedBlockStateValidationFunctionContext extends BaseContext {
+    accountBalance: AccountBalanceViewer;
+    chainIdAtBlockNumber: ChainAtBlockNumberFunction;
+}
+/**
+ * A function that validates a hydrated block against chain state.
+ * @param hydratedBlock The hydrated block to validate.
+ * @param chainId The chain ID to use for validation.
+ * @param archivist The archivist to use for validation.
+ * @returns An array of errors if the block is invalid, or an empty array if it is valid.
+ */
+export type HydratedBlockStateValidationFunction = (context: HydratedBlockStateValidationFunctionContext, hydratedBlock: HydratedBlockWithHashMeta) => Promisable<HydratedBlockStateValidationError[]>;
+//# sourceMappingURL=HydratedBlockStateValidationFunction.d.ts.map

package/dist/neutral/modules/protocol-lib/validation/block/HydratedBlockStateValidationFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HydratedBlockStateValidationFunction.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/protocol-lib/validation/block/HydratedBlockStateValidationFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EAAE,OAAO,EACpB,yBAAyB,EAAE,cAAc,EAC1C,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,YAAY,CAAA;AAEnE,uDAAuD;AACvD,MAAM,MAAM,0BAA0B,GAAG,CAAC,WAAW,EAAE,cAAc,KAAK,UAAU,CAAC,OAAO,CAAC,CAAA;AAE7F,mEAAmE;AACnE,MAAM,WAAW,2CAA4C,SAAQ,WAAW;IAC9E,cAAc,EAAE,oBAAoB,CAAA;IACpC,oBAAoB,EAAE,0BAA0B,CAAA;CACjD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,oCAAoC,GAAG,CACjD,OAAO,EAAE,2CAA2C,EACpD,aAAa,EAAE,yBAAyB,KACrC,UAAU,CAAC,iCAAiC,EAAE,CAAC,CAAA"}

package/dist/neutral/modules/protocol-lib/validation/block/HydratedBlockValidationFunction.d.ts

@@ -0,0 +1,14 @@
+import type { Promisable } from '@ariestools/sdk';
+import type { BaseContext, ChainId, HydratedBlockWithHashMeta, XL1BlockNumber } from '../../../protocol-model/index.js';
+import type { HydratedBlockValidationError } from './error.js';
+/** Context for HydratedBlockValidationFunction operations. */
+export interface HydratedBlockValidationFunctionContext extends BaseContext {
+}
+/**
+ * A function that validates a hydrated block.
+ * @param hydratedBlock The hydrated block to validate.
+ * @param chainIdAtBlockNumber A function to get the chain ID at a specific block number.
+ * @returns An array of errors if the block is invalid, or an empty array if it is valid.
+ */
+export type HydratedBlockValidationFunction = (context: HydratedBlockValidationFunctionContext, hydratedBlock: HydratedBlockWithHashMeta, chainIdAtBlockNumber?: (blockNumber: XL1BlockNumber) => Promisable<ChainId>) => Promisable<HydratedBlockValidationError[]>;
+//# sourceMappingURL=HydratedBlockValidationFunction.d.ts.map

package/dist/neutral/modules/protocol-lib/validation/block/HydratedBlockValidationFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HydratedBlockValidationFunction.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/protocol-lib/validation/block/HydratedBlockValidationFunction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EACV,WAAW,EAAE,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAChE,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAA;AAE9D,8DAA8D;AAC9D,MAAM,WAAW,sCAAuC,SAAQ,WAAW;CAAG;AAE9E;;;;;GAKG;AACH,MAAM,MAAM,+BAA+B,GAAG,CAC5C,OAAO,EAAE,sCAAsC,EAC/C,aAAa,EAAE,yBAAyB,EACxC,oBAAoB,CAAC,EAAE,CAAC,WAAW,EAAE,cAAc,KAAK,UAAU,CAAC,OAAO,CAAC,KACxE,UAAU,CAAC,4BAA4B,EAAE,CAAC,CAAA"}