@xyo-network/xl1-protocol-sdk 1.15.27 → 1.15.28

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

@@ -6,8 +6,6 @@ export * from './Fees.ts';
 export * from './modifiers/index.ts';
 export * from './Object.ts';
 export * from './Payload.ts';
-export * from './ShiftedBigIntConfig.ts';
 export * from './Signature.ts';
 export * from './transaction/index.ts';
-export * from './XL1Amount.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/instances/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/instances/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA"}

package/dist/neutral/model/ChainContext/ChainContext.d.ts

@@ -1,14 +1,24 @@
+import type { Logger } from '@xylabs/logger';
+import type { MapType } from '../../map/index.ts';
 import type { ChainIdentity } from '../ChainIdentity.ts';
 import type { ChainStakeContext, ChainStakeContextRead, ChainStakeContextWrite } from './ChainStakeContext.ts';
 import type { ChainStateContextRead, ChainStateContextWrite } from './ChainStateContext.ts';
 import type { ChainStoreContext, ChainStoreContextRead, ChainStoreContextWrite } from './ChainStoreContext.ts';
-export interface ChainContextWrite extends ChainIdentity, ChainStateContextWrite, ChainStoreContextWrite {
+export interface BaseContext<TCacheValue = string | object | number | bigint> {
+    caches?: Record<string, MapType<string, TCacheValue>>;
+    logger?: Logger;
 }
-export interface StakedChainContextWrite extends ChainContextWrite, ChainStakeContextWrite {
+export declare function contextCache<TCacheValue>(context: BaseContext<TCacheValue | unknown>, name: string, create?: () => MapType<string, TCacheValue>): MapType<string, TCacheValue>;
+export declare function withContextCacheResponse<T extends {} | string | number | bigint>(context: BaseContext, name: string, key: string, func: () => Promise<T extends {} | string | number | bigint ? T : never>, options?: {
+    max?: number;
+}): Promise<T>;
+export interface ChainContextWrite extends BaseContext, ChainIdentity, ChainStateContextWrite, ChainStoreContextWrite {
 }
-export interface ChainContextRead extends ChainIdentity, ChainStateContextRead, ChainStoreContextRead {
+export interface StakedChainContextWrite extends BaseContext, ChainContextWrite, ChainStakeContextWrite {
 }
-export interface StakedChainContextRead extends ChainContextRead, ChainStakeContextRead {
+export interface ChainContextRead extends BaseContext, ChainIdentity, ChainStateContextRead, ChainStoreContextRead {
+}
+export interface StakedChainContextRead extends BaseContext, ChainContextRead, ChainStakeContextRead {
 }
 export type ChainContext = ChainIdentity & ChainContextRead & ChainContextWrite & ChainStoreContext;
 export type StakedChainContext = ChainContext & ChainStakeContext & ChainStakeContextRead & ChainStakeContextWrite;

package/dist/neutral/model/ChainContext/ChainContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainContext.d.ts","sourceRoot":"","sources":["../../../../src/model/ChainContext/ChainContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EACV,iBAAiB,EAAE,qBAAqB,EAAE,sBAAsB,EACjE,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,KAAK,EACV,iBAAiB,EAAE,qBAAqB,EAAE,sBAAsB,EACjE,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,iBAAkB,SAAQ,aAAa,EAAE,sBAAsB,EAAE,sBAAsB;CAAG;AAE3G,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB,EAAE,sBAAsB;CAAG;AAE7F,MAAM,WAAW,gBAAiB,SAAQ,aAAa,EAAE,qBAAqB,EAAE,qBAAqB;CAAG;AAExG,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB,EAAE,qBAAqB;CAAG;AAE1F,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAA;AAEnG,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAA"}
+{"version":3,"file":"ChainContext.d.ts","sourceRoot":"","sources":["../../../../src/model/ChainContext/ChainContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAI5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EACV,iBAAiB,EAAE,qBAAqB,EAAE,sBAAsB,EACjE,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,KAAK,EACV,iBAAiB,EAAE,qBAAqB,EAAE,sBAAsB,EACjE,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,WAAW,CAAC,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,YAAY,CAAC,WAAW,EACtC,OAAO,EAAE,WAAW,CAAC,WAAW,GAAG,OAAO,CAAC,EAC3C,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,GAC1C,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAQ9B;AAED,wBAAsB,wBAAwB,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,EACpF,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,SAAS,EAAE,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,EACxE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,CAAC,CAAC,CAaZ;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW,EAAE,aAAa,EAAE,sBAAsB,EAAE,sBAAsB;CAAG;AAExH,MAAM,WAAW,uBAAwB,SAAQ,WAAW,EAAE,iBAAiB,EAAE,sBAAsB;CAAG;AAE1G,MAAM,WAAW,gBAAiB,SAAQ,WAAW,EAAE,aAAa,EAAE,qBAAqB,EAAE,qBAAqB;CAAG;AAErH,MAAM,WAAW,sBAAuB,SAAQ,WAAW,EAAE,gBAAgB,EAAE,qBAAqB;CAAG;AAEvG,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,iBAAiB,CAAA;AAEnG,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAA"}

package/dist/neutral/model/ChainContext/ChainStateContext.d.ts

@@ -1,7 +1,7 @@
 import type { Hash } from '@xylabs/hex';
 import type { Promisable } from '@xylabs/promise';
 export interface ChainStateContextRead {
-    head(): Promisable<Hash>;
+    head(): Promisable<[Hash, number]>;
 }
 export interface ChainStateContextWrite {
 }

package/dist/neutral/model/ChainContext/ChainStateContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainStateContext.d.ts","sourceRoot":"","sources":["../../../../src/model/ChainContext/ChainStateContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,qBAAqB;IACpC,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAA"}
+{"version":3,"file":"ChainStateContext.d.ts","sourceRoot":"","sources":["../../../../src/model/ChainContext/ChainStateContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,qBAAqB;IACpC,IAAI,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,sBAAsB;CAAG;AAE1C,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,GAAG,sBAAsB,CAAA"}

package/dist/neutral/model/ChainStake/ChainStakeRead.d.ts

@@ -1,17 +1,17 @@
 import type { Address } from '@xylabs/hex';
 import type { Promisable } from '@xylabs/promise';
-import type { Stake } from '@xyo-network/xl1-protocol';
+import type { Position } from '@xyo-network/xl1-protocol';
 export interface ChainStakeRead {
-    active(): Promisable<bigint>;
-    activeByAddressStaked(address: string): Promisable<bigint>;
-    activeByStaker(address: string): Promisable<bigint>;
-    pending(): Promisable<bigint>;
-    pendingByStaker(staker: string): Promisable<bigint>;
-    stakeById(id: number): Promisable<Stake>;
-    stakeByStaker(staker: Address, slot: number): Promisable<Stake>;
-    stakesByStaked(staked: Address, range?: [number, number | 'latest']): Promisable<Stake[]>;
-    stakesByStaker(staker: Address, range?: [number, number | 'latest']): Promisable<Stake[]>;
-    withdrawn(): Promisable<bigint>;
-    withdrawnByStaker(staker: string): Promisable<bigint>;
+    active(time?: number): Promisable<bigint>;
+    activeByAddressStaked(address: string, time?: number): Promisable<bigint>;
+    activeByStaker(address: string, time?: number): Promisable<bigint>;
+    pending(time?: number): Promisable<bigint>;
+    pendingByStaker(staker: string, time?: number): Promisable<bigint>;
+    stakeById(id: number, time?: number): Promisable<Position>;
+    stakeByStaker(staker: Address, slot: number, time?: number): Promisable<Position>;
+    stakesByStaked(staked: Address, range?: [number, number | undefined]): Promisable<Position[]>;
+    stakesByStaker(staker: Address, range?: [number, number | undefined]): Promisable<Position[]>;
+    withdrawn(time?: number): Promisable<bigint>;
+    withdrawnByStaker(staker: string, time?: number): Promisable<bigint>;
 }
 //# sourceMappingURL=ChainStakeRead.d.ts.map

package/dist/neutral/model/ChainStake/ChainStakeRead.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainStakeRead.d.ts","sourceRoot":"","sources":["../../../../src/model/ChainStake/ChainStakeRead.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AAEtD,MAAM,WAAW,cAAc;IAC7B,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IAC5B,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAC1D,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACnD,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IAC7B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACnD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IACxC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IAC/D,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAA;IACzF,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAA;IACzF,SAAS,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;IAC/B,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;CACtD"}
+{"version":3,"file":"ChainStakeRead.d.ts","sourceRoot":"","sources":["../../../../src/model/ChainStake/ChainStakeRead.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAEzD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACzC,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACzE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAClE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAC1C,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAClE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC1D,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjF,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC7F,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC7F,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IAC5C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;CACrE"}

package/dist/neutral/model/StakeEvents.d.ts

@@ -26,6 +26,7 @@ export interface StakeEvent<TName extends StakeEventName = StakeEventName> exten
     args: StakeEventArgs;
 }
 export interface StakeEventsRead {
+    positionCount(range: [number, number | 'latest']): Promisable<number>;
     stakeEvents<TName extends StakeEventName>(range: [number, number | 'latest'], filter?: StakeEventFilter<TName>): Promisable<StakeEvent<TName>[]>;
 }
 //# sourceMappingURL=StakeEvents.d.ts.map

package/dist/neutral/model/StakeEvents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StakeEvents.d.ts","sourceRoot":"","sources":["../../../src/model/StakeEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,eAAO,MAAM,eAAe,2DAA4D,CAAA;AACxF,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAA;AAE3D,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,SAAS,UAAU,GAAG,EAAE;IACzF,IAAI,EAAE,KAAK,CAAA;IACX,IAAI,EAAE,KAAK,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACxD,IAAI,CAAC,EAAE,KAAK,CAAA;IACZ,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAA;AAE5F,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,WAAW,CAAC,KAAK,CAAC;IACzG,IAAI,CAAC,EAAE,oBAAoB,CAAA;CAC5B;AAED,MAAM,WAAW,UAAU,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,aAAa,CAAC,KAAK,CAAC;IACrG,IAAI,EAAE,cAAc,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,KAAK,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;CACjJ"}
+{"version":3,"file":"StakeEvents.d.ts","sourceRoot":"","sources":["../../../src/model/StakeEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,eAAO,MAAM,eAAe,2DAA4D,CAAA;AACxF,MAAM,MAAM,cAAc,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAA;AAE3D,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,KAAK,SAAS,UAAU,GAAG,EAAE;IACzF,IAAI,EAAE,KAAK,CAAA;IACX,IAAI,EAAE,KAAK,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM;IACxD,IAAI,CAAC,EAAE,KAAK,CAAA;IACZ,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAA;AAE5F,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,WAAW,CAAC,KAAK,CAAC;IACzG,IAAI,CAAC,EAAE,oBAAoB,CAAA;CAC5B;AAED,MAAM,WAAW,UAAU,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,aAAa,CAAC,KAAK,CAAC;IACrG,IAAI,EAAE,cAAc,CAAA;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAA;IACrE,WAAW,CAAC,KAAK,SAAS,cAAc,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;CACjJ"}

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

@@ -1,5 +1,6 @@
 export * from './readPayloadMapFromStore.ts';
 export * from './step/index.ts';
 export * from './summary/index.ts';
+export * from './timeBudget.ts';
 export * from './transaction/index.ts';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/neutral/primitives/timeBudget.d.ts

@@ -0,0 +1,3 @@
+import { type Logger } from '@xylabs/logger';
+export declare function timeBudget<TResult>(name: string, logger: Logger | undefined, func: () => Promise<TResult>, budget: number): Promise<TResult>;
+//# sourceMappingURL=timeBudget.d.ts.map

package/dist/neutral/primitives/timeBudget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeBudget.d.ts","sourceRoot":"","sources":["../../../src/primitives/timeBudget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE5C,wBAAsB,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlJ"}

package/dist/neutral/transaction/buildUnsignedTransaction.d.ts

@@ -1,5 +1,5 @@
 import type { Address } from '@xylabs/hex';
 import type { Payload } from '@xyo-network/payload-model';
-import type { AllowedBlockPayload, ChainId, TransactionFeesBigInt, UnsignedHydratedTransactionWithHashStorageMeta } from '@xyo-network/xl1-protocol';
-export declare function buildUnsignedTransaction(chain: ChainId, onChainPayloads: AllowedBlockPayload[], offChainPayloads: Payload[], nbf: number, exp: number, from: Address, fees?: TransactionFeesBigInt): Promise<UnsignedHydratedTransactionWithHashStorageMeta>;
+import type { AllowedBlockPayload, ChainId, TransactionFeesBigInt, UnsignedHydratedTransaction } from '@xyo-network/xl1-protocol';
+export declare function buildUnsignedTransaction(chain: ChainId, onChainPayloads: AllowedBlockPayload[], offChainPayloads: Payload[], nbf: number, exp: number, from: Address, fees?: TransactionFeesBigInt): Promise<UnsignedHydratedTransaction>;
 //# sourceMappingURL=buildUnsignedTransaction.d.ts.map

package/dist/neutral/transaction/buildUnsignedTransaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildUnsignedTransaction.d.ts","sourceRoot":"","sources":["../../../src/transaction/buildUnsignedTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAI1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,OAAO,EAGiD,qBAAqB,EAC7E,8CAA8C,EAC/C,MAAM,2BAA2B,CAAA;AAGlC,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,mBAAmB,EAAE,EACtC,gBAAgB,EAAE,OAAO,EAAE,EAC3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,IAAI,GAAE,qBAA8C,GACnD,OAAO,CAAC,8CAA8C,CAAC,CAmCzD"}
+{"version":3,"file":"buildUnsignedTransaction.d.ts","sourceRoot":"","sources":["../../../src/transaction/buildUnsignedTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAI1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EACV,mBAAmB,EAAE,OAAO,EAAwF,qBAAqB,EACzI,2BAA2B,EAC5B,MAAM,2BAA2B,CAAA;AAGlC,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,mBAAmB,EAAE,EACtC,gBAAgB,EAAE,OAAO,EAAE,EAC3B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,EACb,IAAI,GAAE,qBAA8C,GACnD,OAAO,CAAC,2BAA2B,CAAC,CAmCtC"}

package/dist/neutral/transaction/primitives/transactionElevatedPayloads.d.ts

@@ -1,6 +1,6 @@
 import { type Hash } from '@xylabs/hex';
-import type { Payload, WithHashStorageMeta } from '@xyo-network/payload-model';
+import type { Payload, WithHashMeta } from '@xyo-network/payload-model';
 import type { SignedHydratedTransactionWithStorageMeta, TransactionBoundWitness } from '@xyo-network/xl1-protocol';
 export declare function transactionElevatedPayloadHashes(transaction: TransactionBoundWitness): Hash[];
-export declare function transactionElevatedPayloads([transaction, payloads]: SignedHydratedTransactionWithStorageMeta): WithHashStorageMeta<Payload>[];
+export declare function transactionElevatedPayloads([transaction, payloads]: SignedHydratedTransactionWithStorageMeta): WithHashMeta<Payload>[];
 //# sourceMappingURL=transactionElevatedPayloads.d.ts.map

package/dist/neutral/transaction/primitives/transactionElevatedPayloads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transactionElevatedPayloads.d.ts","sourceRoot":"","sources":["../../../../src/transaction/primitives/transactionElevatedPayloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAC9E,OAAO,KAAK,EAAE,wCAAwC,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAIlH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,uBAAuB,GAAG,IAAI,EAAE,CAG7F;AAED,wBAAgB,2BAA2B,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,wCAAwC,GAAG,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAI7I"}
+{"version":3,"file":"transactionElevatedPayloads.d.ts","sourceRoot":"","sources":["../../../../src/transaction/primitives/transactionElevatedPayloads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,IAAI,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EAAE,wCAAwC,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAIlH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,uBAAuB,GAAG,IAAI,EAAE,CAG7F;AAED,wBAAgB,2BAA2B,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,wCAAwC,GAAG,YAAY,CAAC,OAAO,CAAC,EAAE,CAItI"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.15.27",
+  "version": "1.15.28",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -36,38 +36,39 @@
     "src"
   ],
   "dependencies": {
-    "@xylabs/array": "~5.0.17",
-    "@xylabs/arraybuffer": "~5.0.17",
-    "@xylabs/assert": "~5.0.17",
-    "@xylabs/delay": "~5.0.17",
-    "@xylabs/hex": "~5.0.17",
-    "@xylabs/logger": "~5.0.17",
-    "@xylabs/object": "~5.0.17",
-    "@xylabs/promise": "~5.0.17",
-    "@xylabs/telemetry": "~5.0.17",
-    "@xylabs/typeof": "~5.0.17",
-    "@xyo-network/account-model": "~5.1.15",
-    "@xyo-network/archivist-model": "~5.1.15",
-    "@xyo-network/boundwitness-builder": "~5.1.15",
-    "@xyo-network/boundwitness-model": "~5.1.15",
-    "@xyo-network/payload-builder": "~5.1.15",
-    "@xyo-network/payload-model": "~5.1.15",
-    "@xyo-network/wallet": "~5.1.15",
-    "@xyo-network/wallet-model": "~5.1.15",
-    "@xyo-network/xl1-protocol": "~1.12.95",
+    "@xylabs/array": "~5.0.18",
+    "@xylabs/arraybuffer": "~5.0.18",
+    "@xylabs/assert": "~5.0.18",
+    "@xylabs/delay": "~5.0.18",
+    "@xylabs/hex": "~5.0.18",
+    "@xylabs/logger": "~5.0.18",
+    "@xylabs/object": "~5.0.18",
+    "@xylabs/promise": "~5.0.18",
+    "@xylabs/telemetry": "~5.0.18",
+    "@xylabs/typeof": "~5.0.18",
+    "@xyo-network/account-model": "~5.1.17",
+    "@xyo-network/archivist-model": "~5.1.17",
+    "@xyo-network/boundwitness-builder": "~5.1.17",
+    "@xyo-network/boundwitness-model": "~5.1.17",
+    "@xyo-network/payload-builder": "~5.1.17",
+    "@xyo-network/payload-model": "~5.1.17",
+    "@xyo-network/wallet": "~5.1.17",
+    "@xyo-network/wallet-model": "~5.1.17",
+    "@xyo-network/xl1-protocol": "~1.12.102",
     "async-mutex": "~0.5.0",
     "ethers": "~6.15.0",
+    "lru-cache": "^11.2.2",
     "zod": "~4.1.12"
   },
   "devDependencies": {
-    "@types/node": "~24.9.2",
-    "@xylabs/ts-scripts-yarn3": "~7.1.8",
-    "@xylabs/tsconfig": "~7.1.8",
-    "@xyo-network/account": "~5.1.15",
-    "@xyo-network/boundwitness-validator": "~5.1.15",
-    "eslint": "^9.39.0",
+    "@types/node": "~24.10.0",
+    "@xylabs/ts-scripts-yarn3": "~7.2.4",
+    "@xylabs/tsconfig": "~7.2.4",
+    "@xyo-network/account": "~5.1.17",
+    "@xyo-network/boundwitness-validator": "~5.1.17",
+    "eslint": "^9.39.1",
     "typescript": "~5.9.3",
-    "vitest": "~3.2.4"
+    "vitest": "~4.0.7"
   },
   "engines": {
     "node": ">=22.3 <23"

package/src/block/primitives/blockFromBlockNumber.ts

@@ -4,35 +4,38 @@ import type { WithStorageMeta } from '@xyo-network/payload-model'
 import type { BlockBoundWitness, XL1BlockNumber } from '@xyo-network/xl1-protocol'
 import { asBlockBoundWitnessWithStorageMeta, StepSizes } from '@xyo-network/xl1-protocol'
 
-import type { ChainContextRead } from '../../model/index.ts'
+import { type ChainContextRead, withContextCacheResponse } from '../../model/index.ts'
 
 export async function blockFromBlockNumber(context: ChainContextRead, blockNumber: XL1BlockNumber): Promise<WithStorageMeta<BlockBoundWitness>> {
-  const head = await context.head()
-  const result = await context.store.chainMap.get(head)
-  let currentBlock = asBlockBoundWitnessWithStorageMeta(result, () => `Head block not found for hash: ${head}`, { required: true })
-  if (currentBlock.block < blockNumber) {
-    throw new Error(`Error: Block number ${blockNumber} is greater than head ${currentBlock.block}.`)
-  }
-  while (currentBlock.block > blockNumber) {
-    let jumpHash: Hash | null = currentBlock.previous
-    let jumpBlockNumber = currentBlock.block - 1
-    for (const [step, stepSize] of StepSizes.entries()) {
-      const possibleJumpBlockNumber = currentBlock.block - (currentBlock.block % stepSize) - 1
-      if (possibleJumpBlockNumber >= blockNumber && possibleJumpBlockNumber <= jumpBlockNumber) {
-        jumpBlockNumber = possibleJumpBlockNumber
-        jumpHash = asHash(currentBlock.step_hashes.at(step), () => `Step hash not found for step ${step} in block ${currentBlock.block}`)
-      }
-    }
-    const newBlock = await context.store.chainMap.get(
-      asHash(jumpHash, () => `Jump hash not found for block number [${blockNumber}]: ${jumpBlockNumber} ${toSafeJsonString(currentBlock, 10)}`),
-    )
-    currentBlock = asBlockBoundWitnessWithStorageMeta(newBlock, () => `Block not found for hash: ${jumpHash}`, { required: true })
-    if (currentBlock.block === blockNumber) {
-      break
-    }
+  const cacheKey = `${blockNumber}`
+  return await withContextCacheResponse(context, 'blockFromBlockNumber', cacheKey, async () => {
+    const [headHash] = await context.head()
+    const result = await context.store.chainMap.get(headHash)
+    let currentBlock = asBlockBoundWitnessWithStorageMeta(result, () => `Head block not found for hash: ${headHash}`, { required: true })
     if (currentBlock.block < blockNumber) {
-      throw new Error(`Block number ${blockNumber} is not a valid step block number for block ${head}.`)
+      throw new Error(`Error: Block number ${blockNumber} is greater than head ${currentBlock.block}.`)
+    }
+    while (currentBlock.block > blockNumber) {
+      let jumpHash: Hash | null = currentBlock.previous
+      let jumpBlockNumber = currentBlock.block - 1
+      for (const [step, stepSize] of StepSizes.entries()) {
+        const possibleJumpBlockNumber = currentBlock.block - (currentBlock.block % stepSize) - 1
+        if (possibleJumpBlockNumber >= blockNumber && possibleJumpBlockNumber <= jumpBlockNumber) {
+          jumpBlockNumber = possibleJumpBlockNumber
+          jumpHash = asHash(currentBlock.step_hashes.at(step), () => `Step hash not found for step ${step} in block ${currentBlock.block}`)
+        }
+      }
+      const newBlock = await context.store.chainMap.get(
+        asHash(jumpHash, () => `Jump hash not found for block number [${blockNumber}]: ${jumpBlockNumber} ${toSafeJsonString(currentBlock, 10)}`),
+      )
+      currentBlock = asBlockBoundWitnessWithStorageMeta(newBlock, () => `Block not found for hash: ${jumpHash}`, { required: true })
+      if (currentBlock.block === blockNumber) {
+        break
+      }
+      if (currentBlock.block < blockNumber) {
+        throw new Error(`Block number ${blockNumber} is not a valid step block number for block ${headHash}.`)
+      }
     }
-  }
-  return currentBlock
+    return currentBlock
+  })
 }

package/src/block/primitives/index.ts

@@ -3,4 +3,5 @@ export * from './frames/index.ts'
 export * from './hashFromBlockNumber.ts'
 export * from './model.ts'
 export * from './payloads/index.ts'
+export * from './toStepIdentityString.ts'
 export * from './transfers/index.ts'

package/src/block/primitives/toStepIdentityString.ts

@@ -0,0 +1,5 @@
+import type { StepIdentity, StepIdentityString } from '@xyo-network/xl1-protocol'
+
+export function toStepIdentityString({ block, step }: StepIdentity): StepIdentityString {
+  return `${block}|${step}` as StepIdentityString
+}

package/src/block/primitives/transfers/transfersStepSummaryFromRange.ts

@@ -24,7 +24,7 @@ export async function transfersStepSummaryFromRange(
   // console.log(`transfersStepSummaryFromRange: head=${head}, range=${range[0]}-${range[1]}`)
   const frameHeadHash = await hashFromBlockNumber(context, range[1])
   const frameSize = range[1] - range[0] + 1
-  const head = await context.head()
+  const [headHash] = await context.head()
 
   let result: TransfersStepSummary | undefined = undefined
 
@@ -39,7 +39,7 @@ export async function transfersStepSummaryFromRange(
       }
     }
     result = {
-      schema: TransfersStepSummarySchema, hash: head, stepSize: -1, transfers,
+      schema: TransfersStepSummarySchema, hash: headHash, stepSize: -1, transfers,
     }
   } else {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/src/block/primitives/transfers/transfersSummary.ts

@@ -14,8 +14,8 @@ export async function transfersSummary(
   context: TransfersStepSummaryContext,
 ): Promise<Partial<Record<Address, Partial<Record<Address, bigint>>>>> {
   return await spanRootAsync('transferSummary', async () => {
-    const head = await context.head()
-    const headResult = await context.store.chainMap.get(head)
+    const [headHash] = await context.head()
+    const headResult = await context.store.chainMap.get(headHash)
     const headBoundWitness = asBlockBoundWitnessWithStorageMeta(headResult, () => `Head block not found for hash: ${context.head}`, { required: true })
     const rangeStart = asXL1BlockNumber(isDefined(context.windowSize) ? Math.max(headBoundWitness.block - context.windowSize + 1, 0) : 0)
     const ranges = deepCalculateFramesFromRange([rangeStart, asXL1BlockNumber(headBoundWitness.block)])

package/src/driver/cache/LruCacheMap.ts

@@ -0,0 +1,42 @@
+import { LRUCache } from 'lru-cache'
+
+import type { SynchronousMap } from '../../map/index.ts'
+
+export class LruCacheMap<K extends {}, V extends {} | string | number | bigint, FC = () => void> implements SynchronousMap<K, V> {
+  private lruCache: LRUCache<K, V, FC>
+
+  constructor(options?: LRUCache.Options<K, V, FC>) {
+    this.lruCache = new LRUCache<K, V, FC>(options ?? { max: 5000 })
+  }
+
+  clear(): void {
+    this.lruCache.clear()
+  }
+
+  delete(id: K): boolean {
+    return this.lruCache.delete(id)
+  }
+
+  get(id: K): V | undefined {
+    return this.lruCache.get(id)
+  }
+
+  getMany(id: K[]): V[] {
+    const results: V[] = []
+    for (const key of id) {
+      const value = this.lruCache.get(key)
+      if (value !== undefined) {
+        results.push(value)
+      }
+    }
+    return results
+  }
+
+  has(id: K): boolean {
+    return this.lruCache.has(id)
+  }
+
+  set(id: K, data: V) {
+    this.lruCache.set(id, data)
+  }
+}

package/src/driver/cache/index.ts

@@ -0,0 +1 @@
+export * from './LruCacheMap.ts'

package/src/driver/index.ts

@@ -0,0 +1,2 @@
+export * from './cache/index.ts'
+export * from './memory/index.ts'

package/src/driver/memory/MemoryMap.ts

@@ -0,0 +1,42 @@
+import { isDefined } from '@xylabs/typeof'
+
+import type { SynchronousMap } from '../../map/index.ts'
+
+export class MemoryMap<K extends {}, V = {}> implements SynchronousMap<K, V> {
+  private map: Map<K, V>
+
+  constructor() {
+    this.map = new Map<K, V>()
+  }
+
+  clear(): void {
+    this.map.clear()
+  }
+
+  delete(id: K): boolean {
+    return this.map.delete(id)
+  }
+
+  get(id: K): V | undefined {
+    return this.map.get(id)
+  }
+
+  getMany(ids: K[]): V[] {
+    const results: V[] = []
+    for (const id of ids) {
+      const data = this.map.get(id)
+      if (isDefined(data)) {
+        results.push(data)
+      }
+    }
+    return results
+  }
+
+  has(id: K): boolean {
+    return this.map.has(id)
+  }
+
+  set(id: K, data: V) {
+    this.map.set(id, data)
+  }
+}

package/src/driver/memory/index.ts

@@ -0,0 +1 @@
+export * from './MemoryMap.ts'

package/src/eip-712/Payloads/EIP712Data.ts

@@ -13,30 +13,11 @@ export const EIP712DataPayloadFieldsZod = z.object({
 })
 export type EIP712DataPayloadFields = z.infer<typeof EIP712DataPayloadFieldsZod>
 
-/**
- * @deprecated Use EIP712DataPayloadFields instead
- */
-export type EIP712PayloadFields = EIP712DataPayloadFields
-
 export const EIP712DataPayloadSchema = 'network.xyo.chains.ethereum.eip712.data' as const
 export type EIP712DataPayloadSchema = typeof EIP712DataPayloadSchema
 
-/**
- * @deprecated Use EIP712DataPayloadSchema instead
- */
-export const EIP712PayloadSchema = EIP712DataPayloadSchema
-/**
- * @deprecated Use EIP712DataPayloadSchema instead
- */
-export type EIP712PayloadSchema = typeof EIP712DataPayloadSchema
-
 export type EIP712DataPayload = Payload<EIP712DataPayloadFields, EIP712DataPayloadSchema>
 
-/**
- * @deprecated Use EIP712DataPayload instead
- */
-export type EIP712Payload = EIP712DataPayload
-
 export const isEIP712DataPayload = isPayloadOfZodType<EIP712DataPayload>(
   EIP712DataPayloadFieldsZod,
   EIP712DataPayloadSchema,

package/src/index.ts

@@ -1,8 +1,8 @@
 export * from './block/index.ts'
-export * from './ChainServiceCollection.ts'
 export * from './ChainServiceCollectionV2.ts'
 export * from './config/index.ts'
 export * from './constants.ts'
+export * from './driver/index.ts'
 export * from './eip-712/index.ts'
 export * from './instances/index.ts'
 export * from './map/index.ts'
@@ -10,7 +10,6 @@ export * from './model/index.ts'
 export * from './multipliers.ts'
 export * from './payloads/index.ts'
 export * from './primitives/index.ts'
-export * from './primitives/index.ts'
 export * from './SignedBigInt.ts'
 export * from './time/index.ts'
 export * from './transaction/index.ts'

package/src/instances/index.ts

@@ -6,7 +6,5 @@ export * from './Fees.ts'
 export * from './modifiers/index.ts'
 export * from './Object.ts'
 export * from './Payload.ts'
-export * from './ShiftedBigIntConfig.ts'
 export * from './Signature.ts'
 export * from './transaction/index.ts'
-export * from './XL1Amount.ts'

package/src/model/ChainContext/ChainContext.ts

@@ -1,3 +1,8 @@
+import type { Logger } from '@xylabs/logger'
+import { isDefined, isUndefined } from '@xylabs/typeof'
+
+import { LruCacheMap, MemoryMap } from '../../driver/index.ts'
+import type { MapType } from '../../map/index.ts'
 import type { ChainIdentity } from '../ChainIdentity.ts'
 import type {
   ChainStakeContext, ChainStakeContextRead, ChainStakeContextWrite,
@@ -7,13 +12,53 @@ import type {
   ChainStoreContext, ChainStoreContextRead, ChainStoreContextWrite,
 } from './ChainStoreContext.ts'
 
-export interface ChainContextWrite extends ChainIdentity, ChainStateContextWrite, ChainStoreContextWrite {}
+export interface BaseContext<TCacheValue = string | object | number | bigint> {
+  caches?: Record<string, MapType<string, TCacheValue>>
+  logger?: Logger
+}
+
+export function contextCache<TCacheValue>(
+  context: BaseContext<TCacheValue | unknown>,
+  name: string,
+  create?: () => MapType<string, TCacheValue>,
+): MapType<string, TCacheValue> {
+  if (!context.caches) {
+    context.caches = {}
+  }
+  if (isUndefined(context.caches[name])) {
+    context.caches[name] = create?.() ?? new MemoryMap<string, TCacheValue>()
+  }
+  return context.caches[name] as MapType<string, TCacheValue>
+}
+
+export async function withContextCacheResponse<T extends {} | string | number | bigint>(
+  context: BaseContext,
+  name: string,
+  key: string,
+  func: () => Promise<T extends {} | string | number | bigint ? T : never>,
+  options?: { max?: number },
+): Promise<T> {
+  const cache = contextCache<T>(
+    context,
+    name,
+    () => new LruCacheMap<string, T>({ max: options?.max ?? 10_000 }),
+  )
+  const cacheResult = await cache.get(key)
+  if (isDefined(cacheResult)) {
+    return cacheResult
+  }
+  const result = await func()
+  await cache.set(key, result)
+  return result
+}
+
+export interface ChainContextWrite extends BaseContext, ChainIdentity, ChainStateContextWrite, ChainStoreContextWrite {}
 
-export interface StakedChainContextWrite extends ChainContextWrite, ChainStakeContextWrite {}
+export interface StakedChainContextWrite extends BaseContext, ChainContextWrite, ChainStakeContextWrite {}
 
-export interface ChainContextRead extends ChainIdentity, ChainStateContextRead, ChainStoreContextRead {}
+export interface ChainContextRead extends BaseContext, ChainIdentity, ChainStateContextRead, ChainStoreContextRead {}
 
-export interface StakedChainContextRead extends ChainContextRead, ChainStakeContextRead {}
+export interface StakedChainContextRead extends BaseContext, ChainContextRead, ChainStakeContextRead {}
 
 export type ChainContext = ChainIdentity & ChainContextRead & ChainContextWrite & ChainStoreContext
 

package/src/model/ChainContext/ChainStateContext.ts

@@ -2,7 +2,7 @@ import type { Hash } from '@xylabs/hex'
 import type { Promisable } from '@xylabs/promise'
 
 export interface ChainStateContextRead {
-  head(): Promisable<Hash>
+  head(): Promisable<[Hash, number]>
 }
 
 export interface ChainStateContextWrite {}