@xyo-network/xl1-protocol-sdk 1.26.23 → 1.26.25

package/dist/neutral/isInternetAvailable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isInternetAvailable.d.ts","sourceRoot":"","sources":["../../src/isInternetAvailable.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,QAAa,OAAO,CAAC,OAAO,CAO3D,CAAA"}
+{"version":3,"file":"isInternetAvailable.d.ts","sourceRoot":"","sources":["../../src/isInternetAvailable.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,QAAa,OAAO,CAAC,OAAO,CAO3D,CAAA"}

package/dist/neutral/model/CreatableProviderContext.zod.d.ts

@@ -99,6 +99,8 @@ export declare const BaseConfigContextZod: z.ZodObject<{
             } & {
                 readonly __address: true;
             }, string>>>>>;
+            minCandidates: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+            backoffMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
         }, z.core.$strip>>;
     }, z.core.$loose>;
     locator: z.ZodOptional<z.ZodType<ProviderFactoryLocatorInstance<CreatableProviderContextType>, unknown, z.core.$ZodTypeInternals<ProviderFactoryLocatorInstance<CreatableProviderContextType>, unknown>>>;
@@ -172,6 +174,8 @@ export declare const isBaseConfigContext: <T>(value: T) => value is T & {
             } | undefined;
         };
         validation: {
+            minCandidates: number;
+            backoffMs: number;
             allowedRewardRedeemers?: (Lowercase<string> & {
                 readonly __hex: true;
             } & {
@@ -257,6 +261,8 @@ export declare const asBaseConfigContext: {
                 } | undefined;
             };
             validation: {
+                minCandidates: number;
+                backoffMs: number;
                 allowedRewardRedeemers?: (Lowercase<string> & {
                     readonly __hex: true;
                 } & {
@@ -340,6 +346,8 @@ export declare const asBaseConfigContext: {
                 } | undefined;
             };
             validation: {
+                minCandidates: number;
+                backoffMs: number;
                 allowedRewardRedeemers?: (Lowercase<string> & {
                     readonly __hex: true;
                 } & {
@@ -426,6 +434,8 @@ export declare const toBaseConfigContext: {
                 } | undefined;
             };
             validation: {
+                minCandidates: number;
+                backoffMs: number;
                 allowedRewardRedeemers?: (Lowercase<string> & {
                     readonly __hex: true;
                 } & {
@@ -509,6 +519,8 @@ export declare const toBaseConfigContext: {
                 } | undefined;
             };
             validation: {
+                minCandidates: number;
+                backoffMs: number;
                 allowedRewardRedeemers?: (Lowercase<string> & {
                     readonly __hex: true;
                 } & {

package/dist/neutral/model/CreatableProviderContext.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CreatableProviderContext.zod.d.ts","sourceRoot":"","sources":["../../../src/model/CreatableProviderContext.zod.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,oBAAoB,CAAA;AACnE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAA;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,yDAAwE,CAAA;AAE5G,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAC2C,CAAA;AAE3H,yCAAyC;AACzC,MAAM,MAAM,4BAA4B,GAAG,cAAc,GAAG;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,8BAA8B,CAAA;IACvC,cAAc,CAAC,EAAE,oBAAoB,CAAA;CACtC,CAAA;AAED,qCAAqC;AACrC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG/B,CAAA;AACF,8BAA8B;AAC9B,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAK3E,CAAA;AAEL,sEAAsE;AACtE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAqC,CAAA;AACrE,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA4D,CAAA;AAC5F,oCAAoC;AACpC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA4D,CAAA;AAE5F,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B;;;;;;;;UA9B/B,MAAM;YACJ,UAAU;aACT,8BAA8B;qBACtB,oBAAoB;CA2B4C,CAAA;AACnF,yEAAyE;AACzE,eAAO,MAAM,0BAA0B;;;;;;;;;cAhC/B,MAAM;gBACJ,UAAU;iBACT,8BAA8B;yBACtB,oBAAoB;;;;;;;;;;cAH/B,MAAM;gBACJ,UAAU;iBACT,8BAA8B;yBACtB,oBAAoB;;CA6B0E,CAAA;AACjH,2CAA2C;AAC3C,eAAO,MAAM,0BAA0B;;;;;;;;;cAlC/B,MAAM;gBACJ,UAAU;iBACT,8BAA8B;yBACtB,oBAAoB;;;;;;;;;;cAH/B,MAAM;gBACJ,UAAU;iBACT,8BAA8B;yBACtB,oBAAoB;;CA+B0E,CAAA"}
+{"version":3,"file":"CreatableProviderContext.zod.d.ts","sourceRoot":"","sources":["../../../src/model/CreatableProviderContext.zod.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,oBAAoB,CAAA;AACnE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAA;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,wCAAwC;AACxC,eAAO,MAAM,uBAAuB,yDAAwE,CAAA;AAE5G,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,8BAA8B,CAC2C,CAAA;AAE3H,yCAAyC;AACzC,MAAM,MAAM,4BAA4B,GAAG,cAAc,GAAG;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,UAAU,CAAA;IAClB,OAAO,EAAE,8BAA8B,CAAA;IACvC,cAAc,CAAC,EAAE,oBAAoB,CAAA;CACtC,CAAA;AAED,qCAAqC;AACrC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAG/B,CAAA;AACF,8BAA8B;AAC9B,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEpE,4CAA4C;AAC5C,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAK3E,CAAA;AAEL,sEAAsE;AACtE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAqC,CAAA;AACrE,kEAAkE;AAClE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA4D,CAAA;AAC5F,oCAAoC;AACpC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAA4D,CAAA;AAE5F,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B;;;;;;;;UA9B/B,MAAM;YACJ,UAAU;aACT,8BAA8B;qBACtB,oBAAoB;CA2B4C,CAAA;AACnF,yEAAyE;AACzE,eAAO,MAAM,0BAA0B;;;;;;;;;cAhC/B,MAAM;gBACJ,UAAU;iBACT,8BAA8B;yBACtB,oBAAoB;;;;;;;;;;cAH/B,MAAM;gBACJ,UAAU;iBACT,8BAA8B;yBACtB,oBAAoB;;CA6B0E,CAAA;AACjH,2CAA2C;AAC3C,eAAO,MAAM,0BAA0B;;;;;;;;;cAlC/B,MAAM;gBACJ,UAAU;iBACT,8BAA8B;yBACtB,oBAAoB;;;;;;;;;;cAH/B,MAAM;gBACJ,UAAU;iBACT,8BAA8B;yBACtB,oBAAoB;;CA+B0E,CAAA"}

package/dist/neutral/primitives/uncle/findBestUncle.d.ts

@@ -1,36 +1,17 @@
 import type { SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol-lib';
-/** FindBestUncle helper function. */
-export declare function findBestUncle(finalizedWindowedChain: SignedHydratedBlockWithHashMeta[], uncles: SignedHydratedBlockWithHashMeta[][]): [{
-    schema: "network.xyo.boundwitness" & {
-        readonly __schema: true;
-    };
-    addresses: (Lowercase<string> & {
-        readonly __hex: true;
-    } & {
-        readonly __address: true;
-    })[];
-    payload_hashes: import("@xylabs/sdk-js").BrandedHash[];
-    payload_schemas: import("@xyo-network/sdk-js").BrandedSchema<string>[];
-    previous_hashes: (import("@xylabs/sdk-js").BrandedHash | null)[];
-    $signatures: import("@xylabs/sdk-js").BrandedHex[];
-    block: import("@xyo-network/xl1-protocol-lib").XL1BlockNumber;
-    chain: import("@xylabs/sdk-js").BrandedHex;
-    previous: import("@xylabs/sdk-js").BrandedHash | null;
-    $epoch: number;
-    _hash: import("@xylabs/sdk-js").BrandedHash;
-    _dataHash: import("@xylabs/sdk-js").BrandedHash;
-    $destination?: (Lowercase<string> & {
-        readonly __hex: true;
-    } & {
-        readonly __address: true;
-    }) | undefined;
-    $sourceQuery?: import("@xylabs/sdk-js").BrandedHash | undefined;
-    protocol?: number | undefined;
-    step_hashes?: import("@xylabs/sdk-js").BrandedHash[] | undefined;
-}, {
-    [x: string]: unknown;
-    schema: import("@xyo-network/sdk-js").BrandedSchema<string>;
-    _hash: import("@xylabs/sdk-js").BrandedHash;
-    _dataHash: import("@xylabs/sdk-js").BrandedHash;
-}[]][];
+/** Default minimum number of uncle candidates before selecting. */
+export declare const DEFAULT_MIN_CANDIDATES = 2;
+/** Default back-off timeout in milliseconds. If the head has not changed for this long, minCandidates is ignored. */
+export declare const DEFAULT_BACKOFF_MS = 120000;
+/** Options for findBestUncle block selection. */
+export interface FindBestUncleOptions {
+    /** Back-off timeout in ms. If head age exceeds this, minCandidates is ignored. Default: 120_000. */
+    backoffMs?: number;
+    /** Minimum number of uncle candidates before selecting. Default: 2. */
+    minCandidates?: number;
+    /** Current timestamp in ms. Injectable for testing. Default: Date.now(). */
+    now?: number;
+}
+/** Selects the best uncle chain from candidates using Proof of Perfect scoring. */
+export declare function findBestUncle(finalizedWindowedChain: SignedHydratedBlockWithHashMeta[], uncles: SignedHydratedBlockWithHashMeta[][], options?: FindBestUncleOptions): SignedHydratedBlockWithHashMeta[] | undefined;
 //# sourceMappingURL=findBestUncle.d.ts.map

package/dist/neutral/primitives/uncle/findBestUncle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"findBestUncle.d.ts","sourceRoot":"","sources":["../../../../src/primitives/uncle/findBestUncle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAA;AAIpF,qCAAqC;AACrC,wBAAgB,aAAa,CAAC,sBAAsB,EAAE,+BAA+B,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAGnI"}
+{"version":3,"file":"findBestUncle.d.ts","sourceRoot":"","sources":["../../../../src/primitives/uncle/findBestUncle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAA;AAIpF,mEAAmE;AACnE,eAAO,MAAM,sBAAsB,IAAI,CAAA;AAEvC,qHAAqH;AACrH,eAAO,MAAM,kBAAkB,SAAU,CAAA;AAEzC,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,sBAAsB,EAAE,+BAA+B,EAAE,EACzD,MAAM,EAAE,+BAA+B,EAAE,EAAE,EAC3C,OAAO,CAAC,EAAE,oBAAoB,GAC7B,+BAA+B,EAAE,GAAG,SAAS,CAiB/C"}

package/dist/neutral/primitives/uncle/getProducerKey.d.ts

@@ -0,0 +1,4 @@
+import type { SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol-lib';
+/** Extracts a canonical producer identity string from a block's signer addresses. */
+export declare function getProducerKey(block: SignedHydratedBlockWithHashMeta): string;
+//# sourceMappingURL=getProducerKey.d.ts.map

package/dist/neutral/primitives/uncle/getProducerKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProducerKey.d.ts","sourceRoot":"","sources":["../../../../src/primitives/uncle/getProducerKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAA;AAEpF,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,+BAA+B,GAAG,MAAM,CAE7E"}

package/dist/neutral/primitives/uncle/index.d.ts

@@ -1,4 +1,5 @@
 export * from './findBestUncle.ts';
 export * from './findUncles.ts';
+export * from './getProducerKey.ts';
 export * from './scoreUncle.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/primitives/uncle/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/primitives/uncle/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/primitives/uncle/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA"}

package/dist/neutral/primitives/uncle/scoreUncle.d.ts

@@ -1,4 +1,6 @@
 import type { SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol-lib';
-/** ScoreUncle helper function. */
+/** Bonus applied when a candidate block is from a different producer than the current head. */
+export declare const PRODUCER_DIVERSITY_BONUS = 1000;
+/** Scores an uncle chain candidate for block selection (Proof of Perfect). */
 export declare function scoreUncle(finalizedWindowedChain: SignedHydratedBlockWithHashMeta[], blocks: SignedHydratedBlockWithHashMeta[]): number;
 //# sourceMappingURL=scoreUncle.d.ts.map

package/dist/neutral/primitives/uncle/scoreUncle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoreUncle.d.ts","sourceRoot":"","sources":["../../../../src/primitives/uncle/scoreUncle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAA;AAEpF,kCAAkC;AAClC,wBAAgB,UAAU,CAAC,sBAAsB,EAAE,+BAA+B,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,UAG9H"}
+{"version":3,"file":"scoreUncle.d.ts","sourceRoot":"","sources":["../../../../src/primitives/uncle/scoreUncle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAA;AAIpF,+FAA+F;AAC/F,eAAO,MAAM,wBAAwB,OAAO,CAAA;AAE5C,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,sBAAsB,EAAE,+BAA+B,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,GAAG,MAAM,CAevI"}