BrightCity Chain - BrightCity Chain

A BrightCity Chain é uma blockchain permissionada de consórcio: apenas validadores autorizados produzem blocos, o acesso à rede é controlado pela BrightCity e as aplicações focam em serviços urbanos digitais (IoT, identidade, contratos de serviço público, trilhas de auditoria, etc.).

Rede privada permissionada

Consórcio BrightCity com validadores conhecidos e acesso controlado

Blocos a cada 2s

QBFT com blockperiodseconds: 2, com finalidade BFT adequada a operações urbanas em tempo quase real

Hyperledger Besu

Cliente Ethereum enterprise-grade, operação e observabilidade maduras para redes corporativas

EVM compatível

Contratos em Solidity com Foundry, Hardhat, viem, ethers.js e ferramentas do ecossistema Ethereum

Hyperledger Besu

Documentação oficial do cliente de nó

Ambientes oficiais

Serviço	Produção	Desenvolvimento
RPC	`https://rpc.pgubright.com`	`https://rpc-develop.pgubright.com`
Explorer	explorer.pgubright.com	explorer-develop.pgubright.com
API (Energy)	`https://api-bc.pgubright.com`	`https://api-bc-develop.pgubright.com`
Documentação	docs-bc.pgubright.com	docs-bc-develop.pgubright.com
Web (Marketplace)	web-bc.pgubright.com	web-bc-develop.pgubright.com

Os exemplos de integração nesta documentação usam o ambiente de desenvolvimento (*-develop.pgubright.com), salvo indicação em contrário.

Configuração da rede

Configuração básica

Property	Value
Network Name	BrightCity Chain Testnet
Tipo	Rede privada (consórcio)
Chain ID	`20260520`
Cliente	Hyperledger Besu
Consenso	QBFT
RPC URL	`https://rpc-develop.pgubright.com`
Currency Symbol	ETH (unidade nativa padrão Besu)
Currency Decimals	18
Block Explorer	explorer-develop.pgubright.com

Detalhes da chain

Property	Value
Fork ativado	Berlin (`berlinBlock: 0`)
Block Time	~2 segundos (`blockperiodseconds`)
Finality	Finalidade BFT após commit QBFT (tipicamente ~1 bloco na rede estável)
Block Gas Limit	`30,000,000` (`0x1c9c380`)
EVM	Compatível com ferramentas Ethereum

Parâmetros QBFT (genesis)

Parâmetro	Valor
`blockperiodseconds`	`2`
`epochlength`	`30000`
`requesttimeoutseconds`	`10`

O conjunto inicial de validadores está codificado em extraData no genesis. Alterações no validator set seguem o fluxo de governança QBFT (votação entre validadores).

Conectar com código

Endpoint JSON-RPC: https://rpc-develop.pgubright.com

viem
ethers.js
Foundry
Hardhat
MetaMask

import { defineChain } from 'viem';
import { createPublicClient, createWalletClient, http } from 'viem';

export const brightCityChain = defineChain({
  id: 20260520,
  name: 'BrightCity Chain',
  nativeCurrency: {
    name: 'Ether',
    symbol: 'ETH',
    decimals: 18,
  },
  rpcUrls: {
    default: { http: ['https://rpc-develop.pgubright.com'] },
  },
});

const publicClient = createPublicClient({
  chain: brightCityChain,
  transport: http('https://rpc-develop.pgubright.com'),
});

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://rpc-develop.pgubright.com', {
  chainId: 20260520,
  name: 'brightcity-chain',
});

# foundry.toml
[rpc_endpoints]
brightcity = "https://rpc-develop.pgubright.com"

# forge script script/Deploy.s.sol --rpc-url brightcity --chain-id 20260520 --broadcast

import { HardhatUserConfig } from 'hardhat/config';

const config: HardhatUserConfig = {
  networks: {
    brightcity: {
      url: process.env.BRIGHTCITY_RPC_URL ?? 'https://rpc-develop.pgubright.com',
      accounts: process.env.PRIVATE_KEY ? [process.env.PRIVATE_KEY] : [],
      chainId: 20260520,
    },
  },
};

export default config;

{
  "chainId": "0x134f1c8",
  "chainName": "BrightCity Chain Testnet",
  "nativeCurrency": {
    "name": "Ether",
    "symbol": "ETH",
    "decimals": 18
  },
  "rpcUrls": ["https://rpc-develop.pgubright.com"],
  "blockExplorerUrls": ["https://explorer-develop.pgubright.com"]
}

Acesso à rede

Aspecto	Descrição
Validadores	Nós Besu permissionados operados pelo consórcio BrightCity
Participação	Integrações via `https://rpc-develop.pgubright.com` ou nó dedicado do parceiro

Não exponha chaves privadas de validadores nem o arquivo nodekey em repositórios. O genesis com alloc e extraData é sensível à governança da rede.

Recursos

Conectar carteira

MetaMask e parâmetros da testnet

Usar o RPC

JSON-RPC com curl, viem e ethers

Plataforma energética

Sensores, medições, mercado automático, pagamentos e bridge

Contratos

EuroToken, SensorRegistry, EnergyMarket e EnergySettlement

Consultar no explorer

Blocos, transações e contratos

Diferenças vs Ethereum

Compatibilidade EVM e limitações

Consenso e validadores

QBFT na rede permissionada

Próximos passos

Gas e transações

ETH nativo e envio de transações

Boas práticas

Backends e indexadores

FAQ

Perguntas frequentes

Besu docs

Documentação Hyperledger Besu

Rede privada permissionada

Blocos a cada 2s

Hyperledger Besu

EVM compatível

Hyperledger Besu

​Ambientes oficiais

​Configuração da rede

​Configuração básica

​Detalhes da chain

​Parâmetros QBFT (genesis)

​Conectar com código

​Acesso à rede

​Recursos

Conectar carteira

Usar o RPC

Plataforma energética

Contratos

Consultar no explorer

Diferenças vs Ethereum

Consenso e validadores

​Próximos passos

Gas e transações

Boas práticas

FAQ

Besu docs

Ambientes oficiais

Configuração da rede

Configuração básica

Detalhes da chain

Parâmetros QBFT (genesis)

Conectar com código

Acesso à rede

Recursos

Próximos passos