@xyo-network/chain-sdk 5.0.0 → 5.0.2

package/dist/browser/modules/ethereum/indexing/RestStakeEventsViewer.d.ts

@@ -1,6 +1,11 @@
 import type { EthAddress } from '@ariestools/sdk';
 import type { StakeEvent, StakeEventFilter, StakeEventName, StakeEventsViewer } from '@xyo-network/xl1-sdk';
 import { AbstractCreatableProvider } from '@xyo-network/xl1-sdk';
+import { z } from 'zod';
+/** Provider-specific settings read from `providerBindings.StakeEventsViewer.options`. */
+export declare const RestStakeEventsViewerOptionsZod: z.ZodObject<{
+    headPollIntervalMs: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
 /**
  * StakeEventsViewer backed by the finalized contract-event index rather than eth_getLogs.
  * Raw indexed logs remain contract-generic; this viewer applies the staking ABI at the edge.
@@ -17,19 +22,29 @@ export declare class RestStakeEventsViewer extends AbstractCreatableProvider imp
     private readonly completeFrames;
     private readonly contractInterface;
     private currentHead?;
+    private headPollIntervalMs;
+    private lastSuccessfulSyncAt?;
     private manifestPromise?;
+    private positionCountCheckpoints;
     private stakeEventCache;
+    private readonly stakeEventsByPosition;
     private syncPromise?;
     private tailFrame?;
     get address(): EthAddress;
     get eventIndexBaseUrl(): string;
     protected get fetchFn(): typeof globalThis.fetch;
+    /** Creates the provider instance after its configuration has resolved. */
+    createHandler(): Promise<void>;
     positionCount(range: [number, number | 'latest']): Promise<number>;
     stakeEvents<TName extends StakeEventName>(range?: [number, number | 'latest'], filter?: StakeEventFilter<TName>): Promise<StakeEvent<TName>[]>;
+    private assertRangeAvailable;
     private decodeIndexedStakeEvents;
     private fetchJson;
     private getManifest;
+    private indexStakeEvents;
     private matchesFilter;
+    private matchingStakeEvents;
+    private positionCountThrough;
     private stakeEventFromLog;
     private sync;
     private syncFromHead;

package/dist/browser/modules/ethereum/indexing/RestStakeEventsViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RestStakeEventsViewer.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ethereum/indexing/RestStakeEventsViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAKjD,OAAO,KAAK,EAEV,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAChE,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,yBAAyB,EAG1B,MAAM,sBAAsB,CAAA;AAK7B;;;;;GAKG;AACH,qBACa,qBAAsB,SAAQ,yBAA0B,YAAW,iBAAiB;IAC/F,MAAM,CAAC,QAAQ,CAAC,eAAe,oBAAoB;IACnD,MAAM,CAAC,QAAQ,CAAC,cAAc,sBAA2B;IACzD,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAK;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,wBAA6B;IACrD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAS;IACzC,OAAO,sBAAuC;IAE9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoD;IACtF,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,eAAe,CAAC,CAAgC;IACxD,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,SAAS,CAAC,CAAoB;IAEtC,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAO9B;IAED,SAAS,KAAK,OAAO,IAAI,OAAO,UAAU,CAAC,KAAK,CAE/C;IAEK,aAAa,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlE,WAAW,CAAC,KAAK,SAAS,cAAc,EAC5C,KAAK,GAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAiB,EAClD,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAC/B,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;IAK/B,OAAO,CAAC,wBAAwB;YAalB,SAAS;YAMT,WAAW;IAUzB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,iBAAiB;YAgBX,IAAI;YAOJ,YAAY;CAmC3B"}
+{"version":3,"file":"RestStakeEventsViewer.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ethereum/indexing/RestStakeEventsViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAKjD,OAAO,KAAK,EAEV,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAChE,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,yBAAyB,EAG1B,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,yFAAyF;AACzF,eAAO,MAAM,+BAA+B;;iBAAiE,CAAA;AAO7G;;;;;GAKG;AACH,qBACa,qBAAsB,SAAQ,yBAA0B,YAAW,iBAAiB;IAC/F,MAAM,CAAC,QAAQ,CAAC,eAAe,oBAAoB;IACnD,MAAM,CAAC,QAAQ,CAAC,cAAc,sBAA2B;IACzD,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAK;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,wBAA6B;IACrD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAS;IACzC,OAAO,sBAAuC;IAE9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwC;IACvE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoD;IACtF,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,kBAAkB,CAAgC;IAC1D,OAAO,CAAC,oBAAoB,CAAC,CAAQ;IACrC,OAAO,CAAC,eAAe,CAAC,CAAgC;IACxD,OAAO,CAAC,wBAAwB,CAAgC;IAChE,OAAO,CAAC,eAAe,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAkC;IACxE,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,SAAS,CAAC,CAAoB;IAEtC,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAO9B;IAED,SAAS,KAAK,OAAO,IAAI,OAAO,UAAU,CAAC,KAAK,CAE/C;IAED,0EAA0E;IAC3D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAUvC,aAAa,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlE,WAAW,CAAC,KAAK,SAAS,cAAc,EAC5C,KAAK,GAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAiB,EAClD,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAC/B,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;IAM/B,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,wBAAwB;YAalB,SAAS;YAMT,WAAW;IASzB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,mBAAmB;IAW3B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,iBAAiB;YAgBX,IAAI;YAcJ,YAAY;CAmC3B"}

package/dist/browser/modules/ethereum/indexing/RestStakeViewer.d.ts

@@ -0,0 +1,60 @@
+import type { Address } from '@ariestools/sdk';
+import type { Position, StakeEventsViewer, StakeViewer } from '@xyo-network/xl1-sdk';
+import { AbstractCreatableProvider } from '@xyo-network/xl1-sdk';
+import { z } from 'zod';
+/** Provider-specific settings read from `providerBindings.StakeViewer.options`. */
+export declare const RestStakeViewerOptionsZod: z.ZodObject<{
+    refreshIntervalMs: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/**
+ * StakeViewer materialized from the finalized REST event index.
+ *
+ * The indexer remains the only process that tails the EVM contract. Consumers
+ * rebuild their local position view from immutable indexed events after the
+ * configured refresh interval, so API replicas never attach EVM log listeners.
+ */
+export declare class RestStakeViewer extends AbstractCreatableProvider implements StakeViewer {
+    static readonly connectionTypes: readonly ["rest"];
+    static readonly defaultMoniker: "StakeViewer";
+    static readonly dependencies: ("StakeEventsViewer" | "ChainContractViewer")[];
+    static readonly monikers: "StakeViewer"[];
+    static readonly surface: "node";
+    readonly moniker: "StakeViewer";
+    private _chainContractViewer;
+    private _stakeEventsViewer;
+    private lastSuccessfulSyncAt?;
+    private positionIndex;
+    private positionsByStaked;
+    private positionsByStaker;
+    private refreshIntervalMs;
+    private syncPromise?;
+    /** Returns the finalized stake-event source used to materialize positions. */
+    get stakeEvents(): StakeEventsViewer;
+    /** Returns active finalized stake positions. */
+    activeStakes(): Promise<Position[]>;
+    /** Creates the provider after its REST binding and dependencies resolve. */
+    createHandler(): Promise<void>;
+    /** Returns the configured chain's withdrawal delay. */
+    minWithdrawalBlocks(): Promise<number>;
+    /** Returns finalized positions that have been removed but not withdrawn. */
+    removedStakes(): Promise<Position[]>;
+    /** Returns the configured rewards contract address. */
+    rewardsContract(): Promise<Address>;
+    /** Returns a finalized position by its contract id. */
+    stakeById(id: number): Promise<Position>;
+    /** Returns a staker's finalized position by its contract slot. */
+    stakeByStaker(staker: Address, slot: number): Promise<Position>;
+    /** Returns finalized positions added for an address in the supplied EVM block range. */
+    stakesByStaked(staked: Address, range?: [number, number | undefined]): Promise<Position[]>;
+    /** Returns finalized positions added by a staker in the supplied EVM block range. */
+    stakesByStaker(staker: Address, range?: [number, number | undefined]): Promise<Position[]>;
+    /** Returns the configured staking-token address. */
+    stakingTokenAddress(): Promise<Address>;
+    /** Returns finalized positions that have completed withdrawal. */
+    withdrawnStakes(): Promise<Position[]>;
+    private applyEvent;
+    private positionsInRange;
+    private rebuildPositionIndex;
+    private sync;
+}
+//# sourceMappingURL=RestStakeViewer.d.ts.map

package/dist/browser/modules/ethereum/indexing/RestStakeViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestStakeViewer.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ethereum/indexing/RestStakeViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,KAAK,EACW,QAAQ,EAA0B,iBAAiB,EAAE,WAAW,EACtF,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,yBAAyB,EAC1B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,mFAAmF;AACnF,eAAO,MAAM,yBAAyB;;iBAAgE,CAAA;AAEtG;;;;;;GAMG;AACH,qBACa,eAAgB,SAAQ,yBAA0B,YAAW,WAAW;IACnF,MAAM,CAAC,QAAQ,CAAC,eAAe,oBAAoB;IACnD,MAAM,CAAC,QAAQ,CAAC,cAAc,gBAAqB;IACnD,MAAM,CAAC,QAAQ,CAAC,YAAY,kDAAyD;IACrF,MAAM,CAAC,QAAQ,CAAC,QAAQ,kBAAuB;IAC/C,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAG,MAAM,CAAS;IACzC,QAAQ,CAAC,OAAO,gBAAiC;IAEjD,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,kBAAkB,CAAoB;IAC9C,OAAO,CAAC,oBAAoB,CAAC,CAAQ;IACrC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,iBAAiB,CAAiC;IAC1D,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,WAAW,CAAC,CAAe;IAEnC,8EAA8E;IAC9E,IAAI,WAAW,IAAI,iBAAiB,CAEnC;IAED,gDAAgD;IAC1C,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKzC,4EAA4E;IAC7D,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7C,uDAAuD;IACjD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5C,4EAA4E;IACtE,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK1C,uDAAuD;IACjD,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzC,uDAAuD;IACjD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK9C,kEAAkE;IAC5D,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMrE,wFAAwF;IAClF,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,GAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKhH,qFAAqF;IAC/E,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,GAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKhH,oDAAoD;IAC9C,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC;IAI7C,kEAAkE;IAC5D,eAAe,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAK5C,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,oBAAoB;YAoBd,IAAI;CAcnB"}

package/dist/browser/modules/ethereum/indexing/index.d.ts

@@ -1,2 +1,3 @@
 export * from './RestStakeEventsViewer.js';
+export * from './RestStakeViewer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/browser/modules/ethereum/indexing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ethereum/indexing/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ethereum/indexing/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA"}

package/dist/neutral/ethereum.mjs

@@ -463,14 +463,22 @@ import {
   StakeEventsViewerMoniker
 } from "@xyo-network/xl1-sdk";
 import { Interface } from "ethers";
+import { z } from "zod";
 var STAKE_EVENT_NAMES = /* @__PURE__ */ new Set(["StakeAdded", "StakeRemoved", "StakeWithdrawn"]);
+var DEFAULT_HEAD_POLL_INTERVAL_MS = 5e3;
+var MIN_HEAD_POLL_INTERVAL_MS = 5e3;
+var RestStakeEventsViewerOptionsZod = z.object({ headPollIntervalMs: z.coerce.number().optional() });
 var RestStakeEventsViewer = class extends AbstractCreatableProvider {
   moniker = RestStakeEventsViewer.defaultMoniker;
   completeFrames = /* @__PURE__ */ new Map();
   contractInterface = new Interface(IAddressStakingEvents__factory.abi);
   currentHead;
+  headPollIntervalMs = DEFAULT_HEAD_POLL_INTERVAL_MS;
+  lastSuccessfulSyncAt;
   manifestPromise;
+  positionCountCheckpoints = [];
   stakeEventCache = [];
+  stakeEventsByPosition = /* @__PURE__ */ new Map();
   syncPromise;
   tailFrame;
   get address() {
@@ -487,13 +495,34 @@ var RestStakeEventsViewer = class extends AbstractCreatableProvider {
   get fetchFn() {
     return this.context.fetchFn ?? fetch.bind(globalThis);
   }
+  /** Creates the provider instance after its configuration has resolved. */
+  async createHandler() {
+    await super.createHandler();
+    RestStakeEventsViewer.requireBoundConnection(this.config);
+    const { headPollIntervalMs } = RestStakeEventsViewerOptionsZod.parse(this.config.options);
+    if (headPollIntervalMs !== void 0) {
+      assertEx5(headPollIntervalMs >= MIN_HEAD_POLL_INTERVAL_MS, () => `headPollIntervalMs must be at least ${MIN_HEAD_POLL_INTERVAL_MS}ms`);
+    }
+    this.headPollIntervalMs = headPollIntervalMs ?? DEFAULT_HEAD_POLL_INTERVAL_MS;
+  }
   async positionCount(range) {
-    const events = await this.stakeEvents(range);
-    return Math.max(-1, ...events.map((event) => event.args.id)) + 1;
+    await this.sync();
+    this.assertRangeAvailable(range);
+    if (range[0] === 0) return this.positionCountThrough(range[1]);
+    const events = this.matchingStakeEvents(range);
+    return events.reduce((max, event) => Math.max(max, event.args.id), -1) + 1;
   }
   async stakeEvents(range = [0, "latest"], filter) {
     await this.sync();
-    return this.stakeEventCache.filter((event) => this.matchesFilter(event, range, filter));
+    this.assertRangeAvailable(range);
+    return this.matchingStakeEvents(range, filter);
+  }
+  assertRangeAvailable(range) {
+    const head = assertEx5(this.currentHead, () => "EVM event index head is unavailable");
+    assertEx5(
+      range[1] === "latest" || range[1] <= head.block,
+      () => `Stake-event range ends at ${range[1]}, beyond EVM event index head ${head.block}`
+    );
   }
   decodeIndexedStakeEvents() {
     const frames = [...this.completeFrames.entries()].sort(([a], [b]) => a - b).map(([, frame]) => frame);
@@ -516,6 +545,21 @@ var RestStakeEventsViewer = class extends AbstractCreatableProvider {
     })();
     return await this.manifestPromise;
   }
+  indexStakeEvents(events) {
+    this.stakeEventCache = events;
+    this.positionCountCheckpoints = [];
+    this.stakeEventsByPosition.clear();
+    let maxPositionId = -1;
+    for (const event of events) {
+      const positionEvents = this.stakeEventsByPosition.get(event.args.id) ?? [];
+      positionEvents.push(event);
+      this.stakeEventsByPosition.set(event.args.id, positionEvents);
+      if (event.args.id > maxPositionId) {
+        maxPositionId = event.args.id;
+        this.positionCountCheckpoints.push({ count: maxPositionId + 1, time: event.time });
+      }
+    }
+  }
   // eslint-disable-next-line complexity
   matchesFilter(event, range, filter) {
     if (range[1] !== "latest" && event.time > range[1]) return false;
@@ -526,6 +570,25 @@ var RestStakeEventsViewer = class extends AbstractCreatableProvider {
     if (isDefined3(filter?.args?.staker) && event.args.staker !== filter.args.staker) return false;
     return true;
   }
+  matchingStakeEvents(range, filter) {
+    const positionId = filter?.args?.id;
+    const candidates = isDefined3(positionId) ? this.stakeEventsByPosition.get(positionId) ?? [] : this.stakeEventCache;
+    return candidates.filter((event) => this.matchesFilter(event, range, filter));
+  }
+  positionCountThrough(end) {
+    if (end === "latest") return this.positionCountCheckpoints.at(-1)?.count ?? 0;
+    let low = 0;
+    let high = this.positionCountCheckpoints.length;
+    while (low < high) {
+      const middle = Math.floor((low + high) / 2);
+      if (this.positionCountCheckpoints[middle].time <= end) {
+        low = middle + 1;
+      } else {
+        high = middle;
+      }
+    }
+    return this.positionCountCheckpoints[low - 1]?.count ?? 0;
+  }
   stakeEventFromLog(log) {
     const parsed = this.contractInterface.parseLog({ data: log.data, topics: log.topics });
     if (parsed === null || !STAKE_EVENT_NAMES.has(parsed.name)) return;
@@ -542,7 +605,12 @@ var RestStakeEventsViewer = class extends AbstractCreatableProvider {
     };
   }
   async sync() {
-    this.syncPromise ??= this.syncFromHead().finally(() => {
+    const now = Date.now();
+    const elapsed = this.lastSuccessfulSyncAt === void 0 ? void 0 : now - this.lastSuccessfulSyncAt;
+    if (this.currentHead !== void 0 && elapsed !== void 0 && elapsed >= 0 && elapsed < this.headPollIntervalMs) return;
+    this.syncPromise ??= this.syncFromHead().then(() => {
+      this.lastSuccessfulSyncAt = Date.now();
+    }).finally(() => {
       this.syncPromise = void 0;
     });
     await this.syncPromise;
@@ -573,7 +641,7 @@ var RestStakeEventsViewer = class extends AbstractCreatableProvider {
       assertEx5(this.tailFrame.fromBlock === tailStart, () => "EVM event index tail starts at the wrong block");
       assertEx5(this.tailFrame.toBlock === head.block, () => "EVM event index tail is stale relative to its head");
     }
-    this.stakeEventCache = this.decodeIndexedStakeEvents();
+    this.indexStakeEvents(this.decodeIndexedStakeEvents());
     this.currentHead = head;
   }
 };
@@ -586,8 +654,157 @@ RestStakeEventsViewer = __decorateClass([
   creatableProvider()
 ], RestStakeEventsViewer);
 
+// src/modules/ethereum/indexing/RestStakeViewer.ts
+import { assertEx as assertEx6, toAddress as toAddress3 } from "@ariestools/sdk";
+import {
+  AbstractCreatableProvider as AbstractCreatableProvider2,
+  ChainContractViewerMoniker,
+  creatableProvider as creatableProvider2,
+  StakeEventsViewerMoniker as StakeEventsViewerMoniker2,
+  StakeViewerMoniker
+} from "@xyo-network/xl1-sdk";
+import { z as z2 } from "zod";
+var DEFAULT_REFRESH_INTERVAL_MS = 5e3;
+var MIN_REFRESH_INTERVAL_MS = 5e3;
+var RestStakeViewerOptionsZod = z2.object({ refreshIntervalMs: z2.coerce.number().optional() });
+var RestStakeViewer = class extends AbstractCreatableProvider2 {
+  moniker = RestStakeViewer.defaultMoniker;
+  _chainContractViewer;
+  _stakeEventsViewer;
+  lastSuccessfulSyncAt;
+  positionIndex = /* @__PURE__ */ new Map();
+  positionsByStaked = /* @__PURE__ */ new Map();
+  positionsByStaker = /* @__PURE__ */ new Map();
+  refreshIntervalMs = DEFAULT_REFRESH_INTERVAL_MS;
+  syncPromise;
+  /** Returns the finalized stake-event source used to materialize positions. */
+  get stakeEvents() {
+    return this._stakeEventsViewer;
+  }
+  /** Returns active finalized stake positions. */
+  async activeStakes() {
+    await this.sync();
+    return this.positionIndex.values().filter((position) => position.removeBlock === 0 && position.withdrawBlock === 0).toArray();
+  }
+  /** Creates the provider after its REST binding and dependencies resolve. */
+  async createHandler() {
+    await super.createHandler();
+    RestStakeViewer.requireBoundConnection(this.config);
+    const { refreshIntervalMs } = RestStakeViewerOptionsZod.parse(this.config.options);
+    if (refreshIntervalMs !== void 0) {
+      assertEx6(refreshIntervalMs >= MIN_REFRESH_INTERVAL_MS, () => `refreshIntervalMs must be at least ${MIN_REFRESH_INTERVAL_MS}ms`);
+    }
+    this.refreshIntervalMs = refreshIntervalMs ?? DEFAULT_REFRESH_INTERVAL_MS;
+    this._chainContractViewer = await this.locator.getInstance(ChainContractViewerMoniker);
+    this._stakeEventsViewer = await this.locator.getInstance(StakeEventsViewerMoniker2);
+  }
+  /** Returns the configured chain's withdrawal delay. */
+  async minWithdrawalBlocks() {
+    return await this._chainContractViewer.minWithdrawalBlocks();
+  }
+  /** Returns finalized positions that have been removed but not withdrawn. */
+  async removedStakes() {
+    await this.sync();
+    return this.positionIndex.values().filter((position) => position.removeBlock !== 0 && position.withdrawBlock === 0).toArray();
+  }
+  /** Returns the configured rewards contract address. */
+  async rewardsContract() {
+    return toAddress3(await this._chainContractViewer.rewardsContract());
+  }
+  /** Returns a finalized position by its contract id. */
+  async stakeById(id) {
+    await this.sync();
+    return assertEx6(this.positionIndex.get(id), () => `RestStakeViewer: position ${id} not found in finalized event index`);
+  }
+  /** Returns a staker's finalized position by its contract slot. */
+  async stakeByStaker(staker, slot) {
+    await this.sync();
+    const position = this.positionsByStaker.get(toAddress3(staker))?.at(slot);
+    return assertEx6(position, () => `RestStakeViewer: staker ${staker} has no finalized position at slot ${slot}`);
+  }
+  /** Returns finalized positions added for an address in the supplied EVM block range. */
+  async stakesByStaked(staked, range = [0, void 0]) {
+    await this.sync();
+    return this.positionsInRange(this.positionsByStaked.get(toAddress3(staked)) ?? [], range);
+  }
+  /** Returns finalized positions added by a staker in the supplied EVM block range. */
+  async stakesByStaker(staker, range = [0, void 0]) {
+    await this.sync();
+    return this.positionsInRange(this.positionsByStaker.get(toAddress3(staker)) ?? [], range);
+  }
+  /** Returns the configured staking-token address. */
+  async stakingTokenAddress() {
+    return toAddress3(await this._chainContractViewer.stakingTokenAddress());
+  }
+  /** Returns finalized positions that have completed withdrawal. */
+  async withdrawnStakes() {
+    await this.sync();
+    return this.positionIndex.values().filter((position) => position.removeBlock !== 0 && position.withdrawBlock !== 0).toArray();
+  }
+  applyEvent(index, event) {
+    if (event.name === "StakeAdded") {
+      index.set(event.args.id, {
+        id: event.args.id,
+        staked: toAddress3(event.args.staked),
+        staker: toAddress3(event.args.staker),
+        amount: event.args.amount,
+        addBlock: event.time,
+        removeBlock: 0,
+        withdrawBlock: 0
+      });
+      return;
+    }
+    const position = assertEx6(index.get(event.args.id), () => `RestStakeViewer: ${event.name} precedes StakeAdded for position ${event.args.id}`);
+    index.set(event.args.id, {
+      ...position,
+      ...event.name === "StakeRemoved" ? { removeBlock: event.time } : { withdrawBlock: event.time }
+    });
+  }
+  positionsInRange(positions, range) {
+    const [fromBlock, configuredToBlock] = range;
+    const toBlock = configuredToBlock ?? Number.MAX_SAFE_INTEGER;
+    return positions.filter((position) => position.addBlock >= fromBlock && position.addBlock <= toBlock);
+  }
+  rebuildPositionIndex(events) {
+    const positionIndex = /* @__PURE__ */ new Map();
+    for (const event of events.toSorted((left, right) => left.time - right.time)) {
+      this.applyEvent(positionIndex, event);
+    }
+    const positionsByStaked = /* @__PURE__ */ new Map();
+    const positionsByStaker = /* @__PURE__ */ new Map();
+    for (const position of positionIndex.values().toArray().toSorted((left, right) => left.id - right.id)) {
+      const staked = toAddress3(position.staked);
+      const staker = toAddress3(position.staker);
+      positionsByStaked.set(staked, [...positionsByStaked.get(staked) ?? [], position]);
+      positionsByStaker.set(staker, [...positionsByStaker.get(staker) ?? [], position]);
+    }
+    this.positionIndex = positionIndex;
+    this.positionsByStaked = positionsByStaked;
+    this.positionsByStaker = positionsByStaker;
+  }
+  async sync() {
+    const now = Date.now();
+    const elapsed = this.lastSuccessfulSyncAt === void 0 ? void 0 : now - this.lastSuccessfulSyncAt;
+    if (elapsed !== void 0 && elapsed >= 0 && elapsed < this.refreshIntervalMs) return;
+    this.syncPromise ??= Promise.resolve(this.stakeEvents.stakeEvents([0, "latest"])).then((events) => this.rebuildPositionIndex(events)).then(() => {
+      this.lastSuccessfulSyncAt = Date.now();
+    }).finally(() => {
+      this.syncPromise = void 0;
+    });
+    await this.syncPromise;
+  }
+};
+__publicField(RestStakeViewer, "connectionTypes", ["rest"]);
+__publicField(RestStakeViewer, "defaultMoniker", StakeViewerMoniker);
+__publicField(RestStakeViewer, "dependencies", [ChainContractViewerMoniker, StakeEventsViewerMoniker2]);
+__publicField(RestStakeViewer, "monikers", [StakeViewerMoniker]);
+__publicField(RestStakeViewer, "surface", "node");
+RestStakeViewer = __decorateClass([
+  creatableProvider2()
+], RestStakeViewer);
+
 // src/modules/ethereum/providers/AbstractEvmRunner.ts
-import { assertEx as assertEx6 } from "@ariestools/sdk";
+import { assertEx as assertEx7 } from "@ariestools/sdk";
 import { AbstractEvmProvider } from "@xyo-network/xl1-sdk";
 function evmContractRunnerHandleKey(moniker) {
   return `evm-contract-runner:${moniker}`;
@@ -595,7 +812,7 @@ function evmContractRunnerHandleKey(moniker) {
 var AbstractEvmRunner = class extends AbstractEvmProvider {
   _runner;
   get runner() {
-    return assertEx6(this._runner, () => "EVM contract runner not initialized");
+    return assertEx7(this._runner, () => "EVM contract runner not initialized");
   }
   /** Creates the provider instance after its dependencies and configuration have resolved. */
   async createHandler() {
@@ -611,7 +828,7 @@ var AbstractEvmRunner = class extends AbstractEvmProvider {
 import { toEthAddress as toEthAddress5 } from "@ariestools/sdk";
 import { IStakedXyoChain__factory } from "@xyo-network/typechain";
 import {
-  creatableProvider as creatableProvider2,
+  creatableProvider as creatableProvider3,
   StakeRunnerMoniker
 } from "@xyo-network/xl1-sdk";
 import { getAddress } from "ethers/address";
@@ -642,13 +859,16 @@ __publicField(EvmStakeRunner, "dependencies", []);
 __publicField(EvmStakeRunner, "monikers", [StakeRunnerMoniker]);
 __publicField(EvmStakeRunner, "surface", "node");
 EvmStakeRunner = __decorateClass([
-  creatableProvider2()
+  creatableProvider3()
 ], EvmStakeRunner);
 export {
   AbstractEvmRunner,
   BaseEthProvider,
   EvmStakeRunner,
   RestStakeEventsViewer,
+  RestStakeEventsViewerOptionsZod,
+  RestStakeViewer,
+  RestStakeViewerOptionsZod,
   blockRangeChunks,
   calculateEthBlockRate,
   calculateEthTimeRate,