Swyft

Concentrated liquidity DEX on Stellar.

Swyft is a decentralized exchange built on Stellar using Soroban smart contracts. Inspired by Uniswap v3, it brings concentrated liquidity to the Stellar ecosystem — enabling capital-efficient trading, lower fees, and MEV protection. There is no v3-style DEX on Stellar yet. Swyft is the first.

---

Why Swyft?

	Swyft	Traditional Stellar DEXes
Liquidity model	Concentrated (v3-style)	Full-range only
Capital efficiency	High — LPs set custom price ranges	Low
MEV protection	Yes	No
Developer SDK	TypeScript (@swyft/sdk)	None
Open source	MIT	Varies

---

Tech Stack

Layer	Technology
Smart contracts	Rust / Soroban
Backend API	NestJS — REST + WebSocket
Database	PostgreSQL + Redis (Prisma, BullMQ)
Frontend	Next.js 14, Tailwind CSS, Radix UI
SDK	TypeScript (@swyft/sdk)
Wallets	Freighter / xBull
Monorepo	Turborepo + pnpm workspaces
CI/CD	GitHub Actions
License	MIT

---

Repo Structure

swyft/
├── apps/
│   ├── web/              # Next.js dApp
│   └── api/              # NestJS backend
├── packages/
│   ├── contract/         # Soroban Rust contracts
│   ├── sdk/              # @swyft/sdk (TypeScript)
│   ├── ui/               # @swyft/ui shared components
│   └── config/           # Shared ESLint, TS, Tailwind configs
├── docs/                 # Protocol spec, contributor guides
└── .github/              # CI workflows, issue templates

---

Getting Started

Prerequisites

• Node.js 18+
• pnpm 8+
• Rust + stellar-cli (install guide)
• Docker (for local Postgres + Redis)

Local dev

# Clone the repo
git clone https://github.com/Valreb001/Swyft.git
cd swyft

# Install all dependencies
pnpm install

# Copy env files
cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env

# Start everything
pnpm dev

This starts the Next.js dApp, NestJS API, and watches contract changes simultaneously via Turborepo.

Run contract tests

cd packages/contract
cargo test --workspace

Run API tests

pnpm --filter api test

---

Environment Variables

Copy apps/api/.env.example to apps/api/.env and fill in the values below.

Variable	Required	Default	Description
DATABASE_URL	✅	postgresql://postgres:postgres@localhost:5432/swyft	PostgreSQL connection string (Prisma)
REDIS_URL	✅	redis://localhost:6379	Redis connection string (BullMQ + cache)
STELLAR_NETWORK	✅	testnet	testnet or mainnet
STELLAR_RPC_URL	✅	https://soroban-testnet.stellar.org	Soroban RPC endpoint
HORIZON_URL	✅	https://horizon-testnet.stellar.org	Stellar Horizon endpoint
POOL_CONTRACT_ID	✅	(empty)	Deployed pool contract address — see packages/contract/deployments/testnet.json
JWT_SECRET	✅	change-me-in-production	Secret used to sign JWT tokens — must be changed in production
JWT_EXPIRES_IN	✅	7d	JWT token lifetime
PORT	✅	3001	HTTP port the API listens on
INTERNAL_API_KEY	✅	change-me-in-production	Protects /admin/* and /metrics/db routes — must be changed in production
DB_SLOW_QUERY_THRESHOLD_MS	❌	100	Queries slower than this (ms) are logged as warnings
SENTRY_DSN	❌	(empty)	Sentry DSN for error tracking — leave blank to disable
SENTRY_TRACES_SAMPLE_RATE	❌	0.1	Sentry trace sampling rate (0–1)
COMPRESSION_LEVEL	❌	6	zlib compression level for HTTP responses (1–9)
WEBHOOK_LARGE_SWAP_USD	❌	10000	USD threshold above which a swap triggers a webhook notification

---

Architecture

Browser (Freighter / xBull wallet)
          │
    Next.js dApp
          │
      @swyft/sdk
       ╱        ╲
NestJS API    Soroban RPC
(REST + WS)       │
   │          Soroban contracts
PostgreSQL         │
  + Redis     Stellar network

The NestJS backend indexes Soroban events from Stellar Horizon, caches pool state in Redis, and exposes a REST API and WebSocket gateway for real-time price feeds. The frontend communicates with both the API and Soroban RPC directly via the SDK.

---

Roadmap

Phase	Timeline	Focus	Status
Phase 0 — Foundation	M1–2	Monorepo, CI, contributor onboarding	🟡 In progress
Phase 1 — Core contracts	M2–5	Soroban CL pool, router, position NFT	⚪ Planned
Phase 2 — Backend & SDK	M4–7	NestJS API, indexer, @swyft/sdk	⚪ Planned
Phase 3 — Frontend	M6–9	Swap UI, LP management, pool browser	⚪ Planned
Phase 4 — Mainnet	M9–12	Audit, mainnet deploy, liquidity bootstrap	⚪ Planned
Phase 5 — Growth	M12+	Governance, fee tiers, integrations	⚪ Future

Full roadmap: docs/ROADMAP.md

---

Contributing

Swyft is built almost entirely by external contributors. The maintainer handles architecture decisions, PR reviews, and releases. Contributors handle features.

Pick up an issue and open a PR — that's it.

Good first issues

Look for issues labelled good first issue. These are small, well-scoped tasks that don't require deep protocol knowledge.

Issue labels

Label	Meaning
good first issue	No deep protocol knowledge needed
bounty	Financial reward attached
contracts	Soroban / Rust work
backend	NestJS / API work
frontend	Next.js / React work
sdk	TypeScript SDK work
docs	Documentation

PR conventions

• Branch from main, name your branch feat/..., fix/..., or docs/...
• Follow conventional commits: feat:, fix:, docs:, chore:
• All PRs must pass CI (lint + tests + build)
• One maintainer approval required to merge
• Squash merge only

Full guide: CONTRIBUTING.md

---

Security

Please do not open public GitHub issues for security vulnerabilities. See SECURITY.md for the responsible disclosure process.

---

License

MIT — free to use, fork, and build on commercially.

---

Community

• GitHub Issues — bug reports, feature requests
• GitHub Discussions — RFCs, architecture proposals, Q&A
• GitHub Projects — live task board

---

Swyft is in active development. Contracts are unaudited. Do not use on mainnet until a security audit has been completed.