Sorochain

A full-stack Soroban Token Minting platform — wrap Stellar assets, deploy custom contracts, and track everything in a live dashboard.

---

Project Structure

Sorochain/
├── client/          # React + Vite + Tailwind CSS frontend
├── server/          # Node.js / Express backend (Stellar SDK + Mongoose)
├── docker-compose.yml
└── SECURITY.md

---

Quick Start

1. Prerequisites

• Node.js v18+
• Docker & Docker Compose
• Freighter Wallet browser extension

2. Infrastructure

docker-compose up -d

3. Backend

cd server
npm install
cp .env.example .env
# Edit .env with your credentials
npm run dev

4. Frontend

cd client
npm install
npm run dev

---

Environment Variables

All variables live in server/.env.

Variable	Description
SOROBAN_RPC_URL	RPC endpoint (Futurenet / Testnet)
NETWORK_PASSPHRASE	Network passphrase
MONGO_URI	MongoDB connection string
CORS_ALLOWED_ORIGINS	Comma-separated frontend origins
BRIDGE_RELAYER_ENABLED	true / false
BRIDGE_RELAYER_DIRECTION	both / soroban-to-evm / evm-to-soroban
BRIDGE_SOROBAN_ACCOUNT_ID	Soroban account or bridge contract address
BRIDGE_EVM_RPC_URL	EVM JSON-RPC endpoint
BRIDGE_EVM_BRIDGE_ADDRESS	EVM bridge contract address
BRIDGE_RELAY_ENDPOINT_URL	HTTP endpoint for relay commands

---

Features

• Connect Wallet — Freighter wallet integration
• Mint Tokens — Wrap Stellar Assets or deploy custom Soroban contracts
• Asset Dashboard — Track deployed tokens stored in MongoDB
• Bridge Relayer — Cross-chain relay between Soroban and EVM chains

---

Security

See SECURITY.md for vulnerability reporting and our audit fast-track process.