Skip to content

README.md

Latest commit

 

History

History
141 lines (104 loc) · 4.78 KB

README.md

File metadata and controls

141 lines (104 loc) · 4.78 KB

CDP Agentkit Extension - LangChain Toolkit

CDP integration with LangChain to enable agentic workflows using the core primitives defined in cdp-agentkit-core.

This toolkit contains tools that enable an LLM agent to interact with the Coinbase Developer Platform. The toolkit provides a wrapper around the CDP SDK, allowing agents to perform onchain operations like transfers, trades, and smart contract interactions.

Setup

Prerequisites

Installation

pip install cdp-langchain

Environment Setup

Set the following environment variables:

export CDP_API_KEY_NAME=<your-api-key-name>
export CDP_API_KEY_PRIVATE_KEY=$'<your-private-key>'
export OPENAI_API_KEY=<your-openai-api-key>
export NETWORK_ID=base-sepolia  # Optional: Defaults to base-sepolia

Usage

Basic Setup

from cdp_langchain.agent_toolkits import CdpToolkit
from cdp_langchain.utils import CdpAgentkitWrapper

# Initialize CDP wrapper
cdp = CdpAgentkitWrapper()

# Create toolkit from wrapper
toolkit = CdpToolkit.from_cdp_agentkit_wrapper(cdp)

# Get available tools
tools = toolkit.get_tools()
for tool in tools:
    print(tool.name)

The toolkit provides the following tools:

  1. address_reputation - Retrieve the address's reputation on a given network
  2. deploy_contract - Deploy an arbitrary contract using the Solidity compiler
  3. deploy_nft - Deploy new NFT contracts
  4. deploy_token - Deploy ERC-20 token contracts
  5. get_balance - Get balance for specific assets
  6. get_balance_nft - Get balance for specific NFTs (ERC-721)
  7. get_wallet_details - Get details about the MPC Wallet
  8. mint_nft - Mint NFTs from existing contracts
  9. morpho_deposit - Deposit into a morpho vault
  10. morpho_withdraw - Withdraw from a morpho vault
  11. pyth_fetch_price - Fetch the price of a given price feed from Pyth Network
  12. pyth_fetch_price_feed_id - Fetch the price feed ID for a given token symbol from Pyth Network
  13. register_basename - Register a basename for the wallet
  14. request_faucet_funds - Request test tokens from faucet
  15. superfluid_create_flow - Create a flow using Superfluid
  16. superfluid_update_flow - Update a flow using Superfluid
  17. superfluid_delete_flow - Delete a flow using Superfluid
  18. trade - Trade assets (Mainnet only)
  19. transfer - Transfer assets between addresses
  20. transfer_nft - Transfer an NFT (ERC-721)
  21. wow_buy_token - Buy Zora Wow ERC20 memecoin with ETH
  22. wow_create_token - Deploy a token using Zora's Wow Launcher (Bonding Curve)
  23. wow_sell_token - Sell Zora Wow ERC20 memecoin for ETH
  24. wrap_eth - Wrap ETH to WETH

Using with an Agent

from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

# Initialize LLM
llm = ChatOpenAI(model="gpt-4o-mini")

# Get tools and create agent
tools = toolkit.get_tools()
agent_executor = create_react_agent(llm, tools)

# Example usage
events = agent_executor.stream(
    {"messages": [("user", "Send 0.005 ETH to john2879.base.eth")]},
    stream_mode="values"
)

for event in events:
    event["messages"][-1].pretty_print()

Expected output:

Transferred 0.005 of eth to john2879.base.eth.
Transaction hash for the transfer: 0x78c7c2878659a0de216d0764fc87eff0d38b47f3315fa02ba493a83d8e782d1e
Transaction link for the transfer: https://sepolia.basescan.org/tx/0x78c7c2878659a0de216d0764fc87eff0d38b47f3315fa02ba493a83d8e782d1

CDP Toolkit Specific Features

Wallet Management

The toolkit maintains an MPC wallet that persists between sessions:

# Export wallet data
wallet_data = cdp.export_wallet()

# Import wallet data
values = {"cdp_wallet_data": wallet_data}
cdp = CdpAgentkitWrapper(**values)

Network Support

The toolkit supports multiple networks.

Gasless Transactions

The following operations support gasless transactions on Base Mainnet:

  • USDC transfers
  • EURC transfers
  • cbBTC transfers

Examples

Check out ../examples for inspiration and help getting started!

  • Chatbot Python: Simple example of a Python Chatbot that can perform complex onchain interactions, using OpenAI.

Contributing

See CONTRIBUTING.md for detailed setup instructions and contribution guidelines.