blazephoenix

BlazePhoenix for Hermes Agent

Swap quotes from BlazePhoenix, the fully on-chain DEX aggregator, measured on your own node and verified locally before anything is signed.

The quote is an eth_call to the BlazePhoenix Quoter, run on the RPC URL you configure. BlazePhoenix never sees your node and runs no RPC for you.
The plugin decodes the raw result itself and refuses any answer from the hosted helper that disagrees with what your node returned.
Unsigned Router calldata is checked field by field (router address, canonical encoding, amount, recipient, minimum output, deadline, approval, and the route your node previewed) before it is shown as ready to sign.
It never signs, never sends a transaction and never handles a private key. Standard library only, no Python dependencies.

Tools

| Tool | What it does | Network |
|---|---|---|
| blazephoenix_quote | Net output after the fee, on-chain minimum, price impact, Phoenix Check verdict (ok / caution / danger / blocked). With recipient, also verified unsigned calldata and the exact ERC-20 approval. | your RPC + blazephoenix.xyz |
| blazephoenix_verify_calldata | Checks Router calldata from any source against what the user asked for. Pure and offline. | none |
| blazephoenix_chains | Chains, pinned Router and Quoter addresses, token symbols, and whether an RPC is set (the URL is never shown). | none |

Chains: Base, Ethereum, Optimism, Arbitrum, Robinhood Chain (protocol 1.0.0). Amounts are in base units. Native ETH: wrap to WETH first (the 1.0.0 Router trades ERC-20 tokens).

Setup

hermes plugins install blazephoenix
# prompted for BLAZEPHOENIX_RPC_BASE: your own Base node URL (any provider)

Optional, one per chain: BLAZEPHOENIX_RPC_ETHEREUM, BLAZEPHOENIX_RPC_OPTIMISM, BLAZEPHOENIX_RPC_ARBITRUM, BLAZEPHOENIX_RPC_ROBINHOOD. A chain without an RPC answers rpc_required; nothing falls back to a shared node. The URL is read through Hermes's secret scope and never appears in tool output or errors.

Then ask, for example: "Quote 0.1 WETH to USDC on Base for 0x… and verify the calldata before I sign."

How a quote is made

GET https://blazephoenix.xyz/api/quote/prepare returns the request (deadline, slippage) and the eth_call it expects. The plugin re-encodes that call itself and refuses any difference in target or bytes. The Router and Quoter addresses are pinned in bp.py; a new deployment reaches you only through a reviewed release of this plugin.
Your node checks it serves the expected chain (eth_chainId) and runs previewPlanWithMinOut on the pinned Quoter.
POST https://blazephoenix.xyz/api/quote/decode (pure, no RPC) returns the quote, the Phoenix Check and the unsigned calldata.
The plugin decodes your node's result locally, recomputes the Phoenix Check, refuses a hosted decode that disagrees, and verifies the calldata against the request and your node's route.

The Router also enforces the minimum output on-chain: a worse fill reverts.

What the plugin does on your machine

Network: HTTPS to blazephoenix.xyz (prepare and decode: token addresses, amount, recipient, minimum; never your RPC URL) and JSON-RPC eth_chainId / eth_call to the RPC URL you set. Nothing else.
No shell commands, no background processes, no files read or written, no telemetry, no stored credentials beyond the RPC URL you give Hermes.

Tests

python -m pytest            # 229 offline tests: ABI codec vs eth-abi, selectors, verification, Phoenix Check
BLAZEPHOENIX_RPC_BASE=<your Base node> python -m pytest   # + 9 live tests on Base, including a lying-server suite
python tests/mutants.py     # 21 code mutants, each must turn the suite red

Offline tests need pytest; the differential codec and selector tests also use eth-abi and pycryptodome when installed (test-only).

About