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.

FixtureService nodeWhat happens
approve0x7E57000000000000000000000000000000000001the work is metered, signed and settled
refuse0x7E57000000000000000000000000000000000002the work is refused; nothing is billed
slow0x7E57000000000000000000000000000000000003delivered after a delay (delayMs, default 2000, at most 10000), then settled
dispute0x7E57000000000000000000000000000000000004metered and settled; the answer points at the evidence export
settlement_fail0x7E57000000000000000000000000000000000005metered 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.