@xyo-network/chain-sdk 5.3.1 → 5.3.2

package/dist/neutral/modules/analyze/blockTime.d.ts

@@ -0,0 +1,92 @@
+import type { Hash, Promisable } from '@ariestools/sdk';
+import type { XyoAddress } from '@xyo-network/sdk';
+import type { HydratedBlock, SignedHydratedBlockWithHashMeta, TimePayload } from '@xyo-network/xl1-sdk';
+/**
+ * How far ahead of this observer's clock a candidate's signed epoch may sit before it is refused.
+ *
+ * Producers and finalizers keep their own clocks, and a candidate reaches the finalizer some time
+ * after it was signed, so a strict "not after now" would refuse honest blocks from any producer
+ * whose clock runs slightly ahead. The allowance is what keeps this a defense against far-future
+ * claims rather than a lockout for imperfect NTP.
+ */
+export declare const DEFAULT_MAX_CLOCK_SKEW_MS = 30000;
+/**
+ * How many EVM blocks past this observer's EVM head a candidate's anchor may sit before it is refused.
+ *
+ * Two nodes reading the tip through different RPC providers routinely disagree by a block for a
+ * few seconds, and that disagreement is about the observers, not the producer.
+ */
+export declare const DEFAULT_MAX_EVM_LEAD_BLOCKS = 2;
+/** The time rules, named so a rejection says which one a candidate failed. */
+export declare const BlockTimeRuleIds: readonly ["time-present", "epoch-after-parent", "epoch-not-future", "anchor-monotonic", "anchor-not-ahead"];
+/** One of the time rules. */
+export type BlockTimeRuleId = typeof BlockTimeRuleIds[number];
+/** What an observer knows about the present, resolved to numbers a rule can compare against. */
+export interface BlockTimeBounds {
+    /** The observer's EVM head; absent skips the anchor upper bound. */
+    evmHead?: number;
+    /** The observer's wall clock, in epoch milliseconds. */
+    now: number;
+}
+/** Tolerances the observer-relative rules apply. */
+export interface BlockTimeRuleOptions {
+    /** Defaults to {@link DEFAULT_MAX_CLOCK_SKEW_MS}. */
+    maxClockSkewMs?: number;
+    /** Defaults to {@link DEFAULT_MAX_EVM_LEAD_BLOCKS}. */
+    maxEvmLeadBlocks?: number;
+}
+/**
+ * How a head selector reaches the present: readers rather than values, because a selection pass
+ * resolves them once, lazily, and only when a candidate makes the corresponding claim.
+ */
+export interface BlockTimeRuleParams extends BlockTimeRuleOptions {
+    /** Reads the observer's EVM head; absent, or answering undefined, skips the anchor upper bound. */
+    evmHead?: () => Promisable<number | undefined>;
+    /** The observer's wall clock. Injectable for tests. */
+    now?: () => number;
+    /** Told once per distinct candidate a rule refused. */
+    onRejection?: (rejection: BlockTimeRejection) => void;
+}
+/** A candidate a time rule refused, with enough context to explain it. */
+export interface BlockTimeRejection {
+    /** The candidate's height. */
+    block: number;
+    /** What specifically was wrong. */
+    detail: string;
+    /** The candidate's hash. */
+    hash: Hash;
+    /** Who produced it. */
+    producer?: XyoAddress;
+    /** Which rule. */
+    rule: BlockTimeRuleId;
+}
+/** The signed time payload a block carries, when it has one. */
+export declare function timePayloadOfBlock(block: HydratedBlock): TimePayload | undefined;
+/**
+ * The epoch a block's signed time payload claims, in milliseconds.
+ *
+ * Deliberately no fallback to the unsigned `$epoch` meta (unlike `epochOfBlock` in xl1-sdk, which
+ * reads history): everything here gates on the answer, and a gate must not accept a claim the
+ * producer never signed.
+ */
+export declare function signedEpochOfBlock(block: HydratedBlock): number | undefined;
+/** The EVM height a block's signed time payload claims, when it claims one. */
+export declare function evmAnchorOfBlock(block: HydratedBlock): number | undefined;
+/**
+ * Checks a candidate's signed time claims against its parent and against the observer.
+ *
+ * Every rule reads the candidate's own signed time payload, the one statement about a block's
+ * timing its producer cannot alter after signing. The parent-relative rules are deterministic:
+ * two finalizers holding the same pair reach the same verdict whenever they ask. The
+ * observer-relative rules are not, and are tolerant on purpose. They exist to refuse claims no
+ * honest clock or EVM view could have produced, not to arbitrate between two nodes' slightly
+ * different ideas of the present. That is also why they belong in head selection rather than in
+ * protocol validation: whether a block is valid must not depend on who looked, or when.
+ * @param candidate The block under consideration
+ * @param parent The block it builds on, when known; absent skips the parent-relative rules
+ * @param bounds What the observer knows about the present
+ * @param options Tolerances for the observer-relative rules
+ * @returns The first rule the candidate failed, or undefined when every rule holds
+ */
+export declare function evaluateBlockTime(candidate: SignedHydratedBlockWithHashMeta, parent: HydratedBlock | undefined, bounds: BlockTimeBounds, options?: BlockTimeRuleOptions): BlockTimeRejection | undefined;
+//# sourceMappingURL=blockTime.d.ts.map

package/dist/neutral/modules/analyze/blockTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockTime.d.ts","sourceRoot":"","sources":["../../../../src/modules/analyze/blockTime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EACV,aAAa,EAAE,+BAA+B,EAAE,WAAW,EAC5D,MAAM,sBAAsB,CAAA;AAG7B;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,6GAEnB,CAAA;AAEV,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAA;AAE7D,gGAAgG;AAChG,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,uDAAuD;IACvD,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D,mGAAmG;IACnG,OAAO,CAAC,EAAE,MAAM,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC9C,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,uDAAuD;IACvD,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,kBAAkB,KAAK,IAAI,CAAA;CACtD;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,IAAI,EAAE,IAAI,CAAA;IACV,uBAAuB;IACvB,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB,kBAAkB;IAClB,IAAI,EAAE,eAAe,CAAA;CACtB;AAID,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,GAAG,SAAS,CAEhF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAE3E;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAEzE;AA6CD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,+BAA+B,EAC1C,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,oBAAyB,GACjC,kBAAkB,GAAG,SAAS,CAiBhC"}

package/dist/neutral/modules/analyze/index.d.ts

@@ -1,6 +1,7 @@
 export * from './admission.js';
 export * from './analyzeChain.js';
 export * from './BalanceAnalyzer/index.js';
+export * from './blockTime.js';
 export * from './ChainFinalizer.js';
 export * from './ChainHeadSelector.js';
 export * from './producer/index.js';

package/dist/neutral/modules/analyze/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/analyze/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/analyze/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,6BAA6B,CAAA"}

package/dist/neutral/modules/modules/diviners/index.d.ts

@@ -1,4 +1,3 @@
 export * from './BlockReward/index.js';
-export * from './BlockValidationDiviner.js';
 export * from './HeadValidationDiviner.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/modules/diviners/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/modules/diviners/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/modules/diviners/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,4BAA4B,CAAA"}

package/dist/neutral/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;AA6B/B,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAsErG"}
+{"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,CAuErG"}

package/dist/neutral/modules/protocol/block/createProducerChainStakeIntentTransaction.d.ts

@@ -1,7 +1,20 @@
 import type { Address } from '@ariestools/sdk';
 import type { AccountInstance } from '@xyo-network/sdk';
-import type { ChainId, ChainStakeIntent, HydratedTransactionWithHashMeta, XL1BlockNumber } from '@xyo-network/xl1-sdk';
-export declare function createProducerChainStakeIntent(from: Address, exp: number, nbf?: number): Promise<import("@xyo-network/sdk").WithHashMeta<ChainStakeIntent>>;
+import type { ChainId, HydratedTransactionWithHashMeta, XL1BlockNumber } from '@xyo-network/xl1-sdk';
+export declare function createProducerChainStakeIntent(from: Address, exp: number, nbf?: number): Promise<import("@xyo-network/sdk").WithHashMeta<{
+    schema: "network.xyo.chain.stake.intent" & {
+        readonly __schema: true;
+    };
+    exp: number;
+    from: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
+        readonly __hex: true;
+    } & {
+        readonly __address: true;
+    });
+    intent: "producer";
+    nbf: number;
+    $version?: number | undefined;
+}>>;
 export declare function createProducerChainStakeIntentTransaction(chain: ChainId, signers: AccountInstance[] | undefined, producer: Address, exp: XL1BlockNumber, nbf?: 0 & {
     readonly __blockNumber: true;
 } & {

package/dist/neutral/modules/protocol/block/createProducerChainStakeIntentTransaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createProducerChainStakeIntentTransaction.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol/block/createProducerChainStakeIntentTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,+BAA+B,EAC/B,cAAc,EACf,MAAM,sBAAsB,CAAA;AAM7B,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAI,sEAQvF;AAED,wBAAsB,yCAAyC,CAC7D,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EAAE,YAAK,EAC/B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,cAAc,EACnB,GAAG;;;;CAA4B,EAC/B,IAAI;;;;;CAAyB,GAC5B,OAAO,CAAC,+BAA+B,CAAC,CAc1C"}
+{"version":3,"file":"createProducerChainStakeIntentTransaction.d.ts","sourceRoot":"","sources":["../../../../../src/modules/protocol/block/createProducerChainStakeIntentTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,OAAO,KAAK,EACV,OAAO,EAEP,+BAA+B,EAC/B,cAAc,EACf,MAAM,sBAAsB,CAAA;AAM7B,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,SAAI;;;;;;;;;;;;;IAQvF;AAED,wBAAsB,yCAAyC,CAC7D,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,eAAe,EAAE,YAAK,EAC/B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,cAAc,EACnB,GAAG;;;;CAA4B,EAC/B,IAAI;;;;;CAAyB,GAC5B,OAAO,CAAC,+BAA+B,CAAC,CAc1C"}

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

@@ -1,7 +1,7 @@
 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';
+import type { AdmissionMode, AdmissionShadowReport, BlockTimeRuleParams, ProducerEligibilityEvaluator } from '../../analyze/index.js';
 interface ProcessPendingBlocksParams {
     /** How candidates are admitted; defaults to the allow-list the chain runs on today. */
     admission?: AdmissionMode;
@@ -29,8 +29,13 @@ interface ProcessPendingBlocksParams {
     observer?: AccountInstance;
     /** Where to publish what both admission gates concluded, in shadow posture. */
     publishAdmissionShadow?: (report: AdmissionShadowReport) => Promise<void>;
+    /**
+     * What this node knows about the present, against which every candidate's signed time claims
+     * are bounded by the head selector. Undefined disables the time rules.
+     */
+    timeRules?: BlockTimeRuleParams;
 }
-export declare function processPendingBlocks({ blockValidationViewer, blockViewer, context, logger, mempoolViewer, finalizationRunner, allowedProducers, backoffMs, heartbeatInterval, minCandidates, deadLetterQueueRunner, observer, admission, eligibility, publishAdmissionShadow, }: ProcessPendingBlocksParams): Promise<[{
+export declare function processPendingBlocks({ blockValidationViewer, blockViewer, context, logger, mempoolViewer, finalizationRunner, allowedProducers, backoffMs, heartbeatInterval, minCandidates, deadLetterQueueRunner, observer, admission, eligibility, publishAdmissionShadow, timeRules, }: ProcessPendingBlocksParams): Promise<[{
     schema: "network.xyo.boundwitness" & {
         readonly __schema: true;
     };
@@ -46,7 +51,6 @@ export declare function processPendingBlocks({ blockValidationViewer, blockViewe
     block: import("@xyo-network/xl1-sdk").XL1BlockNumber;
     chain: import("@ariestools/sdk").BrandedHex;
     previous: import("@ariestools/sdk").BrandedHash | null;
-    $epoch: number;
     _hash: import("@ariestools/sdk").BrandedHash;
     _dataHash: import("@ariestools/sdk").BrandedHash;
     $destination?: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
@@ -58,6 +62,7 @@ export declare function processPendingBlocks({ blockValidationViewer, blockViewe
     protocol?: number | undefined;
     step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
     supersedes?: import("@ariestools/sdk").BrandedHash | undefined;
+    $epoch?: number | undefined;
     $version?: 1000000 | undefined;
 }, {
     [x: string]: unknown;

package/dist/neutral/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;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;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,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,iBAAiB,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EACtL,SAAS,EAAE,WAAW,EAAE,sBAAsB,GAC/C,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA4E5B"}
+{"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,mBAAmB,EAAE,4BAA4B,EACxF,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;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,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;IACzE;;;OAGG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAA;CAChC;AAgCD,wBAAsB,oBAAoB,CAAC,EACzC,qBAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAE,qBAAqB,EAAE,QAAQ,EACtL,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE,SAAS,GAC1D,EAAE,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBA6E5B"}

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

@@ -75,6 +75,7 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
     private _blockValidationViewer?;
     private _chainParamsViewer?;
     private _finalizationViewer?;
+    private _headEpochCache?;
     private _lastRejectedBuildAt;
     /** Cache of the last candidate this runner signed; the mempool is the source of truth. */
     private _lastSignedCandidate?;
@@ -143,7 +144,6 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
         block: import("@xyo-network/xl1-sdk").XL1BlockNumber;
         chain: import("@ariestools/sdk").BrandedHex;
         previous: import("@ariestools/sdk").BrandedHash | null;
-        $epoch: number;
         _hash: import("@ariestools/sdk").BrandedHash;
         _dataHash: import("@ariestools/sdk").BrandedHash;
         $destination?: import("@xyo-network/sdk").XyoQuantAddress | (Lowercase<string> & {
@@ -155,6 +155,7 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
         protocol?: number | undefined;
         step_hashes?: import("@ariestools/sdk").BrandedHash[] | undefined;
         supersedes?: import("@ariestools/sdk").BrandedHash | undefined;
+        $epoch?: number | undefined;
         $version?: 1000000 | undefined;
     }, {
         [x: string]: unknown;
@@ -183,8 +184,26 @@ export declare class SimpleBlockRunner extends AbstractCreatableProvider<SimpleB
     private evictStaleExclusions;
     private filterByFunded;
     private generateTimePayload;
+    /**
+     * The head's signed epoch, read once per head.
+     *
+     * It comes from the head's own time payload, by way of the time sync viewer, rather than from the
+     * unsigned `$epoch` meta on the bound witness: the finalizer paces heartbeats by the signed
+     * epoch, and a producer pacing itself by anything else would drift from what qualifies. The
+     * viewer may be remote, and a head lasts many ticks, so the answer is cached until the head moves.
+     * A read failure is not cached — the next tick asks again — and reads as "no epoch", which errs
+     * toward heartbeating rather than toward silence.
+     * @param head The current head block
+     * @returns The head's signed epoch, or undefined when the head carries none or it could not be read
+     */
+    private headEpoch;
     /**
      * Check if a heartbeat block is required based on network activity.
+     *
+     * A head with no signed epoch — the genesis block, or a head that predates the time payload —
+     * cannot be aged, and the chain needs a block to establish its clock, so a heartbeat is due at
+     * once rather than never. The finalizer's pacing agrees: it only paces against a head that has
+     * a signed epoch.
      * @param head The current head block
      * @returns True if a heartbeat is required, false otherwise
      */

package/dist/neutral/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/neutral/modules/validation/block/validators/index.d.ts

@@ -1,6 +1,5 @@
 export * from './AllowedPayloadSchemas.js';
 export * from './BoundWitness.js';
 export * from './Fields.js';
-export * from './JsonSchema.js';
 export * from './PreviousHash.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/block/validators/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/block/validators/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}

package/dist/neutral/modules/validation/elevatedPayload/payloads/validateClaimInBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateClaimInBlock.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/elevatedPayload/payloads/validateClaimInBlock.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACwB,gCAAgC,EAEnE,MAAM,sBAAsB,CAAA;AAsH7B,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,EAAE,gCAsClC,CAAA"}
+{"version":3,"file":"validateClaimInBlock.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/validation/elevatedPayload/payloads/validateClaimInBlock.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACwB,gCAAgC,EAEnE,MAAM,sBAAsB,CAAA;AA2I7B,gGAAgG;AAChG,eAAO,MAAM,oBAAoB,EAAE,gCAqClC,CAAA"}

package/dist/neutral/modules/wrappers/block/HydratedBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HydratedBlock.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wrappers/block/HydratedBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,qBAAqB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,iBAAiB,EAEjG,MAAM,sBAAsB,CAAA;AAiB7B,qBAAa,oBAAoB,CAAC,CAAC,SAAS,yBAAyB,CAAE,YAAW,qBAAqB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACzJ,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAA;IACxD,SAAS,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAK;IAC7D,SAAS,CAAC,OAAO,EAAE,WAAW,CAAA;IAC9B,SAAS,CAAC,iBAAiB,EAAE,2BAA2B,EAAE,CAAK;IAC/D,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,eAAe,CAA0B;IAEjD,SAAS,aAAa,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW;IAKrG,IAAI,KAAK,kDAER;IAED,IAAI,YAAY,uBAEf;IAED,IAAI,KAAK,IAAI,GAAG,CAEf;IAED,IAAI,WAAW,YAEd;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAE7B;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,UAAU,IAAI,iBAAiB,EAAE,CAEpC;IAED,IAAI,UAAU,IAAI,IAAI,EAAE,CAEvB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,YAAY,IAAI,2BAA2B,EAAE,CAEhD;WAEY,KAAK,CAAC,CAAC,SAAS,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAKnH,OAAO,CAAC,KAAK,EAAE,MAAM;IAIrB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIvD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAI7D,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAI5B,aAAa,CAAC,QAAQ,EAAE;QAAE,cAAc,EAAE,oBAAoB,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;cAMzE,KAAK,CAAC,QAAQ,UAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAkB5H"}
+{"version":3,"file":"HydratedBlock.d.ts","sourceRoot":"","sources":["../../../../../src/modules/wrappers/block/HydratedBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,KAAK,EACV,oBAAoB,EACpB,WAAW,EACX,qBAAqB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,iBAAiB,EAEjG,MAAM,sBAAsB,CAAA;AAe7B,qBAAa,oBAAoB,CAAC,CAAC,SAAS,yBAAyB,CAAE,YAAW,qBAAqB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACzJ,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAA;IACxD,SAAS,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAK;IAC7D,SAAS,CAAC,OAAO,EAAE,WAAW,CAAA;IAC9B,SAAS,CAAC,iBAAiB,EAAE,2BAA2B,EAAE,CAAK;IAC/D,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,eAAe,CAA0B;IAEjD,SAAS,aAAa,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW;IAKrG,IAAI,KAAK,kDAER;IAED,IAAI,YAAY,uBAEf;IAED,IAAI,KAAK,IAAI,GAAG,CAEf;IAED,IAAI,WAAW,YAEd;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAE7B;IAED,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,UAAU,IAAI,iBAAiB,EAAE,CAEpC;IAED,IAAI,UAAU,IAAI,IAAI,EAAE,CAEvB;IAED,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,IAAI,YAAY,IAAI,2BAA2B,EAAE,CAEhD;WAEY,KAAK,CAAC,CAAC,SAAS,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAKnH,OAAO,CAAC,KAAK,EAAE,MAAM;IAIrB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIvD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAI7D,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAK5B,aAAa,CAAC,QAAQ,EAAE;QAAE,cAAc,EAAE,oBAAoB,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;cAOzE,KAAK,CAAC,QAAQ,UAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAkB5H"}

package/dist/neutral/modules.mjs

@@ -132,96 +132,23 @@ var countDecimalPlaces = (num) => {
   return decimalIndex === -1 ? 0 : numStr.length - decimalIndex - 1;
 };
 
-// src/modules/modules/diviners/BlockValidationDiviner.ts
+// src/modules/modules/diviners/HeadValidationDiviner.ts
 import {
   assertEx as assertEx2,
-  exists as exists2,
-  isString
+  isDefined as isDefined2,
+  toAddress
 } from "@ariestools/sdk";
 import {
   AbstractDiviner as AbstractDiviner2,
   asArchivistInstance,
   asSchema as asSchema4,
-  creatableModule as creatableModule2,
-  PayloadBuilder as PayloadBuilder2
-} from "@xyo-network/sdk";
-import { asBlockBoundWitness, hydrateBlock } from "@xyo-network/xl1-sdk";
-import { BlockJsonSchemaValidator, validateHydratedBlock } from "#validation";
-var BlockValidationDivinerConfigSchema = asSchema4("network.xyo.diviner.chain.block.validation.config", true);
-var BlockValidationDiviner = class extends AbstractDiviner2 {
-  _inArchivist;
-  _outArchivist;
-  get chainId() {
-    return assertEx2(this.config.chainId, () => "Missing chainId");
-  }
-  get context() {
-    return assertEx2(this.params.context, () => "Missing context");
-  }
-  async resolveInArchivist() {
-    const resolvedModule = assertEx2(
-      await this.resolve(assertEx2(this.config.inArchivist, () => "Missing inArchivist")),
-      () => `Unable to resolve inArchivist [${this.config.inArchivist}]`
-    );
-    const resolvedArchivist = assertEx2(asArchivistInstance(resolvedModule), () => "Invalid inArchivist resolved");
-    this._inArchivist = resolvedArchivist;
-    return this._inArchivist;
-  }
-  async resolveOutArchivist() {
-    const resolvedModule = assertEx2(
-      await this.resolve(assertEx2(this.config.outArchivist, () => "Missing outArchivist")),
-      () => `Unable to resolve outArchivist [${this.config.outArchivist}]`
-    );
-    const resolvedArchivist = assertEx2(asArchivistInstance(resolvedModule), () => "Invalid outArchivist resolved");
-    this._outArchivist = resolvedArchivist;
-    return this._outArchivist;
-  }
-  async divineHandler(payloads) {
-    const inArchivist = await this.resolveInArchivist();
-    const inMap = inArchivist;
-    const blocks = (payloads ?? []).map((b) => asBlockBoundWitness(b)).filter(exists2);
-    const validationResults = await Promise.all(blocks.map(async (block) => {
-      const blockHash = await PayloadBuilder2.hash(block);
-      const hydratedBlock = await hydrateBlock({
-        ...this.context,
-        chainMap: inMap,
-        caches: this.context.caches ?? {}
-      }, blockHash);
-      const validationErrors = await validateHydratedBlock(this.context, hydratedBlock, () => this.chainId, [], [BlockJsonSchemaValidator()]);
-      return validationErrors.length === 0 ? block : void 0;
-    }));
-    const results = validationResults.filter(exists2);
-    if (isString(this.config.outArchivist)) {
-      const outArchivist = await this.resolveOutArchivist();
-      if (results?.length > 0) {
-        await outArchivist.insert(results);
-      }
-    }
-    return results;
-  }
-};
-__publicField(BlockValidationDiviner, "configSchemas", [...__superGet(BlockValidationDiviner, BlockValidationDiviner, "configSchemas"), BlockValidationDivinerConfigSchema]);
-__publicField(BlockValidationDiviner, "targetSchema", BlockValidationDivinerConfigSchema);
-BlockValidationDiviner = __decorateClass([
-  creatableModule2()
-], BlockValidationDiviner);
-
-// src/modules/modules/diviners/HeadValidationDiviner.ts
-import {
-  assertEx as assertEx3,
-  isDefined as isDefined2,
-  toAddress
-} from "@ariestools/sdk";
-import {
-  AbstractDiviner as AbstractDiviner3,
-  asArchivistInstance as asArchivistInstance2,
-  asSchema as asSchema5,
-  creatableModule as creatableModule3
+  creatableModule as creatableModule2
 } from "@xyo-network/sdk";
 import { flattenHydratedBlock } from "@xyo-network/xl1-sdk";
 import { Mutex } from "async-mutex";
 import { ChainHeadSelector } from "#analyze";
-var HeadValidationDivinerConfigSchema = asSchema5("network.xyo.diviner.chain.head.validation.config", true);
-var HeadValidationDiviner = class extends AbstractDiviner3 {
+var HeadValidationDivinerConfigSchema = asSchema4("network.xyo.diviner.chain.head.validation.config", true);
+var HeadValidationDiviner = class extends AbstractDiviner2 {
   _context;
   _headValidationDivinerHeadUpdateTotal;
   _headSelector;
@@ -232,19 +159,19 @@ var HeadValidationDiviner = class extends AbstractDiviner3 {
     return this.params.allowedProducers ?? this.config.allowedProducers ?? [];
   }
   get blockViewer() {
-    return assertEx3(this.params.blockViewer, () => "Missing block viewer");
+    return assertEx2(this.params.blockViewer, () => "Missing block viewer");
   }
   get chainId() {
-    return assertEx3(this.params.chainId ?? this.config.chainId, () => "Missing chain information");
+    return assertEx2(this.params.chainId ?? this.config.chainId, () => "Missing chain information");
   }
   get context() {
     return this._context;
   }
   get headSelector() {
-    return assertEx3(this._headSelector, () => "Missing head selector");
+    return assertEx2(this._headSelector, () => "Missing head selector");
   }
   get mempoolViewer() {
-    return assertEx3(this.params.mempoolViewer, () => "Missing mempool viewer");
+    return assertEx2(this.params.mempoolViewer, () => "Missing mempool viewer");
   }
   async createHandler() {
     await super.createHandler();
@@ -263,11 +190,11 @@ var HeadValidationDiviner = class extends AbstractDiviner3 {
   }
   async resolveOutArchivist() {
     if (this._outArchivist) return this._outArchivist;
-    const resolvedModule = assertEx3(
-      await this.resolve(assertEx3(this.config.outArchivist, () => "Missing outArchivist")),
+    const resolvedModule = assertEx2(
+      await this.resolve(assertEx2(this.config.outArchivist, () => "Missing outArchivist")),
       () => `Unable to resolve outArchivist [${this.config.outArchivist}]`
     );
-    const resolvedArchivist = assertEx3(asArchivistInstance2(resolvedModule), () => "Invalid outArchivist resolved");
+    const resolvedArchivist = assertEx2(asArchivistInstance(resolvedModule), () => "Invalid outArchivist resolved");
     this._outArchivist = resolvedArchivist;
     return this._outArchivist;
   }
@@ -281,7 +208,7 @@ var HeadValidationDiviner = class extends AbstractDiviner3 {
           if (isDefined2(bestHeadChain)) {
             const outArchivist = await this.resolveOutArchivist();
             const oldHeadBlock = this._startingHead?.[0];
-            const newHydratedHeadBlock = assertEx3(bestHeadChain.at(-1), () => "Missing best head block [HeadValidationDiviner]");
+            const newHydratedHeadBlock = assertEx2(bestHeadChain.at(-1), () => "Missing best head block [HeadValidationDiviner]");
             const newHeadBlock = newHydratedHeadBlock[0];
             let finalizedBlocksAttributes = [];
             this.logger?.debug("Validating new HeadBlock head from (block) ", oldHeadBlock?.block, "to", newHeadBlock.block);
@@ -321,24 +248,24 @@ var HeadValidationDiviner = class extends AbstractDiviner3 {
 __publicField(HeadValidationDiviner, "configSchemas", [...__superGet(HeadValidationDiviner, HeadValidationDiviner, "configSchemas"), HeadValidationDivinerConfigSchema]);
 __publicField(HeadValidationDiviner, "targetSchema", HeadValidationDivinerConfigSchema);
 HeadValidationDiviner = __decorateClass([
-  creatableModule3()
+  creatableModule2()
 ], HeadValidationDiviner);
 
 // src/modules/modules/witnesses/ArchivistNextWitness.ts
-import { assertEx as assertEx4 } from "@ariestools/sdk";
+import { assertEx as assertEx3 } from "@ariestools/sdk";
 import {
   AbstractWitness,
-  asArchivistInstance as asArchivistInstance3,
-  asSchema as asSchema6
+  asArchivistInstance as asArchivistInstance2,
+  asSchema as asSchema5
 } from "@xyo-network/sdk";
-var ArchivistNextWitnessConfigSchema = asSchema6("network.xyo.witness.archivist.next.config", true);
+var ArchivistNextWitnessConfigSchema = asSchema5("network.xyo.witness.archivist.next.config", true);
 var ArchivistNextWitness = class extends AbstractWitness {
   static configSchemas = [...super.configSchemas, ArchivistNextWitnessConfigSchema];
   static defaultConfigSchema = ArchivistNextWitnessConfigSchema;
   _cursor;
   async getSourceArchivist() {
-    return assertEx4(asArchivistInstance3(
-      await this.resolve(assertEx4(this.config.sourceArchivist, () => "Missing sourceArchivist"))
+    return assertEx3(asArchivistInstance2(
+      await this.resolve(assertEx3(this.config.sourceArchivist, () => "Missing sourceArchivist"))
     ), () => "Invalid sourceArchivist");
   }
   async observeHandler() {
@@ -355,10 +282,10 @@ var ArchivistNextWitness = class extends AbstractWitness {
 // src/modules/modules/witnesses/NetworkStake/NetworkStake.ts
 import { AsObjectFactory as AsObjectFactory2 } from "@ariestools/sdk";
 import {
-  asSchema as asSchema7,
+  asSchema as asSchema6,
   isPayloadOfSchemaType as isPayloadOfSchemaType2
 } from "@xyo-network/sdk";
-var WeightedNetworkStakeSchema = asSchema7("network.xyo.witness.chain.stake.network.weighted", true);
+var WeightedNetworkStakeSchema = asSchema6("network.xyo.witness.chain.stake.network.weighted", true);
 var isWeightedNetworkStake = isPayloadOfSchemaType2(WeightedNetworkStakeSchema);
 var asWeightedNetworkStakePayload = AsObjectFactory2.create(isWeightedNetworkStake);
 var asWeightedNetworkStakePayloadWithStorageMeta = AsObjectFactory2.create(isWeightedNetworkStake);
@@ -366,10 +293,10 @@ var asWeightedNetworkStakePayloadWithStorageMeta = AsObjectFactory2.create(isWei
 // src/modules/modules/witnesses/NetworkStake/NetworkStakeObserve.ts
 import { AsObjectFactory as AsObjectFactory3 } from "@ariestools/sdk";
 import {
-  asSchema as asSchema8,
+  asSchema as asSchema7,
   isPayloadOfSchemaType as isPayloadOfSchemaType3
 } from "@xyo-network/sdk";
-var NetworkStakeObserveSchema = asSchema8("network.xyo.witness.chain.stake.network.observe", true);
+var NetworkStakeObserveSchema = asSchema7("network.xyo.witness.chain.stake.network.observe", true);
 var isNetworkStakeObserve = isPayloadOfSchemaType3(NetworkStakeObserveSchema);
 var asNetworkStakeObservePayload = AsObjectFactory3.create(isNetworkStakeObserve);
 var asNetworkStakeObservePayloadWithStorageMeta = AsObjectFactory3.create(isNetworkStakeObserve);
@@ -379,8 +306,6 @@ export {
   BlockRewardDiviner,
   BlockRewardDivinerConfigSchema,
   BlockRewardSchema,
-  BlockValidationDiviner,
-  BlockValidationDivinerConfigSchema,
   FixedPercentageBlockRewardDiviner,
   FixedPercentageBlockRewardDivinerConfigSchema,
   HeadValidationDiviner,