stellar-trade README

The project's README from github.com/Stellar-tradehub/stellar-trade. As one markdown file: README.md.

Stellar Trade

A Soroban prediction-market prototype for taking a position on a question and inspecting how it settles. Built on Stellar, the project combines XLM pools, wallet-signed transactions, and contract-enforced payout accounting.

Why Stellar Trade

A poll records what people think. A prediction market records a position against a defined outcome and settles it under published rules. Stellar Trade explores how to make that lifecycle understandable and inspectable: what question is being asked, how much value entered the pool, who can resolve the market, and how the final payout was calculated.

The project is aimed at communities and builders who want a transparent way to aggregate forecasts around ecosystem milestones, public data, or other questions with verifiable resolution criteria. The prototype uses Soroban contracts for the value-bearing rules and Stellar wallets for user authorization. Its goal is to make market mechanics reviewable in code and on the public ledger, while keeping the product honest about what is live and what is still a concept.

Market flow

flowchart LR
    Q[Clear question and close criteria] --> B[Buy YES or NO with XLM]
    B --> P[Pool and fees recorded by Soroban]
    B -->|optional, before close| S[Sell by reducing the position]
    P --> R[Authorized resolver submits outcome]
    R --> C[Winning positions claim proportional payout]
    Q --> X[Cancelled market follows refund rules]

The contract enforces pool accounting and settlement, while the wallet authorizes each transaction. Market questions, criteria, and resolver authority remain essential parts of the trust model.

How a market works

  1. Create a clear question. A market needs an outcome that can be checked against stated criteria and a close time. Resolution sources and criteria must be published before a market opens.
  2. Buy a position. A participant chooses YES or NO and stakes XLM. The contract records the position and accounts for the market's fee shares.
  3. Sell or reduce a position. Before close, a participant can reduce their existing stake. The reduce_position contract operation returns the amount computed by its accounting rules. This is not an order-book sale to another user and does not open a short position.
  4. Resolve and settle. An authorized resolver submits the outcome. Winning positions share the distributable pool proportionally; a cancelled market follows its refund path. Contract calls and resulting transactions can be inspected on Stellar.

Market resolution is currently permissioned. Public price and network feeds shown by the website provide context; they do not act as automated oracles or trigger settlement. Resolver accountability, objective criteria, and public evidence are open product and governance problems, not solved features.

What is implemented

The Rust workspace is maintained in the separate stellar-trade-contracts repository. Its contract README explains the workspace, and the invariant matrix documents safety properties for fee, payout, referral, reward, and storage changes.

Deployment status

These are existing pre-rebrand Testnet deployment addresses. The reward asset at its listed address retains its original identity; it is not STRD. Fresh deployments from the current contract source produce new addresses and initialize a new STRD asset.

Contract Testnet address Status
Prediction market CAPCAPWPGPOCENAJFYYIE22WYNFEDVZ3CT73M5MAKILFMBQ5TN2MIS6T Legacy deployment; configured market #3 is expired
Legacy reward asset CBYUQUXPGWUQRV7STCV3YPVLWNTFJHKLEAG7LVAOK7H4FIFJGZW5P476 Pre-rebrand asset; not STRD
Referral registry CCKVUVYXR6FBB4VFYGDF3IDDUVBRJGKPDDRABTZYKI2LKAJNVLF3TTQ2 Existing Testnet deployment
Leaderboard CCMNYMUI4XMDBTTMM7E6KNQFF3OVKS3Q2ERJ4EVQGCLW4VQCGUGG2AQM Existing Testnet deployment

Inspect the contracts and transactions on Stellar Expert Testnet. The browser app currently uses market #3, which was published to close on September 30, 2026. It does not yet load market terms or resolution status from Soroban. Do not treat the page's sample odds, rankings, or local demo positions as current ledger state.

Run the browser app

The app has no package manager, bundler, or build step. From the root of this repository, run:

python3 -m http.server 8080 --directory frontend

Open http://localhost:8080. To inspect wallet flows, use Freighter on Stellar Testnet and Testnet assets only; they have no mainnet value. Concept-market actions are local simulations and move no funds. The browser stores recent position activity in session storage.

Contracts and checks

Clone the contract repository separately. Install Rust 1.91.0 and the wasm32v1-none target, then run these commands from that repository's root:

cargo test --workspace --all-features
cargo fmt --all -- --check
cargo clippy --workspace --all-features -- -D warnings
cargo build --release --target wasm32v1-none -p prediction_market

The frontend CI uses Node.js 22 to validate HTML pages, local assets, and JavaScript syntax. The contract repository has its own CI workflow for checks, tests, WASM builds, and invariant tests. If you change payout math, fees, storage lifetimes, or reward flows, update the tests and invariant matrix with the implementation.

Roadmap and contributor opportunities

The next work should make the prototype more useful and easier to evaluate:

These are roadmap areas, not a claim that corresponding Wave issues are already open. Contributors should coordinate through GitHub issues and pull requests. Keep changes scoped, add regression tests for contract behavior, and include screenshots for interface changes.

Security, data, and license

Never commit .deploy.env, secret keys, recovery phrases, wallet identities, or generated deployment output. The app asks Freighter to sign transactions and does not handle secret keys. Testnet software and assets are experimental and have no mainnet value. This project is not audited or intended for production financial use. Stellar Trade source code is licensed under MIT; bundled third-party fonts retain their own licenses and notices.

stellar-trade (Stellar-tradehub/stellar-trade)

Searching Database…

130 ·GitHub
Stellar-trade
What is this?Stellar Trade is a prototype prediction market built on Stellar's Soroban smart contracts, where users buy or sell YES/NO positions on a question and the payout settles onchain through a pooled XLM accounting system.
Is this a smart contract, a web app, or both?Both: a Rust/Soroban contract workspace enforces the market, referral, leaderboard and reward-token logic, while a separate static HTML/CSS/JS browser app lets you connect a wallet and call those contracts.
How do I run the browser app?The app has no package manager, bundler, or build step — just open it directly from the repository root in a browser. The contracts live in a separate 'stellar-trade-contracts' repository that you clone and build independently.
What do I need to interact with it?You need the Freighter wallet configured for Stellar Testnet to sign transactions in the browser app; to build or test the contracts yourself you need Rust 1.91.0 with the wasm32v1-none target.
Can I actually buy or sell a position right now?No — the configured Testnet market (#3) has already expired, so although Buy and reduce-position calls are implemented in the client, neither can currently be executed, and the market/leaderboard pages show illustrative sample numbers rather than live contract data.
Is this using real money?No, everything runs on Stellar Testnet with Testnet assets that have no mainnet value; the project explicitly states it is experimental, unaudited, and not intended for production financial use.
Who decides how a market resolves?Resolution is currently permissioned: an authorized resolver submits the outcome, and winning positions share the pool proportionally while a cancelled market follows a refund path. Public price feeds shown on the site are just context, not automated oracles.
What is STRD?STRD is the project's own Soroban reward token, initialized by fresh contract deployments as 'Stellar Trade (STRD)'; it hasn't been deployed yet, and the existing Testnet reward-asset address still holds its original pre-rebrand identity, not STRD.
What's left to build before this could go live?The roadmap includes reading market terms and positions live from Soroban instead of hard-coded frontend data, redeploying a fresh Testnet suite, defining objective resolution/dispute policies, and getting an independent security review before any production use.
Can I sell my position to another trader?No — reducing a position only triggers the contract's own accounting formula to pay out part of your stake; it is not an order-book trade with another user and does not open a short position.
What are similar projects?clearledger-contracts, stellar-pathfinder, nuvex-services, rh-swap, robinhood-meme-token-stock-launchpad, pons-copy-trading-bot, metamask-desktop, clearledger
Which topics is it in?soroban, stellar, prototyping, dapp, defi, wallet, crypto, fintech, smart-contracts, trading, decentralized, cryptocurrency
Creator
Stellar-tradehub
Size
14.2 MB
Stars
130
Updated
CommitOct 13
Age
10d
Commits · 90 Days