curl --request PUT \
--url "https://directory.example.com/dids/did%3Aopenpayload%3A1111111111111111111111/delivery-constraints" \
--header "Content-Type: application/json" \
--data '{
"did": "did:openpayload:1111111111111111111111",
"action": "set_did_delivery_constraints",
"delivery_constraints": {
"requested_cache_seconds": 86400,
"max_http_envelope_bytes": 26214400,
"max_unchunked_message_bytes": 16777216,
"max_chunk_bytes": 2097152,
"max_replicas": 2
},
"nonce": "<policy-nonce>",
"valid_until": "<epoch-milliseconds>",
"signer_key_id": "did:openpayload:1111111111111111111111#keys-1",
"canonical_payload": "<encoded-scale-payload>",
"signature": "<base64-ed25519-signature>"
}'
DIDs
Set DID delivery constraints
Publish clock-time retention, message, chunk, and replica limits for a DID
curl --request PUT \
--url "https://directory.example.com/dids/did%3Aopenpayload%3A1111111111111111111111/delivery-constraints" \
--header "Content-Type: application/json" \
--data '{
"did": "did:openpayload:1111111111111111111111",
"action": "set_did_delivery_constraints",
"delivery_constraints": {
"requested_cache_seconds": 86400,
"max_http_envelope_bytes": 26214400,
"max_unchunked_message_bytes": 16777216,
"max_chunk_bytes": 2097152,
"max_replicas": 2
},
"nonce": "<policy-nonce>",
"valid_until": "<epoch-milliseconds>",
"signer_key_id": "did:openpayload:1111111111111111111111#keys-1",
"canonical_payload": "<encoded-scale-payload>",
"signature": "<base64-ed25519-signature>"
}'
Set the delivery limits controlled by a DID operator. A policy rule may narrow these values but cannot increase them.
This mutation uses an authorized DID proof and the current Policy V2
Omit
policy_nonce. See Authorize a Directory update.
Request
Requested delivery limits. Active values must be positive and at or below their network maxima.
Operator-requested Cache retention in clock-time seconds, stored as a positive
u32. The chain preserves this request but derives an effective maximum of 172800 seconds.Deprecated Policy V2 wire-compatibility field. Omit it. The Directory encodes the unbounded compatibility sentinel
4294967295.Deprecated Policy V2 wire-compatibility field. Omit it. The Directory encodes the unbounded compatibility sentinel
65535.effective_ttl_seconds; it is chain-derived and read-only. The active byte limits must satisfy the consistency rules described in Delivery policies.
curl --request PUT \
--url "https://directory.example.com/dids/did%3Aopenpayload%3A1111111111111111111111/delivery-constraints" \
--header "Content-Type: application/json" \
--data '{
"did": "did:openpayload:1111111111111111111111",
"action": "set_did_delivery_constraints",
"delivery_constraints": {
"requested_cache_seconds": 86400,
"max_http_envelope_bytes": 26214400,
"max_unchunked_message_bytes": 16777216,
"max_chunk_bytes": 2097152,
"max_replicas": 2
},
"nonce": "<policy-nonce>",
"valid_until": "<epoch-milliseconds>",
"signer_key_id": "did:openpayload:1111111111111111111111#keys-1",
"canonical_payload": "<encoded-scale-payload>",
"signature": "<base64-ed25519-signature>"
}'
Response
202 Response
{
"status": "accepted",
"did": "did:openpayload:1111111111111111111111",
"extrinsic": "set_did_delivery_constraints",
"tx_hash": "<transaction-hash>",
"message": "Chain extrinsic submitted"
}
202 Accepted confirms submission for processing, not final settlement. Read the constraints from finalized state before relying on them.
Straight to the point
PUT /dids/{url-encoded-did}/delivery-constraints
- Proof: authorized DID key
- Action:
set_did_delivery_constraints - Nonce: Policy V2
policy_nonce - Above-network active byte or replica values:
400 invalid_delivery_constraints - TTL above 48 hours: accepted as requested, effective value clamped to 48 hours
- Accepted submission:
202

