@dynamic-labs-wallet/node 0.0.323 → 0.0.324

package/index.cjs.js

@@ -588,8 +588,8 @@ class DynamicWalletClient {
             externalServerKeyShares: externalServerKeygenResults
         };
     }
-    async dynamicServerSign({ walletId, message, isFormatted, context, bitcoinConfig, onError }) {
-        const dynamicRequestId = uuid.v4();
+    async dynamicServerSign({ walletId, message, isFormatted, context, bitcoinConfig, onError, dynamicRequestId: providedRequestId }) {
+        const dynamicRequestId = providedRequestId || uuid.v4();
         this.ensureApiClientAuthenticated();
         // Create the room and sign the message
         if (typeof message !== 'string') {
@@ -605,7 +605,9 @@ class DynamicWalletClient {
             forwardMPCClientEnabled: this.forwardMPCEnabled,
             bitcoinConfig
         });
-        return data;
+        return _extends({}, data, {
+            dynamicRequestId
+        });
     }
     async externalServerSign({ chainName, message, roomId, keyShare, derivationPath, isFormatted, bitcoinConfig }) {
         try {
@@ -623,7 +625,7 @@ class DynamicWalletClient {
             throw error;
         }
     }
-    async forwardMPCClientSign({ chainName, message, roomId, keyShare, derivationPath, formattedMessage, dynamicRequestId, isFormatted }) {
+    async forwardMPCClientSign({ chainName, message, roomId, keyShare, derivationPath, formattedMessage, dynamicRequestId, isFormatted, walletId }) {
         try {
             const messageForForwardMPC = core$1.serializeMessageForForwardMPC({
                 message,
@@ -640,7 +642,12 @@ class DynamicWalletClient {
                 signingAlgo: chainName === 'EVM' ? 'ECDSA' : 'ED25519',
                 hashAlgo: chainName === 'EVM' && !isFormatted ? 'keccak256' : undefined,
                 derivationPath: derivationPath,
-                roomUuid: roomId
+                roomUuid: roomId,
+                walletId,
+                environmentId: this.environmentId,
+                traceContext: {
+                    traceId: dynamicRequestId
+                }
             });
             if (!(signatureBytes instanceof Uint8Array)) {
                 throw new TypeError(`Invalid signature format: expected Uint8Array, got ${typeof signatureBytes}`);
@@ -655,6 +662,7 @@ class DynamicWalletClient {
         } catch (error) {
             this.logger.error('Error signing message with forward MPC client', {
                 error,
+                walletId,
                 environmentId: this.environmentId,
                 dynamicRequestId
             });
@@ -706,8 +714,9 @@ class DynamicWalletClient {
                     keyShare: externalServerKeyShares[0],
                     derivationPath,
                     formattedMessage,
-                    dynamicRequestId: uuid.v4(),
-                    isFormatted
+                    dynamicRequestId: data.dynamicRequestId,
+                    isFormatted,
+                    walletId: wallet.walletId
                 });
                 return signature;
             } else {

package/index.esm.js

@@ -587,8 +587,8 @@ class DynamicWalletClient {
             externalServerKeyShares: externalServerKeygenResults
         };
     }
-    async dynamicServerSign({ walletId, message, isFormatted, context, bitcoinConfig, onError }) {
-        const dynamicRequestId = v4();
+    async dynamicServerSign({ walletId, message, isFormatted, context, bitcoinConfig, onError, dynamicRequestId: providedRequestId }) {
+        const dynamicRequestId = providedRequestId || v4();
         this.ensureApiClientAuthenticated();
         // Create the room and sign the message
         if (typeof message !== 'string') {
@@ -604,7 +604,9 @@ class DynamicWalletClient {
             forwardMPCClientEnabled: this.forwardMPCEnabled,
             bitcoinConfig
         });
-        return data;
+        return _extends({}, data, {
+            dynamicRequestId
+        });
     }
     async externalServerSign({ chainName, message, roomId, keyShare, derivationPath, isFormatted, bitcoinConfig }) {
         try {
@@ -622,7 +624,7 @@ class DynamicWalletClient {
             throw error;
         }
     }
-    async forwardMPCClientSign({ chainName, message, roomId, keyShare, derivationPath, formattedMessage, dynamicRequestId, isFormatted }) {
+    async forwardMPCClientSign({ chainName, message, roomId, keyShare, derivationPath, formattedMessage, dynamicRequestId, isFormatted, walletId }) {
         try {
             const messageForForwardMPC = serializeMessageForForwardMPC({
                 message,
@@ -639,7 +641,12 @@ class DynamicWalletClient {
                 signingAlgo: chainName === 'EVM' ? 'ECDSA' : 'ED25519',
                 hashAlgo: chainName === 'EVM' && !isFormatted ? 'keccak256' : undefined,
                 derivationPath: derivationPath,
-                roomUuid: roomId
+                roomUuid: roomId,
+                walletId,
+                environmentId: this.environmentId,
+                traceContext: {
+                    traceId: dynamicRequestId
+                }
             });
             if (!(signatureBytes instanceof Uint8Array)) {
                 throw new TypeError(`Invalid signature format: expected Uint8Array, got ${typeof signatureBytes}`);
@@ -654,6 +661,7 @@ class DynamicWalletClient {
         } catch (error) {
             this.logger.error('Error signing message with forward MPC client', {
                 error,
+                walletId,
                 environmentId: this.environmentId,
                 dynamicRequestId
             });
@@ -705,8 +713,9 @@ class DynamicWalletClient {
                     keyShare: externalServerKeyShares[0],
                     derivationPath,
                     formattedMessage,
-                    dynamicRequestId: v4(),
-                    isFormatted
+                    dynamicRequestId: data.dynamicRequestId,
+                    isFormatted,
+                    walletId: wallet.walletId
                 });
                 return signature;
             } else {

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@dynamic-labs-wallet/node",
-  "version": "0.0.323",
+  "version": "0.0.324",
   "license": "Licensed under the Dynamic Labs, Inc. Terms Of Service (https://www.dynamic.xyz/terms-conditions)",
   "type": "module",
   "dependencies": {
-    "@dynamic-labs-wallet/core": "0.0.323",
+    "@dynamic-labs-wallet/core": "0.0.324",
     "@dynamic-labs-wallet/forward-mpc-client": "0.5.5",
     "@dynamic-labs/logger": "^4.45.2",
     "@dynamic-labs/sdk-api-core": "^0.0.900",

package/src/backup/encryption.d.ts

@@ -0,0 +1,62 @@
+import type { EncryptionMetadata } from '@dynamic-labs-wallet/core';
+export declare const ENCRYPTION_VERSION_LEGACY = "v1";
+export declare const ENCRYPTION_VERSION_CURRENT = "v2";
+export declare const PBKDF2_ALGORITHM = "PBKDF2";
+export declare const PBKDF2_HASH_ALGORITHM = "SHA-256";
+export declare const AES_GCM_ALGORITHM = "AES-GCM";
+export declare const AES_GCM_LENGTH = 256;
+export declare const ENCRYPTION_VERSIONS: {
+    readonly v1: {
+        readonly version: "v1";
+        readonly algorithm: "AES-GCM";
+        readonly keyDerivation: "PBKDF2";
+        readonly iterations: 100000;
+        readonly hashAlgorithm: "SHA-256";
+        readonly algorithmLength: 256;
+    };
+    readonly v2: {
+        readonly version: "v2";
+        readonly algorithm: "AES-GCM";
+        readonly keyDerivation: "PBKDF2";
+        readonly iterations: 1000000;
+        readonly hashAlgorithm: "SHA-256";
+        readonly algorithmLength: 256;
+    };
+};
+export declare const PBKDF2_ITERATIONS: 1000000;
+export declare const PBKDF2_ITERATIONS_LEGACY: 100000;
+export type EncryptionVersion = (typeof ENCRYPTION_VERSIONS)[keyof typeof ENCRYPTION_VERSIONS];
+/**
+ * Encrypts data using the specified encryption version.
+ * Always uses the latest encryption configuration for new encryptions by default.
+ */
+export declare const encryptData: ({ data, password, version, }: {
+    data: string;
+    password: string;
+    version?: string;
+}) => Promise<{
+    salt: string;
+    iv: string;
+    cipher: string;
+    version: string;
+}>;
+/**
+ * Decrypts data with version-based configuration.
+ * Uses the version field from the data to determine encryption parameters.
+ * Falls back to legacy version for backward compatibility if no version is specified.
+ */
+export declare const decryptData: ({ data, password, }: {
+    data: {
+        salt: string;
+        iv: string;
+        cipher: string;
+        version?: string;
+    };
+    password: string;
+}) => Promise<string>;
+/**
+ * Gets encryption metadata for a specific version.
+ * Used when we need to include metadata in legacy systems or APIs that require it.
+ */
+export declare const getEncryptionMetadataForVersion: (version: string) => EncryptionMetadata;
+//# sourceMappingURL=encryption.d.ts.map

package/src/backup/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/backup/encryption.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,eAAO,MAAM,gBAAgB,WAAW,CAAC;AACzC,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAC/C,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;CAiBtB,CAAC;AAEX,eAAO,MAAM,iBAAiB,SAA6D,CAAC;AAC5F,eAAO,MAAM,wBAAwB,QAA4D,CAAC;AAElG,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAC;AAgC/F;;;GAGG;AACH,eAAO,MAAM,WAAW,iCAIrB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;;;;;EA6BA,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,wBAGrB;IACD,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB,oBAmCA,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,YAAa,MAAM,KAAG,kBAajE,CAAC"}

package/src/backup/utils.d.ts

@@ -0,0 +1,4 @@
+import type { ServerKeyShare } from '../mpc/types.js';
+import type { WalletProperties } from '../types.js';
+export declare const checkIfExternalServerKeySharesAreRequired: (wallet: WalletProperties, externalServerKeyShares?: ServerKeyShare[]) => void;
+//# sourceMappingURL=utils.d.ts.map

package/src/backup/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/backup/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,eAAO,MAAM,yCAAyC,WAC5C,gBAAgB,4BACE,cAAc,EAAE,SAW3C,CAAC"}

package/src/client.d.ts

@@ -0,0 +1,353 @@
+import { BIP340KeygenResult, EcdsaKeygenResult, EcdsaSignature, MessageHash, type EcdsaPublicKey } from '#internal/node';
+import { BackupLocation, DynamicApiClient, ThresholdSignatureScheme, type ILogger, WalletOperation, type BitcoinConfig, type KeyShareBackupInfo, type RequestWithElevatedAccessToken } from '@dynamic-labs-wallet/core';
+import { ForwardMPCClientV2 } from '@dynamic-labs-wallet/forward-mpc-client';
+import type { SignMessageContext } from '@dynamic-labs/sdk-api-core';
+import type { ServerKeyShare } from './mpc/index.js';
+import type { ServerInitKeygenResult } from './mpc/types.js';
+import type { DynamicWalletClientProps, WalletProperties } from './types.js';
+export declare class DynamicWalletClient {
+    environmentId: string;
+    debug: boolean;
+    protected logger: ILogger;
+    protected apiClient: DynamicApiClient;
+    protected walletMap: Record<string, WalletProperties>;
+    protected baseMPCRelayApiUrl?: string;
+    protected baseJWTAuthToken?: string;
+    protected baseApiUrl?: string;
+    protected isApiClientAuthenticated: boolean;
+    protected forwardMPCEnabled: boolean;
+    protected resolvedForwardMPCClient: ForwardMPCClientV2 | undefined;
+    constructor({ environmentId, baseApiUrl, baseMPCRelayApiUrl, debug, forwardMPCClient, enableMPCAccelerator, logger, }: DynamicWalletClientProps);
+    private ensureApiClientAuthenticated;
+    authenticateApiToken(authToken: string): Promise<void>;
+    dynamicServerInitializeKeyGen({ chainName, externalServerKeygenIds, thresholdSignatureScheme, dynamicRequestId, skipLock, bitcoinConfig, onError, onCeremonyComplete, }: {
+        chainName: string;
+        externalServerKeygenIds: string[];
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        dynamicRequestId: string;
+        skipLock?: boolean;
+        bitcoinConfig?: BitcoinConfig;
+        onError?: (error: Error) => void;
+        onCeremonyComplete?: (accountAddress: string, walletId: string) => void;
+    }): Promise<import("@dynamic-labs-wallet/core").KeygenCompleteResponse>;
+    externalServerInitializeKeyGen({ chainName, thresholdSignatureScheme, bitcoinConfig, }: {
+        chainName: string;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        bitcoinConfig?: BitcoinConfig;
+    }): Promise<ServerInitKeygenResult[]>;
+    derivePublicKey({ chainName, keyShare, derivationPath, bitcoinConfig, }: {
+        chainName: string;
+        keyShare: ServerKeyShare;
+        derivationPath: Uint32Array | undefined;
+        bitcoinConfig?: BitcoinConfig;
+    }): Promise<string | EcdsaPublicKey | Uint8Array | undefined>;
+    forwardMPCExternalServerKeyGen({ chainName, roomId, dynamicServerKeygenIds, externalServerInitKeygenResults, thresholdSignatureScheme, bitcoinConfig, }: {
+        chainName: string;
+        roomId: string;
+        dynamicServerKeygenIds: string[];
+        externalServerInitKeygenResults: ServerInitKeygenResult[];
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        bitcoinConfig?: BitcoinConfig;
+    }): Promise<{
+        rawPublicKey: EcdsaPublicKey | Uint8Array | string | undefined;
+        externalServerKeyGenResults: ServerKeyShare[];
+    }>;
+    externalServerKeyGen({ chainName, roomId, dynamicServerKeygenIds, externalServerInitKeygenResults, thresholdSignatureScheme, bitcoinConfig, }: {
+        chainName: string;
+        roomId: string;
+        dynamicServerKeygenIds: string[];
+        externalServerInitKeygenResults: ServerInitKeygenResult[];
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        bitcoinConfig?: BitcoinConfig;
+    }): Promise<{
+        rawPublicKey: EcdsaPublicKey | Uint8Array | string | undefined;
+        externalServerKeyGenResults: ServerKeyShare[];
+    }>;
+    keyGen({ chainName, thresholdSignatureScheme, skipLock, bitcoinConfig, onError, onCeremonyComplete, }: {
+        chainName: string;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        skipLock?: boolean;
+        bitcoinConfig?: BitcoinConfig;
+        onError?: (error: Error) => void;
+        onCeremonyComplete?: (accountAddress: string, walletId: string) => void;
+    }): Promise<{
+        rawPublicKey: EcdsaPublicKey | Uint8Array | string | undefined;
+        externalServerKeyShares: ServerKeyShare[];
+    }>;
+    importRawPrivateKey({ chainName, privateKey, thresholdSignatureScheme, bitcoinConfig, onError, onCeremonyComplete, }: {
+        chainName: string;
+        privateKey: string;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        bitcoinConfig?: BitcoinConfig;
+        onError?: (error: Error) => void;
+        onCeremonyComplete?: (accountAddress: string, walletId: string) => void;
+    }): Promise<{
+        rawPublicKey: EcdsaPublicKey | Uint8Array | string | undefined;
+        externalServerKeyShares: ServerKeyShare[];
+    }>;
+    dynamicServerSign({ walletId, message, isFormatted, context, bitcoinConfig, onError, dynamicRequestId: providedRequestId, }: {
+        walletId: string;
+        message: string | Uint8Array;
+        isFormatted?: boolean;
+        context?: SignMessageContext;
+        bitcoinConfig?: BitcoinConfig;
+        onError?: (error: Error) => void;
+        dynamicRequestId?: string;
+    }): Promise<{
+        dynamicRequestId: string;
+        roomId: string;
+        serverKeygenIds: string[];
+    }>;
+    externalServerSign({ chainName, message, roomId, keyShare, derivationPath, isFormatted, bitcoinConfig, }: {
+        chainName: string;
+        message: string | Uint8Array;
+        roomId: string;
+        keyShare: ServerKeyShare;
+        derivationPath: Uint32Array | undefined;
+        isFormatted?: boolean;
+        bitcoinConfig?: BitcoinConfig;
+    }): Promise<Uint8Array | EcdsaSignature>;
+    forwardMPCClientSign({ chainName, message, roomId, keyShare, derivationPath, formattedMessage, dynamicRequestId, isFormatted, walletId, }: {
+        chainName: string;
+        message: string | Uint8Array;
+        roomId: string;
+        keyShare: ServerKeyShare;
+        derivationPath: Uint32Array | undefined;
+        formattedMessage: string | Uint8Array | MessageHash;
+        dynamicRequestId: string;
+        isFormatted?: boolean;
+        walletId?: string;
+    }): Promise<Uint8Array | EcdsaSignature>;
+    sign({ accountAddress, externalServerKeyShares, message, chainName, password, isFormatted, context, onError, bitcoinConfig, }: {
+        accountAddress: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        message: string | Uint8Array;
+        chainName: string;
+        password?: string;
+        isFormatted?: boolean;
+        context?: SignMessageContext;
+        bitcoinConfig?: BitcoinConfig;
+        onError?: (error: Error) => void;
+    }): Promise<Uint8Array | EcdsaSignature>;
+    refreshWalletAccountShares({ accountAddress, chainName, password, externalServerKeyShares, backUpToClientShareService, }: {
+        accountAddress: string;
+        chainName: string;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        backUpToClientShareService?: boolean;
+    }): Promise<(EcdsaKeygenResult | BIP340KeygenResult)[]>;
+    getExportId({ chainName, serverKeyShare, bitcoinConfig, }: {
+        chainName: string;
+        serverKeyShare: ServerKeyShare;
+        bitcoinConfig?: BitcoinConfig;
+    }): Promise<string>;
+    /**
+     * Helper function to create client shares required to complete a reshare ceremony.
+     * @param {string} chainName - The chain to create shares for
+     * @param {WalletProperties} wallet - The wallet to reshare
+     * @param {ThresholdSignatureScheme} oldThresholdSignatureScheme - The current threshold signature scheme
+     * @param {ThresholdSignatureScheme} newThresholdSignatureScheme - The target threshold signature scheme
+     * @returns {Promise<{
+     *   newClientInitKeygenResults: ClientInitKeygenResult[],
+     *   newClientKeygenIds: string[],
+     *   existingClientKeygenIds: string[],
+     *   existingClientKeyShares: ClientKeyShare[]
+     * }>} Object containing new and existing client keygen results, IDs and shares
+     * @todo Support higher to lower reshare strategies
+     */
+    reshareStrategy({ chainName, wallet, oldThresholdSignatureScheme, newThresholdSignatureScheme, }: {
+        chainName: string;
+        wallet: WalletProperties;
+        oldThresholdSignatureScheme: ThresholdSignatureScheme;
+        newThresholdSignatureScheme: ThresholdSignatureScheme;
+    }): Promise<{
+        newExternalServerInitKeygenResults: ServerInitKeygenResult[];
+        newExternalServerKeygenIds: string[];
+        existingExternalServerKeygenIds: string[];
+        existingExternalServerKeyShares: ServerKeyShare[];
+    }>;
+    reshare({ chainName, accountAddress, oldThresholdSignatureScheme, newThresholdSignatureScheme, password, externalServerKeyShares, backUpToClientShareService, }: {
+        chainName: string;
+        accountAddress: string;
+        oldThresholdSignatureScheme: ThresholdSignatureScheme;
+        newThresholdSignatureScheme: ThresholdSignatureScheme;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        backUpToClientShareService?: boolean;
+    }): Promise<(EcdsaKeygenResult | BIP340KeygenResult)[]>;
+    exportKey({ accountAddress, chainName, password, externalServerKeyShares, bitcoinConfig, elevatedAccessToken, }: RequestWithElevatedAccessToken<{
+        accountAddress: string;
+        chainName: string;
+        password?: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        bitcoinConfig?: BitcoinConfig;
+    }>): Promise<{
+        derivedPrivateKey: string | undefined;
+    }>;
+    offlineExportKey({ chainName, keyShares, derivationPath, }: {
+        chainName: string;
+        keyShares: ServerKeyShare[];
+        derivationPath?: string;
+    }): Promise<{
+        derivedPrivateKey: string | undefined;
+    }>;
+    encryptKeyShare({ keyShare, password }: {
+        keyShare: ServerKeyShare;
+        password?: string;
+    }): Promise<string>;
+    ensureCeremonyCompletionBeforeBackup({ accountAddress }: {
+        accountAddress: string;
+    }): Promise<void>;
+    storeEncryptedBackupByWallet({ accountAddress, externalServerKeyShares, password, backUpToClientShareService, }: {
+        accountAddress: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        password?: string;
+        backUpToClientShareService: boolean;
+    }): Promise<{
+        share: ServerKeyShare;
+        backedUpToClientKeyShareService: boolean;
+    }[]>;
+    storeEncryptedBackupByWalletWithRetry({ accountAddress, externalServerKeyShares, password, backUpToClientShareService, }: {
+        accountAddress: string;
+        externalServerKeyShares?: ServerKeyShare[];
+        password?: string;
+        backUpToClientShareService: boolean;
+    }): Promise<Array<{
+        share: ServerKeyShare;
+        backedUpToClientKeyShareService: boolean;
+    }>>;
+    getExternalServerKeyShares({ accountAddress, password }: {
+        accountAddress: string;
+        password?: string;
+    }): Promise<any[]>;
+    updatePassword({ accountAddress, existingPassword, newPassword, backUpToClientShareService, }: {
+        accountAddress: string;
+        existingPassword?: string;
+        newPassword?: string;
+        backUpToClientShareService: boolean;
+    }): Promise<void>;
+    decryptKeyShare({ keyShare, password }: {
+        keyShare: string;
+        password?: string;
+    }): Promise<ServerKeyShare>;
+    /**
+     * Helper function to determine keyshare recovery strategy for dynamic shares.
+     * For REFRESH operations, retrieves enough shares to meet the client threshold.
+     * For all other operations, retrieves just 1 share.
+     *
+     * @param clientKeyShareBackupInfo - Information about backed up key shares
+     * @param thresholdSignatureScheme - The signature scheme being used (2-of-2, 2-of-3, etc)
+     * @param walletOperation - The operation being performed (REFRESH, SIGN_MESSAGE, etc)
+     * @param shareCount - The number of shares to recover if specified for reshare operations
+     * @returns @shares: Object mapping backup locations to arrays of share IDs to recover
+     * @returns @requiredShareCount: The number of shares required to recover
+     */
+    recoverStrategy({ externalServerKeySharesBackupInfo, thresholdSignatureScheme, walletOperation, shareCount, }: {
+        externalServerKeySharesBackupInfo: KeyShareBackupInfo;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        walletOperation: WalletOperation;
+        shareCount?: number;
+    }): {
+        shares: Partial<Record<BackupLocation, string[]>>;
+        requiredShareCount: number;
+    };
+    /**
+     * Attempts to recover key shares from backup if they are not provided.
+     * The recovered shares will be stored in the wallet map for use in signing operations.
+     * @param accountAddress - The account address to recover shares for
+     * @param password - The password to decrypt the shares
+     * @param walletOperation - The wallet operation being performed
+     * @param externalServerKeyShares - The provided key shares (if any)
+     * @param errorMessage - The error message to throw if recovery fails
+     * @throws Error if recovery is needed but fails
+     */
+    protected ensureKeySharesRecovered({ accountAddress, password, walletOperation, externalServerKeyShares, errorMessage, }: {
+        accountAddress: string;
+        password?: string;
+        walletOperation: WalletOperation;
+        externalServerKeyShares?: ServerKeyShare[];
+        errorMessage: string;
+    }): Promise<void>;
+    recoverEncryptedBackupByWallet({ accountAddress, password, walletOperation, shareCount, storeRecoveredShares, }: {
+        accountAddress: string;
+        password?: string;
+        walletOperation: WalletOperation;
+        shareCount?: number;
+        storeRecoveredShares?: boolean;
+    }): Promise<any[]>;
+    exportExternalServerKeyShares({ accountAddress, password }: {
+        accountAddress: string;
+        password?: string;
+    }): Promise<any[]>;
+    /**
+     * Helper function to check if the required wallet fields are present and valid
+     * @param accountAddress - The account address of the wallet to check
+     * @param walletOperation - The wallet operation that determines required fields
+     * @returns boolean indicating if wallet needs to be re-fetched and restored from server
+     */
+    private checkWalletFields;
+    /**
+     * verifyPassword attempts to recover and decrypt a single client key share using the provided password.
+     * If successful, the key share is encrypted with the new password. This method solely performs the recovery
+     * and decryption without storing the restored key shares. If unsuccessful, it throws an error.
+     */
+    verifyPassword({ accountAddress, password }: {
+        accountAddress: string;
+        password?: string;
+    }): Promise<void>;
+    isPasswordEncrypted({ accountAddress }: {
+        accountAddress: string;
+    }): Promise<boolean>;
+    /**
+     * check if the operation requires a password
+     */
+    requiresPasswordForOperation({ accountAddress, walletOperation, }: {
+        accountAddress: string;
+        walletOperation?: WalletOperation;
+    }): Promise<boolean>;
+    /**
+     * check if the operation requires restoring backup shares
+     */
+    requiresRestoreBackupSharesForOperation({ accountAddress, walletOperation, }: {
+        accountAddress: string;
+        walletOperation?: WalletOperation;
+    }): Promise<boolean>;
+    getWalletExternalServerKeyShareBackupInfo({ accountAddress, }: {
+        accountAddress: string;
+    }): Promise<KeyShareBackupInfo>;
+    getWallet({ accountAddress, walletOperation, shareCount, password, }: {
+        accountAddress: string;
+        walletOperation?: WalletOperation;
+        shareCount?: number;
+        password?: string;
+    }): Promise<WalletProperties>;
+    /**
+     * Get a single wallet by address
+     * First tries the efficient getWaasWalletByAddress endpoint, falls back to getUser() if not available
+     */
+    getWalletByAddress(accountAddress: string): Promise<WalletProperties | null>;
+    /**
+     * Get all wallets (kept for backward compatibility but now uses lazy loading)
+     * @deprecated Consider using getWalletByAddress for better performance with large wallet counts
+     */
+    getWallets(): Promise<WalletProperties[]>;
+    /**
+     * Helper method to initialize or update a wallet entry in the walletMap.
+     * This provides a consistent way to set up wallet properties across different operations.
+     * @param accountAddress - The account address for the wallet
+     * @param walletId - The wallet ID
+     * @param chainName - The chain name (e.g., 'BTC', 'EVM')
+     * @param thresholdSignatureScheme - The threshold signature scheme
+     * @param derivationPath - Optional derivation path for the wallet
+     * @param additionalProps - Optional additional properties to merge into the wallet entry
+     */
+    protected initializeWalletMapEntry({ accountAddress, walletId, chainName, thresholdSignatureScheme, derivationPath, additionalProps, }: {
+        accountAddress: string;
+        walletId: string;
+        chainName: string;
+        thresholdSignatureScheme: ThresholdSignatureScheme;
+        derivationPath?: string;
+        additionalProps?: Record<string, unknown>;
+    }): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/src/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../packages/src/client.ts"],"names":[],"mappings":"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"}

package/src/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_LOG_LEVEL = "INFO";
+//# sourceMappingURL=constants.d.ts.map

package/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../packages/src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,SAAS,CAAC"}

package/src/core/createCore.d.ts

@@ -0,0 +1,43 @@
+import { DynamicApiClient, type ILogger } from '@dynamic-labs-wallet/core';
+export type CoreConfig = {
+    environmentId: string;
+    baseApiUrl?: string;
+    baseMPCRelayApiUrl?: string;
+    /**
+     * Enables verbose debug-level logging when `true`.
+     *
+     * Only applies to the built-in default logger. If you provide a custom
+     * `logger`, configure its verbosity directly — this flag has no effect on it.
+     *
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Custom logger for SDK diagnostic output.
+     *
+     * Accepts any object that implements `ILogger` (`debug`, `info`, `warn`, `error`).
+     * When provided, the SDK routes all internal logging through this instance.
+     * You are responsible for configuring its log level — the `debug` flag has
+     * no effect on custom loggers.
+     *
+     * When omitted, a built-in logger is used with verbosity controlled by `debug`.
+     */
+    logger?: ILogger;
+};
+export type Core = {
+    environmentId: string;
+    createApiClient: (options?: Partial<DynamicApiClientConfig>) => DynamicApiClient;
+    logger: ILogger;
+    baseMPCRelayApiUrl?: string;
+    baseApiUrl?: string;
+    debug: boolean;
+    apiKey?: string;
+};
+export type DynamicApiClientConfig = {
+    environmentId: string;
+    authToken?: string;
+    baseApiUrl?: string;
+    sdkVersion?: string;
+};
+export declare const createCore: ({ environmentId, baseApiUrl, baseMPCRelayApiUrl, debug, logger, }: CoreConfig) => Core;
+//# sourceMappingURL=createCore.d.ts.map

package/src/core/createCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createCore.d.ts","sourceRoot":"","sources":["../../src/core/createCore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAU,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGnF,MAAM,MAAM,UAAU,GAAG;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,IAAI,GAAG;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,KAAK,gBAAgB,CAAC;IACjF,MAAM,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,UAAU,sEAMpB,UAAU,KAAG,IA4Bf,CAAC"}

package/src/core/types.d.ts

@@ -0,0 +1,7 @@
+import type { Core } from './createCore.js';
+export type WithCore<T> = T & {
+    _core: Core;
+};
+export declare const assignCore: <T extends object>(target: T, core: Core) => T;
+export declare const getCore: <T extends object>(obj: WithCore<T>) => Core;
+//# sourceMappingURL=types.d.ts.map

package/src/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG;IAC5B,KAAK,EAAE,IAAI,CAAC;CACb,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,UAAU,CAAC,QAAQ,IAAI,KAAG,CAOpE,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,MAAM,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAG,IAE5D,CAAC"}

package/src/delegatedClient/createDelegatedClient.d.ts

@@ -0,0 +1,23 @@
+import type { DynamicApiClient } from '@dynamic-labs-wallet/core';
+import type { WalletProperties } from '../types.js';
+export type DelegatedClientConfig = {
+    environmentId: string;
+    baseApiUrl?: string;
+    baseMPCRelayApiUrl?: string;
+    apiKey: string;
+    debug?: boolean;
+};
+export type DelegatedWalletClient = {
+    get environmentId(): string;
+    get debug(): boolean;
+    get apiUrl(): string | undefined;
+    get wallets(): Record<string, WalletProperties>;
+    createApiClient: (options?: Record<string, any>) => DynamicApiClient;
+    logger: any;
+    apiKey: string;
+    baseMPCRelayApiUrl?: string;
+};
+export declare const createDelegatedApiClient: (client: DelegatedWalletClient, options?: Record<string, any>) => DynamicApiClient;
+export declare const createDelegatedApiClientWithWalletKey: (client: DelegatedWalletClient, walletApiKey: string) => DynamicApiClient;
+export declare const createDelegatedWalletClient: ({ environmentId, baseApiUrl, baseMPCRelayApiUrl, apiKey, debug, }: DelegatedClientConfig) => DelegatedWalletClient;
+//# sourceMappingURL=createDelegatedClient.d.ts.map

package/src/delegatedClient/createDelegatedClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDelegatedClient.d.ts","sourceRoot":"","sources":["../../src/delegatedClient/createDelegatedClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,aAAa,IAAI,MAAM,CAAC;IAC5B,IAAI,KAAK,IAAI,OAAO,CAAC;IACrB,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAAC;IACjC,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAChD,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,gBAAgB,CAAC;IACrE,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAGF,eAAO,MAAM,wBAAwB,WAC3B,qBAAqB,YACpB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAC3B,gBAEF,CAAC;AAGF,eAAO,MAAM,qCAAqC,WACxC,qBAAqB,gBACf,MAAM,KACnB,gBAOF,CAAC;AAEF,eAAO,MAAM,2BAA2B,sEAMrC,qBAAqB,0BAsCvB,CAAC"}

package/src/delegatedClient/index.d.ts

@@ -0,0 +1,7 @@
+export { createDelegatedWalletClient } from './createDelegatedClient.js';
+export type { DelegatedWalletClient, DelegatedClientConfig } from './createDelegatedClient.js';
+export { delegatedSignMessage } from './modules/sign.js';
+export { revokeDelegation } from './modules/revokeDelegation.js';
+export { decryptDelegatedWebhookData } from './modules/decryptWebhookData.js';
+export type { EncryptedDelegatedPayload } from './modules/decryptWebhookData.js';
+//# sourceMappingURL=index.d.ts.map

package/src/delegatedClient/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delegatedClient/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,YAAY,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC"}

package/src/delegatedClient/modules/decryptWebhookData.d.ts

@@ -0,0 +1,18 @@
+import type { ServerKeyShare } from '../../mpc/types.js';
+export type EncryptedDelegatedPayload = {
+    alg: string;
+    iv: string;
+    ct: string;
+    tag: string;
+    ek: string;
+    kid?: string;
+};
+export declare function decryptDelegatedWebhookData({ privateKeyPem, encryptedDelegatedKeyShare, encryptedWalletApiKey, }: {
+    privateKeyPem: string;
+    encryptedDelegatedKeyShare: EncryptedDelegatedPayload;
+    encryptedWalletApiKey: EncryptedDelegatedPayload;
+}): {
+    decryptedDelegatedShare: ServerKeyShare;
+    decryptedWalletApiKey: string;
+};
+//# sourceMappingURL=decryptWebhookData.d.ts.map

package/src/delegatedClient/modules/decryptWebhookData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decryptWebhookData.d.ts","sourceRoot":"","sources":["../../../src/delegatedClient/modules/decryptWebhookData.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,yBAAyB,GAAG;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAyBF,wBAAgB,2BAA2B,CAAC,EAC1C,aAAa,EACb,0BAA0B,EAC1B,qBAAqB,GACtB,EAAE;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B,EAAE,yBAAyB,CAAC;IACtD,qBAAqB,EAAE,yBAAyB,CAAC;CAClD,GAAG;IACF,uBAAuB,EAAE,cAAc,CAAC;IACxC,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAkCA"}

package/src/delegatedClient/modules/revokeDelegation.d.ts

@@ -0,0 +1,3 @@
+import type { DelegatedWalletClient } from '../createDelegatedClient.js';
+export declare const revokeDelegation: (client: DelegatedWalletClient, walletId: string) => Promise<void>;
+//# sourceMappingURL=revokeDelegation.d.ts.map

package/src/delegatedClient/modules/revokeDelegation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revokeDelegation.d.ts","sourceRoot":"","sources":["../../../src/delegatedClient/modules/revokeDelegation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,gBAAgB,WAAkB,qBAAqB,YAAY,MAAM,KAAG,OAAO,CAAC,IAAI,CAapG,CAAC"}

package/src/delegatedClient/modules/sign.d.ts

@@ -0,0 +1,31 @@
+import type { EcdsaSignature } from '#internal/node';
+import type { ServerKeyShare } from '../../mpc/types.js';
+import type { DelegatedWalletClient } from '../createDelegatedClient.js';
+import type { SignMessageContext } from '@dynamic-labs/sdk-api-core';
+export declare const dynamicDelegatedSign: (client: DelegatedWalletClient, { walletId, message, isFormatted, walletApiKey, onError, context, }: {
+    walletId: string;
+    message: string | Uint8Array;
+    isFormatted?: boolean;
+    walletApiKey: string;
+    onError?: (error: Error) => void;
+    context?: SignMessageContext;
+}) => Promise<import("@dynamic-labs-wallet/core").OpenRoomResponse>;
+export declare const delegatedSign: (client: DelegatedWalletClient, { chainName, message, roomId, keyShare, derivationPath, isFormatted, }: {
+    chainName: string;
+    message: string | Uint8Array;
+    roomId: string;
+    keyShare: ServerKeyShare;
+    derivationPath: Uint32Array | undefined;
+    isFormatted?: boolean;
+}) => Promise<Uint8Array | EcdsaSignature>;
+export declare const delegatedSignMessage: (client: DelegatedWalletClient, { walletId, walletApiKey, keyShare, message, chainName, isFormatted, onError, context, }: {
+    walletId: string;
+    walletApiKey: string;
+    keyShare: ServerKeyShare;
+    message: string | Uint8Array;
+    chainName: string;
+    isFormatted?: boolean;
+    onError?: (error: Error) => void;
+    context?: SignMessageContext;
+}) => Promise<Uint8Array | EcdsaSignature>;
+//# sourceMappingURL=sign.d.ts.map

package/src/delegatedClient/modules/sign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.d.ts","sourceRoot":"","sources":["../../../src/delegatedClient/modules/sign.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,eAAO,MAAM,oBAAoB,WACvB,qBAAqB,uEAQ1B;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,kEAsBF,CAAC;AAEF,eAAO,MAAM,aAAa,WAChB,qBAAqB,0EAQ1B;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,cAAc,EAAE,WAAW,GAAG,SAAS,CAAC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,KACA,OAAO,CAAC,UAAU,GAAG,cAAc,CAgBrC,CAAC;AAEF,eAAO,MAAM,oBAAoB,WACvB,qBAAqB,4FAU1B;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,KACA,OAAO,CAAC,UAAU,GAAG,cAAc,CAkCrC,CAAC"}

package/src/index.d.ts

@@ -0,0 +1,13 @@
+export * from '#internal/core';
+export { ThresholdSignatureScheme } from '@dynamic-labs-wallet/core';
+export type { TraceContext } from '@dynamic-labs-wallet/core';
+export { WalletOperation, SOLANA_RPC_URL, getMPCChainConfig } from '@dynamic-labs-wallet/core';
+export { getMPCSignatureScheme, getMPCSigner } from './mpc/index.js';
+export type { ServerInitKeygenResult, ServerKeyShare, SignMessage } from './mpc/index.js';
+export * from './client.js';
+export * from './types.js';
+export * from './utils.js';
+export * from './mpc/index.js';
+export { createDelegatedWalletClient, delegatedSignMessage, revokeDelegation } from './delegatedClient/index.js';
+export type { DelegatedWalletClient, DelegatedClientConfig } from './delegatedClient/index.js';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../packages/src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG/F,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACrE,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG1F,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACjH,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

package/src/mpc/index.d.ts

@@ -0,0 +1,3 @@
+export { getMPCSignatureScheme, getMPCSigner } from './mpc.js';
+export type { ServerInitKeygenResult, ServerKeyShare, SignMessage } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/src/mpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mpc/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/D,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/src/mpc/mpc.d.ts

@@ -0,0 +1,12 @@
+import { type BitcoinConfig, SigningAlgorithm } from '@dynamic-labs-wallet/core';
+import { Ecdsa, ExportableEd25519, BIP340 } from '#internal/node';
+export declare const getMPCSignatureScheme: ({ signingAlgorithm, baseRelayUrl, }: {
+    signingAlgorithm: SigningAlgorithm;
+    baseRelayUrl?: string;
+}) => Ecdsa | ExportableEd25519 | BIP340;
+export declare const getMPCSigner: ({ chainName, baseRelayUrl, bitcoinConfig, }: {
+    chainName: string;
+    baseRelayUrl?: string;
+    bitcoinConfig?: BitcoinConfig;
+}) => Ecdsa | ExportableEd25519 | BIP340;
+//# sourceMappingURL=mpc.d.ts.map

package/src/mpc/mpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpc.d.ts","sourceRoot":"","sources":["../../src/mpc/mpc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAIlE,eAAO,MAAM,qBAAqB,wCAG/B;IACD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,uCAWA,CAAC;AAEF,eAAO,MAAM,YAAY,gDAItB;IACD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,uCAOA,CAAC"}

package/src/mpc/types.d.ts

@@ -0,0 +1,5 @@
+import type { BIP340InitKeygenResult, BIP340KeygenResult, EcdsaInitKeygenResult, EcdsaKeygenResult, Ed25519InitKeygenResult, Ed25519KeygenResult, MessageHash } from '#internal/node';
+export type ServerInitKeygenResult = EcdsaInitKeygenResult | Ed25519InitKeygenResult | BIP340InitKeygenResult;
+export type ServerKeyShare = EcdsaKeygenResult | Ed25519KeygenResult | BIP340KeygenResult;
+export type SignMessage = MessageHash | Uint8Array;
+//# sourceMappingURL=types.d.ts.map

package/src/mpc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mpc/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;AAE9G,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAE1F,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC"}

package/src/types.d.ts

@@ -0,0 +1,41 @@
+import type { ThresholdSignatureScheme, KeyShareBackupInfo, ILogger } from '@dynamic-labs-wallet/core';
+import type { ForwardMPCClientV2 } from '@dynamic-labs-wallet/forward-mpc-client';
+import type { ServerKeyShare } from './mpc/types.js';
+export interface DynamicWalletClientProps {
+    environmentId: string;
+    baseApiUrl?: string;
+    baseMPCRelayApiUrl?: string;
+    /**
+     * Enables verbose debug-level logging when `true`.
+     *
+     * Only applies to the built-in default logger. If you provide a custom
+     * `logger`, configure its verbosity directly — this flag has no effect on it.
+     *
+     * @default false
+     */
+    debug?: boolean;
+    forwardMPCClient?: ForwardMPCClientV2;
+    enableMPCAccelerator?: boolean;
+    /**
+     * Custom logger for SDK diagnostic output.
+     *
+     * Accepts any object that implements `ILogger` (`debug`, `info`, `warn`, `error`).
+     * When provided, the SDK routes all internal logging through this instance.
+     * You are responsible for configuring its log level — the `debug` flag has
+     * no effect on custom loggers.
+     *
+     * When omitted, a built-in logger is used with verbosity controlled by `debug`.
+     */
+    logger?: ILogger;
+}
+export interface WalletProperties {
+    chainName: string;
+    walletId: string;
+    accountAddress: string;
+    externalServerKeyShares: ServerKeyShare[];
+    thresholdSignatureScheme: ThresholdSignatureScheme;
+    derivationPath?: string;
+    addressType?: string;
+    externalServerKeySharesBackupInfo: KeyShareBackupInfo;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../packages/src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;IACtC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,cAAc,EAAE,CAAC;IAC1C,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC,EAAE,kBAAkB,CAAC;CACvD"}

package/src/utils.d.ts

@@ -0,0 +1,49 @@
+import { MessageHash } from '#internal/node';
+import { type KeyShareBackupInfo, type WaasWalletProperties } from '@dynamic-labs-wallet/core';
+import type { ServerKeyShare } from './mpc/types.js';
+export declare const createLogError: (clientTag: string) => ({ message, error, context }: {
+    message: string;
+    error: Error;
+    context: Record<string, unknown>;
+}) => void;
+export declare const logError: ({ message, error, context, clientTag, }: {
+    message: string;
+    error: Error;
+    context: Record<string, unknown>;
+    clientTag?: string;
+}) => void;
+export declare const bytesToBase64: (arr: Uint8Array) => string;
+export declare const stringToBytes: (str: string) => Uint8Array;
+export declare const base64ToBytes: (base64: string) => Uint8Array;
+export declare const ensureBase64Padding: (str: string) => string;
+export declare const stripHexPrefix: (str: string) => string;
+export declare const isHexString: (str: string) => boolean;
+export declare const getExternalServerKeyShareBackupInfo: (params?: {
+    walletProperties: WaasWalletProperties;
+}) => KeyShareBackupInfo;
+/**
+ * Helper function to merge keyshares and remove duplicates based on pubkey and secretShare
+ * @param existingKeyShares - Array of existing keyshares
+ * @param newKeyShares - Array of new keyshares to merge
+ * @returns Array of merged unique keyshares
+ */
+export declare const mergeUniqueKeyShares: (existingKeyShares: ServerKeyShare[], newKeyShares: ServerKeyShare[]) => ServerKeyShare[];
+interface RetryConfig {
+    maxAttempts?: number;
+    retryInterval?: number;
+    operationName?: string;
+    logContext?: Record<string, unknown>;
+}
+/**
+ * Generic helper function to retry a promise-based operations
+ *
+ * @param operation - The async operation to retry
+ * @param config - Configuration options for retry behavior
+ * @returns Promise with the operation result
+ * @throws Last error encountered after all retries are exhausted
+ */
+export declare function retryPromise<T>(operation: () => Promise<T>, { maxAttempts, retryInterval, operationName, logContext }?: RetryConfig): Promise<T>;
+export declare const formatEvmMessage: (message: string | Uint8Array) => MessageHash;
+export declare const formatMessage: (chainName: string, message: string | Uint8Array) => string | Uint8Array | MessageHash;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/src/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../packages/src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAI1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,cAAc,cACb,MAAM,mCACY;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,KAAG,IAClD,CAAC;AAErD,eAAO,MAAM,QAAQ,4CAKlB;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,IAUH,CAAC;AAEF,eAAO,MAAM,aAAa,QAAS,UAAU,WAE5C,CAAC;AAEF,eAAO,MAAM,aAAa,QAAS,MAAM,eAExC,CAAC;AAEF,eAAO,MAAM,aAAa,WAAY,MAAM,eAE3C,CAAC;AAGF,eAAO,MAAM,mBAAmB,QAAS,MAAM,KAAG,MAEjD,CAAC;AAEF,eAAO,MAAM,cAAc,QAAS,MAAM,WAAgD,CAAC;AAE3F,eAAO,MAAM,WAAW,QAAS,MAAM,YAA+C,CAAC;AAEvF,eAAO,MAAM,mCAAmC,YAAa;IAC3D,gBAAgB,EAAE,oBAAoB,CAAC;CACxC,KAAG,kBA2CH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,sBACZ,cAAc,EAAE,gBACrB,cAAc,EAAE,KAC7B,cAAc,EAchB,CAAC;AAEF,UAAU,WAAW;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,EAAE,WAAe,EAAE,aAAmB,EAAE,aAA2B,EAAE,UAAe,EAAE,GAAE,WAAgB,GACvG,OAAO,CAAC,CAAC,CAAC,CAuBZ;AACD,eAAO,MAAM,gBAAgB,YAAa,MAAM,GAAG,UAAU,gBAO5D,CAAC;AAyBF,eAAO,MAAM,aAAa,cAAe,MAAM,WAAW,MAAM,GAAG,UAAU,KAAG,MAAM,GAAG,UAAU,GAAG,WAarG,CAAC"}