Skip to content
@stellar-vortex-protocol

stellar-vortex-protocol

Vortex Protocol

Intent-based cross-chain swaps with Stellar as the settlement layer.

Users express a swap intent — "I want to receive USDC on Stellar, and I'm willing to send 0.14 WETH from Base" — and a competing solver network races to fill it. No bridges. No wrapped tokens. Settlement is guaranteed by on-chain solver bonds.

Project status: ~30% complete. Core settlement contract, intent relay API, and swap/solver UI are functional against mock data and Stellar testnet primitives. The solver registry contract, on-chain proof verification, and live wallet/contract wiring are in progress. See the per-repo roadmaps and open issues for contribution opportunities.


Repositories

Repo Stack Description
vortex-contract Rust / Soroban On-chain intent settlement: intent lifecycle, solver bonds, slashing
vortex-backend TypeScript / Express Intent relay API + WebSocket intent feed
vortex-frontend TypeScript / Next.js 14 Swap UI + solver portal
.github Org-wide community health files (this repo)

Each repository is independently buildable and deployable. Setup instructions live in each repo's README.


The Problem

Getting tokens onto Stellar from Ethereum / Base / Polygon today requires:

  1. Finding a bridge that supports your source token
  2. Waiting for bridge finality (often 15–30 min)
  3. Dealing with wrapped assets that carry bridge-specific trust assumptions
  4. Paying multiple fees across multiple protocols

Vortex replaces this with a single UX primitive: the swap intent.


How It Works

User                    Vortex                   Solver                   Stellar
 │                         │                        │                        │
 │─── submit_intent() ────►│                        │                        │
 │    (src: 0.14 WETH      │                        │                        │
 │     dst: min 480 USDC)  │◄── quote / accept ────►│                        │
 │                         │                        │                        │
 │                         │                        │── fill_intent() ──────►│
 │                         │                        │   (sends 485 USDC      │
 │◄── 485 USDC received ───│◄───────────────────────│    to user on Stellar) │
 │                         │                        │                        │

Intent lifecycle:

State Description
open Awaiting a solver
accepted Solver has 5 minutes to fill
filled User received output on Stellar
cancelled User cancelled before a solver accepted
expired No solver filled before the deadline
slashed Solver accepted but didn't fill — 10% of bond slashed

Security Model

Vortex's security relies on two primitives:

  1. Solver bonds — solvers must lock USDC to participate. Failed fills slash 10% of their bond, making repeated failures unprofitable.
  2. Fill-window enforcement — once a solver accepts, the intent is locked for 5 minutes. If they fail to fill, the intent reverts to open and is re-auctioned, and the bond is slashed permissionlessly via slash_solver().

In production, on-chain proof verification (via cross-chain messaging or oracle attestation) will remove the remaining trust assumption on the solver's honest reporting.

To report a vulnerability, see SECURITY.md.


Contributing

Vortex is open source and contributions are welcome — this is part of why the project participates in the Drips ecosystem for sustainable open-source funding. Please read CONTRIBUTING.md and our Code of Conduct before opening a pull request.


License

MIT © 2026 Vortex Protocol Contributors

Popular repositories Loading

  1. vortex-contracts vortex-contracts Public

    ▎ Soroban smart contracts for Vortex Protocol — on-chain intent settlement, solver bonds, and slashing on Stellar.

    Rust 2 20

  2. vortex-frontend vortex-frontend Public

    Next.js 14 app providing the user-facing swap interface and the solver dashboard. Built with TypeScript and Tailwind CSS. Part of the multi-repo Vortex stack

    TypeScript 1 6

  3. vortex-backend vortex-backend Public

    service that brokers swap intents between users and the solver network and streams the live intent feed. Part of the multi-repo Vortex stack

    TypeScript 1 10

  4. .github .github Public

Repositories

Showing 4 of 4 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…