Skip to content

docs(x402): align runner docs with restricted auth and dry-run behavior#140

Merged
drewstone merged 2 commits intomainfrom
docs/x402-hardening-update
Feb 25, 2026
Merged

docs(x402): align runner docs with restricted auth and dry-run behavior#140
drewstone merged 2 commits intomainfrom
docs/x402-hardening-update

Conversation

@drewstone
Copy link
Contributor

Summary

Adds the x402 runner docs page and aligns it with the merged x402 hardening behavior in blueprint.

What this documents

  • Explicit per-job invocation policy model:
    • disabled
    • public_paid
    • restricted_paid
  • Restricted authorization modes:
    • payer_is_caller
    • delegated_caller_signature
  • On-chain parity checks for restricted jobs via isPermittedCaller(service_id, caller) (eth_call).
  • Delegated signature headers and payload contract, including nonce:
    • X-TANGLE-CALLER
    • X-TANGLE-CALLER-SIG
    • X-TANGLE-CALLER-NONCE
    • X-TANGLE-CALLER-EXPIRY
    • payload: x402-authorize:{service_id}:{job_index}:{keccak(body)}:{nonce}:{expiry}
  • New gateway endpoints:
    • GET /x402/stats
    • POST /x402/jobs/{service_id}/{job_index}/auth-dry-run
  • Runtime semantics:
    • 202 Accepted means accepted/enqueued (not final completion)
    • replay denial behavior (409 signature_replay)
    • dry-run is non-mutating and does not consume delegated nonces

Notes

This PR is intentionally scoped to x402 docs only.

@netlify
Copy link

netlify bot commented Feb 25, 2026

Deploy Preview for tangle-docs ready!

Name Link
🔨 Latest commit a655fe1
🔍 Latest deploy log https://app.netlify.com/projects/tangle-docs/deploys/699f5f3e32bc0c0008b9d762
😎 Deploy Preview https://deploy-preview-140--tangle-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@drewstone drewstone merged commit 01bc48e into main Feb 25, 2026
6 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant