BMONI Embedded — overview - BMONI Embedded Docs

BMONI Embedded is a suite of Flutter packages that lets you add self-custodied Ethereum wallets, a production-grade design system, and ready-to-wire wallet card widgets to any Flutter app.

Start here

Every integration walks the same six stages in the same order. Read the lifecycle once, then jump to the goal you are building.

The integration lifecycle

User → wallet → KYC → rail → fund → move money. What each stage needs before it works, and what it leaves you with.

Start from a goal

USD accounts, Nigerian withdrawals, MXN ramps, SEPA payouts, or onboarding users with no app of your own.

The packages

bmoni_embedded_sdk

Provision secp256k1 wallets and sign Ethereum transactions on-device. Private keys never leave Android Keystore / iOS Secure Enclave.

bkey_uikit

BMONI design system for Flutter — colours, typography, theming, and every UI primitive used across Bkey products.

bmoni_embedded_wallets_cards

Model-aware wallet card widgets, Riverpod notifiers, and pluggable data contracts built on top of bkey_uikit.

API

REST API that backs the embedded wallet product. Full interactive reference hosted separately.

How the packages relate

┌──────────────────────────────────────────────────────────┐
│  Your app  ·  routing  ·  l10n  ·  analytics  ·  auth   │
├──────────────────────────────────────────────────────────┤
│  bmoni_embedded_wallets_cards                            │
│  · EmbeddedWallet models  · Riverpod notifiers          │
│  · EmbeddedWalletCard  · EmbeddedWalletTransactionsSection│
├──────────────────────────────────────────────────────────┤
│  bkey_uikit                                              │
│  · BMoniColors / BMoniTextStyles / BMoniTheme            │
│  · Buttons, forms, sheets, feedback, wallet card         │
├──────────────────────────────────────────────────────────┤
│  bmoni_embedded_sdk                                      │
│  · BmoniEmbeddedSdk  (wallet + PIN + signing)            │
│  · Android Keystore  /  iOS Secure Enclave               │
└──────────────────────────────────────────────────────────┘

Each layer is independently installable. You can use bkey_uikit without bmoni_embedded_sdk, or use bmoni_embedded_sdk headlessly in a custom UI.

Quick links

Task	Where to go
Add a self-custodied wallet to my app	Quickstart
Provision a wallet on-device	Wallet provisioning
Sign a message or transaction	Signing
Apply the BMONI theme	UI Kit — installation
Render a wallet card	Wallet card widget
Call the REST API	API reference

​Start here