mcpField
S
smart-contract-development

smart-contract-development

github.com/vechain開発15105 回インストール4 週間前に更新
リポジトリ

smart-contract-development について

VeChainThor向けにSolidityスマートコントラクトを開発するスキルです。記載されたコントラクトのパターンとツールを使う開発者に、VeChain固有の手順、参照資料、検証要件を示します。

主な機能

  1. 01SolidityとHardhatの開発手順
  2. 02トークンとアクセス制御のパターンガイド
  3. 03ガス最適化とセキュリティの資料
  4. 04HardhatとThor Soloのテストガイド
  5. 05コンパイル、テスト、リスク記録の確認

活用シーン

  1. 01VeChainThor向けSolidityコントラクトの開発
  2. 02アップグレード可能なコントラクトやトークンのパターン確認
  3. 03Thor Soloを使ったコントラクトのテスト
  4. 04ガスとセキュリティ上の考慮事項の確認

MCP 対応

VeChainのオンチェーンデータ取得、トランザクション構築、ネットワーク照会には`@vechain/mcp-server`を推奨しています。VeChainドキュメントの検索先としてKapa AI MCPも挙げています。

インストール

コマンドをコピーしてターミナルで実行します。

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

対象範囲

VeChainThorでのSolidityスマートコントラクト開発には、このスキルを使用してください。

  • Hardhat + @vechain/sdk-hardhat-plugin を使用したSolidityコントラクト
  • ERC-20、ERC-721、アクセス制御、アップグレード可能（UUPS）パターン
  • ガス最適化の手法
  • 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 にします。
  • ガス：まず見積もります。
  • トークン：価値の移転にはVET、ガスにはVTHOを使用します（デュアルトークンモデル）。
5. 検証して完了する

該当するすべての確認項目に合格するまで、タスクは完了していません。

  1. コードがコンパイルできる — ビルドエラーがないこと
  2. テストが成功する — 既存のテストが引き続き成功し、新しいロジックにテストカバレッジがあること
  3. リスクに関する注記を記載する — 署名、手数料、トークン送金に関する影響があれば明記すること

参照ファイル

先に、該当するファイルを読んでください。上記の重要なルールを参照してください。

トピックファイルユーザーが次の内容に言及した場合に読む
スマートコントラクトreferences/smart-contracts.mdSolidity、Hardhat、ERC-20、ERC-721、デプロイ、コントラクトとのやり取り、ライブラリ、コントラクトサイズ、アップグレード可能、プロキシ、アップグレード、再初期化、バージョンパターン、デプロイヘルパー、NatSpec、Slither
ガス最適化references/smart-contracts-optimization.mdガス、最適化、ストレージパッキング、アセンブリ、unchecked
テストreferences/testing.mdテスト、Thor Solo、Docker、CI、フィクスチャ
ABI／コード生成references/abi-codegen.mdTypeChain、ABI、typechain-types、コード生成
セキュリティreferences/security.mdセキュリティ、監査、脆弱性、リエントランシー、アクセス制御、不変条件、残高チェック、パスの対称性、敵対的、エッジケース、問題が起きる可能性

コメント

Markdown 対応