@xyo-network/xl1-providers 4.0.7 → 4.0.9

package/dist/node/locators/basicRestViewerLocator.d.ts

@@ -0,0 +1,32 @@
+import type { RestConnectionConfig } from '@xyo-network/xl1-protocol-sdk';
+/** REST connection config for the S3-backed static file layout, split by bucket. */
+export interface RestRemoteConfig {
+    /** REST connection over the finalized blocks bucket (always required — the base for BlockViewer/ChainStateViewer/ChainContractViewer). */
+    blocks: RestConnectionConfig;
+    /** REST connection over a separate chain-state bucket, when the head pointer lives apart from finalized blocks. Defaults to `blocks`. */
+    chainState?: RestConnectionConfig;
+    /** REST connection over a separate index bucket, when step summaries live apart from finalized blocks. Defaults to `blocks`. */
+    index?: RestConnectionConfig;
+}
+export interface BasicRestViewerLocatorOptions {
+    dataLakeEndpoint?: string;
+    /** Custom fetch override for every REST viewer (custom agents, auth headers, tests). Defaults to the global fetch. */
+    fetchFn?: typeof globalThis.fetch;
+    /**
+     * Whether `XyoViewer` precomputes network-stake-reward positions across the whole chain at
+     * startup. Defaults to `true` (matching `SimpleXyoViewer`'s own default), but that precompute
+     * issues one REST round trip per position/step, which can be slow or fragile against a large,
+     * live chain — set `false` for a lighter-weight client that doesn't need reward data.
+     */
+    initRewardsCache?: boolean;
+}
+/**
+ * Builds a config-driven, connections-native locator for a REST/S3-backed read-only gateway:
+ * `BlockViewer`/`ChainStateViewer`/`FinalizationViewer`/`ChainContractViewer` are bound to REST
+ * connections over the S3 static file layout; every other viewer moniker
+ * (`synthesizeMemoryViewerBindings`) is bound to a shared `memory` connection, resolving to the
+ * `Simple*` implementations that compute their data from the injected `BlockViewer` instead of a
+ * dedicated remote source. Mirrors `basicRemoteViewerLocator`'s RPC-based counterpart.
+ */
+export declare function basicRestViewerLocator(name: string, restConfig: RestRemoteConfig, dataLakeEndpoint?: string, options?: BasicRestViewerLocatorOptions): Promise<import("@xyo-network/xl1-protocol-sdk").ProviderFactoryLocatorInstance<import("@xyo-network/xl1-protocol-sdk").CreatableProviderContextType>>;
+//# sourceMappingURL=basicRestViewerLocator.d.ts.map

package/dist/node/locators/basicRestViewerLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basicRestViewerLocator.d.ts","sourceRoot":"","sources":["../../../src/locators/basicRestViewerLocator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACiC,oBAAoB,EAChE,MAAM,+BAA+B,CAAA;AAgBtC,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,0IAA0I;IAC1I,MAAM,EAAE,oBAAoB,CAAA;IAC5B,yIAAyI;IACzI,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC,gIAAgI;IAChI,KAAK,CAAC,EAAE,oBAAoB,CAAA;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sHAAsH;IACtH,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IACjC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,gBAAgB,EAC5B,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,6BAA6B,yJAyExC"}

package/dist/node/locators/index.d.ts

@@ -1,6 +1,7 @@
 export * from './baseConfigFactoryLocator.ts';
 export * from './basicRemoteRunnerLocator.ts';
 export * from './basicRemoteViewerLocator.ts';
+export * from './basicRestViewerLocator.ts';
 export * from './locatorFromAdaptedConfig.ts';
 export * from './providerCandidates.ts';
 export * from './remoteLocatorFromConfig.ts';

package/dist/node/locators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/locators/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/locators/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,4BAA4B,CAAA"}

package/dist/node/locators/providerCandidates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providerCandidates.d.ts","sourceRoot":"","sources":["../../../src/locators/providerCandidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAyG1F,+EAA+E;AAC/E,wBAAgB,qBAAqB,IAAI,kBAAkB,EAAE,CAE5D"}
+{"version":3,"file":"providerCandidates.d.ts","sourceRoot":"","sources":["../../../src/locators/providerCandidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAuH1F,+EAA+E;AAC/E,wBAAgB,qBAAqB,IAAI,kBAAkB,EAAE,CAE5D"}

package/dist/node/registerHelpers.d.ts

@@ -1,4 +1,4 @@
-import type { AccountInstance } from '@xyo-network/sdk-js';
+import type { AccountInstance } from '@xyo-network/sdk';
 import type { Position } from '@xyo-network/xl1-protocol-lib';
 import type { ProviderFactoryLocator } from '@xyo-network/xl1-protocol-sdk';
 /**

package/dist/node/registerHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registerHelpers.d.ts","sourceRoot":"","sources":["../../src/registerHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAU3E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,sBAAsB,EAC/B,UAAU,eAAe,2GAa1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,GAC/C,SAAS,sBAAsB,EAC/B,WAAW,QAAQ,EAAE,2GAOtB,CAAA"}
+{"version":3,"file":"registerHelpers.d.ts","sourceRoot":"","sources":["../../src/registerHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAU3E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,sBAAsB,EAC/B,UAAU,eAAe,2GAa1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,GAC/C,SAAS,sBAAsB,EAC/B,WAAW,QAAQ,EAAE,2GAOtB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/xl1-providers",
-  "version": "4.0.7",
+  "version": "4.0.9",
   "description": "XYO Layer One API",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -44,73 +44,76 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol-lib": "~4.0.7",
-    "@xyo-network/xl1-protocol-sdk": "~4.0.7",
-    "@xyo-network/xl1-protocol-model": "~4.0.7",
-    "@xyo-network/xl1-rpc": "~4.0.7"
+    "@xyo-network/xl1-protocol-lib": "~4.0.9",
+    "@xyo-network/xl1-protocol-model": "~4.0.9",
+    "@xyo-network/xl1-protocol-sdk": "~4.0.9",
+    "@xyo-network/xl1-rpc": "~4.0.9",
+    "@xyo-network/xl1-rest-block-viewer": "~4.0.9"
   },
   "devDependencies": {
-    "@ariestools/sdk": "^7.0.3",
+    "@ariestools/sdk": "~7.0.8",
     "@bitauth/libauth": "~3.0.0",
-    "@metamask/json-rpc-engine": "^10.5.0",
-    "@metamask/utils": "^11.11.0",
+    "@metamask/json-rpc-engine": "~10.5.0",
+    "@metamask/providers": "~22.1.1",
+    "@metamask/utils": "~11.11.0",
     "@noble/post-quantum": "~0.6.1",
-    "@opentelemetry/api": "^1.9.1",
-    "@opentelemetry/sdk-trace-base": "^2.8.0",
+    "@opentelemetry/api": "~1.9.1",
+    "@opentelemetry/sdk-trace-base": "~2.9.0",
     "@scure/base": "~2.2.0",
     "@scure/bip39": "~2.2.0",
-    "@xylabs/geo": "^7.0.3",
-    "@xylabs/sdk": "^7.0",
-    "@xylabs/threads": "^7.0.3",
-    "@xylabs/toolchain": "~8.5.11",
-    "@xylabs/tsconfig": "~8.5.11",
-    "@xylabs/vitest-extended": "^7.0.3",
-    "@xyo-network/sdk-js": "~7.0.4",
-    "@xyo-network/sdk-protocol": "~7.0.5",
-    "ajv": "^8.20.0",
-    "async-mutex": "^0.5.0",
-    "cosmiconfig": "^9.0.2",
+    "@xylabs/geo": "~7.0.8",
+    "@xylabs/threads": "~7.0.8",
+    "@xylabs/toolchain": "~8.6.2",
+    "@xylabs/tsconfig": "~8.6.2",
+    "@xylabs/vitest-extended": "~7.0.8",
+    "@xyo-network/sdk": "~7.0.8",
+    "@xyo-network/sdk-protocol": "~7.0.13",
+    "ajv": "~8.20.0",
+    "async-mutex": "~0.5.0",
+    "cosmiconfig": "~9.0.2",
     "debug": "~4.4.3",
     "dotenv": "~17.4.2",
-    "eslint": "^10.6.0",
-    "ethers": "^6.17.0",
+    "eslint": "~10.6.0",
+    "ethers": "~6.17.0",
     "hash-wasm": "~4.12.0",
-    "idb": "^8.0.3",
-    "lru-cache": "^11.5.1",
+    "idb": "~8.0.3",
+    "lru-cache": "~11.5.1",
     "observable-fns": "~0.6.1",
-    "tslib": "^2.8.1",
+    "tslib": "~2.8.1",
     "typescript": "~6.0.3",
     "uuid": "~14.0.1",
-    "vite": "^8.1.2",
+    "vite": "~8.1.3",
     "vitest": "~4.1.9",
+    "webextension-polyfill": "~0.12.0",
     "zod": "~4.4.3"
   },
   "peerDependencies": {
-    "@ariestools/sdk": "^7.0",
-    "@bitauth/libauth": "~3.0",
-    "@metamask/json-rpc-engine": "^10.3",
-    "@metamask/utils": "^11.11",
-    "@noble/post-quantum": "~0.6.1",
-    "@opentelemetry/api": "^1.9",
-    "@opentelemetry/sdk-trace-base": "^2.7",
-    "@scure/base": "~2.2",
-    "@scure/bip39": "~2.2",
-    "@xylabs/geo": "^7.0",
-    "@xylabs/sdk": "^7.0",
-    "@xylabs/threads": "^7.0",
-    "@xyo-network/sdk-js": "^7.0",
-    "@xyo-network/sdk-protocol": "~7.0.4",
-    "ajv": "^8.20",
-    "async-mutex": "^0.5",
-    "cosmiconfig": "^9.0",
-    "debug": "~4.4",
-    "ethers": "^6.16",
-    "hash-wasm": "~4.12",
-    "idb": "^8.0",
-    "lru-cache": "^11.3",
-    "observable-fns": "~0.6",
-    "uuid": "~14.0",
-    "zod": "~4.4"
+    "@ariestools/sdk": "^7.0.8",
+    "@bitauth/libauth": "^3.0.0",
+    "@metamask/json-rpc-engine": "^10.5.0",
+    "@metamask/providers": "^22.1.1",
+    "@metamask/utils": "^11.11.0",
+    "@noble/post-quantum": "^0.6.1",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/sdk-trace-base": "^2.9.0",
+    "@scure/base": "^2.2.0",
+    "@scure/bip39": "^2.2.0",
+    "@xylabs/geo": "^7.0.8",
+    "@xylabs/threads": "^7.0.8",
+    "@xyo-network/sdk": "^7.0.8",
+    "@xyo-network/sdk-protocol": "^7.0.13",
+    "ajv": "^8.20.0",
+    "async-mutex": "^0.5.0",
+    "cosmiconfig": "^9.0.2",
+    "debug": "^4.4.3",
+    "ethers": "^6.17.0",
+    "hash-wasm": "^4.12.0",
+    "idb": "^8.0.3",
+    "lru-cache": "^11.5.1",
+    "observable-fns": "^0.6.1",
+    "uuid": "^14.0.1",
+    "webextension-polyfill": "^0.12.0",
+    "zod": "^4.4.3"
   },
   "engines": {
     "node": ">=22"