Test agents and payees
Five reserved service-node addresses behave in a fixed way, so you can exercise every outcome of a paid call without a real payee. They run on Control Mode budgets only (funding: "none"). Opening a stream to one on a money-mode budget through POST /owner/v1/budgets/{id}/streams or a top-up is refused before anything is allocated (test_fixture_money_mode); other ways of opening a stream, such as a human payment, do not make this check, so use these addresses on Control Mode budgets only.
| Fixture | Service node | What happens |
|---|---|---|
approve | 0x7E57000000000000000000000000000000000001 | the work is metered, signed and settled |
refuse | 0x7E57000000000000000000000000000000000002 | the work is refused; nothing is billed |
slow | 0x7E57000000000000000000000000000000000003 | delivered after a delay (delayMs, default 2000, at most 10000), then settled |
dispute | 0x7E57000000000000000000000000000000000004 | metered and settled; the answer points at the evidence export |
settlement_fail | 0x7E57000000000000000000000000000000000005 | metered and signed, settlement fails; the signed voucher stays settleable |
GET /owner/v1/test-fixtures lists them. Every address with the 0x7E57000000000000000000000000000000000 prefix is reserved, used or not, and is refused on money modes on the same two routes.
Status: Live (Control Mode).
Run one delivery
Open a stream to a fixture on a Control Mode budget, then:
cd ~
pwd
curl -s -X POST "$DYNAMO_BASE_URL/owner/v1/test-fixtures/streams/$STREAM_ID/run" \
-H "Authorization: Bearer $DYNAMO_API_KEY" -H 'content-type: application/json' \
-d '{"units":"1000","requestRef":"try-1"}'
The answer names the outcome (approved, approved_slow, disputed, settlement_failed), the billed units, the voucherSeq, billedAmount, whether it settled, and the unsettledAmount. Every outcome goes through the engine's real meter: a retry with the same requestRef bills once.
Error codes
test_fixture_money_mode
Test service nodes run only on Control Mode budgets. Use funding: "none".
test_fixture_not_fixture
The stream's service node is not one of the reserved addresses.
test_fixture_refused
The refuse fixture always refuses. Nothing was billed.
invalid_request
The body failed validation: units is a positive decimal string, requestRef (optional; one is minted when absent) up to 128 characters, delayMs 0 to 10000.
not_found
The stream id is unknown on this deployment.