無料GitHub で公開日本語紹介

nodejs-keccak256

JavaScript・TypeScriptでEthereum用のハッシュ処理を実装・点検し、SHA3との混同による関数識別子や署名、アドレス算出の誤りを防ぐスキル。

原文原文の説明を見る

Prevent Ethereum hashing bugs in JavaScript and TypeScript. Node's sha3-256 is NIST SHA3, not Ethereum Keccak-256, and silently breaks selectors, signatures, storage slots, and address derivation. Use when hashing for Ethereum in JavaScript or TypeScript, or when a selector, signature, storage slot, or derived address is wrong.

affaan-m/ECC

インストール方法を見る

こんなときに便利

関数セレクターやイベント識別情報の計算
署名や保存位置のハッシュ処理の点検
公開鍵からアドレスを算出したいとき
JS・TS内のSHA3誤用の確認

日本語での紹介

できること

JavaScript・TypeScriptでEthereum向けのハッシュ処理を実装し、計算結果が合わない原因を点検するスキルです。Ethereumが使うKeccak-256と、Node.jsのsha3-256の違いを説明し、ethers、viem、web3.jsによる実装例を示します。関数を識別するセレクター、イベントの識別情報、署名用ハッシュ、データの保存位置、公開鍵からのアドレス算出を扱います。

こんなときに便利

Ethereum関連の処理を書いているときや、セレクター・署名・アドレスの計算結果が期待値と異なるときに向いています。既存コードでNode.jsのハッシュ関数を直接使っている箇所の点検にも役立ちます。

使い方の例

「このTypeScriptコードでEthereum用ハッシュの計算方法を確認して」
「ethersで関数セレクターとmappingの保存位置を計算する例を示して」
「公開鍵からアドレスを求める処理を確認して」

注意点

Ethereum用途ではcrypto.createHash('sha3-256')を使わず、Keccak-256対応の実装を使います。掲載例を動かすには、それぞれのライブラリが必要です。ethersの例はv6向けです。

この紹介文は、公開されている SKILL.md をもとに AI（Claude Haiku）が作成しました。正確な仕様は下の原文を確認してください。

含まれるファイル（1）

SKILL.md2.9 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Node.js Keccak-256

Ethereum uses Keccak-256, not the NIST-standardized SHA3 variant exposed by Node's crypto.createHash('sha3-256').

When to Use

Computing Ethereum function selectors or event topics
Building EIP-712, signature, Merkle, or storage-slot helpers in JS/TS
Reviewing any code that hashes Ethereum data with Node crypto directly

How It Works

The two algorithms produce different outputs for the same input, and Node will not warn you.

import crypto from 'crypto';
import { keccak256, toUtf8Bytes } from 'ethers';

const data = 'hello';
const nistSha3 = crypto.createHash('sha3-256').update(data).digest('hex');
const keccak = keccak256(toUtf8Bytes(data)).slice(2);

console.log(nistSha3 === keccak); // false

Examples

ethers v6

import { keccak256, toUtf8Bytes, solidityPackedKeccak256, id } from 'ethers';

const hash = keccak256(new Uint8Array([0x01, 0x02]));
const hash2 = keccak256(toUtf8Bytes('hello'));
const topic = id('Transfer(address,address,uint256)');
const packed = solidityPackedKeccak256(
  ['address', 'uint256'],
  ['0x742d35Cc6634C0532925a3b8D4C9B569890FaC1c', 100n],
);

viem

import { keccak256, toBytes } from 'viem';

const hash = keccak256(toBytes('hello'));

web3.js

const hash = web3.utils.keccak256('hello');
const packed = web3.utils.soliditySha3(
  { type: 'address', value: '0x742d35Cc6634C0532925a3b8D4C9B569890FaC1c' },
  { type: 'uint256', value: '100' },
);

Common patterns

import { id, keccak256, AbiCoder } from 'ethers';

const selector = id('transfer(address,uint256)').slice(0, 10);
const typeHash = keccak256(toUtf8Bytes('Transfer(address from,address to,uint256 value)'));

function getMappingSlot(key: string, mappingSlot: number): string {
  return keccak256(
    AbiCoder.defaultAbiCoder().encode(['address', 'uint256'], [key, mappingSlot]),
  );
}

Address from public key

import { keccak256 } from 'ethers';

function pubkeyToAddress(pubkeyBytes: Uint8Array): string {
  const hash = keccak256(pubkeyBytes.slice(1));
  return '0x' + hash.slice(-40);
}

Audit your codebase

grep -rn "createHash.*sha3" --include="*.ts" --include="*.js" --exclude-dir=node_modules .
grep -rn "keccak256" --include="*.ts" --include="*.js" . | grep -v node_modules

Rule

For Ethereum contexts, never use crypto.createHash('sha3-256'). Use Keccak-aware helpers from ethers, viem, web3, or another explicit Keccak implementation.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ