AI + DeFi

Topaz for AI agents

Bring AI to your Topaz workflow. Talk to the hosted agent for quotes, liquidity and voting strategies, or give your own agent the official protocol skill.

Topaz Agent

Your on-chain DeFi strategist

A non-custodial DeFi strategist for BNB Chain, hosted at agents.topazdex.com. It is purpose-built for the Topaz protocol. It uses multi-step AI reasoning with domain-specific playbooks to analyze pools, recommend positions, optimize votes, plan bribe campaigns, and build wallet-ready transactions — all without ever holding your keys.

Non-custodial by design. The agent builds calldata; your wallet signs. Registered on-chain as Agent ID 113284 via ERC-8004.

Integration Protocols

Four ways to connect

Whether you're a user chatting in natural language, a developer calling REST endpoints, or an autonomous agent connecting via MCP — the Topaz Agent speaks your protocol.

Agent Skill

Teach your own agent the Topaz protocol

The Topaz Agent Skill is a runtime-neutral package — markdown instructions, protocol references, worked examples, evals, and TypeScript helpers — that gives any AI agent the structured context it needs to act on the Topaz protocol. Install it into Claude Code, Cursor, Hermes, OpenCode, or any agent with a skill system.

Version

See current manifest

License

MIT

Chain

BNB Chain hub (56), Robinhood (4663), Base (8453), Ethereum (1), Arc (5042)

Repository

topazdex/agent-skill

Quick Start

Three ways to load Topaz into your agent

Pick the path that matches your runtime. All three point at the same canonical skill.

Read the official Topaz DEX agent skill at
https://www.topazdex.com/skill.md and follow it
when working with Topaz DEX swaps, pools,
gauges, bribes, veNFTs, rewards, quotes,
routes, or integrations.

git clone https://github.com/topazdex/agent-skill.git <dest>
cd <dest>/scripts
cp .env.example .env
yarn install --immutable
yarn validate && yarn smoke

curl -fsSL https://raw.githubusercontent.com/topazdex/agent-skill/main/install.sh | bash

# or pick your own path
curl -fsSL https://raw.githubusercontent.com/topazdex/agent-skill/main/install.sh \
  | bash -s -- ~/some/other/path

Entry Points

Stable URLs you can point any agent at

These endpoints stay stable across versions. Bookmark them, hard-code them in agent configs, ship them in prompts.

Consumption Modes

Works with how your agent already loads context

Not every agent has the same skill system. The Topaz skill is designed to plug into all of them.

Runtime Examples

Conventional locations per runtime

These are examples, not requirements. The canonical source is the GitHub repo — point your agent at whichever path it reads from.

Load https://www.topazdex.com/skill.md and use it as your operating guide for Topaz DEX tasks.

Clone https://github.com/topazdex/agent-skill and follow SKILL.md. Use references, examples, and scripts from the cloned repo when available.

Read https://www.topazdex.com/skill.md. If more detail is needed, clone https://github.com/topazdex/agent-skill into ~/.claude/skills/topaz (or .claude/skills/topaz for project-local) and follow SKILL.md as guidance for Topaz DEX tasks.

Use https://www.topazdex.com/skill.md as the Topaz DEX protocol guide. For full references and scripts, clone https://github.com/topazdex/agent-skill.

Skill Capabilities

What agents can do with the skill

Workflows for all five networks are documented. Quote and swap-batch helpers take any of the five chain IDs, and the remaining helpers target BNB Chain; each helper's reference lists its networks.

Safety

Quote, build, simulate — never broadcast by default

Both the Topaz Agent and the agent skill are safe by default. Funds never move unless the user explicitly asks and signing credentials are configured.

• ✓Quote before building transactions
• ✓Simulate or dry-run when possible
• ✓Clearly report slippage assumptions
• ✓Clearly report approval requirements
• ✓Build calldata without broadcasting by default
• ✓No fund movement unless the user explicitly asks

Update & Verify

Keep your skill installation current

Compare versions against /skill.json, pull updates, and verify the full package boots cleanly.

git -C <dest> pull --ff-only
# or use the wrapper:
bash <dest>/update.sh

cd <dest>
bash tools/check_update.sh
# exit 0 = up to date, 10 = update available

cd <dest>/scripts
yarn install --immutable
yarn validate
yarn build
yarn test
yarn smoke

Agent support and multichain scope

The hosted agent service and installable skill are maintained separately from this interface. The published skill covers all five networks and documents xTOPAZ entry and redemption, bridging and spoke voting. Its quote and swap-batch helpers accept all five chain IDs; the remaining helpers and command-line tools target BNB Chain. Check the service's current capabilities and deployed network before using a builder; never substitute BNB addresses or data for a planned spoke.

This interface supports xTOPAZ entry, redemption, bridging and spoke voting on the live networks. The hosted agent service and installable skill have their own release capabilities; web support does not activate agent builders. Check the published service manifest and chain-qualified addresses. Live networks · Multichain integration.

Carry chain, account, contract, token address, recipient and NFT or local stake ID in every quote and plan. Keep source submission, source confirmation and destination delivery distinct. A transaction hash is not proof that a bridge completed or a destination action succeeded.