nodejs-keccak256

nodejs-keccak256 スキルの概要

nodejs-keccak256 でできること

nodejs-keccak256 スキルは、JavaScript と TypeScript でよくある Ethereum のバグを避けるのに役立ちます。Node の crypto.createHash('sha3-256') を使うべきでない場面で使ってしまい、本来必要なのが Keccak-256 だった、という取り違えを防ぐためのスキルです。このズレがあると、selector、event topic、署名、storage slot の計算、アドレス導出が静かに壊れることがあります。

こんな人に向いています

バックエンドサービス、bot、indexer、ウォレット系ツール、スマートコントラクト補助コード、あるいは Ethereum データをハッシュする Node ベースのコードを扱うなら、nodejs-keccak256 スキルが向いています。特に、誤ったハッシュ処理を本番に出す前に見つけたいレビュー担当者や保守担当者に有用です。

なぜ重要なのか

これは一般的なハッシュ解説ではありません。nodejs-keccak256 スキルの主な価値は、判断の精度にあります。どのコードが危険なのか、何に置き換えるべきか、そして出力が Ethereum のツールと一致するかどうかをどう確かめるかを示してくれます。そのため、nodejs-keccak256 for Backend Development のような「正確さが利便性より重要」な場面で実用的です。

nodejs-keccak256 スキルの使い方

スキルをインストールして開く

nodejs-keccak256 スキルは次のコマンドでインストールします:
npx skills add affaan-m/everything-claude-code --skill nodejs-keccak256

その後、まず SKILL.md を開いてください。このリポジトリではサポートファイルはこれだけなので、最短ルートはスキル本文をしっかり読み、nodejs-keccak256 usage の作業基準として使うことです。

ざっくりした依頼を、よいプロンプトに変える

このスキルは、具体的なハッシュ対象、実行環境、期待する Ethereum の成果物を与えるほど効果を発揮します。たとえば次のような情報があると強いです。

• ハッシュ対象: function selector、EIP-712 domain、event topic、storage slot、packed encoding
• スタック: Node.js、ethers v6、viem、web3.js、plain crypto
• 入力の形: string、bytes、ABI-encoded tuple、address、bigint
• 望む出力形式: 0x の有無を含む hex、bytes、topic hash、selector

プロンプトの例:
Review this Node.js code that computes an ERC-20 Transfer topic. Replace sha3-256 with a correct Keccak-256 approach and show the safest ethers v6 version.

正しいワークフローで進める

まず、そのコードが Ethereum のハッシュ処理なのか、一般的な NIST SHA3 なのかを見分けます。Ethereum 関連であれば、Node の SHA3 実装を、Keccak-256 を明示的に提供する ethers や viem のライブラリ関数に置き換えます。そのうえで、見た目が似ているかどうかではなく、既知の selector や topic と照合して結果を確認します。

最初に読むべき箇所

この nodejs-keccak256 guide では、SKILL.md の次の部分を重点的に読んでください。

• When to Use
• How It Works
• Examples
• ethers v6

これらのセクションで、使うべき境界、失敗パターン、推奨される置き換え方法が分かります。

nodejs-keccak256 スキルの FAQ

nodejs-keccak256 は Ethereum 用だけですか？

はい、主な用途はそこです。このスキルは、一般的な暗号処理ではなく、Ethereum 互換の Keccak-256 を扱うためのものです。Ethereum 以外で標準の SHA3-256 が必要なら、このスキルは適切ではありません。

なぜ Node crypto を直接使わないのですか？

crypto.createHash('sha3-256') は Keccak-256 ではないからです。Node は警告してくれず、selector、topic、署名が本番で壊れるまで「正しそう」に見えてしまうことがあります。nodejs-keccak256 スキルは、その静かな取り違えを防ぐためにあります。

初心者でも使えますか？

はい。ハッシュしたい内容を平易な言葉で説明できれば十分です。nodejs-keccak256 install と使い方の案内を活かすのに、暗号の深い知識までは必要ありません。ただし、何の Ethereum 成果物を作ろうとしているのかは把握している必要があります。

ethers や viem と併用できますか？

はい。リポジトリの例には ethers v6 と viem のパターンがあり、実際のバックエンドコードベースで役立つ理由はそこにあります。ライブラリ固有の、しかも正しさを担保しやすい置き換えが必要なときは、普通のプロンプトよりも適しています。

nodejs-keccak256 スキルを改善するには

ハッシュ対象の Ethereum 成果物を具体的に伝える

最も良い結果が出るのは、何をハッシュしているかを明確に指定したときです。たとえば「Transfer(address,address,uint256) の ERC-721 topic」と言ってください。「この文字列をハッシュして」だけでは不十分です。そうすることで、nodejs-keccak256 skill が正しいエンコーディングと出力形にたどり着きやすくなります。

元のコードと期待値を一緒に渡す

すでに失敗しているコードがあるなら、スニペットと期待値、あるいは信頼できる参照値を貼ってください。そうすると、問題がエンコーディングなのか、アルゴリズムの選択なのか、フォーマットなのかを切り分けやすくなります。バックエンド用途では、出力を ethers v6、viem、あるいは古い web3.js と互換に保つ必要があるかどうかも明記してください。

よくある失敗パターンに注意する

ミスの多くは Keccak そのものではなく、入力の準備段階にあります。string と bytes の混同、ABI packing の不足、0x 正規化の忘れが、誤った修正の原因になりがちです。最初の回答がそれらしく見えても既知の selector や topic と一致しないなら、検証ステップとライブラリ別の書き換えを求めてください。

既知の値と照らして反復する

最初の回答のあと、信頼できる Ethereum ソースの既知の selector、topic、hash と比較してください。違っていれば、差分をそのまま返し、より絞った修正を依頼します。推測に頼らず nodejs-keccak256 usage を改善するには、これが最短です。