Agents
Capabilities
The Topaz skill covers every workflow exposed by the protocol. This page groups the most common ones into recipes you can hand directly to an agent. Each recipe links to the protocol doc that defines the underlying mechanics.
quote, built calldata, approval-needed, or broadcast tx-hash. Nothing moves on-chain unless you explicitly ask and signing credentials are configured. See the Safety Model for the full contract.Quoting & swapping
The skill knows how to quote v2 volatile, v2 stable, v3 concentrated, and mixed-route swaps, with slippage modeling.
Quote a swap
Quote a swap of 5 WBNB into USDT on Topaz. Show the best
route, expected output, price impact, and the per-pool
fees you'd pay.Build swap calldata
Build wallet-ready calldata for the swap above with 0.5%
slippage tolerance, valid for 20 minutes. Don't broadcast.Explain a route
Why did Topaz route this swap through three pools instead
of the direct WBNB/USDT pool? Walk me through the fee and
liquidity math.Protocol mechanics: Swaps & Routing.
Liquidity (v2 LP and v3 NFT positions)
Open a v2 LP position
Add 1000 USDT and the equivalent WBNB into the
USDT/WBNB volatile pool on Topaz. Quote, build, don't
broadcast.Mint a concentrated (v3) position
Mint a Slipstream concentrated-liquidity position in the
USDT/WBNB pool covering the ±5% range around current
price. Use 0.05% fee tier. Quote and build.Inspect existing positions
Show me every Topaz LP and CL position my wallet holds,
with current value, fee earnings, and whether each one is
in range.Protocol mechanics: Providing Liquidity · Concentrated Positions.
Gauges, voting & veTOPAZ
Lock TOPAZ to mint a veNFT
Lock 10,000 TOPAZ for the maximum duration to mint a
veTOPAZ NFT. Quote and build the lock transaction.Vote with a veNFT
I want to vote my veNFT (id 1234) 60% on USDT/WBNB and
40% on TOPAZ/WBNB. Build the vote transaction.Inspect gauge APRs and bribes
Rank the top 10 Topaz gauges by total reward APR for the
current epoch, including emissions, trading fees, and
active bribes. Show what 1 veTOPAZ would earn voting for
each.Protocol mechanics: veTOPAZ Locks · Gauge Voting · Incentives (Bribes).
Bribes & reward claims
Post a bribe / incentive
I want to incentivize voters of the USDT/WBNB gauge with
5000 USDT for next epoch. Build the bribe transaction.Claim everything claimable
For my wallet, claim all unclaimed: gauge emissions on my
LP/CL positions, voter trading-fee rewards, voter bribes,
and any veTOPAZ rebase. Build the transactions.Protocol mechanics: Incentives (Bribes).
Reading protocol state
Pool stats
Show me the current TVL, 24h volume, fee revenue, and
emissions for the USDT/WBNB pool on Topaz, both v2 and v3
sides.Wallet portfolio
Give me a complete Topaz portfolio for my wallet:
veTOPAZ locks, LP/CL positions, current claimable
rewards, and total estimated APR.Protocol-wide analytics
Compare the last 4 epochs on Topaz: total emissions,
total bribes offered, average voter APR, and any new
gauges that were added.Integration / building on top
The skill is also the right starting point for agents that help developers integrate Topaz. The prompts below assume the agent has access to your codebase.
Quote widget for a dapp
Add a Topaz swap quote widget to this dapp. It should
quote any pair via Topaz, show the route and price impact,
and let the user click through to app.topazdex.com to
execute. Don't build a wallet integration.Diagnose a failing swap
This Topaz swap is reverting on-chain (tx hash 0x...).
Tell me what's wrong: bad slippage, missing approval, path
that doesn't exist, or something else.See also the protocol-level Integration Guide for the underlying contracts and subgraph.