Acesso ao JSON-RPC
A devnet da Basis Network é uma rede pública de desenvolvimento, aberta à internet, mas cada requisição precisa de um token pessoal. Aqui está tudo o que você precisa para se conectar.
Não é um ambiente de produção: os LITHOS da devnet não têm valor e a cadeia pode ser reiniciada sem aviso prévio.
Configuração
O token vai no caminho da URL, não em um cabeçalho. Basta exportar uma variável e a CLI oficial funciona sem nenhuma outra mudança:
export BASIS_RPC_URL=https://rpc.basisnetwork.com.co/<seu-token>A mesma URL serve para qualquer cliente que fale JSON-RPC sobre HTTPS:
curl -X POST https://rpc.basisnetwork.com.co/<seu-token> \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'Cada token identifica uma pessoa e é revogado individualmente. Não publique nem cole o token em um repositório: quem tiver o token fala com a rede em seu nome. Se ele vazar, peça outro e desativamos o anterior na hora.
Dados da rede
| Parâmetro | Valor |
|---|---|
| Identificador da cadeia | 6969 (0x1b39) |
| Nome interno | basis-devnet-6969 |
| Moeda | LITHOS |
| Unidade mínima | tomo — 1 LITHOS = 1.000.000.000 tomos |
| Casas decimais | 9 |
| Taxa base mínima | 100 tomos por unidade de gas |
| Custo de uma transferência | 21.000 gas × 100 = 0,0021 LITHOS |
| Tempo de bloco | ≈ 3 s, havendo ou não transações |
| Assinaturas | ML-DSA-65 (FIPS 204) |
| Endereços | 32 bytes — BLAKE3 da chave pública |
| Endpoint JSON-RPC | rpc.basisnetwork.com.co/<seu-token> |
| Explorador | explorer.basisnetwork.com.co |
A Basis é pós-quântica: aqui, uma carteira de Ethereum só consegue ler. Os endereços têm 32 bytes em vez de 20 e as assinaturas são ML-DSA-65, não secp256k1; por isso a MetaMask e similares conseguem consultar a cadeia, mas não conseguem assinar uma transação para ela. Para enviar transações, use a CLI da Basis ou a carteira oficial.
Limites
| Limite | Valor |
|---|---|
| Requisições por endereço IP | 25/s sustentadas, picos de até 50 |
| Chamadas por lote | 100 |
| Métodos habilitados | 38 (os listados abaixo) |
| Tamanho de uma transferência | ≈ 5.444 bytes trafegados |
Exceder o limite de requisições retorna 429; chamar um método fora da lista retorna um erro JSON-RPC, não uma falha de rede. A devnet não guarda estado histórico: consultas a blocos antigos — eth_call ou eth_getBalance em uma altura passada — falham por design. Consulte sempre com latest.
Métodos disponíveis
Os eth_* são a interface de compatibilidade; os basis_* são os nativos, e os únicos que entendem os endereços de 32 bytes sem truncá-los.
- eth_blockNumber
- eth_chainId
- net_version
- web3_clientVersion
- eth_getBlockByNumber
- eth_getBlockByHash
- eth_getTransactionByHash
- eth_getTransactionReceipt
- eth_getTransactionByBlockNumberAndIndex
- eth_getTransactionByBlockHashAndIndex
- eth_getBalance
- eth_getCode
- eth_getStorageAt
- eth_getLogs
- eth_call
- eth_estimateGas
- eth_gasPrice
- eth_maxPriorityFeePerGas
- eth_feeHistory
- eth_getTransactionCount
- eth_syncing
- eth_getUncleByBlockHashAndIndex
- eth_sendRawTransaction
- eth_getBlockReceipts
- eth_getBlockTransactionCountByNumber
- basis_blockNumber
- basis_resolveAddress
- basis_getRawTransaction
- basis_getBlockConsensus
- basis_getBalance
- basis_getTransactionCount
- basis_getBlock
- basis_getBlocks
- basis_chainId
- basis_getSubnets
- basis_getValidators
- basis_getAccount
- basis_getReceipt
Obter um token
No Discord da Basis Network, digite /rpc-token e conte em uma frase o que você vai construir. A solicitação chega à equipe e, quando alguém a aprova, o bot envia a URL completa para você por mensagem direta. Deixe as mensagens diretas abertas para esse servidor, senão ele não vai conseguir enviá-la.
Um token por pessoa: se pedir de novo, você recebe o mesmo. Se preferir e-mail, contact@basisnetwork.com.co também serve.