GOAT Name Service (.goat)

# Check availability
npx -p @goatnetwork/agentkit agentkit-gns search alice

# Quote the registration price
npx -p @goatnetwork/agentkit agentkit-gns price alice --years 1 --token USDC

# Register on GOAT mainnet (requires USDC/USDT already on GOAT)
GOAT_PRIVATE_KEY=0x... \
  npx -p @goatnetwork/agentkit agentkit-gns register alice --years 1 --token USDC

GOAT_PRIVATE_KEY=0x... \
PAYMENT_CHAIN_RPC_URL=https://bsc-dataseed.bnbchain.org \
  npx -p @goatnetwork/agentkit agentkit-gns x402-register alice \
    --pay-chain 56 \
    --pay-token USDT \
    --pay-token-contract 0x55d398326f99059fF775485246999027B3197955

1. x402.config preflight     — validate (payChain, payToken, payTokenContract)
                                 against the merchant's authoritative config
2. estimatePrice (GOAT-side) — quote totalWei in the GOAT-side stablecoin
3. commit (GOAT)             — bind (GOAT-side stablecoin, totalWei) into
                                 the on-chain commit hash
4. waitForCommitment         — poll until block.timestamp ≥ revealAt
                                 (minCommitmentAge = 60s; CLI default
                                  timeout 180s)
5. x402.createOrder          — pin commitMaxAmountWei so the backend
                                 re-derives a matching hash
6. x402.submitSignature      — user signs the calldata typed data
7. x402.payOrder             — broadcast source-chain ERC-20 transfer
                                 (e.g. 3 USDT on BSC)
8. poll getOrderStatus       — until INVOICED (true success) or terminal
                                 failure (FAILED / EXPIRED / CANCELLED)

import { JsonRpcProvider, Wallet } from 'ethers';
import { ActionProvider, ExecutionRuntime, PolicyEngine } from '@goatnetwork/agentkit';
import { EvmWalletProvider } from '@goatnetwork/agentkit/core';
import {
  HttpGnsApiAdapter,
  commitAction,
  waitForCommitmentAction,
  registerAction,
  estimatePriceAction,
  getGnsContracts,
  resolveGnsPaymentToken,
} from '@goatnetwork/agentkit/plugins';

const networkKey = 'goat-mainnet';
const contracts = getGnsContracts(networkKey);
const api = new HttpGnsApiAdapter({ network: networkKey });

const rpcUrl = 'https://rpc.goat.network';
const wallet = new EvmWalletProvider(
  new Wallet(process.env.GOAT_PRIVATE_KEY!, new JsonRpcProvider(rpcUrl)),
  new JsonRpcProvider(rpcUrl),
  networkKey,
);

const provider = new ActionProvider();
provider.register(estimatePriceAction(api));
provider.register(commitAction(contracts, wallet));
provider.register(waitForCommitmentAction(contracts, wallet));
provider.register(registerAction(contracts, wallet));

const policy = new PolicyEngine({
  allowedNetworks: [networkKey],
  maxRiskWithoutConfirm: 'low',
  writeEnabled: true,
});
const runtime = new ExecutionRuntime(policy, { maxRetries: 0, retryDelayMs: 200 });

// 1. Quote the GOAT-side price
const goatToken = resolveGnsPaymentToken(networkKey, 'USDC')!;
const quote = await runtime.run(
  provider.get('goat.gns.estimatePrice'),
  { traceId: 't1', network: networkKey, now: Date.now() },
  { name: 'alice', years: 1, tokenContract: goatToken.address },
  { confirmed: true },
);
const totalWei = (quote.output as { totalWei: string }).totalWei;

// 2. Commit (binds the same paymentToken + maxPaymentAmount the backend will re-derive)
const commit = await runtime.run(
  provider.get('goat.gns.commit'),
  { traceId: 't2', network: networkKey, now: Date.now() },
  {
    name: 'alice',
    owner: (await wallet.getAddress()) as `0x${string}`,
    years: 1,
    paymentTokenAddress: goatToken.address,
    paymentTokenSymbol: goatToken.symbol,
    amountWei: totalWei,
  },
  { confirmed: true, revealedFields: ['secret'] },
);

// 3. Wait for the reveal window, then call register / renew per your flow.