swap-integration

swap-integration is Uniswap's official skill for building token-swap functionality into frontends, backend scripts/bots, and smart contracts. It solves the routing and integration complexity of on-chain trading by pointing developers at the right method for their context: the hosted Trading API for apps and scripts, the Universal Router SDK for direct transaction construction, and direct Universal Router `execute()` calls for on-chain composability. A decision table and routing-type reference (CLASSIC, UniswapX Dutch auctions, MEV-protected priority orders, wrap/unwrap, bridge, and more) help pick an approach per chain.

The documented Trading API flow is a three-step sequence — check approval, get a quote, then request a signable swap transaction — authenticated with an `x-api-key` header obtained from the Uniswap Developer Portal. The skill includes concrete request/response shapes, key parameters (slippage tolerance, exact-input/output, routing preference, urgency), and installation snippets for the SDK packages.

Notably, the skill is security-conscious: it mandates strict input validation before interpolating any user value (regex-checked Ethereum addresses, numeric amounts, chain IDs from the official list), forbids hardcoding API keys, rejects shell metacharacters, and requires an explicit user-confirmation prompt before any transaction that spends gas or transfers tokens. It targets web3 and DeFi developers integrating swaps. Because generated code can construct and submit value-transferring on-chain transactions, the capability is financially sensitive, though the built-in confirmation gate and validation rules substantially mitigate accidental or unauthorized fund movement.