Skip to content

docs(readme): reflect live deploy, on-chain perp, and shipped pipeline - #125

Merged
obchain merged 4 commits into
mainfrom
docs/readme-live-status
Jun 22, 2026
Merged

obchain merged 4 commits into
mainfrom
docs/readme-live-status

Conversation

@obchain

@obchain obchain commented Jun 22, 2026

Copy link
Copy Markdown
Owner

What

Refresh README.md so it matches the project's current live state. The README still read like an M1-in-progress, read-only research project with no on-chain components — which directly contradicts the on-chain perp section further down and the live deployment.

Changes

  • Project status table — M1 marked done (full pipeline + e2e smoke), M2 in progress (multi-venue, on-chain perp, always-on deploy + CI/CD shipped; API keys / status page pending). "What works today" and "What's next" rewritten to match.
  • Roadmap — checkmarks updated through M1; M2 progress reflected.
  • API section — (planned) -> live; real base URL volx-api.ancilar.com; example request + JSON payload now match the actual response shape (index, source_strip_hash, next_update_eta_seconds). WS URL updated. Fixed the stale #api-planned anchor in the header nav + contents.
  • Security section — removed the false "no on-chain components, no wallet code, no user funds custody" claim. Documents the testnet contract surface (VolXOracle / VolXPerpV2 / MockUSDC, not audited, testnet only), the keeper-key handling, and the Cloudflare Tunnel exposure model.
  • Tech stack deploy row + "exchange-neutral" bullet — match the shipped self-hosted + Netlify + Docker Hub + multi-venue setup.

Verification

  • All live links return 200 (app / trade / pool / dashboard).
  • Referenced docs (METHODOLOGY, CHANGELOG, LICENSE, onchain-demo) exist.
  • grep confirms no stale api.volx.dev / api-planned / "no on-chain components" / "Oracle Cloud" strings remain.
  • Docs-only change; no code touched.

obchain added 4 commits June 22, 2026 13:19
The README still described VolX as an M1-in-progress, read-only research
project with no on-chain components. That no longer matches reality: the
full pipeline, public API, on-chain Sepolia perp, and CI/CD deploy are
all live.

- Project status: M1 done, M2 in progress (multi-venue + perp + deploy
  shipped); roadmap checkmarks updated to match.
- API section: 'planned' -> live, real base URL (volx-api.ancilar.com),
  example payload matches the actual response shape.
- Security: drop the false 'no on-chain components / no wallet code'
  claim; document the testnet contract + keeper-key surface and the
  Cloudflare Tunnel exposure model.
- Tech stack deploy row + 'exchange-neutral' bullet: match the shipped
  self-hosted + Netlify + Docker Hub setup and live multi-venue blend.
- Fix the stale #api-planned anchor in the header nav and contents.
The WS example carried the old planned shape. Match the actual ClientTick
emitted by api/internal/stream/hub.go: no 'data' wrapper, 'channel' (not
'index_id'), 'type':'tick', and 'ts' as Unix epoch milliseconds. Subscribe
channels are lower-case index ids.
The Phase 2 milestone (OKX + Bybit connectors, per-venue strip + median
blend, outlier drop, confidence score, per-service Dockerfiles) is fully
shipped and the milestone is closed, as is the on-chain perp milestone.
The previous status table conflated M2 with later, unscoped hardening
work (API keys, status page, backups) and so read 'in progress'.

- Status table: M2 + on-chain perp + deploy/CI-CD marked Complete; M3 in
  progress (methodology + dashboard live, aggregator listings pending).
- Roadmap: M2 checked off; unbuilt hardening moved to a 'Future' line.
- Moved API keys / rate-limit tiers / status page / backups out of M2 and
  into clearly-future work across the API, security, and perf sections.
…tor listings

Public launch is shipped: methodology page, public dashboard, and the live
backend + frontend deploy are all up. External aggregator/directory
submissions and product analytics were never project goals, so they are
removed from the roadmap rather than tracked as pending.

- Status table + roadmap: M3 -> Complete.
- Remove 'aggregator submissions' from What's next.
- Retag stale 'Oracle Cloud (M3)' repo-layout comments to the actual
  self-hosted + Cloudflare deploy.
@obchain
obchain merged commit 9e9f07d into main Jun 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant