Explorar ativos Ethereum: como consultar todos os Tokens ERC-20 na Carteira

No mundo da Blockchain, verificar o saldo de Tokens ERC-20 na própria Carteira é relativamente simples — basta abrir a aplicação da Carteira para ver todas as informações de saldo dos Tokens importados. No entanto, quando precisamos consultar os Tokens detidos pelo endereço de outra pessoa, a situação torna-se complexa, especialmente na ausência de acesso direto à Carteira da outra parte.

Para investidores individuais, analistas de empresas ou investigadores de blockchain, a capacidade de obter rapidamente dados de posse de tokens de um endereço específico é uma habilidade importante. Felizmente, a infraestrutura moderna de blockchain oferece várias soluções de API que nos permitem consultar eficientemente a situação de posse de tokens ERC-20 de qualquer endereço Ethereum.

Este artigo irá apresentar detalhadamente três serviços de API populares - Chainbase, Alchemy e Moralis, que oferecem soluções especializadas para consultar tokens ERC-20 em endereços específicos. Vamos demonstrar, de uma forma amigável para desenvolvedores, como implementar a funcionalidade de consulta de ativos através dessas ferramentas.

Chainbase: A escolha eficiente para consulta de dados de Blockchain

Chainbase é uma poderosa infraestrutura de camada de interação da blockchain Web3, cujo serviço de API pode ajudar os desenvolvedores a acessar e utilizar rapidamente os dados da blockchain. Através de passos simples, podemos consultar a situação de posse de tokens de qualquer endereço.

Configurações de Conta e Preparativos

1. Criar conta e obter chave API

   • Visite o site da Chainbase para se registrar uma conta gratuita
   • Após o login, acesse o painel e crie um novo projeto
   • Obter e guardar a chave API, que é um requisito necessário para consultas futuras.

2. Preparação do Ambiente de Desenvolvimento

   • Certifique-se de que o seu ambiente de desenvolvimento tem o Node.js instalado
   • Usar npm para instalar a biblioteca Axios: npm install axios --save

Implementar a funcionalidade de consulta

Usar JavaScript para interagir com a API Chainbase e obter o saldo de Token ERC-20 do Endereço especificado:

javascript const axios = require('axios');

async function getERC20Tokens() { tente { const response = await axios.get( ' { params: { chain_id: '1', // Ethereum mainnet endereço: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045', // Exemplo de endereço limite: 5 // Retorna os 5 primeiros Tokens }, cabeçalhos: { 'x-api-key': 'sua chave API' // substitua pela sua chave real } } ); console.log(JSON.stringify(response.data, null, 2)); } catch (error) { console.error('Consulta falhou:', error); } }

getERC20Tokens();

Ver resultados da consulta

Após executar o script, você verá uma resposta JSON semelhante à abaixo, mostrando os detalhes do Token ERC-20 detidos no endereço especificado:

{ "data": [ { "chain_id": "1", "endereço": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", "contract_address": "0xc00e94cb662c3520282e6f5717214004a7f26888", "name": "Compound", "symbol": "COMP", "decimais": 18, "balance": "10472650474472796", "balance_in_usd": 0.71 }, ...mais informações sobre tokens... ] }

Os dados de resposta contêm informações chave, como o endereço do contrato de cada Token, nome, símbolo, número de casas decimais, saldo e valor em dólares.

Alchemy: Plataforma profissional de desenvolvimento Blockchain

Alchemy é a principal plataforma no campo do desenvolvimento de Blockchain, oferecendo poderosas ferramentas de API para ler e escrever dados de Blockchain. Abaixo estão os passos detalhados para consultar o saldo de Token ERC-20 através da Alchemy:

Preparação do ambiente e configuração da conta

1. Instalar ferramentas necessárias

   • Instalar Node.js e NPM
   • Criar pasta do projeto e inicializar o ambiente

2. Obter credenciais de acesso Alchemy

   • Registar uma conta Alchemy
   • Criar uma nova aplicação, escolher a rede principal Ethereum
   • Salvar a URL HTTP e a chave API da aplicação

Configuração e Desenvolvimento do Projeto

Criar estrutura do projeto e instalar dependências:

bash mkdir eth-balance cd eth-balance npm init -y npm install alchemy-sdk toque main.js

Escreva o código de consulta no arquivo main.js:

javascript const { Alchemy, Network } = require("alchemy-sdk");

// Configurar parâmetros de acesso const config = { apiKey: "Sua chave API", rede: Rede.ETH_MAINNET };

const alchemy = new Alchemy(config); const endereço = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045";

// Obter saldo do token async function getTokenBalances() { const balances = await alchemy.core.getTokenBalances(endereço); console.log("Saldo do Token:"); console.log(saldos);

// Processar Tokens com saldo diferente de zero const nonZeroBalances = balances.tokenBalances.filter(token => { return token.tokenBalance !== "0"; });

console.log( Este endereço possui ${nonZeroBalances.length} tipos de saldos não zero de Tokens ERC-20);

// Obter informações mais detalhadas sobre o Token para (de token de nonZeroBalances) { const metadata = await alchemy.core.getTokenMetadata(token.contractAddress); console.log(Token: ${metadata.name}); console.log(símbolo: ${metadata.symbol}); console.log( saldo: ${token.tokenBalance / Math.pow(10, metadata.decimals)}); console.log("-----"); } }

getTokenBalances();

Execução de consultas e análise de resultados

Executar o script para ver o resultado:

bash node main.js

Os resultados da consulta mostrarão informações detalhadas sobre o Token, incluindo:

• Nome e símbolo do Token
• Endereço do contrato
• Quantidade de saldo formatada
• Token metadata (como número de casas decimais)

A vantagem do Alchemy é que ele não só fornece consultas básicas de saldo, mas também suporta a obtenção de metadados, filtragem de tokens e formatação de saldo, permitindo que os desenvolvedores construam facilmente funcionalidades completas de gestão de ativos.

Moralis: Serviço de API Web3 de nível empresarial

Moralis oferece um conjunto de ferramentas API Web3 completo, ajudando os desenvolvedores a integrar facilmente funcionalidades de blockchain. Os passos para consultar o saldo de tokens ERC-20 usando Moralis são os seguintes:

Trabalho de preparação inicial

1. Configuração do Ambiente

   • Instalar o Node.js v14+ e o NPM
   • Definir variáveis de ambiente do sistema

2. Obter a chave API

   • Criar conta Moralis
   • Após o login, vá a "Configurações" > "Segredo" para encontrar a "Chave API Web3"
   • Copiar a chave para uso futuro

implementação de código

Crie um novo arquivo JavaScript e escreva o seguinte código:

javascript const Moralis = require("moralis").default;

// Inicializar Moralis async function initMoralis() { await Moralis.start({ apiKey: "sua chave API" }); }

// Consultar Token na Carteira async function fetchWalletTokens() { await initMoralis();

tente { const Endereço = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045";

const response = await Moralis.EvmApi.token.getWalletTokenBalances({
  endereço: endereço,
  chain: "0x1" // Ethereum Mainnet
});

console.log(JSON.stringify(response.toJSON(), null, 2));

} catch (e) { console.error(e); } }

fetchWalletTokens();

Execução de consulta e análise de resultados

Executar o script para obter resultados:

bash node moralis-tokens.js

Exemplo de resultado da consulta:

json [ { "token_address": "0x4d224452801aced8b2f0aebe155379bb5d594381", "name": "ApeCoin",} "símbolo": "APE", "logo": "", "thumbnail": "", "decimais": 18, "balance": "5000000000000000000" }, { "endereço_token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "símbolo": "WETH", "logo": null, "thumbnail": null, "decimais": 18, "balance": "7050000000000000000" } ]

A resposta da API Moralis fornece informações completas sobre a moeda, incluindo nome, símbolo, endereço do contrato, URL do logotipo e saldo expresso na menor unidade da moeda. Esses dados podem ser usados diretamente para desenvolver aplicações de gestão de ativos, ferramentas de análise de portfólio ou sistemas de visualização de dados de blockchain.

Comparação de Funcionalidades do Serviço API

| Características | Chainbase | Alchemy | Moralis | |---------|----------|---------|---------| | Limite gratuito | Número de solicitações limitado | Pacote gratuito disponível | Nível gratuito disponível | | Velocidade de consulta | Rápido | Muito rápido | Rápido | | Token Metadados | Suporte | Suporte Detalhado | Suporte Abrangente | | Dados Históricos | Suporte Parcial | Suporte | Suporte | | Usabilidade | Alta | Média | Elevada | | Cenários de Aplicação | Consulta Básica | Desenvolvimento Profissional | Aplicações Empresariais |

Através destes três serviços de API, desenvolvedores e pesquisadores podem facilmente obter informações sobre as holdings de Token ERC-20 de qualquer endereço Ethereum, proporcionando suporte de dados confiável para análises de ativos, monitoramento de transações, cálculos fiscais e outros cenários de aplicação. Escolher as ferramentas mais adequadas de acordo com as necessidades específicas e preferências técnicas ajudará a melhorar a eficiência do desenvolvimento e a experiência do usuário.

Estas ferramentas não só facilitam a construção de aplicações pelos desenvolvedores, como também fornecem aos investidores uma importante transparência de ativos, ajudando-os a compreender melhor a distribuição de ativos no mundo do Blockchain. Quer seja para fins de pesquisa ou para necessidades de aplicação prática, dominar a utilização destas APIs irá adicionar uma conveniência à sua jornada no Blockchain.