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 official client is enough
Section titled “The official client is enough”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.
Get test zUSDC
Section titled “Get test zUSDC”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 (
mintit 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.
Base Sepolia ETH
Section titled “Base Sepolia ETH”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.
Mint, approve, wrap
Section titled “Mint, approve, wrap”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):
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.
Keep the order id
Section titled “Keep the order id”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 twice
Section titled “Do not sign twice”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.
Who pays gas
Section titled “Who pays gas”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.
What you can see
Section titled “What you can see”- 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.
Ask for testnet access
Section titled “Ask for testnet access”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.