DarkCircle Suite Docs
Documentation

DarkCircle Suite · Documentation & Guides

Private payments, AMM liquidity, multi-sig custody, a real estate brokerage, grand guild halls and a talent escrow rail on Quai Network (Cyprus-1, chain id 9), behind one real-time 3D portal. These pages are the operator and user manual for the whole suite.

Pre-release

Treat everything here as pre-release. Several apps run as labelled showcases or against simulations, and no contract in the suite has had an independent security audit. Do not point any of it at funds you cannot afford to lose. Details per app: Security & limitations.

Start here

🚀

Getting started

Prerequisites, building every app, assembling the unified site, deploying, and the quality gates CI enforces.

🌐

The portal

The WebGL front door: controls, carousel, sound, routing, privacy and graceful degradation.

🔒

Security & limitations

What is audited and what is not, what is simulated, and every known limitation in one place.

The six apps

🛡️

DarkCircle

x402 payment privacy: WQUAI/WQI shielded pools, PPOI compliance, ephemeral payees, a voice agent.

⚡

Circleswap

Quai DeFi dashboard: pool analytics, swap math, LP, and a chain-driven Farms & Pools page.

🔐

DarkSafe

Multi-sig vaults: on-chain proposals, native timelock, quorum checks, extension-only signing.

🏠

Dark Questate

Real estate brokerage: EIP-6065 deeds, broker listings, escrowed offers, one-transaction closings.

⚔️

DarkOrder

Grand Guild Halls: found a guild in one transaction, govern by QNS name, pay x402 tribute, voice seneschal.

🛤️

Dark Star Rail

Talent agency rail: milestone escrow, protocol fees, gasless x402 settlement, live on Orchard and mainnet.

Suite at a glance

AppRouteSource folderStatus
DarkCircle/x402tumbler/ (alias /darkcircle/)x402tumbler/Simulation pools in-memory; voice agent is real-chain
Circleswap/q0/ (alias /circleswap/)q0/Live reads Cyprus-1 data; your wallet signs
DarkSafe/multisigows/ (alias /darksafe/)multisigows/Beta v2 contracts unaudited; factory-gated
Dark Questate/darkquestate/b6/Showcase contracts not deployed; samples labelled
DarkOrder/darkorder/d0/Showcase contracts not deployed; samples labelled
Dark Star Rail/bai/ (alias /darkstarrail/)bai/Live escrow deployed on Orchard + mainnet; no external audit yet

Where everything lives

.
+-- index.html                  3D portal + subdomain router (single file, ASCII-only)
+-- 404.html                    base-path-aware redirect for deep links and subdomains
+-- docs/                       this documentation (static HTML, no build step)
+-- assets/3d/                  qrb_chamber.glb + vendored three.js r160
+-- tools/                      scene builder, asset verifier, site assembler, router tests
+-- playlist/                   background music for the portal
+-- x402tumbler/                DarkCircle
+-- q0/                         Circleswap
+-- multisigows/                DarkSafe
+-- b6/                         Dark Questate  (ships as darkquestate/)
+-- d0/                         DarkOrder      (ships as darkorder/)
+-- bai/                        Dark Star Rail (talent escrow, x402 rail)