@xyo-network/xl1-protocol-sdk 1.17.6 → 1.18.0-rc.1

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

@@ -0,0 +1,82 @@
+import type { Hex } from '@xylabs/sdk-js';
+import { Base } from '@xylabs/sdk-js';
+import type { AccountInstance } from '@xyo-network/account-model';
+import { type PayloadBuilderOptions } from '@xyo-network/payload-builder';
+import type { Payload } from '@xyo-network/payload-model';
+import type { AllowedBlockPayload, ChainId, TransactionFeesBigInt } from '@xyo-network/xl1-protocol';
+export declare class TransactionBuilder<TPayload extends Payload> extends Base<Omit<PayloadBuilderOptions, 'schema'>> {
+    private _blockRange?;
+    private _chain?;
+    private _elevatedPayloads;
+    private _fees;
+    private _payloads;
+    private _signers;
+    constructor(options?: Omit<PayloadBuilderOptions, 'schema'>);
+    build(): Promise<[{
+        schema: "network.xyo.boundwitness";
+        addresses: import("@xylabs/sdk-js").Address[];
+        payload_hashes: import("@xylabs/sdk-js").Hash[];
+        payload_schemas: string[];
+        previous_hashes: (import("@xylabs/sdk-js").Hash | null)[];
+        $signatures: Hex[];
+        nbf: import("@xyo-network/xl1-protocol").XL1BlockNumber;
+        exp: import("@xyo-network/xl1-protocol").XL1BlockNumber;
+        fees: {
+            base: Hex;
+            gasLimit: Hex;
+            gasPrice: Hex;
+            priority: Hex;
+        };
+        chain: Hex;
+        from: import("@xylabs/sdk-js").Address;
+        _hash: import("@xylabs/sdk-js").Hash;
+        _dataHash: import("@xylabs/sdk-js").Hash;
+        $destination?: import("@xylabs/sdk-js").Address | undefined;
+        $sourceQuery?: import("@xylabs/sdk-js").Hash | undefined;
+        script?: string[] | undefined;
+    }, {
+        schema: string;
+        _hash: import("@xylabs/sdk-js").Hash;
+        _dataHash: import("@xylabs/sdk-js").Hash;
+    }[]]>;
+    chain(chain: ChainId): this;
+    dryRun(): Promise<[{
+        schema: "network.xyo.boundwitness";
+        addresses: import("@xylabs/sdk-js").Address[];
+        payload_hashes: import("@xylabs/sdk-js").Hash[];
+        payload_schemas: string[];
+        previous_hashes: (import("@xylabs/sdk-js").Hash | null)[];
+        $signatures: Hex[];
+        nbf: import("@xyo-network/xl1-protocol").XL1BlockNumber;
+        exp: import("@xyo-network/xl1-protocol").XL1BlockNumber;
+        fees: {
+            base: Hex;
+            gasLimit: Hex;
+            gasPrice: Hex;
+            priority: Hex;
+        };
+        chain: Hex;
+        from: import("@xylabs/sdk-js").Address;
+        _hash: import("@xylabs/sdk-js").Hash;
+        _dataHash: import("@xylabs/sdk-js").Hash;
+        $destination?: import("@xylabs/sdk-js").Address | undefined;
+        $sourceQuery?: import("@xylabs/sdk-js").Hash | undefined;
+        script?: string[] | undefined;
+    }, {
+        schema: string;
+        _hash: import("@xylabs/sdk-js").Hash;
+        _dataHash: import("@xylabs/sdk-js").Hash;
+    }[]]>;
+    elevatedPayload(payload?: AllowedBlockPayload): this;
+    elevatedPayloads(payloads?: AllowedBlockPayload[]): this;
+    estimatedMinimumFees(): Promise<TransactionFeesBigInt>;
+    fees(fees: TransactionFeesBigInt): this;
+    payload(payload?: TPayload): this;
+    payloads(payloads?: TPayload[]): this;
+    range(blockRange: [number, number]): this;
+    removeElevatedPayload(payload: AllowedBlockPayload): Promise<this>;
+    removePayload(payload: TPayload): Promise<this>;
+    signer(signer?: AccountInstance): this;
+    signers(signers?: (AccountInstance | null)[]): this;
+}
+//# sourceMappingURL=TransactionBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionBuilder.d.ts","sourceRoot":"","sources":["../../../src/transaction/TransactionBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAY,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACzF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,OAAO,EACP,qBAAqB,EACtB,MAAM,2BAA2B,CAAA;AASlC,qBAAa,kBAAkB,CAAC,QAAQ,SAAS,OAAO,CAAE,SAAQ,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,CAAC;IAC3G,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAK;IACpB,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAM;IAIzD,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgBX,KAAK,CAAC,KAAK,EAAE,OAAO;IAKd,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;IAaZ,eAAe,CAAC,OAAO,CAAC,EAAE,mBAAmB;IAO7C,gBAAgB,CAAC,QAAQ,CAAC,EAAE,mBAAmB,EAAE;IAQ3C,oBAAoB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAY5D,IAAI,CAAC,IAAI,EAAE,qBAAqB;IAKhC,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ;IAK1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE;IAU9B,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5B,qBAAqB,CAAC,OAAO,EAAE,mBAAmB;IAalD,aAAa,CAAC,OAAO,EAAE,QAAQ;IAarC,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe;IAO/B,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,eAAe,GAAG,IAAI,CAAC,EAAE;CAS7C"}

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

@@ -0,0 +1,6 @@
+import type { Address } from '@xylabs/sdk-js';
+import type { AccountInstance } from '@xyo-network/account-model';
+import type { Payload, Schema } from '@xyo-network/payload-model';
+import type { ChainId, SignedHydratedTransactionWithHashMeta, XL1BlockNumber } from '@xyo-network/xl1-protocol';
+export declare const buildRandomTransaction: (chain: ChainId, payloads?: Payload[], account?: AccountInstance, nbf?: XL1BlockNumber, exp?: XL1BlockNumber, privatePayloadSchemas?: Schema[], receiverAddress?: Address) => Promise<SignedHydratedTransactionWithHashMeta>;
+//# sourceMappingURL=buildRandomTransaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildRandomTransaction.d.ts","sourceRoot":"","sources":["../../../src/transaction/buildRandomTransaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EACW,OAAO,EAC5B,qCAAqC,EAErC,cAAc,EACf,MAAM,2BAA2B,CAAA;AAMlC,eAAO,MAAM,sBAAsB,GACjC,OAAO,OAAO,EACd,WAAW,OAAO,EAAE,EACpB,UAAU,eAAe,EACzB,MAAK,cAA0C,EAC/C,MAAK,cAAmD,EACxD,wBAAuB,MAAM,EAAO,EACpC,kBAAkB,OAAO,KACxB,OAAO,CAAC,qCAAqC,CAY/C,CAAA"}

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

@@ -1,3 +1,4 @@
+export * from './buildRandomTransaction.ts';
 export * from './buildTransaction.ts';
 export * from './buildUnsignedTransaction.ts';
 export * from './confirmSubmittedTransaction.ts';
@@ -5,4 +6,5 @@ export * from './hydrateTransaction.ts';
 export * from './primitives/index.ts';
 export * from './script.ts';
 export * from './signTransaction.ts';
+export * from './TransactionBuilder.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kCAAkC,CAAA;AAChD,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,kCAAkC,CAAA;AAChD,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA"}

package/dist/neutral/viewers/Block.d.ts

@@ -1,6 +1,6 @@
 import type { Hash, Promisable } from '@xylabs/sdk-js';
 import type { Payload, WithHashMeta } from '@xyo-network/payload-model';
-import type { SignedHydratedBlockWithHashMeta, XL1BlockNumber } from '@xyo-network/xl1-protocol';
+import type { ChainId, SignedHydratedBlockWithHashMeta, XL1BlockNumber } from '@xyo-network/xl1-protocol';
 import type { Provider } from '../model/index.ts';
 export interface BlockViewerMethods {
     blocksByHash(hash: Hash, limit?: number): Promisable<SignedHydratedBlockWithHashMeta[]>;
@@ -13,6 +13,9 @@ export type BlockViewerMoniker = typeof BlockViewerMoniker;
 export interface BlockViewer extends BlockViewerMethods, Provider<BlockViewerMoniker> {
     blockByHash(hash: Hash): Promisable<SignedHydratedBlockWithHashMeta | null>;
     blockByNumber(block: XL1BlockNumber): Promisable<SignedHydratedBlockWithHashMeta | null>;
+    chainId(): Promisable<ChainId>;
+    chainId(blockNumber: XL1BlockNumber): Promisable<ChainId>;
+    chainId(blockNumber: 'latest'): Promisable<ChainId>;
     currentBlockHash(): Promisable<Hash>;
     currentBlockNumber(): Promisable<XL1BlockNumber>;
     payloadByHash(hash: Hash): Promisable<WithHashMeta<Payload> | null>;

package/dist/neutral/viewers/Block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../src/viewers/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EAAE,+BAA+B,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAEhG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACvF,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACpG,YAAY,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAA;IAC3D,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CACpE;AAED,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,MAAM,WAAW,WAAY,SAAQ,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IACnF,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IAC3E,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACxF,gBAAgB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACpC,kBAAkB,IAAI,UAAU,CAAC,cAAc,CAAC,CAAA;IAChD,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;CACpE"}
+{"version":3,"file":"Block.d.ts","sourceRoot":"","sources":["../../../src/viewers/Block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EACV,OAAO,EAAE,+BAA+B,EAAE,cAAc,EACzD,MAAM,2BAA2B,CAAA;AAElC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACvF,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACpG,YAAY,IAAI,UAAU,CAAC,+BAA+B,CAAC,CAAA;IAC3D,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CACpE;AAED,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,MAAM,WAAW,WAAY,SAAQ,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IACnF,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IAC3E,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,+BAA+B,GAAG,IAAI,CAAC,CAAA;IACxF,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,WAAW,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACzD,OAAO,CAAC,WAAW,EAAE,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAA;IACnD,gBAAgB,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IACpC,kBAAkB,IAAI,UAAU,CAAC,cAAc,CAAC,CAAA;IAChD,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;CACpE"}

package/dist/neutral/viewers/ChainStakeViewer.d.ts

@@ -1,9 +1,8 @@
 import type { Provider } from '../model/index.ts';
-import type { ChainViewer } from './Chain.ts';
 import type { ChainContractViewer } from './ChainContract.ts';
 import type { StakeTotalsViewer } from './StakeTotals.ts';
 export declare const ChainStakeViewerMoniker: "ChainStakeViewer";
 export type ChainStakeViewerMoniker = typeof ChainStakeViewerMoniker;
-export interface ChainStakeViewer extends Omit<ChainContractViewer, 'moniker'>, Omit<StakeTotalsViewer, 'moniker'>, Omit<ChainViewer, 'moniker'>, Provider<ChainStakeViewerMoniker> {
+export interface ChainStakeViewer extends Omit<ChainContractViewer, 'moniker'>, Omit<StakeTotalsViewer, 'moniker'>, Provider<ChainStakeViewerMoniker> {
 }
 //# sourceMappingURL=ChainStakeViewer.d.ts.map

package/dist/neutral/viewers/ChainStakeViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChainStakeViewer.d.ts","sourceRoot":"","sources":["../../../src/viewers/ChainStakeViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,eAAO,MAAM,uBAAuB,EAAG,kBAA2B,CAAA;AAClE,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAChH,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,uBAAuB,CAAC;CAEhE"}
+{"version":3,"file":"ChainStakeViewer.d.ts","sourceRoot":"","sources":["../../../src/viewers/ChainStakeViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,eAAO,MAAM,uBAAuB,EAAG,kBAA2B,CAAA;AAClE,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAA;AAEpE,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAChH,QAAQ,CAAC,uBAAuB,CAAC;CAElC"}

package/dist/neutral/viewers/Fork.d.ts

@@ -2,7 +2,6 @@ import type { Promisable } from '@xylabs/sdk-js';
 import type { ChainId } from '@xyo-network/xl1-protocol';
 export type ForkHistory = Record<number, ChainId>;
 export interface ForkViewerMethods {
-    chainIdAtBlock(blockNumber: number): Promisable<ChainId | undefined>;
     forkHistory(): Promisable<ForkHistory>;
 }
 //# sourceMappingURL=Fork.d.ts.map

package/dist/neutral/viewers/Fork.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Fork.d.ts","sourceRoot":"","sources":["../../../src/viewers/Fork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEjD,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IACpE,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;CACvC"}
+{"version":3,"file":"Fork.d.ts","sourceRoot":"","sources":["../../../src/viewers/Fork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAExD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEjD,MAAM,WAAW,iBAAiB;IAChC,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;CACvC"}

package/dist/neutral/viewers/Stake.d.ts

@@ -2,7 +2,6 @@ import type { Address, Promisable } from '@xylabs/sdk-js';
 import type { Position, Provider } from '../model/index.ts';
 import type { StakeEventsViewer } from './StakeEvents.ts';
 export interface StakeViewerProperties {
-    chainId: Address;
     minWithdrawalBlocks: number;
     rewardsContract: Address;
     stakeEvents: StakeEventsViewer;

package/dist/neutral/viewers/Stake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Stake.d.ts","sourceRoot":"","sources":["../../../src/viewers/Stake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,mBAAmB,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC3C,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAClE,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;IACvD,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;CACxD;AAED,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,MAAM,WAAW,WAAY,SAAQ,kBAAkB,EAAE,qBAAqB,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IAC1G,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,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;AAED,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAAC,kBAAkB,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9C"}
+{"version":3,"file":"Stake.d.ts","sourceRoot":"","sources":["../../../src/viewers/Stake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,MAAM,WAAW,qBAAqB;IACpC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,eAAe,EAAE,OAAO,CAAA;IACxB,WAAW,EAAE,iBAAiB,CAAA;IAC9B,mBAAmB,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAC3C,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAClE,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;IACvD,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAA;CACxD;AAED,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,MAAM,WAAW,WAAY,SAAQ,kBAAkB,EAAE,qBAAqB,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IAC1G,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,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;AAED,eAAO,MAAM,kBAAkB,EAAG,aAAsB,CAAA;AACxD,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAA;AAE1D,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAAC,kBAAkB,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC9C"}

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

@@ -1,7 +1,6 @@
 export * from './AccountBalance.ts';
 export * from './Block.ts';
 export * from './BlockReward.ts';
-export * from './Chain.ts';
 export * from './ChainContract.ts';
 export * from './ChainStakeViewer.ts';
 export * from './Fork.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/viewers/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/viewers/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.17.6",
+  "version": "1.18.0-rc.1",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -39,11 +39,11 @@
     "!**/*.test.*"
   ],
   "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
     "@xylabs/hex": "~5.0.51",
     "@xylabs/sdk-js": "~5.0.51",
     "@xyo-network/account": "~5.2.17",
     "@xyo-network/account-model": "~5.2.17",
-    "@xyo-network/archivist-memory": "~5.2.17",
     "@xyo-network/archivist-model": "~5.2.17",
     "@xyo-network/boundwitness-builder": "~5.2.17",
     "@xyo-network/boundwitness-model": "~5.2.17",
@@ -58,15 +58,16 @@
     "zod": "~4.1.13"
   },
   "devDependencies": {
-    "@types/node": "~24.10.3",
+    "@types/node": "~25.0.2",
     "@xylabs/events": "~5.0.51",
-    "@xylabs/ts-scripts-yarn3": "~7.2.8",
-    "@xylabs/tsconfig": "~7.2.8",
+    "@xylabs/ts-scripts-yarn3": "~7.2.32",
+    "@xylabs/tsconfig": "~7.2.32",
     "@xylabs/vitest-extended": "~5.0.51",
     "@xyo-network/account": "~5.2.17",
+    "@xyo-network/archivist-mongodb": "~5.2.17",
     "@xyo-network/boundwitness-validator": "~5.2.17",
     "axios": "^1.13.2",
-    "eslint": "^9.39.1",
+    "eslint": "^9.39.2",
     "typescript": "~5.9.3",
     "vitest": "~4.0.15"
   },
@@ -79,5 +80,6 @@
   "engineStrict": true,
   "publishConfig": {
     "access": "public"
-  }
-}
+  },
+  "stableVersion": "1.17.7"
+}

package/src/CreatableProvider/AbstractCreatableProvider.ts

@@ -1,5 +1,6 @@
-import { AbstractCreatable } from '@xylabs/sdk-js'
+import { AbstractCreatable, assertEx } from '@xylabs/sdk-js'
 
+import type { Provider, ProviderMoniker } from '../model/index.ts'
 import type {
   CreatableProvider,
   CreatableProviderEventData, CreatableProviderFactory, CreatableProviderInstance, CreatableProviderParams,
@@ -7,11 +8,51 @@ import type {
 import { ProviderFactory } from './ProviderFactory.ts'
 
 export abstract class AbstractCreatableProvider<TParams extends CreatableProviderParams = CreatableProviderParams,
-  TEventData extends CreatableProviderEventData = CreatableProviderEventData> extends AbstractCreatable<TParams, TEventData> {
+  TEventData extends CreatableProviderEventData = CreatableProviderEventData> extends AbstractCreatable<TParams, TEventData>
+  implements Omit<CreatableProviderInstance, 'moniker'> {
+  protected _contextCache: TParams['context'] | undefined
+
+  get config() {
+    return assertEx(this.context.config, () => 'config is required')
+  }
+
+  get context() {
+    return assertEx(this.params.context, () => 'context is required')
+  }
+
+  get locator() {
+    return assertEx(this.context.locator, () => 'locator is required')
+  }
+
   static factory<TModule extends CreatableProviderInstance>(
     this: CreatableProvider<TModule>,
     params?: Partial<TModule['params']>,
   ): CreatableProviderFactory<TModule> {
-    return ProviderFactory.withParams<TModule>(this, params)
+    const factory = ProviderFactory.withParams<TModule>(this, params)
+    return factory
+  }
+
+  static async getInstance<T extends CreatableProviderInstance>(
+    this: CreatableProvider<T>,
+    inParams: T['params'],
+  ): Promise<T> {
+    const instance = await this.create<T>(inParams)
+    return instance
+  }
+
+  static async tryGetInstance<T extends CreatableProviderInstance>(
+    this: CreatableProvider<T>,
+    inParams: T['params'],
+  ): Promise<T | undefined> {
+    try {
+      return await this.create<T>(inParams)
+    } catch {
+      return
+    }
+  }
+
+  async locateAndCreate<TProvider extends Provider<ProviderMoniker>,
+    TParams extends CreatableProviderInstance<TProvider>['params'] = CreatableProviderInstance<TProvider>['params']>(moniker: TProvider['moniker']) {
+    return await this.locator?.getInstance<TProvider, TParams>(moniker)
   }
 }

package/src/CreatableProvider/CreatableProvider.ts

@@ -1,22 +1,38 @@
+import type { MeterProvider, TracerProvider } from '@opentelemetry/api'
 import type { EventData } from '@xylabs/events'
 import type {
-  Creatable, CreatableInstance, CreatableParams, EmptyObject,
-  Labels, WithOptionalLabels,
+  Creatable, CreatableInstance, CreatableParams,
+  Labels, Logger, WithOptionalLabels,
 } from '@xylabs/sdk-js'
 
-import type { ProviderMoniker } from '../model/index.ts'
+import type { Config } from '../config/index.ts'
+import type { Provider, ProviderMoniker } from '../model/index.ts'
+import type { RuntimeStatusMonitor } from '../status/index.ts'
 import type { LabeledCreatableProviderFactory } from './LabeledCreatableProviderFactory.ts'
 import type { ProviderFactoryLocatorInstance } from './ProviderFactoryLocatorInstance.ts'
 
-export interface CreatableProviderParams<TConfig extends EmptyObject = EmptyObject> extends CreatableParams {
-  config?: TConfig
-  locator?: ProviderFactoryLocatorInstance
+export interface CreatableProviderContext {
+  _id?: string
+  config: Config
+  locator: ProviderFactoryLocatorInstance
+  logger?: Logger
+  meterProvider?: MeterProvider
+  singletons: Record<string, unknown>
+  statusReporter?: RuntimeStatusMonitor
+  traceProvider?: TracerProvider
+}
+
+export interface CreatableProviderParams<TContext extends CreatableProviderContext = CreatableProviderContext> extends CreatableParams {
+  context: TContext
 }
 export interface CreatableProviderEventData extends EventData {}
 
-export interface CreatableProviderInstance<TParams extends CreatableProviderParams = CreatableProviderParams,
+export type CreatableProviderInstance<TProvider extends Provider<ProviderMoniker> = Provider<ProviderMoniker>,
+  TParams extends CreatableProviderParams = CreatableProviderParams,
   TEventData extends CreatableProviderEventData = CreatableProviderEventData>
-  extends CreatableInstance<TParams, TEventData> {}
+  = CreatableInstance<TParams, TEventData> & TProvider
+
+export type ProviderFactoryScope = 'global' | 'context' | 'local'
 
 export interface CreatableProviderFactory<T extends CreatableProviderInstance = CreatableProviderInstance>
   extends Omit<CreatableProvider<T>, 'create' | 'createHandler' | 'paramsHandler'> {
@@ -24,10 +40,21 @@ export interface CreatableProviderFactory<T extends CreatableProviderInstance =
   defaultParams?: Partial<T['params']>
 
   labels?: Labels
+  resolvedMoniker: string
+  scope: ProviderFactoryScope
 
+  /** @deprecated use getInstance instead */
   create(
     this: CreatableProviderFactory<T>,
-    params?: Partial<T['params']>): Promise<T>
+    params?: Partial<T['params']>, start?: boolean): Promise<T>
+
+  getInstance(
+    this: CreatableProviderFactory<T>,
+    params: T['params'], start?: boolean): Promise<T>
+
+  tryGetInstance(
+    this: CreatableProviderFactory<T>,
+    params: T['params'], start?: boolean): Promise<T | undefined>
 
 }
 

package/src/CreatableProvider/CreatableProviderRegistry.ts

@@ -13,17 +13,21 @@ const buildProviderFactory = <TProvider extends CreatableProviderInstance>(
   provider: CreatableProviderFactory<TProvider>,
   labels?: Labels,
 ): LabeledCreatableProviderFactory<TProvider> => {
-  const factory: LabeledCreatableProviderFactory<TProvider> = {
-    // Destructure instance properties
-    ...provider,
-
+  const factory = {
     monikers: provider.monikers,
     // Copy static methods
     create: provider.create.bind(provider) as LabeledCreatableProviderFactory<TProvider>['create'],
 
     // Merge module & supplied labels
     labels: { ...(provider as LabeledCreatableProviderFactory).labels, ...labels },
-  }
+    creatableProvider: provider.creatableProvider,
+    resolvedMoniker: provider.resolvedMoniker,
+    scope: provider.scope,
+    getInstance: provider.getInstance.bind(provider) as LabeledCreatableProviderFactory<TProvider>['getInstance'],
+    tryGetInstance: provider.tryGetInstance?.bind(provider) as LabeledCreatableProviderFactory<TProvider>['tryGetInstance'],
+    defaultMoniker: provider.defaultMoniker,
+    factory: provider.factory.bind(provider) as LabeledCreatableProviderFactory<TProvider>['factory'],
+  } satisfies LabeledCreatableProviderFactory<TProvider>
   return factory
 }
 

package/src/CreatableProvider/ProviderFactory.ts

@@ -3,8 +3,13 @@ import { assertEx } from '@xylabs/sdk-js'
 
 import type {
   CreatableProvider, CreatableProviderFactory, CreatableProviderInstance,
+  ProviderFactoryScope,
 } from './CreatableProvider.ts'
 
+declare global {
+  var xyoServiceSingletons: Record<string, unknown>
+}
+
 export class ProviderFactory<TProvider extends CreatableProviderInstance> implements CreatableProviderFactory<TProvider> {
   creatableProvider: CreatableProvider<TProvider>
 
@@ -16,19 +21,29 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
 
   monikers: CreatableProvider<TProvider>['monikers']
 
+  scope: ProviderFactoryScope
+
   constructor(
     creatableProvider: CreatableProvider<TProvider>,
     params?: Partial<TProvider['params']>,
     labels: Labels = {},
+    scope: ProviderFactoryScope = 'context',
   ) {
     this.creatableProvider = creatableProvider
     this.defaultParams = params
     this.defaultMoniker = creatableProvider.defaultMoniker
     this.monikers = creatableProvider.monikers
+    this.scope = scope
     assertEx(this.monikers.includes(this.defaultMoniker), () => 'defaultMoniker must be in monikers')
     this.labels = Object.assign({}, (creatableProvider as WithOptionalLabels).labels ?? {}, labels ?? {})
   }
 
+  get resolvedMoniker() {
+    const labels: Labels = this.labels ?? {}
+    const labelString = Object.entries(labels).map(([key, value]) => `${key}=${value}`).join(',')
+    return labelString.length === 0 ? `${this.defaultMoniker}` : `${this.defaultMoniker}|${labelString}`
+  }
+
   static withParams<T extends CreatableProviderInstance>(
     creatableProvider: CreatableProvider<T>,
     params?: Partial<T['params']>,
@@ -37,16 +52,9 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
     return new ProviderFactory<T>(creatableProvider, params, labels)
   }
 
-  create(this: CreatableProviderFactory<TProvider>, params?: Partial<TProvider['params']>): Promise<TProvider> {
-    const mergedParams: TProvider['params'] = {
-      ...this.defaultParams,
-      ...params,
-      config: {
-        ...this.defaultParams?.config,
-        ...params?.config,
-      },
-    } as TProvider['params']
-    return this.creatableProvider.create<TProvider>(mergedParams)
+  /** @deprecated use getInstance instead */
+  async create(this: CreatableProviderFactory<TProvider>, params?: Partial<TProvider['params']>, start = true): Promise<TProvider> {
+    return await this.getInstance(params as TProvider['params'], start)
   }
 
   factory<T extends CreatableProviderInstance>(
@@ -56,4 +64,58 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
   ): CreatableProviderFactory<T> {
     return new ProviderFactory<T>(this.creatableProvider, params, labels)
   }
+
+  async getInstance(this: CreatableProviderFactory<TProvider>, params: TProvider['params'], start = true): Promise<TProvider> {
+    let scopeObject: Record<string, unknown> = {}
+    switch (this.scope) {
+      case 'global': {
+        if (globalThis.xyoServiceSingletons === undefined) {
+          globalThis.xyoServiceSingletons = {}
+        }
+        scopeObject = globalThis.xyoServiceSingletons
+        break
+      }
+      case 'context': {
+        const context = assertEx(
+          params?.context,
+          () => 'Context is required for context-scoped providers',
+        )
+        if (context.singletons === undefined) {
+          context.singletons = {}
+        }
+        scopeObject = context.singletons
+        break
+      }
+      default: {
+        scopeObject = {}
+        break
+      }
+    }
+    const mergedParams: TProvider['params'] = {
+      ...this.defaultParams,
+      ...params,
+      context: {
+        ...this.defaultParams?.context,
+        ...params?.context,
+        config: {
+          ...this.defaultParams?.context?.config,
+          ...params?.context?.config,
+        },
+      },
+    } as TProvider['params']
+    const result = await this.creatableProvider.create<TProvider>(mergedParams)
+    if (start) {
+      assertEx(await result.start(), () => 'Failed to start provider instance')
+    }
+    scopeObject[this.resolvedMoniker] = result
+    return result
+  }
+
+  async tryGetInstance(this: CreatableProviderFactory<TProvider>, params: TProvider['params'], start = true): Promise<TProvider | undefined> {
+    try {
+      return await this.getInstance(params, start)
+    } catch {
+      return
+    }
+  }
 }