Skip to content

ezedike-evan/stellar-intel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Stellar Intel

License: MIT CI Coverage npm (@stellarintel/sdk) Deployed on Vercel Conventional Commits

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.

Stellar Intel off-ramp comparison — live anchor quotes, fee breakdown, and one-click execution
Live demo → stellar-intel.vercel.app


Table of contents


Why this exists

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:

  1. 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.
  2. 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.
  3. 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.


Tech stack

Layer Technology
Framework Next.js 16, React 19, TypeScript
Styling Tailwind CSS v4
Data fetching SWR
Blockchain @stellar/stellar-sdk v14
Deployment Vercel

Getting Started

Prerequisites: Node.js 20+, npm

# Clone the repository
git clone https://github.com/your-org/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 dev

The app will be available at http://localhost:3000.

# Type-check the codebase
npm run typecheck

# Lint
npm run lint

# Production build
npm run build

Environment Variables

Copy .env.example to .env.local and set the following variables:

Variable Required Default Description
NEXT_PUBLIC_STELLAR_NETWORK No mainnet Stellar network to connect to (mainnet or testnet)
NEXT_PUBLIC_HORIZON_URL No https://horizon.stellar.org Horizon server URL
NEXT_PUBLIC_STELLAR_EXPERT_URL No https://api.stellar.expert/explorer/public Stellar Expert API base URL used for transaction links

All three variables have safe production defaults and are optional for local development. To point at the Stellar testnet, set:

NEXT_PUBLIC_STELLAR_NETWORK=testnet
NEXT_PUBLIC_HORIZON_URL=https://horizon-testnet.stellar.org

Documentation

The 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?".

Contributing

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:

Every contributor merged during OSS week is credited by name in the grant resubmission document.


Contributors

Thanks to everyone who has shipped code, docs, designs, or anchor integrations for Stellar Intel.

Evan Ezedike
Evan Ezedike

Creator & maintainer
💻 📖 🏗️ 🚧
Your name here
Your name here

Open a PR →

Emoji key follows the all-contributors spec: 💻 code · 📖 docs · 🎨 design · 🏗️ infrastructure · 🚧 maintenance · 🔌 anchor integration.


License

MIT

About

Execution layer for stablecoin value on Stellar.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors