gbit-address
v1.0.0
Published
Gera pares de chaves (endereço + chave privada) para testes locais de desenvolvimento Web3.
Readme
🔑 gbit-address
Gera pares de chaves (endereço + chave privada) para testes locais de desenvolvimento Web3.
Igual às contas que o npx hardhat node mostra ao subir uma rede local — só que sob demanda, em qualquer terminal, sem precisar de um projeto Hardhat rodando.
📦 Pacote no NPM · 💻 Repositório no GitHub
⚠️ Aviso importante
As chaves geradas por esse CLI são para testes e desenvolvimento local. Elas aparecem em texto puro no terminal (e, se você optar por salvar, também em arquivo).
Nunca envie fundos reais para esses endereços, e nunca use essas chaves em produção ou em redes mainnet. Uma chave que já foi exibida em tela ou salva em arquivo não deve ser considerada segura para guardar valor real.
Instalação
npm install -g gbit-addressou
npx gbit-addressPor padrão, gera 10 contas. Para gerar uma quantidade diferente:
npx gbit-address 20✨ O que cada conta mostra
Conta #0
Address:
0xb092AE....
Private Key:
0xa39470....
Balance:
10000 ETH (saldo simulado, apenas para testes locais)
- Address e Private Key são gerados com ethers.js, a mesma biblioteca usada por ferramentas como Hardhat e MetaMask — criptograficamente seguros e aleatórios.
- Balance é apenas ilustrativo (não existe rede de verdade por trás), útil para simular contas de teste em interfaces e scripts.
💾 Salvando em arquivo
Ao final, o CLI pergunta se você quer salvar as contas em gbit-accounts.json. Se você confirmar:
- O arquivo é criado na pasta atual
- Se existir um
.gitignoreno projeto, o CLI adicionagbit-accounts.jsonautomaticamente, evitando que chaves privadas sejam enviadas sem querer para um repositório público
📦 Instalação
npx gbit-addressOu, se preferir instalar globalmente:
npm install -g gbit-address
gbit-addressRecursos
✅ Gera 10 contas Ethereum
✅ Endereços únicos
✅ Private Keys
✅ Compatível com Hardhat
✅ Compatível com Ganache
✅ Compatível com Foundry
✅ Ideal para testes locais
✅ Saída organizada
🛠️ Tecnologias
Node.js
ethers.js — geração das chaves
chalk — cores no terminal
inquirer — confirmação para salvar em arquivo
figlet + gradient-string — logo ASCII colorido
🗺️ Roadmap
- [ ] Opção de gerar contas a partir de uma mnemônica (seed phrase) específica
- [ ] Suporte a outras redes além de EVM (ex: Solana)
- [ ] Flag
--quietpara gerar sem prints, direto para arquivo
🤝 Ecossistema Gbit
| Ferramenta | Descrição |
|---|---|
| gbit-next | Cria projetos Next.js prontos, com templates completos |
| gbit-start | Abre ou clona qualquer projeto existente e o deixa rodando |
| gbit-readme | Gera README profissional automaticamente |
| gbit-address | Este CLI — gera pares de chaves para testes Web3 |
| create-gbit-app | Projetos fullstack completos (Backend + Frontend Vite/TS + Smart Contracts) |
