Skip to content

bridgelet-org/bridgelet

Bridgelet

Ephemeral accounts for onboarding non-crypto users into Stellar

Overview

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.

Key Features

  • ✅ 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

Architecture

  • bridgelet-core: Soroban smart contracts for on-chain account restrictions and sweep logic
  • bridgelet-sdk: NestJS backend SDK for account lifecycle management and claim authentication
  • bridgelet-ui: (Future) Next.js reference implementation for claim flows

📚 Documentation

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 README for alternative viewing methods.

This documentation is actively maintained and will evolve as the project progresses.

Quick Start

# Clone repositories
git clone https://github.com/bridgelet-org/bridgelet-sdk.git
git clone https://github.com/bridgelet-org/bridgelet-core.git

# See individual repo READMEs for setup instructions

Repositories

MVP Scope (v0.1)

  • 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.

Status

🚧 Early Development - Building core primitives

Current phase: MVP implementation (Q1 2026)

See our Public Roadmap for future plans and milestones.

Security

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

Contributing

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

License

MIT License - see LICENSE

Contact


Built for the Stellar ecosystem 🌟

About

Main coordination repo

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 11