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

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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.26.23",
+  "version": "1.26.24",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -22,7 +22,6 @@
   "exports": {
     ".": {
       "types": "./dist/neutral/index.d.ts",
-      "import": "./dist/neutral/index.mjs",
       "default": "./dist/neutral/index.mjs"
     },
     "./test": {
@@ -35,7 +34,6 @@
     },
     "./package.json": "./package.json"
   },
-  "types": "./dist/neutral/index.d.ts",
   "files": [
     "dist",
     "!**/*.bench.*",
@@ -47,8 +45,8 @@
     "async-mutex": "~0.5.0",
     "cosmiconfig": "^9.0.1",
     "lru-cache": "^11.3.3",
-    "@xyo-network/xl1-schema": "~1.26.23",
-    "@xyo-network/xl1-protocol-lib": "~1.26.23"
+    "@xyo-network/xl1-protocol-lib": "~1.26.24",
+    "@xyo-network/xl1-schema": "~1.26.24"
   },
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
@@ -119,8 +117,8 @@
     "vite": "^8.0.8",
     "vitest": "~4.1.4",
     "zod": "~4.3.6",
-    "@xyo-network/xl1-network-model": "~1.26.23",
-    "@xyo-network/xl1-protocol-model": "~1.26.23"
+    "@xyo-network/xl1-network-model": "~1.26.24",
+    "@xyo-network/xl1-protocol-model": "~1.26.24"
   },
   "peerDependencies": {
     "@opentelemetry/api": "^1",