Feat/opensea Integrate Opensea Actions to Agentkit by Elkhan-Isayev · Pull Request #325 · coinbase/agentkit

Elkhan-Isayev · 2025-02-09T16:42:16Z

OpenSea Action Provider for AgentKit

🚀 Overview
We are enhancing Coinbase's chat system with seamless OpenSea integration, enabling users to effortlessly browse their NFTs, select assets, and list them—all within the chat interface. This integration makes NFT trading more intuitive, accessible, and streamlined.

File Structure

agentkit/src/action-providers/opensea/
├── openSeaActionProvider.ts        # Main provider implementation
├── openSeaActionProvider.test.ts   # Test suite
├── schemas.ts                     # Schema for listing an NFT on OpenSea
└── index.ts                        # Public exports

Core Features

List an NFT Action
@CreateAction({ name: "list_nft" })
This tool allows users to list an NFT on OpenSea. It takes the token ID, contract address, and listing price as input.
Fetch NFTs of a Specific Wallet Address
@CreateAction({ name: "get_nfts_by_account" })
This tool fetches all NFTs associated with a given wallet address.

Technical Details

viemwalletprovider: Handles wallet interaction
openseasdk: Provides marketplace interaction
sepolia: Facilitates interaction over the testnet

This integration ensures that AI agents can interact with OpenSea via a secure and type-safe interface, simplifying the process for users and enabling efficient NFT trading within the chat system.

cb-heimdall · 2025-02-09T16:42:22Z

🟡 Heimdall Review Status

Requirement Status More Info

Reviews

🟡 -1/1

Denominator calculation

Show calculation

1 if user is bot 0

1 if user is external 0

2 if repo is sensitive 0

From .codeflow.yml 1

Additional review requirements

Show calculation

Max	0

0

From CODEOWNERS 0

Global minimum 0

Max 1

1

1 if commit is unverified 1

Sum 2

Elkhan-Isayev · 2025-02-09T17:32:15Z

OpenSea Action Provider for AgentKit

🚀 Overview
We are enhancing Coinbase's chat system with seamless OpenSea integration, enabling users to effortlessly browse their NFTs, select assets, and list them—all within the chat interface. This integration makes NFT trading more intuitive, accessible, and streamlined.

File Structure

agentkit/src/action-providers/opensea/
├── openSeaActionProvider.ts        # Main provider implementation
├── openSeaActionProvider.test.ts   # Test suite
├── schemas.ts                     # Schema for listing an NFT on OpenSea
└── index.ts                        # Public exports

Core Features

List an NFT Action
@CreateAction({ name: "list_nft" })
This tool allows users to list an NFT on OpenSea. It takes the token ID, contract address, and listing price as input.
Fetch NFTs of a Specific Wallet Address
@CreateAction({ name: "get_nfts_by_account" })
This tool fetches all NFTs associated with a given wallet address.

Technical Details

viemwalletprovider: Handles wallet interaction
openseasdk: Provides marketplace interaction
sepolia: Facilitates interaction over the testnet

This integration ensures that AI agents can interact with OpenSea via a secure and type-safe interface, simplifying the process for users and enabling efficient NFT trading within the chat system.

Elkhan-Isayev · 2025-02-09T19:55:33Z

Issue ticked id: #300

0xRAG

Thanks for the contribution @Elkhan-Isayev, this is an exciting addition! Please review and address my feedback. Also, it would be great if you could add screenshots of the action working as expected.

0xRAG · 2025-02-11T00:23:43Z

    "typescript": "^5.4.5"
+  },
+  "dependencies": {
+    "opensea-js": "^7.1.15"


Please move this to typescript/agentkit/package.json

0xRAG · 2025-02-11T00:24:08Z

+import { z } from "zod";
+import { ActionProvider } from "../actionProvider";
+import { CreateAction } from "../actionDecorator";
+import { OpenSeaSDK, Chain } from "opensea-js"; // Assuming an OpenSea SDK is available


Nit: Please remove this comment

0xRAG · 2025-02-11T00:26:12Z

+ */
+export class OpenSeaActionProvider extends ActionProvider {
+  private readonly client: OpenSeaSDK;
+  private readonly walletProvider: ViemWalletProvider;


I suggest extending ViemWalletProvider which will configure a PublicClient / WalletClient. Then you'll also be able to remove the walletPrivateKey config parameter

0xRAG · 2025-02-11T00:26:22Z

+ */
+export interface OpenSeaActionProviderConfig {
+  apiKey?: string;
+  walletPrivateKey: string;


See comment below about removing this

0xRAG · 2025-02-11T00:26:30Z

+    /*
+     * if (!config.apiKey) {
+     *   throw new Error("OPENSEA_API_KEY is not configured.");
+     * }
+     */


Please remove

0xRAG · 2025-02-11T00:27:46Z

+  })
+  async listNFT(args: z.infer<typeof OpenSeaListNFTSchema>): Promise<string> {
+    try {
+      const expirationTime = Math.round(Date.now() / 1000 + 60 * 60 * 24);


Should the expiration be user-configurable?

0xRAG · 2025-02-11T00:28:00Z

+
+      return `Successfully listed NFT:\n${JSON.stringify(response)}`;
+    } catch (error) {
+      console.log("response: ", error);


Please remove

0xRAG · 2025-02-11T00:29:20Z

+    "OPENAI_API_KEY",
+    "CDP_API_KEY_NAME",
+    "CDP_API_KEY_PRIVATE_KEY",
+    "WALLET_PRIVATE_KEY",


Please remove, see comment in openSeaActionProvider.ts

0xRAG · 2025-02-11T00:29:50Z

      apiKeyPrivateKey: process.env.CDP_API_KEY_PRIVATE_KEY?.replace(/\\n/g, "\n"),
      cdpWalletData: walletDataStr || undefined,
-      networkId: process.env.NETWORK_ID || "base-sepolia",
+      networkId: process.env.NETWORK_ID || "ethereum-sepolia",


Please revert – fallback value should remain base-sepolia

0xRAG · 2025-02-11T00:30:21Z

+        openSeaActionProvider({
+          walletPrivateKey: process.env.WALLET_PRIVATE_KEY!,
+        }),


Should an apiKey be passed in here?

phdargen · 2025-07-25T06:50:15Z

Has been implemented in #261, can be closed @CarsonRoscoe together with issue #300

mahammadZeynalov and others added 4 commits February 8, 2025 18:10

add setup for integration with opensea

8964142

fix import

be6b941

bug fix

dbafaa6

feat/opensea: init unit tests

e2d3522

feat/opensea: init unit tests

c4b0e28

Elkhan-Isayev changed the title ~~Feat/opensea~~ Feat/opensea Integrate Opensea Actions to Agentkit Feb 9, 2025

0xRAG added action provider New action provider needs review PR / issue needs review apple labels Feb 10, 2025

0xRAG requested changes Feb 11, 2025

View reviewed changes

0xRAG added changes requested PR / Issue has changes requested typescript and removed needs review PR / issue needs review labels Feb 11, 2025

This was referenced Mar 3, 2025

feat: opensea action provider #505

Closed

feat: add action to list nfts on opensea (ts) #261

Merged

CarsonRoscoe closed this Jul 25, 2025

Conversation

Elkhan-Isayev commented Feb 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

OpenSea Action Provider for AgentKit

File Structure

Core Features

Technical Details

Uh oh!

cb-heimdall commented Feb 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🟡 Heimdall Review Status

Uh oh!

Elkhan-Isayev commented Feb 9, 2025

OpenSea Action Provider for AgentKit

File Structure

Core Features

Technical Details

Uh oh!

Elkhan-Isayev commented Feb 9, 2025

Uh oh!

0xRAG left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

phdargen commented Jul 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Milestone

Development

Uh oh!

5 participants

Elkhan-Isayev commented Feb 9, 2025 •

edited

Loading

cb-heimdall commented Feb 9, 2025 •

edited

Loading

phdargen commented Jul 25, 2025 •

edited

Loading