🔍 Project Summary

SPARQ Shield is a decentralized protection protocol on Solana, built to provide automated, transparent coverage for DeFi protocols. It enables users to deposit funds into a shared pool, purchase coverage plans, and receive instant or automated payouts when incidents occur — all on-chain, without intermediaries.

The frontend and branding are already live at Coinsparq.com, showcasing the SPARQ Shield vision. The smart contract is partially implemented, with infrastructure and front-end integration still required to reach full feature parity.

🧠 Current State

✅ Completed

  • Environment setup: Rust 1.81, Anchor 0.30.1, Solana CLI 2.3.13
  • Base Anchor program created (sparq_shield)
  • PDAs + vault logic implemented (pool + off-curve ATA)
  • Deposit / withdraw flow tested with Node.js scripts
  • Frontend website and wallet connection UI completed
  • Branding, marketing copy, and whitepaper finalized

⚠️ In Progress / Missing

  • Policy purchase + management logic
  • Instant payout / claim execution logic
  • Dynamic plan pricing (Bronze, Silver, Gold)
  • Indexer for real-time metrics (capital, APY, utilization)
  • Program configuration instructions (fees, governance)
  • Devnet deployment + testing
  • Frontend integration with IDL + metrics API

⚙️ Technical Scope

Anchor Program (On-Chain)

Implement and test:

  • initialize_pool — Create a new pool with vault + fee config
  • deposit / withdraw — Transfer tokens between user and vault
  • purchase_policy — Pay premium, mint or record policy
  • trigger_claim — Auto/keeper-triggered payout
  • set_fee_bps, set_plan_config — Admin configuration

Off-Chain Indexer / API

  • Subscribe to program events (via Helius or WebSocket)
  • Aggregate and output /metrics.json with:
    • Total capital locked
    • Active policies
    • Utilization rate
    • Provider APY

Frontend Integration

  • Connect wallet → display user balances + policies
  • Buy coverage and pay premium via Anchor client
  • Display dashboard metrics (from /metrics.json)
  • Include protection estimator based on on-chain pricing logic

🏗️ Deliverables

TypeDeliverableNotes
Programsparq_shield.so, sparq_shield.jsonDeployed on Devnet
Scriptsinit.ts, deposit.ts, withdraw.ts, buy_policy.ts, trigger_claim.tsCLI testing scripts
API/metrics.jsonJSON data for frontend dashboard
FrontendWallet connect + coverage purchaseHooked via IDL client
DocsREADME.md, SPEC_GAP.mdFull setup + deployment guide
DevnetPublic addresses + TX linksFor demo validation

🚀 Phased Roadmap

Phase 1 (3 weeks)

  • Finalize and deploy on-chain logic (pool, policy, payout)
  • Build indexer service for metrics
  • Integrate frontend with IDL + metrics API
  • Deliver working Devnet demo

Phase 1.5 (1–2 weeks)

  • Add oracle/keeper automation for incident detection
  • Expand plan pricing with dynamic parameters

Phase 2 (3–4 weeks)

  • Governance integration
  • Multi-mint pools, institutional coverage
  • SPARQ token integration for utility + staking

🧩 Handoff Package (Already Available)

  • Whitepaper PDF
  • Frontend live at https://coinsparq.com
  • Anchor project folder (~/clean/programs/sparq_shield)
  • Environment fully configured
  • Partial scripts (mint_and_deposit_tx.js, etc.)

💬 Contact Summary

Owner: Peter (alias: Sparq)
Project: SPARQ Shield (part of Coinsparq)
Goal: Complete smart contract, integrate indexer, connect frontend for public demo launch.

Developer Deliverable: Bring the on-chain MVP to full feature parity with the website vision — automated, transparent Solana DeFi protection.