feat: final submission (#16)

Author: lumoswiz

.env.example

@@ -0,0 +1,34 @@
+# -------------------------------
+# Bot variables
+# -------------------------------
+# ANTHROPIC_API_KEY: Your Anthropic API key used by the PydanticAI agent.
+export ANTHROPIC_API_KEY=
+
+# ENCOURAGE_TRADE: When set (e.g., python booleans, True), it injects a system prompt to encourage the agent to trade during its next decision period.
+export ENCOURAGE_TRADE=
+
+# START_BLOCK: The block number at which the bot catches up on CoW Swap trades from upon first startup.
+export START_BLOCK=
+
+# -------------------------------
+# Web3 variables
+# -------------------------------
+# PRIVATE_KEY: The agent's private key for signing transactions.
+export PRIVATE_KEY=
+
+# WEB3_ALCHEMY_PROJECT_ID: Your Alchemy project ID used as the default provider by bot.py with the ape-alchemy plugin.
+export WEB3_ALCHEMY_PROJECT_ID=
+
+# GNOSISSCAN_API_KEY: API key for Gnosisscan, which lets bot.py automatically fetch and cache ABIs for contracts with ape-etherscan plugin.
+export GNOSISSCAN_API_KEY=
+
+# CHAIN_ID: The chain ID required by smart-contract-infra for deploying and configuring agent-safe components.
+export CHAIN_ID=
+
+# SAFE_ADDRESS: (Optional) The Safe address to interact with. Set this if you already have a deployed Safe.
+export SAFE_ADDRESS=
+
+# TRADING_MODULE_ADDRESS: (Optional) The deployed trading module proxy address. Set this if available.
+export TRADING_MODULE_ADDRESS=
+
+

LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lumoswiz
+
+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.

README.md

@@ -0,0 +1,68 @@
+# Moozilla x Kong [![Open in Gitpod][gitpod-badge]][gitpod] [![CI Status][ci-badge]][ci] [![Built with Silverback][silverback-badge]][silverback] [![License: MIT][license-badge]][license]
+
+[gitpod]: https://gitpod.io/#https://github.com/lumoswiz/cow-agent
+[gitpod-badge]: https://img.shields.io/badge/Gitpod-Open%20in%20Gitpod-FFB45B?logo=gitpod
+[ci]: https://github.com/lumoswiz/cow-agent/actions
+[ci-badge]: https://github.com/lumoswiz/cow-agent/actions/workflows/ci.yml/badge.svg
+[silverback]: https://github.com/ApeWorX/silverback
+[silverback-badge]: https://img.shields.io/badge/Built%20with-Silverback-blue?style=flat-square
+[license]: https://opensource.org/licenses/MIT
+[license-badge]: https://img.shields.io/badge/License-MIT-yellow.svg
+
+Welcome to **Moozilla x Kong**  
+Your project description goes here...
+
+## Development Prerequisites
+
+- **[Bun](https://bun.sh)** `v1.1.31`
+- **[uv](https://docs.astral.sh/uv/getting-started/)** `v0.5.26`
+
+## Monorepo Contents
+
+This repository is organized as a **monorepo** and contains multiple related projects:
+
+- **CoW Trader:** A Silverback CoW Swap trading bot that uses PydanticAI as the agent framework.
+- **Smart Contract Infra:** Provides the smart contract development,deployment and configuration scripts for:
+  - The token allowlist governance mechanism.
+  - Setting up a new Safe or bringing your own.
+  - Deploying a trading module proxy enabled on the Safe.
+  - Configuring the module on the Safe with the guard and enable the agent to trade via the module.
+
+Each project is maintained in its own subdirectory and may have additional project-specific configuration and dependencies. However, they all share a centralized `.env` file located at the repository root.
+
+## Project Specific Configuration
+
+While a centralized `.env` file is used for common environment variables, each project in this monorepo may have additional settings and build steps:
+
+- **CoW Trader:**  
+  This project might require extra, project-specific configuration. Please refer to the [CoW Trader README](./path/to/cow-trader/README.md) for full setup instructions.
+
+- **Smart Contract Infra:**  
+  Building and deploying the contract components is handled separately. Detailed instructions are available in the [Smart Contract Infra README](./path/to/smart-contract-infra/README.md).
+
+### Environment Variables
+
+Each variable is explained in the `.env.example` file. Be sure to copy `.env.example` to `.env` and fill in the required values:
+
+- **PydanticAI Variables:**
+
+  - `ANTHROPIC_API_KEY`
+  - `ENCOURAGE_TRADE`
+
+- **Bot Variables:**
+
+  - `START_BLOCK`
+
+- **Web3 Variables:**
+  - `PRIVATE_KEY`
+  - `WEB3_ALCHEMY_PROJECT_ID`
+  - `GNOSISSCAN_API_KEY`
+  - `CHAIN_ID`
+  - `SAFE_ADDRESS` (optional)
+  - `TRADING_MODULE_ADDRESS` (optional)
+
+This setup allows you to configure both individual projects while sharing common environment variables.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

cow-trader/README.md

@@ -12,6 +12,12 @@ Create venv and install dependencies:
 uv sync --all-extras --dev
 ```
 
+Venv:
+
+```bash
+source .venv/bin/activate
+```
+
 Install all Ape framework plugins:
 
 ```bash
@@ -20,6 +26,58 @@ ape plugins install .
 
 ## Run Silverback Bot
 
+Before running the bot, ensure you've set up an account alias as outlined in the [Ape Accounts documentation](https://docs.apeworx.io/ape/stable/userguides/accounts.html).
+
+Once your account alias is ready (e.g. `cow-agent`), you can run the bot:
+
 ```bash
 silverback run --network gnosis:mainnet:alchemy --account cow-agent
 ```
+
+This command uses the alias you configured as the signer. There will be a prompt asking if you want to enable auto-signing.
+
+### Bot Overview
+
+The bot continuously monitors new blocks and manages trading through two primary block handlers:
+
+- **update_state:**
+
+  - Processes each new block to fetch and update CoW Swap trade data.
+  - Tracks key events (e.g. recent trades, block numbers) and updates local storage (e.g. `trades.csv`, `block.csv`, `orders.csv`, `reasoning.csv`, `decisions.csv`).
+  - Controls whether trading is enabled based on a cooldown and past decisions.
+
+- **make_trading_decision:**
+  - When permitted, it builds a **TradeContext** from recent trade events and past decisions.
+  - Provides this context to an AI agent (with tools like token naming, token type, and eligible buy tokens) along with a system prompt (stored in `system_prompt.txt`).
+  - The agent returns a decision on whether to trade and which token to buy.
+  - If a trade is executed, the bot builds a CoW Swap order (via a quote → order payload → submit → pre-sign sequence using the TradingModule).
+  - A trading cooldown is applied after executing a trade.
+
+Other key components include:
+
+- **Agent Architecture:**
+
+  - The agent receives an aggregated **TradeContext** via **AgentDependencies** and produces an **AgentResponse** that's converted to an **AgentDecision**.
+  - Past decisions (and their outcomes) are fed back to refine future trading decisions.
+
+  - **Contract Address Configuration:**
+    - The `TOKEN_ALLOWLIST_ADDRESS` is loaded from [deployments](../smart-contract-infra/deployments/contracts.json) (for chain ID 100).
+    - The `SAFE_ADDRESS` and `TRADING_MODULE_ADDRESS` are taken from environment variables if set; otherwise, they default to the values in deployments.
+
+- **Local Storage Helpers:**
+
+  - Utility functions load and persist state data (trades, orders, decisions, and processed blocks) in CSV files.
+
+- **CoW Swap Trading Functions:**
+
+  - Dedicated functions handle constructing, submitting, and signing orders through the CoW Swap orderbook API and TradingModule.
+
+- **Initialization:**
+  - On startup (`bot_startup`), the bot loads persistent state, catches up on historical trades, and optionally enables auto-signing.
+  - During worker initialization (`worker_startup`), each worker (both block handlers) gets access to shared state—including the trading agent instance, historical trades, and past decisions.
+
+This design ensures the bot continuously tracks market activity, leverages an AI agent for dynamic decision-making, and safely executes trades on CoW Swap.
+
+## Acknowledgements
+
+- [Marginal Protocol](https://github.com/MarginalProtocol/v1-liquidator-bot)

cow-trader/ape-config.yaml

@@ -9,3 +9,7 @@ plugins:
     version: 0.8.7
   - name: solidity
     version: 0.8.5
+
+gnosis:
+  mainnet:
+    transaction_acceptance_timeout: 120 # 2 minutes

cow-trader/bot.py

@@ -32,19 +32,41 @@
 DECISIONS_FILEPATH = os.environ.get("DECISIONS_FILEPATH", ".db/decisions.csv")
 REASONING_FILEPATH = os.environ.get("REASONING_FILEPATH", ".db/reasoning.csv")
 
+
+# Loading contract helper functions
+def _load_contracts_deployments(
+    filepath: str = "../smart-contract-infra/deployments/contracts.json",
+) -> dict:
+    with Path(filepath).open() as f:
+        return json.load(f)
+
+
+def _get_contract_address(contract_key: str, chain_id: int = 100) -> str:
+    contracts = _load_contracts_deployments()
+    chain_key = str(chain_id)
+    try:
+        return contracts["chains"][chain_key][contract_key]
+    except KeyError:
+        raise Exception(f"{contract_key} not found for chain ID {chain_id}")
+
+
 # Addresses
-SAFE_ADDRESS = "0xbc3c7818177dA740292659b574D48B699Fdf0816"
-TOKEN_ALLOWLIST_ADDRESS = "0x98a4351d926e6274829c3807f39D9a7037462589"
 GPV2_SETTLEMENT_ADDRESS = "0x9008D19f58AAbD9eD0D60971565AA8510560ab41"
-TRADING_MODULE_ADDRESS = "0xF11bC1ff8Ab8Cc297e5a1f1A51B8d1792E99D648"
+TOKEN_ALLOWLIST_ADDRESS = os.environ.get(
+    "TOKEN_ALLOWLIST_ADDRESS", _get_contract_address("allowlist", 100)
+)
+SAFE_ADDRESS = os.environ.get("SAFE_ADDRESS", _get_contract_address("safe", 100))
+TRADING_MODULE_ADDRESS = os.environ.get(
+    "TRADING_MODULE_ADDRESS", _get_contract_address("tradingModuleProxy", 100)
+)
 
 GNO = "0x9C58BAcC331c9aa871AFD802DB6379a98e80CEdb"
 COW = "0x177127622c4A00F3d409B75571e12cB3c8973d3c"
 WXDAI = "0xe91D153E0b41518A2Ce8Dd3D7944Fa863463a97d"
 MONITORED_TOKENS = [GNO, COW, WXDAI]
 
 MINIMUM_TOKEN_BALANCES = {
-    GNO: 116,
+    GNO: 55e14,
     COW: 10e18,
     WXDAI: 5e18,
 }
@@ -70,8 +92,6 @@ def _load_abi(abi_name: str) -> Dict:
 
 # Variables
 START_BLOCK = int(os.environ.get("START_BLOCK", chain.blocks.head.number))
-HISTORICAL_BLOCK_STEP = int(os.environ.get("HISTORICAL_BLOCK_STEP", 720))
-EXTENSION_INTERVAL = int(os.environ.get("EXTENSION_INTERVAL", 6))
 TRADING_BLOCK_COOLDOWN = int(os.environ.get("TRADING_BLOCK_COOLDOWN", 360))
 SYSTEM_PROMPT = Path("./system_prompt.txt").read_text().strip()
 
@@ -535,11 +555,6 @@ def _get_canonical_pair(token_a: str, token_b: str) -> tuple[str, str]:
     return (token_a, token_b) if token_a.lower() < token_b.lower() else (token_b, token_a)
 
 
-def _calculate_price(sell_amount: str, buy_amount: str) -> float:
-    """Calculate price from amounts"""
-    return int(sell_amount) / int(buy_amount)
-
-
 def _process_trade_log(log) -> Dict:
     """
     Process trade log and compute canonical price as: