onchain-typescript-skills
为使用Viem和Wagmi构建以太坊TypeScript应用提供编码技能支持。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：onchain-typescript-skills。 它的用途是：为使用Viem和Wagmi构建以太坊TypeScript应用提供编码技能支持。 完整的 Skill 内容见：https://321skill.com/skills/onchain-typescript-skills/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想用Viem读取一个ERC20合约的代币总供应量，这是我的合约地址和ABI。”，它会引导你创建Public Client，使用`readContract`方法，并确保ABI用`as const`修饰以获得完整的类型安全。或者
对AI说：“在Next.js项目里，如何用Wagmi连接钱包并显示账户余额？”，它会帮你设置Wagmi配置、Provider，并使用`useAccount`和`useReadContract`等Hook实现功能。
介绍
这个Skill旨在解决开发者在构建以太坊及EVM链上TypeScript应用时，因不熟悉Viem和Wagmi最新版本（Viem 2.x, Wagmi 3.x）而导致编码效率低下、类型安全缺失和常见模式错误的问题。它通过提供即时的代码片段、最佳实践指导和错误模式识别，帮助开发者快速编写正确的区块链交互代码。
Skill通过两种方式安装：推荐使用npx命令一键安装，或在Claude Code插件市场中注册后选择安装特定的子技能（如viem或wagmi）。安装后，AI会在你编写相关代码时自动触发并提供建议。
它非常适合前端开发、后端开发和全栈开发人员，尤其是那些正在使用或计划使用TypeScript、Viem和Wagmi栈来开发去中心化应用（DApp）、Node.js脚本或后端服务的开发者。对于从ethers.js等旧库迁移过来的开发者尤其有帮助。
使用建议：明确你的开发场景（React应用用Wagmi，Node脚本用Viem），并在提问时尽量提供上下文，如ABI或具体的操作意图。注意Skill强调的类型安全（使用as const）和simulateContract先行的模式，遵循这些能避免常见陷阱。
核心特点
本Skill深度集成了Viem 2.x与Wagmi 3.x的最新API和最佳实践，尤其强调通过`as const`实现ABI的完全类型推断，以及强制执行`simulateContract`再`writeContract`的安全交易模式，这些是其他通用代码助手容易忽略的关键细节。
注意事项
不适合用于非TypeScript项目、非EVM链开发，或需要使用更低级别（如直接RPC调用）或更古老区块链库（如ethers.js 4.x）的场景。
常见问题
开发React应用应该用Viem还是Wagmi技能？
开发React或Next.js前端应用，主要使用Wagmi技能；在Next.js的API路由等后端部分进行链上操作时，使用Viem技能。
如何确保生成的合约调用代码是类型安全的？
Skill会引导你使用`as const`断言来定义ABI，这是实现完整TypeScript类型推断和避免常见AI编码错误的关键。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/onchain-typescript-skills/raw/index.md 读取 onchain-typescript-skills 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/onchain-typescript-skills/raw/index.md（查看排版版本）