A mobile-first Stellar Testnet wallet ecosystem
Stellar PocketPay is an open-source, mobile-first wallet ecosystem built on the Stellar Testnet. It is designed to demonstrate real-world blockchain development patterns while remaining approachable for developers of all experience levels.
The project spans three repositories that work together to provide a complete wallet experience — from a polished React Native mobile app, to a Soroban smart contract for savings vaults, to a reusable TypeScript SDK that ties everything together.
Note: This project runs on Stellar Testnet and is intended for educational and demonstration purposes. Do not use it with real funds.
The Stellar PocketPay ecosystem is organized as a multi-repo project:
| Repository | Description | Tech Stack |
|---|---|---|
stellar-pocketpay-wallet |
Mobile wallet app with full Stellar Testnet integration | React Native, Expo, TypeScript |
stellar-pocketpay-vault |
Soroban savings vault smart contract | Rust, Soroban SDK |
stellar-pocketpay-sdk |
Reusable TypeScript SDK for Stellar & Soroban interactions | TypeScript, Stellar SDK |
stellar-pocketpay-docs |
Central documentation (this repo) | Markdown |
stellar-pocketpay/
├── stellar-pocketpay-wallet/ # React Native mobile app
│ ├── src/
│ │ ├── screens/ # UI screens (Home, Send, Receive, Vault, etc.)
│ │ ├── services/ # Stellar & Soroban service layers
│ │ ├── components/ # Reusable UI components
│ │ ├── navigation/ # App navigation (React Navigation)
│ │ ├── store/ # State management (Zustand)
│ │ ├── theme/ # Design tokens & theming
│ │ └── utils/ # Helpers & constants
│ ├── app.json
│ └── package.json
│
├── stellar-pocketpay-vault/ # Soroban smart contract
│ ├── contracts/
│ │ └── savings-vault/
│ │ └── src/
│ │ ├── lib.rs # Contract entry point
│ │ ├── vault.rs # Core vault logic
│ │ ├── types.rs # Data types & enums
│ │ ├── errors.rs # Custom error codes
│ │ ├── events.rs # Contract events
│ │ ├── storage.rs # Storage helpers
│ │ └── test.rs # Unit tests
│ └── Cargo.toml
│
├── stellar-pocketpay-sdk/ # TypeScript SDK
│ ├── src/
│ │ ├── wallet/ # Wallet creation & management
│ │ ├── transactions/ # XLM payment operations
│ │ ├── vault/ # Soroban vault interactions
│ │ ├── types/ # TypeScript type definitions
│ │ ├── utils/ # Utility functions
│ │ └── index.ts # Public API exports
│ ├── tests/ # Test suites
│ └── package.json
│
└── stellar-pocketpay-docs/ # Documentation (this repo)
├── README.md
├── ARCHITECTURE.md
├── SETUP.md
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── ROADMAP.md
├── SECURITY.md
└── ISSUES.md
- Wallet Management — Create, import, and securely store Stellar keypairs
- Send & Receive XLM — Full payment flows with QR code support
- Transaction History — Paginated, real-time transaction feed
- Contact Book — Save and manage frequently used addresses
- Savings Vault — Deposit, withdraw, and time-lock funds via Soroban
- Testnet Funding — One-tap Friendbot integration for test XLM
- Deposits & Withdrawals — Secure fund management on-chain
- Time Locks — Lock funds for a specified duration
- Emergency Withdrawal — Owner-only emergency access with penalties
- Event Logging — Full audit trail via Soroban contract events
- Wallet Utilities — Generate keypairs, check balances, fund from Friendbot
- Payment Operations — Build, sign, and submit XLM transactions
- Vault Client — Typed interface for all Soroban vault operations
- Fully Typed — Comprehensive TypeScript definitions for all APIs
Each repository has its own detailed setup guide. Here's the fastest way to get started:
# 1. Clone all repos
git clone https://github.com/Stellar-PocketPay/stellar-pocketpay-wallet.git
git clone https://github.com/Stellar-PocketPay/stellar-pocketpay-vault.git
git clone https://github.com/Stellar-PocketPay/stellar-pocketpay-sdk.git
git clone https://github.com/Stellar-PocketPay/stellar-pocketpay-docs.git
# 2. Set up the SDK
cd stellar-pocketpay-sdk
npm install
npm run build
# 3. Set up the wallet app
cd ../stellar-pocketpay-wallet
npm install
npx expo start
# 4. Set up the smart contract (requires Rust & Soroban CLI)
cd ../stellar-pocketpay-vault
cargo build
cargo testFor detailed setup instructions, see SETUP.md.
| Document | Description |
|---|---|
| Architecture | System design, data flow, and component relationships |
| Setup Guide | Step-by-step setup for each repository |
| Contributing | How to contribute, branch naming, commit conventions |
| Code of Conduct | Community standards and expectations |
| Roadmap | Planned features and milestones |
| Security | Security practices and vulnerability reporting |
| Issue Guide | Issue labels, templates, and good first issues |
| Layer | Technology |
|---|---|
| Mobile App | React Native, Expo, TypeScript |
| State Management | Zustand |
| Navigation | React Navigation |
| Secure Storage | expo-secure-store |
| Smart Contract | Rust, Soroban SDK |
| SDK | TypeScript, @stellar/stellar-sdk |
| Network | Stellar Testnet / Soroban RPC |
We welcome contributions from developers of all experience levels! Whether you're fixing a typo, adding a feature, or improving documentation — every contribution matters.
- Read our Contributing Guide
- Check the Issue Guide for beginner-friendly tasks
- Follow our Code of Conduct
All repositories in the Stellar PocketPay ecosystem are licensed under the MIT License.
MIT License
Copyright (c) 2026 Stellar PocketPay Contributors
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Built with 💜 on Stellar