mcpField
V
vechain-core

vechain-core

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

关于 vechain-core

面向 VeChain 开发者的技能，指导基于 SDK 的实现、交易设计和验证；相关任务优先参考随附文档和 VeChain MCP 工具。

主要功能

  1. 01VeChain SDK 与网络使用指导
  2. 02手续费代付与多子句交易指导
  3. 03Connex 和 thor-devkit 迁移指导
  4. 04按主题优先读取参考文件
  5. 05构建、测试与风险说明检查

适用场景

  1. 01实现 VeChain SDK 功能
  2. 02规划赞助交易或批量交易
  3. 03迁移旧版 VeChain 项目
  4. 04验证交易相关代码变更

MCP 相关

对于 VeChain 链上数据、交易构建和实时网络查询，技能指引使用 `@vechain/mcp-server`；查询 VeChain 文档则推荐 Kapa AI MCP。

安装

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

$npx skills add https://github.com/vechain/vechain-ai-skills --skill vechain-core

安装后在 Claude Code 中输入/vechain-core确认已加载。

包含的文件

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

references/
fee-delegation.md
multi-clause-transactions.md
resources.md
sdk-migration.md

详细介绍

VeChain 核心技能

重要规则

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

适用范围

将此 Skill 用于一般 VeChain 开发：

  • SDK 用法（@vechain/sdk-core、@vechain/sdk-network、ethers 适配器）
  • 费用代付（VIP-191）——免 Gas 交易、后端赞助、vechain.energy
  • 多子句交易——将多个操作原子化批处理
  • 双代币模型（VET 用于价值转移，VTHO 用于 Gas）
  • 从 Connex/thor-devkit 迁移至 VeChain SDK
  • 一般 VeChainThor 开发模式和参考链接

对于专门主题，请参阅配套技能：

  • frontend — 通用前端模式：React Query、Turborepo、状态管理、Chakra UI、国际化、交易 UX
  • vechain-kit — VeChain Kit 和 dapp-kit 包：钩子、组件、钱包连接、社交登录
  • smart-contract-development — Solidity、Hardhat、测试、安全、Gas 优化
  • vebetterdao — X2Earn 应用、B3TR/VOT3、治理、VeVote
  • stargate — NFT 质押、验证者、委托、VTHO 奖励

默认技术栈

层级默认选项替代选项
SDK@vechain/sdk-core + @vechain/sdk-network@vechain/sdk-ethers-adapter
NodeNode 20 LTS（通过 nvm 管理）--

操作流程

1. 检查 Node 版本

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

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

当用户的请求含糊不清或有多种解决方式时，先询问再构建。不要默默研究替代方案后自行选择。将研究与实施分开：

  • 如果范围不明确，请用户缩小范围
  • 如果存在多种可行架构，请说明权衡利弊并让用户选择
  • 只有在方法达成一致后，才开始实施
4. 按照 VeChain 特定要求正确实施
  • 网络：始终明确指定（mainnet/testnet/solo）
  • Gas：先估算，适当时使用费用代付
  • 交易：批处理有利于原子性或 UX 时，使用多子句交易
  • 代币：VET 用于价值转移，VTHO 用于 Gas（双代币模型）
5. 验证并交付

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

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

然后提供：

  • 更改的文件 + 差异
  • 安装/构建/测试命令
  • 关于签名、费用和代币转账的风险说明

参考文件

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

主题文件用户提及时阅读……
费用代付references/fee-delegation.mdgasless、sponsored、VIP-191、delegator、vechain.energy
多子句references/multi-clause-transactions.mdbatch、multi-clause、atomic、multiple operations
旧版迁移references/sdk-migration.mdConnex、thor-devkit、migration、deprecated
参考链接references/resources.mddocs URL、npm link、GitHub repo

评论

支持 Markdown