@xyo-network/chain-sdk 5.0.4 → 5.1.0

package/dist/node/modules/protocol/block/BuildBlockOptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BuildBlockOptions.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol/block/BuildBlockOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAKpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAChE,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,mBAAmB,EAAE,CAAA;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,mBAAmB,CAAC,EAAE,cAAc,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,GAAG,EAAE,yBAAyB,EAAE,CAAA;CACjC;AAED,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qBASjE,CAAA;AAED,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,iBAAiB,EAAE,IAAI,CAAA;CACxB;AAED,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,wBAYpE,CAAA;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,iBAAiB,EAAE,IAAI,CAAA;IACvB,mBAAmB,EAAE,cAAc,CAAA;IACnC,kBAAkB,EAAE,IAAI,EAAE,CAAA;IAC1B,qBAAqB,EAAE,OAAO,CAAA;CAC/B;AAED,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qBAejE,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,qBAAqB,CAAA"}
+{"version":3,"file":"BuildBlockOptions.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol/block/BuildBlockOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAKpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,EAChE,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,mBAAmB,EAAE,CAAA;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,mBAAmB,CAAC,EAAE,cAAc,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,GAAG,EAAE,yBAAyB,EAAE,CAAA;CACjC;AAED,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qBASjE,CAAA;AAED,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,iBAAiB,EAAE,IAAI,CAAA;CACxB;AAED,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,wBAYpE,CAAA;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAClE,iBAAiB,EAAE,IAAI,CAAA;IACvB,mBAAmB,EAAE,cAAc,CAAA;IACnC,kBAAkB,EAAE,IAAI,EAAE,CAAA;IAC1B,qBAAqB,EAAE,OAAO,CAAA;IAC9B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,IAAI,CAAA;CAClB;AAED,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qBAejE,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,qBAAqB,CAAA"}

package/dist/node/modules/protocol/block/buildBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildBlock.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol/block/buildBlock.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACS,+BAA+B,EACnD,MAAM,sBAAsB,CAAA;AAY7B,OAAO,EACL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAA;AAiB/B,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAiErG"}
+{"version":3,"file":"buildBlock.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol/block/buildBlock.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACS,+BAA+B,EACnD,MAAM,sBAAsB,CAAA;AAY7B,OAAO,EACL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAA;AA6B/B,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAsErG"}

package/dist/node/modules/protocol/block/buildNextBlock.d.ts

@@ -1,3 +1,4 @@
+import type { Hash } from '@ariestools/sdk';
 import type { AccountInstance, WithHashMeta } from '@xyo-network/sdk';
 import type { AllowedBlockPayload, BlockBoundWitness, ChainId, SignedHydratedBlockWithHashMeta, SignedHydratedTransaction } from '@xyo-network/xl1-sdk';
 import { AttoXL1 } from '@xyo-network/xl1-sdk';
@@ -5,5 +6,5 @@ export declare function buildNextBlock(previousBlock: WithHashMeta<BlockBoundWit
     readonly __hex: true;
 } & {
     readonly __address: true;
-}, stepRewardPoolBalance?: AttoXL1, protocol?: number, chainId?: ChainId): Promise<SignedHydratedBlockWithHashMeta>;
+}, stepRewardPoolBalance?: AttoXL1, protocol?: number, chainId?: ChainId, supersedes?: Hash): Promise<SignedHydratedBlockWithHashMeta>;
 //# sourceMappingURL=buildNextBlock.d.ts.map

package/dist/node/modules/protocol/block/buildNextBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildNextBlock.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol/block/buildNextBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,KAAK,EACV,mBAAmB,EAAE,iBAAiB,EACtC,OAAO,EACP,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,OAAO,EAER,MAAM,sBAAsB,CAAA;AAI7B,wBAAsB,cAAc,CAClC,aAAa,EAAE,YAAY,CAAC,iBAAiB,CAAC,EAC9C,GAAG,EAAE,yBAAyB,EAAE,EAChC,aAAa,EAAE,mBAAmB,EAAE,EACpC,OAAO,EAAE,eAAe,EAAE,EAC1B,sBAAsB;;;;CAA0B,EAChD,qBAAqB,GAAE,OAAqB,EAC5C,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,+BAA+B,CAAC,CAa1C"}
+{"version":3,"file":"buildNextBlock.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol/block/buildNextBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,KAAK,EACV,mBAAmB,EAAE,iBAAiB,EACtC,OAAO,EACP,+BAA+B,EAC/B,yBAAyB,EAC1B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,OAAO,EAER,MAAM,sBAAsB,CAAA;AAI7B,wBAAsB,cAAc,CAClC,aAAa,EAAE,YAAY,CAAC,iBAAiB,CAAC,EAC9C,GAAG,EAAE,yBAAyB,EAAE,EAChC,aAAa,EAAE,mBAAmB,EAAE,EACpC,OAAO,EAAE,eAAe,EAAE,EAC1B,sBAAsB;;;;CAA0B,EAChD,qBAAqB,GAAE,OAAqB,EAC5C,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,OAAO,EACjB,UAAU,CAAC,EAAE,IAAI,GAChB,OAAO,CAAC,+BAA+B,CAAC,CAc1C"}

package/dist/node/modules/services/implementation/processPendingBlocks.d.ts

@@ -1,13 +1,18 @@
 import type { Address, Logger } from '@ariestools/sdk';
 import type { AccountInstance } from '@xyo-network/sdk';
 import type { BaseContext, BlockValidationViewer, BlockViewer, DeadLetterQueueRunner, FinalizationRunner, MempoolViewer } from '@xyo-network/xl1-sdk';
+import type { AdmissionMode, AdmissionShadowReport, ProducerEligibilityEvaluator } from '../../analyze/index.js';
 interface ProcessPendingBlocksParams {
+    /** How candidates are admitted; defaults to the allow-list the chain runs on today. */
+    admission?: AdmissionMode;
     allowedProducers?: Address[];
     backoffMs?: number;
     blockValidationViewer: BlockValidationViewer;
     blockViewer: BlockViewer;
     context: BaseContext;
     deadLetterQueueRunner?: DeadLetterQueueRunner;
+    /** Computes producer standing, for the shadow and enforce postures. */
+    eligibility?: ProducerEligibilityEvaluator;
     finalizationRunner: FinalizationRunner;
     logger?: Logger;
     mempoolViewer: MempoolViewer;
@@ -17,8 +22,10 @@ interface ProcessPendingBlocksParams {
      * carry its signature, which is what makes them attributable evidence rather than a local note.
      */
     observer?: AccountInstance;
+    /** Where to publish what both admission gates concluded, in shadow posture. */
+    publishAdmissionShadow?: (report: AdmissionShadowReport) => Promise<void>;
 }
-export declare function processPendingBlocks({ blockValidationViewer, blockViewer, context, logger, mempoolViewer, finalizationRunner, allowedProducers, backoffMs, minCandidates, deadLetterQueueRunner, observer, }: ProcessPendingBlocksParams): Promise<[{
+export declare function processPendingBlocks({ blockValidationViewer, blockViewer, context, logger, mempoolViewer, finalizationRunner, allowedProducers, backoffMs, minCandidates, deadLetterQueueRunner, observer, admission, eligibility, publishAdmissionShadow, }: ProcessPendingBlocksParams): Promise<[{
     schema: "network.xyo.boundwitness" & {
         readonly __schema: true;
     };
@@ -45,6 +52,7 @@ export declare function processPendingBlocks({ blockValidationViewer, blockViewe
     $sourceQuery?: import("@ariestools/sdk").BrandedHash | undefined;
     protocol?: number | undefined;
     step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
+    supersedes?: import("@ariestools/sdk").BrandedHash | undefined;
 }, {
     [x: string]: unknown;
     schema: import("@xyo-network/sdk").BrandedSchema<string>;

package/dist/node/modules/services/implementation/processPendingBlocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processPendingBlocks.d.ts","sourceRoot":"","sources":["../../../../../src/modules/services/implementation/processPendingBlocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,kBAAkB,EAA6B,aAAa,EACrI,MAAM,sBAAsB,CAAA;AAS7B,UAAU,0BAA0B;IAClC,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,WAAW,CAAA;IACpB,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B;AAgCD,wBAAsB,oBAAoB,CAAC,EACzC,qBAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,GACpK,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAiE5B"}
+{"version":3,"file":"processPendingBlocks.d.ts","sourceRoot":"","sources":["../../../../../src/modules/services/implementation/processPendingBlocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EACV,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAAE,kBAAkB,EAA6B,aAAa,EACrI,MAAM,sBAAsB,CAAA;AAK7B,OAAO,KAAK,EACV,aAAa,EAAE,qBAAqB,EAAE,4BAA4B,EACnE,MAAM,UAAU,CAAA;AAKjB,UAAU,0BAA0B;IAClC,uFAAuF;IACvF,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,WAAW,CAAA;IACpB,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,uEAAuE;IACvE,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1E;AAgCD,wBAAsB,oBAAoB,CAAC,EACzC,qBAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EACnK,SAAS,EAAE,WAAW,EAAE,sBAAsB,GAC/C,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA2E5B"}

package/dist/node/modules/services/simple/block/runner/SimpleBlockRunner.d.ts

@@ -37,7 +37,7 @@ export interface SimpleBlockRunnerParams extends CreatableProviderParams {
 export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleBlockRunnerParams> implements BlockRunner {
     static readonly connectionTypes: readonly ["lmdb", "mongo", "memory"];
     static readonly defaultMoniker: "BlockRunner";
-    static readonly dependencies: ("MempoolViewer" | "BlockRewardViewer" | "AccountBalanceViewer" | "BlockValidationViewer" | "FinalizationViewer" | "TimeSyncViewer")[];
+    static readonly dependencies: ("AccountBalanceViewer" | "MempoolViewer" | "BlockRewardViewer" | "BlockValidationViewer" | "FinalizationViewer" | "TimeSyncViewer")[];
     static readonly monikers: "BlockRunner"[];
     static readonly surface: "node";
     moniker: "BlockRunner";
@@ -51,7 +51,10 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
     private _address?;
     private _blockRewardViewer?;
     private _blockValidationViewer?;
+    private _chainParamsViewer?;
     private _finalizationViewer?;
+    /** Cache of the last candidate this runner signed; the mempool is the source of truth. */
+    private _lastSignedCandidate?;
     private _mempoolViewer?;
     private _rewardAddress?;
     private _timeSyncViewer?;
@@ -127,6 +130,7 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
         $sourceQuery?: import("@ariestools/sdk").BrandedHash | undefined;
         protocol?: number | undefined;
         step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
+        supersedes?: import("@ariestools/sdk").BrandedHash | undefined;
     }, {
         [x: string]: unknown;
         schema: import("@xyo-network/sdk").BrandedSchema<string>;
@@ -152,8 +156,37 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
      * @returns True if a heartbeat is required, false otherwise
      */
     private heartbeatRequired;
+    /**
+     * The hash of this producer's own earlier candidate at the same height and parent, if any.
+     *
+     * The parent is part of the match on purpose. Two candidates at one height built on different
+     * parents are not a re-proposal, they are different branches, and linking across them would
+     * assert a supersession that never happened.
+     *
+     * Memory is only a cache. A restart wipes it while the pool still holds the prior candidate, so
+     * the pool is consulted whenever memory misses. Following the chain to its tip keeps a third
+     * proposal pointing at the second rather than back at the first.
+     * @param block The height being proposed
+     * @param previous The parent this proposal builds on
+     * @returns The prior candidate's signed data hash, or undefined when there is none
+     */
+    private previousOwnCandidateHash;
     private rejectExhaustedBlock;
     private rejectWrongChainTransactions;
+    /**
+     * The candidate this proposal supersedes, or undefined when nothing should be stamped.
+     *
+     * Identity is the signed data hash rather than the storage hash, because that is what an
+     * observer recomputes when deciding whether two candidates are the same block — client meta
+     * such as `$epoch` must not be able to make one candidate look like two.
+     *
+     * With no register wired, or with the field unactivated, this never stamps. That is what keeps
+     * a producer running this build emission-identical to one running the release before it, which
+     * the rollout depends on: stamping before the fleet has upgraded would partition validation.
+     * @param head The block being built on
+     * @returns The superseded candidate's hash, or undefined
+     */
+    private resolveSupersedes;
     private runBuildValidateRetryLoop;
 }
 //# sourceMappingURL=SimpleBlockRunner.d.ts.map

package/dist/node/modules/services/simple/block/runner/SimpleBlockRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SimpleBlockRunner.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/services/simple/block/runner/SimpleBlockRunner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SimpleBlockRunner.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/services/simple/block/runner/SimpleBlockRunner.ts"],"names":[],"mappings":"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"}

package/dist/node/modules/services/simple/block/runner/index.d.ts

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

package/dist/node/modules/services/simple/block/runner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/services/simple/block/runner/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/services/simple/block/runner/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA"}

package/dist/node/modules/services/simple/block/runner/selectSupersededCandidate.d.ts

@@ -0,0 +1,22 @@
+import type { Hash } from '@ariestools/sdk';
+import type { WithHashMeta, XyoAddress } from '@xyo-network/sdk';
+import type { BlockBoundWitness } from '@xyo-network/xl1-sdk';
+/**
+ * Which of a producer's own pending candidates a new proposal at this height supersedes.
+ *
+ * Matching on the parent as well as the height is the guard that matters. Two candidates at one
+ * height built on different parents are not a re-proposal, they are competing branches, and
+ * stamping a link across them would assert a supersession that never happened — turning an
+ * honest producer's block into evidence against it.
+ *
+ * When several of its own candidates are already in the pool, the tip of the supersedes chain is
+ * the one to point at: the tip is the candidate nothing else has replaced, so a third proposal
+ * links to the second rather than reaching back past it and leaving the second orphaned.
+ * @param candidates Pending candidates visible to this producer
+ * @param address The producer's own signing address
+ * @param block The height being proposed
+ * @param previous The parent this proposal builds on
+ * @returns The signed data hash to supersede, or undefined when there is nothing to link
+ */
+export declare function selectSupersededCandidate(candidates: WithHashMeta<BlockBoundWitness>[], address: XyoAddress, block: number, previous: Hash): Hash | undefined;
+//# sourceMappingURL=selectSupersededCandidate.d.ts.map

package/dist/node/modules/services/simple/block/runner/selectSupersededCandidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectSupersededCandidate.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/services/simple/block/runner/selectSupersededCandidate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,YAAY,CAAC,iBAAiB,CAAC,EAAE,EAC7C,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,IAAI,GACb,IAAI,GAAG,SAAS,CAOlB"}

package/dist/node/modules/slashing/detect/DetectedOffense.d.ts

@@ -0,0 +1,27 @@
+import type { Payload } from '@xyo-network/sdk';
+import type { OffenseCode } from '@xyo-network/xl1-sdk';
+import type { OffenseKey } from '../model/offenseKey.js';
+import type { OffenseVerdict } from '../model/VerificationOutcome.js';
+/**
+ * Conduct a watcher found and then verified.
+ *
+ * Carries the verdict rather than a bare flag, because the transcript is what makes the detection
+ * worth anything: it is the same record an arbiter would publish, so an operator watching in
+ * telemetry mode can see exactly what a report would have said before any are ever filed.
+ */
+export interface DetectedOffense {
+    /**
+     * The artifacts the verdict rests on.
+     *
+     * Carried because a report has to supply them: a reporter that named hashes without producing
+     * the objects would be asking everyone else to take its word for it.
+     */
+    artifacts: Payload[];
+    /** What the offense is filed under. */
+    key: OffenseKey;
+    /** Which class. */
+    offense: OffenseCode;
+    /** What verification concluded, with its transcript. */
+    verdict: OffenseVerdict;
+}
+//# sourceMappingURL=DetectedOffense.d.ts.map

package/dist/node/modules/slashing/detect/DetectedOffense.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectedOffense.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/detect/DetectedOffense.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,SAAS,EAAE,OAAO,EAAE,CAAA;IACpB,uCAAuC;IACvC,GAAG,EAAE,UAAU,CAAA;IACf,mBAAmB;IACnB,OAAO,EAAE,WAAW,CAAA;IACpB,wDAAwD;IACxD,OAAO,EAAE,cAAc,CAAA;CACxB"}

package/dist/node/modules/slashing/detect/candidatePairs.d.ts

@@ -0,0 +1,44 @@
+import type { Hash } from '@ariestools/sdk';
+import type { XyoAddress } from '@xyo-network/sdk';
+/** One candidate a watcher saw a producer sign, reduced to what deciding equivocation needs. */
+export interface CandidateSighting {
+    /** Height the candidate claims. */
+    block: number;
+    /** Recomputed signed identity — never the storage hash, which client meta can move. */
+    dataHash: Hash;
+    /** Parent the candidate builds on. */
+    previous: Hash | null;
+    /** Address that signed it. */
+    producer: XyoAddress;
+    /** The candidate this one declares it replaces, when it declares one. */
+    supersedes?: Hash;
+}
+/** Two candidates from one producer that compete for the same slot. */
+export interface CandidatePair {
+    /** Height they compete at. */
+    block: number;
+    /** The earlier sighting. */
+    first: CandidateSighting;
+    /** Who signed both. */
+    producer: XyoAddress;
+    /** The later sighting. */
+    second: CandidateSighting;
+}
+/**
+ * Finds candidate pairs that look like equivocation among what a watcher has seen.
+ *
+ * This is detection, not judgment. It answers which pairs are worth verifying, and a pair reaching
+ * this list is not yet an accusation — the verification procedure decides that, and it re-derives
+ * everything from the artifacts rather than trusting anything here.
+ *
+ * A declared link clears the pair immediately, so an honest producer's re-proposal never enters
+ * the pipeline at all. Doing that here rather than later matters: a watcher that queued every
+ * re-proposal for verification would spend its budget on producers doing exactly what they should.
+ *
+ * Sightings are compared by recomputed identity, so a candidate seen twice through different paths
+ * collapses to one rather than becoming a pair with itself.
+ * @param sightings Candidates the watcher has observed
+ * @returns Pairs worth verifying, one per competing combination
+ */
+export declare function findCandidatePairs(sightings: readonly CandidateSighting[]): CandidatePair[];
+//# sourceMappingURL=candidatePairs.d.ts.map

package/dist/node/modules/slashing/detect/candidatePairs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidatePairs.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/detect/candidatePairs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,uFAAuF;IACvF,QAAQ,EAAE,IAAI,CAAA;IACd,sCAAsC;IACtC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAA;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,UAAU,CAAA;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,IAAI,CAAA;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,KAAK,EAAE,iBAAiB,CAAA;IACxB,uBAAuB;IACvB,QAAQ,EAAE,UAAU,CAAA;IACpB,0BAA0B;IAC1B,MAAM,EAAE,iBAAiB,CAAA;CAC1B;AAaD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,GAAG,aAAa,EAAE,CAqB3F"}

package/dist/node/modules/slashing/detect/index.d.ts

@@ -0,0 +1,5 @@
+export * from './candidatePairs.js';
+export * from './DetectedOffense.js';
+export * from './offenseGate.js';
+export * from './suppression.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/slashing/detect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/detect/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA"}

package/dist/node/modules/slashing/detect/offenseGate.d.ts

@@ -0,0 +1,18 @@
+import type { ChainParams, OffenseCode } from '@xyo-network/xl1-sdk';
+/**
+ * Whether a watcher may treat conduct at a height as a reportable offense.
+ *
+ * Two gates, and the second one only applies to equivocation. A producer cannot declare that one
+ * candidate replaces another until the field that says so is active, so before that activation
+ * every honest re-proposal is indistinguishable from equivocation. Reporting the class then would
+ * accuse operators of an offense the protocol gave them no way to avoid.
+ *
+ * That conjunction is fixed here rather than left to configuration. An operator who could switch
+ * it off would be arming their node to file accusations the chain cannot sustain.
+ * @param params The register version covering the offense height
+ * @param offense The offense class being considered
+ * @param height The XL1 height the conduct occurred at
+ * @returns True when reports naming this class at this height may be recorded
+ */
+export declare function isOffenseWatchable(params: ChainParams, offense: OffenseCode, height: number): boolean;
+//# sourceMappingURL=offenseGate.d.ts.map

package/dist/node/modules/slashing/detect/offenseGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offenseGate.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/detect/offenseGate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGpE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAGrG"}

package/dist/node/modules/slashing/detect/suppression.d.ts

@@ -0,0 +1,23 @@
+import type { OffenseKey } from '../model/offenseKey.js';
+import type { SlashHistoryReader } from '../model/SlashHistoryReader.js';
+/** Why a watcher should not file a report it would otherwise have filed. */
+export type SuppressionReason = 'adjudicated' | 'already-reported';
+/**
+ * Whether an offense a watcher has detected is already spoken for.
+ *
+ * Duplicate detection is normal — every validator watching the same chain sees the same
+ * misconduct — so the interesting question is not whether to detect it but whether to add another
+ * report of it.
+ *
+ * A settled offense is the stronger case. Filing against something already adjudicated is not
+ * merely redundant: an adjudicated offense cannot be re-litigated, so the new report is itself
+ * invalid and exposes its filer to a counter-slash. A watcher must never walk into that.
+ *
+ * An existing unsettled report is only redundant. Nothing is lost by staying quiet — the offense
+ * is already on the record and the bounty already claimed by whoever got there first.
+ * @param history Finalized slash traffic as this watcher can see it
+ * @param key The offense being considered
+ * @returns Why to stay quiet, or undefined when the report is worth filing
+ */
+export declare function suppressionFor(history: SlashHistoryReader, key: OffenseKey): Promise<SuppressionReason | undefined>;
+//# sourceMappingURL=suppression.d.ts.map

package/dist/node/modules/slashing/detect/suppression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suppression.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/detect/suppression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAExE,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,kBAAkB,CAAA;AAElE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAGxC"}

package/dist/node/modules/slashing/eligibility/evaluateProducerEligibility.d.ts

@@ -0,0 +1,71 @@
+import type { Promisable } from '@ariestools/sdk';
+import type { XyoAddress } from '@xyo-network/sdk';
+import type { ChainParams, StakeSnapshotViewerMethods } from '@xyo-network/xl1-sdk';
+/**
+ * Whether an address has a current declaration to produce, as of a height.
+ *
+ * `undefined` means the question could not be answered — no intent reader is wired — which is
+ * different from `false` (the reader looked and found nothing current). Collapsing the two would
+ * turn a missing reader into either a free pass or an accusation, depending on the direction.
+ */
+export type HasValidIntent = (address: XyoAddress, height: number) => Promisable<boolean | undefined>;
+/** What the participation predicate needs about a candidate block. */
+export interface EligibilityInput {
+    /** The producer being evaluated. */
+    accused: XyoAddress;
+    /** EVM anchor carried by the candidate itself. */
+    blockAnchor?: number;
+    /** The candidate's XL1 height, where intent windows are judged. */
+    height: number;
+    /** Whether the address has a current production declaration. */
+    intent: HasValidIntent;
+    /** The register version in force. */
+    params: ChainParams;
+    /** EVM anchor carried by the candidate's parent. */
+    parentAnchor?: number;
+    /** Stake as it stood at an EVM height. */
+    snapshot?: StakeSnapshotViewerMethods;
+}
+/** What evaluating participation concluded, including the numbers it concluded it from. */
+export interface EligibilityEvaluation {
+    /** Seasoned active stake measured at the evaluation point. */
+    activeStake?: bigint;
+    /** The EVM height stake was measured at. */
+    eStar?: number;
+    /** Whether the address may produce, when that could be established. */
+    eligible?: boolean;
+    /** Whether the address has a current declaration. */
+    intentValid?: boolean;
+    /** Why not, when it is not. */
+    reason?: string;
+    /** False when the inputs to the predicate could not be resolved at all. */
+    resolvable: boolean;
+    /** The seasoned portion staked on itself. */
+    selfBond?: bigint;
+}
+/**
+ * The one place participation is decided.
+ *
+ * Admission and after-the-fact verification call this same function, and that is the point. If
+ * the finalizer's idea of who may produce and the offense procedure's idea ever diverged, a block
+ * could be admitted by the network and simultaneously constitute an offense by its producer — so
+ * there is exactly one implementation and both callers take it.
+ *
+ * The measurement point comes from the two blocks' own signed anchors rather than any live view,
+ * so the answer does not depend on when it is asked. A block admissible when it was produced must
+ * still evaluate as admissible a week later.
+ *
+ * Stake is counted seasoned: a position participates only once it has sat at risk for the
+ * register's minimum age, so production rights cannot be flash-acquired the block before the
+ * measurement point. The unaged total is measured beside it purely so the report can tell an
+ * entrant waiting out seasoning apart from an operator short of capital.
+ *
+ * The tri-state matters as much as the verdict. `resolvable: false` means the question could not
+ * be put — no snapshot, no anchors, no intent reader — which admission treats as "do not gate"
+ * and verification treats as inconclusive. Collapsing it into ineligible would turn a missing
+ * reader into an accusation.
+ * @param input The candidate, the register, and the readers to consult
+ * @returns The verdict with the measurements behind it
+ */
+export declare function evaluateProducerEligibility(input: EligibilityInput): Promise<EligibilityEvaluation>;
+//# sourceMappingURL=evaluateProducerEligibility.d.ts.map

package/dist/node/modules/slashing/eligibility/evaluateProducerEligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateProducerEligibility.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/eligibility/evaluateProducerEligibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AAGnF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;AAErG,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,OAAO,EAAE,UAAU,CAAA;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAA;IACd,gEAAgE;IAChE,MAAM,EAAE,cAAc,CAAA;IACtB,qCAAqC;IACrC,MAAM,EAAE,WAAW,CAAA;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,0BAA0B,CAAA;CACtC;AAED,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAA;IACnB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA6CzG"}

package/dist/node/modules/slashing/eligibility/index.d.ts

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

package/dist/node/modules/slashing/eligibility/index.d.ts.map

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

package/dist/node/modules/slashing/index/SlashIndexStore.d.ts

@@ -0,0 +1,22 @@
+import type { JsonObject, Promisable } from '@ariestools/sdk';
+/** Moniker the slash index's store resolves under. */
+export declare const SlashIndexStoreMoniker = "SlashIndexStore";
+/**
+ * The object store the slash index is written to.
+ *
+ * Named apart from any S3 base class on purpose: the pass that decides *what* to write is pure
+ * and tested on its own, and this is the whole of what it needs from the world. Keeping the two
+ * separate is what makes the crash-safety argument checkable — the part with the reasoning has no
+ * I/O, and the part with I/O has no reasoning.
+ */
+export interface SlashIndexStore {
+    /** Whether an object already exists, so immutable writes can be skipped. */
+    hasObject(path: string): Promisable<boolean>;
+    /** Reads a published object, or undefined when it is not there. */
+    readObject(path: string): Promisable<unknown>;
+    /** Writes an object. */
+    writeObject(path: string, value: JsonObject, immutable: boolean): Promisable<void>;
+}
+/** Whether a resolved provider can actually serve as the index store. */
+export declare function isSlashIndexStore(value: unknown): value is SlashIndexStore;
+//# sourceMappingURL=SlashIndexStore.d.ts.map

package/dist/node/modules/slashing/index/SlashIndexStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlashIndexStore.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/index/SlashIndexStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE7D,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IAC5C,mEAAmE;IACnE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IAC7C,wBAAwB;IACxB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;CACnF;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAK1E"}

package/dist/node/modules/slashing/index/foldSlashIndex.d.ts

@@ -0,0 +1,56 @@
+import type { Hash, JsonObject } from '@ariestools/sdk';
+import type { SignedHydratedBlockWithHashMeta, SlashIndexKeyRecord } from '@xyo-network/xl1-sdk';
+/** One object to write, and whether it may ever be rewritten. */
+export interface SlashIndexWrite {
+    /** True when the object is content-addressed and must never change once written. */
+    immutable: boolean;
+    /** Where it goes. */
+    path: string;
+    /** What goes there. */
+    value: JsonObject;
+}
+/** Everything one batch of finalized blocks contributes to the index. */
+export interface SlashIndexDelta {
+    /** Producer aggregates: path to the offense keys seen for that producer. */
+    accused: Map<string, string[]>;
+    /** Per-offense aggregates, keyed by their path. */
+    keys: Map<string, SlashIndexKeyRecord>;
+    /**
+     * Adjudications and challenges whose report was not in this batch.
+     *
+     * Their offense cannot be resolved from the blocks alone — the report that names it is further
+     * back — so the writing pass resolves them against the published request records.
+     */
+    pending: {
+        hash: Hash;
+        kind: 'adjudication' | 'challenge';
+        request: Hash;
+    }[];
+    /** Content-addressed records, safe to skip when already present. */
+    records: SlashIndexWrite[];
+}
+/**
+ * Folds finalized blocks into everything the index should gain from them.
+ *
+ * Pure, and deliberately so: the pass that writes has to be safe to re-run after a crash, and the
+ * cheapest way to be sure of that is for the decision of *what* to write to depend on nothing but
+ * the blocks. Run it twice over the same range and it produces the same delta.
+ *
+ * Aggregates are keyed by canonical offense identity, so several validators reporting the same
+ * misconduct converge on one record instead of accumulating as separate accusations.
+ * @param blocks Finalized blocks to fold, in ascending height order
+ * @returns The records and aggregate contributions from those blocks
+ */
+export declare function foldSlashIndex(blocks: SignedHydratedBlockWithHashMeta[]): SlashIndexDelta;
+/**
+ * Merges an aggregate contribution into whatever is already published.
+ *
+ * Every field either appends or is set once. That is what lets a crashed pass simply rescan: a
+ * second fold over the same blocks adds nothing it did not already add, and a fold over new blocks
+ * never erases what an earlier one recorded.
+ * @param existing The published aggregate, when there is one
+ * @param next The contribution from this pass
+ * @returns The aggregate to publish
+ */
+export declare function mergeKeyRecord(existing: SlashIndexKeyRecord | undefined, next: SlashIndexKeyRecord): SlashIndexKeyRecord;
+//# sourceMappingURL=foldSlashIndex.d.ts.map

package/dist/node/modules/slashing/index/foldSlashIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foldSlashIndex.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/index/foldSlashIndex.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,KAAK,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAShG,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,SAAS,EAAE,OAAO,CAAA;IAClB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,KAAK,EAAE,UAAU,CAAA;CAClB;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAC9B,mDAAmD;IACnD,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;IACtC;;;;;OAKG;IACH,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,EAAE,CAAA;IAC5E,oEAAoE;IACpE,OAAO,EAAE,eAAe,EAAE,CAAA;CAC3B;AAWD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,+BAA+B,EAAE,GAAG,eAAe,CAOzF;AA+ED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,mBAAmB,GAAG,SAAS,EACzC,IAAI,EAAE,mBAAmB,GACxB,mBAAmB,CAYrB"}

package/dist/node/modules/slashing/index/index.d.ts

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

package/dist/node/modules/slashing/index/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/index/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA"}

package/dist/node/modules/slashing/index.d.ts

@@ -0,0 +1,6 @@
+export * from './detect/index.js';
+export * from './eligibility/index.js';
+export * from './index/index.js';
+export * from './model/index.js';
+export * from './verify/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/slashing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/slashing/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA"}

package/dist/node/modules/slashing/model/OffenseProcedure.d.ts

@@ -0,0 +1,28 @@
+import type { Hash } from '@ariestools/sdk';
+import type { Payload } from '@xyo-network/sdk';
+import type { SlashRequest } from '@xyo-network/xl1-sdk';
+import type { OffenseVerificationContext } from './OffenseVerificationContext.js';
+import type { OffenseVerdict } from './VerificationOutcome.js';
+/** An artifact that survived re-hashing and signature checking. */
+export interface VerifiedArtifact {
+    /** The recomputed data hash, which is the artifact's identity. */
+    dataHash: Hash;
+    /** The artifact itself. */
+    payload: Payload;
+    /**
+     * The recomputed meta-inclusive hash, when the preamble computed it.
+     *
+     * Signed references — a block's `previous`, a carrier's payload list — may point at either
+     * form, and both are recomputed from the artifact itself so a reference match never rests on
+     * a hash the supplier merely claimed.
+     */
+    storageHash?: Hash;
+}
+/**
+ * One offense class's verification procedure.
+ *
+ * Procedures receive artifacts already re-hashed and signature-checked, so each one reasons about
+ * what the evidence means rather than re-deriving whose it is.
+ */
+export type OffenseProcedure = (ctx: OffenseVerificationContext, request: SlashRequest, artifacts: ReadonlyMap<Hash, VerifiedArtifact>) => Promise<OffenseVerdict>;
+//# sourceMappingURL=OffenseProcedure.d.ts.map

package/dist/node/modules/slashing/model/OffenseProcedure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OffenseProcedure.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slashing/model/OffenseProcedure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,QAAQ,EAAE,IAAI,CAAA;IACd,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,IAAI,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,0BAA0B,EAC/B,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAC3C,OAAO,CAAC,cAAc,CAAC,CAAA"}