O endpoint público da BrightCity Chain Testnet é:
Trata-se de um JSON-RPC compatível com Ethereum/EVM. Use-o em carteiras, SDKs, backends e scripts para ler estado e enviar transações assinadas.
Métodos disponíveis no uso público
Para integração normal, utilize namespaces eth_* , net_* e web3_* (por exemplo: eth_chainId, eth_blockNumber, eth_getBalance, eth_sendRawTransaction).
Métodos debug_* , engine_* , txpool_* e admin_* não fazem parte do uso público deste endpoint. Eles são reservados à operação interna da rede.
eth_chainId
eth_blockNumber
net_version
eth_getBalance
eth_getTransactionReceipt
curl -s https://rpc.fmartns.dev \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}'
import { createPublicClient , http , formatEther } from 'viem' ;
const client = createPublicClient ({
transport: http ( 'https://rpc.fmartns.dev' ),
});
const chainId = await client . getChainId ();
const blockNumber = await client . getBlockNumber ();
const balance = await client . getBalance ({
address: '0xSEU_ENDERECO' ,
});
console . log ({ chainId , blockNumber , eth: formatEther ( balance ) });
import { ethers } from 'ethers' ;
const provider = new ethers . JsonRpcProvider ( 'https://rpc.fmartns.dev' , {
chainId: 20260520 ,
name: 'brightcity-chain-testnet' ,
});
const network = await provider . getNetwork ();
const blockNumber = await provider . getBlockNumber ();
const balance = await provider . getBalance ( '0xSEU_ENDERECO' );
console . log ({ chainId: network . chainId , blockNumber , balance: balance . toString () });
Boas práticas
Evite polling agressivo (muitas requisições por segundo). Prefira intervalos razoáveis ou WebSocket apenas se o endpoint suportar e estiver documentado para seu caso.
Implemente retry com backoff em falhas temporárias (timeout, 502, 503).
Trate erros JSON-RPC (error.code, error.message) de forma explícita no backend.
Ao indexar eventos, persista o último bloco processado e retome a partir de bloco + 1 após reinícios.
Sempre valide chainId === 20260520 na inicialização do cliente.
Próximos passos
Boas práticas para integradores Padrões para backends e indexadores
Gas e transações Gas nativo e envio de transações