Skip to main content

​
Embedded Wallets

Integrate Spark wallets directly into your applications for seamless Bitcoin-native user experiences.

​
Overview

Embedded wallets allow users to interact with Bitcoin and Spark without managing separate wallet applications. Perfect for DeFi apps, games, and consumer applications.

​
Prerequisites

  • Spark SDK installed
  • Basic React/JavaScript knowledge
  • Understanding of wallet concepts

​
Getting Started

​
Wallet Integration

Embed Spark wallets in your app: 
import { SparkWallet } from '@spark/sdk';

const wallet = new SparkWallet({
  // Configuration options
});

​
Key Features

  • Instant Setup: Users can start transacting immediately
  • Lightning Integration: Built-in Lightning Network support
  • Token Support: Native BTKN token handling
  • Cross-Platform: Works on web, mobile, and desktop

​
Implementation Patterns

​
Custodial Wallets

  • Quick onboarding
  • User-friendly experience
  • Managed key recovery

​
Non-Custodial Wallets

  • Full user control
  • Enhanced security
  • Self-sovereignty

​
Hybrid Approaches

  • Flexible key management
  • Progressive decentralization
  • Best of both worlds

​
Use Cases

  • DeFi Applications: Trading, lending, yield farming
  • Gaming: In-game economies and NFT trading
  • E-commerce: Bitcoin payments and rewards
  • Social Apps: Tipping and micropayments

​
Security Considerations

  • Key management strategies
  • Multi-signature setups
  • Hardware wallet integration
  • Recovery mechanisms

​
Next Steps

  • Choose your wallet integration approach
  • Implement basic wallet functionality
  • Add advanced features like Lightning payments