hak-saucerswap-plugin 0.1.0__tar.gz

hak_saucerswap_plugin-0.1.0/.env.example

@@ -0,0 +1,8 @@
+# Hedera operator (consumer app constructs the Client)
+HEDERA_OPERATOR_ID=
+HEDERA_OPERATOR_KEY=
+
+# SaucerSwap plugin
+# Request an API key at support@saucerswap.finance
+SAUCERSWAP_API_KEY=
+SAUCERSWAP_NETWORK=mainnet

hak_saucerswap_plugin-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --python ${{ matrix.python-version }}
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Test
+        run: uv run pytest -q
+
+      - name: Build
+        run: uv build

hak_saucerswap_plugin-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,23 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for PyPI Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Build
+        run: uv build
+
+      - name: Publish
+        uses: pypa/gh-action-pypi-publish@release/v1

hak_saucerswap_plugin-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+.env
+.pytest_cache/
+.ruff_cache/

hak_saucerswap_plugin-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: hak-saucerswap-plugin
+Version: 0.1.0
+Summary: Hedera Agent Kit (Python) plugin for SaucerSwap DEX: quotes, swaps, liquidity, pools, and farms
+Project-URL: Repository, https://github.com/jmgomezl/hak-saucerswap-plugin-py
+Project-URL: Documentation, https://github.com/jmgomezl/hak-saucerswap-plugin-py#readme
+Author-email: Juan Gomez <juanmag.lpez@gmail.com>
+License: MIT
+Keywords: agent,ai,dex,hashgraph,hedera,hedera-agent-kit,saucerswap
+Requires-Python: <3.14,>=3.10
+Requires-Dist: hedera-agent-kit<4,>=3.4.2
+Requires-Dist: hiero-sdk-python<0.3,>=0.2.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.7
+Description-Content-Type: text/markdown
+
+# hak-saucerswap-plugin (Python)
+
+A [Hedera Agent Kit](https://github.com/hashgraph/hedera-agent-kit-py) plugin that integrates the [SaucerSwap](https://saucerswap.finance) DEX, letting AI agents quote swaps, execute trades, manage liquidity, and explore farming opportunities on Hedera.
+
+Python port of the TypeScript plugin [`hak-saucerswap-plugin`](https://github.com/jmgomezl/hak-saucerswap-plugin).
+
+## Tools
+
+| Method | Description | On-chain |
+| --- | --- | --- |
+| `saucerswap_get_swap_quote` | Price quote with min output, price impact, and route | No |
+| `saucerswap_swap_tokens` | Execute a swap via the router (`swapExactTokensForTokens`) | Yes |
+| `saucerswap_get_pools` | List/filter liquidity pools and reserves | No |
+| `saucerswap_add_liquidity` | Add liquidity to a pool (`addLiquidity`) | Yes |
+| `saucerswap_remove_liquidity` | Burn LP tokens for the underlying pair (`removeLiquidity`) | Yes |
+| `saucerswap_get_farms` | List active yield farms | No |
+
+## Installation
+
+```bash
+pip install hak-saucerswap-plugin
+```
+
+## Usage
+
+```python
+from hedera_agent_kit.shared.configuration import AgentMode, Configuration, Context
+from hak_saucerswap_plugin import saucerswap_plugin
+
+context = Context(account_id="0.0.xxxx", mode=AgentMode.AUTONOMOUS)
+# Attach plugin configuration to the context (optional; env vars also work):
+context.saucerswap = {"network": "mainnet"}
+
+configuration = Configuration(plugins=[saucerswap_plugin], context=context)
+```
+
+## Configuration
+
+Settings resolve with this precedence: context config → environment variables → network defaults → built-in defaults.
+
+| Context key | Env var | Description | Default |
+| --- | --- | --- | --- |
+| `base_url` | `SAUCERSWAP_BASE_URL` | SaucerSwap REST API base URL | `https://api.saucerswap.finance` |
+| `api_key` | `SAUCERSWAP_API_KEY` | API key sent as `x-api-key` (request at support@saucerswap.finance) | — |
+| `network` | `SAUCERSWAP_NETWORK` | `mainnet` or `testnet`; fills router/WHBAR/alias defaults | — |
+| `timeout_seconds` | `SAUCERSWAP_TIMEOUT_SECONDS` | HTTP timeout in seconds | `10` |
+| `retries` | `SAUCERSWAP_RETRIES` | Retries for 429/5xx/transport errors | `2` |
+| `router_contract_id` | `SAUCERSWAP_ROUTER_CONTRACT_ID` | V1 router contract ID | from network |
+| `router_v2_contract_id` | `SAUCERSWAP_ROUTER_V2_CONTRACT_ID` | V2 router contract ID | from network |
+| `wrapped_hbar_token_id` | `SAUCERSWAP_WRAPPED_HBAR_TOKEN_ID` | WHBAR token ID (used for the `HBAR` alias) | from network |
+| `token_aliases` | `SAUCERSWAP_TOKEN_ALIASES` | Symbol → token ID map (env var takes JSON) | from network |
+| `default_pool_version` | `SAUCERSWAP_DEFAULT_POOL_VERSION` | `v1` or `v2` | `v2` |
+| `gas_limit` | `SAUCERSWAP_GAS_LIMIT` | Gas limit for router calls | `2000000` |
+| `deadline_minutes` | `SAUCERSWAP_DEADLINE_MINUTES` | Default transaction deadline | `20` |
+
+Network defaults (contract addresses from the [official SaucerSwap deployments](https://docs.saucerswap.finance/developerx/contract-deployments)) are exported as `SAUCERSWAP_MAINNET` and `SAUCERSWAP_TESTNET`.
+
+A pre-configured `httpx.AsyncClient` can also be injected by attaching it to the context as `context.saucerswap_client` (e.g. to share auth headers or transports).
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check .
+```
+
+## License
+
+MIT

hak_saucerswap_plugin-0.1.0/README.md

@@ -0,0 +1,70 @@
+# hak-saucerswap-plugin (Python)
+
+A [Hedera Agent Kit](https://github.com/hashgraph/hedera-agent-kit-py) plugin that integrates the [SaucerSwap](https://saucerswap.finance) DEX, letting AI agents quote swaps, execute trades, manage liquidity, and explore farming opportunities on Hedera.
+
+Python port of the TypeScript plugin [`hak-saucerswap-plugin`](https://github.com/jmgomezl/hak-saucerswap-plugin).
+
+## Tools
+
+| Method | Description | On-chain |
+| --- | --- | --- |
+| `saucerswap_get_swap_quote` | Price quote with min output, price impact, and route | No |
+| `saucerswap_swap_tokens` | Execute a swap via the router (`swapExactTokensForTokens`) | Yes |
+| `saucerswap_get_pools` | List/filter liquidity pools and reserves | No |
+| `saucerswap_add_liquidity` | Add liquidity to a pool (`addLiquidity`) | Yes |
+| `saucerswap_remove_liquidity` | Burn LP tokens for the underlying pair (`removeLiquidity`) | Yes |
+| `saucerswap_get_farms` | List active yield farms | No |
+
+## Installation
+
+```bash
+pip install hak-saucerswap-plugin
+```
+
+## Usage
+
+```python
+from hedera_agent_kit.shared.configuration import AgentMode, Configuration, Context
+from hak_saucerswap_plugin import saucerswap_plugin
+
+context = Context(account_id="0.0.xxxx", mode=AgentMode.AUTONOMOUS)
+# Attach plugin configuration to the context (optional; env vars also work):
+context.saucerswap = {"network": "mainnet"}
+
+configuration = Configuration(plugins=[saucerswap_plugin], context=context)
+```
+
+## Configuration
+
+Settings resolve with this precedence: context config → environment variables → network defaults → built-in defaults.
+
+| Context key | Env var | Description | Default |
+| --- | --- | --- | --- |
+| `base_url` | `SAUCERSWAP_BASE_URL` | SaucerSwap REST API base URL | `https://api.saucerswap.finance` |
+| `api_key` | `SAUCERSWAP_API_KEY` | API key sent as `x-api-key` (request at support@saucerswap.finance) | — |
+| `network` | `SAUCERSWAP_NETWORK` | `mainnet` or `testnet`; fills router/WHBAR/alias defaults | — |
+| `timeout_seconds` | `SAUCERSWAP_TIMEOUT_SECONDS` | HTTP timeout in seconds | `10` |
+| `retries` | `SAUCERSWAP_RETRIES` | Retries for 429/5xx/transport errors | `2` |
+| `router_contract_id` | `SAUCERSWAP_ROUTER_CONTRACT_ID` | V1 router contract ID | from network |
+| `router_v2_contract_id` | `SAUCERSWAP_ROUTER_V2_CONTRACT_ID` | V2 router contract ID | from network |
+| `wrapped_hbar_token_id` | `SAUCERSWAP_WRAPPED_HBAR_TOKEN_ID` | WHBAR token ID (used for the `HBAR` alias) | from network |
+| `token_aliases` | `SAUCERSWAP_TOKEN_ALIASES` | Symbol → token ID map (env var takes JSON) | from network |
+| `default_pool_version` | `SAUCERSWAP_DEFAULT_POOL_VERSION` | `v1` or `v2` | `v2` |
+| `gas_limit` | `SAUCERSWAP_GAS_LIMIT` | Gas limit for router calls | `2000000` |
+| `deadline_minutes` | `SAUCERSWAP_DEADLINE_MINUTES` | Default transaction deadline | `20` |
+
+Network defaults (contract addresses from the [official SaucerSwap deployments](https://docs.saucerswap.finance/developerx/contract-deployments)) are exported as `SAUCERSWAP_MAINNET` and `SAUCERSWAP_TESTNET`.
+
+A pre-configured `httpx.AsyncClient` can also be injected by attaching it to the context as `context.saucerswap_client` (e.g. to share auth headers or transports).
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check .
+```
+
+## License
+
+MIT

hak_saucerswap_plugin-0.1.0/hak_saucerswap_plugin/__init__.py

@@ -0,0 +1,70 @@
+"""hak-saucerswap-plugin: Hedera Agent Kit (Python) plugin for the SaucerSwap DEX."""
+
+from hedera_agent_kit.shared.plugin import Plugin
+
+from .config import SaucerSwapConfig, resolve_saucerswap_config
+from .networks import (
+    NETWORK_DEFAULTS,
+    SAUCERSWAP_MAINNET,
+    SAUCERSWAP_TESTNET,
+    SaucerSwapNetworkDefaults,
+)
+from .tools import (
+    SAUCERSWAP_ADD_LIQUIDITY_TOOL,
+    SAUCERSWAP_GET_FARMS_TOOL,
+    SAUCERSWAP_GET_POOLS_TOOL,
+    SAUCERSWAP_GET_SWAP_QUOTE_TOOL,
+    SAUCERSWAP_REMOVE_LIQUIDITY_TOOL,
+    SAUCERSWAP_SWAP_TOKENS_TOOL,
+    AddLiquidityTool,
+    FarmsTool,
+    PoolsTool,
+    QuoteTool,
+    RemoveLiquidityTool,
+    SwapTool,
+)
+
+__version__ = "0.1.0"
+
+saucerswap_plugin_tool_names = {
+    "SAUCERSWAP_GET_SWAP_QUOTE_TOOL": SAUCERSWAP_GET_SWAP_QUOTE_TOOL,
+    "SAUCERSWAP_SWAP_TOKENS_TOOL": SAUCERSWAP_SWAP_TOKENS_TOOL,
+    "SAUCERSWAP_GET_POOLS_TOOL": SAUCERSWAP_GET_POOLS_TOOL,
+    "SAUCERSWAP_ADD_LIQUIDITY_TOOL": SAUCERSWAP_ADD_LIQUIDITY_TOOL,
+    "SAUCERSWAP_REMOVE_LIQUIDITY_TOOL": SAUCERSWAP_REMOVE_LIQUIDITY_TOOL,
+    "SAUCERSWAP_GET_FARMS_TOOL": SAUCERSWAP_GET_FARMS_TOOL,
+}
+
+saucerswap_plugin = Plugin(
+    name="saucerswap",
+    version=__version__,
+    description=(
+        "Integration with SaucerSwap DEX for token swaps, liquidity provision, "
+        "and yield farming"
+    ),
+    tools=lambda context: [
+        SwapTool(context),
+        QuoteTool(context),
+        PoolsTool(context),
+        AddLiquidityTool(context),
+        RemoveLiquidityTool(context),
+        FarmsTool(context),
+    ],
+)
+
+__all__ = [
+    "saucerswap_plugin",
+    "saucerswap_plugin_tool_names",
+    "SaucerSwapConfig",
+    "resolve_saucerswap_config",
+    "SaucerSwapNetworkDefaults",
+    "SAUCERSWAP_MAINNET",
+    "SAUCERSWAP_TESTNET",
+    "NETWORK_DEFAULTS",
+    "SwapTool",
+    "QuoteTool",
+    "PoolsTool",
+    "AddLiquidityTool",
+    "RemoveLiquidityTool",
+    "FarmsTool",
+]

hak_saucerswap_plugin-0.1.0/hak_saucerswap_plugin/api/__init__.py

@@ -0,0 +1,4 @@
+from .client import SaucerSwapClient, create_saucerswap_client
+from .endpoints import SAUCER_ENDPOINTS
+
+__all__ = ["SaucerSwapClient", "create_saucerswap_client", "SAUCER_ENDPOINTS"]

hak_saucerswap_plugin-0.1.0/hak_saucerswap_plugin/api/client.py

@@ -0,0 +1,147 @@
+"""Async HTTP client for the SaucerSwap REST API with retries and token caching."""
+
+from __future__ import annotations
+
+import asyncio
+import re
+from typing import Any
+
+import httpx
+
+from .endpoints import SAUCER_ENDPOINTS
+
+TOKEN_ID_RE = re.compile(r"^\d+\.\d+\.\d+$")
+
+RETRYABLE_STATUS = {429}
+
+
+def _is_retryable_status(status: int) -> bool:
+    return status in RETRYABLE_STATUS or 500 <= status < 600
+
+
+class SaucerSwapClient:
+    """Thin wrapper over the SaucerSwap REST API.
+
+    Accepts an optional pre-configured ``httpx.AsyncClient`` (``http``) so a
+    host application can inject auth headers or custom transports.
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: str = "https://api.saucerswap.finance",
+        timeout_seconds: float = 10.0,
+        retries: int = 2,
+        api_key: str | None = None,
+        http: httpx.AsyncClient | None = None,
+    ):
+        self.retries = retries
+        if http is not None:
+            self._http = http
+        else:
+            headers = {"x-api-key": api_key} if api_key else None
+            self._http = httpx.AsyncClient(
+                base_url=base_url, timeout=timeout_seconds, headers=headers
+            )
+        self._tokens_cache: list[dict[str, Any]] | None = None
+        self._token_index: dict[str, dict[str, Any]] | None = None
+
+    async def _request(self, path: str, params: dict[str, Any] | None = None) -> Any:
+        last_error: Exception | None = None
+        for attempt in range(self.retries + 1):
+            try:
+                response = await self._http.get(path, params=params)
+                if _is_retryable_status(response.status_code) and attempt < self.retries:
+                    await asyncio.sleep(0.2 * 2**attempt)
+                    continue
+                response.raise_for_status()
+                return response.json()
+            except (httpx.TransportError, httpx.HTTPStatusError) as error:
+                last_error = error
+                retryable = isinstance(error, httpx.TransportError) or (
+                    isinstance(error, httpx.HTTPStatusError)
+                    and _is_retryable_status(error.response.status_code)
+                )
+                if attempt < self.retries and retryable:
+                    await asyncio.sleep(0.2 * 2**attempt)
+                    continue
+                raise
+        raise last_error if last_error else RuntimeError("SaucerSwap request failed")
+
+    async def get_tokens(self) -> list[dict[str, Any]]:
+        tokens = await self._request(SAUCER_ENDPOINTS["tokens"])
+        self._cache_tokens(tokens)
+        return tokens
+
+    async def get_token_by_id_or_symbol(self, value: str) -> dict[str, Any] | None:
+        if self._token_index is None:
+            await self.get_tokens()
+        assert self._token_index is not None
+        return self._token_index.get(value.lower())
+
+    async def resolve_token_id(self, value: str) -> str:
+        if TOKEN_ID_RE.match(value):
+            return value
+        token = await self.get_token_by_id_or_symbol(value)
+        return token["id"] if token else value
+
+    async def get_pools(self, version: str) -> list[dict[str, Any]]:
+        endpoint = (
+            SAUCER_ENDPOINTS["pools_v1"] if version == "v1" else SAUCER_ENDPOINTS["pools_v2"]
+        )
+        return await self._request(endpoint)
+
+    async def get_pool_by_tokens(
+        self, token_a: str, token_b: str, version: str
+    ) -> dict[str, Any] | None:
+        pools = await self.get_pools(version)
+        for pool in pools:
+            a = pool.get("tokenA", {}).get("id")
+            b = pool.get("tokenB", {}).get("id")
+            if (a == token_a and b == token_b) or (a == token_b and b == token_a):
+                return pool
+        return None
+
+    async def get_swap_quote(
+        self, *, from_token: str, to_token: str, amount: str
+    ) -> dict[str, Any]:
+        return await self._request(
+            SAUCER_ENDPOINTS["swap_quote"],
+            params={
+                "tokenIn": from_token,
+                "tokenOut": to_token,
+                "amount": amount,
+                "fromToken": from_token,
+                "toToken": to_token,
+            },
+        )
+
+    async def get_farms(self) -> list[dict[str, Any]]:
+        return await self._request(SAUCER_ENDPOINTS["farms"])
+
+    async def get_stats(self) -> dict[str, Any]:
+        return await self._request(SAUCER_ENDPOINTS["stats"])
+
+    async def aclose(self) -> None:
+        await self._http.aclose()
+
+    def _cache_tokens(self, tokens: list[dict[str, Any]]) -> None:
+        self._tokens_cache = tokens
+        self._token_index = {}
+        for token in tokens:
+            for key in ("id", "symbol", "name"):
+                value = token.get(key)
+                if isinstance(value, str):
+                    self._token_index[value.lower()] = token
+
+
+def create_saucerswap_client(
+    config: Any, http: httpx.AsyncClient | None = None
+) -> SaucerSwapClient:
+    return SaucerSwapClient(
+        base_url=config.base_url,
+        timeout_seconds=config.timeout_seconds,
+        retries=config.retries,
+        api_key=config.api_key,
+        http=http,
+    )

hak_saucerswap_plugin-0.1.0/hak_saucerswap_plugin/api/endpoints.py

@@ -0,0 +1,8 @@
+SAUCER_ENDPOINTS = {
+    "pools_v1": "/pools",
+    "pools_v2": "/v2/pools",
+    "swap_quote": "/v1/swap/quote",
+    "tokens": "/tokens",
+    "farms": "/farms",
+    "stats": "/stats",
+}

hak_saucerswap_plugin-0.1.0/hak_saucerswap_plugin/config.py

@@ -0,0 +1,148 @@
+"""Configuration resolution for the SaucerSwap plugin.
+
+Precedence (highest first): context-attached config -> environment variables
+-> network defaults -> built-in defaults. Mirrors the TypeScript plugin's
+`resolveSaucerSwapConfig`.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from dataclasses import dataclass, field
+from typing import Any
+
+from .networks import NETWORK_DEFAULTS
+
+PoolVersion = str  # "v1" | "v2"
+
+DEFAULT_BASE_URL = "https://api.saucerswap.finance"
+DEFAULT_TIMEOUT_SECONDS = 10.0
+DEFAULT_RETRIES = 2
+DEFAULT_POOL_VERSION: PoolVersion = "v2"
+DEFAULT_GAS_LIMIT = 2_000_000
+DEFAULT_DEADLINE_MINUTES = 20
+
+
+@dataclass
+class SaucerSwapConfig:
+    base_url: str = DEFAULT_BASE_URL
+    timeout_seconds: float = DEFAULT_TIMEOUT_SECONDS
+    retries: int = DEFAULT_RETRIES
+    api_key: str | None = None
+    network: str | None = None
+    router_contract_id: str | None = None
+    router_v2_contract_id: str | None = None
+    wrapped_hbar_token_id: str | None = None
+    token_aliases: dict[str, str] = field(default_factory=dict)
+    default_pool_version: PoolVersion = DEFAULT_POOL_VERSION
+    gas_limit: int = DEFAULT_GAS_LIMIT
+    deadline_minutes: int = DEFAULT_DEADLINE_MINUTES
+
+
+def _to_number(value: str | None, fallback: float) -> float:
+    if not value:
+        return fallback
+    try:
+        return float(value)
+    except ValueError:
+        return fallback
+
+
+def _to_int(value: str | None, fallback: int) -> int:
+    if not value:
+        return fallback
+    try:
+        return int(float(value))
+    except ValueError:
+        return fallback
+
+
+def _read_token_aliases(value: str | None) -> dict[str, str]:
+    if not value:
+        return {}
+    try:
+        parsed = json.loads(value)
+    except json.JSONDecodeError:
+        return {}
+    if isinstance(parsed, dict):
+        return {str(k): str(v) for k, v in parsed.items()}
+    return {}
+
+
+def _read_pool_version(value: str | None) -> PoolVersion | None:
+    return value if value in ("v1", "v2") else None
+
+
+def _read_network(value: str | None) -> str | None:
+    return value if value in ("mainnet", "testnet") else None
+
+
+def _read_context_config(context: Any) -> dict[str, Any]:
+    """Extract plugin config attached to the runtime context.
+
+    Supports a `saucerswap` attribute (or key) on the context holding either a
+    dict or a SaucerSwapConfig-like object.
+    """
+    if context is None:
+        return {}
+    raw = None
+    if isinstance(context, dict):
+        raw = context.get("saucerswap")
+    else:
+        raw = getattr(context, "saucerswap", None)
+    if raw is None:
+        return {}
+    if isinstance(raw, dict):
+        return dict(raw)
+    if isinstance(raw, SaucerSwapConfig):
+        return {k: v for k, v in vars(raw).items()}
+    return {k: v for k, v in vars(raw).items() if not k.startswith("_")}
+
+
+def resolve_saucerswap_config(context: Any = None) -> SaucerSwapConfig:
+    ctx = _read_context_config(context)
+
+    network = _read_network(ctx.get("network")) or _read_network(
+        os.environ.get("SAUCERSWAP_NETWORK")
+    )
+    defaults = NETWORK_DEFAULTS.get(network) if network else None
+
+    env_aliases = _read_token_aliases(os.environ.get("SAUCERSWAP_TOKEN_ALIASES"))
+    env_pool_version = _read_pool_version(os.environ.get("SAUCERSWAP_DEFAULT_POOL_VERSION"))
+
+    token_aliases: dict[str, str] = {}
+    if defaults:
+        token_aliases.update(defaults.token_aliases)
+    token_aliases.update(env_aliases)
+    token_aliases.update(ctx.get("token_aliases") or {})
+
+    return SaucerSwapConfig(
+        base_url=ctx.get("base_url")
+        or os.environ.get("SAUCERSWAP_BASE_URL")
+        or DEFAULT_BASE_URL,
+        timeout_seconds=ctx.get("timeout_seconds")
+        or _to_number(os.environ.get("SAUCERSWAP_TIMEOUT_SECONDS"), DEFAULT_TIMEOUT_SECONDS),
+        retries=ctx.get("retries")
+        if ctx.get("retries") is not None
+        else _to_int(os.environ.get("SAUCERSWAP_RETRIES"), DEFAULT_RETRIES),
+        api_key=ctx.get("api_key") or os.environ.get("SAUCERSWAP_API_KEY"),
+        network=network,
+        router_contract_id=ctx.get("router_contract_id")
+        or os.environ.get("SAUCERSWAP_ROUTER_CONTRACT_ID")
+        or (defaults.router_contract_id if defaults else None),
+        router_v2_contract_id=ctx.get("router_v2_contract_id")
+        or os.environ.get("SAUCERSWAP_ROUTER_V2_CONTRACT_ID")
+        or (defaults.router_v2_contract_id if defaults else None),
+        wrapped_hbar_token_id=ctx.get("wrapped_hbar_token_id")
+        or os.environ.get("SAUCERSWAP_WRAPPED_HBAR_TOKEN_ID")
+        or (defaults.wrapped_hbar_token_id if defaults else None),
+        token_aliases=token_aliases,
+        default_pool_version=ctx.get("default_pool_version")
+        or env_pool_version
+        or DEFAULT_POOL_VERSION,
+        gas_limit=ctx.get("gas_limit")
+        or _to_int(os.environ.get("SAUCERSWAP_GAS_LIMIT"), DEFAULT_GAS_LIMIT),
+        deadline_minutes=ctx.get("deadline_minutes")
+        or _to_int(os.environ.get("SAUCERSWAP_DEADLINE_MINUTES"), DEFAULT_DEADLINE_MINUTES),
+    )

hak_saucerswap_plugin-0.1.0/hak_saucerswap_plugin/networks.py

@@ -0,0 +1,42 @@
+"""Official SaucerSwap contract addresses per Hedera network.
+
+Source: https://docs.saucerswap.finance/developerx/contract-deployments
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+
+@dataclass(frozen=True)
+class SaucerSwapNetworkDefaults:
+    router_contract_id: str
+    router_v2_contract_id: str
+    wrapped_hbar_token_id: str
+    token_aliases: dict[str, str] = field(default_factory=dict)
+
+
+SAUCERSWAP_MAINNET = SaucerSwapNetworkDefaults(
+    router_contract_id="0.0.3045981",
+    router_v2_contract_id="0.0.3949434",
+    wrapped_hbar_token_id="0.0.1456986",
+    token_aliases={
+        "SAUCE": "0.0.731861",
+        "XSAUCE": "0.0.1460200",
+    },
+)
+
+SAUCERSWAP_TESTNET = SaucerSwapNetworkDefaults(
+    router_contract_id="0.0.19264",
+    router_v2_contract_id="0.0.1414040",
+    wrapped_hbar_token_id="0.0.15058",
+    token_aliases={
+        "SAUCE": "0.0.1183558",
+        "XSAUCE": "0.0.1418651",
+    },
+)
+
+NETWORK_DEFAULTS: dict[str, SaucerSwapNetworkDefaults] = {
+    "mainnet": SAUCERSWAP_MAINNET,
+    "testnet": SAUCERSWAP_TESTNET,
+}

hak_saucerswap_plugin-0.1.0/hak_saucerswap_plugin/tools/__init__.py

@@ -0,0 +1,25 @@
+from .farms import SAUCERSWAP_GET_FARMS_TOOL, FarmsTool
+from .liquidity import (
+    SAUCERSWAP_ADD_LIQUIDITY_TOOL,
+    SAUCERSWAP_REMOVE_LIQUIDITY_TOOL,
+    AddLiquidityTool,
+    RemoveLiquidityTool,
+)
+from .pools import SAUCERSWAP_GET_POOLS_TOOL, PoolsTool
+from .quote import SAUCERSWAP_GET_SWAP_QUOTE_TOOL, QuoteTool
+from .swap import SAUCERSWAP_SWAP_TOKENS_TOOL, SwapTool
+
+__all__ = [
+    "FarmsTool",
+    "AddLiquidityTool",
+    "RemoveLiquidityTool",
+    "PoolsTool",
+    "QuoteTool",
+    "SwapTool",
+    "SAUCERSWAP_GET_FARMS_TOOL",
+    "SAUCERSWAP_ADD_LIQUIDITY_TOOL",
+    "SAUCERSWAP_REMOVE_LIQUIDITY_TOOL",
+    "SAUCERSWAP_GET_POOLS_TOOL",
+    "SAUCERSWAP_GET_SWAP_QUOTE_TOOL",
+    "SAUCERSWAP_SWAP_TOKENS_TOOL",
+]