crossmint_wallets

Releases

1. ▸▾0.2.17 Oct 2026Deprecated

   The single recovery argument is deprecated. Pass one of them, not both. When the request is read, both throw CrossmintWalletException with walletInval…

   • CrossmintWalletCreateRequest and CrossmintCreateOnLoginConfig take recoveryMethods on their default constructor. The single recovery argument is deprecated. Pass one of them, not both. When the request is read, both throw CrossmintWalletException with walletInvalidRecoveryConfig, and neither throws it with walletMissingRecoveryMethod.
   • Deprecated: the .withRecoveryMethods constructors. Use the default constructor with recoveryMethods.
   • Requires crossmint_core ^0.1.8.

   Open source →
2. ▸▾0.2.025 Sept 2026Breaking

   …recovery method that authorizes the operation. Breaking change for anyone implementing `CrossmintWalletsClient` directly — add the parameter to your i…

   • CrossmintWalletsClient.addSigner and .removeSigner gained an optional approver parameter, naming the recovery method that authorizes the operation. Breaking change for anyone implementing CrossmintWalletsClient directly — add the parameter to your implementation. Threaded through DefaultCrossmintWalletsClient, WalletsApiService.unregisterSigner, and the signer registration/removal serialization.
   • CrossmintWalletCreateRequest gained a second constructor, .withRecoveryMethods, taking the full recoveryMethods list. The two constructors are mutually exclusive: the default one takes a single recovery, the new one takes the list. recoveryMethods and recovery (the first entry) are readable off either. Mirrors the paired createWallet overloads in the Swift and Kotlin SDKs.
   • The wire form follows the constructor, not the list length. The default constructor sends config.adminSigner and works on every chain; .withRecoveryMethods sends config.recoveryMethods on Solana and Stellar. On another chain a one-entry list goes out as config.adminSigner, and a longer list throws CrossmintWalletException(walletInvalidChain) client-side instead of reaching the backend's HTTP 501. This matches RecoveryInput in the Swift SDK and RecoveryConfig in Kotlin.
   • CrossmintWalletCreateRequest.withResolvedSigners rebuilds a request with resolved signers through the same constructor, so the wire form survives the controller's email and device-signer resolution. usesRecoveryMethodList reports which form a request holds.
   • CrossmintWallets.createWalletWithRecoveryMethods is the facade entry point for the list form; createWallet keeps its single-recovery signature.
   • New error code CrossmintErrorCode.walletMissingRecoveryMethod, thrown as a CrossmintWalletException when a request carries no recovery method at all. It is an Exception rather than the StateError an empty list would otherwise raise, so caller on Exception handlers catch it instead of leaving the operation stranded in progress.
   • Fixed: the approver is trimmed before it is sent. The registration body and the unregisterSigner query string used to carry the raw string, and a whitespace-only approver is now dropped instead of sent as " ".
   • Requires crossmint_core ^0.1.7.

• crossmint_flutterpub.devFlutter SDK for Crossmint wallets, authentication, signers, embedded checkout, and verifiable credentials. Headless-first — you own the UI.
• crossmint_corepub.devPure-Dart base primitives for the Crossmint Flutter SDK — config, transport, error types, chain validation, and shared models.