Skip to content

rmelfi/drex-sandbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💻 DREX Sandbox — Projeto de Teste Local

Este repositório é um guia simples para criar e rodar um sandbox do DREX localmente, usando Hardhat 3 e Ethers v6.


🚀 Começando

1. Pré-requisitos

  • Node.js 22+ (LTS)
  • npm
node -v
npm -v

2. Instalação

Clone o repositório e instale as dependências:

git clone https://github.com/rmelfi/drex-sandbox.git
cd drex-sandbox
npm install

3. Compilar os contratos

npm run compile

Os artifacts serão gerados em artifacts/.


4. Rodar o nó local

Abra um terminal e rode:

npm run node

Isso inicia a blockchain local em http://127.0.0.1:8545 com contas de teste pré-carregadas.


5. Deploy do RealDigital e STR

Em outro terminal:

npm run deploy

O script scripts/deploy.ts vai:

  • Conectar ao nó local
  • Obter três contas (deployer, authority, admin)
  • Deployar o contrato RealDigital.sol
  • Deployar o contrato STR.sol
  • Mostrar os endereços no console

6. Testar funcionalidades

Há scripts de demonstração, como:

npx hardhat run --network localhost scripts/demo-buy-car.ts
npx hardhat run --network localhost scripts/demo-split.ts

Eles simulam:

  • Habilitação de contas (enableAccount)
  • Emissão (requestToMint)
  • Transferência entre participantes
  • Queima (requestToBurn)

🧠 Conceitos importantes

  • Hardhat: framework para compilar, testar e rodar scripts de contratos Ethereum.
  • Ethers v6: biblioteca para deploy e interação com contratos.
  • RealDigital.sol: token ERC20 com 2 casas decimais.
  • CBDCAccessControl.sol: define papéis como MINTER_ROLE, BURNER_ROLE, PAUSER_ROLE, etc.
  • STR.sol: contrato que chama mint e burn no RealDigital para participantes autorizados.

Sempre use ethers.parseUnits(valor, 2) para lidar com valores (por exemplo, 100.5010050).


⚠️ Avisos

  • Este projeto é somente para testes locais.
  • As chaves privadas exibidas pelo Hardhat são de desenvolvimento e não devem ser usadas em produção.

📹 Vídeo

Gravei um passo a passo mostrando como usar este repositório do zero ao deploy:
📽️ Link do vídeo: Video

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors