feat: upgrade cdp-sdk (#777)

Author: 0xRAG

python/coinbase-agentkit/README.md

@@ -7,31 +7,36 @@ AgentKit is a framework for easily enabling AI agents to take actions onchain. I
 - [Getting Started](#getting-started)
 - [Installation](#installation)
 - [Usage](#usage)
-    - [Create an AgentKit instance](#create-an-agentkit-instance)
-    - [Create an AgentKit instance with a specified wallet provider](#create-an-agentkit-instance-with-a-specified-wallet-provider)
-    - [Create an AgentKit instance with specified action providers](#create-an-agentkit-instance-with-specified-action-providers)
-    - [Use with a framework extension (e.g., LangChain + OpenAI)](#use-with-a-framework-extension)
+  - [Create an AgentKit instance](#create-an-agentkit-instance)
+  - [Create an AgentKit instance with a specified wallet provider](#create-an-agentkit-instance-with-a-specified-wallet-provider)
+  - [Create an AgentKit instance with specified action providers](#create-an-agentkit-instance-with-specified-action-providers)
+  - [Use with a framework extension (e.g., LangChain + OpenAI)](#use-with-a-framework-extension)
 - [Creating an Action Provider](#creating-an-action-provider)
-    - [Adding Actions to your Action Provider](#adding-actions-to-your-action-provider)
-    - [Adding Actions that use a Wallet Provider](#adding-actions-that-use-a-wallet-provider)
-    - [Adding an Action Provider to your AgentKit instance](#adding-an-action-provider-to-your-agentkit-instance)
+  - [Adding Actions to your Action Provider](#adding-actions-to-your-action-provider)
+  - [Adding Actions that use a Wallet Provider](#adding-actions-that-use-a-wallet-provider)
+  - [Adding an Action Provider to your AgentKit instance](#adding-an-action-provider-to-your-agentkit-instance)
 - [Action Providers](#action-providers)
 - [Wallet Providers](#wallet-providers)
-    - [CdpEvmServerWalletProvider](#cdpevmserverwalletprovider)
-        - [Network Configuration](#network-configuration)
-        - [Configuring from an existing CDP API Wallet](#configuring-from-an-existing-cdp-api-wallet)
-        - [Creating a new wallet](#creating-a-new-wallet)
-        - [Example Usage with AgentKit](#example-usage-with-agentkit)
-    - [CdpEvmSmartWalletProvider](#cdpevmsmartwalletprovider)
-        - [Network Configuration](#network-configuration)
-        - [Configuring with a Private Key Owner](#configuring-with-a-private-key-owner)
-        - [Configuring with a Server Wallet Owner](#configuring-with-a-server-wallet-owner)
-        - [Creating a New Smart Wallet](#creating-a-new-smart-wallet)
-        - [Gasless Transactions with Paymaster](#gasless-transactions-with-paymaster)
-        - [Example Usage with AgentKit](#example-usage-with-agentkit)
-    - [EthAccountWalletProvider](#ethaccountwalletprovider)
-        - [Configuring gas parameters](#configuring-ethaccountwalletprovider-gas-parameters)
-    - [SmartWalletProvider](#smartwalletprovider)
+  - [CdpEvmServerWalletProvider](#cdpevmserverwalletprovider)
+    - [Network Configuration](#network-configuration)
+    - [Configuring from an existing CDP API Wallet](#configuring-from-an-existing-cdp-api-wallet)
+    - [Creating a new wallet](#creating-a-new-wallet)
+    - [Example Usage with AgentKit](#example-usage-with-agentkit)
+  - [CdpEvmSmartWalletProvider](#cdpevmsmartwalletprovider)
+    - [Network Configuration](#network-configuration)
+    - [Configuring with a Private Key Owner](#configuring-with-a-private-key-owner)
+    - [Configuring with a Server Wallet Owner](#configuring-with-a-server-wallet-owner)
+    - [Creating a New Smart Wallet](#creating-a-new-smart-wallet)
+    - [Gasless Transactions with Paymaster](#gasless-transactions-with-paymaster)
+    - [Example Usage with AgentKit](#example-usage-with-agentkit)
+  - [EthAccountWalletProvider](#ethaccountwalletprovider)
+    - [Configuring gas parameters](#configuring-ethaccountwalletprovider-gas-parameters)
+    - [Configuring `EthAccountWalletProvider` rpc url](#configuring-ethaccountwalletprovider-rpc-url)
+  - [SmartWalletProvider](#smartwalletprovider)
+  - [CdpSolanaWalletProvider](#cdpsolanawalletprovider)
+    - [Configuring with API credentials](#configuring-with-api-credentials)
+    - [Using environment variables](#using-environment-variables)
+    - [Example Usage with AgentKit](#example-usage-with-agentkit)
 - [Contributing](#contributing)
 
 ## Getting Started
@@ -888,9 +893,9 @@ import os
 from eth_account import Account
 
 from coinbase_agentkit import (
-    AgentKit, 
-    AgentKitConfig, 
-    SmartWalletProvider, 
+    AgentKit,
+    AgentKitConfig,
+    SmartWalletProvider,
     SmartWalletProviderConfig
 )
 
@@ -916,6 +921,112 @@ agent_kit = AgentKit(AgentKitConfig(
 ))
 ```
 
+### CdpSolanaWalletProvider
+
+The `CdpSolanaWalletProvider` is a wallet provider that uses the Coinbase Developer Platform (CDP) API for Solana networks. It supports SOL transfers and message signing on Solana mainnet, devnet, and testnet.
+
+#### Network Configuration
+
+The `CdpSolanaWalletProvider` can be configured to use different Solana networks by setting the `network_id` parameter:
+
+- `solana-mainnet` - Solana Mainnet
+- `solana-devnet` - Solana Devnet (default)
+- `solana-testnet` - Solana Testnet
+
+```python
+from coinbase_agentkit import CdpSolanaWalletProvider, CdpSolanaWalletProviderConfig
+
+wallet_provider = CdpSolanaWalletProvider(CdpSolanaWalletProviderConfig(
+    api_key_id="CDP API KEY ID",
+    api_key_secret="CDP API KEY SECRET",
+    wallet_secret="CDP WALLET SECRET",
+    network_id="solana-devnet",
+))
+```
+
+#### Configuring with API credentials
+
+You can configure the provider by passing CDP API credentials directly:
+
+```python
+from coinbase_agentkit import CdpSolanaWalletProvider, CdpSolanaWalletProviderConfig
+
+wallet_provider = CdpSolanaWalletProvider(CdpSolanaWalletProviderConfig(
+    api_key_id="CDP API KEY ID",
+    api_key_secret="CDP API KEY SECRET",
+    wallet_secret="CDP WALLET SECRET",
+    network_id="solana-mainnet",
+))
+```
+
+#### Using environment variables
+
+The provider can also read configuration from environment variables:
+
+```python
+from coinbase_agentkit import CdpSolanaWalletProvider, CdpSolanaWalletProviderConfig
+
+# Set environment variables:
+# CDP_API_KEY_ID="your-api-key-id"
+# CDP_API_KEY_SECRET="your-api-key-secret"
+# CDP_WALLET_SECRET="your-wallet-secret"
+# NETWORK_ID="solana-devnet"
+
+wallet_provider = CdpSolanaWalletProvider(CdpSolanaWalletProviderConfig())
+```
+
+#### Using an existing wallet
+
+If you have an existing CDP Solana wallet, you can specify its address:
+
+```python
+from coinbase_agentkit import CdpSolanaWalletProvider, CdpSolanaWalletProviderConfig
+
+wallet_provider = CdpSolanaWalletProvider(CdpSolanaWalletProviderConfig(
+    api_key_id="CDP API KEY ID",
+    api_key_secret="CDP API KEY SECRET",
+    wallet_secret="CDP WALLET SECRET",
+    address="YOUR_EXISTING_SOLANA_ADDRESS",
+    network_id="solana-mainnet",
+))
+```
+
+#### Example Usage with AgentKit
+
+Here's a complete example of using `CdpSolanaWalletProvider` with AgentKit:
+
+```python
+from coinbase_agentkit import (
+    AgentKit,
+    AgentKitConfig,
+    CdpSolanaWalletProvider,
+    CdpSolanaWalletProviderConfig,
+    wallet_action_provider,
+)
+
+# Initialize the wallet provider
+wallet_provider = CdpSolanaWalletProvider(CdpSolanaWalletProviderConfig(
+    api_key_id="CDP API KEY ID",
+    api_key_secret="CDP API KEY SECRET",
+    wallet_secret="CDP WALLET SECRET",
+    network_id="solana-devnet",
+))
+
+# Create AgentKit instance with wallet and action providers
+agentkit = AgentKit(AgentKitConfig(
+    wallet_provider=wallet_provider,
+    action_providers=[
+        wallet_action_provider(),  # Provides basic wallet operations for Solana
+    ],
+))
+
+# The wallet provider supports:
+# - Getting wallet address: wallet_provider.get_address()
+# - Getting SOL balance: wallet_provider.get_balance()
+# - Transferring SOL: wallet_provider.native_transfer(to, amount)
+# - Signing messages: wallet_provider.sign_message(message)
+```
+
 ## Contributing
 
 See [CONTRIBUTING.md](https://github.com/coinbase/agentkit/blob/main/CONTRIBUTING.md) for more information.

python/coinbase-agentkit/changelog.d/777.feature.md

@@ -0,0 +1 @@
+Upgraded cdp-sdk to latest and added CdpSolanaWalletProvider

python/coinbase-agentkit/coinbase_agentkit/__init__.py

@@ -29,6 +29,8 @@
     CdpEvmServerWalletProviderConfig,
     CdpEvmSmartWalletProvider,
     CdpEvmSmartWalletProviderConfig,
+    CdpSolanaWalletProvider,
+    CdpSolanaWalletProviderConfig,
     EthAccountWalletProvider,
     EthAccountWalletProviderConfig,
     EvmWalletProvider,
@@ -47,6 +49,8 @@
     "CdpEvmServerWalletProviderConfig",
     "CdpEvmSmartWalletProvider",
     "CdpEvmSmartWalletProviderConfig",
+    "CdpSolanaWalletProvider",
+    "CdpSolanaWalletProviderConfig",
     "EvmWalletProvider",
     "EthAccountWalletProvider",
     "EthAccountWalletProviderConfig",

python/coinbase-agentkit/coinbase_agentkit/action_providers/cdp/README.md

@@ -27,7 +27,10 @@ tests/action_providers/cdp/
 - `address_reputation`: Returns onchain activity metrics
 - `request_faucet_funds`: Request testnet funds from CDP faucet
 
-  - Available only on Base Sepolia
+  - Available on Base Sepolia, Ethereum Sepolia, and Solana Devnet
+  - Supported assets:
+    - Base Sepolia / Ethereum Sepolia: ETH (default), USDC, EURC, CBBTC
+    - Solana Devnet: SOL (default), USDC
 
 ### CDP Wallet Actions
 

python/coinbase-agentkit/coinbase_agentkit/action_providers/cdp/cdp_api_action_provider.py

@@ -9,7 +9,7 @@
 from ...wallet_providers.evm_wallet_provider import EvmWalletProvider
 from ..action_decorator import create_action
 from ..action_provider import ActionProvider
-from .schemas import RequestFaucetFundsSchema
+from .schemas import RequestFaucetFundsSchema, SwapSchema
 
 TWalletProvider = TypeVar("TWalletProvider", bound=EvmWalletProvider)
 
@@ -116,6 +116,58 @@ async def _request_faucet():
         else:
             return "Error: Faucet is only supported on Ethereum and Solana protocol families."
 
+    @create_action(
+        name="swap",
+        description="""
+This tool can be used to swap tokens on EVM networks (Ethereum and Base).
+It takes the from asset ID, to asset ID, amount, and network as input.
+Only supported on mainnet EVM networks.
+Amount should be specified in the smallest denomination (e.g., wei for ETH).""",
+        schema=SwapSchema,
+    )
+    def swap(self, wallet_provider: TWalletProvider, args: dict[str, Any]) -> str:
+        """Swap tokens using CDP API.
+
+        Args:
+            wallet_provider: The wallet provider instance.
+            args: Input arguments for the action.
+
+        Returns:
+            str: A message containing the action response or error details.
+
+        """
+        validated_args = SwapSchema(**args)
+        network = wallet_provider.get_network()
+
+        if network.protocol_family != "evm":
+            return "Error: Swap is only supported on EVM networks."
+
+        if "sepolia" in network.network_id or "testnet" in network.network_id:
+            return "Error: Swap is only supported on mainnet networks."
+
+        client = self._get_client(wallet_provider)
+        try:
+            loop = asyncio.get_event_loop()
+        except RuntimeError:
+            loop = asyncio.new_event_loop()
+            asyncio.set_event_loop(loop)
+
+        async def _swap():
+            async with client as cdp:
+                return await cdp.evm.swap(
+                    address=wallet_provider.get_address(),
+                    amount=validated_args.amount,
+                    from_asset_id=validated_args.from_asset_id,
+                    to_asset_id=validated_args.to_asset_id,
+                    network=validated_args.network,
+                )
+
+        try:
+            swap_result = loop.run_until_complete(_swap())
+            return f"Successfully swapped {validated_args.amount} {validated_args.from_asset_id} to {validated_args.to_asset_id}. Transaction hash: {swap_result.transaction_hash}"
+        except Exception as e:
+            return f"Error performing swap: {e!s}"
+
     def supports_network(self, network: Network) -> bool:
         """Check if the network is supported by this action provider.
 
@@ -127,7 +179,13 @@ def supports_network(self, network: Network) -> bool:
 
         """
         if network.protocol_family == "evm":
-            return network.network_id in ["base-sepolia", "ethereum-sepolia"]
+            # Support both testnet (for faucet) and mainnet (for swap)
+            return network.network_id in [
+                "base-sepolia",
+                "ethereum-sepolia",  # testnet for faucet
+                "base-mainnet",
+                "ethereum-mainnet",  # mainnet for swap
+            ]
         elif network.protocol_family == "svm":
             return network.network_id == "solana-devnet"
         return False

python/coinbase-agentkit/coinbase_agentkit/action_providers/cdp/schemas.py

@@ -10,3 +10,12 @@ class RequestFaucetFundsSchema(BaseModel):
         None,
         description="The optional asset ID to request from faucet",
     )
+
+
+class SwapSchema(BaseModel):
+    """Input schema for token swapping."""
+
+    amount: str = Field(description="The amount of the from asset to swap")
+    from_asset_id: str = Field(description="The from asset ID to swap")
+    to_asset_id: str = Field(description="The to asset ID to receive from the swap")
+    network: str = Field(description="The network on which to perform the swap")

python/coinbase-agentkit/coinbase_agentkit/wallet_providers/__init__.py

@@ -8,6 +8,10 @@
     CdpEvmSmartWalletProvider,
     CdpEvmSmartWalletProviderConfig,
 )
+from .cdp_solana_wallet_provider import (
+    CdpSolanaWalletProvider,
+    CdpSolanaWalletProviderConfig,
+)
 from .eth_account_wallet_provider import EthAccountWalletProvider, EthAccountWalletProviderConfig
 from .evm_wallet_provider import EvmWalletProvider
 from .wallet_provider import WalletProvider
@@ -18,6 +22,8 @@
     "CdpEvmServerWalletProviderConfig",
     "CdpEvmSmartWalletProvider",
     "CdpEvmSmartWalletProviderConfig",
+    "CdpSolanaWalletProvider",
+    "CdpSolanaWalletProviderConfig",
     "EvmWalletProvider",
     "EthAccountWalletProvider",
     "EthAccountWalletProviderConfig",