Skip to content

Jubilee-Protocol/jubilee-pocket

Repository files navigation

Jubilee Pocket πŸ“±

Jubilee Pocket turns your Solana Seeker into a device that pays for itself. Stake SKR tokens directly to Guardians via the Seed Vault to unlock instant, self-repaying jUSDi credit. Secure, biometric, and built for the Liberty Layer

License: MIT Solana Anchor Donate Crypto

Jubilee Pocket


App Screenshots

Welcome Β  Deposit Β  Borrow Β  Auto-Repay


Overview

Jubilee Pocket is a mobile-first lending protocol designed for the Solana Seeker device. Users deposit Seeker Rewards (SKR) as collateral and borrow jUSDi (Jubilee USD Index) against their holdings with up to 55% LTV β€” plus a holder bonus for larger positions.

Key Features

  • 🏦 Collateralized Lending β€” Deposit SKR, borrow jUSDi
  • πŸ“ˆ Yield Harvesting β€” Automatically repays debt with staking rewards
  • πŸ” Seed Vault Integration β€” Native hardware security on Seeker
  • ⚑ Pyth Oracle β€” Real-time price feeds for accurate LTV
  • πŸ”„ Jupiter Swaps β€” Swap jUSDi ↔ USDC directly in-app
  • πŸ›‘ Emergency Pause β€” Circuit breaker for admin control
  • πŸ“± React Native App β€” Mobile-first experience

Program Addresses

Devnet (Live βœ…)

Program Address
Guardian Vault DwuGR9qYkgYUPxR6jZSkAHdv23YPeqaAwxLAG593L1ar
SKR Mint (Demo) SKR1111111111111111111111111111111111111111
jUSDi Mint (Demo) jUSD111111111111111111111111111111111111111

Note: Demo mints are used for testing. Production mints will be deployed with mainnet launch.


Repository Structure

jubilee-pocket/
β”œβ”€β”€ programs/
β”‚   └── guardian-vault/     # Anchor program
β”‚       └── src/
β”‚           β”œβ”€β”€ instructions/
β”‚           β”œβ”€β”€ state/
β”‚           └── errors.rs
β”œβ”€β”€ mobile/                  # React Native app (Jubilee Pocket)
β”‚   β”œβ”€β”€ App.tsx              # Main app entry
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ screens/         # 7 screens (Home, Deposit, Borrow, etc.)
β”‚   β”‚   β”œβ”€β”€ components/      # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ services/        # NotificationService, etc.
β”‚   β”‚   └── utils/
β”‚   β”œβ”€β”€ android/             # Android build config
β”‚   └── ios/                 # iOS build config
β”œβ”€β”€ assets/                  # Logo and screenshots
β”œβ”€β”€ tests/                   # Integration tests
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ AUDIT_REPORT.md
β”‚   β”œβ”€β”€ RED_TEAM_AUDIT.md
β”‚   β”œβ”€β”€ ONE_PAGER.md
β”‚   β”œβ”€β”€ COPYRIGHT.md
β”‚   └── PRIVACY_POLICY.md
β”œβ”€β”€ hackathon/
β”‚   └── apk/                 # Android APK for submission
└── Anchor.toml

Quick Start

Prerequisites

  • Rust 1.70+
  • Solana CLI 1.16+
  • Anchor 0.28.0
  • Node.js 18+

Build & Test

# Clone
git clone git@github.com:Jubilee-Protocol/jubilee-pocket.git
cd jubilee-pocket

# Install dependencies
yarn install

# Build program
anchor build

# Run tests
anchor test

Deploy to Devnet

# Configure for devnet
solana config set --url devnet

# Get devnet SOL
solana airdrop 5

# Deploy
anchor deploy --provider.cluster devnet

Run the Mobile App

The mobile app requires the Android SDK and a Solana Seeker (or emulator).

cd mobile
yarn install
# Ensure you have an Android Emulator running or device connected
yarn android

⚠️ Hardware Requirement: This application relies on the Solana Seed Vault. Full functionality requires a Solana Seeker or Saga device. Standard Android emulators may fail at the "Connect Wallet" step.


How It Works

Deposit & Borrow Flow

  1. User deposits SKR collateral
  2. Pyth oracle provides real-time price
  3. System calculates max borrow (55% LTV base)
  4. jUSDi minted to user wallet

Harvest & Repay

  1. User calls harvest_repay instruction
  2. Rewards calculated from staking APY
  3. Debt reduced by reward amount (minus 3% fee)

Withdrawal Flow (Two-Step)

  1. Start Cooldown β€” User initiates withdrawal
  2. Wait 48 Hours β€” Security cooldown
  3. Complete β€” Collateral returned, account closed

Security

Audit Score Status
Internal Review 93/100 βœ… Complete

See AUDIT_REPORT.md for details.


Roadmap

  • Core program development
  • Security audit (93/100)
  • Pyth oracle integration
  • Devnet deployment
  • Mobile app integration (Jubilee Pocket)
    • React Native with MWA support
    • SwapScreen (Jupiter API)
    • Push notifications
    • Demo mode for testing
  • Mainnet launch (February 2026)
  • Bootstrap funds for pool creation (jUSDi/USDC + jUSDi/SKR)

Built By

Jubilee Labs β€” Building the Liberty Layer known as Jubilee Protocol


License

MIT License β€” see LICENSE


"The prudent see danger and take refuge, but the simple keep going and pay the penalty." β€” Proverbs 22:3