nodejs-keccak256

Vue d’ensemble de la skill nodejs-keccak256

Ce que fait nodejs-keccak256

La skill nodejs-keccak256 vous aide à éviter un bug Ethereum fréquent en JavaScript et TypeScript : utiliser crypto.createHash('sha3-256') de Node alors qu’il vous faut en réalité Keccak-256. Ce décalage peut casser silencieusement des sélecteurs, des topics d’événements, des signatures, des calculs de storage slot et la dérivation d’adresses.

À qui s’adresse cette skill

Utilisez la skill nodejs-keccak256 si vous travaillez sur des services backend, des bots, des indexeurs, des outils de wallet, des helpers pour smart contracts, ou tout code Node qui hache des données Ethereum. Elle est particulièrement utile aux relecteurs et aux mainteneurs qui doivent repérer un hachage incorrect avant sa mise en production.

Pourquoi c’est important

Il ne s’agit pas d’un guide de hachage générique. La valeur principale de la skill nodejs-keccak256 est d’améliorer la qualité de décision : elle vous dit quand le code est dangereux, quoi utiliser à la place, et comment vérifier que le résultat correspond bien aux outils Ethereum. C’est donc très pertinent pour nodejs-keccak256 for Backend Development, où la justesse compte davantage que la commodité.

Comment utiliser la skill nodejs-keccak256

Installer et ouvrir la skill

Installez la skill nodejs-keccak256 avec :
npx skills add affaan-m/everything-claude-code --skill nodejs-keccak256

Ouvrez ensuite d’abord SKILL.md. Dans ce dépôt, c’est le seul fichier d’accompagnement ; le plus efficace est donc de lire attentivement le corps de la skill et d’en faire votre référence de travail pour nodejs-keccak256 usage.

Transformer une tâche approximative en bon prompt

La skill donne ses meilleurs résultats si vous fournissez précisément la tâche de hachage, le runtime et l’artefact Ethereum attendu. De bons inputs incluent :

• la cible du hash : sélecteur de fonction, domaine EIP-712, topic d’événement, storage slot ou encodage compact
• la stack : Node.js, ethers v6, viem, web3.js ou crypto brut
• la forme de l’entrée : string, bytes, tuple encodé en ABI, adresse ou bigint
• le format de sortie souhaité : hex avec ou sans 0x, bytes, topic hash ou sélecteur

Exemple de structure de prompt :
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.

Adopter le bon workflow

Commencez par déterminer si le code fait du hachage Ethereum ou du SHA3 NIST générique. S’il s’agit d’un cas Ethereum, remplacez l’implémentation SHA3 de Node par une fonction de bibliothèque comme ethers ou viem, qui expose explicitement Keccak-256. Vérifiez ensuite le résultat à l’aide d’un sélecteur ou d’un topic connus, plutôt que de vous fier à une simple ressemblance visuelle.

Ce qu’il faut lire en premier

Pour ce nodejs-keccak256 guide, lisez SKILL.md en vous concentrant sur :

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

Ces sections indiquent le périmètre prévu, le mode d’échec et les patterns de remplacement privilégiés.

FAQ sur la skill nodejs-keccak256

nodejs-keccak256 sert-elle uniquement aux usages Ethereum ?

Oui, c’est son cas d’usage principal. La skill porte sur Keccak-256 compatible Ethereum, pas sur la cryptographie générale. Si vous avez besoin du SHA3-256 standard pour un usage hors Ethereum, ce n’est pas le bon outil.

Pourquoi ne pas utiliser simplement Node crypto directement ?

Parce que crypto.createHash('sha3-256') n’est pas Keccak-256. Node ne vous avertit pas, et le bug peut sembler “correct” jusqu’au moment où il casse un sélecteur, un topic ou une signature en production. La skill nodejs-keccak256 existe pour éviter ce décalage silencieux.

Est-ce adapté aux débutants ?

Oui, si vous savez décrire clairement l’objectif du hachage. Vous n’avez pas besoin de connaissances poussées en cryptographie pour tirer parti de nodejs-keccak256 install et des conseils d’utilisation, mais vous devez savoir quel artefact Ethereum vous construisez.

Fonctionne-t-elle avec ethers et viem ?

Oui. Les exemples du dépôt montrent des patterns pour ethers v6 et viem, ce qui rend cette skill vraiment utile dans des bases de code backend réelles. C’est un meilleur choix qu’un simple prompt quand vous avez besoin de remplacements corrects par construction et spécifiques à une bibliothèque.

Comment améliorer la skill nodejs-keccak256

Donner à la skill l’artefact exact

Les meilleurs résultats viennent quand vous précisez l’objet Ethereum qui est haché. Par exemple, dites “topic Transfer(address,address,uint256) d’ERC-721”, plutôt que simplement “hash this string”. Cela permet à la skill nodejs-keccak256 de choisir le bon encodage et la bonne forme de sortie.

Inclure la source et la sortie attendue

Si vous avez déjà du code en échec, collez l’extrait ainsi que la valeur attendue ou une référence connue comme correcte. Cela aide la skill à déterminer si le problème vient de l’encodage, du choix d’algorithme ou du formatage. Pour le backend, précisez aussi si la sortie doit rester compatible avec ethers v6, viem ou l’ancien web3.js.

Surveiller les modes d’échec fréquents

La plupart des erreurs ne viennent pas de Keccak lui-même, mais de la préparation de l’entrée. Les confusions entre string et bytes, l’absence de packing ABI et l’oubli de la normalisation 0x provoquent beaucoup de faux correctifs. Si la première réponse paraît plausible mais ne correspond pas à un sélecteur ou à un topic connus, demandez une étape de vérification et une réécriture spécifique à la bibliothèque.

Itérer en comparant avec une valeur connue

Après un premier passage, comparez le résultat avec un sélecteur, un topic ou un hash connus provenant d’une source Ethereum de confiance. S’il diffère, renvoyez le décalage exact et demandez une correction plus ciblée. C’est la manière la plus rapide d’améliorer nodejs-keccak256 usage sans deviner.