Before you start
Set up your project and get an API key.
Flutter Wallets Example
See the full example app in the SDK repo.
1
Install the SDK
Run the following command to install the SDK:
2
Configure deep link scheme for OAuth
If you plan to use OAuth login (Google, Twitter), you need a deep link scheme so the browser
can return to your app after authentication.Android — add to your iOS — add to your
AndroidManifest.xml:android/app/src/main/AndroidManifest.xml
Info.plist:ios/Runner/Info.plist
If you only use email OTP login (no OAuth), you can skip this step.
3
Initialize the client and add providers
Create a Pass the API key via For detailed configuration options, see the Flutter SDK Reference.
CrossmintWalletProvider at the root of your app. This example uses Crossmint Auth
but you can use any authentication provider of your choice.With the current setup, a wallet will be created automatically on login.See all supported chains here.main.dart
--dart-define when running the app:4
Allow users to login, logout, and access their wallet
Crossmint Auth in Flutter is headless — you build your own login UI and call the SDK directly.
Use
CrossmintWalletContext to access the auth client and wallet controller.home_screen.dart
Launching in Production
For production, some changes are required:- Create a developer account on the production console
- Create a production client API key on the API Keys page with the API scopes
users.create,users.read,wallets.read,wallets.create,wallets:transactions.create,wallets:transactions.sign,wallets:balance.read,wallets.fund - Replace your test API key with the production key
- Use your own authentication provider: For production applications, Crossmint recommends using third-party authentication with providers like Auth0, Firebase, or Supabase, rather than Crossmint Auth. Configure JWT authentication in the Crossmint Console under API Keys > JWT Authentication.
- Switch your chains from testnets to their mainnet equivalents (for example,
base-sepoliatobase), and re-create your wallets. Staging wallet addresses do not carry over to production. - Replace test tokens with real assets (for example,
usdxmtousdc), and plan for gas sponsorship as a real cost
Learn More
Check Balances
Check the balance of a wallet.
Transfer Tokens
Send tokens between wallets.
Operational Signers
Register operational signers on a wallet.
Other Links
API Reference
Deep dive into API reference docs.
Talk to an expert
Contact the Crossmint sales team for support.

