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

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

@@ -1 +1 @@
-{"version":3,"file":"Mempool.d.ts","sourceRoot":"","sources":["../../../src/viewers/Mempool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,+BAA+B,EAAE,qCAAqC,EAAE,MAAM,2BAA2B,CAAA;AAEvH,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,eAAO,MAAM,6BAA6B;;;;mBAIxC,CAAA;AAEF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEtF,eAAO,MAAM,uBAAuB;;;;mBAIlC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE1E,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACzF,mBAAmB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,qCAAqC,EAAE,CAAC,CAAA;CAC5G;AAED,eAAO,MAAM,oBAAoB,EAAG,eAAwB,CAAA;AAC5D,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAA;AAE9D,MAAM,WAAW,aAAc,SAAQ,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB,CAAC;CAAG"}
+{"version":3,"file":"Mempool.d.ts","sourceRoot":"","sources":["../../../src/viewers/Mempool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,+BAA+B,EAAE,qCAAqC,EAAE,MAAM,2BAA2B,CAAA;AAEvH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAA;AAEF,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEtF,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE1E,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,+BAA+B,EAAE,CAAC,CAAA;IACzF,mBAAmB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,qCAAqC,EAAE,CAAC,CAAA;CAC5G;AAED,eAAO,MAAM,oBAAoB,EAAG,eAAwB,CAAA;AAC5D,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAA;AAE9D,MAAM,WAAW,aAAc,SAAQ,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB,CAAC;CAAG"}

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").BrandedHash, 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.core.$strip>;
+export type TransactionValidationQualification = z.infer<typeof TransactionValidationQualificationZod>;
+export declare const isTransactionValidationQualification: <T>(value: T) => value is T & {
+    head: import("@xylabs/sdk-js").BrandedHash;
+    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.core.$strip>, z.ZodObject<{
+    head: z.ZodPipe<z.ZodString, z.ZodTransform<import("@xylabs/sdk-js").BrandedHash, string>>;
+}, z.core.$strip>, z.ZodObject<{}, 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").BrandedHash;
+} | 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,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,EAC2C,KAAK,QAAQ,EAC9D,MAAM,mBAAmB,CAAA;AAE1B,eAAO,MAAM,qCAAqC;;;iBAAwB,CAAA;AAC1E,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAA;AACtG,eAAO,MAAM,oCAAoC;;;CAAsD,CAAA;AAEvG,eAAO,MAAM,8BAA8B;;;;mDAA0B,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/WindowedBlock.d.ts

@@ -0,0 +1,14 @@
+import type { Hash } from '@xylabs/hex';
+import type { Promisable } from '@xylabs/sdk-js';
+import type { HydratedBlockWithHashMeta } from '@xyo-network/xl1-protocol';
+import type { Provider, ProviderMoniker } from '../model/index.ts';
+import type { BlockViewerMethods } from './Block.ts';
+export interface WindowedBlockViewerMethods extends BlockViewerMethods {
+    blocksByTransactionHashes(hashes: Hash[]): Promisable<HydratedBlockWithHashMeta[]>;
+}
+export declare const WindowedBlockViewerMoniker: "WindowedBlockViewer";
+export type WindowedBlockViewerMoniker = typeof WindowedBlockViewerMoniker;
+export interface WindowedBlockViewer<TMoniker extends ProviderMoniker = WindowedBlockViewerMoniker> extends WindowedBlockViewerMethods, Provider<TMoniker> {
+    blockByTransactionHash(hash: Hash): Promisable<HydratedBlockWithHashMeta | null>;
+}
+//# sourceMappingURL=WindowedBlock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WindowedBlock.d.ts","sourceRoot":"","sources":["../../../src/viewers/WindowedBlock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AAE1E,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAEpD,MAAM,WAAW,0BAA2B,SAAQ,kBAAkB;IACpE,yBAAyB,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,yBAAyB,EAAE,CAAC,CAAA;CACnF;AAED,eAAO,MAAM,0BAA0B,EAAG,qBAA8B,CAAA;AACxE,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAA;AAE1E,MAAM,WAAW,mBAAmB,CAAC,QAAQ,SAAS,eAAe,GAAG,0BAA0B,CAAE,SAAQ,0BAA0B,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACxJ,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;CACjF"}

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

@@ -1,8 +1,10 @@
 export * from './AccountBalance.ts';
 export * from './Block.ts';
 export * from './BlockReward.ts';
+export * from './BlockValidation.ts';
 export * from './ChainContract.ts';
 export * from './ChainStakeViewer.ts';
+export * from './Finalization.ts';
 export * from './Fork.ts';
 export * from './Mempool.ts';
 export * from './NetworkStakeStepReward.ts';
@@ -13,5 +15,7 @@ export * from './StepStake.ts';
 export * from './StepViewer.ts';
 export * from './TimeSync.ts';
 export * from './Transaction.ts';
+export * from './TransactionValidation.ts';
 export * from './TransferBalance.ts';
+export * from './WindowedBlock.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,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,mBAAmB,CAAA;AACjC,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;AACpC,cAAc,oBAAoB,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json.schemastore.org/package.json",
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.18.0-rc.1",
+  "version": "1.18.1",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -40,36 +40,39 @@
   ],
   "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-model": "~5.2.17",
-    "@xyo-network/boundwitness-builder": "~5.2.17",
-    "@xyo-network/boundwitness-model": "~5.2.17",
-    "@xyo-network/payload-builder": "~5.2.17",
-    "@xyo-network/payload-model": "~5.2.17",
-    "@xyo-network/wallet": "~5.2.17",
-    "@xyo-network/wallet-model": "~5.2.17",
-    "@xyo-network/xl1-protocol": "~1.14.17",
+    "@xylabs/hex": "~5.0.61",
+    "@xylabs/sdk-js": "~5.0.61",
+    "@xylabs/zod": "~5.0.61",
+    "@xyo-network/account": "~5.2.19",
+    "@xyo-network/account-model": "~5.2.19",
+    "@xyo-network/archivist-model": "~5.2.19",
+    "@xyo-network/boundwitness-builder": "~5.2.19",
+    "@xyo-network/boundwitness-model": "~5.2.19",
+    "@xyo-network/payload-builder": "~5.2.19",
+    "@xyo-network/payload-model": "~5.2.19",
+    "@xyo-network/wallet": "~5.2.19",
+    "@xyo-network/wallet-model": "~5.2.19",
+    "@xyo-network/xl1-protocol": "~1.18.1",
     "async-mutex": "~0.5.0",
     "ethers": "^6.16.0",
     "lru-cache": "^11.2.4",
-    "zod": "~4.1.13"
+    "zod": "~4.2.1"
   },
   "devDependencies": {
-    "@types/node": "~25.0.2",
-    "@xylabs/events": "~5.0.51",
+    "@types/node": "~25.0.3",
+    "@xylabs/events": "~5.0.61",
     "@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",
+    "@xylabs/vitest-extended": "~5.0.61",
+    "@xyo-network/account": "~5.2.19",
+    "@xyo-network/archivist-memory": "~5.2.19",
+    "@xyo-network/archivist-mongodb": "~5.2.19",
+    "@xyo-network/boundwitness-validator": "~5.2.19",
     "axios": "^1.13.2",
     "eslint": "^9.39.2",
+    "tslib": "^2.8.1",
     "typescript": "~5.9.3",
-    "vitest": "~4.0.15"
+    "vitest": "~4.0.16"
   },
   "peerDependencies": {
     "axios": "^1.13.2"
@@ -80,6 +83,5 @@
   "engineStrict": true,
   "publishConfig": {
     "access": "public"
-  },
-  "stableVersion": "1.17.7"
+  }
 }

package/src/CreatableProvider/AbstractCreatableProvider.ts

@@ -3,32 +3,38 @@ import { AbstractCreatable, assertEx } from '@xylabs/sdk-js'
 import type { Provider, ProviderMoniker } from '../model/index.ts'
 import type {
   CreatableProvider,
-  CreatableProviderEventData, CreatableProviderFactory, CreatableProviderInstance, CreatableProviderParams,
+  CreatableProviderEventData, CreatableProviderInstance, CreatableProviderParams,
+  ProviderMap,
 } from './CreatableProvider.ts'
 import { ProviderFactory } from './ProviderFactory.ts'
 
 export abstract class AbstractCreatableProvider<TParams extends CreatableProviderParams = CreatableProviderParams,
   TEventData extends CreatableProviderEventData = CreatableProviderEventData> extends AbstractCreatable<TParams, TEventData>
   implements Omit<CreatableProviderInstance, 'moniker'> {
+  dependencies: ProviderMap = {}
+
   protected _contextCache: TParams['context'] | undefined
 
-  get config() {
-    return assertEx(this.context.config, () => 'config is required')
+  abstract readonly moniker: ProviderMoniker
+
+  protected get config() {
+    return this.context.config!
   }
 
-  get context() {
-    return assertEx(this.params.context, () => 'context is required')
+  protected get context() {
+    return this.params.context!
   }
 
-  get locator() {
-    return assertEx(this.context.locator, () => 'locator is required')
+  protected get locator() {
+    return this.context.locator!
   }
 
-  static factory<TModule extends CreatableProviderInstance>(
-    this: CreatableProvider<TModule>,
-    params?: Partial<TModule['params']>,
-  ): CreatableProviderFactory<TModule> {
-    const factory = ProviderFactory.withParams<TModule>(this, params)
+  static factory<TInstance extends CreatableProviderInstance, TDependencies extends ProviderMoniker[] = ProviderMoniker[]>(
+    this: CreatableProvider<TInstance>,
+    dependencies: TDependencies,
+    params?: Partial<TInstance['params']>,
+  ) {
+    const factory = ProviderFactory.withParams<TInstance, TDependencies>(this, dependencies, params)
     return factory
   }
 
@@ -40,6 +46,22 @@ export abstract class AbstractCreatableProvider<TParams extends CreatableProvide
     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'],

package/src/CreatableProvider/CreatableProvider.ts

@@ -27,18 +27,25 @@ export interface CreatableProviderParams<TContext extends CreatableProviderConte
 }
 export interface CreatableProviderEventData extends EventData {}
 
-export type CreatableProviderInstance<TProvider extends Provider<ProviderMoniker> = Provider<ProviderMoniker>,
+export type CreatableProviderInstance<
+  TProvider extends Provider<ProviderMoniker> = Provider<ProviderMoniker>,
+  TDependencies extends ProviderMoniker[] = ProviderMoniker[],
   TParams extends CreatableProviderParams = CreatableProviderParams,
   TEventData extends CreatableProviderEventData = CreatableProviderEventData>
-  = CreatableInstance<TParams, TEventData> & TProvider
+  = CreatableInstance<TParams, TEventData> & TProvider & {
+    dependencies: ProviderMap<TDependencies[number]>
+  }
 
 export type ProviderFactoryScope = 'global' | 'context' | 'local'
 
-export interface CreatableProviderFactory<T extends CreatableProviderInstance = CreatableProviderInstance>
+export interface CreatableProviderFactory<T extends CreatableProviderInstance = CreatableProviderInstance,
+  TDependencies extends ProviderMoniker[] = ProviderMoniker[]>
   extends Omit<CreatableProvider<T>, 'create' | 'createHandler' | 'paramsHandler'> {
   creatableProvider: CreatableProvider<T>
   defaultParams?: Partial<T['params']>
 
+  readonly dependencies: TDependencies
+
   labels?: Labels
   resolvedMoniker: string
   scope: ProviderFactoryScope
@@ -46,26 +53,31 @@ export interface CreatableProviderFactory<T extends CreatableProviderInstance =
   /** @deprecated use getInstance instead */
   create(
     this: CreatableProviderFactory<T>,
-    params?: Partial<T['params']>, start?: boolean): Promise<T>
+    params?: Partial<T['params'] & CreatableProviderParams>, start?: boolean): Promise<T>
 
   getInstance(
     this: CreatableProviderFactory<T>,
-    params: T['params'], start?: boolean): Promise<T>
+    params: T['params'] & CreatableProviderParams, start?: boolean): Promise<T>
 
   tryGetInstance(
     this: CreatableProviderFactory<T>,
-    params: T['params'], start?: boolean): Promise<T | undefined>
+    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>
+export interface LabeledCreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance,
+  TDependencies extends ProviderMoniker[] = ProviderMoniker[]> extends CreatableProvider<T>, WithOptionalLabels {
+  factory(dependencies: TDependencies, 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>
+export type ProviderMap<T extends ProviderMoniker = ProviderMoniker> = Partial<Record<T, CreatableProviderInstance<Provider<T>>>>
+
+export interface CreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance,
+  TDependencies extends ProviderMoniker[] = ProviderMoniker[]> extends Creatable<T> {
+  readonly defaultMoniker: ProviderMoniker
+  readonly dependencies: TDependencies
+  readonly monikers: ProviderMoniker[]
+  factory(dependencies: TDependencies, params?: Partial<T['params'] & CreatableProviderParams>): CreatableProviderFactory<T>
 }
 
 /**

package/src/CreatableProvider/CreatableProviderRegistry.ts

@@ -5,9 +5,8 @@ import type { ProviderMoniker } from '../model/index.ts'
 import type { CreatableProviderFactory, CreatableProviderInstance } from './CreatableProvider.ts'
 import type { LabeledCreatableProviderFactory } from './LabeledCreatableProviderFactory.ts'
 
-export interface CreatableProviderRegistry {
-  [key: string]: (CreatableProviderFactory | LabeledCreatableProviderFactory)[] | undefined
-}
+export type CreatableProviderRegistry<TMonikers extends ProviderMoniker[] = ProviderMoniker[]>
+  = Record<TMonikers[number], (CreatableProviderFactory | LabeledCreatableProviderFactory)[] | undefined>
 
 const buildProviderFactory = <TProvider extends CreatableProviderInstance>(
   provider: CreatableProviderFactory<TProvider>,
@@ -16,11 +15,13 @@ const buildProviderFactory = <TProvider extends CreatableProviderInstance>(
   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,
+    dependencies: provider.dependencies,
     resolvedMoniker: provider.resolvedMoniker,
     scope: provider.scope,
     getInstance: provider.getInstance.bind(provider) as LabeledCreatableProviderFactory<TProvider>['getInstance'],

package/src/CreatableProvider/ProviderFactory.ts

@@ -1,6 +1,7 @@
 import type { Labels, WithOptionalLabels } from '@xylabs/sdk-js'
 import { assertEx } from '@xylabs/sdk-js'
 
+import type { ProviderMoniker } from '../model/index.ts'
 import type {
   CreatableProvider, CreatableProviderFactory, CreatableProviderInstance,
   ProviderFactoryScope,
@@ -10,13 +11,16 @@ declare global {
   var xyoServiceSingletons: Record<string, unknown>
 }
 
-export class ProviderFactory<TProvider extends CreatableProviderInstance> implements CreatableProviderFactory<TProvider> {
+export class ProviderFactory<TProvider extends CreatableProviderInstance,
+  TDependencies extends ProviderMoniker[]> implements CreatableProviderFactory<TProvider> {
   creatableProvider: CreatableProvider<TProvider>
 
   defaultMoniker: CreatableProvider<TProvider>['monikers'][number]
 
   defaultParams?: Partial<TProvider['params']>
 
+  dependencies: TDependencies
+
   labels?: Labels
 
   monikers: CreatableProvider<TProvider>['monikers']
@@ -25,6 +29,7 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
 
   constructor(
     creatableProvider: CreatableProvider<TProvider>,
+    dependencies: TDependencies,
     params?: Partial<TProvider['params']>,
     labels: Labels = {},
     scope: ProviderFactoryScope = 'context',
@@ -32,6 +37,7 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
     this.creatableProvider = creatableProvider
     this.defaultParams = params
     this.defaultMoniker = creatableProvider.defaultMoniker
+    this.dependencies = dependencies
     this.monikers = creatableProvider.monikers
     this.scope = scope
     assertEx(this.monikers.includes(this.defaultMoniker), () => 'defaultMoniker must be in monikers')
@@ -44,12 +50,13 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
     return labelString.length === 0 ? `${this.defaultMoniker}` : `${this.defaultMoniker}|${labelString}`
   }
 
-  static withParams<T extends CreatableProviderInstance>(
-    creatableProvider: CreatableProvider<T>,
-    params?: Partial<T['params']>,
+  static withParams<TInstance extends CreatableProviderInstance, TDependencies extends ProviderMoniker[]>(
+    creatableProvider: CreatableProvider<TInstance>,
+    dependencies: TDependencies,
+    params?: Partial<TInstance['params']>,
     labels: Labels = {},
   ) {
-    return new ProviderFactory<T>(creatableProvider, params, labels)
+    return new ProviderFactory<TInstance, TDependencies>(creatableProvider, dependencies, params, labels)
   }
 
   /** @deprecated use getInstance instead */
@@ -57,12 +64,13 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
     return await this.getInstance(params as TProvider['params'], start)
   }
 
-  factory<T extends CreatableProviderInstance>(
-    this: CreatableProviderFactory<T>,
-    params?: Partial<T['params']>,
+  factory<TInstance extends CreatableProviderInstance, TDependencies extends ProviderMoniker[]>(
+    this: CreatableProviderFactory<TInstance, TDependencies>,
+    dependencies: TDependencies,
+    params?: Partial<TInstance['params']>,
     labels: Labels = {},
-  ): CreatableProviderFactory<T> {
-    return new ProviderFactory<T>(this.creatableProvider, params, labels)
+  ) {
+    return new ProviderFactory<TInstance, TDependencies>(this.creatableProvider, dependencies, params, labels)
   }
 
   async getInstance(this: CreatableProviderFactory<TProvider>, params: TProvider['params'], start = true): Promise<TProvider> {
@@ -103,11 +111,12 @@ export class ProviderFactory<TProvider extends CreatableProviderInstance> implem
         },
       },
     } as TProvider['params']
-    const result = await this.creatableProvider.create<TProvider>(mergedParams)
+    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')
     }
-    scopeObject[this.resolvedMoniker] = result
     return result
   }
 

package/src/CreatableProvider/ProviderFactoryLocator.ts

@@ -12,15 +12,16 @@ import type { ProviderFactoryLocatorInstance } from './ProviderFactoryLocatorIns
 /**
  * A class which encapsulates the Service Locator Pattern for Provider Factories
  */
-export class ProviderFactoryLocator implements ProviderFactoryLocatorInstance {
-  protected readonly _context: CreatableProviderContext
-  protected readonly _registry: CreatableProviderRegistry
+export class ProviderFactoryLocator<TContext extends CreatableProviderContext = CreatableProviderContext,
+  TMonikers extends ProviderMoniker[] = ProviderMoniker[]> implements ProviderFactoryLocatorInstance<TContext> {
+  protected readonly _context: TContext
+  protected readonly _registry: CreatableProviderRegistry<TMonikers>
 
   private _frozen = false
 
-  constructor(context: Omit<CreatableProviderContext, 'locator'>, registry: CreatableProviderRegistry = {}) {
+  constructor(context: Omit<TContext, 'locator'>, registry: CreatableProviderRegistry = {}) {
     this._registry = registry
-    this._context = { ...context, locator: this }
+    this._context = { ...context, locator: this } as unknown as TContext
   }
 
   get context() {
@@ -68,7 +69,8 @@ export class ProviderFactoryLocator implements ProviderFactoryLocatorInstance {
       } as CreatableProviderInstance<TProvider>['params']['context'],
     } as CreatableProviderInstance<TProvider>['params']
     const factory = this.locate<TProvider>(moniker, labels)
-    return await factory.getInstance(resolvedParams)
+    const result = await factory.getInstance(resolvedParams)
+    return result
   }
 
   /**

package/src/CreatableProvider/ProviderFactoryLocatorInstance.ts

@@ -1,11 +1,15 @@
 import type { Labels } from '@xylabs/sdk-js'
 
 import type { Provider, ProviderMoniker } from '../model/index.ts'
-import type { CreatableProviderFactory, CreatableProviderInstance } from './CreatableProvider.ts'
+import type {
+  CreatableProviderContext, CreatableProviderFactory, CreatableProviderInstance,
+} from './CreatableProvider.ts'
 import type { CreatableProviderRegistry } from './CreatableProviderRegistry.ts'
 import type { LabeledCreatableProviderFactory } from './LabeledCreatableProviderFactory.ts'
 
-export interface ProviderFactoryLocatorInstance {
+export interface ProviderFactoryLocatorInstance<T extends CreatableProviderContext = CreatableProviderContext> {
+
+  context: T
 
   /**
    * The current registry for the module factory