@xyo-network/xl1-protocol-sdk 1.17.7 → 1.18.0

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

@@ -0,0 +1,54 @@
+import { type Promisable } from '@xylabs/sdk-js';
+import type { HydratedBlock, SignedHydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol';
+import z from 'zod';
+import { type Provider } from '../model/index.ts';
+import type { HydratedBlockValidationError } from '../validation/index.ts';
+export declare const BlockValidationQualificationZod: z.ZodObject<{
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").Hash, string>>;
+    range: z.ZodTuple<[z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>], null>;
+}, z.z.core.$strip>;
+export type BlockValidationQualification = z.infer<typeof BlockValidationQualificationZod>;
+export declare const isBlockValidationQualification: <T>(value: T) => value is T & {
+    head: import("@xylabs/sdk-js").Hash;
+    range: [import("@xyo-network/xl1-protocol").XL1BlockNumber, import("@xyo-network/xl1-protocol").XL1BlockNumber];
+};
+export declare const BlockValidationConfigFieldsZod: z.ZodObject<{
+    value: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodBoolean>;
+}, z.z.core.$strip>;
+export declare const BlockValidationConfigZod: z.ZodUnion<readonly [z.ZodObject<{
+    value: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodBoolean>;
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").Hash, string>>;
+}, z.z.core.$strip>, z.ZodObject<{
+    value: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodBoolean>;
+    range: z.ZodTuple<[z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>], null>;
+}, z.z.core.$strip>, z.ZodObject<{
+    value: z.ZodOptional<z.ZodBoolean>;
+    state: z.ZodOptional<z.ZodBoolean>;
+}, z.z.core.$strip>, z.ZodObject<{}, z.z.core.$strip>]>;
+export type BlockValidationConfig = z.infer<typeof BlockValidationConfigZod>;
+export declare const isBlockValidationConfig: <T>(value: T) => value is T & (Record<string, never> | {
+    value?: boolean | undefined;
+    state?: boolean | undefined;
+} | {
+    head: import("@xylabs/sdk-js").Hash;
+    value?: boolean | undefined;
+    state?: boolean | undefined;
+} | {
+    range: [import("@xyo-network/xl1-protocol").XL1BlockNumber, import("@xyo-network/xl1-protocol").XL1BlockNumber];
+    value?: boolean | undefined;
+    state?: boolean | undefined;
+});
+export interface BlockValidationViewerMethods {
+    qualifiedValidateBlocks(blocks: HydratedBlock[], config?: BlockValidationConfig): Promisable<[HydratedBlockValidationError[], BlockValidationQualification]>;
+}
+export declare const BlockValidationViewerMoniker: "BlockValidationViewer";
+export type BlockValidationViewerMoniker = typeof BlockValidationViewerMoniker;
+export interface BlockValidationViewer extends BlockValidationViewerMethods, Provider<BlockValidationViewerMoniker> {
+    qualifiedValidateBlock(block: SignedHydratedBlockWithHashMeta, config?: BlockValidationConfig): Promisable<[HydratedBlockValidationError[], BlockValidationQualification]>;
+    validateBlock(block: SignedHydratedBlockWithHashMeta, config?: BlockValidationConfig): Promisable<HydratedBlockValidationError[]>;
+    validateBlocks(blocks: SignedHydratedBlockWithHashMeta[], config?: BlockValidationConfig): Promisable<HydratedBlockValidationError[]>;
+}
+//# sourceMappingURL=BlockValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BlockValidation.d.ts","sourceRoot":"","sources":["../../../src/viewers/BlockValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAC/F,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,OAAO,EAC6E,KAAK,QAAQ,EAChG,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AAE1E,eAAO,MAAM,+BAA+B;;;mBAAwB,CAAA;AACpE,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAC1F,eAAO,MAAM,8BAA8B;;;CAAgD,CAAA;AAE3F,eAAO,MAAM,8BAA8B;;;mBAGzC,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;uDAKnC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAC5E,eAAO,MAAM,uBAAuB;;;;;;;;;;;EAAyC,CAAA;AAE7E,MAAM,WAAW,4BAA4B;IAC3C,uBAAuB,CACrB,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,UAAU,CAAC,CAAC,4BAA4B,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAA;CAC9E;AAED,eAAO,MAAM,4BAA4B,EAAG,uBAAgC,CAAA;AAC5E,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAA;AAE9E,MAAM,WAAW,qBAAsB,SAAQ,4BAA4B,EAAE,QAAQ,CAAC,4BAA4B,CAAC;IACjH,sBAAsB,CACpB,KAAK,EAAE,+BAA+B,EACtC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,UAAU,CAAC,CAAC,4BAA4B,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAA;IAC7E,aAAa,CAAC,KAAK,EAAE,+BAA+B,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,UAAU,CAAC,4BAA4B,EAAE,CAAC,CAAA;IACjI,cAAc,CAAC,MAAM,EAAE,+BAA+B,EAAE,EAAE,MAAM,CAAC,EAAE,qBAAqB,GAAG,UAAU,CAAC,4BAA4B,EAAE,CAAC,CAAA;CACtI"}

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/StakeIntent.d.ts

@@ -1,8 +1,8 @@
 import type { Address, Hash, Promisable } from '@xylabs/sdk-js';
 import type { ChainStakeIntent, XL1BlockRange } from '@xyo-network/xl1-protocol';
-import type { Provider, Qualified } from '../model/index.ts';
+import type { ChainQualified, Provider } from '../model/index.ts';
 export interface StakeIntentViewerMethods {
-    qualifiedIntentByAddress(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<Qualified<ChainStakeIntent | null>>;
+    qualifiedIntentByAddress(address: Address, headOrRange?: Hash | XL1BlockRange): Promisable<ChainQualified<ChainStakeIntent | null>>;
 }
 export declare const StakeIntentViewerMoniker: "StakeIntentViewer";
 export type StakeIntentViewerMoniker = typeof StakeIntentViewerMoniker;

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

@@ -1 +1 @@
-{"version":3,"file":"StakeIntent.d.ts","sourceRoot":"","sources":["../../../src/viewers/StakeIntent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAAE,IAAI,EAAE,UAAU,EAC1B,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEhF,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAE5D,MAAM,WAAW,wBAAwB;IACvC,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAA;CAC/H;AAED,eAAO,MAAM,wBAAwB,EAAG,mBAA4B,CAAA;AACpE,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAA;AAEtE,MAAM,WAAW,iBAAkB,SAAQ,wBAAwB,EAAE,QAAQ,CAAC,wBAAwB,CAAC;IACrG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CAC3G"}
+{"version":3,"file":"StakeIntent.d.ts","sourceRoot":"","sources":["../../../src/viewers/StakeIntent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EAAE,IAAI,EAAE,UAAU,EAC1B,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjE,MAAM,WAAW,wBAAwB;IACvC,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,cAAc,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAA;CACpI;AAED,eAAO,MAAM,wBAAwB,EAAG,mBAA4B,CAAA;AACpE,MAAM,MAAM,wBAAwB,GAAG,OAAO,wBAAwB,CAAA;AAEtE,MAAM,WAAW,iBAAkB,SAAQ,wBAAwB,EAAE,QAAQ,CAAC,wBAAwB,CAAC;IACrG,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,IAAI,GAAG,aAAa,GAAG,UAAU,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CAC3G"}

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

@@ -0,0 +1,35 @@
+import { type Promisable } from '@xylabs/sdk-js';
+import { type HydratedTransaction, type ValidationError } from '@xyo-network/xl1-protocol';
+import type z from 'zod';
+import { type Provider } from '../model/index.ts';
+export declare const TransactionValidationQualificationZod: z.ZodObject<{
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").Hash, string>>;
+    range: z.ZodTuple<[z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>], null>;
+}, z.z.core.$strip>;
+export type TransactionValidationQualification = z.infer<typeof TransactionValidationQualificationZod>;
+export declare const isTransactionValidationQualification: <T>(value: T) => value is T & {
+    head: import("@xylabs/sdk-js").Hash;
+    range: [import("@xyo-network/xl1-protocol").XL1BlockNumber, import("@xyo-network/xl1-protocol").XL1BlockNumber];
+};
+export declare const TransactionValidationConfigZod: z.ZodUnion<readonly [z.ZodObject<{
+    range: z.ZodTuple<[z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<import("@xyo-network/xl1-protocol").XL1BlockNumber, number>>], null>;
+}, z.z.core.$strip>, z.ZodObject<{
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").Hash, string>>;
+}, z.z.core.$strip>, z.ZodObject<{}, z.z.core.$strip>]>;
+export type TransactionValidationConfig = z.infer<typeof TransactionValidationConfigZod>;
+export declare const isTransactionValidationConfig: <T>(value: T) => value is T & ({
+    range: [import("@xyo-network/xl1-protocol").XL1BlockNumber, import("@xyo-network/xl1-protocol").XL1BlockNumber];
+} | {
+    head: import("@xylabs/sdk-js").Hash;
+} | Record<string, never>);
+export interface TransactionValidationViewerMethods {
+    qualifiedValidateTransactions(transactions: HydratedTransaction[], config?: TransactionValidationConfig): Promisable<[ValidationError[][], TransactionValidationQualification]>;
+}
+export declare const TransactionValidationViewerMoniker: "TransactionValidationViewer";
+export type TransactionValidationViewerMoniker = typeof TransactionValidationViewerMoniker;
+export interface TransactionValidationViewer extends TransactionValidationViewerMethods, Provider<TransactionValidationViewerMoniker> {
+    qualifiedValidateTransaction(transaction: HydratedTransaction, config?: TransactionValidationConfig): Promisable<[ValidationError[], TransactionValidationQualification]>;
+    validateTransaction(transaction: HydratedTransaction[], config?: TransactionValidationConfig): Promisable<ValidationError[]>;
+    validateTransactions(transactions: HydratedTransaction[], config?: TransactionValidationConfig): Promisable<ValidationError[][]>;
+}
+//# sourceMappingURL=TransactionValidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionValidation.d.ts","sourceRoot":"","sources":["../../../src/viewers/TransactionValidation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC1F,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AAExB,OAAO,EAC2C,KAAK,QAAQ,EAC9D,MAAM,mBAAmB,CAAA;AAE1B,eAAO,MAAM,qCAAqC;;;mBAAwB,CAAA;AAC1E,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAA;AACtG,eAAO,MAAM,oCAAoC;;;CAAsD,CAAA;AAEvG,eAAO,MAAM,8BAA8B;;;;uDAA0B,CAAA;AACrE,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AACxF,eAAO,MAAM,6BAA6B;;;;0BAA+C,CAAA;AAEzF,MAAM,WAAW,kCAAkC;IACjD,6BAA6B,CAC3B,YAAY,EAAE,mBAAmB,EAAE,EACnC,MAAM,CAAC,EAAE,2BAA2B,GACnC,UAAU,CAAC,CAAC,eAAe,EAAE,EAAE,EAAE,kCAAkC,CAAC,CAAC,CAAA;CACzE;AAED,eAAO,MAAM,kCAAkC,EAAG,6BAAsC,CAAA;AACxF,MAAM,MAAM,kCAAkC,GAAG,OAAO,kCAAkC,CAAA;AAE1F,MAAM,WAAW,2BAA4B,SAAQ,kCAAkC,EAAE,QAAQ,CAAC,kCAAkC,CAAC;IACnI,4BAA4B,CAC1B,WAAW,EAAE,mBAAmB,EAChC,MAAM,CAAC,EAAE,2BAA2B,GACnC,UAAU,CAAC,CAAC,eAAe,EAAE,EAAE,kCAAkC,CAAC,CAAC,CAAA;IACtE,mBAAmB,CAAC,WAAW,EAAE,mBAAmB,EAAE,EAAE,MAAM,CAAC,EAAE,2BAA2B,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC,CAAA;IAC5H,oBAAoB,CAAC,YAAY,EAAE,mBAAmB,EAAE,EAAE,MAAM,CAAC,EAAE,2BAA2B,GAAG,UAAU,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;CACjI"}

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

@@ -1,7 +1,7 @@
 export * from './AccountBalance.ts';
 export * from './Block.ts';
 export * from './BlockReward.ts';
-export * from './Chain.ts';
+export * from './BlockValidation.ts';
 export * from './ChainContract.ts';
 export * from './ChainStakeViewer.ts';
 export * from './Fork.ts';
@@ -14,5 +14,6 @@ export * from './StepStake.ts';
 export * from './StepViewer.ts';
 export * from './TimeSync.ts';
 export * from './Transaction.ts';
+export * from './TransactionValidation.ts';
 export * from './TransferBalance.ts';
 //# sourceMappingURL=index.d.ts.map

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,sBAAsB,CAAA;AACpC,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,4BAA4B,CAAA;AAC1C,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.7",
+  "version": "1.18.0",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -39,11 +39,12 @@
     "!**/*.test.*"
   ],
   "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
     "@xylabs/hex": "~5.0.51",
     "@xylabs/sdk-js": "~5.0.51",
+    "@xylabs/zod": "~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 +59,16 @@
     "zod": "~4.1.13"
   },
   "devDependencies": {
-    "@types/node": "~25.0.1",
+    "@types/node": "~25.0.2",
     "@xylabs/events": "~5.0.51",
-    "@xylabs/ts-scripts-yarn3": "~7.2.30",
-    "@xylabs/tsconfig": "~7.2.30",
+    "@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"
   },

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,67 @@ 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
+
+  protected get config() {
+    return this.context.config!
+  }
+
+  protected get context() {
+    return this.params.context!
+  }
+
+  protected get locator() {
+    return this.context.locator!
+  }
+
   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 override async paramsHandler<T extends CreatableProviderInstance>(
+    params: Partial<T['params']> = {},
+  ) {
+    const context = assertEx(params.context, () => new Error('Context is required'))
+    const config = assertEx(context.config, () => new Error('Context config is required'))
+    const locator = assertEx(context.locator, () => new Error('Context locator is required'))
+    return await super.paramsHandler<T>({
+      ...params,
+      statusReporter: params.statusReporter ?? context.statusReporter,
+      context: {
+        ...context, config, locator,
+      },
+      name: params.name ?? (this as unknown as CreatableProvider<T>).defaultMoniker,
+    })
+  }
+
+  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,21 +40,32 @@ 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'] & CreatableProviderParams>, start?: boolean): Promise<T>
+
+  getInstance(
+    this: CreatableProviderFactory<T>,
+    params: T['params'] & CreatableProviderParams, start?: boolean): Promise<T>
+
+  tryGetInstance(
+    this: CreatableProviderFactory<T>,
+    params: T['params'] & CreatableProviderParams, start?: boolean): Promise<T | undefined>
 
 }
 
 export interface LabeledCreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance> extends CreatableProvider<T>, WithOptionalLabels {
-  factory(params?: Partial<T['params']>): LabeledCreatableProviderFactory<T>
+  factory(params?: Partial<T['params'] & CreatableProviderParams>): LabeledCreatableProviderFactory<T>
 }
 
 export interface CreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance> extends Creatable<T> {
   defaultMoniker: ProviderMoniker
   monikers: ProviderMoniker[]
-  factory(params?: Partial<T['params']>): CreatableProviderFactory<T>
+  factory(params?: Partial<T['params'] & CreatableProviderParams>): CreatableProviderFactory<T>
 }
 
 /**

package/src/CreatableProvider/CreatableProviderRegistry.ts

@@ -13,17 +13,22 @@ 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
+    // eslint-disable-next-line sonarjs/deprecation
     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,59 @@ 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 resultPromise = scopeObject[this.resolvedMoniker] as Promise<TProvider> ?? this.creatableProvider.create<TProvider>(mergedParams)
+    scopeObject[this.resolvedMoniker] = resultPromise
+    const result = await resultPromise
+    if (start) {
+      assertEx(await result.start(), () => 'Failed to start provider instance')
+    }
+    return result
+  }
+
+  async tryGetInstance(this: CreatableProviderFactory<TProvider>, params: TProvider['params'], start = true): Promise<TProvider | undefined> {
+    try {
+      return await this.getInstance(params, start)
+    } catch {
+      return
+    }
+  }
 }