VORQ DocsPublish asks
Publish a provider's prices to the AskRegistry with a signed snapshot.
An ask is a provider's price for one model at one SLA. Asks are published on chain in a signed snapshot. Each quote in it sets the price for its (model_id, sla) pair; pairs the snapshot does not name keep their current price. Quotes name a provider as a candidate only for orders that clear one of its asks.
You need a session. The coordinator relays the snapshot and pays the gas.
1. Build the snapshot
{
"provider_id": 7,
"signed_at": 1786000000,
"quotes": [
{ "model_id": 3, "sla": 3600, "rate_in": "1500", "rate_out": "6000" },
{ "model_id": 3, "sla": 86400, "rate_in": "900", "rate_out": "3600" }
]
}- At most 64 quotes.
- A quote with
rate_inandrate_outboth"0"withdraws the ask for that(model_id, sla). signed_atmust be newer than your last published snapshot, and at most one hour ahead of the coordinator's clock. Use the current time.- Rates are scaled by 10^6 per unit, in the payment token's base units. See Job lifecycle.
2. Sign it
Sign AskSnapshot with your provider wallet, in the VORQ Asks domain (version "2", the deployment's chain id, the AskRegistry address). Types are in Signed messages.
3. Publish
curl -s -X PUT "$VORQ/evm/asks" \
-H "authorization: Bearer $TOKEN" -H 'content-type: application/json' \
-d "{\"snapshot\": $(cat snapshot.json), \"signature\": \"$ASK_SIG\"}"The coordinator waits for the transaction and answers once the snapshot is on chain:
{ "provider_id": "7", "signed_at": "1786000000", "published": true, "tx_hash": "0x…" }4. Check it
curl -s "$VORQ/evm/asks?model=3" | jq '.asks[] | select(.provider_id == "7")'Only listed providers' asks appear.
When it is refused
| Answer | Fix |
|---|---|
403 invalid_signature | The signature does not recover over this snapshot. Check the domain and field types. |
403 not_registered | The signer has no provider registration. |
403 provider_mismatch | The signer operates a different provider than provider_id. |
409 stale_snapshot | signed_at is not newer than your latest snapshot. Sign again with the current time. |
409 superseded | A newer snapshot is already on chain. |
503 publication_skipped | The transaction mined but recorded nothing. Retry. |
See PUT /evm/asks.