list_questions
List question/version keys using stable lexicographic pagination.
Contract
Limit must be 1..1000. For the next page, supply the last returned key as after. Listing identifies registered keys; get_ledger validates their complete histories.
Fields
| Field | Type | Required |
|---|---|---|
after | Key or null | No |
limit | integer | Yes |
op | "list_questions" | Yes |
Setup
Start a fresh --memory process and send these requests, one per line, before the example. The same sequence also works with a new SQLite database.
{"version":1,"id":"setup-1","command":{"op":"create_question","question":{"id":"doc-launch","version":1,"proposition":"Release before timestamp 100","opens_at":0,"deadline":100,"resolve_after":110,"yes_rule":"Archive confirms release strictly before 100","no_rule":"Complete archive confirms no qualifying release","void_rule":"Archive permanently unavailable","resolution_sources":["official archive"]}}}
Request
Send this object on one line. It is expanded below for readability.
{
"version": 1,
"id": "example",
"command": {
"op": "list_questions",
"after": null,
"limit": 10
}
}
Response
This response is generated by executing the example against the current binary. Commit timestamps, when present, are shown as <runtime UTC seconds>; the actual protocol returns integer UTC seconds.
{
"version": 1,
"id": "example",
"result": {
"questions": [
{
"question_id": "doc-launch",
"version": 1
}
]
}
}
Verification
The documentation gate executes the setup and request, then checks the following result fields against independently specified expectations:
JSON pointer within result | Expected |
|---|---|
/questions/0/question_id | "doc-launch" |
/questions/0/version | 1 |
Float comparisons use a 1e-12 tolerance. Request schema validation and cross-record validation still apply. See errors and recovery for failure handling.