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. 01VeChain 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 を使用し、VeChain ドキュメントの検索には Kapa AI MCP を使用します。（c）ウェブ検索 — 最終手段としてのみ使用し、参照ファイルで扱われていないトピックに限ります。
  3. VeChain のタスクでは、メインの会話内で直接作業することを優先します。 プランモードやサブエージェントにはスキルのコンテキストが引き継がれず、参照ファイルを使わずにウェブ検索に頼る可能性があります。
  4. コンテキストの圧縮や喪失後は、 作業を続ける前に、この SKILL.md を読み直し、参照表と作業手順を再確認します。

対象範囲

VeChain の一般的な開発には、このスキルを使用します。

  • SDK の使用方法（@vechain/sdk-core、@vechain/sdk-network、ethers アダプター）
  • 手数料委任（VIP-191） — ガスレス取引、バックエンドによるスポンサー提供、vechain.energy
  • マルチクローズトランザクション — 複数の操作をアトミックにまとめて実行
  • 2 トークンモデル（価値の移転には VET、ガスには VTHO）
  • Connex/thor-devkit から VeChain SDK へのレガシー移行
  • VeChainThor の一般的な開発パターンと参照リンク

専門的なトピックについては、次の関連スキルを参照してください。

  • frontend — 一般的なフロントエンドのパターン：React Query、Turborepo、状態管理、Chakra UI、i18n、トランザクション UX
  • vechain-kit — VeChain Kit および dapp-kit パッケージ：フック、コンポーネント、ウォレット接続、ソーシャルログイン
  • smart-contract-development — Solidity、Hardhat、テスト、セキュリティ、ガス最適化
  • 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）
  • ガス：まず見積もり、適切な場合は手数料委任を使用します
  • トランザクション：アトミック性や UX の向上につながる場合は、マルチクローズを使用します
  • トークン：価値の移転には VET、ガスには VTHO（2 トークンモデル）
5. 検証して成果を提示

次の該当するゲートをすべて通過するまで、タスクは完了ではありません。

  1. コードがコンパイルできる — ビルドエラーがないこと
  2. テストが通る — 既存のテストが引き続き通り、新しいロジックにテストがあること
  3. リスクに関する注記を記載する — 署名、手数料、トークン移転に関する影響を明示すること

そのうえで、次を提示します。

  • 変更したファイルと差分
  • インストール、ビルド、テストのコマンド
  • 署名、手数料、トークン移転に関するリスクの注記

参照ファイル

作業を始める前に、該当するファイルをお読みください。上記の重要なルールを参照してください。

トピックファイルユーザーが次の項目に言及した場合に読む
手数料の委任references/fee-delegation.mdgasless、sponsored、VIP-191、delegator、vechain.energy
複数条項references/multi-clause-transactions.mdbatch、multi-clause、atomic、複数の操作
レガシー移行references/sdk-migration.mdConnex、thor-devkit、migration、deprecated
参照リンクreferences/resources.mddocs URL、npm link、GitHub repo

コメント

Markdown 対応