CLIs

my-agent/
├── package.json       # Dependencies and scripts
├── tsconfig.json      # TypeScript configuration
├── .env.example       # Environment variable template
├── README.md          # Quick start instructions
└── src/
    └── index.ts       # Main entry point with all plugins registered

import { ActionProvider } from '@goatnetwork/agentkit/providers';
import { PolicyEngine, ExecutionRuntime } from '@goatnetwork/agentkit/core';
import { NoopWalletProvider } from '@goatnetwork/agentkit/core';
import {
  walletBalanceAction,
  getDetailsAction,
  getAllowanceAction,
  contractReadAction,
  contractWriteAction,
  transferNativeAction,
  transferErc20Action,
  approveErc20Action,
  deployContractAction,
  resolveTokenAction,
  NoopWalletReadAdapter,
} from '@goatnetwork/agentkit/plugins';

// Replace NoopWalletProvider with a real provider for production use.
const wallet = new NoopWalletProvider();

const provider = new ActionProvider();
provider.register(walletBalanceAction(new NoopWalletReadAdapter()));
provider.register(getDetailsAction(wallet));
provider.register(getAllowanceAction(wallet));
provider.register(contractReadAction(wallet));
provider.register(contractWriteAction(wallet));
provider.register(transferNativeAction(wallet));
provider.register(transferErc20Action(wallet));
provider.register(approveErc20Action(wallet));
provider.register(deployContractAction(wallet));
provider.register(resolveTokenAction());

const policy = new PolicyEngine({
  allowedNetworks: ['goat-testnet'],
  maxRiskWithoutConfirm: 'low',
  writeEnabled: true,
});

const runtime = new ExecutionRuntime(policy, {
  maxRetries: 2,
  retryDelayMs: 200,
});

console.log('Agent ready - minimal preset, 1 plugin(s)');
console.log('Registered actions:', provider.list().map((a) => a.name));

cd my-agent
pnpm install   # or npm install
pnpm start     # runs: tsx src/index.ts

npx -p @goatnetwork/agentkit agentkit-gns --help

npx -p @goatnetwork/agentkit agentkit-gns lookup alice

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

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

# Register on GOAT mainnet (requires USDC/USDT on GOAT)
npx -p @goatnetwork/agentkit agentkit-gns register alice --years 1 --token USDC

# Cross-chain register paid from BSC (USDT, 18 decimals on BNB Smart Chain)
npx -p @goatnetwork/agentkit agentkit-gns x402-register alice \
  --pay-chain 56 \
  --pay-token USDT \
  --pay-token-contract 0x55d398326f99059fF775485246999027B3197955

npx -p @goatnetwork/agentkit agentkit-giftcard --help

# Discover available regions (US, CA, …) — start here. Brand catalogs are
# region-scoped; the upstream API silently defaults to US if you don't pick.
npx -p @goatnetwork/agentkit agentkit-giftcard regions

# List brands in a chosen region. --country is required in non-TTY contexts;
# interactively the CLI prompts with a region picker (US as the default).
npx -p @goatnetwork/agentkit agentkit-giftcard list-brands --country US

# Get details for one brand (includes products[] with UUIDs to pass to buy).
# get-brand is region-agnostic — brand UUIDs are global.
npx -p @goatnetwork/agentkit agentkit-giftcard get-brand <brand-id>

# List supported source chains and their tokens
npx -p @goatnetwork/agentkit agentkit-giftcard list-chains

# Buy a giftcard (createOrder → payOrder → poll until FULFILLED)
npx -p @goatnetwork/agentkit agentkit-giftcard buy \
  --product <product-id> --face-value 25 \
  --pay-chain 56 --pay-token USDT

# Inspect status (use --reveal-secrets to print card_code / card_pin / card_link)
npx -p @goatnetwork/agentkit agentkit-giftcard status <order-id>

# List past orders (filter by status, paginate)
npx -p @goatnetwork/agentkit agentkit-giftcard list-orders