Find the best rates on Stellar, in real time.
Stellar Intel is a rate aggregator for the Stellar ecosystem. It compares off-ramp withdrawal rates, on-ramp deposit fees, yield protocol APYs, and swap routes across anchors and DeFi protocols — and lets you execute directly from the same interface.
Built for users sending money home across Africa, Latin America, and Southeast Asia via Stellar anchors.
Live demo → stellar-intel.vercel.app
- Why this exists
- Tech stack
- Getting started
- Environment variables
- Documentation
- Contributing
- Contributors
- License
Moving a dollar from a wallet in San Francisco to a bank account in Lagos, Buenos Aires, or Manila is still a small act of faith. Rates drift between the quote and the signature, anchors fail silently, and the user finds out forty minutes later when nothing lands. Every serious stablecoin corridor has the same three unsolved problems: which anchor is actually cheapest right now, will it honour the quote, and is it up.
Stellar Intel is the execution layer for stablecoin value on Stellar. We treat an off-ramp as a signed intent — "withdraw $100 USDC to this NGN account, at or better than this rate, before this deadline" — and route it to the anchor that can satisfy it. Three primitives, one product:
- Intent router. Live SEP-38 quotes across every integrated anchor, ranked by net landed value (gross rate − fees − slippage − historical fill-rate penalty), not headline rate.
- Reputation oracle. Every quote, fill, failure, and settlement latency is written to an on-chain Soroban contract. Anchors earn a public, user-verifiable track record; consumers read it without our permission.
- Agent surface. An MCP server exposes the router and oracle to AI agents, so an agent can price, compare, and execute an off-ramp in five lines — the same primitives used by the web UI.
Non-custodial by construction: every leg is signed by the user, the anchor takes custody under SEP-24, Stellar enforces atomicity. We never touch funds.
The deeper thesis and the grant resubmission case live in docs/PROPOSAL.md; the request/quote/sign/settle flow and the Soroban oracle wiring live in docs/ARCHITECTURE.md.
| Layer | Technology |
|---|---|
| Framework | Next.js 16, React 19, TypeScript |
| Styling | Tailwind CSS v4 |
| Data fetching | SWR |
| Blockchain | @stellar/stellar-sdk v15 |
| Deployment | Vercel |
Prerequisites: Node.js 20+, npm
# Clone the repository
git clone https://github.com/Ezedike-Evan/stellar-intel.git
cd stellar-intel
# Install dependencies
npm install
# Copy the example environment file and fill in your values
cp .env.example .env.local
# Start the development server
npm run devThe app will be available at http://localhost:3000.
# Type-check the codebase
npm run typecheck
# Lint
npm run lint
# Production build
npm run buildCopy .env.example to .env.local and set the following variables. The server
validates these at boot in lib/config.ts and fails fast on a missing or
malformed required value.
| Variable | Required | Default | Description |
|---|---|---|---|
NEXT_PUBLIC_STELLAR_NETWORK |
Yes | mainnet |
Stellar network (mainnet or testnet). |
NEXT_PUBLIC_HORIZON_URL |
Yes | https://horizon.stellar.org |
Horizon server URL. |
NEXT_PUBLIC_USDC_ISSUER |
Yes | — | USDC issuer public key (G…, 56 chars). Validated; no default. |
NEXT_PUBLIC_STELLAR_EXPERT_URL |
No | https://api.stellar.expert/explorer/public |
Stellar Expert API base for transaction links. |
NEXT_PUBLIC_APP_NAME |
No | Stellar Intel |
Display name used in the UI. |
ADMIN_SECRET_KEY |
Yes* | — | *Required only to access /admin/disputes and admin API routes. |
NEXT_PUBLIC_USDC_ISSUER has no default — set it (Circle's canonical USDC issuer
for mainnet). To point at the Stellar testnet, set:
NEXT_PUBLIC_STELLAR_NETWORK=testnet
NEXT_PUBLIC_HORIZON_URL=https://horizon-testnet.stellar.orgThe full doc surface lives under docs/. Start with:
| Document | What it covers |
|---|---|
| docs/PROPOSAL.md | Grant thesis: execution-layer framing, intent primitive, reputation oracle moat. |
| docs/ARCHITECTURE.md | System diagram, intent router, Soroban oracle, MCP/agent surface, SEP-10/24/38 flow. |
| docs/ROADMAP.md | Milestone waves v1.0 → v5, with tickable per-wave scope. |
| docs/INTENT_API.md | Intent schema, signing rules, replay protection, curl + TS snippets. |
| docs/ANCHOR_REPUTATION.md | Scoring methodology, composite formula, dispute process. |
| docs/ORACLE_SPEC.md | Soroban contract interface, consumer examples, publisher whitelist policy. |
| docs/MCP.md | Tool list, claude mcp add instructions, example prompts, agent-safety notes. |
| docs/SECURITY.md | Non-custodial guarantee, key handling, disclosure email, supply-chain policy. |
| docs/FAQ.md | "Is this custodial?", "what if an anchor fails?", "how are we different?". |
Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.
All contributors are expected to follow the Code of Conduct.
Good places to start:
- Issues tagged
good-first-issue— scoped, unblocked, reviewer-ready. - Issues tagged
help-wanted— larger tickets actively looking for owners. - Anchor integrations — see docs/ANCHOR_ONBOARDING.md.
Every contributor merged during OSS week is credited by name in the grant resubmission document.
Thanks to everyone who has shipped code, docs, designs, or anchor integrations for Stellar Intel.
 Evan Ezedike Creator & maintainer 💻 📖 🏗️ 🚧 |
 Your name here Open a PR → |
Emoji key follows the all-contributors spec: 💻 code · 📖 docs · 🎨 design · 🏗️ infrastructure · 🚧 maintenance · 🔌 anchor integration.