Skip to content

Shielded-Protocol/shielded-app

Repository files navigation

shielded-app

Next.js 14 frontend for Shielded Protocol.

Part of Shielded Protocol — private, compliant DeFi on Stellar.

CI Stellar Wave Issues


Routes

Route Description Status
/ Landing page — connect wallet, navigate to flows
/portfolio Private portfolio — shielded positions from local storage
/deposit Deposit flow — token selector, amount input, lifecycle 🔧 In progress
/withdraw Withdraw flow — ZK proof generation UI, step progress
/compliance Compliance dashboard — auditor view with viewing key 🔧 In progress

Quickstart

# Prerequisites: Node 20+, pnpm

git clone https://github.com/Shielded-Protocol/shielded-app
cd shielded-app
pnpm install

# Development
pnpm dev
# → http://localhost:3000

# Build
pnpm build

# Type check
pnpm typecheck

Key components

Component Purpose
ProofProgress Step-by-step ZK proof generation status with animated indicators
WalletConnect Freighter wallet connection (scaffold — see issue #15)
ShieldedBalance Private balance display from local note storage
NoteManager Encrypted local storage for shielded notes

Privacy model

Shielded positions are stored in browser localStorage. No balance data is ever sent to a server or exposed on-chain. The ZK proof is generated client-side — your secret never leaves your device.

Current state: localStorage is unencrypted in v0.1.0. Encryption using AES-GCM + wallet-derived key is planned for v0.2.0.


Contributing

See CONTRIBUTING.md.

Browse Wave-ready issues.


License

MIT

About

Next.js 14 frontend for Shielded Protocol: private portfolio, deposit/withdraw flows, ZK proof progress UI, compliance dashboard

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors