Templars Exchange (TaEX) — perpetual exchange built on Arc

Hybrid BTC perpetual exchange prototype: deterministic Rust CLOB and risk gate, EIP-712 signed fills, immutable Solidity custody/settlement, PostgreSQL projection, controlled relay/oracle, and a React trading terminal. This repository is testnet-only and must not be used with real funds.

Verify

pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace --all-targets
& .\.tools\foundry\forge.exe test --root contracts
pnpm arc:check

Run locally

Copy .env.example to an untracked .env, populate deployed Arc Testnet addresses, and provide a random 32+ character risk API token. Start PostgreSQL with infra/compose.yml, then run the matcher, relay/indexer, and web scripts. The web UI labels fallback market content as demo data whenever the matcher has no sequenced book.

When Docker is unavailable on Windows, use powershell -File scripts/start-postgres-fallback.ps1. For an active controlled testnet market, run powershell -File scripts/run-testnet-oracle.ps1 -PriceUsd 60000 in a dedicated process. It uses the ignored encrypted deployer keystore and refuses non-Arc chain IDs.

Architecture decisions are in docs/adr, operational procedures in docs/operations.md, API/stream schemas in docs/api.md, security analysis in docs/threat-model.md, and the source register in docs/sources.md.

The complete stack and the Arc Reth/proposer boundary are documented in docs/architecture-stack.md.

Testnet deployment

The verified deployment is recorded in deployments/arc-testnet/manifest.json. All admin/market/risk/keeper/pauser/oracle roles are held by 0x72CA27CC843373671DaA8F4876C36aa84ee74A3E; the separate settlement relay is 0xA3d8E3b543a79D326f492d610Ab35241f3533F9B. The address ending in …637 is not used by the final deployment.

Import a deployer only into an encrypted keystore, fund it exclusively with Arc Testnet assets, set role addresses, and run scripts/deploy-arc-testnet.ps1. The script refuses any RPC whose chain ID is not 5042002 and applies Arc-tested gas settings.