@nerochain/x402-client
v1.0.0-rc.1
Published
Agent-side fetch wrapper for the x402 V2 payment protocol on NERO Chain. Catches HTTP 402, signs a PaymentPayload via an injectable PaymentSigner, retries the request.
Readme
@nerochain/x402-client
Wrapper de fetch lado-agente para o protocolo de pagamento x402 V2 na NERO Chain. Captura HTTP 402, assina um PaymentPayload via um PaymentSigner injetado, e repete a requisição. Funciona com qualquer signer; vem com suporte first-class ao esquema aa-native via @nerochain/x402-aa.
Instalação
pnpm add @nerochain/x402-client @nerochain/x402-aaUso — fetch
import { x402Fetch } from "@nerochain/x402-client";
import { aaNativeSigner } from "@nerochain/x402-aa";
const signer = aaNativeSigner({
signer: yourEthersWallet,
rpcUrl: "https://rpc.nerochain.io",
bundlerUrl: "https://bundler-mainnet.nerochain.io",
paymasterUrl: "https://paymaster-mainnet.nerochain.io",
paymasterApiKey: process.env.NERO_PAYMASTER_API_KEY!,
settlementContract: "0x5eCfc64f2339992668f555918674B604F97B412D",
entryPoint: "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789",
accountFactory: "0x9406Cc6185a346906296840746125a0E44976454",
});
const fetchPaid = x402Fetch({ signer });
const res = await fetchPaid("https://merchant.example.com/api/llm", {
method: "POST",
body: JSON.stringify({ prompt: "Explique x402" }),
});Adapters
@nerochain/x402-client— fetch (padrão)@nerochain/x402-client/axios— axios
Lendo o recibo
import { readSettlementReceipt } from "@nerochain/x402-client";
const receipt = readSettlementReceipt(res);
console.log(receipt.transactionHash, receipt.payer, receipt.amount);Documentação
Referência completa: https://x402.nerochain.io/docs/sdk/x402-client.
Licença
MIT.