@xyo-network/chain-orchestration 1.20.22 → 1.20.24

package/dist/browser/shared/init/walletResolution.d.ts

@@ -1,6 +1,12 @@
 import type { Address } from '@xylabs/sdk-js';
 import type { WalletInstance } from '@xyo-network/wallet-model';
 import type { ActorConfig, Config } from '@xyo-network/xl1-sdk';
+/**
+ * Default BIP-32 derivation path per actor, expressed as a *relative* path
+ * (the consumer appends it to the root wallet base path). Each actor resolves
+ * to a distinct slot to avoid collisions out of the box.
+ */
+export declare const DEFAULT_ACTOR_ACCOUNT_PATH: Record<string, string>;
 export declare const BUILT_IN_DEV_MNEMONIC = "crane ribbon cook cousin tobacco vital moral protect merit knock veteran hint knee ocean nurse";
 export declare const INSECURE_GENESIS_REWARD_MNEMONIC = "test test test test test test test test test test test junk";
 export declare const GENESIS_REWARD_AMOUNT = 20000000000000000000000n;
@@ -10,11 +16,9 @@ export type RootMnemonicConfig = Config & {
     mnemonic?: string;
 };
 type ActorWalletConfig = Partial<ActorConfig> & {
-    accountIndex?: number;
-    mnemonic?: string;
+    accountPath?: string;
 };
-export type WalletSource = 'root' | 'actor';
-export type MnemonicKind = 'built-in-dev' | 'configured-root' | 'configured-actor';
+export type MnemonicKind = 'built-in-dev' | 'configured-root' | 'insecure-genesis-reward';
 export interface ResolvedRootWallet {
     basePath: string;
     isBuiltInDevMnemonic: boolean;
@@ -23,7 +27,7 @@ export interface ResolvedRootWallet {
     mnemonicKind: Extract<MnemonicKind, 'built-in-dev' | 'configured-root'>;
 }
 export interface ResolvedWalletMetadata {
-    accountIndex: number;
+    accountPath: string;
     actorName: string;
     address: string;
     derivationPath: string;
@@ -31,22 +35,46 @@ export interface ResolvedWalletMetadata {
     mnemonic: string;
     mnemonicKind: MnemonicKind;
     privateKey?: string;
-    source: WalletSource;
     usesBuiltInDevMnemonic: boolean;
 }
 export interface ResolvedWalletReport {
-    actorSpecificAccounts: ResolvedWalletMetadata[];
-    isRootRequired: boolean;
     requestedActors: string[];
     root: ResolvedRootWallet;
     sharedAccounts: ResolvedWalletMetadata[];
 }
 export declare function clearResolvedWalletReport(): void;
-export declare function getReservedActorIndex(actorName: string): number;
+/**
+ * Resolve the effective BIP-32 derivation path for an actor.
+ *
+ * - If the actor config specifies `accountPath`, use it.
+ * - Otherwise fall back to `DEFAULT_ACTOR_ACCOUNT_PATH[actorName]`.
+ * - Otherwise fall back to `"0"` (a relative path that derives to the first slot
+ *   under the root wallet's base path).
+ *
+ * The returned value is exactly what the user provided (or the default) —
+ * absolute paths keep their `m/` prefix; relative paths do not.
+ */
+export declare function resolveActorAccountPath(actorName: string, actorConfig?: ActorWalletConfig): string;
+export declare function isAbsoluteAccountPath(accountPath: string): boolean;
+/**
+ * Expand a (possibly relative) actor accountPath into a fully qualified BIP-32
+ * derivation path. Used for reporting and collision detection.
+ */
+export declare function expandAccountPath(accountPath: string, basePath?: string): string;
 export declare function getBuiltInDevMnemonic(): string;
 export declare function getInsecureGenesisRewardMnemonic(): string;
 export declare function resolveRootWallet(configuration: RootMnemonicConfig): ResolvedRootWallet;
 export declare function resolveActorWallet(actorName: string, actorConfig: ActorWalletConfig | undefined, root: ResolvedRootWallet): Promise<ResolvedWalletMetadata>;
+export declare class ActorMnemonicNotAllowedError extends Error {
+    readonly actors: string[];
+    constructor(actors: string[]);
+}
+export declare function assertNoActorMnemonics(configuration: RootMnemonicConfig): void;
+export declare class DerivationPathCollisionError extends Error {
+    readonly collisions: Record<string, string[]>;
+    constructor(collisions: Record<string, string[]>);
+}
+export declare function detectDerivationPathCollisions(requestedActors: string[], configuration: RootMnemonicConfig): DerivationPathCollisionError | undefined;
 export declare function resolveWalletReport(requestedActors: string[], configuration: RootMnemonicConfig): Promise<ResolvedWalletReport>;
 export declare function buildInsecureGenesisRewardAccounts(): Promise<ResolvedWalletMetadata[]>;
 export declare function initializeResolvedWalletReport(requestedActors: string[], configuration: RootMnemonicConfig): Promise<ResolvedWalletReport>;
@@ -54,6 +82,6 @@ export declare function getResolvedWalletReport(): ResolvedWalletReport | undefi
 export declare function formatWalletReport(report: ResolvedWalletReport): string;
 export declare function formatInsecureGenesisRewardWarning(accounts: ResolvedWalletMetadata[]): string;
 export declare function resolveGenesisRewardAddress(config: Pick<Config, 'chain'>): Promise<Address>;
-export declare function resolveWalletForActor(actorName: string, mnemonic?: string, accountIndex?: number): Promise<WalletInstance>;
+export declare function resolveWalletForActor(actorName: string, accountPath?: string): Promise<WalletInstance>;
 export {};
 //# sourceMappingURL=walletResolution.d.ts.map

package/dist/browser/shared/init/walletResolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"walletResolution.d.ts","sourceRoot":"","sources":["../../../../src/shared/init/walletResolution.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"walletResolution.d.ts","sourceRoot":"","sources":["../../../../src/shared/init/walletResolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAI/D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO7D,CAAA;AAED,eAAO,MAAM,qBAAqB,mGAAmG,CAAA;AACrI,eAAO,MAAM,gCAAgC,gEAAgE,CAAA;AAC7G,eAAO,MAAM,qBAAqB,2BAAkC,CAAA;AAGpE,eAAO,MAAM,sBAAsB,UAAU,CAAA;AAC7C,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAC7C,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAC/D,KAAK,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,iBAAiB,GAAG,yBAAyB,CAAA;AAEzF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,oBAAoB,EAAE,OAAO,CAAA;IAC7B,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,cAAc,GAAG,iBAAiB,CAAC,CAAA;CACxE;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,YAAY,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sBAAsB,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,IAAI,EAAE,kBAAkB,CAAA;IACxB,cAAc,EAAE,sBAAsB,EAAE,CAAA;CACzC;AAkBD,wBAAgB,yBAAyB,SAExC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAGlG;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAElE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA4B,GAAG,MAAM,CAErG;AAgBD,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAgB,gCAAgC,IAAI,MAAM,CAEzD;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,kBAAkB,GAAG,kBAAkB,CAWvF;AA2BD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,iBAAiB,GAAG,SAAS,EAC1C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAOjC;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAA;gBACb,MAAM,EAAE,MAAM,EAAE;CAQ7B;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,kBAAkB,GAAG,IAAI,CAK9E;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;gBACjC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAYjD;AAED,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,MAAM,EAAE,EACzB,aAAa,EAAE,kBAAkB,GAChC,4BAA4B,GAAG,SAAS,CAgB1C;AAED,wBAAsB,mBAAmB,CACvC,eAAe,EAAE,MAAM,EAAE,EACzB,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAiC/B;AAED,wBAAsB,kCAAkC,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAa5F;AAED,wBAAsB,8BAA8B,CAClD,eAAe,EAAE,MAAM,EAAE,EACzB,aAAa,EAAE,kBAAkB,GAChC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,SAAS,CAE1E;AAwBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CA2BvE;AAED,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,sBAAsB,EAAE,GAAG,MAAM,CAiB7F;AAED,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAKjG;AAED,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAK5G"}