@crossmint/wallets-sdk 0.21.0 → 1.0.0-beta.3

package/dist/wallets/wallet-factory.js

@@ -1,42 +1 @@
-import {
-  WalletFactory
-} from "../chunk-2PSAUSOG.js";
-import "../chunk-ZP4ZZCIE.js";
-import "../chunk-VVPGO564.js";
-import "../chunk-EVR4CD53.js";
-import "../chunk-L52GDMSH.js";
-import "../chunk-CTOLL4BK.js";
-import "../chunk-QM3BB4E2.js";
-import "../chunk-S2L5Z2ZT.js";
-import "../chunk-H6WV5NRT.js";
-import "../chunk-GJT2JD3E.js";
-import "../chunk-K6LSGLG6.js";
-import "../chunk-2RG6642I.js";
-import "../chunk-YDZRBHS3.js";
-import "../chunk-HFEF2URB.js";
-import "../chunk-4Z3YDHHG.js";
-import "../chunk-T5NKL6F4.js";
-import "../chunk-FZQG6OX2.js";
-import "../chunk-FOOISYCJ.js";
-import "../chunk-Q52MMQSC.js";
-import "../chunk-7GOUUPS4.js";
-import "../chunk-47WKYTRN.js";
-import "../chunk-IPO25BCU.js";
-import "../chunk-2I2OFGNL.js";
-import "../chunk-PIFD6KNH.js";
-import "../chunk-PK7J3Y3L.js";
-import "../chunk-WJUPOCKJ.js";
-import "../chunk-X4SPF4KJ.js";
-import "../chunk-ZBLW42YE.js";
-import "../chunk-2T5HHKUI.js";
-import "../chunk-3U6UAYOV.js";
-import "../chunk-MMISP35W.js";
-import "../chunk-JWMQALLN.js";
-import "../chunk-SGINWAB6.js";
-import "../chunk-455NK5LB.js";
-import "../chunk-XEPUH4XH.js";
-import "../chunk-GLUD6EBN.js";
-import "../chunk-ASE2FXWP.js";
-export {
-  WalletFactory
-};
+import{a}from"../chunk-24JKRXBH.js";import"../chunk-YIO5XXQ4.js";import"../chunk-2RNAWXXS.js";import"../chunk-TOAFCAVT.js";import"../chunk-575WRSRN.js";import"../chunk-IOSADDL5.js";import"../chunk-6FGJ3ICD.js";import"../chunk-GOXB2RBF.js";import"../chunk-N5WVT7QE.js";import"../chunk-2JW6HKFK.js";import"../chunk-L52GDMSH.js";import"../chunk-G5R6VQGJ.js";import"../chunk-QM3BB4E2.js";import"../chunk-PKYRYRX4.js";import"../chunk-OQZTL6ZG.js";import"../chunk-ZE4NT3CJ.js";import"../chunk-MMFZP54X.js";import"../chunk-WT5MDUZY.js";import"../chunk-YDZRBHS3.js";import"../chunk-36OMUNL3.js";import"../chunk-LEALJLNK.js";import"../chunk-SMADCELI.js";import"../chunk-RR6DWIRN.js";import"../chunk-O6VBO7KG.js";import"../chunk-EE4ITUGS.js";import"../chunk-WCGUGIGJ.js";import"../chunk-XNZLCUTY.js";import"../chunk-LB4V5KKI.js";import"../chunk-SH7KRBXV.js";import"../chunk-XS5B3TUE.js";import"../chunk-EIHK5TYE.js";import"../chunk-WBIKVPHW.js";import"../chunk-W7LJS32A.js";import"../chunk-2YLRFJ66.js";import"../chunk-JDDMCB6P.js";import"../chunk-KUP7H7X2.js";import"../chunk-FT5EVMLB.js";import"../chunk-SVIKBM3S.js";import"../chunk-KKQBZXFE.js";import"../chunk-S3DYQVRD.js";import"../chunk-EXC7TCGL.js";import"../chunk-455NK5LB.js";import"../chunk-6TYV7ADO.js";import"../chunk-W6V7WGBL.js";import"../chunk-J3R36SGJ.js";export{a as WalletFactory};

package/dist/wallets/wallet.cjs

@@ -1,33 +1 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunk4ZWUI6LEcjs = require('../chunk-4ZWUI6LE.cjs');
-require('../chunk-5IC7UWND.cjs');
-require('../chunk-M6IPPGXQ.cjs');
-require('../chunk-IGRPHTXZ.cjs');
-require('../chunk-KHY5FXO4.cjs');
-require('../chunk-RUQYXEEG.cjs');
-require('../chunk-DDNG224J.cjs');
-require('../chunk-HWTWDQYT.cjs');
-require('../chunk-OPKFMXPI.cjs');
-require('../chunk-PO6S7UR3.cjs');
-require('../chunk-VTF3WCXG.cjs');
-require('../chunk-CPZQ7BK5.cjs');
-require('../chunk-U56Z2EOR.cjs');
-require('../chunk-QQNDLR6E.cjs');
-require('../chunk-4GFSUI2I.cjs');
-require('../chunk-MNHK6EQK.cjs');
-require('../chunk-RHR6P2KP.cjs');
-require('../chunk-MIKWTXUA.cjs');
-require('../chunk-HTSQPZHW.cjs');
-require('../chunk-NIBKCMQ2.cjs');
-require('../chunk-55V4VMTX.cjs');
-require('../chunk-7USEVMTW.cjs');
-require('../chunk-F7L2TZ3I.cjs');
-require('../chunk-XC2V34TS.cjs');
-require('../chunk-CCIGWTAO.cjs');
-require('../chunk-2M32LBCA.cjs');
-require('../chunk-3WZUNLYI.cjs');
-require('../chunk-UO2J2ZB2.cjs');
-
-
-exports.Wallet = _chunk4ZWUI6LEcjs.Wallet;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkVA26VSUQcjs = require('../chunk-VA26VSUQ.cjs');require('../chunk-CUHDOBKN.cjs');require('../chunk-JJ72GFYU.cjs');require('../chunk-3VYGTPRF.cjs');require('../chunk-LZNQBJEK.cjs');require('../chunk-NX256LAH.cjs');require('../chunk-576HP23H.cjs');require('../chunk-YPHM2V2G.cjs');require('../chunk-5IC7UWND.cjs');require('../chunk-4ADZVYB5.cjs');require('../chunk-IGRPHTXZ.cjs');require('../chunk-6MGMZ3SI.cjs');require('../chunk-ENU3EKBG.cjs');require('../chunk-W5EH3HYF.cjs');require('../chunk-7VUOD7EI.cjs');require('../chunk-RC6KDONJ.cjs');require('../chunk-PO6S7UR3.cjs');require('../chunk-QBS76CBT.cjs');require('../chunk-2C3AOHCT.cjs');require('../chunk-WP4V3OCS.cjs');require('../chunk-QY5OHQW4.cjs');require('../chunk-JBP52JOH.cjs');require('../chunk-SPTXAOFR.cjs');require('../chunk-5QIW67NU.cjs');require('../chunk-YGL4ITFK.cjs');require('../chunk-NJWSHT2H.cjs');require('../chunk-JJMKQ5PK.cjs');require('../chunk-A33BEWR7.cjs');require('../chunk-TTSJFEM5.cjs');require('../chunk-RXRRXB74.cjs');require('../chunk-6EZCCLTK.cjs');require('../chunk-SCEPJO4Q.cjs');require('../chunk-VV6374MW.cjs');require('../chunk-UE3WVHTM.cjs');require('../chunk-5X4EOJFG.cjs');require('../chunk-HRUMWG2F.cjs');require('../chunk-IR5WN6FQ.cjs');require('../chunk-GEY574TH.cjs');require('../chunk-T3U46LK3.cjs');require('../chunk-CCIGWTAO.cjs');require('../chunk-3OGAQBMG.cjs');require('../chunk-FOINTZC5.cjs');require('../chunk-2GKPWQBQ.cjs');exports.Wallet = _chunkVA26VSUQcjs.a;

package/dist/wallets/wallet.d.cts

@@ -1,24 +1,25 @@
+import { WalletsTransactionV2025ResponseDto } from '../api/gen/types.gen.cjs';
 import { ApiClient } from '../api/client.cjs';
-import { FundWalletResponse, GetTransactionsResponse, GetTransactionSuccessResponse, Activity, RegisterSignerPasskeyParams, WalletLocator, ApproveSignatureResponse } from '../api/types.cjs';
-import { WalletNftsResponseDto, WalletsTransactionV2025ResponseDto } from '../api/gen/types.gen.cjs';
-import { WalletOptions, Balances, SendTokenTransactionOptions, UserLocator, Transaction, PrepareOnly, ApproveParams, ApproveResult, AddDelegatedSignerOptions, AddDelegatedSignerReturnType, DelegatedSigner, ApproveOptions, Signature } from './types.cjs';
+import { e as WalletOptions, n as SignerConfigForChain, x as Signer, B as Balances, V as FundWalletResponse, X as GetTransactionsResponse, Y as GetTransactionSuccessResponse, T as Transfers, Z as SendTokenTransactionOptions, _ as UserLocator, b as Transaction, L as PrepareOnly, $ as ApproveParams, a0 as ApproveResult, a1 as AddSignerOptions, m as ServerSignerConfig, k as ExternalWalletRegistrationConfig, a2 as AddSignerReturnType, D as DelegatedSigner, o as SignerLocator, U as WalletLocator, a3 as ApproveOptions, a4 as ApproveSignatureResponse, g as Signature } from '../types-Dz8JNP4U.cjs';
 import { Chain } from '../chains/chains.cjs';
-import { Signer, ServerSignerConfig } from '../signers/types.cjs';
 import '@crossmint/common-sdk-base';
 import 'viem';
-import '@solana/web3.js';
+import 'ox';
 import '@crossmint/client-sdk-window';
 import '@crossmint/client-signers';
+import '@solana/web3.js';
 import 'abitype';
-import 'ox';
+import '../utils/device-signers/DeviceSignerKeyStorage.cjs';
 
 type WalletContructorType<C extends Chain> = {
     chain: C;
     address: string;
     owner?: string;
     alias?: string;
-    signer: Signer;
     options?: WalletOptions;
+    recovery: SignerConfigForChain<C>;
+    signers?: SignerConfigForChain<C>[];
+    signer?: Signer;
 };
 declare class Wallet<C extends Chain> {
     #private;
@@ -26,18 +27,39 @@ declare class Wallet<C extends Chain> {
     address: string;
     owner?: string;
     alias?: string;
-    signer: Signer;
     constructor(args: WalletContructorType<C>, apiClient: ApiClient);
+    get signer(): Signer | 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 get apiClient(): ApiClient;
+    protected static getRecovery<C extends Chain>(wallet: Wallet<C>): SignerConfigForChain<C>;
+    get apiClient(): ApiClient;
     protected get options(): WalletOptions | undefined;
     /**
-     * Get the API client
-     * @returns The API client
+     * Get the recovery signer config
+     * @returns The recovery signer config
      * @experimental This API is experimental and may change in the future
      */
-    experimental_apiClient(): ApiClient;
+    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)
@@ -68,31 +90,32 @@ declare class Wallet<C extends Chain> {
      * @param {number} params.page - The page number
      * @param {WalletLocator} [params.locator] - The locator
      * @returns The NFTs
-     * @experimental This API is experimental and may change in the future
      */
-    experimental_nfts(params: {
+    nfts(params: {
         perPage: number;
         page: number;
-    }): Promise<WalletNftsResponseDto>;
+    }): Promise<unknown>;
     /**
      * Get the wallet transactions
      * @returns The transactions
      * @throws {Error} If the transactions cannot be retrieved
      */
-    experimental_transactions(): Promise<GetTransactionsResponse>;
+    transactions(): Promise<GetTransactionsResponse>;
     /**
      * Get a transaction by id
      * @returns The transaction
      * @throws {Error} If the transaction cannot be retrieved
      */
-    experimental_transaction(transactionId: string): Promise<GetTransactionSuccessResponse>;
+    transaction(transactionId: string): Promise<GetTransactionSuccessResponse>;
     /**
-     * Get the wallet activity
-     * @returns The activity
-     * @experimental This API is experimental and may change in the future
-     * @throws {Error} If the activity cannot be retrieved
+     * Get the wallet transfers
+     * @returns The transfers
+     * @throws {Error} If the transfers cannot be retrieved
      */
-    experimental_activity(): Promise<Activity>;
+    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)
@@ -108,7 +131,7 @@ declare class Wallet<C extends Chain> {
      * @param params - The parameters
      * @param params.transactionId - The transaction id
      * @param params.options - The options for the transaction
-     * @param params.options.experimental_approval - The approval
+     * @param params.options.approval - The approval
      * @param params.options.additionalSigners - The additional signers
      * @returns The transaction
      */
@@ -119,28 +142,103 @@ declare class Wallet<C extends Chain> {
      * @param params.transactionId - The transaction id or
      * @param params.signatureId - The signature id
      * @param params.options - The options for the transaction
-     * @param params.options.experimental_approval - The approval
+     * @param params.options.approval - The approval
      * @param params.options.additionalSigners - The additional signers
      * @returns The transaction or signature
      */
     approve<T extends ApproveParams>(params: T): Promise<ApproveResult<T>>;
     /**
-     * Add a delegated signer to the wallet
-     * @param signer - The signer. For Solana, it must be a string. For EVM, it can be a string or a passkey.
+     * 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.experimental_prepareOnly - If true, returns the transaction/signature ID without auto-approving
+     * @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> : DelegatedSigner>;
+    /**
+     * Set the active signer for this wallet.
+     * Accepts a signer config object. The locator is inferred internally.
+     * Works for both delegated signers and the recovery (admin) 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 delegated and recovery signers).
+     *
+     * @param signer - The signer config object to use
      */
-    addDelegatedSigner<T extends AddDelegatedSignerOptions | undefined = undefined>(params: {
-        signer: string | RegisterSignerPasskeyParams | ServerSignerConfig;
-        options?: T;
-    }): Promise<T extends PrepareOnly<true> ? AddDelegatedSignerReturnType<C> : void>;
+    useSigner(signer: SignerConfigForChain<C>): Promise<void>;
     /**
-     * List the delegated signers for this wallet.
-     * @returns {Promise<DelegatedSigner[]>} The delegated signers
+     * Resolve a non-device signer: check delegated registration first, then fall back to recovery.
+     * For passkeys without an explicit credential id, auto-selects from registered delegated signers.
      */
-    delegatedSigners(): Promise<DelegatedSigner[]>;
+    private resolveNonDeviceSigner;
+    /**
+     * Try to auto-select a passkey credential from registered delegated 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 (delegated) 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>;
+    /**
+     * 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<DelegatedSigner[]>} The signers
+     */
+    signers(): Promise<DelegatedSigner[]>;
     protected get walletLocator(): WalletLocator;
+    /**
+     * Ensures that a signer is available. Throws if the wallet is read-only.
+     */
+    protected requireSigner(): Signer;
     protected preAuthIfNeeded(): Promise<void>;
+    /**
+     * Check if a signer config matches the wallet's recovery (admin) 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;
+    /**
+     * Build an InternalSignerConfig from a SignerConfigForChain.
+     */
+    private buildInternalSignerConfig;
     protected get isSolanaWallet(): boolean;
     protected resolveChainForEnvironment(): C;
     protected approveTransactionAndWait(transactionId: string, options?: ApproveOptions): Promise<{

package/dist/wallets/wallet.d.ts

@@ -1,24 +1,25 @@
+import { WalletsTransactionV2025ResponseDto } from '../api/gen/types.gen.js';
 import { ApiClient } from '../api/client.js';
-import { FundWalletResponse, GetTransactionsResponse, GetTransactionSuccessResponse, Activity, RegisterSignerPasskeyParams, WalletLocator, ApproveSignatureResponse } from '../api/types.js';
-import { WalletNftsResponseDto, WalletsTransactionV2025ResponseDto } from '../api/gen/types.gen.js';
-import { WalletOptions, Balances, SendTokenTransactionOptions, UserLocator, Transaction, PrepareOnly, ApproveParams, ApproveResult, AddDelegatedSignerOptions, AddDelegatedSignerReturnType, DelegatedSigner, ApproveOptions, Signature } from './types.js';
+import { e as WalletOptions, n as SignerConfigForChain, x as Signer, B as Balances, V as FundWalletResponse, X as GetTransactionsResponse, Y as GetTransactionSuccessResponse, T as Transfers, Z as SendTokenTransactionOptions, _ as UserLocator, b as Transaction, L as PrepareOnly, $ as ApproveParams, a0 as ApproveResult, a1 as AddSignerOptions, m as ServerSignerConfig, k as ExternalWalletRegistrationConfig, a2 as AddSignerReturnType, D as DelegatedSigner, o as SignerLocator, U as WalletLocator, a3 as ApproveOptions, a4 as ApproveSignatureResponse, g as Signature } from '../types-BaHy48kd.js';
 import { Chain } from '../chains/chains.js';
-import { Signer, ServerSignerConfig } from '../signers/types.js';
 import '@crossmint/common-sdk-base';
 import 'viem';
-import '@solana/web3.js';
+import 'ox';
 import '@crossmint/client-sdk-window';
 import '@crossmint/client-signers';
+import '@solana/web3.js';
 import 'abitype';
-import 'ox';
+import '../utils/device-signers/DeviceSignerKeyStorage.js';
 
 type WalletContructorType<C extends Chain> = {
     chain: C;
     address: string;
     owner?: string;
     alias?: string;
-    signer: Signer;
     options?: WalletOptions;
+    recovery: SignerConfigForChain<C>;
+    signers?: SignerConfigForChain<C>[];
+    signer?: Signer;
 };
 declare class Wallet<C extends Chain> {
     #private;
@@ -26,18 +27,39 @@ declare class Wallet<C extends Chain> {
     address: string;
     owner?: string;
     alias?: string;
-    signer: Signer;
     constructor(args: WalletContructorType<C>, apiClient: ApiClient);
+    get signer(): Signer | 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 get apiClient(): ApiClient;
+    protected static getRecovery<C extends Chain>(wallet: Wallet<C>): SignerConfigForChain<C>;
+    get apiClient(): ApiClient;
     protected get options(): WalletOptions | undefined;
     /**
-     * Get the API client
-     * @returns The API client
+     * Get the recovery signer config
+     * @returns The recovery signer config
      * @experimental This API is experimental and may change in the future
      */
-    experimental_apiClient(): ApiClient;
+    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)
@@ -68,31 +90,32 @@ declare class Wallet<C extends Chain> {
      * @param {number} params.page - The page number
      * @param {WalletLocator} [params.locator] - The locator
      * @returns The NFTs
-     * @experimental This API is experimental and may change in the future
      */
-    experimental_nfts(params: {
+    nfts(params: {
         perPage: number;
         page: number;
-    }): Promise<WalletNftsResponseDto>;
+    }): Promise<unknown>;
     /**
      * Get the wallet transactions
      * @returns The transactions
      * @throws {Error} If the transactions cannot be retrieved
      */
-    experimental_transactions(): Promise<GetTransactionsResponse>;
+    transactions(): Promise<GetTransactionsResponse>;
     /**
      * Get a transaction by id
      * @returns The transaction
      * @throws {Error} If the transaction cannot be retrieved
      */
-    experimental_transaction(transactionId: string): Promise<GetTransactionSuccessResponse>;
+    transaction(transactionId: string): Promise<GetTransactionSuccessResponse>;
     /**
-     * Get the wallet activity
-     * @returns The activity
-     * @experimental This API is experimental and may change in the future
-     * @throws {Error} If the activity cannot be retrieved
+     * Get the wallet transfers
+     * @returns The transfers
+     * @throws {Error} If the transfers cannot be retrieved
      */
-    experimental_activity(): Promise<Activity>;
+    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)
@@ -108,7 +131,7 @@ declare class Wallet<C extends Chain> {
      * @param params - The parameters
      * @param params.transactionId - The transaction id
      * @param params.options - The options for the transaction
-     * @param params.options.experimental_approval - The approval
+     * @param params.options.approval - The approval
      * @param params.options.additionalSigners - The additional signers
      * @returns The transaction
      */
@@ -119,28 +142,103 @@ declare class Wallet<C extends Chain> {
      * @param params.transactionId - The transaction id or
      * @param params.signatureId - The signature id
      * @param params.options - The options for the transaction
-     * @param params.options.experimental_approval - The approval
+     * @param params.options.approval - The approval
      * @param params.options.additionalSigners - The additional signers
      * @returns The transaction or signature
      */
     approve<T extends ApproveParams>(params: T): Promise<ApproveResult<T>>;
     /**
-     * Add a delegated signer to the wallet
-     * @param signer - The signer. For Solana, it must be a string. For EVM, it can be a string or a passkey.
+     * 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.experimental_prepareOnly - If true, returns the transaction/signature ID without auto-approving
+     * @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> : DelegatedSigner>;
+    /**
+     * Set the active signer for this wallet.
+     * Accepts a signer config object. The locator is inferred internally.
+     * Works for both delegated signers and the recovery (admin) 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 delegated and recovery signers).
+     *
+     * @param signer - The signer config object to use
      */
-    addDelegatedSigner<T extends AddDelegatedSignerOptions | undefined = undefined>(params: {
-        signer: string | RegisterSignerPasskeyParams | ServerSignerConfig;
-        options?: T;
-    }): Promise<T extends PrepareOnly<true> ? AddDelegatedSignerReturnType<C> : void>;
+    useSigner(signer: SignerConfigForChain<C>): Promise<void>;
     /**
-     * List the delegated signers for this wallet.
-     * @returns {Promise<DelegatedSigner[]>} The delegated signers
+     * Resolve a non-device signer: check delegated registration first, then fall back to recovery.
+     * For passkeys without an explicit credential id, auto-selects from registered delegated signers.
      */
-    delegatedSigners(): Promise<DelegatedSigner[]>;
+    private resolveNonDeviceSigner;
+    /**
+     * Try to auto-select a passkey credential from registered delegated 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 (delegated) 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>;
+    /**
+     * 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<DelegatedSigner[]>} The signers
+     */
+    signers(): Promise<DelegatedSigner[]>;
     protected get walletLocator(): WalletLocator;
+    /**
+     * Ensures that a signer is available. Throws if the wallet is read-only.
+     */
+    protected requireSigner(): Signer;
     protected preAuthIfNeeded(): Promise<void>;
+    /**
+     * Check if a signer config matches the wallet's recovery (admin) 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;
+    /**
+     * Build an InternalSignerConfig from a SignerConfigForChain.
+     */
+    private buildInternalSignerConfig;
     protected get isSolanaWallet(): boolean;
     protected resolveChainForEnvironment(): C;
     protected approveTransactionAndWait(transactionId: string, options?: ApproveOptions): Promise<{

package/dist/wallets/wallet.js

@@ -1,33 +1 @@
-import {
-  Wallet
-} from "../chunk-VVPGO564.js";
-import "../chunk-L52GDMSH.js";
-import "../chunk-CTOLL4BK.js";
-import "../chunk-QM3BB4E2.js";
-import "../chunk-S2L5Z2ZT.js";
-import "../chunk-H6WV5NRT.js";
-import "../chunk-GJT2JD3E.js";
-import "../chunk-K6LSGLG6.js";
-import "../chunk-2RG6642I.js";
-import "../chunk-YDZRBHS3.js";
-import "../chunk-HFEF2URB.js";
-import "../chunk-4Z3YDHHG.js";
-import "../chunk-T5NKL6F4.js";
-import "../chunk-FZQG6OX2.js";
-import "../chunk-FOOISYCJ.js";
-import "../chunk-Q52MMQSC.js";
-import "../chunk-WJUPOCKJ.js";
-import "../chunk-X4SPF4KJ.js";
-import "../chunk-ZBLW42YE.js";
-import "../chunk-2T5HHKUI.js";
-import "../chunk-3U6UAYOV.js";
-import "../chunk-MMISP35W.js";
-import "../chunk-JWMQALLN.js";
-import "../chunk-SGINWAB6.js";
-import "../chunk-455NK5LB.js";
-import "../chunk-XEPUH4XH.js";
-import "../chunk-GLUD6EBN.js";
-import "../chunk-ASE2FXWP.js";
-export {
-  Wallet
-};
+import{a}from"../chunk-2RNAWXXS.js";import"../chunk-TOAFCAVT.js";import"../chunk-575WRSRN.js";import"../chunk-IOSADDL5.js";import"../chunk-6FGJ3ICD.js";import"../chunk-GOXB2RBF.js";import"../chunk-N5WVT7QE.js";import"../chunk-2JW6HKFK.js";import"../chunk-L52GDMSH.js";import"../chunk-G5R6VQGJ.js";import"../chunk-QM3BB4E2.js";import"../chunk-PKYRYRX4.js";import"../chunk-OQZTL6ZG.js";import"../chunk-ZE4NT3CJ.js";import"../chunk-MMFZP54X.js";import"../chunk-WT5MDUZY.js";import"../chunk-YDZRBHS3.js";import"../chunk-36OMUNL3.js";import"../chunk-LEALJLNK.js";import"../chunk-SMADCELI.js";import"../chunk-RR6DWIRN.js";import"../chunk-O6VBO7KG.js";import"../chunk-EE4ITUGS.js";import"../chunk-WCGUGIGJ.js";import"../chunk-XNZLCUTY.js";import"../chunk-LB4V5KKI.js";import"../chunk-SH7KRBXV.js";import"../chunk-XS5B3TUE.js";import"../chunk-EIHK5TYE.js";import"../chunk-WBIKVPHW.js";import"../chunk-W7LJS32A.js";import"../chunk-2YLRFJ66.js";import"../chunk-JDDMCB6P.js";import"../chunk-KUP7H7X2.js";import"../chunk-FT5EVMLB.js";import"../chunk-SVIKBM3S.js";import"../chunk-KKQBZXFE.js";import"../chunk-S3DYQVRD.js";import"../chunk-EXC7TCGL.js";import"../chunk-455NK5LB.js";import"../chunk-6TYV7ADO.js";import"../chunk-W6V7WGBL.js";import"../chunk-J3R36SGJ.js";export{a as Wallet};

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@crossmint/wallets-sdk",
-  "version": "0.21.0",
+  "version": "1.0.0-beta.3",
   "repository": "https://github.com/Crossmint/crossmint-sdk",
   "license": "Apache-2.0",
   "author": "Paella Labs Inc",
   "sideEffects": false,
   "type": "module",
   "exports": {
-    "import": "./dist/index.js",
-    "require": "./dist/index.cjs"
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -22,6 +24,7 @@
     "@solana/web3.js": "1.98.1",
     "@stellar/stellar-sdk": "v14.0.0-rc.3",
     "abitype": "1.0.8",
+    "base32.js": "0.1.0",
     "bs58": "5.0.0",
     "@noble/hashes": "1.8.0",
     "ox": "0.6.9",
@@ -29,8 +32,9 @@
     "viem": "2.33.1",
     "@crossmint/client-sdk-window": "1.0.9",
     "@crossmint/client-signers": "0.1.2",
-    "@crossmint/common-sdk-auth": "1.0.73",
-    "@crossmint/common-sdk-base": "0.9.20"
+    "@crossmint/common-sdk-auth": "1.1.0-beta.1",
+    "@crossmint/common-sdk-base": "0.10.0-beta.1",
+    "@crossmint/client-signers-cryptography": "0.0.4"
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "0.69.2",