intentkit 0.6.10.dev7__py3-none-any.whl → 0.6.11__py3-none-any.whl

intentkit/skills/xmtp/swap.py

@@ -0,0 +1,213 @@
+from typing import List, Tuple, Type
+
+from pydantic import BaseModel, Field
+
+from intentkit.clients.cdp import get_origin_cdp_client
+from intentkit.models.chat import ChatMessageAttachment, ChatMessageAttachmentType
+from intentkit.skills.xmtp.base import XmtpBaseTool
+
+
+class SwapInput(BaseModel):
+    """Input for XMTP swap skill.
+
+    This creates an unsigned swap transaction attachment using CDP swap quote
+    that a user can review and sign via XMTP wallet_sendCalls.
+    """
+
+    from_address: str = Field(description="The sender address for the swap")
+    from_token: str = Field(
+        description="The contract address of the token to swap from"
+    )
+    to_token: str = Field(description="The contract address of the token to swap to")
+    from_amount: str = Field(
+        description="The input amount in the smallest unit of from_token (as string)"
+    )
+    slippage_bps: int = Field(
+        default=100,
+        description="Maximum slippage in basis points (100 = 1%). Defaults to 100.",
+    )
+
+
+class XmtpSwap(XmtpBaseTool):
+    """Skill for creating XMTP swap transactions using CDP swap quote.
+
+    Generates a wallet_sendCalls transaction request to perform a token swap.
+    May include an ERC20 approval call followed by the router swap call.
+    Supports Base mainnet and Base Sepolia testnet.
+    """
+
+    name: str = "xmtp_swap"
+    description: str = (
+        "Create an XMTP transaction request for swapping tokens on Base using CDP swap quote. "
+        "Returns a wallet_sendCalls payload that can include an optional approval call and the swap call. "
+        "Only supports base-mainnet and base-sepolia."
+    )
+    args_schema: Type[BaseModel] = SwapInput
+
+    async def _arun(
+        self,
+        from_address: str,
+        from_token: str,
+        to_token: str,
+        from_amount: str,
+        slippage_bps: int = 100,
+    ) -> Tuple[str, List[ChatMessageAttachment]]:
+        # Input validation
+        if (
+            not from_address
+            or not from_address.startswith("0x")
+            or len(from_address) != 42
+        ):
+            raise ValueError("from_address must be a valid Ethereum address")
+
+        if not from_token or not from_token.startswith("0x") or len(from_token) != 42:
+            raise ValueError("from_token must be a valid token contract address")
+
+        if not to_token or not to_token.startswith("0x") or len(to_token) != 42:
+            raise ValueError("to_token must be a valid token contract address")
+
+        if from_token.lower() == to_token.lower():
+            raise ValueError("from_token and to_token cannot be the same")
+
+        try:
+            amount_int = int(from_amount)
+            if amount_int <= 0:
+                raise ValueError("from_amount must be a positive integer")
+        except ValueError as e:
+            raise ValueError(f"from_amount must be a valid positive integer: {e}")
+
+        if (
+            not isinstance(slippage_bps, int)
+            or slippage_bps < 0
+            or slippage_bps > 10000
+        ):
+            raise ValueError("slippage_bps must be between 0 and 10000 (0% to 100%)")
+
+        # Resolve agent context and target network
+        context = self.get_context()
+        agent = context.agent
+
+        # ChainId mapping for XMTP wallet_sendCalls
+        chain_id_hex_by_network = {
+            "base-mainnet": "0x2105",  # 8453
+            "base-sepolia": "0x14A34",  # 84532
+        }
+
+        if agent.network_id not in chain_id_hex_by_network:
+            raise ValueError(
+                f"XMTP swap only supports base-mainnet or base-sepolia. Current agent network: {agent.network_id}"
+            )
+
+        chain_id_hex = chain_id_hex_by_network[agent.network_id]
+
+        # CDP network mapping for swap quote API
+        # Reference: CDP SDK examples for swap quote and price
+        # https://github.com/coinbase/cdp-sdk/blob/main/examples/python/evm/swaps/create_swap_quote.py
+        network_for_cdp = {
+            "base-mainnet": "base",
+            "base-sepolia": "base-sepolia",
+        }[agent.network_id]
+
+        # Get CDP client from global origin helper (server-side credentials)
+        cdp_client = get_origin_cdp_client(self.skill_store)
+
+        # Call CDP to create swap quote and extract call datas
+        # Be permissive with response shape across SDK versions
+        try:
+            # Attempt the canonical method per CDP SDK examples
+            # create_swap_quote(from_token, to_token, from_amount, network, taker, slippage_bps, signer_address)
+            # Note: Don't use async with context manager as get_origin_cdp_client returns a managed global client
+            quote = await cdp_client.evm.create_swap_quote(
+                from_token=from_token,
+                to_token=to_token,
+                from_amount=str(from_amount),
+                network=network_for_cdp,
+                taker=from_address,
+                slippage_bps=slippage_bps,
+                signer_address=from_address,
+            )
+        except Exception as e:  # pragma: no cover - defensive
+            raise ValueError(f"Failed to create swap quote via CDP: {e!s}")
+
+        # Extract transaction data from QuoteSwapResult
+        # CDP returns a single transaction object with all necessary data
+        calls: list[dict] = []
+
+        # Validate that we have the required fields from CDP
+        if not hasattr(quote, "to") or not hasattr(quote, "data"):
+            raise ValueError(
+                "CDP swap quote missing required transaction fields (to, data)"
+            )
+
+        # Format value field - ensure it's a hex string
+        value_hex = "0x0"
+        if hasattr(quote, "value") and quote.value:
+            if isinstance(quote.value, str) and quote.value.startswith("0x"):
+                value_hex = quote.value
+            else:
+                value_hex = hex(int(quote.value)) if quote.value != "0" else "0x0"
+
+        # Format data field - ensure it has 0x prefix
+        data_hex = quote.data if quote.data.startswith("0x") else f"0x{quote.data}"
+
+        # Get expected output amount for metadata
+        to_amount = getattr(quote, "to_amount", None) or "unknown"
+        min_to_amount = getattr(quote, "min_to_amount", None) or "unknown"
+
+        # Create the swap call following XMTP wallet_sendCalls format
+        swap_call = {
+            "to": quote.to,
+            "value": value_hex,
+            "data": data_hex,
+            "metadata": {
+                "description": f"Swap {from_amount} units of {from_token} for {to_token} (expected: {to_amount}, min: {min_to_amount})",
+                "transactionType": "swap",
+                "currency": from_token,
+                "amount": int(from_amount),
+                "toAddress": quote.to,
+                "fromToken": from_token,
+                "toToken": to_token,
+                "expectedOutput": to_amount,
+                "minimumOutput": min_to_amount,
+                "slippageBps": slippage_bps,
+                "network": agent.network_id,
+            },
+        }
+
+        calls.append(swap_call)
+
+        # Note: CDP's create_swap_quote already includes any necessary approvals
+        # in the single transaction if needed, or handles them via Permit2 signatures
+
+        # Build XMTP wallet_sendCalls payload
+        wallet_send_calls = {
+            "version": "1.0",
+            "from": from_address,
+            "chainId": chain_id_hex,
+            "calls": calls,
+        }
+
+        # Attachment for chat
+        attachment: ChatMessageAttachment = {
+            "type": ChatMessageAttachmentType.XMTP,
+            "url": None,
+            "json": wallet_send_calls,
+        }
+
+        # Human-friendly message with more details
+        expected_output = getattr(quote, "to_amount", "unknown")
+        min_output = getattr(quote, "min_to_amount", "unknown")
+
+        content_message = (
+            f"🔄 Swap transaction ready!\n\n"
+            f"**Details:**\n"
+            f"• From: {from_amount} units of {from_token}\n"
+            f"• To: {to_token}\n"
+            f"• Expected output: {expected_output} units\n"
+            f"• Minimum output: {min_output} units\n"
+            f"• Network: {agent.network_id}\n"
+            f"• Slippage: {slippage_bps / 100:.1f}%\n\n"
+            f"Please review the transaction details and sign to execute the swap."
+        )
+
+        return content_message, [attachment]

intentkit/skills/xmtp/transfer.py

@@ -66,13 +66,20 @@ class XmtpTransfer(XmtpBaseTool):
         context = self.get_context()
         agent = context.agent
 
-        # Check if agent is on base mainnet
-        if agent.network_id != "base-mainnet" and agent.network_id != "base-sepolia":
+        # ChainId mapping for XMTP wallet_sendCalls
+        chain_id_hex_by_network = {
+            "base-mainnet": "0x2105",  # 8453
+            "base-sepolia": "0x14A34",  # 84532
+        }
+
+        if agent.network_id not in chain_id_hex_by_network:
             raise ValueError(
                 f"XMTP transfer only supports base-mainnet or base-sepolia network. "
                 f"Current agent network: {agent.network_id}"
             )
 
+        chain_id_hex = chain_id_hex_by_network[agent.network_id]
+
         # Calculate amount in smallest unit (wei for ETH, token units for ERC20)
         amount_int = int(float(amount) * (10**decimals))
 
@@ -127,7 +134,7 @@ class XmtpTransfer(XmtpBaseTool):
         wallet_send_calls = {
             "version": "1.0",
             "from": from_address,
-            "chainId": "0x2105",  # Base mainnet chain ID (8453 in hex)
+            "chainId": chain_id_hex,
             "calls": [
                 {
                     "to": transaction_to,
@@ -147,8 +154,12 @@ class XmtpTransfer(XmtpBaseTool):
 
         # Create user message
         content_message = (
-            f"I have created a transaction request for transferring {amount} {currency} "
-            f"to {to_address} on Base mainnet. "
+            f"💸 Transfer transaction ready!\n\n"
+            f"**Details:**\n"
+            f"• Amount: {amount} {currency}\n"
+            f"• To: {to_address}\n"
+            f"• Network: {agent.network_id}\n"
+            f"• Type: {'ERC20 Token' if token_contract_address else 'Native ETH'}\n\n"
             f"Please review the transaction details and sign to execute the transfer."
         )
 

{intentkit-0.6.10.dev7.dist-info → intentkit-0.6.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intentkit
-Version: 0.6.10.dev7
+Version: 0.6.11
 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
@@ -58,6 +58,7 @@ Requires-Dist: httpx>=0.28.1
 Requires-Dist: jsonref>=1.1.0
 Requires-Dist: langchain-community>=0.3.19
 Requires-Dist: langchain-core>=0.3.43
+Requires-Dist: langchain-deepseek>=0.1.4
 Requires-Dist: langchain-mcp-adapters>=0.0.11
 Requires-Dist: langchain-openai>=0.3.8
 Requires-Dist: langchain-text-splitters>=0.3.8

{intentkit-0.6.10.dev7.dist-info → intentkit-0.6.11.dist-info}/RECORD

@@ -1,4 +1,4 @@
-intentkit/__init__.py,sha256=ZmqNv3he6-fU_58ILsPGXGbpawiaKh-MXgNkiaFQA7c,384
+intentkit/__init__.py,sha256=O-g3L_v3CCqDWGpUO9c77rBx7P3t0KVW0X67YBiBdnw,379
 intentkit/abstracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 intentkit/abstracts/agent.py,sha256=108gb5W8Q1Sy4G55F2_ZFv2-_CnY76qrBtpIr0Oxxqk,1489
 intentkit/abstracts/api.py,sha256=ZUc24vaQvQVbbjznx7bV0lbbQxdQPfEV8ZxM2R6wZWo,166
@@ -8,18 +8,18 @@ intentkit/abstracts/graph.py,sha256=8jkQnm6pnUAyiU7w5dpe2RuSLvpXBN17NGqZGEuc0ys,
 intentkit/abstracts/skill.py,sha256=cIJ6BkASD31U1IEkE8rdAawq99w_xsg0lt3oalqa1ZA,5071
 intentkit/abstracts/twitter.py,sha256=cEtP7ygR_b-pHdc9i8kBuyooz1cPoGUGwsBHDpowJyY,1262
 intentkit/clients/__init__.py,sha256=sQ_6_bRC2MPWLPH-skQ3qsEe8ce-dUGL7i8VJOautHg,298
-intentkit/clients/cdp.py,sha256=_CkvnBkzdq7-sFMGct4lz85FpaOoHxOGstWubhClzrA,5921
+intentkit/clients/cdp.py,sha256=VaIFzgfqpq5H4bHbFBe8UPabhkwe8s5pge_P5FssGqU,6453
 intentkit/clients/twitter.py,sha256=Lfa7srHOFnY96SXcElW0jfg7XKS_WliWnXjPZEe6SQc,18976
 intentkit/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-intentkit/config/config.py,sha256=npQqWffhc2RZ3ECEOQXHp1DP-15aQqQ-xooIBkxDiM0,7576
+intentkit/config/config.py,sha256=Q3xsxRvn0RxcPpAOHbHcPumTRlJQMcE_pfnPfAl6aXw,8553
 intentkit/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 intentkit/core/agent.py,sha256=GIKDn1dTenIHWMRxe-ud7hd1cQaHzbTDdypy5IAgPfU,16658
 intentkit/core/api.py,sha256=3GIMJpwduLUSbVPNW6mQVxZncYHH3OlLwdiqFtYtEAE,1208
 intentkit/core/client.py,sha256=rIwtJVVm-7piXtFNDbeykt9vWdNTecgjW0aA3N-lHnM,1495
-intentkit/core/credit.py,sha256=vLT47NlLrGyvSU1OP8dkVXV5_VHqRNSeAK5t1FqSSYs,61742
-intentkit/core/engine.py,sha256=ibaPSez5IuNys5AT3xifBsKUwNElFiJMmsXCjuziRdE,43555
+intentkit/core/credit.py,sha256=Y5cjShFFqGBhz7Uc_ziqejyW-2FP58TYxsSNc4N_6hI,63039
+intentkit/core/engine.py,sha256=aDfaqw8kBWYg_cznIapSWPT4Z8O2pTOMVEIJTgxSut8,38020
 intentkit/core/node.py,sha256=7h9zgDSd928bzUi3m3EZnKkhbwqlbRAQUr_uz7gKB5Y,8880
-intentkit/core/prompt.py,sha256=RfLhlUktkB2kCr3wfldqq6ZP2l8heZIMc8jVp31KIyQ,3631
+intentkit/core/prompt.py,sha256=eaa2FyFptpsWlEGWCL8jVmZMGB6Pl9hBnt-y8Yq37RU,16041
 intentkit/core/skill.py,sha256=vPK37sDRT9kzkMBymPwqZ5uEdxTTRtb_DfREIeyz-Xw,5788
 intentkit/models/agent.py,sha256=pKeafRhmFMJwuIEBJkBEIl_oEu_CQ5AkvsBVfNfoxuQ,67168
 intentkit/models/agent_data.py,sha256=mVsiK8TziYa1W1ujU1KwI9osIVIeSM7XJEogGRL1WVU,28263
@@ -32,7 +32,7 @@ intentkit/models/credit.py,sha256=bcasHyrCwforLGrH8ZWEvN6y6ml7NeAFrGl8cfqvqbI,42
 intentkit/models/db.py,sha256=nuDX6NEtnfD5YLr2iVpAAXsgHbSpG5diqfLC-PkHsA4,4406
 intentkit/models/db_mig.py,sha256=vT6Tanm-BHC2T7dTztuB1UG494EFBAlHADKsNzR6xaQ,3577
 intentkit/models/generator.py,sha256=lyZu9U9rZUGkqd_QT5SAhay9DY358JJY8EhDSpN8I1M,10298
-intentkit/models/llm.py,sha256=TTTuea6f9aFxmS1X1SVUuMhvTh5rvIiqMn9A14lFxPY,26911
+intentkit/models/llm.py,sha256=BgmtW6Vq7ZLZN33HG37VWGg_e8YlF8GxrO9WEvKCE-A,26928
 intentkit/models/redis.py,sha256=UoN8jqLREO1VO9_w6m-JhldpP19iEHj4TiGVCMutQW4,3702
 intentkit/models/skill.py,sha256=h_2wtKEbYE29TLsMdaSnjfOv6vXY6GwMU_abw-ONX28,16374
 intentkit/models/user.py,sha256=P7l6LOsZmXZ5tDPTczTbqDtDB_MKc_9_ddZkAB2npPk,9288
@@ -388,10 +388,12 @@ intentkit/skills/web_scraper/scrape_and_index.py,sha256=Xi1BmUd-LgmJXnQOgSz82baq
 intentkit/skills/web_scraper/utils.py,sha256=feGBTMWqpkoY7RFy2xDHVs5y8c2h8-XZ111jRo6cC3k,23349
 intentkit/skills/web_scraper/website_indexer.py,sha256=rTqCx-XzJtMlZnyGImPGWRdLpS13_exXc3lQu9EDjQM,17925
 intentkit/skills/xmtp/README.md,sha256=7y3ny77l5WUI758Q3xip1akFEgBdbibkwZjeJDu5MwE,2963
-intentkit/skills/xmtp/__init__.py,sha256=pG56rMjtC85x_R_YadlKyTnWYJe-jgwW4xolilcVCkA,2003
+intentkit/skills/xmtp/__init__.py,sha256=inpuVqA9i98g8VIqqfC28PbfveozSukbEHOLbOMYv14,2538
 intentkit/skills/xmtp/base.py,sha256=85ZEuNLJmI_NmBPkbvDXQrNvJNG8dp9MbcbQYQQ3QZ8,430
-intentkit/skills/xmtp/schema.json,sha256=p8lPnzAzsW4yrPcuEv48Tv6qj3ouSNEFjw7YSxDZ3ok,1558
-intentkit/skills/xmtp/transfer.py,sha256=hlkUu2UkTKx1Y7mUrBT4OjkWuzDK8DwfNpxYEwdOFhc,5860
+intentkit/skills/xmtp/price.py,sha256=LqM3tWiW42bYIRqfvsZUvYpG5H5ife3WUhR-pxiS9I8,2648
+intentkit/skills/xmtp/schema.json,sha256=GFJKYPQVAcfiybL1uhAHANYeQUR0JWWxPgPhXW92N0s,3089
+intentkit/skills/xmtp/swap.py,sha256=8YEjfOTS-BtKKuXT1QLedBTM9h4QUF0rVYtLkC7WPG0,8412
+intentkit/skills/xmtp/transfer.py,sha256=qmSIsSrWR-S5JFlBP4YjxudsWlKsCpp-JjDQjYUhdHg,6182
 intentkit/skills/xmtp/xmtp.png,sha256=vQzT-71zIb8aPodg-GkGSQbBnjGAPczWGm3es2ZkJe8,6681
 intentkit/utils/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 intentkit/utils/chain.py,sha256=3GBHuAbXxQr_HlOvkbB2kruYSkweucfxI5u-swXzY40,15135
@@ -401,7 +403,7 @@ intentkit/utils/random.py,sha256=DymMxu9g0kuQLgJUqalvgksnIeLdS-v0aRk5nQU0mLI,452
 intentkit/utils/s3.py,sha256=9trQNkKQ5VgxWsewVsV8Y0q_pXzGRvsCYP8xauyUYkg,8549
 intentkit/utils/slack_alert.py,sha256=s7UpRgyzLW7Pbmt8cKzTJgMA9bm4EP-1rQ5KXayHu6E,2264
 intentkit/utils/tx.py,sha256=2yLLGuhvfBEY5n_GJ8wmIWLCzn0FsYKv5kRNzw_sLUI,1454
-intentkit-0.6.10.dev7.dist-info/METADATA,sha256=7fKyuBYx-P6ONWtY6BCv7SslqGW3IfRqAbQNC9ArH3U,6373
-intentkit-0.6.10.dev7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-intentkit-0.6.10.dev7.dist-info/licenses/LICENSE,sha256=Bln6DhK-LtcO4aXy-PBcdZv2f24MlJFm_qn222biJtE,1071
-intentkit-0.6.10.dev7.dist-info/RECORD,,
+intentkit-0.6.11.dist-info/METADATA,sha256=vf9PbkXoHaxW1Wac6xw9_xh8hd2yYWYD3D5H79mXl5I,6409
+intentkit-0.6.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+intentkit-0.6.11.dist-info/licenses/LICENSE,sha256=Bln6DhK-LtcO4aXy-PBcdZv2f24MlJFm_qn222biJtE,1071
+intentkit-0.6.11.dist-info/RECORD,,