@crossmint/wallets-sdk 1.0.0 → 1.0.2

package/dist/wallets/types.d.ts

@@ -0,0 +1,11 @@
+import '@solana/web3.js';
+import '@crossmint/client-sdk-window';
+import '@crossmint/client-signers';
+import 'viem';
+import 'abitype';
+export { k as AddSignerOptions, a2 as AddSignerReturnType, aH as Approval, j as ApproveOptions, A as ApproveParams, a1 as ApproveResult, B as Balances, e as Callbacks, C as ClientSideWalletArgsFor, a as ClientSideWalletCreateArgs, aF as DeviceSignerDescriptor, E as EVMTransactionInput, aB as FormattedEVMTransaction, aD as PendingApproval, O as PrepareOnly, $ as SendTokenTransactionOptions, az as SendTokenTransactionType, Q as SignMessageInput, U as SignTypedDataInput, h as Signature, aA as SignatureInputOptions, S as Signer, aC as SignerInput, b as SignerStatus, i as SolanaTransactionInput, X as StellarTransactionInput, aE as StellarWalletPlugin, aG as TokenBalance, c as Transaction, V as TransactionInputOptions, T as Transfers, a0 as UserLocator, W as WalletArgsFor, d as WalletCreateArgs, f as WalletOptions, g as WalletPlugin } from '../types-vcGYTcL0.js';
+import '../chains/chains.js';
+import '../utils/device-signers/DeviceSignerKeyStorage.js';
+import '../api/gen/types.gen.js';
+import 'ox';
+import '@crossmint/common-sdk-base';

package/dist/wallets/wallet-factory.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkB5TANOHXcjs = require('../chunk-B5TANOHX.cjs');require('../chunk-K5TQ4QU3.cjs');require('../chunk-ICFT4GH4.cjs');require('../chunk-CUHDOBKN.cjs');require('../chunk-YHV3672R.cjs');require('../chunk-CAZWAHBL.cjs');require('../chunk-3VYGTPRF.cjs');require('../chunk-NX256LAH.cjs');require('../chunk-D6SLJ5C2.cjs');require('../chunk-L756WM7L.cjs');require('../chunk-5IC7UWND.cjs');require('../chunk-GZP2JQ6P.cjs');require('../chunk-IGRPHTXZ.cjs');require('../chunk-3VSFHDFH.cjs');require('../chunk-ENU3EKBG.cjs');require('../chunk-3SVXPFSP.cjs');require('../chunk-4DJWSV7I.cjs');require('../chunk-YF5G4U6L.cjs');require('../chunk-PO6S7UR3.cjs');require('../chunk-ODOCGZQN.cjs');require('../chunk-3FY5QWEA.cjs');require('../chunk-U64C57PB.cjs');require('../chunk-4KN3NJMT.cjs');require('../chunk-JBP52JOH.cjs');require('../chunk-5FH7WFWL.cjs');require('../chunk-SPTXAOFR.cjs');require('../chunk-5QIW67NU.cjs');require('../chunk-YGL4ITFK.cjs');require('../chunk-GEY3BU62.cjs');require('../chunk-PHPBBEXU.cjs');require('../chunk-A33BEWR7.cjs');require('../chunk-OGP7B5O3.cjs');require('../chunk-IJ632UXD.cjs');require('../chunk-6EZCCLTK.cjs');require('../chunk-SCEPJO4Q.cjs');require('../chunk-CEV4NP5X.cjs');require('../chunk-GEY574TH.cjs');require('../chunk-UE3WVHTM.cjs');require('../chunk-5X4EOJFG.cjs');require('../chunk-HRUMWG2F.cjs');require('../chunk-IR5WN6FQ.cjs');require('../chunk-T3U46LK3.cjs');require('../chunk-CCIGWTAO.cjs');require('../chunk-3TRQCN5N.cjs');require('../chunk-LKQYA27B.cjs');require('../chunk-2GKPWQBQ.cjs');exports.WalletFactory = _chunkB5TANOHXcjs.a;

package/dist/wallets/wallet-factory.d.cts

@@ -0,0 +1,37 @@
+import { ApiClient } from '../api/client.cjs';
+import { Chain } from '../chains/chains.cjs';
+import { W as WalletArgsFor, d as WalletCreateArgs } from '../types-DfT-EHk3.cjs';
+import { Wallet } from './wallet.cjs';
+import '@crossmint/common-sdk-base';
+import 'viem';
+import '../api/gen/types.gen.cjs';
+import 'ox';
+import '@crossmint/client-sdk-window';
+import '@crossmint/client-signers';
+import '@solana/web3.js';
+import 'abitype';
+import '../utils/device-signers/DeviceSignerKeyStorage.cjs';
+
+declare class WalletFactory {
+    private readonly apiClient;
+    constructor(apiClient: ApiClient);
+    getWallet<C extends Chain>(args: WalletArgsFor<C>): Promise<Wallet<C>>;
+    getWallet<C extends Chain>(walletLocator: string, args: WalletArgsFor<C>): Promise<Wallet<C>>;
+    createWallet<C extends Chain>(args: WalletCreateArgs<C>): Promise<Wallet<C>>;
+    private createWalletInstance;
+    private getWalletLocator;
+    private createPasskeySigner;
+    /**
+     * Ensures device signer is included in the signers array for wallet creation.
+     * If no device signer is present in args.signers, adds one.
+     * Device signers are not supported for Solana (Squads does not support device signer registration).
+     */
+    private ensureDeviceSignerInSigners;
+    private validateExistingWalletConfig;
+    private validateSigners;
+    private isMatchingPasskeySigner;
+    private registerSigners;
+    private getChainType;
+}
+
+export { WalletFactory };

package/dist/wallets/wallet-factory.d.ts

@@ -0,0 +1,37 @@
+import { ApiClient } from '../api/client.js';
+import { Chain } from '../chains/chains.js';
+import { W as WalletArgsFor, d as WalletCreateArgs } from '../types-vcGYTcL0.js';
+import { Wallet } from './wallet.js';
+import '@crossmint/common-sdk-base';
+import 'viem';
+import '../api/gen/types.gen.js';
+import 'ox';
+import '@crossmint/client-sdk-window';
+import '@crossmint/client-signers';
+import '@solana/web3.js';
+import 'abitype';
+import '../utils/device-signers/DeviceSignerKeyStorage.js';
+
+declare class WalletFactory {
+    private readonly apiClient;
+    constructor(apiClient: ApiClient);
+    getWallet<C extends Chain>(args: WalletArgsFor<C>): Promise<Wallet<C>>;
+    getWallet<C extends Chain>(walletLocator: string, args: WalletArgsFor<C>): Promise<Wallet<C>>;
+    createWallet<C extends Chain>(args: WalletCreateArgs<C>): Promise<Wallet<C>>;
+    private createWalletInstance;
+    private getWalletLocator;
+    private createPasskeySigner;
+    /**
+     * Ensures device signer is included in the signers array for wallet creation.
+     * If no device signer is present in args.signers, adds one.
+     * Device signers are not supported for Solana (Squads does not support device signer registration).
+     */
+    private ensureDeviceSignerInSigners;
+    private validateExistingWalletConfig;
+    private validateSigners;
+    private isMatchingPasskeySigner;
+    private registerSigners;
+    private getChainType;
+}
+
+export { WalletFactory };

package/dist/wallets/wallet-factory.js

@@ -0,0 +1 @@
+import{a}from"../chunk-LSMX26JP.js";import"../chunk-YIO5XXQ4.js";import"../chunk-Q7CG36OB.js";import"../chunk-TOAFCAVT.js";import"../chunk-N4IWDL6M.js";import"../chunk-2DANZH3R.js";import"../chunk-IOSADDL5.js";import"../chunk-GOXB2RBF.js";import"../chunk-VADIEIDS.js";import"../chunk-SLXO6E5S.js";import"../chunk-L52GDMSH.js";import"../chunk-6X5JEJD7.js";import"../chunk-QM3BB4E2.js";import"../chunk-RBSMBO4T.js";import"../chunk-OQZTL6ZG.js";import"../chunk-N355UETO.js";import"../chunk-3VRN3GKQ.js";import"../chunk-BITOMWYZ.js";import"../chunk-YDZRBHS3.js";import"../chunk-N5622OKA.js";import"../chunk-CBKN4SEV.js";import"../chunk-KYHZI332.js";import"../chunk-5LWJMR24.js";import"../chunk-O6VBO7KG.js";import"../chunk-EM3D5Q3A.js";import"../chunk-EE4ITUGS.js";import"../chunk-WCGUGIGJ.js";import"../chunk-XNZLCUTY.js";import"../chunk-CKZYSQOK.js";import"../chunk-QVTKTDED.js";import"../chunk-XS5B3TUE.js";import"../chunk-M335XCYO.js";import"../chunk-YH7G2U6V.js";import"../chunk-W7LJS32A.js";import"../chunk-2YLRFJ66.js";import"../chunk-KY7JXYJT.js";import"../chunk-S3DYQVRD.js";import"../chunk-KUP7H7X2.js";import"../chunk-FT5EVMLB.js";import"../chunk-SVIKBM3S.js";import"../chunk-KKQBZXFE.js";import"../chunk-EXC7TCGL.js";import"../chunk-455NK5LB.js";import"../chunk-B6GZ3H2H.js";import"../chunk-XLOZ34NX.js";import"../chunk-J3R36SGJ.js";export{a as WalletFactory};

package/dist/wallets/wallet.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkICFT4GH4cjs = require('../chunk-ICFT4GH4.cjs');require('../chunk-CUHDOBKN.cjs');require('../chunk-YHV3672R.cjs');require('../chunk-CAZWAHBL.cjs');require('../chunk-3VYGTPRF.cjs');require('../chunk-NX256LAH.cjs');require('../chunk-D6SLJ5C2.cjs');require('../chunk-L756WM7L.cjs');require('../chunk-5IC7UWND.cjs');require('../chunk-GZP2JQ6P.cjs');require('../chunk-IGRPHTXZ.cjs');require('../chunk-3VSFHDFH.cjs');require('../chunk-ENU3EKBG.cjs');require('../chunk-3SVXPFSP.cjs');require('../chunk-4DJWSV7I.cjs');require('../chunk-YF5G4U6L.cjs');require('../chunk-PO6S7UR3.cjs');require('../chunk-ODOCGZQN.cjs');require('../chunk-3FY5QWEA.cjs');require('../chunk-U64C57PB.cjs');require('../chunk-4KN3NJMT.cjs');require('../chunk-JBP52JOH.cjs');require('../chunk-5FH7WFWL.cjs');require('../chunk-SPTXAOFR.cjs');require('../chunk-5QIW67NU.cjs');require('../chunk-YGL4ITFK.cjs');require('../chunk-GEY3BU62.cjs');require('../chunk-PHPBBEXU.cjs');require('../chunk-A33BEWR7.cjs');require('../chunk-OGP7B5O3.cjs');require('../chunk-IJ632UXD.cjs');require('../chunk-6EZCCLTK.cjs');require('../chunk-SCEPJO4Q.cjs');require('../chunk-CEV4NP5X.cjs');require('../chunk-GEY574TH.cjs');require('../chunk-UE3WVHTM.cjs');require('../chunk-5X4EOJFG.cjs');require('../chunk-HRUMWG2F.cjs');require('../chunk-IR5WN6FQ.cjs');require('../chunk-T3U46LK3.cjs');require('../chunk-CCIGWTAO.cjs');require('../chunk-3TRQCN5N.cjs');require('../chunk-LKQYA27B.cjs');require('../chunk-2GKPWQBQ.cjs');exports.Wallet = _chunkICFT4GH4cjs.a;

package/dist/wallets/wallet.d.cts

@@ -0,0 +1,274 @@
+import { WalletsTransactionV2025ResponseDto } from '../api/gen/types.gen.cjs';
+import { ApiClient } from '../api/client.cjs';
+import { f as WalletOptions, r as SignerConfigForChain, m as SignerAdapter, B as Balances, Y as FundWalletResponse, Z as GetTransactionsResponse, _ as GetTransactionSuccessResponse, T as Transfers, $ as SendTokenTransactionOptions, a0 as UserLocator, c as Transaction, O as PrepareOnly, A as ApproveParams, a1 as ApproveResult, k as AddSignerOptions, q as ServerSignerConfig, o as ExternalWalletRegistrationConfig, a2 as AddSignerReturnType, S as Signer, s as SignerLocator, a3 as WalletLocator, j as ApproveOptions, a4 as ApproveSignatureResponse, h as Signature } from '../types-DfT-EHk3.cjs';
+import { Chain } from '../chains/chains.cjs';
+import '@crossmint/common-sdk-base';
+import 'viem';
+import 'ox';
+import '@crossmint/client-sdk-window';
+import '@crossmint/client-signers';
+import '@solana/web3.js';
+import 'abitype';
+import '../utils/device-signers/DeviceSignerKeyStorage.cjs';
+
+type WalletContructorType<C extends Chain> = {
+    chain: C;
+    address: string;
+    owner?: string;
+    alias?: string;
+    options?: WalletOptions;
+    recovery: SignerConfigForChain<C>;
+    signers?: SignerConfigForChain<C>[];
+    signer?: SignerAdapter;
+};
+declare class Wallet<C extends Chain> {
+    #private;
+    chain: C;
+    address: string;
+    owner?: string;
+    alias?: string;
+    constructor(args: WalletContructorType<C>, apiClient: ApiClient);
+    get signer(): SignerAdapter | undefined;
+    /**
+     * Initialize the device signer by resolving key availability.
+     * If a device key is found locally, assembles the signer immediately.
+     * If not, flags the wallet for recovery so a key is generated during the next transaction.
+     * Device signers are not supported for Solana (Squads does not support device signer registration).
+     */
+    private initDeviceSigner;
+    /**
+     * Initialize the default signer for this wallet.
+     * Priority:
+     * 1. Device signer (if available and enabled)
+     * 2. If no device signer and no pending recovery: fallback based on delegated signer count
+     *    - 0 signers: try to use recovery signer
+     *    - 1 signer: try to use that signer
+     *    - >1 signers: leave undefined (user must call useSigner)
+     *
+     * Note: Server and api-key signers may fail to auto-assemble if required data
+     * is not available in the API response. In those cases, the signer is left undefined.
+     */
+    private initDefaultSigner;
+    protected static getApiClient<C extends Chain>(wallet: Wallet<C>): ApiClient;
+    protected static getOptions<C extends Chain>(wallet: Wallet<C>): WalletOptions | undefined;
+    protected static getRecovery<C extends Chain>(wallet: Wallet<C>): SignerConfigForChain<C>;
+    protected static getInitialSigners<C extends Chain>(wallet: Wallet<C>): SignerConfigForChain<C>[];
+    get apiClient(): ApiClient;
+    protected get options(): WalletOptions | undefined;
+    /**
+     * Get the recovery signer config
+     * @returns The recovery signer config
+     * @experimental This API is experimental and may change in the future
+     */
+    get recovery(): SignerConfigForChain<C>;
+    /**
+     * Get the wallet balances - always includes USDC and native token (ETH/SOL)
+     * @param {string[]} tokens - Additional tokens to request (optional: native token and usdc are always included)
+     * @returns {Promise<Balances<C>>} The balances returns nativeToken, usdc, tokens
+     * @throws {Error} If the balances cannot be retrieved
+     */
+    balances(tokens?: string[]): Promise<Balances<C>>;
+    /**
+     * Funds the wallet with Crossmint's stablecoin (USDXM).
+     *
+     * **Note:** This method is only available in staging environments and exclusively supports USDXM tokens.
+     * It cannot be used in production environments.
+     * @param amount - The amount of USDXM to fund the wallet with
+     * @param chain - Optional chain to fund on. If not provided, uses the wallet's default chain
+     * @returns The funding response
+     * @throws {Error} If the funding operation fails or if called in a production environment
+     */
+    stagingFund(amount: number, chain?: Chain): Promise<FundWalletResponse>;
+    /**
+     * Transform the API balance response to the new structure
+     * @private
+     */
+    private transformBalanceResponse;
+    /**
+     * Get the wallet NFTs
+     * @param params - The parameters
+     * @param params.perPage - The number of NFTs per page
+     * @param params.page - The page number
+     * @returns The NFTs
+     */
+    nfts(params: {
+        perPage: number;
+        page: number;
+    }): Promise<unknown>;
+    /**
+     * Get the wallet transactions
+     * @returns The transactions
+     * @throws {Error} If the transactions cannot be retrieved
+     */
+    transactions(): Promise<GetTransactionsResponse>;
+    /**
+     * Get a transaction by id
+     * @returns The transaction
+     * @throws {Error} If the transaction cannot be retrieved
+     */
+    transaction(transactionId: string): Promise<GetTransactionSuccessResponse>;
+    /**
+     * Get the wallet transfers
+     * @returns The transfers
+     * @throws {Error} If the transfers cannot be retrieved
+     */
+    transfers(params?: {
+        tokens?: string;
+        status?: "successful" | "failed";
+    }): Promise<Transfers>;
+    /**
+     * Send a token to a wallet or user locator
+     * @param {string | UserLocator} to - The recipient (address or user locator)
+     * @param {string} token - The token (address or currency symbol)
+     * @param {string} amount - The amount to send (decimal units)
+     * @param {TransactionInputOptions} options - The options for the transaction
+     * @returns {Transaction} The transaction
+     */
+    send<T extends SendTokenTransactionOptions | undefined = undefined>(to: string | UserLocator, token: string, amount: string, options?: T): Promise<Transaction<T extends PrepareOnly<true> ? true : false>>;
+    /**
+     * @deprecated Use `approve` instead.
+     * Approve a transaction
+     * @param params - The parameters
+     * @param params.transactionId - The transaction id
+     * @param params.options - The options for the transaction
+     * @param params.options.approval - The approval
+     * @param params.options.additionalSigners - The additional signers
+     * @returns The transaction
+     */
+    approveTransaction(params: ApproveParams): Promise<Error>;
+    /**
+     * Approve a transaction or signature
+     * @param params - The parameters
+     * @param params.transactionId - The transaction id
+     * @param params.signatureId - The signature id
+     * @param params.options - The options for the approval
+     * @param params.options.approval - The approval data
+     * @param params.options.additionalSigners - Additional signers for the approval
+     * @returns The transaction or signature
+     */
+    approve<T extends ApproveParams>(params: T): Promise<ApproveResult<T>>;
+    /**
+     * Add a signer to the wallet.
+     * Always uses the recovery signer internally to approve the registration.
+     * If the signer being added is the current operational signer, it will be reassembled with the new locator.
+     * Otherwise, the original signer is restored after the operation.
+     * @param signer - The signer configuration object
+     * @param options - The options for the operation
+     * @param options.prepareOnly - If true, returns the signer with approval ID without auto-approving
+     */
+    addSigner<T extends AddSignerOptions | undefined = undefined>(signer: SignerConfigForChain<C> | ServerSignerConfig | ExternalWalletRegistrationConfig, options?: T): Promise<T extends PrepareOnly<true> ? AddSignerReturnType<C> : Signer>;
+    /**
+     * Set the active signer for this wallet.
+     * Accepts a signer config object. The locator is inferred internally.
+     * Works for both registered signers and the recovery signer.
+     *
+     * For passkey signers: if no `id` is provided, the wallet will auto-select the passkey
+     * if exactly one passkey signer is registered. If multiple passkeys exist, an `id` must be specified.
+     *
+     * For device signers: if no device key is found locally, the signer will be created
+     * automatically during the next transaction (via recovery).
+     *
+     * For external-wallet signers: the config object must include an onSign callback
+     * (applies to both registered and recovery signers).
+     *
+     * @param signer - The signer config object to use
+     */
+    useSigner(signer: SignerConfigForChain<C>): Promise<void>;
+    /**
+     * Resolve a non-device signer: check registration first, then fall back to recovery.
+     * For passkeys without an explicit credential id, auto-selects from registered signers.
+     */
+    private resolveNonDeviceSigner;
+    /**
+     * Try to auto-select a passkey credential from registered signers.
+     * Returns true if a credential was auto-selected, false if no passkey signers exist.
+     * Throws if multiple passkey signers exist (user must specify an id).
+     */
+    private tryAutoSelectPasskey;
+    /**
+     * Compute the signer locator for registration checks.
+     * Server signers use the derived address; other types use the standard locator.
+     */
+    private resolveSignerLocator;
+    private isPasskeyMissingId;
+    /**
+     * Check if a signer is registered in this wallet.
+     * @param signerLocator - The locator of the signer to check
+     * @returns true if the signer is registered
+     */
+    signerIsRegistered(signerLocator: SignerLocator | string): Promise<boolean>;
+    /**
+     * Check if a signer is approved and usable for the current wallet chain.
+     * @param signerLocator - The locator of the signer to check
+     * @returns true if the signer is approved for this chain
+     */
+    isSignerApproved(signerLocator: SignerLocator | string): Promise<boolean>;
+    /**
+     * Whether the wallet needs recovery (signer registration) before the next transaction.
+     * @returns true if recovery is needed
+     */
+    needsRecovery(): boolean;
+    /**
+     * Register a device signer with the wallet using the recovery signer.
+     * Generates a new device key and registers it on-chain.
+     * Returns early if the device signer's locator is already approved on-chain.
+     */
+    recover(): Promise<void>;
+    /**
+     * List the signers for this wallet.
+     * Returns full signer objects with status.
+     * For EVM wallets, only signers with an approval (pending or completed) for the wallet's chain are included.
+     * @returns {Promise<WalletSigner[]>} The signers
+     */
+    signers(): Promise<Signer[]>;
+    protected get walletLocator(): WalletLocator;
+    /**
+     * Ensures that a signer is available. Throws if the wallet is read-only.
+     */
+    protected requireSigner(): SignerAdapter;
+    protected preAuthIfNeeded(): Promise<void>;
+    /**
+     * Check if a signer config matches the wallet's recovery signer.
+     */
+    private isRecoverySigner;
+    /**
+     * Validate that the signer input has the required values for its type.
+     */
+    private validateSignerInput;
+    /**
+     * Check if a device signer key is available locally, or flag for recovery.
+     * Looks up device key storage by wallet address, then by matching registered device signers.
+     * If no key is found, sets needsRecovery so a new device key is generated during the next transaction.
+     */
+    private resolveDeviceSignerAvailability;
+    private assembleFullSigner;
+    private getSignerState;
+    /**
+     * Build an InternalSignerConfig from a SignerConfigForChain.
+     */
+    private buildInternalSignerConfig;
+    protected get isSolanaWallet(): boolean;
+    protected resolveChainForEnvironment(): C;
+    protected approveTransactionAndWait(transactionId: string, options?: ApproveOptions): Promise<{
+        hash: string;
+        explorerLink: string;
+        transactionId: string;
+    }>;
+    protected approveSignatureAndWait(signatureId: string, options?: ApproveOptions): Promise<{
+        signature: string;
+        signatureId: string;
+    }>;
+    protected approveSignatureInternal(signatureId: string, options?: ApproveOptions): Promise<ApproveSignatureResponse>;
+    protected approveTransactionInternal(transactionId: string, options?: ApproveOptions): Promise<WalletsTransactionV2025ResponseDto>;
+    private executeApproveTransactionWithErrorHandling;
+    private executeApproveSignatureWithErrorHandling;
+    protected waitForSignature(signatureId: string): Promise<Signature<false>>;
+    protected waitForTransaction(transactionId: string, timeoutMs?: number, { backoffMultiplier, maxBackoffMs, initialBackoffMs, }?: {
+        initialBackoffMs?: number;
+        backoffMultiplier?: number;
+        maxBackoffMs?: number;
+    }): Promise<Transaction<false>>;
+    protected sleep(ms: number): Promise<unknown>;
+}
+
+export { Wallet };

package/dist/wallets/wallet.d.ts

@@ -0,0 +1,274 @@
+import { WalletsTransactionV2025ResponseDto } from '../api/gen/types.gen.js';
+import { ApiClient } from '../api/client.js';
+import { f as WalletOptions, r as SignerConfigForChain, m as SignerAdapter, B as Balances, Y as FundWalletResponse, Z as GetTransactionsResponse, _ as GetTransactionSuccessResponse, T as Transfers, $ as SendTokenTransactionOptions, a0 as UserLocator, c as Transaction, O as PrepareOnly, A as ApproveParams, a1 as ApproveResult, k as AddSignerOptions, q as ServerSignerConfig, o as ExternalWalletRegistrationConfig, a2 as AddSignerReturnType, S as Signer, s as SignerLocator, a3 as WalletLocator, j as ApproveOptions, a4 as ApproveSignatureResponse, h as Signature } from '../types-vcGYTcL0.js';
+import { Chain } from '../chains/chains.js';
+import '@crossmint/common-sdk-base';
+import 'viem';
+import 'ox';
+import '@crossmint/client-sdk-window';
+import '@crossmint/client-signers';
+import '@solana/web3.js';
+import 'abitype';
+import '../utils/device-signers/DeviceSignerKeyStorage.js';
+
+type WalletContructorType<C extends Chain> = {
+    chain: C;
+    address: string;
+    owner?: string;
+    alias?: string;
+    options?: WalletOptions;
+    recovery: SignerConfigForChain<C>;
+    signers?: SignerConfigForChain<C>[];
+    signer?: SignerAdapter;
+};
+declare class Wallet<C extends Chain> {
+    #private;
+    chain: C;
+    address: string;
+    owner?: string;
+    alias?: string;
+    constructor(args: WalletContructorType<C>, apiClient: ApiClient);
+    get signer(): SignerAdapter | undefined;
+    /**
+     * Initialize the device signer by resolving key availability.
+     * If a device key is found locally, assembles the signer immediately.
+     * If not, flags the wallet for recovery so a key is generated during the next transaction.
+     * Device signers are not supported for Solana (Squads does not support device signer registration).
+     */
+    private initDeviceSigner;
+    /**
+     * Initialize the default signer for this wallet.
+     * Priority:
+     * 1. Device signer (if available and enabled)
+     * 2. If no device signer and no pending recovery: fallback based on delegated signer count
+     *    - 0 signers: try to use recovery signer
+     *    - 1 signer: try to use that signer
+     *    - >1 signers: leave undefined (user must call useSigner)
+     *
+     * Note: Server and api-key signers may fail to auto-assemble if required data
+     * is not available in the API response. In those cases, the signer is left undefined.
+     */
+    private initDefaultSigner;
+    protected static getApiClient<C extends Chain>(wallet: Wallet<C>): ApiClient;
+    protected static getOptions<C extends Chain>(wallet: Wallet<C>): WalletOptions | undefined;
+    protected static getRecovery<C extends Chain>(wallet: Wallet<C>): SignerConfigForChain<C>;
+    protected static getInitialSigners<C extends Chain>(wallet: Wallet<C>): SignerConfigForChain<C>[];
+    get apiClient(): ApiClient;
+    protected get options(): WalletOptions | undefined;
+    /**
+     * Get the recovery signer config
+     * @returns The recovery signer config
+     * @experimental This API is experimental and may change in the future
+     */
+    get recovery(): SignerConfigForChain<C>;
+    /**
+     * Get the wallet balances - always includes USDC and native token (ETH/SOL)
+     * @param {string[]} tokens - Additional tokens to request (optional: native token and usdc are always included)
+     * @returns {Promise<Balances<C>>} The balances returns nativeToken, usdc, tokens
+     * @throws {Error} If the balances cannot be retrieved
+     */
+    balances(tokens?: string[]): Promise<Balances<C>>;
+    /**
+     * Funds the wallet with Crossmint's stablecoin (USDXM).
+     *
+     * **Note:** This method is only available in staging environments and exclusively supports USDXM tokens.
+     * It cannot be used in production environments.
+     * @param amount - The amount of USDXM to fund the wallet with
+     * @param chain - Optional chain to fund on. If not provided, uses the wallet's default chain
+     * @returns The funding response
+     * @throws {Error} If the funding operation fails or if called in a production environment
+     */
+    stagingFund(amount: number, chain?: Chain): Promise<FundWalletResponse>;
+    /**
+     * Transform the API balance response to the new structure
+     * @private
+     */
+    private transformBalanceResponse;
+    /**
+     * Get the wallet NFTs
+     * @param params - The parameters
+     * @param params.perPage - The number of NFTs per page
+     * @param params.page - The page number
+     * @returns The NFTs
+     */
+    nfts(params: {
+        perPage: number;
+        page: number;
+    }): Promise<unknown>;
+    /**
+     * Get the wallet transactions
+     * @returns The transactions
+     * @throws {Error} If the transactions cannot be retrieved
+     */
+    transactions(): Promise<GetTransactionsResponse>;
+    /**
+     * Get a transaction by id
+     * @returns The transaction
+     * @throws {Error} If the transaction cannot be retrieved
+     */
+    transaction(transactionId: string): Promise<GetTransactionSuccessResponse>;
+    /**
+     * Get the wallet transfers
+     * @returns The transfers
+     * @throws {Error} If the transfers cannot be retrieved
+     */
+    transfers(params?: {
+        tokens?: string;
+        status?: "successful" | "failed";
+    }): Promise<Transfers>;
+    /**
+     * Send a token to a wallet or user locator
+     * @param {string | UserLocator} to - The recipient (address or user locator)
+     * @param {string} token - The token (address or currency symbol)
+     * @param {string} amount - The amount to send (decimal units)
+     * @param {TransactionInputOptions} options - The options for the transaction
+     * @returns {Transaction} The transaction
+     */
+    send<T extends SendTokenTransactionOptions | undefined = undefined>(to: string | UserLocator, token: string, amount: string, options?: T): Promise<Transaction<T extends PrepareOnly<true> ? true : false>>;
+    /**
+     * @deprecated Use `approve` instead.
+     * Approve a transaction
+     * @param params - The parameters
+     * @param params.transactionId - The transaction id
+     * @param params.options - The options for the transaction
+     * @param params.options.approval - The approval
+     * @param params.options.additionalSigners - The additional signers
+     * @returns The transaction
+     */
+    approveTransaction(params: ApproveParams): Promise<Error>;
+    /**
+     * Approve a transaction or signature
+     * @param params - The parameters
+     * @param params.transactionId - The transaction id
+     * @param params.signatureId - The signature id
+     * @param params.options - The options for the approval
+     * @param params.options.approval - The approval data
+     * @param params.options.additionalSigners - Additional signers for the approval
+     * @returns The transaction or signature
+     */
+    approve<T extends ApproveParams>(params: T): Promise<ApproveResult<T>>;
+    /**
+     * Add a signer to the wallet.
+     * Always uses the recovery signer internally to approve the registration.
+     * If the signer being added is the current operational signer, it will be reassembled with the new locator.
+     * Otherwise, the original signer is restored after the operation.
+     * @param signer - The signer configuration object
+     * @param options - The options for the operation
+     * @param options.prepareOnly - If true, returns the signer with approval ID without auto-approving
+     */
+    addSigner<T extends AddSignerOptions | undefined = undefined>(signer: SignerConfigForChain<C> | ServerSignerConfig | ExternalWalletRegistrationConfig, options?: T): Promise<T extends PrepareOnly<true> ? AddSignerReturnType<C> : Signer>;
+    /**
+     * Set the active signer for this wallet.
+     * Accepts a signer config object. The locator is inferred internally.
+     * Works for both registered signers and the recovery signer.
+     *
+     * For passkey signers: if no `id` is provided, the wallet will auto-select the passkey
+     * if exactly one passkey signer is registered. If multiple passkeys exist, an `id` must be specified.
+     *
+     * For device signers: if no device key is found locally, the signer will be created
+     * automatically during the next transaction (via recovery).
+     *
+     * For external-wallet signers: the config object must include an onSign callback
+     * (applies to both registered and recovery signers).
+     *
+     * @param signer - The signer config object to use
+     */
+    useSigner(signer: SignerConfigForChain<C>): Promise<void>;
+    /**
+     * Resolve a non-device signer: check registration first, then fall back to recovery.
+     * For passkeys without an explicit credential id, auto-selects from registered signers.
+     */
+    private resolveNonDeviceSigner;
+    /**
+     * Try to auto-select a passkey credential from registered signers.
+     * Returns true if a credential was auto-selected, false if no passkey signers exist.
+     * Throws if multiple passkey signers exist (user must specify an id).
+     */
+    private tryAutoSelectPasskey;
+    /**
+     * Compute the signer locator for registration checks.
+     * Server signers use the derived address; other types use the standard locator.
+     */
+    private resolveSignerLocator;
+    private isPasskeyMissingId;
+    /**
+     * Check if a signer is registered in this wallet.
+     * @param signerLocator - The locator of the signer to check
+     * @returns true if the signer is registered
+     */
+    signerIsRegistered(signerLocator: SignerLocator | string): Promise<boolean>;
+    /**
+     * Check if a signer is approved and usable for the current wallet chain.
+     * @param signerLocator - The locator of the signer to check
+     * @returns true if the signer is approved for this chain
+     */
+    isSignerApproved(signerLocator: SignerLocator | string): Promise<boolean>;
+    /**
+     * Whether the wallet needs recovery (signer registration) before the next transaction.
+     * @returns true if recovery is needed
+     */
+    needsRecovery(): boolean;
+    /**
+     * Register a device signer with the wallet using the recovery signer.
+     * Generates a new device key and registers it on-chain.
+     * Returns early if the device signer's locator is already approved on-chain.
+     */
+    recover(): Promise<void>;
+    /**
+     * List the signers for this wallet.
+     * Returns full signer objects with status.
+     * For EVM wallets, only signers with an approval (pending or completed) for the wallet's chain are included.
+     * @returns {Promise<WalletSigner[]>} The signers
+     */
+    signers(): Promise<Signer[]>;
+    protected get walletLocator(): WalletLocator;
+    /**
+     * Ensures that a signer is available. Throws if the wallet is read-only.
+     */
+    protected requireSigner(): SignerAdapter;
+    protected preAuthIfNeeded(): Promise<void>;
+    /**
+     * Check if a signer config matches the wallet's recovery signer.
+     */
+    private isRecoverySigner;
+    /**
+     * Validate that the signer input has the required values for its type.
+     */
+    private validateSignerInput;
+    /**
+     * Check if a device signer key is available locally, or flag for recovery.
+     * Looks up device key storage by wallet address, then by matching registered device signers.
+     * If no key is found, sets needsRecovery so a new device key is generated during the next transaction.
+     */
+    private resolveDeviceSignerAvailability;
+    private assembleFullSigner;
+    private getSignerState;
+    /**
+     * Build an InternalSignerConfig from a SignerConfigForChain.
+     */
+    private buildInternalSignerConfig;
+    protected get isSolanaWallet(): boolean;
+    protected resolveChainForEnvironment(): C;
+    protected approveTransactionAndWait(transactionId: string, options?: ApproveOptions): Promise<{
+        hash: string;
+        explorerLink: string;
+        transactionId: string;
+    }>;
+    protected approveSignatureAndWait(signatureId: string, options?: ApproveOptions): Promise<{
+        signature: string;
+        signatureId: string;
+    }>;
+    protected approveSignatureInternal(signatureId: string, options?: ApproveOptions): Promise<ApproveSignatureResponse>;
+    protected approveTransactionInternal(transactionId: string, options?: ApproveOptions): Promise<WalletsTransactionV2025ResponseDto>;
+    private executeApproveTransactionWithErrorHandling;
+    private executeApproveSignatureWithErrorHandling;
+    protected waitForSignature(signatureId: string): Promise<Signature<false>>;
+    protected waitForTransaction(transactionId: string, timeoutMs?: number, { backoffMultiplier, maxBackoffMs, initialBackoffMs, }?: {
+        initialBackoffMs?: number;
+        backoffMultiplier?: number;
+        maxBackoffMs?: number;
+    }): Promise<Transaction<false>>;
+    protected sleep(ms: number): Promise<unknown>;
+}
+
+export { Wallet };

package/dist/wallets/wallet.js

@@ -0,0 +1 @@
+import{a}from"../chunk-Q7CG36OB.js";import"../chunk-TOAFCAVT.js";import"../chunk-N4IWDL6M.js";import"../chunk-2DANZH3R.js";import"../chunk-IOSADDL5.js";import"../chunk-GOXB2RBF.js";import"../chunk-VADIEIDS.js";import"../chunk-SLXO6E5S.js";import"../chunk-L52GDMSH.js";import"../chunk-6X5JEJD7.js";import"../chunk-QM3BB4E2.js";import"../chunk-RBSMBO4T.js";import"../chunk-OQZTL6ZG.js";import"../chunk-N355UETO.js";import"../chunk-3VRN3GKQ.js";import"../chunk-BITOMWYZ.js";import"../chunk-YDZRBHS3.js";import"../chunk-N5622OKA.js";import"../chunk-CBKN4SEV.js";import"../chunk-KYHZI332.js";import"../chunk-5LWJMR24.js";import"../chunk-O6VBO7KG.js";import"../chunk-EM3D5Q3A.js";import"../chunk-EE4ITUGS.js";import"../chunk-WCGUGIGJ.js";import"../chunk-XNZLCUTY.js";import"../chunk-CKZYSQOK.js";import"../chunk-QVTKTDED.js";import"../chunk-XS5B3TUE.js";import"../chunk-M335XCYO.js";import"../chunk-YH7G2U6V.js";import"../chunk-W7LJS32A.js";import"../chunk-2YLRFJ66.js";import"../chunk-KY7JXYJT.js";import"../chunk-S3DYQVRD.js";import"../chunk-KUP7H7X2.js";import"../chunk-FT5EVMLB.js";import"../chunk-SVIKBM3S.js";import"../chunk-KKQBZXFE.js";import"../chunk-EXC7TCGL.js";import"../chunk-455NK5LB.js";import"../chunk-B6GZ3H2H.js";import"../chunk-XLOZ34NX.js";import"../chunk-J3R36SGJ.js";export{a as Wallet};