Skip to main content

Attested Data Response

The Attested Data Response (ADR) is the canonical gateway response format. It is designed so consumers can verify data without trusting the gateway.

Structure (v1)​

  • kind: olymp.attested_data_response.v1
  • network: { name, chainId, rpc? }
  • request: { requestId, endpoint, query, queryHash, timestamp }
  • data: { schemaId, schemaVersion, dataType, nonce, createdAt, window, payload, payloadPointer }
  • provider: { providerAddress, providerType, trustTier, signingMode, endpoint, adapter?, bond? }
  • onchain: { anchorId, anchor, score }
  • proofs: { providerSignature, adapterSignature?, payloadMerkle? }
  • gatewayReceipt: signed query receipt (see Query Receipt spec)

Normative rules​

  • Gateways MUST include provider.trustTier and provider.signingMode.
  • Gateways MUST include a valid on-chain anchor reference in onchain.anchor.
  • Gateways MUST include payloadPointer even when payload is embedded.
  • All hashes MUST be keccak256 and encoded as hex with 0x prefix.

Verification checklist​

  1. Verify payloadPointer.payloadHash against payload bytes.
  2. Verify provider or adapter EIP-712 signature.
  3. Confirm provider registry entry matches providerType and signingMode.
  4. Confirm on-chain anchor matches schemaId, dataTypeHash, window, payloadHash.
  5. Verify gateway receipt signature.
  6. Enforce trust policy (Tier A only, min score, etc).

Trust tiers​

  • Tier A: Provider-signed (higher trust).
  • Tier B: Adapter-attributed (bootstrap, reduced trust).

Disclaimers​

Verification outcomes are variable and depend on on-chain state and payload integrity. No guarantees. Not investment advice.