Skip to content

ROADMAP.md

Latest commit

 

History

History
150 lines (115 loc) · 6.32 KB

ROADMAP.md

File metadata and controls

150 lines (115 loc) · 6.32 KB
Raw

Roadmap

Vision

Build a decentralized, cost-effective bridge between Base (Ethereum L2) and Stacks (Bitcoin L2) that allows users to transfer USDC at significantly lower costs than bridging via Ethereum L1.

Phase 1: Core Infrastructure (Completed)

  • EVM bridge contract (Solidity) with multi-sig support
  • Stacks xUSDC SIP-010 token upgraded to Clarity 4 (wrapped-usdc-v4)
  • Relayer service for event watching + mint/release flows
  • Frontend with wallet connection (WalletConnect + MetaMask + Base Account)
  • Deposit flow: Base USDC -> Stacks xUSDC
  • Withdraw flow: Stacks xUSDC -> Base USDC

Phase 2: Security Hardening (Completed)

  • Multi-signature validation (2-of-3 signers)
  • Rate limiting (hourly and daily caps) using stacks-block-time
  • Timelocked releases for large transactions
  • Emergency pause mechanism
  • Immutable on-chain audit trail

Phase 3: Developer Tooling & Open Source (Current)

  • Repository documentation + contribution guidelines
  • Local E2E harness scripts + guide (docs/local-e2e.md)
  • Deployment scripts with network-specific USDC validation
  • Config management (mainnet/testnet auto-detect + STACKS_CORE_API_URL)
  • Stacks devnet support + signer initialization v4 script
  • Frontend wallet UX upgrades (OnchainKit + Base Account, wagmi v2)
  • Initial testing (EVM unit tests + Clarinet tests for wrapped-usdc-v4)
  • GitHub issue templates
  • Good first issues for contributors (templates)
  • API documentation (contracts + relayer flow)
  • Expanded developer guides (setup, runbook, troubleshooting, deployment)

Phase 4: USDCx Integration ✅

Official USDCx Contract: SP120SBRBQJ00MCWS7TM5R8WJNTTKD5K0HFRC2CNE.usdcx (Circle xReserve)

  • Configure official Circle USDCx contract address in all contracts
  • Update frontend with USDCx contract reference
  • DEX adapter trait + Velar adapter stub contract
  • execute-mint-and-swap flow + auto-swap toggles in wrapped-usdc-v4
  • Research: DEX liquidity pool creation for xUSDC/USDCx (No pool exists; Velar permissionless, Bitflow preferred for stable-swaps)
  • Integration: Velar on-chain swap calls + pool configuration (velar-adapter.clar)
  • Alternative: Direct Circle xReserve integration (xreserve-adapter.clar + relayer handler)
  • Documentation: Bridge to USDCx workflow (docs/usdcx-workflow.md)

Phase 4.5: Testnet Deployment ✅

  • Base Sepolia: BridgeBase at 0xFCDF3e427e4a4CF3E573762693B9a1bBb35C504B
  • Stacks Testnet: wrapped-usdc-v5 deployed and signers initialized
  • Stacks Testnet: xreserve-adapter deployed
  • Relayer auto-reconnect for RPC filter expiration
  • Frontend simplified with native wagmi wallet connection
  • Deposit E2E Verified: Base → Stacks mint flow tested
  • Withdraw E2E Verified: Stacks → Base release flow tested
  • Transaction History UI: Component fetching from Blockscout API
  • Functional Withdraw Button: burnTokens() via openContractCall

Phase 5: Decentralization

  • Decentralized relayer network (multiple operators)
  • Governance token for protocol decisions
  • Fee sharing with relayer operators
  • Staking mechanism for relayers

Phase 6: Multi-Chain Expansion

  • Arbitrum One support
  • Optimism support
  • Other EVM L2 chains
  • Cross-chain routing optimization

Phase 7: Mainnet Launch ✅ COMPLETE (January 30, 2026)

Base Mainnet

Stacks Mainnet

Security Configuration

  • 2-of-3 multi-sig on both chains
  • Rate limits: 10K/tx, 50K/hr, 200K/day
  • Timelock for large transactions
  • Relayer configured and running

Phase 7.5: Frontend Enhancements ✅ (January 2026)

Real-Time L1 Gas Comparison (NEW)

  • Etherscan Gas Oracle v2 API integration
  • Dynamic L1 vs L2 fee comparison
  • Visual comparison bars (green L2 / red L1)
  • L1 gas price display in Gwei (e.g., "L1: 0.47 Gwei")
  • Edge case handling when L1 is cheaper (isCheaper boolean)

Dynamic Footer Stats

  • FooterStats component with real-time avg fee
  • Live calculation from usePrices hook
  • Shows "<$0.01" for very low fees

Real-Time Price Feeds

  • ETH/USD from Chainlink on Base mainnet (updates every block)
  • STX/USD from Coinbase API (5-minute cache)
  • usePrices hook with fallback values

SSR-Safe Wallet Connection

  • ConnectButton component with hydration handling
  • useSyncExternalStore for React 18 compatibility
  • Lazy AppKit initialization via openAppKitModal()
  • projectId validation with user-friendly error state

Network-Aware Components

  • BridgeStats: Dynamic Blockscout API (mainnet/testnet)
  • TransactionHistory: Auto-switches based on NEXT_PUBLIC_NETWORK
  • FeeEstimator: Live price badges showing data sources

Phase 8: Future Improvements

  • Security audit by reputable firm
  • Bug bounty program
  • Liquidity bootstrapping
  • DEX pool creation for xUSDC/USDCx

How to Contribute

See CONTRIBUTING.md for details on how to help with any of these phases. For contract APIs and relayer flow details, see docs/developer-api.md.

Priority Areas

  1. Security Audit - Third-party code review
  2. Liquidity - DEX pool creation for better UX
  3. Decentralization - Multiple relayer operators
  4. Documentation - User guides and tutorials