@xyo-network/xl1-protocol-sdk 1.18.0-rc.1 → 1.18.0

package/dist/neutral/viewers/AccountBalance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AccountBalance.d.ts","sourceRoot":"","sources":["../../../src/viewers/AccountBalance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAAE,IAAI,EAAE,UAAU,EAC1B,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,aAAa,EACnB,MAAM,2BAA2B,CAAA;AAElC,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACV,MAAM,mBAAmB,CAAA;AAE1B,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAIvC,CAAA;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEpF,MAAM,WAAW,2BAA2B;IAC1C,gCAAgC,CAC9B,OAAO,EAAE,OAAO,EAAE,EAClB,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GACjC,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAC,CAAA;IACtE,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAClI;AAED,MAAM,WAAW,oBAAqB,SAAQ,2BAA2B,EAAE,QAAQ,CAAC,2BAA2B,CAAC;IAC9G,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACzF,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAA;IACzI,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,yBAAyB,EAAE,CAAC,CAAA;IACpH,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;CAC9G;AAED,eAAO,MAAM,2BAA2B,EAAG,sBAA+B,CAAA;AAC1E,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAA"}
+{"version":3,"file":"AccountBalance.d.ts","sourceRoot":"","sources":["../../../src/viewers/AccountBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAG9D,OAAO,EACL,KAAK,OAAO,EAEb,MAAM,2BAA2B,CAAA;AAElC,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAA;AAE1B,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAIvC,CAAA;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEpF,eAAO,MAAM,8BAA8B;;;mBAAwB,CAAA;AACnE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACxF,eAAO,MAAM,6BAA6B;;;CAA+C,CAAA;AAEzF,eAAO,MAAM,uBAAuB;;;;uDAA0B,CAAA;AAC9D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAC1E,eAAO,MAAM,sBAAsB;;;;0BAAwC,CAAA;AAE3E,MAAM,WAAW,2BAA2B;IAC1C,gCAAgC,CAC9B,OAAO,EAAE,OAAO,EAAE,EAClB,MAAM,EAAE,oBAAoB,GAC3B,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3E,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,oBAAoB,GAAG,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACjI;AAED,MAAM,WAAW,oBAAqB,SAAQ,2BAA2B,EAAE,QAAQ,CAAC,2BAA2B,CAAC;IAC9G,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACpF,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,yBAAyB,EAAE,CAAC,CAAC,CAAA;IACpI,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC,yBAAyB,EAAE,CAAC,CAAA;IAC/G,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;CACzG;AAED,eAAO,MAAM,2BAA2B,EAAG,sBAA+B,CAAA;AAC1E,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAA"}

package/dist/neutral/viewers/BlockValidation.d.ts

@@ -0,0 +1,54 @@
+import { type Promisable } from '@xylabs/sdk-js';
+import type { HydratedBlock, SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol';
+import z from 'zod';
+import { type Provider } from '../model/index.ts';
+import type { HydratedBlockValidationError } from '../validation/index.ts';
+export declare const BlockValidationQualificationZod: z.ZodObject<{
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").Hash, string>>;
+    range: z.ZodTuple<[z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>], null>;
+}, z.z.core.$strip>;
+export type BlockValidationQualification = z.infer<typeof BlockValidationQualificationZod>;
+export declare const isBlockValidationQualification: <T>(value: T) => value is T & {
+    head: import("@xylabs/sdk-js").Hash;
+    range: [import("@xyo-network/xl1-protocol").XL1BlockNumber, import("@xyo-network/xl1-protocol").XL1BlockNumber];
+};
+export declare const BlockValidationConfigFieldsZod: z.ZodObject<{
+    value: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodBoolean>;
+}, z.z.core.$strip>;
+export declare const BlockValidationConfigZod: z.ZodUnion<readonly [z.ZodObject<{
+    value: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodBoolean>;
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").Hash, string>>;
+}, z.z.core.$strip>, z.ZodObject<{
+    value: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodBoolean>;
+    range: z.ZodTuple<[z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>], null>;
+}, z.z.core.$strip>, z.ZodObject<{
+    value: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodBoolean>;
+}, z.z.core.$strip>, z.ZodObject<{}, z.z.core.$strip>]>;
+export type BlockValidationConfig = z.infer<typeof BlockValidationConfigZod>;
+export declare const isBlockValidationConfig: <T>(value: T) => value is T & (Record<string, never> | {
+    value?: boolean | undefined;
+    state?: boolean | undefined;
+} | {
+    head: import("@xylabs/sdk-js").Hash;
+    value?: boolean | undefined;
+    state?: boolean | undefined;
+} | {
+    range: [import("@xyo-network/xl1-protocol").XL1BlockNumber, import("@xyo-network/xl1-protocol").XL1BlockNumber];
+    value?: boolean | undefined;
+    state?: boolean | undefined;
+});
+export interface BlockValidationViewerMethods {
+    qualifiedValidateBlocks(blocks: HydratedBlock[], config?: BlockValidationConfig): Promisable<[HydratedBlockValidationError[], BlockValidationQualification]>;
+}
+export declare const BlockValidationViewerMoniker: "BlockValidationViewer";
+export type BlockValidationViewerMoniker = typeof BlockValidationViewerMoniker;
+export interface BlockValidationViewer extends BlockValidationViewerMethods, Provider<BlockValidationViewerMoniker> {
+    qualifiedValidateBlock(block: SignedHydratedBlockWithHashMeta, config?: BlockValidationConfig): Promisable<[HydratedBlockValidationError[], BlockValidationQualification]>;
+    validateBlock(block: SignedHydratedBlockWithHashMeta, config?: BlockValidationConfig): Promisable<HydratedBlockValidationError[]>;
+    validateBlocks(blocks: SignedHydratedBlockWithHashMeta[], config?: BlockValidationConfig): Promisable<HydratedBlockValidationError[]>;
+}
+//# sourceMappingURL=BlockValidation.d.ts.map

package/dist/neutral/viewers/BlockValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockValidation.d.ts","sourceRoot":"","sources":["../../../src/viewers/BlockValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAC/F,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,OAAO,EAC6E,KAAK,QAAQ,EAChG,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAE1E,eAAO,MAAM,+BAA+B;;;mBAAwB,CAAA;AACpE,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAC1F,eAAO,MAAM,8BAA8B;;;CAAgD,CAAA;AAE3F,eAAO,MAAM,8BAA8B;;;mBAGzC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;uDAKnC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC5E,eAAO,MAAM,uBAAuB;;;;;;;;;;;EAAyC,CAAA;AAE7E,MAAM,WAAW,4BAA4B;IAC3C,uBAAuB,CACrB,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,UAAU,CAAC,CAAC,4BAA4B,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAA;CAC9E;AAED,eAAO,MAAM,4BAA4B,EAAG,uBAAgC,CAAA;AAC5E,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAE9E,MAAM,WAAW,qBAAsB,SAAQ,4BAA4B,EAAE,QAAQ,CAAC,4BAA4B,CAAC;IACjH,sBAAsB,CACpB,KAAK,EAAE,+BAA+B,EACtC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,UAAU,CAAC,CAAC,4BAA4B,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAA;IAC7E,aAAa,CAAC,KAAK,EAAE,+BAA+B,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,UAAU,CAAC,4BAA4B,EAAE,CAAC,CAAA;IACjI,cAAc,CAAC,MAAM,EAAE,+BAA+B,EAAE,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,UAAU,CAAC,4BAA4B,EAAE,CAAC,CAAA;CACtI"}

package/dist/neutral/viewers/StakeIntent.d.ts

@@ -1,8 +1,8 @@
 import type { Address, Hash, Promisable } from '@xylabs/sdk-js';
 import type { ChainStakeIntent, XL1BlockRange } from '@xyo-network/xl1-protocol';
-import type { Provider, Qualified } from '../model/index.ts';
+import type { ChainQualified, Provider } from '../model/index.ts';
 export interface StakeIntentViewerMethods {
-    qualifiedIntentByAddress(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<Qualified<ChainStakeIntent | null>>;
+    qualifiedIntentByAddress(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<ChainQualified<ChainStakeIntent | null>>;
 }
 export declare const StakeIntentViewerMoniker: "StakeIntentViewer";
 export type StakeIntentViewerMoniker = typeof StakeIntentViewerMoniker;

package/dist/neutral/viewers/StakeIntent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StakeIntent.d.ts","sourceRoot":"","sources":["../../../src/viewers/StakeIntent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAAE,IAAI,EAAE,UAAU,EAC1B,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE5D,MAAM,WAAW,wBAAwB;IACvC,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAA;CAC/H;AAED,eAAO,MAAM,wBAAwB,EAAG,mBAA4B,CAAA;AACpE,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAA;AAEtE,MAAM,WAAW,iBAAkB,SAAQ,wBAAwB,EAAE,QAAQ,CAAC,wBAAwB,CAAC;IACrG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CAC3G"}
+{"version":3,"file":"StakeIntent.d.ts","sourceRoot":"","sources":["../../../src/viewers/StakeIntent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAAE,IAAI,EAAE,UAAU,EAC1B,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjE,MAAM,WAAW,wBAAwB;IACvC,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,cAAc,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAA;CACpI;AAED,eAAO,MAAM,wBAAwB,EAAG,mBAA4B,CAAA;AACpE,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAA;AAEtE,MAAM,WAAW,iBAAkB,SAAQ,wBAAwB,EAAE,QAAQ,CAAC,wBAAwB,CAAC;IACrG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CAC3G"}

package/dist/neutral/viewers/TransactionValidation.d.ts

@@ -0,0 +1,35 @@
+import { type Promisable } from '@xylabs/sdk-js';
+import { type HydratedTransaction, type ValidationError } from '@xyo-network/xl1-protocol';
+import type z from 'zod';
+import { type Provider } from '../model/index.ts';
+export declare const TransactionValidationQualificationZod: z.ZodObject<{
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").Hash, string>>;
+    range: z.ZodTuple<[z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>], null>;
+}, z.z.core.$strip>;
+export type TransactionValidationQualification = z.infer<typeof TransactionValidationQualificationZod>;
+export declare const isTransactionValidationQualification: <T>(value: T) => value is T & {
+    head: import("@xylabs/sdk-js").Hash;
+    range: [import("@xyo-network/xl1-protocol").XL1BlockNumber, import("@xyo-network/xl1-protocol").XL1BlockNumber];
+};
+export declare const TransactionValidationConfigZod: z.ZodUnion<readonly [z.ZodObject<{
+    range: z.ZodTuple<[z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>], null>;
+}, z.z.core.$strip>, z.ZodObject<{
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").Hash, string>>;
+}, z.z.core.$strip>, z.ZodObject<{}, z.z.core.$strip>]>;
+export type TransactionValidationConfig = z.infer<typeof TransactionValidationConfigZod>;
+export declare const isTransactionValidationConfig: <T>(value: T) => value is T & ({
+    range: [import("@xyo-network/xl1-protocol").XL1BlockNumber, import("@xyo-network/xl1-protocol").XL1BlockNumber];
+} | {
+    head: import("@xylabs/sdk-js").Hash;
+} | Record<string, never>);
+export interface TransactionValidationViewerMethods {
+    qualifiedValidateTransactions(transactions: HydratedTransaction[], config?: TransactionValidationConfig): Promisable<[ValidationError[][], TransactionValidationQualification]>;
+}
+export declare const TransactionValidationViewerMoniker: "TransactionValidationViewer";
+export type TransactionValidationViewerMoniker = typeof TransactionValidationViewerMoniker;
+export interface TransactionValidationViewer extends TransactionValidationViewerMethods, Provider<TransactionValidationViewerMoniker> {
+    qualifiedValidateTransaction(transaction: HydratedTransaction, config?: TransactionValidationConfig): Promisable<[ValidationError[], TransactionValidationQualification]>;
+    validateTransaction(transaction: HydratedTransaction[], config?: TransactionValidationConfig): Promisable<ValidationError[]>;
+    validateTransactions(transactions: HydratedTransaction[], config?: TransactionValidationConfig): Promisable<ValidationError[][]>;
+}
+//# sourceMappingURL=TransactionValidation.d.ts.map

package/dist/neutral/viewers/TransactionValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionValidation.d.ts","sourceRoot":"","sources":["../../../src/viewers/TransactionValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC1F,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,EAC2C,KAAK,QAAQ,EAC9D,MAAM,mBAAmB,CAAA;AAE1B,eAAO,MAAM,qCAAqC;;;mBAAwB,CAAA;AAC1E,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAA;AACtG,eAAO,MAAM,oCAAoC;;;CAAsD,CAAA;AAEvG,eAAO,MAAM,8BAA8B;;;;uDAA0B,CAAA;AACrE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACxF,eAAO,MAAM,6BAA6B;;;;0BAA+C,CAAA;AAEzF,MAAM,WAAW,kCAAkC;IACjD,6BAA6B,CAC3B,YAAY,EAAE,mBAAmB,EAAE,EACnC,MAAM,CAAC,EAAE,2BAA2B,GACnC,UAAU,CAAC,CAAC,eAAe,EAAE,EAAE,EAAE,kCAAkC,CAAC,CAAC,CAAA;CACzE;AAED,eAAO,MAAM,kCAAkC,EAAG,6BAAsC,CAAA;AACxF,MAAM,MAAM,kCAAkC,GAAG,OAAO,kCAAkC,CAAA;AAE1F,MAAM,WAAW,2BAA4B,SAAQ,kCAAkC,EAAE,QAAQ,CAAC,kCAAkC,CAAC;IACnI,4BAA4B,CAC1B,WAAW,EAAE,mBAAmB,EAChC,MAAM,CAAC,EAAE,2BAA2B,GACnC,UAAU,CAAC,CAAC,eAAe,EAAE,EAAE,kCAAkC,CAAC,CAAC,CAAA;IACtE,mBAAmB,CAAC,WAAW,EAAE,mBAAmB,EAAE,EAAE,MAAM,CAAC,EAAE,2BAA2B,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC,CAAA;IAC5H,oBAAoB,CAAC,YAAY,EAAE,mBAAmB,EAAE,EAAE,MAAM,CAAC,EAAE,2BAA2B,GAAG,UAAU,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;CACjI"}

package/dist/neutral/viewers/index.d.ts

@@ -1,6 +1,7 @@
 export * from './AccountBalance.ts';
 export * from './Block.ts';
 export * from './BlockReward.ts';
+export * from './BlockValidation.ts';
 export * from './ChainContract.ts';
 export * from './ChainStakeViewer.ts';
 export * from './Fork.ts';
@@ -13,5 +14,6 @@ export * from './StepStake.ts';
 export * from './StepViewer.ts';
 export * from './TimeSync.ts';
 export * from './Transaction.ts';
+export * from './TransactionValidation.ts';
 export * from './TransferBalance.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/viewers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/viewers/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/viewers/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.18.0-rc.1",
+  "version": "1.18.0",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -42,6 +42,7 @@
     "@opentelemetry/api": "^1.9.0",
     "@xylabs/hex": "~5.0.51",
     "@xylabs/sdk-js": "~5.0.51",
+    "@xylabs/zod": "~5.0.51",
     "@xyo-network/account": "~5.2.17",
     "@xyo-network/account-model": "~5.2.17",
     "@xyo-network/archivist-model": "~5.2.17",
@@ -80,6 +81,5 @@
   "engineStrict": true,
   "publishConfig": {
     "access": "public"
-  },
-  "stableVersion": "1.17.7"
+  }
 }

package/src/CreatableProvider/AbstractCreatableProvider.ts

@@ -12,16 +12,16 @@ export abstract class AbstractCreatableProvider<TParams extends CreatableProvide
   implements Omit<CreatableProviderInstance, 'moniker'> {
   protected _contextCache: TParams['context'] | undefined
 
-  get config() {
-    return assertEx(this.context.config, () => 'config is required')
+  protected get config() {
+    return this.context.config!
   }
 
-  get context() {
-    return assertEx(this.params.context, () => 'context is required')
+  protected get context() {
+    return this.params.context!
   }
 
-  get locator() {
-    return assertEx(this.context.locator, () => 'locator is required')
+  protected get locator() {
+    return this.context.locator!
   }
 
   static factory<TModule extends CreatableProviderInstance>(
@@ -40,6 +40,22 @@ export abstract class AbstractCreatableProvider<TParams extends CreatableProvide
     return instance
   }
 
+  static override async paramsHandler<T extends CreatableProviderInstance>(
+    params: Partial<T['params']> = {},
+  ) {
+    const context = assertEx(params.context, () => new Error('Context is required'))
+    const config = assertEx(context.config, () => new Error('Context config is required'))
+    const locator = assertEx(context.locator, () => new Error('Context locator is required'))
+    return await super.paramsHandler<T>({
+      ...params,
+      statusReporter: params.statusReporter ?? context.statusReporter,
+      context: {
+        ...context, config, locator,
+      },
+      name: params.name ?? (this as unknown as CreatableProvider<T>).defaultMoniker,
+    })
+  }
+
   static async tryGetInstance<T extends CreatableProviderInstance>(
     this: CreatableProvider<T>,
     inParams: T['params'],

package/src/CreatableProvider/CreatableProvider.ts

@@ -46,26 +46,26 @@ export interface CreatableProviderFactory<T extends CreatableProviderInstance =
   /** @deprecated use getInstance instead */
   create(
     this: CreatableProviderFactory<T>,
-    params?: Partial<T['params']>, start?: boolean): Promise<T>
+    params?: Partial<T['params'] & CreatableProviderParams>, start?: boolean): Promise<T>
 
   getInstance(
     this: CreatableProviderFactory<T>,
-    params: T['params'], start?: boolean): Promise<T>
+    params: T['params'] & CreatableProviderParams, start?: boolean): Promise<T>
 
   tryGetInstance(
     this: CreatableProviderFactory<T>,
-    params: T['params'], start?: boolean): Promise<T | undefined>
+    params: T['params'] & CreatableProviderParams, start?: boolean): Promise<T | undefined>
 
 }
 
 export interface LabeledCreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance> extends CreatableProvider<T>, WithOptionalLabels {
-  factory(params?: Partial<T['params']>): LabeledCreatableProviderFactory<T>
+  factory(params?: Partial<T['params'] & CreatableProviderParams>): LabeledCreatableProviderFactory<T>
 }
 
 export interface CreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance> extends Creatable<T> {
   defaultMoniker: ProviderMoniker
   monikers: ProviderMoniker[]
-  factory(params?: Partial<T['params']>): CreatableProviderFactory<T>
+  factory(params?: Partial<T['params'] & CreatableProviderParams>): CreatableProviderFactory<T>
 }
 
 /**

package/src/CreatableProvider/CreatableProviderRegistry.ts

@@ -16,6 +16,7 @@ const buildProviderFactory = <TProvider extends CreatableProviderInstance>(
   const factory = {
     monikers: provider.monikers,
     // Copy static methods
+    // eslint-disable-next-line sonarjs/deprecation
     create: provider.create.bind(provider) as LabeledCreatableProviderFactory<TProvider>['create'],
 
     // Merge module & supplied labels

package/src/CreatableProvider/ProviderFactory.ts

@@ -103,11 +103,12 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
         },
       },
     } as TProvider['params']
-    const result = await this.creatableProvider.create<TProvider>(mergedParams)
+    const resultPromise = scopeObject[this.resolvedMoniker] as Promise<TProvider> ?? this.creatableProvider.create<TProvider>(mergedParams)
+    scopeObject[this.resolvedMoniker] = resultPromise
+    const result = await resultPromise
     if (start) {
       assertEx(await result.start(), () => 'Failed to start provider instance')
     }
-    scopeObject[this.resolvedMoniker] = result
     return result
   }
 

package/src/CreatableProvider/ProviderFactoryLocator.ts

@@ -68,7 +68,8 @@ export class ProviderFactoryLocator implements ProviderFactoryLocatorInstance {
       } as CreatableProviderInstance<TProvider>['params']['context'],
     } as CreatableProviderInstance<TProvider>['params']
     const factory = this.locate<TProvider>(moniker, labels)
-    return await factory.getInstance(resolvedParams)
+    const result = await factory.getInstance(resolvedParams)
+    return result
   }
 
   /**

package/src/config/Services.ts

@@ -2,12 +2,14 @@ import { globalRegistry } from 'zod'
 import * as z from 'zod'
 
 export const ServicesConfigZod = z.object({
-  accountBalanceViewerEndpoint: z.string().optional().register(globalRegistry, {
+  accountBalanceViewerEndpoint: z.string().default('http://localhost:8080/rpc').register(globalRegistry, {
+    default: 'http://localhost:8080/rpc',
     description: 'Endpoint of the API to use for instantiating an external AccountBalanceViewer',
     title: 'services.accountBalanceViewerEndpoint',
     type: 'string',
   }),
-  apiEndpoint: z.string().optional().register(globalRegistry, {
+  apiEndpoint: z.string().default('http://localhost:8080/rpc').register(globalRegistry, {
+    default: 'http://localhost:8080/rpc',
     description: 'Endpoint of the API to use for instantiating an external Viewers',
     title: 'services.apiEndpoint',
     type: 'string',

package/src/model/ChainQualification.ts

@@ -0,0 +1,33 @@
+import { HashZod } from '@xylabs/hex'
+import { zodIsFactory } from '@xylabs/zod'
+import { XL1BlockRangeZod } from '@xyo-network/xl1-protocol'
+import z from 'zod'
+
+export const ChainQualificationZod = z.object({ head: HashZod, range: XL1BlockRangeZod })
+export type ChainQualification = z.infer<typeof ChainQualificationZod>
+export const isChainQualification = zodIsFactory(ChainQualificationZod)
+
+export const ChainQualifiedRangeConfigZod = z.object({ range: XL1BlockRangeZod })
+export type ChainQualifiedRangeConfig = z.infer<typeof ChainQualifiedRangeConfigZod>
+export const isChainQualifiedRangeConfig = zodIsFactory(ChainQualifiedRangeConfigZod)
+
+export const ChainQualifiedHeadConfigZod = z.object({ head: HashZod })
+export type ChainQualifiedHeadConfig = z.infer<typeof ChainQualifiedHeadConfigZod>
+export const isChainQualifiedHeadConfig = zodIsFactory(ChainQualifiedHeadConfigZod)
+
+export const ChainQualifiedConfigZod = z.union([ChainQualifiedRangeConfigZod, ChainQualifiedHeadConfigZod, z.object({})])
+export type ChainQualifiedConfig = z.infer<typeof ChainQualifiedConfigZod>
+export const isChainQualifiedConfig = zodIsFactory(ChainQualifiedConfigZod)
+
+export const ExtendChainQualifiedConfigZod = (<T>(zodType: z.ZodType<T>) => {
+  return z.union([
+    ChainQualifiedRangeConfigZod.extend(zodType),
+    ChainQualifiedHeadConfigZod.extend(zodType),
+    zodType,
+  ])
+}) as <T>(zodType: z.ZodType<T>) => z.ZodType<T & ChainQualifiedConfig>
+
+export type ChainQualified<T> = [T, ChainQualification]
+export const ChainQualifiedZod = <T>(zodType: z.ZodType<T>) => {
+  return z.tuple([zodType, ChainQualificationZod])
+}

package/src/model/index.ts

@@ -1,10 +1,10 @@
 export * from './ChainContext/index.ts'
 export * from './ChainFork/index.ts'
 export * from './ChainIdentity.ts'
+export * from './ChainQualification.ts'
 export * from './ChainStore.ts'
 export * from './PayloadBundle/index.ts'
 export * from './PayloadMap.ts'
 export * from './Position.ts'
 export * from './Provider.ts'
-export * from './Qualified.ts'
 export * from './RecordKeyType.ts'

package/src/primitives/chain/getWindowedChain.ts

@@ -0,0 +1,23 @@
+import type { Hash } from '@xylabs/sdk-js'
+import type { SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol'
+
+import type { BlockViewer } from '../../viewers/index.ts'
+
+export async function getWindowedChain(blockViewer: BlockViewer, maxWindowSize: number, previousChain: SignedHydratedBlockWithHashMeta[] = []) {
+  const newBlocks: SignedHydratedBlockWithHashMeta[] = []
+  let currentBlock: SignedHydratedBlockWithHashMeta | null = await blockViewer.currentBlock()
+  console.log('[getWindowedChain] Current Block:', currentBlock?.[0]._hash)
+  const head = currentBlock
+  while (currentBlock !== null && currentBlock[0].block >= head[0].block) {
+    newBlocks.unshift(currentBlock)
+    const previousBlockHash: Hash | null = currentBlock[0].previous
+    currentBlock = (previousBlockHash === null ? null : await blockViewer.blockByHash(previousBlockHash))
+  }
+  const newChain = [...previousChain, ...newBlocks].slice(-maxWindowSize)
+  while (newChain.length > 0 && newChain.length < maxWindowSize && newChain[0][0].previous !== null) {
+    const block = await blockViewer.blockByHash(newChain[0][0].previous!)
+    if (block === null) break
+    newChain.unshift(block)
+  }
+  return newChain
+}

package/src/primitives/chain/index.ts

@@ -1,2 +1,3 @@
+export * from './getWindowedChain.ts'
 export * from './step/index.ts'
 export * from './time/index.ts'

package/src/primitives/index.ts

@@ -10,3 +10,4 @@ export * from './state/index.ts'
 export * from './step/index.ts'
 export * from './timeBudget.ts'
 export * from './transaction/index.ts'
+export * from './uncle/index.ts'

package/src/primitives/rewards/networkStakeStepRewardPositionWeight.ts

@@ -1,7 +1,7 @@
 import { type StepIdentity } from '@xyo-network/xl1-protocol'
 
 import type { StakedChainContextRead } from '../../model/index.ts'
-import type { BlockViewer } from '../../viewers/Block.ts'
+import type { BlockViewer } from '../../viewers/index.ts'
 import { externalBlockRangeFromStep } from '../chain/time/index.ts'
 import { weightedStakeForRangeByPosition } from '../stake/index.ts'
 

package/src/primitives/uncle/findBestUncle.ts

@@ -0,0 +1,8 @@
+import type { SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol'
+
+import { scoreUncle } from './scoreUncle.ts'
+
+export function findBestUncle(finalizedWindowedChain: SignedHydratedBlockWithHashMeta[], uncles: SignedHydratedBlockWithHashMeta[][]) {
+  const scores = uncles.map(uncle => ([scoreUncle(finalizedWindowedChain, uncle), uncle] as const)).toSorted((a, b) => b[0] - a[0])
+  return scores[0]?.[1] ?? finalizedWindowedChain
+}

package/src/primitives/uncle/findUncles.ts

@@ -0,0 +1,75 @@
+import {
+  assertEx,
+  exists, type Hash,
+} from '@xylabs/sdk-js'
+import { isTransactionBoundWitness, type SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol'
+
+import type { BaseContext } from '../../model/index.ts'
+
+function blocksToChains(blocks: SignedHydratedBlockWithHashMeta[]) {
+  const chains: SignedHydratedBlockWithHashMeta[][] = []
+  const map = new Map<Hash, SignedHydratedBlockWithHashMeta>()
+  for (const block of blocks) {
+    map.set(block[0]._hash, block)
+  }
+  for (const block of blocks) {
+    let uncle: SignedHydratedBlockWithHashMeta[] = [block]
+    let previous = block[0].previous ? map.get(block[0].previous) : undefined
+    while (previous) {
+      if (previous[0].block === (uncle[0][0].block - 1)) {
+        uncle.unshift(previous)
+        previous = previous[0].previous ? map.get(previous[0].previous) : undefined
+      } else {
+        // block number sequence is off
+        uncle = []
+        break
+      }
+    }
+    if (uncle.length > 0) {
+      chains.push(uncle)
+    }
+  }
+  return chains
+}
+
+function toValidUncle(
+  _context: BaseContext,
+  finalizedWindowedChain: SignedHydratedBlockWithHashMeta[],
+  possibleUncle: SignedHydratedBlockWithHashMeta[],
+) {
+  const finalizedWindowStartBlockNumber = finalizedWindowedChain.at(0)?.[0].block ?? -1
+  const finalizedHead = assertEx(finalizedWindowedChain.at(-1), () => 'finalizedWindowedChain is empty')
+  // prune the chain to match the finalized head
+
+  const prunedPossibleUncle = possibleUncle.filter(b => b[0].block > finalizedHead[0].block)
+
+  if (prunedPossibleUncle.length === 0) {
+    return
+  }
+
+  if (prunedPossibleUncle[0][0].block !== finalizedHead[0].block + 1) {
+    // uncle does not build on finalized head (block number mismatch)
+    return
+  }
+  if (prunedPossibleUncle[0][0].previous !== finalizedHead[0]._hash) {
+    // uncle does not build on finalized head (previous hash mismatch)
+    return
+  }
+  const allUncleTransactions = prunedPossibleUncle.flatMap(b => b[1]).filter(isTransactionBoundWitness)
+  const allFinalizedTransactions = finalizedWindowedChain.flatMap(b => b[1]).filter(isTransactionBoundWitness)
+  const txPossiblyBeforeWindow = allUncleTransactions.find(tx => tx.nbf < finalizedWindowStartBlockNumber)
+  if (txPossiblyBeforeWindow) {
+    // uncle has a transaction that is valid before the finalized window
+    return
+  }
+  const txExistsInWindow = allUncleTransactions.find(tx => allFinalizedTransactions.find(finalTx => finalTx._hash === tx._hash))
+  if (txExistsInWindow) {
+    // uncle has a transaction that is already in the finalized window
+    return
+  }
+  return prunedPossibleUncle
+}
+
+export function findUncles(context: BaseContext, finalizedWindowedChain: SignedHydratedBlockWithHashMeta[], blocks: SignedHydratedBlockWithHashMeta[]) {
+  return blocksToChains(blocks).map(chain => toValidUncle(context, finalizedWindowedChain, chain)).filter(exists)
+}

package/src/primitives/uncle/index.ts

@@ -0,0 +1,3 @@
+export * from './findBestUncle.ts'
+export * from './findUncles.ts'
+export * from './scoreUncle.ts'

package/src/primitives/uncle/scoreUncle.ts

@@ -0,0 +1,6 @@
+import type { SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol'
+
+export function scoreUncle(finalizedWindowedChain: SignedHydratedBlockWithHashMeta[], blocks: SignedHydratedBlockWithHashMeta[]) {
+  // TODO: More than length check
+  return blocks.length
+}

package/src/provider/viewer/XyoViewer.ts

@@ -1,9 +1,7 @@
-import type {
-  Address, Hash, Promisable,
-} from '@xylabs/sdk-js'
-import type { AttoXL1, XL1BlockRange } from '@xyo-network/xl1-protocol'
+import type { Address, Promisable } from '@xylabs/sdk-js'
+import type { AttoXL1 } from '@xyo-network/xl1-protocol'
 
-import type { Provider } from '../../model/index.ts'
+import type { ChainQualifiedConfig, Provider } from '../../model/index.ts'
 import type {
   AccountBalanceHistoryItem,
   AccountBalanceViewer,
@@ -22,8 +20,10 @@ import type { NetworkStakeViewer } from './NetworkStake/index.ts'
 export interface XyoViewerMethods extends
   NetworkStakeStepRewardViewerMethods, BlockViewerMethods,
   TransactionViewerMethods, StakeViewerMethods, ForkViewerMethods {
-  accountBalance(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<AttoXL1>
-  accountBalanceHistory(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<AccountBalanceHistoryItem[]>
+  /** @deprecated Use .account.balance.accountBalance instead */
+  accountBalance(address: Address, config?: ChainQualifiedConfig): Promisable<AttoXL1>
+  /** @deprecated Use .account.balance.accountBalanceHistory instead */
+  accountBalanceHistory(address: Address, config?: ChainQualifiedConfig): Promisable<AccountBalanceHistoryItem[]>
 }
 
 export const XyoViewerMoniker = 'XyoViewer' as const