Como Obter Dados de Carteiras na Solana

#wallet #data #solana

Os dados de carteira Web3 são um dos principais requisitos para vários projetos construídos na Solana. Neste artigo, veremos como podemos efetivamente acessar dados das carteiras na Solana usando as APIs SHYFT.

As moedas criptográficas têm se tornado cada vez mais populares, com o crescimento de sua tecnologia de base - as blockchains. Uma carteira criptográfica é um aplicativo que funciona como uma carteira normal, exceto por ser usada para armazenar moedas criptográficas fungíveis e Tokens Não Fungíveis. É um ponto de acesso para suas moedas criptográficas e possui as chaves de acesso para assinar transações criptográficas digitais.

As modernas carteiras Crypto tornam as blockchains acessíveis a todos e muitos dApps requerem que os dados das carteiras sejam lidos e processados de forma eficiente. Para recuperar dados sobre uma carteira na Solana, você precisará usar uma ferramenta ou biblioteca que seja capaz de se comunicar com a blockchain e de recuperar os dados. Várias bibliotecas e ferramentas podem ser usadas para recuperar dados de uma carteira na Solana, incluindo a Solana CLI (interface de linha de comando) e a biblioteca Solana web3.js.

É fundamental notar que a Web3 lhe concede custódia e controle sobre seus bens, o que também significa estar ciente das questões de segurança. Dois aspectos confidenciais de qualquer carteira da Web3 são a chave privada da carteira e a frase semente, que, se comprometidas podem levar à perda de ativos. Portanto, precisamos de uma solução suficientemente simples para ser usada ou integrada facilmente nos dApps, juntamente com um acesso seguro aos dados da carteira. Aqui é onde a SHYFT entra. A SHYFT oferece uma solução baseada em API para várias operações na Solana, incluindo APIs para obter dados de carteira de forma segura. Neste artigo, vamos ver como podemos obter dados de carteira da Solana usando as APIs SHYFT.

Leia a Documentação da API SHYFT aqui.

Sumário

1 . Antes de Iniciar

2 . Obtendo o Portfólio de Carteiras

3 . Obtendo o Histórico de Transação de uma carteira

4 . O Kit para Desenvolvimento de Software

4 . Fontes

Antes de Iniciar

Para começar, precisamos de algumas coisas.

Autenticação: Obtendo sua chave API Shyft

x-api-key é um parâmetro de autenticação, que lhe dá acesso às APIs SHYFT. Você pode obter sua própria chave API a partir do site da SHYFT. Basta se inscrever com seu e-mail aqui e você pode obtê-la gratuitamente.

Carteira Phantom

Vamos precisar da extensão do navegador de carteiras Phantom, que você pode baixar do link abaixo.

Chrome/Brave.

Firefox.

Uma vez concluído, crie sua conta de carteira Phantom. Dicas na tela estão disponíveis, que o guiarão durante a configuração e o início do processo. Você também pode encontrar um guia detalhado relacionado a isto aqui.

Obtendo o Portfólio de Carteiras

SHYFT fornece uma API para a obtenção de todo o portfólio de carteiras, tanto os dados de Tokens Fungíveis quanto os Não Fungíveis em uma única solicitação. O Endpoint API para obter o portfólio de carteiras:

GET <https://api.shyft.to/sol/v1/wallet/get_portfolio?network=devnet&wallet=YOUR_WALLET_ADDRESS>

Essa API aceita o parâmetro x-api-key no cabeçalho, que é um parâmetro de autorização usado pela SHYFT para validação de seus usuários. Você pode obter sua própria x-api-key pelo site da SHYFT gratuitamente aqui.

Parâmetros necessários para esta solicitação de API

network: Selecione o cluster da rede Solana, que pode ser tanto devnet, testnet ou mainnet-beta. Os Tokens e NFTs que existem nessa rede serão procurados.
wallet: Aceita o endereço da carteira cujos dados estão sendo procurados.

O endereço da wallet e os parâmetros da network podem ser considerados input do usuário usando um formulário simples no front end ou podem ser definidas diretamente no back end, conforme a necessidade.

Formulário HTML para aceitar endereço de carteira e rede

Uma vez que a solicitação API é executada com sucesso, a resposta retornada se parece um pouco com isto.

{
 "success": true,
 "message": "Portfolio fetched successfully",
 "result": {
   "sol_balance": 1.87873304,
   "num_tokens": 2,
   "tokens": [
     {
       "address": "4TLk2jocJupKsZubcMFCqsEFFu5jVGzTp14kAANDaEFv",
       "balance": 500000
     },
     {
       "address": "7yPeRofJpfEyjLJ8CLB7czuk4sKG9toXWVq8CcHr4DcU",
       "balance": 310.000001
     }
   ],
   "num_nfts": 3,
   "nfts": [
     {
       "key": 4,
       "updateAuthority": "BvzKvn6nUUAYtKu2pH3h5SbUkUNcRPQawg4bURBiojJx",
       "mint": "ApJPjFr585xKSMk7EtAKU4UrcpyEgdN7X8trvd3gChYk",
       "data": {
         "name": "Nightweaver",
         "symbol": "NW",
         "uri": "<https://nftstorage.link/ipfs/aafkreidwzqo2fjyas32s2bhsvjo7fyi42yidtg5hpzetlsrij66eq3xblm>",
         "sellerFeeBasisPoints": 0,
         "creators": [
           {
             "address": "BvzKvn6nUUAYtKu2pH3h5SbUkUNcRPQawg4bURBiojJx",
             "verified": 1,
             "share": 100
           }
         ]
       },
       "primarySaleHappened": 0,
       "isMutable": 1
     },
     {
       "key": 4,
       "updateAuthority": "BvzKvn6nUUAYtKu2pH3h5SbUkUNcRPQawg4bURBiojJx",
       "mint": "9XTGWZENKa18N1vgCQ3RjJWHG92Di2JKYi73jiC4hkEM",
       "data": {
         "name": "SHYFT",
         "symbol": "SHF",
         "uri": "<https://nftstorage.link/ipfs/cyfkruh2askugb2wgbl2qkpfzd6bn34zkzjswfeo3esichllkn2m7fpffs4hy>",
         "sellerFeeBasisPoints": 5,
         "creators": [
           {
             "address": "BvzKvn6nUUAYtKu2pH3h5SbUkUNcRPQawg4bURBiojJx",
             "verified": 1,
             "share": 100
           }
         ]
       },
       "primarySaleHappened": 0,
       "isMutable": 1
     }
   ]
 }
}

A resposta da API contém o sol_balance da carteira, um array de tokens SPL na carteira, indicados pelo array de tokens e os NFTs na carteira, indicados pelo array nfts. Esses dados de carteira podem ser utilizados em qualquer dApp, incluindo os que tentam mostrar o Portfólio Web3 de um usuário, verificando os dados da carteira de um usuário para conceder alguma forma de acesso aos portais e muito mais.

Apresentação dos Dados da Carteira recebido em resposta

Obtendo o Histórico de Transação de uma carteira

A maioria dos dApps que mostram os dados da carteira também têm dispositivos para mostrar as transações relativas à carteira. Também podemos buscar dados de transações paginadas da carteira, usando as APIs SHYFT. O endpoint da API:

GET <https://api.shyft.to/sol/v1/wallet/transaction_history>

Para saber mais detalhes sobre dados de transações, consulte nosso artigo sobre como obter transações paginadas na Solana usando as APIs SHYFT. Você também pode encontrar os detalhes dos parâmetros para solicitação de API em nossos documentos de desenvolvimento aqui.

O Kit para Desenvolvimento de Software

Junto com as extensas APIs Web3 da SHYFT, a SHYFT também lançou um novíssimo SDK para a blockchain Solana. Com este SDK, você pode realizar várias operações na Solana, como obter detalhes do NFT por endereço de cunhagem ou por proprietários, obter saldo de carteira, portfólio e muito mais. Aqui está uma prévia de como você pode obter um portfólio de carteiras usando o novíssimo SDK SHYFT.

Instalação e inicialização

Para instalar o SDK SHYFT com npm, use o seguinte comando:

npm install @shyft-to/js

Você pode importá-lo para o projeto usando

import { ShyftSdk, Network } from '@shyft-to/js';

Obtendo dados da carteira usando SDK

Para obter dados da carteira,

const shyft = new ShyftSdk({ apiKey: 'YOUR_API_KEY', network: Network.Devnet }); //initialização
(async () => {
 const portfolio = await shyft.wallet.getPortfolio({
     wallet:WALLET_ADDRESS, //Seu endereço de carteira
     network:Network.Devnet  // Selecione a estrutura da rede
   })
 console.log(portfolio); //o portifólio conterá todos os dados exigidos da carteira
})();

Resumindo, tanto as APIs SHYFT quanto o SDK SHYFT são maneiras de buscar dados de carteiras de forma segura e sem complicações. Se você gosta de construir com a SHYFT, sinta-se à vontade para conferir nossos outros artigos sobre Criar uma Candy Machine (v3) na Solana ou sobre Airdropping de tokens na Solana.

Esperamos que você tenha uma grande jornada de desenvolvimento web3 com a SHYFT!

Esse artigo foi escrito pelo Team Shyft e traduzido por Fátima Lima. O original pode ser lido aqui.