Skip to main content
Use natural language for intent, but keep constraints explicit.

Patterns that work

1) Pass account and chain in metadata

2) Split plan and execution

3) Ask for goals, not tool sequences

4) State hard constraints directly

Common pitfalls

Hallucinated token addresses

Prefer metadata or TokenAddressTool for symbol resolution.

Ambiguous chain

“Swap USDC to WETH” is ambiguous unless chain is explicit.

Slippage format

Use percentages (1%) to avoid unit mismatch.

Native token handling

Use asset names (ETH, MATIC, SOL) unless the flow requires explicit addresses.

Bridge timing assumptions

Cross-chain settlement can take seconds to minutes depending on route/provider.

Useful prompt templates

When to avoid agent-driven execution

  • High-value production trades without a review loop
  • Unsupervised wallets with broad permissions
  • Fully deterministic backend flows that should call SDK methods directly
Last modified on May 15, 2026