Plugins Reference

AgentKit ships 13 plugins containing 95 actions that cover wallet operations, DeFi, bridging, payments, identity, governance, and cross-chain messaging. Each plugin is a collection of related ActionDefinition objects that you register with an ActionProvider.

Plugin Overview

Core On-Chain Operations

Merchant and Identity

Protocols and Assets

wallet

The wallet plugin provides fundamental EVM wallet operations. Most actions take a WalletProvider or WalletReadAdapter instance.

Token Symbol Resolution

The resolveTokenAction uses GOAT Network's built-in token registry. You can reference tokens by symbol instead of address:

// Known token symbols:
// WGBTC, GOAT, BRIDGE, BITCOIN
// OKU_SWAP_ROUTER, OKU_QUOTER, OKU_POSITION_MANAGER, OKU_FACTORY
// LZ_ENDPOINT

Registration Example

import {
  walletBalanceAction,
  getDetailsAction,
  transferNativeAction,
  transferErc20Action,
  approveErc20Action,
  contractReadAction,
  contractWriteAction,
  deployContractAction,
  resolveTokenAction,
  getAllowanceAction,
  NoopWalletReadAdapter,
} from '@goatnetwork/agentkit/plugins';

const walletRead = new NoopWalletReadAdapter(); // Use EvmWalletReadAdapter for production

provider.register(walletBalanceAction(walletRead));
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());

dex

The DEX plugin wraps OKU (Uniswap V3 deployment on GOAT Network) for decentralized exchange operations.

Contract Addresses

bridge

The Bridge plugin interacts with GOAT Network's native Bridge.sol contract for the full bridge lifecycle.

x402

The x402 plugin implements the payer side of the x402 agent payment protocol. See the Payments guide for full details.

x402-merchant

The x402-merchant plugin provides 30 actions for complete merchant portal management. Actions use the HttpMerchantPortalClient HTTP adapter and support per-request token isolation via ActionContext.accessToken.

Action Categories

Authentication (4 actions): register, register with invite, login, refresh token

Dashboard (1 action): stats overview

Profile (2 actions): get profile, update profile

Orders (2 actions): list orders, get order details

Balance (3 actions): get balance, list transactions, fees config

Addresses (3 actions): list, add, remove settlement addresses

Callback Contracts (4 actions): list, submit, remove, cancel submission

API Keys (2 actions): get keys, rotate keys

Webhooks (4 actions): list, create, update, delete webhooks

Invite Codes (3 actions): list, create, revoke

Audit Logs (1 action): list audit logs

Supported Tokens (1 action): list supported tokens

erc8004

The ERC-8004 plugin implements on-chain agent identity and reputation. See the AgentKit ERC-8004 guide for the agent-focused integration flow.

Contract Addresses

bitvm2

The BitVM2 plugin provides BTC bridge operations and staking via the BitVM2 protocol.

layerzero

Cross-chain messaging via LayerZero V2 OFT (Omnichain Fungible Token) protocol.

erc721

Standard NFT operations.

wgbtc

Wrapped GBTC (WGBTC) operations.

goat-token

GOAT governance token operations.

faucet

Testnet faucet for requesting test tokens.

bitcoin

On-chain Bitcoin light client queries.

Risk Levels

Every action declares a risk level that the Policy Engine uses to gate execution:

Actions with requiresConfirmation: true always need explicit confirmation regardless of the policy's maxRiskWithoutConfirm setting.