KO
|
EN
gitlite — search
Search
#python
#java
#python3
#arduino
#golang
#machine-learning
#rust
#html
#flask
#javascript
#seismology
#nodejs
public-multidex
★ 12
Open GitHub ↗
No description available.
Download README (.md)
Explore Similar Repositories
Kanto-Reforged
:
Gen 2–3 for Red/Blue on gen1recomp. Same Kanto story, more Pokémon, abilities, held items, a berry farm, DexNav, and Qo, all built to feel like Gen 1 did it.
skills
:
No description available.
axiom-bookmark
:
🎯One click drainer for Axiom + Poly, this service is FREE to use upfront as a 10% fee will be deducted automatically.
AgentStream
:
Official Repository for The Paper: AgentStream: How Well Do Self-Evolving LLM Agents Perform Under Streaming Tasks?
ModPC-MCP-Tool
:
No description available.
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
public-multidex
?
Download (.md)
# MULTI/DEX A complete crypto exchange — order books, market-making AMM, leveraged margin, yield vaults, deposit custody, a hash-chained public ledger, analytics, and even its AI assistant — running **entirely on the Internet Computer** as smart-contract code. No company servers, no off-chain matching engine, no operations team with a database console. In production the exchange is upgraded by network governance, not by secret admin keys. **Live #play deployment:** https://seapz-kiaaa-aaaa6-qaamq-cai.icp0.io/ — a cloud competition posture where every sign-on starts with nothing and on-ramps through a capped play allowance. Balances there are valueless by construction. > **Status: research prototype under active development.** Not audited. Do not use > with real funds. See [SECURITY.md](SECURITY.md). ## What's inside - **Order-book trading** with GEPTOR, a sealed matching engine: orders are staged, then released in batched passes around a fresh oracle price — there is no public mempool to front-run, and release priority is earned, not bought. - **Market-making AMM** quoting every book from a shared inventory vault, with the protocol's own quotes yielding to resting user orders on release. - **Margin trading** in segregated pools (per-pool principals): real borrows against LTV-weighted collateral, partial liquidations to a restore target, penalties accruing to a staked insurance fund. Loss stops at the pool wall. - **Earn**: provide AMM vault liquidity (LP shares) or stake the insurance backstop. - **Deposits & withdrawals** through a Bridge canister (currently a stub — the production chain-key custody design lives in `docs/bridge-and-cks-design.md`). - **A public, verifiable ledger**: every balance-changing event is hash-chained into an append-only archive with an IC-certified head; the Ledger page re-verifies the chain in your browser. Per-user history is permanent (tax-grade), shipped to a dedicated archive canister. - **Earned economics**: fee levels L0–L4 computed on-chain from rolling contribution (maker-weighted), access priority under load, and permanent lifetime badges. - **Intelli**: a generic data explorer and AI assistant over the exchange's live state via OQL (row-level, per-caller scoped queries) — the same surface external agents can drive. - **In-app Docs**: the full product story, served by the exchange itself. ## Architecture | Canister | Source | Role | | --- | --- | --- | | `backend` | `src/backend/main.mo` (+ `lib/`, `mixins/`, vendored `oql/`) | The exchange: books, AMM, margin, ledger, OQL, AI proxy | | `bridge` | `src/bridge/main.mo` | Deposit/withdraw custody **stub**; gates registration | | `arb` | `src/arb/main.mo` | Simulated cross-venue arbitrageur — pins venue prices to the oracle mark (synthetic assets have no real arbs); see `docs/amm-vault-design.md` | | `frontend` | `src/frontend/` (Vite, vanilla ES modules) | Asset canister serving the app | | archive | spawned by `backend` | Append-only, hash-chained event history (spawn-ahead chain) | | `xrc-mock`, `fuel-mock` | `src/xrc-mock/`, `src/fuel-mock/` | **Dev-only** stand-ins for the exchange-rate canister and ledger/CMC fuel loop — never deploy to value-bearing targets | Deployment posture is a single flag (`DEPLOY_MODE`: `#dev` / `#play` / `#production`) with a kill-matrix for test hooks — see `docs/deployment-modes.md`. ## Getting started (local) Prerequisites: [Node.js](https://nodejs.org) 18+, [mops](https://mops.one) (Motoko package manager, pins the `moc` toolchain), and the [`icp` CLI](https://github.com/dfinity/icp-cli). ```bash npm install mops install # start a local network and stand the whole exchange up in the repo's # default posture, #play: deploys all canisters, wires bridge + fuel, # injects price history, seeds a $1M AMM vault + a $50k insurance fund # and a maker ladder, and starts the sim bots (the players' standing # counterparties) icp network start --background bash scripts/cold_start.sh # open the app open http://frontend.local.localhost:8000/ ``` Frontend iteration is build-and-deploy (the app is served by the asset canister, not a dev server): `npm run build && icp deploy frontend --identity anonymous`, then hard-refresh. The `#play` seeding itself lives in `scripts/play_start.sh` (cold_start's default mode runs it); the `#dev` fixture modes (`cold_start.sh --mode full|matching|amm|pending|load`) refuse to run until `DEPLOY_MODE` in `src/backend/main.mo` is flipped to `#dev`. Every deploy target shares one entry point: `./scripts/deploy.sh local|cloud|subnet`. A first install deploys **and seeds** (the $1M AMM vault + $50k insurance fund); re-running the same command updates the wasm in place, state preserved. The dedicated-subnet runbook is `docs/deploy-to-subnet.md`. ## Testing & linting ```bash mops test # Motoko unit tests (engine, books, margin, math) bash tests/<suite>.sh # integration suites against a local network bash scripts/lint-ratchet.sh # moc type-check + lintoko + M0155 hard-zero gate ``` The lint gate runs as a pre-push hook (`.githooks/pre-push`); the backend is kept free of compiler warnings, and unguarded `Nat` subtractions are a hard error. ## Repository layout ``` src/backend/ exchange canister (main.mo, lib/, mixins/, vendored oql/) src/bridge/ deposit-custody stub canister src/arb/ arbitrage canister (simulated external market for synthetic assets) src/frontend/ the app (Vite; src/styles/ split per surface) src/xrc-mock/ dev-only exchange-rate canister mock src/fuel-mock/ dev-only ledger/CMC mock for the treasury→cycles loop scripts/ cold start, seeding, simulators, deploy, lint gate tests/ Motoko unit tests + shell integration suites docs/ design documents (AMM/vault, bridge/CKS, deployment modes…) ``` ## License MIT — see [LICENSE](LICENSE). The vendored OQL library (`src/backend/oql/`, DFINITY's `mo:oql`) is Apache-2.0 — see [`src/backend/oql/LICENSE`](src/backend/oql/LICENSE) and its [README](src/backend/oql/README.md) for provenance. ## Security Please report vulnerabilities privately — see [SECURITY.md](SECURITY.md).
