Saltar al contenido principal

Transparency Oracle — /api/transparency/*

The Transparency Oracle is the framework's economy mirror — a real state contract on the entangled state (slug='transparency-oracle', purpose='oracle') that ticks every 4 Zeqonds and writes a snapshot row aggregating the entire network supply state. Consumed by the public dashboard at /transparency/, the SDK's ZeqWalletClient.transparencyNow(), and any wallet that wants live visibility on where the framework's money is.

Source: shared/api-core/src/routes/transparency.ts. Background: ZEQ economy.

Endpoints​

MethodPathAuthNotes
GET/api/transparency/nownoneLatest snapshot row (most recent Zeqond).
GET/api/transparency/history?n=100noneMost recent N snapshots (max 1287).
GET/api/transparency/breakdownnonePer-machine compute spend totals.
GET/api/transparency/revenuenoneTwo-channel revenue ledger (subscriptions + swap pot).

All endpoints are public, no auth required. Rate-limited at 600 req/min per IP.

Snapshot shape​

Every GET /api/transparency/now returns the latest row from network_snapshots:

{
  "ok":               true,
  "zeqond_number":    "2289003912",
  "captured_at":      "2026-05-10T13:08:32.412Z",
  "machines_active":  47,
  "total_minted":     "8104553127",
  "total_burned":     "8089112440",
  "in_circulation":   "15440687",
  "foundation_pot":   "294813",
  "drip_rate_zqt_per_zeqond": "47.00",
  "compute_count_24h":          18445,
  "compute_spend_total_24h":    "189230",
  "subscription_revenue_24h_usd": "1247.00",
  "swap_revenue_24h_usd":         "78.50"
}

Numbers come back as strings to preserve bigint precision.

Why a state contract, not a dashboard hack​

The oracle is not a periodic SQL aggregation hidden behind a dashboard. Each snapshot is a real chain row written by a contract transition (cost: 5 ZEQ against the foundation pot). That means:

  • Any wallet can subscribe to the oracle and re-render historic state.
  • Replay the last week of snapshots and you get an exact economy movie.
  • Forge a snapshot? You'd have to forge a contract transition — same hash-entangled state integrity as any other state machine event.
  • The dashboard at /transparency/ is just a thin reader; the oracle itself is the source of truth.

Use from the SDK​

import { ZeqWalletClient } from "@zeq-os/sdk";

const w = new ZeqWalletClient({ origin: "https://YOUR-FRAMEWORK" });
const now    = await w.transparencyNow();
const recent = await w.transparencyHistory(60);   // last 60 snapshots ≈ 4 minutes
const rev    = await w.revenue();                 // two-channel ledger

Cadence​

The oracle ticks every 4 Zeqonds (≈3.108 seconds) inside the tickTransparencyOracle daemon (mirrors the heartbeat-burn cadence). The dashboard polls at the same rate so visitors see numbers move in near-real-time.

  • ZEQ economy — what the oracle aggregates
  • Tally Protocol — per-balance endpoints
  • audits/2026-05-10-economy/_ECONOMICS.md — canonical economy reference