Banana Wallet SDK

Ship wallets your users can actually recover and trust. Banana Wallet SDK lets you wire up contract-based accounts with layered approval steps in minutes. Start by installing the client library, pick your factors (passkey/WebAuthn, email or app code, push), and call a single setup to enroll a device and create a policy-bound account. You can render the built-in screens for sign-in, factor enrollment, and recovery, or keep it headless and bring your own UI with the hooks. In development, run against a test network, seed mock factors, and trigger loss-of-device scenarios to validate recovery before you ever touch mainnet.

From there, design transaction rules instead of exposing a raw private key. Define spending limits per token, require a second check for transfers above a threshold, and whitelist destinations that skip extra prompts. For high-frequency actions—game moves, in-app swaps, or minting—you can issue short-lived session keys that sign only within the scope you allow. When a user confirms, the SDK assembles and submits a contract call, and if a policy needs more approvals it escalates to the next factor automatically. You handle a single success callback; the SDK manages prompts, retries, and user messaging.

Teams can extend the same flow to shared accounts. Add guardians or coworkers as additional approvers, map roles to methods (e.g., trading vs. withdrawals), and require N-of-M confirmations for sensitive actions. On the backend, subscribe to webhooks for approvals, recovery attempts, or policy changes to keep your logs and analytics in sync. Optional gas sponsorship lets you abstract fees for the first run, and you can flip it off when users are ready. The wallet address stays stable across devices, and users can rotate or revoke factors without breaking the account.

Going live is straightforward. Gate features behind capability checks so users on older devices can fall back to code-based prompts while modern browsers use passkeys. Provide backup codes during enrollment and a guided recovery path that confirms identity with multiple signals. Use the test utilities to fuzz policies, simulate chain congestion, and assert that blocked calls stay blocked. If you’re migrating from externally owned accounts, attach the contract wallet alongside the old address, mirror balances, and cut over once users enroll at least two factors. Banana Wallet SDK focuses on the workflows—enrollment, approval, recovery—so you can focus on your app, not key management.