GOAT Network
AgentKit

GOAT Network AgentKit

AgentKit plugs your existing agent or app into GOAT Network. It is not an agent creator; it is the toolkit your project uses to sign transactions, accept x402 payments, register ERC-8004 identity, and expose the same capability surface to major AI frameworks.

It provides a production-grade runtime engine, 118 pre-built on-chain actions across 15 plugins (including the 30-action x402 merchant portal, the 15-action GNS .goat name service, and the 8-action x402 giftcard purchase flow), plus adapters for five major AI frameworks — so you define an action once and export it everywhere.

Open the official AgentKit product page for the latest public overview, or review the AgentKit GitHub repository for source code and package updates.

Key Features

118 Actions, 15 Plugins

Wallet, DEX, bridge, NFT, governance, payments, merchant management, agent identity, cross-chain, .goat naming, and x402 giftcard purchase.

5 AI Framework Adapters

OpenAI Function Calling, LangChain, MCP, Vercel AI SDK, and OpenAI Agents SDK — define once, use everywhere.

x402 Payments

Native agent payment protocol with EIP-712 signing flow plus a 30-action merchant portal and a real consumer flow (giftcard purchase).

ERC-8004 Identity

On-chain agent registration, metadata, and reputation system for trustless agent identity.

GOAT Name Service

.goat human-readable names with ENS-style commit-reveal registration and cross-chain x402-paid registration from Polygon / Base / Arbitrum / Optimism / BSC / Metis.

Production Runtime

Policy engine, Zod validation, idempotency (memory/Redis), retries, timeouts, Prometheus metrics, and execution hooks.

Three CLIs

create-goat-agent project scaffolder; agentkit-gns for .goat name management; agentkit-giftcard for end-user giftcard purchases.

Quick Start Paths

Install the SDK
npm install @goatnetwork/agentkit
Scaffold a starter project
npm create goat-agent

Install the SDK directly when you already have an app, agent, or runtime. Use the CLI when you want a runnable starter project for GOAT Network AgentKit.

Architecture

AgentKit is organized into four layers:

Four-Layer Architecture
┌──────────────────────────────────────────────────────────────┐
│  Adapters                                                     │
│  OpenAI · LangChain · MCP · Vercel AI · OpenAI Agents        │
├──────────────────────────────────────────────────────────────┤
│  Providers                                                    │
│  ActionProvider · customActionProvider · Tool Manifest         │
├──────────────────────────────────────────────────────────────┤
│  Plugins (15 modules, 118 actions)                            │
│  wallet · dex · bridge · x402 · erc8004 · bitvm2 · gns ·     │
│  giftcard · ...                                               │
├──────────────────────────────────────────────────────────────┤
│  Core Runtime Engine                                          │
│  Policy → Validation → Idempotency → Retry → Timeout →       │
│  Metrics → Hooks                                              │
└──────────────────────────────────────────────────────────────┘
LayerResponsibilityKey Files
CoreRuntime engine: policy gate, schema validation, idempotency, retry, metrics, timeout, hookscore/runtime/execution-runtime.ts
PluginsConcrete on-chain operation implementations grouped by featureplugins/*/actions/*.ts
ProvidersAction registration, discovery, and JSON Schema tool manifest generationproviders/action-provider.ts
AdaptersConvert actions into tool formats for each AI frameworkadapters/*/tools.ts

Repository Structure

Directory Layout
agentkit/
├── core/           # Runtime engine (policy, validation, idempotency, retry, metrics, timeout, hooks)
├── plugins/        # 15 feature modules (118 actions)
├── adapters/       # 5 AI framework adapters
├── providers/      # Action registry + tool manifest generation
├── networks/       # GOAT Network chain adapter layer (mainnet / testnet)
├── packages/       # Published packages, including create-goat-agent
├── bin/            # End-user CLI binaries (agentkit-gns, agentkit-giftcard)
├── examples/       # Runnable examples
└── tests/          # Unit + integration tests

How It Fits in GOAT Network Agent Infrastructure

AgentKit sits at the top of the GOAT Network agent protocol stack, integrating the identity and payment layers into a single developer SDK:

GOAT Network Agent Protocol Stack
┌─────────────────────────────────────────┐
│       AgentKit (This SDK)               │  Build & deploy agents
├─────────────────────────────────────────┤
│     x402 (Payment Protocol)             │  Agent-to-agent payments
├─────────────────────────────────────────┤
│   ERC-8004 (Identity & Trust)           │  On-chain agent registry
├─────────────────────────────────────────┤
│       GOAT Network (L2)                 │  Bitcoin-secured settlement
└─────────────────────────────────────────┘
  • ERC-8004 for AgentKit provides the agent-facing registration, metadata, and reputation flow. AgentKit wraps this as the erc8004 plugin with 9 actions.
  • x402 provides HTTP-native payments. Start with the x402 overview, developer quick start, and payment modes before wiring the AgentKit plugins.
  • AgentKit adds wallet management, DeFi operations, cross-chain bridging, Bitcoin integration, and a production-grade runtime on top.

Supported Networks

NetworkChain IDRPC URL
goat-mainnet2345https://rpc.goat.network
goat-testnet48816https://rpc.testnet3.goat.network

AgentKit upstream now maps goat-testnet to chain ID 48816 and the default RPC URL https://rpc.testnet3.goat.network.

Next Steps

Quick Start

Install AgentKit or scaffold a starter project, then run your first action.

Plugins Reference

Browse all 15 plugins and 118 actions.

GOAT Name Service (.goat)

Register and manage .goat human-readable names — on-chain or paid cross-chain via x402.

x402 Giftcard Purchase

Turn-key cross-chain consumer flow — agents pay USDC/USDT on Polygon/Base/Arbitrum/Optimism/BSC/Metis, users receive giftcards off-chain.

ERC-8004 for AgentKit

Register agents, publish metadata, and collect reputation using the AgentKit plugin.

CLI Scaffolding

Generate a ready-to-run project with npm create goat-agent.

x402 Payments

Make and accept payments with the x402 protocol.

Edit on GitHub

Agent Infrastructure

Understand how GOAT Network combines identity, payments, and runtime tooling for autonomous agents.

Quick Start

Install AgentKit into an existing agent or app, or scaffold a starter project, then configure a wallet, runtime, and first action on GOAT Network.

On this page

GOAT Network AgentKitKey FeaturesQuick Start PathsArchitectureRepository StructureHow It Fits in GOAT Network Agent InfrastructureSupported NetworksNext Steps