Ephemeral accounts for onboarding non-crypto users into Stellar
Bridgelet is an open-source infrastructure SDK that enables organizations to send payments to recipients who don't have crypto wallets yet. It creates secure, single-use Stellar accounts that automatically bridge recipients into permanent wallets when they claim funds.
The problem: Mass payments (payroll, aid, airdrops) fail when recipients don't have wallets or understand seed phrases.
The solution: Create temporary accounts that recipients can claim without crypto knowledge, then auto-sweep funds to permanent wallets.
- ✅ Single-use ephemeral Stellar accounts
- ✅ No seed phrase management for recipients
- ✅ Automatic sweep to permanent wallets
- ✅ Time-based expiration with fund recovery
- ✅ Composable with existing payment platforms
- bridgelet-core: Soroban smart contracts for on-chain restrictions
- bridgelet-sdk: Backend SDK and API (NestJS + TypeScript)
- bridgelet-ui: Reference UI demonstrating SDK integration (Next.js 16+, TypeScript, Tailwind CSS)
└─ Located in
frontend/within this repository
This is a monorepo containing both the docs and frontend reference implementation:
bridgelet/
├── frontend/ # Next.js Reference UI
│ ├── app/ # App router pages (/, /send, /claim/[token])
│ ├── components/ # Reusable UI components
│ ├── lib/ # Utilities and SDK wrappers
│ └── ...
└── docs/ # Technical specifications and guides
Comprehensive documentation is available in the /docs directory:
| Document | Description |
|---|---|
| 📐 Architecture Overview | System design and component interactions |
| 🔒 Security Model | Security considerations and threat model |
| 🚀 Getting Started | Quick start guide for developers |
| 🔧 Integration Guide | Step-by-step integration instructions |
| 💡 Use Cases & Examples | Real-world use cases and examples |
| 📋 MVP Specification | Minimum viable product requirements |
| 🧪 Testing Guide | Testing strategy, guidelines, and best practices |
📌 Note: If PDFs don't render in your browser, click the links above to download them directly, or see the docs directory for more information.
This documentation is actively maintained and will evolve as the project progresses.
The reference UI is built with Next.js 16+, TypeScript 5+ (Strict Mode), and Tailwind CSS.
To run the frontend locally:
# Navigate to the frontend directory
cd frontend
# Set up environment variables
cp .env.example .env.local
# Install dependencies
npm install
# Run the development server
npm run devThe application will be available at http://localhost:3000.
/— Homepage & Explainer/send— Sender Flow (Create ephemeral account)/claim/[token]— Recipient Flow (Direct claim redemption)
For backend or smart contract development, please refer to the specific repositories:
- bridgelet-sdk setup instructions
- bridgelet-core setup instructions
- bridgelet-sdk - Backend SDK (NestJS + TypeScript)
- bridgelet-core - Smart contracts (Soroban + Rust)
- bridgelet - Reference UI implementation and documentation (This repository)
- Create single-use Stellar accounts programmatically
- Accept one inbound payment per account
- Lock outbound transfers to one destination
- Auto-sweep on claim
- Expire unclaimed accounts after time window
See MVP Specification for complete details.
🚧 Early Development - Building core primitives
Current phase: MVP implementation (Q1 2026)
See our Public Roadmap for future plans and milestones.
Security is critical for financial infrastructure. If you discover a vulnerability, please review our Security Policy for responsible disclosure guidelines.
Security Contact: aminubabafatima8@gmail.com
We welcome contributions! See CONTRIBUTING.md for guidelines.
Please also review our Code of Conduct and Support Guide before engaging.
Areas of interest:
- Soroban smart contract development
- Financial infrastructure for emerging markets
- Developer experience and SDK design
MIT License - see LICENSE
- Issues: GitHub Issues
- Discussions: GitHub Discussions
-
- Support Overview: SUPPORT.md
Built for the Stellar ecosystem 🌟