mcpField
S
smart-contract-development

smart-contract-development

github.com/vechain开发15105 次安装4 周前更新
代码仓库

关于 smart-contract-development

面向 VeChainThor 上 Solidity 智能合约开发的 Skill，适用于使用所列合约模式和工具的开发者。它提供 VeChain 专用项目流程、参考资料指引和验证要求。

主要功能

  1. 01Solidity 与 Hardhat 工作流
  2. 02代币和访问控制模式指引
  3. 03Gas 优化与安全参考资料
  4. 04Hardhat 和 Thor Solo 测试指引
  5. 05编译、测试及风险说明检查

适用场景

  1. 01为 VeChainThor 开发 Solidity 合约
  2. 02审查可升级合约或代币模式
  3. 03使用 Thor Solo 测试合约
  4. 04检查 Gas 与安全因素

MCP 相关

该 Skill 建议使用 `@vechain/mcp-server` 获取 VeChain 链上数据、构建交易并查询实时网络，也提及使用 Kapa AI MCP 查找 VeChain 文档。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/vechain/vechain-ai-skills --skill smart-contract-development

安装后在 Claude Code 中输入/smart-contract-development确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
abi-codegen.md
security.md
smart-contracts-optimization.md
smart-contracts.md
testing.md

详细介绍

智能合约开发技能

关键规则

  1. 先阅读参考文件。 如果用户的请求涉及下方参考表中的任何主题，请先阅读对应文件，然后再进行任何其他操作——在编写代码之前、做出决定之前。简要说明正在阅读哪些文件，以便用户确认技能已启用（例如：“正在阅读智能合约参考……”）。
  2. VeChain 相关主题的信息优先级： (a) 此技能中的参考文件——始终是主要信息来源。(b) VeChain MCP 工具——使用 @vechain/mcp-server 获取链上数据、构建交易并查询实时网络；使用 Kapa AI MCP 查找 VeChain 文档。(c) 网络搜索——仅作为最后手段，且仅用于参考文件未涵盖的主题。
  3. 处理 VeChain 任务时，优先直接在主对话中进行。 计划模式和子 Agent 不会继承技能上下文，可能会改用网络搜索，而不是使用参考文件。
  4. 上下文压缩或丢失后， 继续工作前请重新阅读此 SKILL.md，以恢复对参考表和操作流程的了解。

适用范围

将此技能用于 VeChainThor 上的 Solidity 智能合约开发：

  • 使用 Hardhat + @vechain/sdk-hardhat-plugin 开发 Solidity 合约
  • ERC-20、ERC-721、访问控制、可升级（UUPS）模式
  • Gas 优化技术
  • 使用 Hardhat + Thor Solo 进行测试
  • 安全审查和审计清单
  • ABI 代码生成和 TypeChain 配置

默认技术栈

层默认选项备选方案
合约Solidity + Hardhat + @vechain/sdk-hardhat-plugin--
EVM 目标paris（必须）--
测试Hardhat + Thor Solo（--on-demand）--
类型TypeChain（@typechain/ethers-v6）@vechain/vechain-contract-types（预构建）
NodeNode 20 LTS（通过 nvm 管理）--

操作流程

1. 检查 Node 版本

安装依赖或运行任何命令之前：

  • 检查项目根目录中是否存在 .nvmrc。如果存在，运行 nvm use 切换到所需版本。
  • 如果 .nvmrc 不存在，则创建一个，内容为 20（Node 20 LTS），然后运行 nvm use。
2. 检测项目结构
  • 如果存在 turbo.json → 遵循 Turborepo 约定（packages/contracts、packages/*）
3. 实施前先澄清

当用户的请求含糊不清或可能有多种解决方式时，请先询问，再着手构建。将调研与实施分开进行。

4. 按 VeChain 特定要求正确实施
  • 网络：始终明确指定（mainnet/testnet/solo）
  • EVM 目标：始终使用 paris
  • Gas：先估算
  • 代币：VET 用于转账，VTHO 用于 Gas（双代币模型）
5. 验证并交付

只有通过所有适用检查项，任务才算完成：

  1. 代码可编译——无构建错误
  2. 测试通过——现有测试仍然通过；新逻辑有测试覆盖
  3. 记录风险说明——明确说明任何签名、费用或代币转账方面的影响

参考文件

在进行任何操作之前，请先阅读匹配的文件。请参阅上方的关键规则。

主题文件用户提及时阅读……
智能合约references/smart-contracts.mdSolidity、Hardhat、ERC-20、ERC-721、部署、合约交互、库、合约大小、可升级、代理、升级、reinitializer、版本模式、部署辅助工具、NatSpec、Slither
Gas 优化references/smart-contracts-optimization.mdgas、优化、存储打包、汇编、unchecked
测试references/testing.md测试、Thor Solo、Docker、CI、测试夹具
ABI / 代码生成references/abi-codegen.mdTypeChain、ABI、typechain-types、代码生成
安全references/security.md安全、审计、漏洞、重入、访问控制、不变量、余额检查、路径对称性、对抗性、边界情况、可能出什么问题

评论

支持 Markdown