Métodos da API JSON-RPC

Métodos Ethereum padrão

A compatibilidade EVM da Tanssi é derivada do Frontier e segue de perto a compatibilidade Ethereum do Moonbeam. Os nós da Tanssi suportam uma ampla variedade de métodos JSON-RPC padrão do Ethereum.

Nem todos os métodos são suportados; alguns retornam valores padrão (especialmente os ligados ao PoW). Abaixo está a lista dos métodos Ethereum JSON-RPC suportados na Tanssi para que os desenvolvedores saibam o que está disponível ao interagir com redes EVM da Tanssi.

Métodos básicos da API Ethereum suportados:

• eth_protocolVersion — retorna 1 por padrão
• eth_syncing — retorna um objeto com o status de sincronização ou false
• eth_hashrate — retorna "0x0" por padrão
• eth_coinbase — retorna o autor do último bloco (não necessariamente finalizado)
• eth_mining — retorna false por padrão
• eth_chainId — retorna o chain ID usado para assinar no bloco atual
• eth_gasPrice — retorna a base fee por unidade de gas. Atualmente é o gas price mínimo da rede
• eth_accounts — lista de endereços do cliente
• eth_blockNumber — maior número de bloco disponível
• eth_getBalance — saldo do endereço fornecido
• eth_getStorageAt — conteúdo do storage em um endereço
• eth_getBlockByHash — informações do bloco por hash, incluindo baseFeePerGas em blocos pós-London
• eth_getBlockByNumber — informações do bloco por número, incluindo baseFeePerGas em blocos pós-London
• eth_getBlockReceipts — todos os receipts de transações de um bloco
• eth_getTransactionCount — número de transações (nonce) enviadas pelo endereço
• eth_getBlockTransactionCountByHash — número de transações em um bloco por hash
• eth_getBlockTransactionCountByNumber — número de transações em um bloco por número
• eth_getUncleCountByBlockHash — retorna "0x0" por padrão
• eth_getUncleCountByBlockNumber — retorna "0x0" por padrão
• eth_getCode — código no endereço informado e bloco informado
• eth_sendTransaction — cria transação de chamada ou criação de contrato (se houver código em data). Retorna o hash da transação ou zero hash se ainda não disponível
• eth_sendRawTransaction — cria transação de chamada ou criação para transações assinadas. Retorna hash ou zero hash se ainda não disponível
• eth_call — executa chamada sem criar transação, retornando o valor da execução
• eth_estimateGas — estima o gas necessário para uma transação. Pode receber gasPrice ou maxFeePerGas e maxPriorityFeePerGas
• eth_feeHistory — retorna baseFeePerGas, gasUsedRatio, oldestBlock e reward para um intervalo de até 1024 blocos
• eth_getTransactionByHash — informações de uma transação por hash; transações EIP-1559 incluem maxPriorityFeePerGas e maxFeePerGas
• eth_getTransactionByBlockHashAndIndex — informações de uma transação por hash do bloco e índice; inclui campos EIP-1559
• eth_getTransactionByBlockNumberAndIndex — informações de uma transação por número do bloco e índice; inclui campos EIP-1559
• eth_getTransactionReceipt — receipt de uma transação por hash
• eth_getUncleByBlockHashAndIndex — retorna null por padrão
• eth_getUncleByBlockNumberAndIndex — retorna null por padrão
• eth_getLogs — array de logs que correspondem ao filtro
• eth_newFilter — cria filtro com base nos parâmetros fornecidos; retorna o ID do filtro
• eth_newBlockFilter — cria filtro para avisar quando chegar um novo bloco; retorna ID
• eth_getFilterChanges — método de polling para filtros; retorna logs desde o último poll
• eth_getFilterLogs — array de logs que correspondem ao filtro com ID fornecido
• eth_uninstallFilter — remove um filtro pelo ID; use quando o polling não for mais necessário (filtros expiram se não forem consultados)

Métodos JSON-RPC personalizados

Os nós da Tanssi expõem dois endpoints personalizados: frnt_isBlockFinalized e frnt_isTxFinalized. Como a Tanssi tem finalização determinística, é possível saber com certeza se um bloco ou transação está finalizado ou não. Esses endpoints ajudam a verificar a finalização de eventos on-chain.

frnt_isBlockFinalized - verifica a finalização do bloco pelo hash

ParâmetrosRetornoExemplo

• block_hash string - hash do bloco (aceita hash estilo Substrate ou Ethereum)

boolean - true se o bloco estiver finalizado; false se não estiver finalizado ou não encontrado

curl -H "Content-Type: application/json" -X POST --data '{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "frnt_isBlockFinalized",
  "params": ["INSERT_BLOCK_HASH"]
}' https://services.tanssi-testnet.network/dancelight-2001/

frnt_isTxFinalized - verifica a finalização de uma transação pelo hash EVM

ParâmetrosRetornoExemplo

• tx_hash string - hash EVM da transação

boolean - true se a transação estiver finalizada; false se não estiver finalizada ou não encontrada

curl -H "Content-Type: application/json" -X POST --data '{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "frnt_isTxFinalized",
  "params": ["INSERT_TRANSACTION_HASH"]
}' https://services.tanssi-testnet.network/dancelight-2001/

Última atualização: 9 de dezembro de 2025
| Criada: 9 de dezembro de 2025