intentkit 0.6.9.dev2__py3-none-any.whl → 0.6.10.dev1__py3-none-any.whl

intentkit/skills/xmtp/transfer.py

@@ -0,0 +1,170 @@
+from typing import Any, List, Optional, Tuple
+
+from langchain_core.runnables import RunnableConfig
+from pydantic import BaseModel, Field
+
+from intentkit.models.chat import ChatMessageAttachment, ChatMessageAttachmentType
+from intentkit.skills.xmtp.base import XmtpBaseTool
+
+
+class TransferInput(BaseModel):
+    """Input for XMTP transfer skill."""
+
+    from_address: str = Field(description="The sender address for the transfer")
+    to_address: str = Field(description="The recipient address for the transfer")
+    amount: str = Field(
+        description="The amount to transfer (as string to handle large numbers)"
+    )
+    decimals: int = Field(
+        description="Number of decimal places for the token (18 for ETH, varies for ERC20 tokens)"
+    )
+    currency: str = Field(description="Currency symbol (e.g., 'ETH', 'USDC', 'DAI')")
+    token_contract_address: Optional[str] = Field(
+        default=None,
+        description="Token contract address for ERC20 transfers. Leave empty for ETH transfers.",
+    )
+
+
+class XmtpTransfer(XmtpBaseTool):
+    """Skill for creating XMTP transfer transactions."""
+
+    name: str = "xmtp_transfer"
+    description: str = """Create an XMTP transaction request for transferring ETH or ERC20 tokens on Base mainnet.
+    
+    This skill generates a wallet_sendCalls transaction request according to XMTP protocol 
+    that can be sent to users for signing. The transaction can transfer:
+    - ETH (when token_contract_address is not provided)
+    - ERC20 tokens (when token_contract_address is provided)
+    
+    Only supports Base mainnet network.
+    """
+    args_schema = TransferInput
+
+    async def _arun(
+        self,
+        from_address: str,
+        to_address: str,
+        amount: str,
+        decimals: int,
+        currency: str,
+        token_contract_address: Optional[str],
+        config: RunnableConfig,
+        **kwargs: Any,
+    ) -> Tuple[str, List[ChatMessageAttachment]]:
+        """Create an XMTP transfer transaction request.
+
+        Args:
+            from_address: The sender address
+            to_address: The recipient address
+            amount: Amount to transfer
+            decimals: Token decimals
+            currency: Currency symbol
+            token_contract_address: Token contract address (None for ETH)
+            config: LangChain runnable config
+
+        Returns:
+            Tuple of (content_message, list_of_attachments)
+        """
+        # Get context and check network
+        context = self.context_from_config(config)
+        agent = context.agent
+
+        # Check if agent is on base mainnet
+        if agent.network_id != "base-mainnet" and agent.network_id != "base-sepolia":
+            raise ValueError(
+                f"XMTP transfer only supports base-mainnet or base-sepolia network. "
+                f"Current agent network: {agent.network_id}"
+            )
+
+        # Check if agent has EVM wallet address
+        if not agent.evm_wallet_address:
+            raise ValueError(
+                "Agent must have an EVM wallet address to create XMTP transactions"
+            )
+
+        # Validate from_address matches agent's wallet
+        if from_address.lower() != agent.evm_wallet_address.lower():
+            raise ValueError(
+                f"from_address must match agent's EVM wallet address: {agent.evm_wallet_address}"
+            )
+
+        # Calculate amount in smallest unit (wei for ETH, token units for ERC20)
+        amount_int = int(float(amount) * (10**decimals))
+
+        if token_contract_address:
+            # ERC20 Token Transfer
+            transaction_to = token_contract_address
+            transaction_value = "0x0"  # No ETH value for token transfers
+
+            # Create ERC20 transfer function call data
+            # Function signature: transfer(address,uint256)
+            # Method ID: First 4 bytes of keccak256("transfer(address,uint256)")
+            method_id = "0xa9059cbb"  # transfer(address,uint256) method ID
+
+            # Encode to_address (32 bytes, left-padded)
+            to_address_clean = to_address.replace("0x", "")
+            to_address_padded = to_address_clean.zfill(64)
+
+            # Encode amount (32 bytes, left-padded)
+            amount_hex = hex(amount_int)[2:]  # Remove 0x prefix
+            amount_padded = amount_hex.zfill(64)
+
+            # Combine method ID + padded address + padded amount
+            call_data = method_id + to_address_padded + amount_padded
+
+            description = f"Send {amount} {currency} to {to_address}"
+            metadata = {
+                "description": description,
+                "transactionType": "erc20_transfer",
+                "currency": currency,
+                "amount": amount_int,
+                "decimals": decimals,
+                "toAddress": to_address,
+                "tokenContract": token_contract_address,
+            }
+        else:
+            # ETH Transfer
+            transaction_to = to_address
+            transaction_value = hex(amount_int)
+            call_data = "0x"  # No call data for simple ETH transfer
+
+            description = f"Send {amount} {currency} to {to_address}"
+            metadata = {
+                "description": description,
+                "transactionType": "transfer",
+                "currency": currency,
+                "amount": amount_int,
+                "decimals": decimals,
+                "toAddress": to_address,
+            }
+
+        # Create XMTP wallet_sendCalls transaction request
+        wallet_send_calls = {
+            "version": "1.0",
+            "from": from_address,
+            "chainId": "0x2105",  # Base mainnet chain ID (8453 in hex)
+            "calls": [
+                {
+                    "to": transaction_to,
+                    "value": transaction_value,
+                    "data": call_data,
+                    "metadata": metadata,
+                }
+            ],
+        }
+
+        # Create ChatMessageAttachment
+        attachment: ChatMessageAttachment = {
+            "type": ChatMessageAttachmentType.XMTP,
+            "url": None,
+            "json": wallet_send_calls,
+        }
+
+        # Create user message
+        content_message = (
+            f"I have created a transaction request for transferring {amount} {currency} "
+            f"to {to_address} on Base mainnet. "
+            f"Please review the transaction details and sign to execute the transfer."
+        )
+
+        return content_message, [attachment]

intentkit/skills/xmtp/xmtp.svg

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="100" height="100" viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background circle -->
+  <circle cx="50" cy="50" r="45" fill="#1DB584" stroke="#0F7B5C" stroke-width="2"/>
+  
+  <!-- XMTP messaging icon -->
+  <g transform="translate(20, 25)">
+    <!-- Chat bubble 1 -->
+    <rect x="5" y="15" width="35" height="20" rx="10" fill="white" opacity="0.9"/>
+    <circle cx="10" cy="23" r="2" fill="#1DB584"/>
+    <circle cx="16" cy="23" r="2" fill="#1DB584"/>
+    <circle cx="22" cy="23" r="2" fill="#1DB584"/>
+    
+    <!-- Chat bubble 2 -->
+    <rect x="20" y="35" width="35" height="20" rx="10" fill="white" opacity="0.8"/>
+    <path d="M 25 42 L 50 42" stroke="#1DB584" stroke-width="2" stroke-linecap="round"/>
+    <path d="M 25 47 L 45 47" stroke="#1DB584" stroke-width="2" stroke-linecap="round"/>
+  </g>
+  
+  <!-- Protocol symbol -->
+  <g transform="translate(35, 60)">
+    <circle cx="15" cy="15" r="12" fill="white" opacity="0.2"/>
+    <path d="M 8 12 L 15 8 L 22 12 L 15 16 Z" fill="white"/>
+    <path d="M 8 16 L 15 12 L 22 16 L 15 20 Z" fill="white" opacity="0.7"/>
+  </g>
+</svg>

{intentkit-0.6.9.dev2.dist-info → intentkit-0.6.10.dev1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.6.9.dev2
+Version: 0.6.10.dev1
 Summary: Intent-based AI Agent Platform - Core Package
 Project-URL: Homepage, https://github.com/crestal-network/intentkit
 Project-URL: Repository, https://github.com/crestal-network/intentkit
@@ -64,8 +64,8 @@ Requires-Dist: langchain-xai>=0.2.1
 Requires-Dist: langchain<0.4.0,>=0.3.25
 Requires-Dist: langgraph-checkpoint-postgres<2.0.23,>=2.0.16
 Requires-Dist: langgraph-checkpoint>=2.0.18
-Requires-Dist: langgraph-prebuilt<0.6.0,>=0.5.1
-Requires-Dist: langgraph<0.6.0,>=0.5.1
+Requires-Dist: langgraph-prebuilt<0.7.0,>=0.6.1
+Requires-Dist: langgraph<0.7.0,>=0.6.1
 Requires-Dist: langmem>=0.0.27
 Requires-Dist: mypy-boto3-s3<2.0.0,>=1.37.24
 Requires-Dist: openai>=1.59.6