Skip to content

jerrymusaga/Spectra-Protocol

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Spectra Protocol

Verifiable Strategy Vaults with Fork Marketplace on Solana

Built for Solana Frontier Hackathon 2026 (April 6 – May 11).

Quick Start

Frontend (runs immediately with mock data)

cd frontend && npm install && npm run dev
# → http://localhost:3000

Anchor Program

anchor build && anchor deploy
# Update program ID in Anchor.toml, lib.rs, agent/.env

Agent

cd agent && npm install && cp .env.example .env
# Edit .env, fund agent wallet, then:
npm run dev

Architecture

  • Anchor Program: 8 instructions — initialize_fund, deposit, withdraw, authorize_deployment, return_from_deployment, log_receipt, publish_fund, fork_fund
  • Agent: Real Kamino klend-sdk + Jupiter API + Pyth SOL/USD integration
  • Frontend: Next.js 14, Tailwind, custom design system

Venues (Real Integrations)

Venue APY SDK
Kamino USDC Lending 6-20%+ @kamino-finance/klend-sdk
Kamino SOL Lending 3-8% @kamino-finance/klend-sdk
Jupiter JLP 10-20% Jupiter v6 API
JLP Multiply 20-35% klend-sdk (leverage)

Signal Types

Signal Source
SOL 24h Momentum Pyth SOL/USD
USDC Lending APY Kamino reserve
JLP APY Jupiter
SOL Lending APY Kamino reserve

Solflare Integration (Deep Wallet Experience)

Spectra treats the wallet as a core interface layer, not just a connect button. Built for the Solflare integration track with deep wallet-first UX.

What We Built

Feature Description
Custom Connect Modal Solflare featured as recommended wallet with branded UI, security notices, and connected-state actions
Transaction Simulation Every transaction is simulated before signing — users see estimated fees, compute units, warnings, and program logs before approval
Transaction Builder 5-step signing flow (Configure → Simulate → Sign → Confirmed → Error) for deposits, withdrawals, and strategy forks
Portfolio Analytics Real-time SOL + SPL token balances, USD values, allocation breakdown bar, auto-refresh every 30s
Transaction History On-chain tx classification (swap/defi/nft/transfer), SOL balance changes, program detection (Jupiter, Kamino, Bubblegum)
Solflare Deep Links solflare:// in-app browser links for strategies, transactions, and accounts
Shareable URLs Pre-filled action params (?action=deposit&amount=100) — recipients land directly on deposit/fork flows
QR Codes Generated SVG QR codes for mobile scanning — opens strategy in Solflare's in-app browser
Wallet Command Center Dedicated /wallet page with portfolio, activity, and transact tabs
Wallet-First Onboarding Connect prompts on dashboard, inline tx builders on fund pages, deep link param parsing

Deep Link Examples

# Open strategy in Solflare in-app browser
https://solflare.com/ul/v1/browse/https%3A%2F%2Fspectra-protocol.xyz%2Ffund%2Falpha-sentinel?cluster=devnet

# Shareable deposit link (pre-fills amount)
https://spectra-protocol.xyz/fund/alpha-sentinel?action=deposit&amount=100&ref=share

# Shareable fork link
https://spectra-protocol.xyz/fund/alpha-sentinel?action=fork&ref=share

# View transaction in Solflare
https://solflare.com/tx/<signature>?cluster=devnet

Architecture

frontend/src/
├── providers/WalletProvider.tsx      # Solflare-first adapter setup
├── hooks/
│   ├── useWalletPortfolio.ts         # Real-time SOL + SPL balances
│   ├── useTransactionHistory.ts      # On-chain tx fetch + classification
│   └── useTransactionSimulator.ts    # Pre-sign simulation engine
├── components/wallet/
│   ├── WalletModal.tsx               # Custom connect modal
│   ├── WalletPortfolio.tsx           # Portfolio analytics panel
│   ├── TransactionHistory.tsx        # Classified tx feed
│   ├── TransactionSimulator.tsx      # Simulation preview UI
│   ├── TransactionBuilder.tsx        # Multi-step signing flow
│   └── ShareStrategy.tsx             # Deep link + QR share modal
├── lib/deep-links.ts                 # Solflare deep link generator
└── app/wallet/page.tsx               # Wallet command center

Trust Model

Agent wallet (dedicated keypair) is registered as fund.agent_authority. Spectra program controls deployment limits via authorize_deployment with guardrails: max per tx, max outstanding, cooldown period. Every action logged as immutable Receipt PDA + cNFT.

About

Verifiable Strategy Vaults with Fork Marketplace on Solana

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors