Contratos inteligentes compatíveis com EVM na BrightCity Chain Testnet. Use os padrões ERC para credenciais, registros, tokens de utilidade e integração com backends.

ERC-721

Ativos únicos: credenciais, certificados, licenças digitais

ERC-1155

Múltiplos tipos: lotes, insumos, edições numeradas

ERC-20

Tokens fungíveis: créditos, pontos, moedas de utilidade

Por que usar padrões ERC?

Carteiras, SDKs e o explorer entendem ERC-721, ERC-1155 e ERC-20 sem adaptadores proprietários.
Implementações amplamente usadas. Estenda com Ownable, AccessControl e hooks padrão.
Compile com evmVersion: "berlin" e Solidity 0.8.28. Veja Diferenças em relação ao Ethereum.
Mint, transferência e leitura de eventos via RPC (eth_getLogs) ou indexador. Veja Boas práticas para integradores.

Rede

ItemValor
RPChttps://rpc.fmartns.dev
Chain ID20260520
Fork EVMBerlin
A testnet usa fork Berlin. Não use evmVersion de Shanghai ou superior no compilador, ou o deploy pode falhar com Invalid opcode.

Deploy

Publique contratos com Hardhat (ou Foundry) apontando para a testnet:
npm install --save-dev hardhat @nomicfoundation/hardhat-toolbox dotenv
Veja o guia Deploy de contratos para configuração completa de rede, .env e exemplo HelloWorld.

Controle de acesso

Em redes permissionadas, controle quem pode mintar ou administrar contratos:
  • Ownable: um administrador (operador do consórcio).
  • AccessControl: papéis separados (MINTER_ROLE, UPGRADER_ROLE, etc.).
Funções de mint e upgrade devem ficar no backend com chave de serviço, nunca expostas no frontend do cidadão.

Royalties (EIP-2981)

Contratos podem implementar EIP-2981 para repasse automático em transferências secundárias, se a política do consórcio exigir. Em rede privada, o enforcement depende dos contratos e integrações aprovadas.

Verificação no explorer

Após o deploy, consulte o endereço em explorer.fmartns.dev para validar bytecode, transações de criação e interações. Veja Consultar no explorer.

Próximos passos

Deploy na testnet

Hardhat, RPC e chain ID

ERC-721

Ativos únicos e metadata

ERC-1155

Lotes e semi-fungíveis

ERC-20

Tokens fungíveis