Agents
Capabilities
These are example workflows for the Topaz skill’s BNB integration. Each recipe needs current deployment data and provider support. The skill's own guides cover xTOPAZ vault entry, bridging and spoke voting; check its helpers' chain support before building a spoke transaction.
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.
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
Compare BNB gauges for the current epoch. Keep LP Fee APR, LP Emissions APR and voter fees plus incentives separate. Show source timestamps and how adding my vote changes my estimated share. Do not sum all three as one return.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 www.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.