intentkit 0.7.5.dev15__py3-none-any.whl → 0.7.5.dev17__py3-none-any.whl

intentkit/skills/lifi/__init__.py

@@ -1,5 +1,5 @@
 import logging
-from typing import List, Optional, TypedDict
+from typing import Any, List, Optional, TypedDict
 
 from intentkit.abstracts.skill import SkillStoreABC
 from intentkit.skills.base import SkillConfig, SkillState
@@ -32,10 +32,10 @@ async def get_skills(
     config: "Config",
     is_private: bool,
     store: SkillStoreABC,
-    **_,
+    **_: Any,
 ) -> list[LiFiBaseTool]:
     """Get all LiFi skills."""
-    available_skills = []
+    available_skills: list[str] = []
 
     # Log configuration
     logger.info(f"[LiFi_Skills] Initializing with config: {config}")
@@ -57,7 +57,7 @@ async def get_skills(
     logger.info(f"[LiFi_Skills] Available skills: {available_skills}")
 
     # Get each skill using the cached getter
-    skills = []
+    skills: list[LiFiBaseTool] = []
     for name in available_skills:
         try:
             skill = get_lifi_skill(name, store, config)

intentkit/skills/lifi/token_execute.py

@@ -2,11 +2,12 @@ import asyncio
 from typing import Any, Dict, List, Optional, Type
 
 import httpx
+from coinbase_agentkit import CdpEvmWalletProvider
 from pydantic import BaseModel, Field
 from web3 import Web3
 
 from intentkit.abstracts.skill import SkillStoreABC
-from intentkit.clients import get_cdp_client
+from intentkit.clients import CdpClient, get_cdp_client
 from intentkit.skills.lifi.base import LiFiBaseTool
 from intentkit.skills.lifi.token_quote import TokenQuote
 from intentkit.skills.lifi.utils import (
@@ -69,7 +70,7 @@ class TokenExecute(LiFiBaseTool):
     default_slippage: float = 0.03
     allowed_chains: Optional[List[str]] = None
     max_execution_time: int = 300
-    quote_tool: TokenQuote = Field(default=None, exclude=True)
+    quote_tool: Optional[TokenQuote] = Field(default=None, exclude=True)
 
     def __init__(
         self,
@@ -77,7 +78,7 @@ class TokenExecute(LiFiBaseTool):
         default_slippage: float = 0.03,
         allowed_chains: Optional[List[str]] = None,
         max_execution_time: int = 300,
-    ):
+    ) -> None:
         """Initialize the TokenExecute skill with configuration options."""
         super().__init__(skill_store=skill_store)
         self.default_slippage = default_slippage
@@ -93,6 +94,8 @@ class TokenExecute(LiFiBaseTool):
 
     def _format_quote_result(self, data: Dict[str, Any]) -> str:
         """Format the quote result in a readable format."""
+        if self.quote_tool is None:
+            raise RuntimeError("Quote tool is not initialized")
         # Use the same formatting as token_quote
         return self.quote_tool._format_quote_result(data)
 
@@ -103,7 +106,7 @@ class TokenExecute(LiFiBaseTool):
         from_token: str,
         to_token: str,
         from_amount: str,
-        slippage: float = None,
+        slippage: Optional[float] = None,
         **kwargs,
     ) -> str:
         """Execute a token transfer."""
@@ -168,7 +171,9 @@ class TokenExecute(LiFiBaseTool):
 
                 # Step 3: Execute transaction
                 tx_hash = await self._execute_transfer_transaction(
-                    cdp_wallet_provider, quote_data
+                    cdp_wallet_provider,
+                    quote_data,
+                    from_address,
                 )
 
                 # Step 4: Monitor status and return result
@@ -180,10 +185,12 @@ class TokenExecute(LiFiBaseTool):
             self.logger.error("LiFi_Error: %s", str(e))
             return f"An unexpected error occurred: {str(e)}"
 
-    async def _get_cdp_wallet_provider(self, agent_id: str):
+    async def _get_cdp_wallet_provider(
+        self, agent_id: str
+    ) -> CdpEvmWalletProvider | str:
         """Get CDP wallet provider with error handling."""
         try:
-            cdp_client = await get_cdp_client(agent_id, self.skill_store)
+            cdp_client: CdpClient = await get_cdp_client(agent_id, self.skill_store)
             if not cdp_client:
                 return "CDP client not available. Please ensure your agent has CDP wallet configuration."
 
@@ -207,7 +214,7 @@ class TokenExecute(LiFiBaseTool):
         from_amount: str,
         slippage: float,
         from_address: str,
-    ) -> Dict[str, Any]:
+    ) -> Dict[str, Any] | str:
         """Get quote from LiFi API."""
         api_params = build_quote_params(
             from_chain,
@@ -249,7 +256,7 @@ class TokenExecute(LiFiBaseTool):
         return data
 
     async def _handle_token_approval(
-        self, wallet_provider, quote_data: Dict[str, Any]
+        self, wallet_provider: CdpEvmWalletProvider, quote_data: Dict[str, Any]
     ) -> Optional[str]:
         """Handle ERC20 token approval if needed."""
         estimate = quote_data.get("estimate", {})
@@ -273,13 +280,18 @@ class TokenExecute(LiFiBaseTool):
             raise Exception(f"Failed to approve token: {str(e)}")
 
     async def _execute_transfer_transaction(
-        self, wallet_provider, quote_data: Dict[str, Any]
+        self,
+        wallet_provider: CdpEvmWalletProvider,
+        quote_data: Dict[str, Any],
+        from_address: str,
     ) -> str:
         """Execute the main transfer transaction."""
         transaction_request = quote_data.get("transactionRequest")
 
         try:
-            tx_params = prepare_transaction_params(transaction_request)
+            tx_params = prepare_transaction_params(
+                transaction_request, wallet_address=from_address
+            )
             self.logger.info(
                 f"Sending transaction to {tx_params['to']} with value {tx_params['value']}"
             )
@@ -407,7 +419,7 @@ class TokenExecute(LiFiBaseTool):
 
     async def _check_and_set_allowance(
         self,
-        wallet_provider,
+        wallet_provider: CdpEvmWalletProvider,
         token_address: str,
         approval_address: str,
         amount: str,

intentkit/skills/lifi/token_quote.py

@@ -65,7 +65,7 @@ class TokenQuote(LiFiBaseTool):
         skill_store: SkillStoreABC,
         default_slippage: float = 0.03,
         allowed_chains: Optional[List[str]] = None,
-    ):
+    ) -> None:
         """Initialize the TokenQuote skill with configuration options."""
         super().__init__(skill_store=skill_store)
         self.default_slippage = default_slippage
@@ -78,7 +78,7 @@ class TokenQuote(LiFiBaseTool):
         from_token: str,
         to_token: str,
         from_amount: str,
-        slippage: float = None,
+        slippage: Optional[float] = None,
         **kwargs,
     ) -> str:
         """Get a quote for token transfer."""

intentkit/skills/lifi/utils.py

@@ -4,6 +4,7 @@ LiFi Skills Utilities
 Common utilities and helper functions for LiFi token transfer skills.
 """
 
+from decimal import ROUND_DOWN, Decimal, InvalidOperation
 from typing import Any, Dict, List, Optional, Tuple
 
 import httpx
@@ -179,7 +180,7 @@ def handle_api_response(
     from_chain: str,
     to_token: str,
     to_chain: str,
-) -> Tuple[Optional[Dict], Optional[str]]:
+) -> Tuple[Optional[Dict[str, Any]], Optional[str]]:
     """
     Handle LiFi API response and return data or error message.
 
@@ -293,17 +294,20 @@ def convert_chain_to_id(chain: str) -> int:
 
 
 def convert_amount_to_wei(amount: str, token_symbol: str = "ETH") -> str:
-    """
-    Convert human-readable amount to wei format for LiFi API.
+    """Convert a token amount into the smallest denomination expected by LiFi."""
 
-    Args:
-        amount: Amount in human readable format (e.g., "0.0015")
-        token_symbol: Token symbol to determine decimals
+    if amount is None:
+        raise ValueError("Amount is required")
+
+    normalized_amount = amount.strip()
+    if not normalized_amount:
+        raise ValueError("Amount cannot be empty")
+
+    # If the user already provided an integer amount without a decimal point,
+    # assume it is already in the token's smallest denomination.
+    if normalized_amount.isdigit():
+        return normalized_amount
 
-    Returns:
-        Amount in wei format as string
-    """
-    # Default decimals for common tokens
     token_decimals = {
         "ETH": 18,
         "USDC": 6,
@@ -318,13 +322,16 @@ def convert_amount_to_wei(amount: str, token_symbol: str = "ETH") -> str:
     decimals = token_decimals.get(token_symbol.upper(), 18)
 
     try:
-        # Convert string to float, then to wei
-        amount_float = float(amount)
-        amount_wei = int(amount_float * (10**decimals))
-        return str(amount_wei)
-    except (ValueError, TypeError):
-        # If conversion fails, return original amount
-        return amount
+        decimal_amount = Decimal(normalized_amount)
+        scaled_amount = (decimal_amount * (Decimal(10) ** decimals)).quantize(
+            Decimal("1"),
+            rounding=ROUND_DOWN,
+        )
+        return str(int(scaled_amount))
+    except (InvalidOperation, ValueError, TypeError):
+        # If conversion fails, fall back to the original value to avoid
+        # accidentally submitting an incorrect amount.
+        return normalized_amount
 
 
 def build_quote_params(
@@ -350,15 +357,12 @@ def build_quote_params(
     Raises:
         ValueError: If chain identifiers are not recognized
     """
-    # Convert amount to wei format for API
-    wei_amount = convert_amount_to_wei(from_amount, from_token)
-
     return {
         "fromChain": convert_chain_to_id(from_chain),
         "toChain": convert_chain_to_id(to_chain),
         "fromToken": from_token,
         "toToken": to_token,
-        "fromAmount": wei_amount,
+        "fromAmount": convert_amount_to_wei(from_amount, from_token),
         "fromAddress": from_address or DUMMY_ADDRESS,
         "slippage": slippage,
     }
@@ -381,36 +385,85 @@ def is_native_token(token_address: str) -> bool:
     )
 
 
-def prepare_transaction_params(transaction_request: Dict[str, Any]) -> Dict[str, Any]:
-    """
-    Prepare transaction parameters for CDP wallet provider.
+def _convert_hex_or_decimal(value: Any) -> Optional[int]:
+    """Convert LiFi transaction numeric values into integers."""
 
-    Args:
-        transaction_request: Transaction request from LiFi API
+    if value is None:
+        return None
 
-    Returns:
-        Formatted transaction parameters
+    if isinstance(value, int):
+        return value
+
+    if isinstance(value, str):
+        stripped = value.strip()
+        if not stripped:
+            return None
+        if stripped.startswith("0x"):
+            return int(stripped, 16)
+        try:
+            return int(Decimal(stripped))
+        except (InvalidOperation, ValueError):
+            return None
+
+    return None
+
+
+def prepare_transaction_params(
+    transaction_request: Dict[str, Any],
+    wallet_address: Optional[str] = None,
+) -> Dict[str, Any]:
+    """Prepare transaction parameters for the CDP wallet provider."""
 
-    Raises:
-        Exception: If required parameters are missing
-    """
     to_address = transaction_request.get("to")
-    value = transaction_request.get("value", "0")
+    value = transaction_request.get("value", "0x0")
     data = transaction_request.get("data", "0x")
 
     if not to_address:
-        raise Exception("No destination address in transaction request")
+        raise Exception("Transaction request is missing destination address")
 
-    # Convert value to integer if it's a string
-    if isinstance(value, str):
-        value = int(value, 16) if value.startswith("0x") else int(value)
-
-    return {
+    tx_params: Dict[str, Any] = {
         "to": Web3.to_checksum_address(to_address),
-        "value": value,
         "data": data,
     }
 
+    int_value = _convert_hex_or_decimal(value)
+    if int_value is not None:
+        tx_params["value"] = int_value
+
+    chain_id = _convert_hex_or_decimal(transaction_request.get("chainId"))
+    if chain_id is not None:
+        tx_params["chainId"] = chain_id
+
+    gas_limit = _convert_hex_or_decimal(
+        transaction_request.get("gasLimit") or transaction_request.get("gas")
+    )
+    if gas_limit is not None:
+        tx_params["gas"] = gas_limit
+
+    gas_price = _convert_hex_or_decimal(transaction_request.get("gasPrice"))
+    if gas_price is not None:
+        tx_params["gasPrice"] = gas_price
+
+    max_fee_per_gas = _convert_hex_or_decimal(transaction_request.get("maxFeePerGas"))
+    if max_fee_per_gas is not None:
+        tx_params["maxFeePerGas"] = max_fee_per_gas
+
+    max_priority_fee_per_gas = _convert_hex_or_decimal(
+        transaction_request.get("maxPriorityFeePerGas")
+    )
+    if max_priority_fee_per_gas is not None:
+        tx_params["maxPriorityFeePerGas"] = max_priority_fee_per_gas
+
+    nonce = _convert_hex_or_decimal(transaction_request.get("nonce"))
+    if nonce is not None:
+        tx_params["nonce"] = nonce
+
+    from_address = transaction_request.get("from") or wallet_address
+    if from_address:
+        tx_params["from"] = Web3.to_checksum_address(from_address)
+
+    return tx_params
+
 
 def format_quote_basic_info(data: Dict[str, Any]) -> Dict[str, Any]:
     """
@@ -464,7 +517,7 @@ def format_fees_and_gas(data: Dict[str, Any]) -> Tuple[str, str]:
 
     # Extract gas and fee costs
     gas_costs = estimate.get("gasCosts", [])
-    fee_costs = []
+    fee_costs: List[Dict[str, Any]] = []
 
     # Collect fee information from included steps
     for step in data.get("includedSteps", []):
@@ -476,7 +529,7 @@ def format_fees_and_gas(data: Dict[str, Any]) -> Tuple[str, str]:
     fees_text = ""
     if fee_costs:
         fees_text = "**Fees:**\n"
-        total_fee_usd = 0
+        total_fee_usd = 0.0
         for fee in fee_costs:
             fee_name = fee.get("name", "Unknown fee")
             fee_amount = fee.get("amount", "0")
@@ -508,7 +561,7 @@ def format_fees_and_gas(data: Dict[str, Any]) -> Tuple[str, str]:
     gas_text = ""
     if gas_costs:
         gas_text = "**Gas Cost:**\n"
-        total_gas_usd = 0
+        total_gas_usd = 0.0
         for gas in gas_costs:
             gas_amount = gas.get("amount", "0")
             gas_token = gas.get("token", {}).get("symbol", "ETH")
@@ -628,7 +681,7 @@ def get_explorer_url(chain_id: int, tx_hash: str) -> str:
 
 
 def format_transaction_result(
-    tx_hash: str, chain_id: int, token_info: dict = None
+    tx_hash: str, chain_id: int, token_info: Optional[Dict[str, str]] = None
 ) -> str:
     """
     Format transaction result with explorer link.

intentkit/skills/morpho/__init__.py

@@ -0,0 +1,50 @@
+"""Morpho AgentKit skills."""
+
+from typing import TypedDict
+
+from coinbase_agentkit import morpho_action_provider
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.skills.base import (
+    SkillConfig,
+    SkillState,
+    action_to_structured_tool,
+    get_agentkit_actions,
+)
+from intentkit.skills.morpho.base import MorphoBaseTool
+
+
+class SkillStates(TypedDict):
+    MorphoActionProvider_deposit: SkillState
+    MorphoActionProvider_withdraw: SkillState
+
+
+class Config(SkillConfig):
+    """Configuration for Morpho skills."""
+
+    states: SkillStates
+
+
+async def get_skills(
+    config: "Config",
+    is_private: bool,
+    store: SkillStoreABC,
+    agent_id: str,
+    **_,
+) -> list[MorphoBaseTool]:
+    """Get all Morpho skills."""
+
+    available_skills: list[str] = []
+    for skill_name, state in config["states"].items():
+        if state == "disabled":
+            continue
+        if state == "public" or (state == "private" and is_private):
+            available_skills.append(skill_name)
+
+    actions = await get_agentkit_actions(agent_id, store, [morpho_action_provider])
+    tools: list[MorphoBaseTool] = []
+    for skill in available_skills:
+        for action in actions:
+            if action.name.endswith(skill):
+                tools.append(action_to_structured_tool(action))
+    return tools

intentkit/skills/morpho/base.py

@@ -0,0 +1,11 @@
+"""Morpho AgentKit skills base class."""
+
+from intentkit.skills.cdp.base import CDPBaseTool
+
+
+class MorphoBaseTool(CDPBaseTool):
+    """Base class for Morpho tools."""
+
+    @property
+    def category(self) -> str:
+        return "morpho"

intentkit/skills/morpho/morpho.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <defs>
+    <radialGradient id="morpho" cx="50%" cy="50%" r="70%">
+      <stop offset="0%" stop-color="#82f3ff" />
+      <stop offset="100%" stop-color="#006064" />
+    </radialGradient>
+  </defs>
+  <rect width="128" height="128" fill="#004d40" rx="16" />
+  <circle cx="64" cy="48" r="28" fill="url(#morpho)" />
+  <rect x="36" y="72" width="56" height="20" rx="10" fill="#26a69a" />
+  <text x="50%" y="84%" font-family="Arial,Helvetica,sans-serif" font-size="18" fill="#e0f2f1" font-weight="600" text-anchor="middle">Morpho</text>
+</svg>

intentkit/skills/morpho/schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Morpho",
+  "description": "Morpho lending actions via Coinbase AgentKit",
+  "x-icon": "https://ai.service.crestal.dev/skills/morpho/morpho.svg",
+  "x-tags": [
+    "Blockchain"
+  ],
+  "properties": {
+    "enabled": {
+      "type": "boolean",
+      "title": "Enabled",
+      "description": "Whether this skill is enabled",
+      "default": true
+    },
+    "states": {
+      "type": "object",
+      "properties": {
+        "MorphoActionProvider_deposit": {
+          "type": "string",
+          "title": "Deposit",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "State for MorphoActionProvider_deposit",
+          "default": "disabled"
+        },
+        "MorphoActionProvider_withdraw": {
+          "type": "string",
+          "title": "Withdraw",
+          "enum": [
+            "disabled",
+            "public",
+            "private"
+          ],
+          "x-enum-title": [
+            "Disabled",
+            "Agent Owner + All Users",
+            "Agent Owner Only"
+          ],
+          "description": "State for MorphoActionProvider_withdraw",
+          "default": "disabled"
+        }
+      },
+      "description": "States for each Morpho skill (disabled, public, or private)"
+    },
+    "api_key_provider": {
+      "type": "string",
+      "title": "API Key Provider",
+      "description": "Who provides the API key",
+      "enum": [
+        "platform"
+      ],
+      "x-enum-title": [
+        "Nation Hosted"
+      ],
+      "default": "platform"
+    }
+  },
+  "required": [
+    "states",
+    "enabled"
+  ],
+  "additionalProperties": true
+}

intentkit/skills/pyth/__init__.py

@@ -0,0 +1,50 @@
+"""Pyth AgentKit skills."""
+
+from typing import TypedDict
+
+from coinbase_agentkit import pyth_action_provider
+
+from intentkit.abstracts.skill import SkillStoreABC
+from intentkit.skills.base import (
+    SkillConfig,
+    SkillState,
+    action_to_structured_tool,
+    get_agentkit_actions,
+)
+from intentkit.skills.pyth.base import PythBaseTool
+
+
+class SkillStates(TypedDict):
+    PythActionProvider_fetch_price: SkillState
+    PythActionProvider_fetch_price_feed: SkillState
+
+
+class Config(SkillConfig):
+    """Configuration for Pyth skills."""
+
+    states: SkillStates
+
+
+async def get_skills(
+    config: "Config",
+    is_private: bool,
+    store: SkillStoreABC,
+    agent_id: str,
+    **_,
+) -> list[PythBaseTool]:
+    """Get all Pyth skills."""
+
+    available_skills: list[str] = []
+    for skill_name, state in config["states"].items():
+        if state == "disabled":
+            continue
+        if state == "public" or (state == "private" and is_private):
+            available_skills.append(skill_name)
+
+    actions = await get_agentkit_actions(agent_id, store, [pyth_action_provider])
+    tools: list[PythBaseTool] = []
+    for skill in available_skills:
+        for action in actions:
+            if action.name.endswith(skill):
+                tools.append(action_to_structured_tool(action))
+    return tools

intentkit/skills/pyth/base.py

@@ -0,0 +1,11 @@
+"""Pyth AgentKit skills base class."""
+
+from intentkit.skills.cdp.base import CDPBaseTool
+
+
+class PythBaseTool(CDPBaseTool):
+    """Base class for Pyth tools."""
+
+    @property
+    def category(self) -> str:
+        return "pyth"

intentkit/skills/pyth/pyth.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128">
+  <rect width="128" height="128" fill="#111827" rx="16" />
+  <path d="M40 44h48l-12 40H28z" fill="#38bdf8" opacity="0.85" />
+  <path d="M88 84H40l12-40h48z" fill="#f472b6" opacity="0.75" />
+  <text x="50%" y="92" font-family="Arial,Helvetica,sans-serif" font-size="18" fill="#f8fafc" text-anchor="middle">PYTH</text>
+</svg>