用途：OnchainKit 用于以 React 组件和 TypeScript 工具构建生产级链上应用，抽象区块链复杂性，适合创建加密钱包、代币兑换、NFT 与支付等界面。资料称其在 Base 上自动生效、无需后端、交易费用低于 0.01 美元。
主要能力：钱包连接与管理（Wallet、ConnectWallet）；身份展示（Identity、Avatar、Name、Badge）；代币操作（Swap、SwapAmountInput、SwapButton，支持任意 ERC-20 兑换、法币购买、余额与价格）；交易构建（Transaction、TransactionButton）；支付结算（Checkout、CheckoutButton）；NFT 集成（NFTCard）。另提供 hooks、工具函数与完整 TypeScript 类型，并支持自定义 EVM 链与 MiniKit/Farcaster Frame。
使用方式：新项目可运行 scripts/create-onchain-app.py <project-name>，并可用 scripts/validate-setup.py 校验；已有项目执行 npm install @coinbase/onchainkit。需配置环境变量 NEXT_PUBLIC_CDP_API_KEY、NEXT_PUBLIC_WC_PROJECT_ID，可选 NEXT_PUBLIC_CHAIN_ID="8453"。需在应用中用 WagmiProvider 包裹 OnchainKitProvider，并传入 apiKey 与 chain。建议按组件级导入，如 import { Wallet } from '@coinbase/onchainkit/wallet'。
适用场景：钱包连接流程、多代币兑换界面、NFT 铸造与展示、链上商店结算、Farcaster Frame 应用等。提供基础应用、兑换、NFT 铸造、电商等模板。
限制：资料未提供具体收费、价格或性能数据；需要正确的 provider 与 API Key 配置；私钥不得暴露在客户端代码中；交易参数需校验。常见问题包括钱包连接失败、API 报错、交易回滚和样式问题，可通过检查配置与环境变量、参照 troubleshooting 文档排查。