Add 8004 action provider (#930)

* add 8004 action provider

* use agent0 sdk for search

* bump agent0 sdk

* use agent0 sdk for onchain txs

* improve search

* bump agent0

Author: phdargen

typescript/.changeset/upset-parrots-visit.md

@@ -0,0 +1,5 @@
+---
+"@coinbase/agentkit": patch
+---
+
+Added erc8004 action providers

typescript/agentkit/README.md

@@ -368,6 +368,47 @@ const agent = createAgent({
 </table>
 </details>
 <details>
+<summary><strong>ERC-8004</strong></summary>
+<table width="100%">
+<tr>
+    <td width="200"><code>append_response</code></td>
+    <td width="768">Appends an off-chain response URI to a reputation feedback entry (ERC-8004 Reputation Registry).</td>
+</tr>
+<tr>
+    <td width="200"><code>get_agent_feedback</code></td>
+    <td width="768">Lists feedback for an agent with optional filters (reviewers, value range, tags).</td>
+</tr>
+<tr>
+    <td width="200"><code>get_agent_info</code></td>
+    <td width="768">Returns identity, endpoints, capabilities, reputation summary, and status for a registered agent.</td>
+</tr>
+<tr>
+    <td width="200"><code>get_owned_agents</code></td>
+    <td width="768">Lists agents owned by a wallet address (defaults to the connected wallet).</td>
+</tr>
+<tr>
+    <td width="200"><code>give_feedback</code></td>
+    <td width="768">Submits on-chain feedback (and optional IPFS payload) for an agent; cannot be used on your own agent.</td>
+</tr>
+<tr>
+    <td width="200"><code>register_agent</code></td>
+    <td width="768">Registers a new agent on the ERC-8004 Identity Registry (mint NFT and set registration URI).</td>
+</tr>
+<tr>
+    <td width="200"><code>revoke_feedback</code></td>
+    <td width="768">Revokes feedback previously submitted by the connected wallet.</td>
+</tr>
+<tr>
+    <td width="200"><code>search_agents</code></td>
+    <td width="768">Discovers agents via semantic search, capability/status filters, reputation bounds, sort, and pagination.</td>
+</tr>
+<tr>
+    <td width="200"><code>update_agent_metadata</code></td>
+    <td width="768">Updates agent metadata, endpoints (MCP/A2A), trust models, taxonomies, and status flags.</td>
+</tr>
+</table>
+</details>
+<details>
 <summary><strong>ERC20</strong></summary>
 <table width="100%">
 <tr>

typescript/agentkit/package.json

@@ -60,6 +60,7 @@
     "@zerodev/sdk": "^5.4.28",
     "@zoralabs/coins-sdk": "0.2.8",
     "@zoralabs/protocol-deployments": "0.6.1",
+    "agent0-sdk": "^1.7.1",
     "bs58": "^4.0.1",
     "canonicalize": "^2.1.0",
     "clanker-sdk": "^4.1.18",

typescript/agentkit/src/action-providers/across/acrossActionProvider.ts

@@ -127,7 +127,7 @@ export class AcrossActionProvider extends ActionProvider<EvmWalletProvider> {
         throw new Error(`No input tokens available on chain ${originChain.id}`);
       }
       const tokenInfo = inputTokens.find(
-        token => token.symbol.toUpperCase() === (args.inputTokenSymbol ?? "ETH").toUpperCase(),
+        token => token.symbol.toUpperCase() === args.inputTokenSymbol.toUpperCase(),
       );
       if (!tokenInfo) {
         throw new Error(
@@ -141,7 +141,7 @@ export class AcrossActionProvider extends ActionProvider<EvmWalletProvider> {
       const inputAmount = parseUnits(args.amount, decimals);
 
       // Check balance
-      const isNative = (args.inputTokenSymbol ?? "ETH").toUpperCase() === "ETH";
+      const isNative = args.inputTokenSymbol.toUpperCase() === "ETH";
       if (isNative) {
         // Check native ETH balance
         const ethBalance = await walletProvider.getBalance();
@@ -212,7 +212,7 @@ export class AcrossActionProvider extends ActionProvider<EvmWalletProvider> {
         ((Number(formattedInfo.inputAmount) - Number(formattedInfo.outputAmount)) /
           Number(formattedInfo.inputAmount)) *
         100;
-      if (actualSlippagePercentage > (args.maxSplippage ?? 1.5)) {
+      if (actualSlippagePercentage > args.maxSplippage) {
         throw new Error(
           `Output amount has high slippage of ${actualSlippagePercentage.toFixed(2)}%, which exceeds the maximum allowed slippage of ${args.maxSplippage}%. ` +
             `Input: ${formattedInfo.inputAmount} ${args.inputTokenSymbol}, Output: ${formattedInfo.outputAmount} ${args.inputTokenSymbol}`,

typescript/agentkit/src/action-providers/across/schemas.ts

@@ -24,7 +24,7 @@ export const BridgeTokenSchema = z
       .number()
       .nullable()
       .transform(val => val ?? 1.5)
-      .describe("The maximum slippage percentage (e.g. 10 for 10%)"),
+      .describe("The maximum slippage percentage (e.g. 10 for 10%), defaults to 1.5%"),
   })
   .describe("Instructions for bridging tokens across chains using Across Protocol");
 

typescript/agentkit/src/action-providers/erc8004/README.md

@@ -0,0 +1,72 @@
+# ERC-8004 Action Providers
+
+This directory contains **ERC8004IdentityActionProvider** and **ERC8004ReputationActionProvider**, which expose actions for the [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) trustless agent registries (identity and reputation) on supported EVM networks. Implementation uses the Agent0 SDK (`getAgent0SDK`).
+
+## Directory Structure
+
+```
+erc8004/
+├── erc8004IdentityActionProvider.ts      # Identity registry: register, metadata, discovery
+├── erc8004IdentityActionProvider.test.ts
+├── erc8004ReputationActionProvider.ts    # Reputation registry: feedback, responses, queries
+├── erc8004ReputationActionProvider.test.ts
+├── identitySchemas.ts                    # Zod schemas for identity actions
+├── reputationSchemas.ts                  # Zod schemas for reputation actions
+├── constants.ts                          # Supported network IDs and helpers
+├── utils.ts                              # Agent0 SDK wiring
+├── index.ts                              # Public exports
+└── README.md                             # This file
+```
+
+## Providers
+
+Register both providers on an `EvmWalletProvider` when you want full ERC-8004 coverage:
+
+```typescript
+import {
+  erc8004IdentityActionProvider,
+  erc8004ReputationActionProvider,
+} from "@coinbase/agentkit";
+
+const identity = erc8004IdentityActionProvider({ pinataJwt: process.env.PINATA_JWT });
+const reputation = erc8004ReputationActionProvider({ pinataJwt: process.env.PINATA_JWT });
+```
+
+Optional `pinataJwt` enables IPFS uploads for richer metadata and off-chain feedback payloads (comments, A2A task fields).
+
+## Identity actions (`erc8004_identity`)
+
+- `register_agent`: Mint an agent NFT on the Identity Registry and set registration JSON / URI.
+
+- `update_agent_metadata`: Patch agent configuration (name, description, image, MCP/A2A endpoints, ENS, active/x402 flags, trust models, OASF taxonomies, custom metadata).
+
+- `get_owned_agents`: List agents owned by an address (defaults to the connected wallet).
+
+- `search_agents`: Discover agents via semantic keyword search, filters (capabilities, status, reputation), sort, and pagination.
+
+- `get_agent_info`: Fetch full agent profile (identity, endpoints, capabilities, reputation summary, status).
+
+## Reputation actions (`erc8004_reputation`)
+
+- `give_feedback`: Submit scored feedback (tags, endpoint, optional comment / A2A context); core data on-chain, optional IPFS file when JWT is set. Callers cannot rate their own agent.
+
+- `revoke_feedback`: Revoke feedback previously sent from the connected wallet.
+
+- `append_response`: Append an off-chain response URI to a feedback entry (agent owners, aggregators, auditors, etc., per spec).
+
+- `get_agent_feedback`: Read feedback for an agent with optional filters (reviewers, value range, tags).
+
+## Adding New Actions
+
+1. Add or extend Zod schemas in `identitySchemas.ts` or `reputationSchemas.ts`. See [Defining the input schema](https://github.com/coinbase/agentkit/blob/main/CONTRIBUTING-TYPESCRIPT.md#defining-the-input-schema).
+2. Implement the action on `ERC8004IdentityActionProvider` or `ERC8004ReputationActionProvider` with `@CreateAction`.
+3. Cover behavior in the matching `*.test.ts` file.
+
+## Network Support
+
+Supported `networkId` values are defined in `constants.ts` (e.g. Ethereum and Base mainnet/sepolia, Polygon mainnet). Other networks are rejected by `supportsNetwork`.
+
+## Notes
+
+- Agent IDs may be passed as a local token id (e.g. `"123"`) or as `"chainId:tokenId"` (e.g. `"84532:123"`).
+- For broader setup and examples, see the AgentKit [8004 guide](../../../../8004.md) in this repo.

typescript/agentkit/src/action-providers/erc8004/constants.ts

@@ -0,0 +1,47 @@
+import { NETWORK_ID_TO_CHAIN_ID, Network } from "../../network";
+
+// Supported network IDs for ERC-8004 - must match agent0 SDK (contracts.ts DEFAULT_REGISTRIES)
+export const SUPPORTED_NETWORK_IDS = [
+  "ethereum-mainnet", // 1
+  "ethereum-sepolia", // 11155111
+  "base-mainnet", // 8453
+  "base-sepolia", // 84532
+  "polygon-mainnet", // 137
+] as const;
+
+export type SupportedNetworkId = (typeof SUPPORTED_NETWORK_IDS)[number];
+
+/**
+ * Gets the chain ID from a network object
+ *
+ * @param network - The network object
+ * @returns The chain ID as a number
+ * @throws Error if network is not supported
+ */
+export function getChainIdFromNetwork(network: Network): number {
+  const networkId = network.networkId;
+  if (!networkId) {
+    throw new Error("Network ID is not defined");
+  }
+
+  const chainIdStr = NETWORK_ID_TO_CHAIN_ID[networkId];
+  if (!chainIdStr) {
+    throw new Error(
+      `Network ${networkId} is not supported. Supported networks: ${SUPPORTED_NETWORK_IDS.join(", ")}`,
+    );
+  }
+
+  return parseInt(chainIdStr, 10);
+}
+
+/**
+ * Checks if a network is supported for ERC-8004
+ *
+ * @param network - The network to check
+ * @returns True if the network is supported
+ */
+export function isNetworkSupported(network: Network): boolean {
+  const networkId = network.networkId;
+  if (!networkId) return false;
+  return SUPPORTED_NETWORK_IDS.includes(networkId as SupportedNetworkId);
+}