floe-agentkit-actions 0.1.0__tar.gz

floe_agentkit_actions-0.1.0/.gitignore

@@ -0,0 +1,21 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+.env.*
+!.env.example
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+*.so
+.coverage
+htmlcov/
+.floe-agent.json
+.wallet-data.json

floe_agentkit_actions-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Floe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

floe_agentkit_actions-0.1.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: floe-agentkit-actions
+Version: 0.1.0
+Summary: Coinbase AgentKit ActionProvider for Floe DeFi lending protocol on Base
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agentkit,ai-agent,base,coinbase,defi,floe,lending
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Requires-Dist: coinbase-agentkit>=0.7.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: web3>=7.0.0
+Provides-Extra: cli
+Requires-Dist: anthropic>=0.30.0; extra == 'cli'
+Requires-Dist: openai>=1.0.0; extra == 'cli'
+Requires-Dist: questionary>=2.0.0; extra == 'cli'
+Requires-Dist: rich>=13.0.0; extra == 'cli'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Provides-Extra: langchain
+Requires-Dist: coinbase-agentkit-langchain>=0.1.0; extra == 'langchain'
+Requires-Dist: langchain-openai>=0.1.0; extra == 'langchain'
+Description-Content-Type: text/markdown
+
+# floe-agentkit-actions
+
+Coinbase AgentKit ActionProvider for the **Floe DeFi lending protocol** on Base.
+
+23 AI-agent actions for intent-based lending, flash loan arbitrage, and loan management.
+
+## Installation
+
+```bash
+pip install floe-agentkit-actions
+
+# With CLI support
+pip install floe-agentkit-actions[cli]
+
+# With LangChain integration
+pip install floe-agentkit-actions[langchain]
+```
+
+## Quick Start
+
+### As an AgentKit Provider
+
+```python
+from coinbase_agentkit import AgentKit, AgentKitConfig
+from floe_agentkit_actions import floe_action_provider
+
+agentkit = AgentKit(AgentKitConfig(
+    wallet_provider=wallet_provider,
+    action_providers=[floe_action_provider()],
+))
+```
+
+### Standalone Usage
+
+```python
+from floe_agentkit_actions import floe_action_provider
+
+floe = floe_action_provider()
+result = floe.get_price(wallet_provider, {
+    "collateral_token": "0x4200000000000000000000000000000000000006",  # WETH
+    "loan_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",      # USDC
+})
+print(result)
+```
+
+### CLI
+
+```bash
+floe-agent
+```
+
+Interactive AI-powered DeFi agent with support for OpenAI, Claude, and Ollama.
+
+## Actions (23)
+
+### Read (8)
+- `get_markets` — Query lending market info
+- `get_loan` — Get loan details
+- `get_my_loans` — All loans for connected wallet
+- `check_loan_health` — Health status and liquidation distance
+- `get_price` — Oracle price (Chainlink + Pyth)
+- `get_accrued_interest` — Interest accrued on a loan
+- `get_liquidation_quote` — Liquidation profit/loss breakdown
+- `get_intent_book` — Look up on-chain intent by hash
+
+### Write (7)
+- `post_lend_intent` — Post lending offer at fixed rate
+- `post_borrow_intent` — Post borrow request with collateral
+- `match_intents` — Match lend + borrow intents to create loan
+- `repay_loan` — Fully or partially repay loan
+- `add_collateral` — Add collateral to improve health
+- `withdraw_collateral` — Withdraw excess collateral
+- `liquidate_loan` — Liquidate unhealthy loan
+
+### Flash Loans (5)
+- `get_flash_loan_fee` — Query protocol flash fee
+- `estimate_flash_arb_profit` — Simulate multi-leg arb profit
+- `flash_loan` — Raw flash loan (receiver must be smart contract)
+- `flash_arb` — Flash arb via FlashArbReceiver
+- `get_flash_arb_balance` — Check accumulated profit
+
+### Deploy (3)
+- `deploy_flash_arb_receiver` — Deploy FlashArbReceiver with pre-flight checks
+- `check_flash_arb_readiness` — Environment readiness check
+- `verify_flash_arb_receiver` — Validate receiver configuration
+
+## Wallet Providers
+
+| Provider | Use Case |
+|----------|----------|
+| Private Key (`EvmWalletProvider`) | Development / scripting |
+| CDP (`CdpWalletProvider`) | Production agents (MPC) |
+
+## Framework Integrations
+
+### LangChain
+
+```python
+from floe_agentkit_actions.integrations.langchain import get_floe_langchain_tools
+tools = get_floe_langchain_tools(wallet_provider)
+```
+
+### OpenAI Function Calling
+
+```python
+from floe_agentkit_actions.integrations.openai_agents import get_floe_openai_tools
+tools = get_floe_openai_tools(wallet_provider)
+```
+
+## Environment Variables
+
+```bash
+PRIVATE_KEY=0x...               # Wallet private key
+CDP_API_KEY_NAME=...            # Coinbase CDP API key name
+CDP_API_KEY_PRIVATE_KEY=...     # Coinbase CDP API secret
+OPENAI_API_KEY=sk-...           # OpenAI (for CLI)
+ANTHROPIC_API_KEY=sk-ant-...    # Anthropic (for CLI)
+BASE_RPC_URL=https://...        # Custom Base RPC (recommended)
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

floe_agentkit_actions-0.1.0/README.md

@@ -0,0 +1,130 @@
+# floe-agentkit-actions
+
+Coinbase AgentKit ActionProvider for the **Floe DeFi lending protocol** on Base.
+
+23 AI-agent actions for intent-based lending, flash loan arbitrage, and loan management.
+
+## Installation
+
+```bash
+pip install floe-agentkit-actions
+
+# With CLI support
+pip install floe-agentkit-actions[cli]
+
+# With LangChain integration
+pip install floe-agentkit-actions[langchain]
+```
+
+## Quick Start
+
+### As an AgentKit Provider
+
+```python
+from coinbase_agentkit import AgentKit, AgentKitConfig
+from floe_agentkit_actions import floe_action_provider
+
+agentkit = AgentKit(AgentKitConfig(
+    wallet_provider=wallet_provider,
+    action_providers=[floe_action_provider()],
+))
+```
+
+### Standalone Usage
+
+```python
+from floe_agentkit_actions import floe_action_provider
+
+floe = floe_action_provider()
+result = floe.get_price(wallet_provider, {
+    "collateral_token": "0x4200000000000000000000000000000000000006",  # WETH
+    "loan_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",      # USDC
+})
+print(result)
+```
+
+### CLI
+
+```bash
+floe-agent
+```
+
+Interactive AI-powered DeFi agent with support for OpenAI, Claude, and Ollama.
+
+## Actions (23)
+
+### Read (8)
+- `get_markets` — Query lending market info
+- `get_loan` — Get loan details
+- `get_my_loans` — All loans for connected wallet
+- `check_loan_health` — Health status and liquidation distance
+- `get_price` — Oracle price (Chainlink + Pyth)
+- `get_accrued_interest` — Interest accrued on a loan
+- `get_liquidation_quote` — Liquidation profit/loss breakdown
+- `get_intent_book` — Look up on-chain intent by hash
+
+### Write (7)
+- `post_lend_intent` — Post lending offer at fixed rate
+- `post_borrow_intent` — Post borrow request with collateral
+- `match_intents` — Match lend + borrow intents to create loan
+- `repay_loan` — Fully or partially repay loan
+- `add_collateral` — Add collateral to improve health
+- `withdraw_collateral` — Withdraw excess collateral
+- `liquidate_loan` — Liquidate unhealthy loan
+
+### Flash Loans (5)
+- `get_flash_loan_fee` — Query protocol flash fee
+- `estimate_flash_arb_profit` — Simulate multi-leg arb profit
+- `flash_loan` — Raw flash loan (receiver must be smart contract)
+- `flash_arb` — Flash arb via FlashArbReceiver
+- `get_flash_arb_balance` — Check accumulated profit
+
+### Deploy (3)
+- `deploy_flash_arb_receiver` — Deploy FlashArbReceiver with pre-flight checks
+- `check_flash_arb_readiness` — Environment readiness check
+- `verify_flash_arb_receiver` — Validate receiver configuration
+
+## Wallet Providers
+
+| Provider | Use Case |
+|----------|----------|
+| Private Key (`EvmWalletProvider`) | Development / scripting |
+| CDP (`CdpWalletProvider`) | Production agents (MPC) |
+
+## Framework Integrations
+
+### LangChain
+
+```python
+from floe_agentkit_actions.integrations.langchain import get_floe_langchain_tools
+tools = get_floe_langchain_tools(wallet_provider)
+```
+
+### OpenAI Function Calling
+
+```python
+from floe_agentkit_actions.integrations.openai_agents import get_floe_openai_tools
+tools = get_floe_openai_tools(wallet_provider)
+```
+
+## Environment Variables
+
+```bash
+PRIVATE_KEY=0x...               # Wallet private key
+CDP_API_KEY_NAME=...            # Coinbase CDP API key name
+CDP_API_KEY_PRIVATE_KEY=...     # Coinbase CDP API secret
+OPENAI_API_KEY=sk-...           # OpenAI (for CLI)
+ANTHROPIC_API_KEY=sk-ant-...    # Anthropic (for CLI)
+BASE_RPC_URL=https://...        # Custom Base RPC (recommended)
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT

floe_agentkit_actions-0.1.0/examples/.env.example

@@ -0,0 +1,11 @@
+# Wallet (choose one)
+PRIVATE_KEY=0x...your_private_key_here
+# CDP_API_KEY_NAME=your_cdp_api_key_name
+# CDP_API_KEY_PRIVATE_KEY=your_cdp_api_key_private_key
+
+# AI Provider (choose one)
+OPENAI_API_KEY=sk-...your_openai_key
+# ANTHROPIC_API_KEY=sk-ant-...your_anthropic_key
+
+# Optional: Custom RPC (recommended for production)
+# BASE_RPC_URL=https://mainnet.base.org

floe_agentkit_actions-0.1.0/examples/chatbot.py

@@ -0,0 +1,53 @@
+"""LangChain chatbot example with Floe actions.
+
+Run: PRIVATE_KEY=0x... OPENAI_API_KEY=sk-... python examples/chatbot.py
+Requires: pip install floe-agentkit-actions[langchain] langchain-openai langgraph
+"""
+
+from __future__ import annotations
+
+import os
+
+
+def main() -> None:
+    from coinbase_agentkit.wallet_providers import EvmWalletProvider
+    from langchain_openai import ChatOpenAI
+    from langgraph.prebuilt import create_react_agent
+
+    from floe_agentkit_actions.integrations.langchain import get_floe_langchain_tools
+
+    # Create wallet
+    private_key = os.environ.get("PRIVATE_KEY")
+    if not private_key:
+        print("Error: Set PRIVATE_KEY environment variable")
+        return
+
+    wallet_provider = EvmWalletProvider(
+        private_key=private_key,
+        network_id="base-mainnet",
+    )
+
+    # Get Floe tools as LangChain tools
+    tools = get_floe_langchain_tools(wallet_provider)
+    print(f"Loaded {len(tools)} Floe tools\n")
+
+    # Create LangChain agent
+    llm = ChatOpenAI(model="gpt-4o")
+    agent = create_react_agent(llm, tools)
+
+    # Chat loop
+    print("Floe DeFi Agent (type 'exit' to quit)\n")
+    while True:
+        user_input = input("You: ").strip()
+        if not user_input:
+            continue
+        if user_input.lower() in ("exit", "quit"):
+            break
+
+        response = agent.invoke({"messages": [("user", user_input)]})
+        last_msg = response["messages"][-1]
+        print(f"\nAssistant: {last_msg.content}\n")
+
+
+if __name__ == "__main__":
+    main()

floe_agentkit_actions-0.1.0/examples/standalone.py

@@ -0,0 +1,56 @@
+"""Standalone usage of FloeActionProvider — no AI framework required.
+
+Run: PRIVATE_KEY=0x... python examples/standalone.py
+Requires: PRIVATE_KEY environment variable
+"""
+
+from __future__ import annotations
+
+import os
+
+
+def main() -> None:
+    from coinbase_agentkit.wallet_providers import EvmWalletProvider
+
+    from floe_agentkit_actions import FloeConfig, floe_action_provider
+
+    # Create wallet provider
+    private_key = os.environ.get("PRIVATE_KEY")
+    if not private_key:
+        print("Error: Set PRIVATE_KEY environment variable")
+        return
+
+    rpc_url = os.environ.get("BASE_RPC_URL")
+    wallet_provider = EvmWalletProvider(
+        private_key=private_key,
+        network_id="base-mainnet",
+        **({"rpc_url": rpc_url} if rpc_url else {}),
+    )
+
+    address = wallet_provider.get_address()
+    print(f"Connected: {address}\n")
+
+    # Create Floe action provider
+    floe = floe_action_provider(FloeConfig())
+
+    # Example: Get oracle price
+    print("--- Oracle Price ---")
+    result = floe.get_price(wallet_provider, {
+        "collateral_token": "0x4200000000000000000000000000000000000006",  # WETH
+        "loan_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",  # USDC
+    })
+    print(result)
+
+    # Example: Get my loans
+    print("\n--- My Loans ---")
+    result = floe.get_my_loans(wallet_provider, {})
+    print(result)
+
+    # Example: Check flash loan fee
+    print("\n--- Flash Loan Fee ---")
+    result = floe.get_flash_loan_fee(wallet_provider, {})
+    print(result)
+
+
+if __name__ == "__main__":
+    main()

floe_agentkit_actions-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "floe-agentkit-actions"
+version = "0.1.0"
+description = "Coinbase AgentKit ActionProvider for Floe DeFi lending protocol on Base"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+keywords = ["defi", "lending", "agentkit", "coinbase", "ai-agent", "floe", "base"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+dependencies = [
+    "coinbase-agentkit>=0.7.0",
+    "web3>=7.0.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+cli = [
+    "questionary>=2.0.0",
+    "rich>=13.0.0",
+    "openai>=1.0.0",
+    "anthropic>=0.30.0",
+]
+langchain = [
+    "coinbase-agentkit-langchain>=0.1.0",
+    "langchain-openai>=0.1.0",
+]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-cov>=5.0.0",
+    "pytest-asyncio>=0.23.0",
+    "ruff>=0.4.0",
+    "mypy>=1.10.0",
+]
+
+[project.scripts]
+floe-agent = "floe_agentkit_actions.cli.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/floe_agentkit_actions"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.mypy]
+python_version = "3.10"
+strict = true

floe_agentkit_actions-0.1.0/src/floe_agentkit_actions/__init__.py

@@ -0,0 +1,28 @@
+"""Coinbase AgentKit ActionProvider for Floe DeFi lending protocol on Base.
+
+Usage::
+
+    from floe_agentkit_actions import floe_action_provider
+
+    provider = floe_action_provider()
+"""
+
+from __future__ import annotations
+
+from .action_provider import FloeActionProvider
+from .types import FloeConfig
+
+
+def floe_action_provider(config: FloeConfig | None = None) -> FloeActionProvider:
+    """Create a new FloeActionProvider instance.
+
+    Args:
+        config: Optional configuration with custom contract addresses and market IDs.
+
+    Returns:
+        A FloeActionProvider ready to register with AgentKit.
+    """
+    return FloeActionProvider(config)
+
+
+__all__ = ["FloeActionProvider", "FloeConfig", "floe_action_provider"]