hak-saucerswap-plugin (Python)

A Hedera Agent Kit plugin that integrates the SaucerSwap 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.

Tools

Installation

pip install hak-saucerswap-plugin

Usage

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.

Network defaults (contract addresses from the official SaucerSwap 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

uv sync
uv run pytest
uv run ruff check .

License

MIT