@nerochain/x402-aa

PaymentSigner ERC-4337 / AA-nativo para o protocolo x402 V2 na NERO Chain. Constrói UserOps patrocinados pelo paymaster que liquidam USDC/USDT através do SettlementContract NERO 402. A smart contract wallet do agente paga o merchant; o gás é patrocinado pelo NERO Paymaster.

Instalação

pnpm add @nerochain/x402-aa @nerochain/x402-client

Uso

import { aaNativeSigner } from "@nerochain/x402-aa";
import { x402Fetch } from "@nerochain/x402-client";
import { Wallet } from "ethers";

const eoa = new Wallet(process.env.NERO_PRIVATE_KEY!);

const signer = aaNativeSigner({
  signer: eoa,
  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 f = x402Fetch({ signer });
const res = await f("https://merchant.example.com/api/llm", {
  method: "POST",
  body: JSON.stringify({ prompt: "..." }),
});

O que ele faz internamente

Para cada desafio 402:

1. Calcula um requestHash vinculado a (payer, merchant, token, amount).
2. Codifica SettlementContract.settle(merchant, token, amount, requestHash) no callData da SCW.
3. Constrói uma UserOperation ERC-4337 v0.6 contra o EntryPoint configurado.
4. Solicita patrocínio do NERO Paymaster (tipo 0).
5. Assina com a EOA, retorna o PaymentPayload para @nerochain/x402-client enviar.

Documentação

Referência completa: https://x402.nerochain.io/docs/sdk/x402-aa.

Licença

MIT.