Skip to content

David1984TK/Bimex

Repository files navigation

Bimex

Zero-loss social impact crowdfunding on Stellar/Soroban

CI License: MIT Network: Testnet Contract Frontend Security For responsible disclosure, see our Security Policy.

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
API reference Indexer endpoints, rate limits, configuration
FAQ (español) Preguntas frecuentes
FAQ (English) Frequently asked questions
Security policy Bug bounty program and responsible disclosure
Threat model Assets, threat actors, and attack surface
Contract invariants Properties the smart contract must never violate
Bug bounty Tier 2 Platform decision and budget for the post-launch program

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)

Security

This repository has active Secret Scanning and Push Protection enabled to prevent accidental exposure of credentials and secrets (such as Stellar secret keys or Supabase service role tokens).

Please ensure you do not commit any secrets. Any push containing suspected secrets will be automatically blocked by GitHub.

About

Create a social impact crowdfunding platform where contributors capital is always recoverable, built on Stellar and Soroban. These returns fund the project, and upon completion, each contributor receives exactly their original investment back.

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors