Skip to content

What buyers do

This page describes what a buyer does to pay a SubEtha v2 Provider on the hosted testnet, as the product repository records it. What the public chain shows is summarised in Who sees what.

The wire is standard x402 v2 exact (EIP-3009 transferWithAuthorization). You pay with the unmodified official client, @x402/fetch and @x402/evm 2.28.0. No SubEtha client or package is required to pay.

On the hosted testnet the network is Base Sepolia (eip155:84532) and the asset is zUSDC (wrapped USDC). You need:

  • An EOA. Smart-contract wallets cannot pay; EIP-3009 verifies ECDSA only.
  • A little Base Sepolia ETH for three public transactions: mint test USDC, approve, and wrap.
  • Test zUSDC, obtained in three public steps: get test USDC (mint it to your address), approve the official zUSDC contract to spend it, then wrap it with that zUSDC contract. Wrapping gives a public zUSDC balance, which is what an x402 payment spends.

You need two contract addresses: the test USDC (the zUSDC underlying, whose mint anyone can call) and zUSDC. Both use 6 decimals. Like every hosted value, the addresses are not published here: a Provider finds them in the invite packet; otherwise ask the operator.

The test USDC is not Circle’s USDC. It is the zERC20 testnet’s own test token (its on-chain name is “Dummy USD Coin”, symbol USDC), and anyone can mint it. Calling its mint is this token’s faucet: no faucet site, sign-in or bot check is needed. This zUSDC wraps only that token, so USDC from Circle’s faucet does not work here.

Public Base Sepolia faucets exist (the Base documentation lists them under “Network faucets”), and each rate-limits claims. Most ask for something a fresh EOA does not have. On 2026-11-18 the pages said so: Alchemy and QuickNode ask for a small balance on Ethereum mainnet, QuickNode also a bot check, and Chainlink a browser wallet connection. If a faucet does not serve your EOA, claim to another testnet wallet of your own and send a little ETH from it to the EOA. The operator does not send ETH or zUSDC, not even on request.

Each step is one public transaction from your EOA. With Foundry’s cast (the calls are plain contract calls, so any wallet or tool that can call a contract works too):

Terminal window
USDC="<test USDC address from your packet>"
ZUSDC="<zUSDC address from your packet>"
ME="<your EOA address>"
AMOUNT="<amount in atomic units (6 decimals)>"
RPC="<a Base Sepolia RPC URL>"
KS="<your keystore file>"
PW="<0600 file with its password>"
cast send "$USDC" "mint(address,uint256)" "$ME" "$AMOUNT" --rpc-url "$RPC" --keystore "$KS" --password-file "$PW"
cast send "$USDC" "approve(address,uint256)" "$ZUSDC" "$AMOUNT" --rpc-url "$RPC" --keystore "$KS" --password-file "$PW"
cast send "$ZUSDC" "wrap(uint256,address)" "$AMOUNT" "$ME" --rpc-url "$RPC" --keystore "$KS" --password-file "$PW"
cast call "$ZUSDC" "balanceOf(address)(uint256)" "$ME" --rpc-url "$RPC"

The last line prints your public zUSDC balance in atomic units.

Amounts. Wrap a little more than you plan to spend; purchases on the testnet are small. A Provider needs zUSDC only for the probe: wrap a small amount above the probe amount. Gas is small: on 2026-11-18 mint, approve, wrap and a probe together cost about 0.000002 ETH (gas used: mint 51,255, approve 46,306, wrap 106,014), so about 0.00001 ETH is ample at such fees. Fees vary; keep a margin.

The 402 carries extensions.subetha.info with the order id and a recovery URL. Keep the order id before signing. It is what you recover with: the wallet that paid recovers the result with the official SIWX extension, and the recovery route accepts no payment. Recovery depends on retained order state, and the hosted service promises no retention.

Do not sign again for the same order after a timeout or refusal.

  • A signed authorization remains usable on chain until its validBefore. Anyone holding it may submit it.
  • A refusal or timeout is not revocation and not proof that nothing was broadcast.
  • Keep the order id, and recover if payment appears.
  • The hosted service resolves uncertain relay outcomes against chain state.
  • Rate and send limits are service answers, not client errors. Wait, then request again rather than re-signing.

On the documented hosted testnet you sign the payment authorization, and a delegated x402 facilitator broadcasts it through the facilitator’s relay, paying the settlement gas. You still need Base Sepolia ETH for the mint, approve and wrap transactions. The relay is unguaranteed, and its terms and mainnet availability are unknown.

Self-run operation is a different configuration: it requires an operator-funded broadcaster.

  • You see your own purchases.
  • The public chain shows the payer address, the amount, the token, the per-order burn address and the time of the settle transaction.
  • The Provider sees its own orders, including the authorization identity.

The full table, including what the hosted-testnet operator sees, is in Who sees what.

Capacity is limited and the service may be paused or reset. Testnet access and questions go to contact@subethalabs.com or X @subethalabs; the landing page’s contact section has the same details. Providers should read For Providers.

Reviewed 2026-11-16 against the product repository at e972064; re-read on 2026-11-18 against 68e061b, which changes only the quickstart’s and the operations notes’ funding and probe text. The mint, approve and wrap calls and the gas figures were added on 2026-11-18 from a live self-funded run on Base Sepolia (the commands encode the same calldata as that run); the faucet requirements are as the faucet pages stated that day, and the sentence that the operator sends no funds follows the owner’s decision of the same day. The test USDC’s name and symbol were read from the chain on 2026-11-18. Evidence is the product repository’s own records; this site made no payment for this page.