nodejs-keccak256

Visão geral da skill nodejs-keccak256

O que a skill nodejs-keccak256 faz

A skill nodejs-keccak256 ajuda você a evitar um bug muito comum em Ethereum em JavaScript e TypeScript: usar crypto.createHash('sha3-256') do Node quando, na verdade, você precisa de Keccak-256. Essa diferença pode quebrar silenciosamente seletores, tópicos de eventos, assinaturas, cálculos de storage slot e derivação de endereços.

Para quem esta skill é indicada

Use a skill nodejs-keccak256 se você trabalha com serviços de backend, bots, indexadores, ferramentas de carteira, helpers de smart contracts ou qualquer código Node que faça hash de dados de Ethereum. Ela é especialmente útil para revisores e mantenedores que precisam identificar hash incorreto antes do deploy.

Por que isso importa

Isso não é um guia genérico de hashing. O principal valor da skill nodejs-keccak256 está na qualidade da decisão: ela mostra quando o código está inseguro, com o que substituir e como confirmar que a saída bate com as ferramentas do ecossistema Ethereum. Isso a torna prática para nodejs-keccak256 for Backend Development, onde a correção pesa mais do que a conveniência.

Como usar a skill nodejs-keccak256

Instale e abra a skill

Instale a skill nodejs-keccak256 com:
npx skills add affaan-m/everything-claude-code --skill nodejs-keccak256

Depois, abra primeiro o SKILL.md. Neste repositório, esse é o único arquivo de apoio, então o caminho mais rápido é ler o corpo da skill com atenção e usá-lo como referência de trabalho para nodejs-keccak256 usage.

Transforme uma tarefa vaga em um bom prompt

A skill funciona melhor quando você informa exatamente qual é o hashing, qual runtime está em uso e qual artefato de Ethereum você espera obter. Boas informações de entrada incluem:

• o alvo do hash: selector de função, domínio EIP-712, tópico de evento, storage slot ou packed encoding
• a stack: Node.js, ethers v6, viem, web3.js ou crypto puro
• o formato da entrada: string, bytes, tuple codificada em ABI, address ou bigint
• o formato de saída desejado: hex com ou sem 0x, bytes, topic hash ou selector

Exemplo de formato 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.

Use o fluxo de trabalho certo

Comece identificando se o código está fazendo hashing para Ethereum ou SHA3 NIST genérico. Se for algo relacionado a Ethereum, troque a implementação SHA3 do Node por uma função de biblioteca, como ethers ou viem, que exponha Keccak-256 de forma explícita. Depois, valide o resultado contra um selector ou tópico conhecido, em vez de confiar só na aparência visual.

O que ler primeiro

Para este nodejs-keccak256 guide, leia SKILL.md e foque em:

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

Essas seções mostram o limite pretendido, o modo de falha e os padrões de substituição preferidos.

Perguntas frequentes sobre a skill nodejs-keccak256

A skill nodejs-keccak256 é só para Ethereum?

Sim, esse é o principal encaixe. A skill trata de Keccak-256 compatível com Ethereum, não de criptografia geral. Se você precisa de SHA3-256 padrão para uso fora de Ethereum, esta skill não é a ferramenta certa.

Por que não usar o Node crypto diretamente?

Porque crypto.createHash('sha3-256') não é Keccak-256. O Node não emite aviso, e o bug pode parecer “certo” até quebrar um selector, tópico ou assinatura em produção. A skill nodejs-keccak256 existe para evitar esse desalinhamento silencioso.

É amigável para iniciantes?

Sim, desde que você consiga descrever o objetivo do hashing em linguagem simples. Você não precisa de conhecimento profundo de criptografia para aproveitar nodejs-keccak256 install e as orientações de uso, mas precisa saber qual artefato de Ethereum está construindo.

Funciona com ethers e viem?

Sim. Os exemplos do repositório mostram padrões com ethers v6 e viem, o que torna essa skill útil em bases de backend reais. Ela é uma opção melhor do que um prompt genérico quando você precisa de substituições corretas por construção e específicas da biblioteca.

Como melhorar a skill nodejs-keccak256

Dê à skill o artefato exato

Os melhores resultados vêm quando você especifica qual objeto de Ethereum está sendo hasheado. Por exemplo, diga “tópico de Transfer(address,address,uint256) de ERC-721”, em vez de apenas “faça hash desta string”. Isso permite que a nodejs-keccak256 skill escolha a codificação e o formato de saída corretos.

Inclua a origem e a saída esperada

Se você já tiver código com falha, cole o trecho e o valor esperado ou uma referência confiável que já funcione. Isso ajuda a skill a identificar se o problema está na codificação, na escolha do algoritmo ou na formatação. Em trabalho de backend, também diga se a saída precisa continuar compatível com ethers v6, viem ou o legado web3.js.

Fique atento aos modos de falha mais comuns

A maioria dos erros não está no Keccak em si, mas na preparação da entrada. Confusão entre string e bytes, ausência de ABI packing e esquecimento da normalização de 0x geram muitas correções falsas. Se a primeira resposta parecer correta, mas não bater com um selector ou tópico conhecido, peça uma etapa de verificação e uma reescrita específica para a biblioteca.

Itere validando contra um valor conhecido

Depois da primeira passada, compare o resultado com um selector, tópico ou hash conhecido de uma fonte confiável do ecossistema Ethereum. Se houver diferença, devolva a divergência exata e peça uma correção mais restrita. Esse é o jeito mais rápido de melhorar o uso de nodejs-keccak256 sem adivinhação.