GET paid resource
The buyer's agent requests a paid resource with the unmodified official x402 client. No SubEtha client is needed to pay.
Customers pay zUSDC (wrapped USDC) with the unmodified official x402 client. Each order uses a different receiving address instead of one fixed payTo. Payer, amount, token and transaction time stay public. The zERC20 v2 SDK is designed not to link that address directly to the merchant's shielded funds on chain; this property has not been independently quantified, and correlation remains possible.
Testnet work with design partners. The records behind this page: public Sepolia runs on 2026-10-31 and 2026-11-01, and a hosted Base Sepolia configuration since 2026-11-09. Not production. Mainnet is a plan, not a status.
When every API call is an ordinary on-chain transfer, two things leak: which services a customer keeps paying for, and what a Provider earns and from whom.
Repeated transfers from one wallet show which Providers were paid, when, how much and in what order. SubEtha v2 makes it harder to tell, from public payments, which service a customer uses. It does not make it impossible.
A stream of payments into one payTo lets anyone chart inflows, usage trends and dependence on key customers. Our hypothesis, not a measured result: customers who care about this may prefer or keep using you, and your revenue stream and customer mix are less exposed on the public chain.
The wire is standard x402 v2 exact. What changes is where each payment lands and when the body is released. The five steps describe the hosted testnet configuration.
The buyer's agent requests a paid resource with the unmodified official x402 client. No SubEtha client is needed to pay.
Your Provider answers 402 with scheme exact, zUSDC, the amount and a payTo that is a fresh per-order burn-sale address from the zERC20 v2 point of sale, bound to this order.
The buyer signs a standard EIP-3009 transferWithAuthorization and retries the request. One order, one authorization.
The official middleware verifies, then your existing Express handler runs. Its response is held, not sent, until settlement. Side effects are not rolled back if settlement fails.
On the hosted testnet the facilitator relays the settlement to a delegated x402 facilitator, which broadcasts it and pays the gas: a public zUSDC transfer from the payer to the per-order address. The facilitator re-validates the mined receipt (one authorization used, one transfer of the order amount to the order's address, on time by block time), and your response is released with status 200.
extensions.subetha.info, the wallet that paid recovers with the official SIWX extension, and the recovery route accepts no payment. Recovery depends on retained order state; the hosted service promises no retention.What SubEtha v2 aims at is the direct public link between a per-order payTo and the merchant's shielded funds. Everything else in the table stays visible to someone.
Payer address, amount, token, the per-order address and the time of the settle transaction.
Which API it bought and with which wallet, for its own purchases.
Its own orders, including the authorization identity of the payer.
Per order: the payer address, amount, transaction, digest and Provider. It holds only each Provider's POS key, which derives addresses, writes that Provider's lane and tells which addresses are the Provider's. It cannot spend; it holds no seed and no view key.
Holds the merchant and broadcaster keys, funds the broadcaster, and sees the merchant wallet's whole activity.
Which merchant's shielded funds a per-order address feeds. This is a property of the zERC20 v2 SDK design and has not been independently quantified.
Withdraw outputs from the merchant's shielded funds are visible to everyone.
Timing, amounts, the merchant's other activity and the size of the anonymity set can suggest a link; the evidence does not quantify identification accuracy. zERC20's private-send amount privacy does not carry over to the burn-sale path used here.
Your Provider trusts the payTo the facilitator hands out and checks it later with its own view key. The operator could still withhold orders, attribute an order to another Provider, or hand out an address that is not yours; the audit finds this after the fact.
The documented integration is Express on Node. Source is provided to design partners on request. Registration on the hosted testnet is by application, reviewed by the operator, or by the operator on request.
The standard x402 exact flow, the official client on the buyer side, and the official @x402/express middleware on yours.
Your customers pay in zUSDC (wrapped USDC; wrapping is a public step). The facilitator supplies a per-order payTo. Your integration holds the response until the mined receipt is re-validated. In the hosted configuration your POS key determines the intended wallet destination. A mined transfer and a delivered body do not establish merchant-side private mint or spendability.
Delivery follows the mined receipt; there is no finality gate. A chain reorg or an ASP rejection can occur after delivery, so delivering the body does not guarantee merchant credit or spendability. Provider-only rage exit is unverified and is not a verified remedy. Keep paid handlers idempotent or read-only.
Node 22.12 or later and pnpm 10.15.1; an Express app whose paid handler you wrap with @subetha/provider/x402 (createSubetha gives guard, a paymentMiddleware built on @x402/express 2.28.0, observer, handlers and start()); compiled entry points run with plain node. Other server frameworks are not established by the records. Use the supported response API: raw-socket writes bypass the guard. Your customers need an EOA (smart-contract wallets cannot pay), a little Base Sepolia ETH for the mint, approve and wrap transactions, test zUSDC, and the unmodified official client.
Registration is testnet only, and there are two ways in. You apply by email to [email protected]; the operator reviews the application and, if it is approved, sends an invite code. Approval is not guaranteed and capacity is limited. With the code you make a POS key, register, pay a one-time probe and activate from your own machine, signed by your own EOA. The Provider tools and the extension come as tarballs with the invite code, checked against the integrity values in the registration guide. The operator path stays open: you make a POS key in your own wallet and send the operator the POS key file and your Provider address, never a seed or a view key; the operator registers you and issues a Provider token and a one-time probe address; you complete the operator's probe-payment instructions, confirm the payment in your own wallet and notify the operator; orders open after activation. Either way, you run the official middleware with the SubEtha extension pointed at your own lane of the hosted facilitator, with your Provider token. Keep every probe address and supply all of them, with your own view key, to each audit; audit regularly. Withdrawals are public, journaled and not repeated automatically.
The v2 Provider extension is source 0.2.0, unpublished; the npm package @subetha/provider 0.1.0 is V1 and has no ./x402 subpath. The v2 facilitator and adapter are private workspace packages. Access is an authorized checkout provided to design partners on request. SubEtha-authored code is Apache-2.0; the zERC20 v2 SDKs are installed from npm under their own terms, and the repository grants no commercial-use rights, public-hosting rights or official status for any zERC20 component.
Read from the product repository's own records as of 2026-11-13. This is not a current availability check, and this page made no payment.
One payment by the unmodified official client; body delivered on the re-validated mined receipt; chain finality reached later. After a Provider restart the same order was recovered with SIWX and zero payment signatures; another wallet got 403.
The official approval hook: deny and mismatch gave zero signatures and no settlement; allow gave one settlement and the body. The same recovery results; the denied order answered 409.
The repository records the switch to the hosted configuration on 2026-11-09, followed by one public purchase verifying relay, delivery and recovery 200. The operator sees, per order, the payer address, amount, transaction, digest and Provider; it holds only each Provider's POS key (which derives addresses, writes that Provider's lane and tells which addresses are the Provider's); it signs no transaction, cannot spend, and holds no seed and no view key. A measurement on 2026-11-08 and the quickstart describe new-order creation as serialized, about 9 s per order; this is not a latency guarantee.
Several payers, more orders, budget refills, monitoring and hosting are not covered by the Sepolia sample. Browser wallet signing and browser purchase-to-recovery are not verified. Multi-instance deployment, Router integration, mainnet and a latency SLA are outside the sample's verification scope; the sample states that the Router and SVM are out of its scope. Real reorgs and sustained latency are not proven. The hosted record adds one purchase at switchover, not sustained-operation or scale evidence. Provider-only rage exit is unverified. Merchant-side private mint and spendability were not observed in the documented runs.
SubEtha is not intended to be a Sepolia-only service; we plan to extend to mainnet assets across chains supported by zERC20 v2, with integration and validation per chain and asset. The prerequisites for mainnet remain open.
Capacity is limited and the service may be paused or reset; it promises no availability or retention. Settlement is relayed to a delegated x402 facilitator, which broadcasts and pays gas; the relay is unguaranteed, and its terms and mainnet availability are unknown.
v2 Provider extension: source 0.2.0, unpublished. npm @subetha/provider: 0.1.0, V1, no ./x402 subpath. Facilitator and adapter: private workspace packages. SubEtha code is Apache-2.0; the zERC20 v2 SDKs follow their own npm terms; no commercial-use, public-hosting or official-status grant exists for any zERC20 component. Production-use permission is not established by the evidence.
No. The payer address, the amount, the token, the per-order address and the time of the settle transaction are public on chain, and amounts are not hidden on this burn-sale path. What is not directly linked on the public chain is which merchant's shielded funds a per-order address feeds, a zERC20 v2 SDK design property that has not been independently quantified. Correlation through timing, amounts, your other activity and the size of the anonymity set remains possible, and public withdrawals are public.
The documented integration is the official @x402/express middleware 2.28.0 with the SubEtha extension around an existing Express handler, on Node 22.12 or later. Your customers keep the unmodified official client. The records do not establish other server frameworks, and the Provider and facilitator processes are not designed for browser embedding.
An EOA (smart-contract wallets cannot pay; EIP-3009 verifies ECDSA only), a little Base Sepolia ETH for the mint, approve and wrap transactions, test zUSDC obtained by wrapping test USDC, and the unmodified official client. They should keep the orderId from the 402 before signing and never sign again for the same order after a timeout or a refusal: a signed authorization stays usable on chain until its validBefore, and a refusal is not a revocation.
The SubEtha Router is a separate product with its own page: an MCP server that lets an agent pay on one testnet rail and reach a paid API on another, testnet-only and unaudited. The Provider-side path on this page is not the Router, and nothing here establishes privacy properties for purchases made through the Router. Router integration with SubEtha v2 is outside the verification scope of the documented path. See the Router page and SubEtha and the Router in the Docs.
No. The current offering is testnet work with design partners. SubEtha's own code is Apache-2.0; the zERC20 v2 SDKs are installed from npm under their own terms, and the repository grants no commercial-use rights, public-hosting rights or official status for any zERC20 component. Production-use permission is not established by the evidence presented here.
No. The v2 Provider extension is unpublished source (0.2.0); the facilitator and adapter are private workspace packages. No v2 package exists on npm; @subetha/provider 0.1.0 on npm is V1. Source is provided to design partners on request.
Your response is released only after the facilitator re-validates the mined receipt. Chain finality is later and separate, and delivery does not establish merchant-side private mint or spendability. A 202 is not delivery; only status 200 is sold, one order per 402.
Tell us about your x402 setup and your customers. Testnet registration requests go to the same address. No demo, delivery date or SLA is promised.
顧客は、無改造の公式 x402 クライアントで zUSDC(wrap した USDC)を支払う。固定の payTo ではなく、注文ごとに異なる受取アドレスを使う。payer・金額・token・取引時刻は公開のまま。zERC20 v2 SDK の設計では、そのアドレスと merchant の shielded funds は公開チェーン上で直接結び付かない。この性質は独立に定量評価されておらず、相関による推測は可能。
設計パートナーとのテストネット段階です。このページの根拠となる記録: 公開 Sepolia での実行(2026-10-31、2026-11-01)と、2026-11-09 以降の hosted Base Sepolia 構成。本番ではありません。メインネットは計画であり、現状ではありません。
API 呼び出しのたびに通常のオンチェーン送金が起きると、2 つのことが漏れます。顧客がどのサービスに払い続けているか、そして Provider が誰からいくら得ているか。
1 つのウォレットからの繰り返しの送金は、どの Provider に、いつ、いくら、どの順で払ったかを示します。SubEtha v2 は、公開決済からどのサービスを使ったかを辿りにくくします。不可能にするものではありません。
1 つの payTo への入金の列からは、誰でも入金・利用トレンド・大口顧客への依存を描けます。仮説であり、測定結果ではありません: これを気にする顧客はあなたを選び続けるかもしれず、売上の流れと顧客構成が公開チェーン上で晒されにくくなります。
ワイヤは標準の x402 v2 exact です。変わるのは、各支払いの着地点と、本文が解放されるタイミングです。5 つのステップは hosted testnet 構成を説明しています。
買い手のエージェントが、無改造の公式 x402 クライアントで有料リソースを要求します。支払いに SubEtha のクライアントは要りません。
あなたの Provider は 402 で scheme exact、zUSDC、金額、そして zERC20 v2 の point of sale が発行した新しい注文別 burn-sale アドレスを payTo として返し、この注文に結び付けます。
買い手は標準の EIP-3009 transferWithAuthorization に署名して再リクエストします。1 注文、1 authorization。
公式 middleware が verify し、既存の Express handler が実行されます。応答は settle まで送信されず保持されます。settle が失敗しても副作用は巻き戻りません。
hosted testnet では facilitator が settle を委任先の x402 facilitator に中継し、そこが放送して gas を払います。payer から注文別アドレスへの公開の zUSDC 送金です。facilitator が mined receipt を再検証し(authorization の使用 1 件、注文のアドレスへの注文金額の送金 1 件、ブロック時刻で期限内)、応答が status 200 で解放されます。
extensions.subetha.info で届き、支払ったウォレットが公式の SIWX 拡張で復旧し、復旧ルートは支払いを受け付けません。復旧は保持された注文状態に依存し、hosted サービスは保持を約束しません。SubEtha v2 が狙うのは、注文ごとの payTo と merchant の shielded funds の間の、公開チェーン上の直接のリンクです。表のそれ以外は、誰かには見えています。
payer のアドレス、金額、token、注文ごとのアドレス、settle トランザクションの時刻。
自分の購入について、どの API をどのウォレットで買ったか。
自分の注文。payer の authorization の identity を含みます。
注文ごとに、payer のアドレス、金額、トランザクション、digest、Provider。保持するのは各 Provider の POS key だけで、それでアドレスを導出し、その Provider のレーンに書き、どのアドレスがその Provider のものかを知ります。使うことはできず、seed も view key も持ちません。
merchant と broadcaster の鍵を持ち、broadcaster に資金を入れ、merchant ウォレットの活動全体を見ます。
注文ごとのアドレスがどの merchant の shielded funds に流れるか。zERC20 v2 SDK の設計上の性質で、独立した定量評価はされていません。
merchant の shielded funds からの withdraw 出力は全員に見えます。
タイミング、金額、merchant の他の活動、匿名性セットの大きさは関連を示唆し得ます。根拠は識別精度を定量化していません。burn-sale パスでは、zERC20 の private-send パスにある金額の秘匿性は引き継がれません。
あなたの Provider は facilitator が渡す payTo を信頼し、あとから自分の view key で確認します。運用者は注文を握りつぶす、別の Provider の注文として扱う、あなたのものではないアドレスを渡す、ということがなおできます。監査はそれを事後に見つけます。
文書化された統合は Node 上の Express です。ソースは設計パートナーへ依頼ベースで提供します。hosted testnet への登録は、申し込み制(運用者が審査)か、運用者への依頼で行います。
標準の x402 exact フロー、買い手側の公式クライアント、あなた側の公式 @x402/express middleware。
顧客は zUSDC(wrap した USDC。wrap は公開の手順)で払います。facilitator が注文ごとの payTo を供給します。あなたの統合は、mined receipt の再検証まで応答を保持します。hosted 構成では、あなたの POS key が意図したウォレット宛先を決めます。mined 送金と配信された本文は、merchant 側の private mint や spendability を立証しません。
配信は mined receipt に従い、finality のゲートはありません。チェーンの reorg や ASP の拒否は配信後にも起こり得るため、本文を配信しても merchant への入金や spendability は保証されません。Provider 単独の rage exit は未検証で、検証済みの救済ではありません。有料 handler は冪等か読み取り専用にしてください。
Node 22.12 以上と pnpm 10.15.1。有料 handler を @subetha/provider/x402 で包める Express アプリ(createSubetha が guard、@x402/express 2.28.0 上に組んだ paymentMiddleware、observer、handlers、start() を返します)。コンパイル済みのエントリは素の node で動かします。他のサーバーフレームワークは記録上確立していません。サポートされた response API を使ってください。raw socket への書き込みは guard を迂回します。顧客側には EOA(スマートコントラクトウォレットは支払えません)、mint・approve・wrap のための少量の Base Sepolia ETH、テスト用 zUSDC、無改造の公式クライアントが必要です。
登録はテストネット限定で、入り方は二つあります。[email protected] にメールでお申し込みください。運用者が申請内容を審査し、承認された場合は招待コードを送ります。承認は保証されず、受け入れ数にも限りがあります。そのコードを使って、自分のマシンから自分の EOA の署名で、POS key の作成、登録、一度きりの probe の支払い、有効化を行います。Provider ツールと拡張は招待コードとともに tarball で届き、登録ガイド(英語)に載っている integrity 値と照合してから使います。運用者経由の登録も引き続き使えます。あなたは自分のウォレットで POS key を作り、POS key ファイルと Provider アドレスを運用者に送ります。seed や view key は決して送りません。運用者があなたを登録し、Provider token と一度きりの probe アドレスを発行します。あなたは運用者の probe 支払い手順を完了し、自分のウォレットで支払いを確認して運用者に知らせます。注文は有効化後に開きます。どちらの場合も、公式 middleware と SubEtha 拡張を、hosted facilitator 上の自分のレーンに向けて、Provider token とともに動かします。probe アドレスはすべて保管し、自分の view key とともに毎回の監査に渡します。監査は定期的に行います。withdraw は公開で、記録され、自動では繰り返されません。
v2 の Provider 拡張はソース 0.2.0 で未公開です。npm パッケージ @subetha/provider 0.1.0 は V1 で、./x402 サブパスを持ちません。v2 の facilitator と adapter は非公開のワークスペースパッケージです。アクセスは、設計パートナーへ依頼ベースで提供する認可済みチェックアウトです。SubEtha が書いたコードは Apache-2.0。zERC20 v2 SDK は npm からそれぞれの条件でインストールされ、この repository はいかなる zERC20 コンポーネントについても商用利用権・公開サービス運用権・公式の地位を付与しません。
2026-11-13 時点で、製品 repository 自身の記録から読み取ったものです。現在の可用性の確認ではなく、このページのために支払いは行っていません。
無改造の公式クライアントによる支払い 1 件。再検証した mined receipt で本文を配信、チェーンの finality は後から到達。Provider 再起動後、同じ注文を SIWX で支払い署名ゼロで復旧。別のウォレットは 403。
公式の承認フック: deny と mismatch は署名ゼロ・settle なし、allow は settle 1 件と本文。復旧の結果は同じで、deny された注文は 409。
repository は 2026-11-09 の hosted 構成への切替と、それに続く公開購入 1 件(中継・配信・復旧 200 を確認)を記録しています。運用者には注文ごとに payer のアドレス、金額、トランザクション、digest、Provider が見えます。保持するのは各 Provider の POS key だけで(アドレスの導出、その Provider のレーンへの書き込み、どのアドレスがその Provider のものかの把握に使います)、トランザクションに署名せず、使うこともできず、seed も view key も持ちません。2026-11-08 の計測と quickstart は、新規注文の作成を直列で 1 件あたり約 9 秒と記述しています。これはレイテンシの保証ではありません。
複数の payer、より多い注文、予算の補充、監視、ホスティングは Sepolia のサンプルでは覆われていません。ブラウザウォレットの署名とブラウザでの購入から復旧までは未検証です。マルチインスタンス配備、Router 連携、mainnet、レイテンシ SLA はサンプルの検証範囲外で、サンプルは Router と SVM を範囲外と明記しています。実際の reorg と持続的なレイテンシは証明されていません。hosted の記録が加えるのは切替時の購入 1 件で、継続運用や規模の証拠ではありません。Provider 単独の rage exit は未検証です。merchant 側の private mint と spendability は、文書化された実行では観測されていません。
SubEtha は Sepolia 限定のサービスにとどまる意図ではなく、zERC20 v2 が対応するチェーンのメインネット資産へ、チェーンと資産ごとの統合と検証を経て拡張する計画です。メインネット移行の前提条件は未解決です。
容量は限られ、サービスは停止や初期化されることがあります。可用性も保持も約束しません。settle は委任先の x402 facilitator に中継され、そこが放送して gas を払います。この中継は保証されず、その条件とメインネットでの提供可否は不明です。
v2 の Provider 拡張: ソース 0.2.0、未公開。npm の @subetha/provider: 0.1.0、V1、./x402 サブパスなし。facilitator と adapter: 非公開のワークスペースパッケージ。SubEtha のコードは Apache-2.0、zERC20 v2 SDK はそれぞれの npm の条件に従い、いかなる zERC20 コンポーネントについても商用利用・公開サービス運用・公式の地位の付与はありません。本番利用の許可は根拠からは確認できません。
いいえ。payer のアドレス、金額、token、注文ごとのアドレス、settle トランザクションの時刻はチェーン上で公開で、この burn-sale パスでは金額は隠れません。公開チェーン上で直接結び付かないのは、注文ごとのアドレスがどの merchant の shielded funds に流れるかで、これは zERC20 v2 SDK の設計上の性質であり、独立した定量評価はされていません。タイミング、金額、あなたの他の活動、匿名性セットの大きさによる相関は残り得て、公開 withdraw は公開です。
文書化された統合は、既存の Express handler を公式 @x402/express middleware 2.28.0 と SubEtha 拡張で包むもので、Node 22.12 以上で動きます。顧客は無改造の公式クライアントのままです。他のサーバーフレームワークは記録上確立しておらず、Provider と facilitator のプロセスはブラウザ組み込みを想定していません。
EOA(スマートコントラクトウォレットは支払えません。EIP-3009 は ECDSA だけを検証します)、mint・approve・wrap のための少量の Base Sepolia ETH、テスト用 USDC を wrap して得るテスト用 zUSDC、無改造の公式クライアントです。署名の前に 402 の orderId を控え、タイムアウトや拒否の後に同じ注文へ再署名してはいけません。署名済みの authorization は validBefore までチェーン上で使用可能なままで、拒否は取り消しではありません。
SubEtha Router は専用ページを持つ別の製品です。エージェントがあるテストネットのレールで支払い、別のレールの有料 API に到達できるようにする MCP サーバーで、テストネット限定・未監査です。このページの Provider 側の経路は Router ではなく、Router 経由の購入の秘匿性について、このページは何も示しません。Router と SubEtha v2 の連携は、文書化された経路の検証範囲外です。Router のページと Docs の SubEtha and the Router を参照してください。
いいえ。現在の提供は、設計パートナーとのテストネット段階です。SubEtha 自身のコードは Apache-2.0。zERC20 v2 SDK は npm からそれぞれの条件でインストールされ、この repository はいかなる zERC20 コンポーネントについても商用利用権・公開サービス運用権・公式の地位を付与しません。本番利用の許可は、ここで提示した根拠からは確認できません。
いいえ。v2 の Provider 拡張は未公開のソース(0.2.0)で、facilitator と adapter は非公開のワークスペースパッケージです。v2 の npm パッケージはなく、npm にある @subetha/provider 0.1.0 は V1 です。ソースは設計パートナーへ依頼ベースで提供します。
応答は、facilitator が mined receipt を再検証した後にだけ解放されます。チェーンの finality は後で別のものであり、配信は merchant 側の private mint や spendability を立証しません。202 は配信ではなく、売られるのは status 200 だけで、402 ごとに 1 注文です。
あなたの x402 の構成と顧客について教えてください。テストネット登録の相談も同じ宛先です。デモ、納期、SLA は約束しません。