Skip to content

README.md

Latest commit

 

History

History
74 lines (56 loc) · 2.76 KB

README.md

File metadata and controls

74 lines (56 loc) · 2.76 KB
Raw

Bimex

Zero-loss social impact crowdfunding on Stellar/Soroban

License: MIT Network: Testnet Contract Frontend

Contributors lock MXNe stablecoin into the contract. The yield (~13.45% APY) funds the project. When the project completes, every contributor gets their exact principal back — zero loss.

How it works

Contributor locks MXNe
        │
        ├─ 50% → CETES (9.45% APY) ─┐
        ├─ 50% → AMM   (4.00% APY) ─┴─→ Yield goes to project owner
        │
        └─ Project completes → contributor withdraws 100% of principal

🚀 Pilot Project

We're launching our first real-world project on Mainnet! Check out the complete guide:

Status: Ready to launch | Timeline: 9 weeks | Budget: $15,000 MXN

Quick start

# Frontend
cd bimex-frontend
npm install
cp .env.example .env.local   # fill in contract IDs
npm run dev                  # http://localhost:5173

# Contract (only if modifying)
cd bimex
cargo test
stellar contract build

Documentation

Document Description
Technical docs Deployment, contract functions, lifecycle, changelog
Contributor guide How to back a project as a user
Project creator guide How to launch a project on Bimex
Technical integration guide ABI, CLI examples, JS SDK integration
Pilot project guide First real-world project on Mainnet
FAQ (español) Preguntas frecuentes
FAQ (English) Frequently asked questions

Contract addresses (Testnet)

Resource ID
Bimex contract CDFFTEQLNIG2RAUONFXSQX2YS2UTQTCBEUAPK6S42XFNIOQEYPBJVH5T
MXNe SAC token CDDIGHPVTW4PSCQCU67NQ4NXZ4NX5GDLNL3O67WT5RQ4GT6RXIEYPC4T
Soroban RPC https://soroban-testnet.stellar.org

Stack

  • Smart contract: Rust / Soroban SDK (WASM)
  • Frontend: React 19 + Vite + Stellar SDK v14
  • Wallet: Freighter
  • Deploy: Vercel (frontend) · Stellar Testnet (contract)