FaithBridge

Cross-chain capital optimizer for the multichain future. FaithBridge enables seamless yield migration from Ethereum to Stacks DeFi protocols with a single click.

The Mission

Bridge the gap between Ethereum's liquidity and Stacks' yield opportunities. FaithBridge automates the complex cross-chain journey so your capital never sleeps.

Why FaithBridge

• One-Click Yield: Zap from Ethereum directly into Stacks DeFi
• Best Rates: Automated yield optimization across protocols
• Full Transparency: Track every step of your cross-chain journey
• Secure: Battle-tested contracts with multi-sig protection

Architecture

faithbridge/
├── contracts/              # Clarity smart contracts
│   ├── vault.clar          # Yield vault with receipt tokens
│   ├── bridge-adapter.clar # xReserve integration
│   └── strategies/         # DeFi strategy adapters
├── frontend/               # React + TypeScript dashboard
├── analytics/              # Monitoring and alerting
└── docs/                   # Protocol documentation

Supported Strategies

Protocol	Type	Target APY
Zest Protocol	Lending	8-15%
Bitflow	DEX LP	10-25%
Alex Lab	Lending	6-12%

Features

• Dual wallet integration (MetaMask + Leather)
• Automated bridge tracking
• Portfolio dashboard with historical yields
• Gas estimation and optimization
• Multi-strategy allocation
• Zap out (Stacks → Ethereum)
• Real-time notifications

Getting Started

Prerequisites

• Node.js 18+
• MetaMask (Ethereum)
• Leather wallet (Stacks)

Installation

git clone https://github.com/faithorji/faithbridge.git
cd faithbridge
npm install

Run Tests

cd contracts
npm test

Start Development

cd frontend
npm install
npm run dev

Bridge Flow

Ethereum (USDC) → xReserve → Stacks (USDCx) → Strategy
     ↓                                          ↓
   Approve         Bridge         Mint      Deposit

Zap In (Ethereum → Stacks)

1. Select strategy and amount
2. Approve USDC spending
3. Bridge via xReserve
4. Finalize deposit on Stacks
5. Start earning yield

Zap Out (Stacks → Ethereum)

1. Select position to withdraw
2. Burn receipt tokens
3. Bridge USDCx back
4. Receive USDC on Ethereum

Contract Addresses

Ethereum Mainnet

• USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• xReserve: 0x008888878f94C0d87defdf0B07f46B93C1934442

Stacks Mainnet

• USDCx: SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS.usdcx-token

Tech Stack

• Smart Contracts: Clarity + Clarinet
• Frontend: React 19, TypeScript, Tailwind CSS
• State: Zustand + TanStack Query
• Ethereum: viem + wagmi + RainbowKit
• Stacks: @stacks/connect + @stacks/js

Security

• Comprehensive test coverage (21+ tests)
• Post-condition verification
• Time-locked critical functions
• Multi-sig treasury controls

Roadmap

• Additional protocol integrations
• Mobile app
• Governance token launch
• Cross-chain expansion

License

MIT

---

Bridging capital across chains, one yield at a time