用途:OnchainKit 用于构建生产级链上应用,通过现成 React 组件与 TypeScript 工具封装区块链复杂度,默认支持 Base 网络。
主要能力:提供钱包连接与管理、身份展示(ENS 名称、头像、验证徽章)、代币操作(任意 ERC-20 兑换、法币购买、余额与价格)、交易构建与执行、支付结算流程、NFT 展示与铸造,以及 MiniKit 用于 Farcaster Frame 应用。支持自定义 EVM 链。
使用方式:新建项目可运行 scripts/create-onchain-app.py <project-name>,随后用 scripts/validate-setup.py 验证;已有项目执行 npm install @coinbase/onchainkit,并运行 scripts/setup-environment.py 配置环境。需配置 NEXT_PUBLIC_CDP_API_KEY、NEXT_PUBLIC_WC_PROJECT_ID 等环境变量,并在 WagmiProvider 内包裹 OnchainKitProvider 传入 apiKey 与 chain。组件按路径导入,例如 import { Wallet, ConnectWallet } from '@coinbase/onchainkit/wallet'。
适用场景:加密钱包连接、代币兑换/购买应用、NFT 市场与铸造页、链上商店支付流程、需要身份展示的 DApp。官方提供 basic-app、swap-app、nft-mint、commerce 等模板。
限制:需自行申请 API 密钥并正确配置 provider;客户端代码不得暴露私钥;交易参数需校验。资料中未提供具体收费与价格信息,平台支持范围以官方文档为准。