docs: add x402 payment standard page under AI Studio on Hedera#550
Merged
Conversation
Add a top-level x402 doc covering Hedera's official "exact" payment
scheme and reference implementation in the x402 repo.
- Explain what x402 is/is not, who uses it, and its use cases to
correct the "magic crypto-for-agents" misconception
- Document the facilitator-as-feePayer flow and the PaymentRequirements
/PaymentPayload/SettlementResponse messages
- Add client/server usage examples; note @x402/hedera is not yet on npm
(use from the x402 monorepo source)
- Cover requirements and limitations
- Highlight the Blocky402 facilitator (verified hedera:testnet endpoint
and docs) plus how to run and get listed as a Hedera facilitator
- Link the Hedera blog, scheme spec, package, whitepaper, and report
Register the page in docs.json under the "AI Studio on Hedera" group.
Signed-off-by: Piotr Swierzy <piotr.swierzy@blockydevs.com>
|
@piotrswierzy @walkerlj0 -- adding a data point for the Hedera x402 facilitator listing (point 6 of the issue scope on hashgraph/hedera-agent-kit-js#806). AlgoVoi APM (Agent Payment Module) runs x402 on Hedera in production via the gateway at Facilitator surfaces:
The page would benefit from at least two production-grade Hedera facilitator entries (parallel coverage, not single-vendor) so readers see Hedera x402 as ecosystem infrastructure rather than implementation-specific. Happy to PR the facilitator-list entry directly against this branch or file a follow-up PR once #550 lands -- whichever path keeps the review cycle short for you. -- AlgoVoi |
narbs91
reviewed
May 26, 2026
narbs91
left a comment
narbs91
left a comment
There was a problem hiding this comment.
Look great overall to me, just a few comments/suggestions grammar wise
| Hedera contributes its own **`exact` payment scheme and a reference implementation** to the official [x402 repository](https://github.com/x402-foundation/x402), so applications and AI agents can settle payments in HBAR or HTS tokens over x402 with the speed and low, predictable fees of the Hedera network. | ||
|
|
||
| <Info> | ||
| For the background story and Hedera's perspective on why this matters, read the announcement: [**Hedera and the x402 Payment Standard**](https://hedera.com/blog/hedera-and-the-x402-payment-standard/). |
Member
There was a problem hiding this comment.
this renders on the site but not in github diff
Member
theekrystallee
left a comment
theekrystallee
left a comment
There was a problem hiding this comment.
LGTM. after you resolve comments i can approve to merge
Co-authored-by: Narb <29411347+narbs91@users.noreply.github.com> Signed-off-by: Peter Swierzy <123735851+piotrswierzy@users.noreply.github.com>
Co-authored-by: Narb <29411347+narbs91@users.noreply.github.com> Signed-off-by: Peter Swierzy <123735851+piotrswierzy@users.noreply.github.com>
Co-authored-by: Narb <29411347+narbs91@users.noreply.github.com> Signed-off-by: Peter Swierzy <123735851+piotrswierzy@users.noreply.github.com>
Co-authored-by: Narb <29411347+narbs91@users.noreply.github.com> Signed-off-by: Peter Swierzy <123735851+piotrswierzy@users.noreply.github.com>
Co-authored-by: Narb <29411347+narbs91@users.noreply.github.com> Signed-off-by: Peter Swierzy <123735851+piotrswierzy@users.noreply.github.com>
Co-authored-by: Narb <29411347+narbs91@users.noreply.github.com> Signed-off-by: Peter Swierzy <123735851+piotrswierzy@users.noreply.github.com>
Co-authored-by: Narb <29411347+narbs91@users.noreply.github.com> Signed-off-by: Peter Swierzy <123735851+piotrswierzy@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description:
Add a top-level x402 doc covering Hedera's official "exact" payment
scheme and reference implementation in the x402 repo.
Register the page in docs.json under the "AI Studio on Hedera" group.
Related issue(s):
Fixes #
Notes for reviewer:
Checklist