@ophis/plugin-goat

A GOAT SDK plugin that lets an AI agent swap ERC-20 tokens via Ophis (a CoW Protocol fork): gasless, MEV-protected, intent-based settlement. Orders carry the Ophis partner fee and optional referral attribution for rebates on indexed chains.

Install

npm i @ophis/plugin-goat @goat-sdk/core @goat-sdk/wallet-evm @goat-sdk/wallet-viem

Use

import { getOnChainTools } from '@goat-sdk/adapter-vercel-ai'; // or langchain / mastra / eliza / mcp
import { viem } from '@goat-sdk/wallet-viem';
import { createWalletClient, http } from 'viem';
import { privateKeyToAccount } from 'viem/accounts';
import { base } from 'viem/chains';
import { ophis } from '@ophis/plugin-goat';

const walletClient = createWalletClient({
  account: privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`),
  chain: base,
  transport: http(),
});

const tools = await getOnChainTools({
  wallet: viem(walletClient),
  plugins: [ophis({ referralCode: process.env.OPHIS_REFERRAL_CODE! })],
});

This registers an ophis_swap tool the agent can call:

| Param | | |---|---| | sellToken | ERC-20 address (native ETH not supported — use WETH) | | buyToken | ERC-20 address | | sellAmount | whole units, e.g. "1.5" | | slippageBps | optional, default 50 (0.5%) |

It quotes against the Ophis orderbook, signs the order EIP-712 with the agent's wallet, approves the CoW vault relayer once, submits, and returns the CoW order UID + an explorer URL.

Notes

• ERC-20 → ERC-20 only. Native-ETH sells need CoW eth-flow (a separate path); wrap to WETH first.
• The agent's wallet is the order owner and receiver — funds only ever move through the audited CoW settlement contract, back to the same wallet.
• Discovery chains: Ethereum, Gnosis, Arbitrum, Base, Optimism, Polygon, Avalanche. Version 0.3.7 uses SDK 0.4.5 but does not expand this discovery list to Arc. If the tool is invoked directly with an Arc wallet, its configured referral default applies and only ERC-20 orders are accepted.
• Get a referral code (it carries the rebate): https://docs.ophis.fi/ai-agents

The order-flow core is @ophis/agent-swap; see also @ophis/agentkit-ophis for Coinbase AgentKit.