Soroban Smart Wallet POC

A monorepo proof of concept demonstrating WebAuthn-enabled Smart Wallets on the Stellar/Soroban blockchain.

Overview

This project showcases how to build a smart wallet that uses passkeys (WebAuthn) for authentication and transaction signing, eliminating the need for traditional private key management.

Structure

• apps/backend - Express.js backend server handling WebAuthn flows and Soroban interactions
• apps/web - React frontend application for wallet management
• contracts/ - Soroban smart contracts (Factory and Smart Wallet)

Prerequisites

For Node.js Apps

• Node.js 24 LTS or higher
• npm 10.x or higher

For Smart Contracts

• Rust (install via rustup)
• Stellar CLI stellar-cli

Getting Started

1. Install Dependencies

npm install

2. Build Smart Contracts

cd contracts
make build

3. Configure Environment

Copy the example environment file in the backend:

cp apps/backend/.env.example apps/backend/.env

Then update the values with your Stellar testnet configuration.

4. Run Development Servers

Run the backend server:

npm run dev:backend

Run the web application (in a separate terminal):

npm run dev:web

Build

Build all applications:

npm run build

Build individual applications:

npm run build:backend
npm run build:web

License

MIT