byte_query_fact
Query a registered fact-oracle publisher for a signed answer with citation URLs, providing on-chain provenance and tamper-evidence.
Instructions
Query a PayPerByte fact-oracle publisher for a signed answer with citations. Posts the question to a registered fact-oracle publisher (topic='fact-oracle'), waits for the on-chain BroadcastStreamed response, and returns the answer plus structured citation URLs. The signed receipt proves which publisher produced the answer (provenance + tamper-evidence), NOT that the answer is correct — ground your output in the cited sources, not in a truth guarantee. Availability: this requires a registered fact-oracle publisher actively broadcasting; if none is live the call returns a timeout rather than an answer.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| question | Yes | The factual question to ask (e.g. 'What was last night's Lakers vs Warriors score?'). Should be specific and verifiable. | |
| topic_filter | No | Optional topic filter (e.g. 'fact-oracle' default; future: 'sports', 'finance'). | |
| max_byte_cost | No | Max response payload bytes you're willing to pay for (defaults to 2000, ≈$1 at $0.0005/byte). Publisher refuses if can't fit answer. | |
| min_publisher_pqs | No | Minimum PQS to consider (BPS scale, 0-10000). 9000 = Elite-only, 7500 = Premium+. | |
| subscriber_address | Yes | Your wallet address. You MUST be subscribed to the chosen publisher (with sufficient USDC escrow) or the publisher's on-chain broadcast will be skipped. | |
| max_response_latency_ms | No | Max time to wait for the publisher's broadcast (default 30000 ms). Local-LLM publishers (Ollama + Searxng + 3-sample NLI gate) take ~30-60s; Anthropic + passthrough takes ~10-20s. Hard ceiling 180s. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Error message if the query failed (no eligible publisher, broadcast timeout, etc.) | |
| answer | No | Publisher's grounded answer to the question | |
| citations | No | URLs/sources cited by the publisher in support of the answer | |
| confidence | No | Publisher-reported confidence (0-1) | |
| elapsed_ms | No | End-to-end time to obtain the answer (ms) | |
| request_id | No | Request id binding the query to this answer | |
| payload_hash | No | keccak256 of the response payload | |
| publisher_pqs | No | Publisher quality score (PQS) at fulfillment | |
| publisher_address | No | Publisher address that fulfilled the query | |
| response_size_bytes | No | Size of the response payload (bytes) | |
| publisher_tx_or_status | No | Delivery status or settlement reference |