Solana Fungible Token API: Acesso Completo aos Dados de Tokens

Visão Geral

Inicialmente, o DAS API apenas suportava consultas de propriedade contra Metaplex NFTs e cNFTs. Helius estendeu o DAS API para suportar todos os tokens, incluindo tokens SPL simples (sem metadados) e Token-2022 (mais suas extensões). Você pode consultar os saldos de tokens de qualquer conta em todos os tokens (SPL, Token-2022, NFTs e NFTs comprimidos), com preços de tokens em USD incluídos. Um token Solana é definido por sua conta de mint. Por exemplo, a conta de mint para USDC é EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Quando você compra $40 de USDC, uma conta de token é criada que contém 40 tokens USDC. Uma carteira pode conter centenas de contas de token para diferentes tokens. Para saber mais sobre Token-2022, veja o post no blog da Helius.

Quando usar isto

Use a extensão de token fungível quando quiser uma visão unificada dos ativos de uma conta — tokens fungíveis, NFTs e NFTs comprimidos — em uma chamada DAS, com metadados e preços em USD. É a escolha certa para rastreadores de portfólio, carteiras e dashboards de tokens. Utilize os métodos padrão de token RPC (getTokenAccountBalance, getTokenAccountsByOwner, getTokenSupply, getTokenLargestAccounts) quando você só precisar de valores brutos on-chain — saldo de uma única conta, fornecimento total ou maiores detentores — sem metadados ou preços. Veja o Guia de Obtenção de Tokens SPL para isso.

Como funciona

A extensão de tokens fungíveis da Helius gira em torno da indexação de propriedade. Os seguintes métodos fornecem uma visão unificada dos ativos de uma conta: getAsset, getAssetsByOwner e searchAssets. A extensão adiciona um campo extra chamado tokenType, que permite consultas contra todos os ativos que a conta possui, incluindo tokens fungíveis e Token-2022. As opções para tokenType são:

fungible: Retorna todos os tokens fungíveis.
nonFungible: Retorna todos os NFTs (NFTs comprimidos e regulares).
regularNft: Retorna apenas os NFTs regulares.
compressedNft: Retorna apenas os NFTs comprimidos.
all: Retorna todos os tokens.

Exemplo de solicitação:

{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze",
        "tokenType": "all"
    }
}

A resposta agora inclui tokens fungíveis como JitoSOL. Cada item contém o saldo total da conta, o endereço do programa do token, o endereço associado ao token, o fornecimento total em circulação e as informações de preço. O item reduzido abaixo mostra os campos relevantes:

{
    "id": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
    "content": {
        "$schema": "",
        "json_uri": "",
        "metadata": {
            "description": "MEV-Powered Liquid Staking Derivative",
            "name": "Jito Staked SOL",
            "symbol": "JitoSOL",
            "token_standard": "Fungible"
        }
        // ...
    },
    "token_info": {
        "symbol": "JitoSOL",
        "balance": 35688813508,
        "supply": 5949594702758293,
        "decimals": 9,
        "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        "associated_token_address": "H7iLu4DPFpzEx1AGN8BCN7Qg966YFndt781p6ukhgki9",
        "price_info": {
            "price_per_token": 56.47943,
            "total_price": 2015.6838854339217,
            "currency": "USDC"
        }
    }
    // ...
}

Suporte ao Token-2022

Helius suporta tokens Token-2022 e analisa suas extensões. A resposta inclui o campo mint_extensions se o token utilizar o programa Token-2022. O item reduzido abaixo mostra o campo mint_extensions para BERN:

{
    "mint_extensions": {
        "transfer_fee_config": {
            "withheld_amount": 0,
            "newer_transfer_fee": {
                "epoch": 457,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 690
            },
            "older_transfer_fee": {
                "epoch": 455,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 0
            },
            "withdraw_withheld_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD",
            "transfer_fee_config_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD"
        }
    }
    // ...
}

Compatibilidade retroativa

Para compatibilidade retroativa, o comportamento é idêntico ao original DAS quando tokenType é omitido: apenas NFTs e NFTs comprimidos são retornados.

{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze"
    }
}

Próximos passos

Obter Tokens SPL

Saldos, fornecimento, detentores, e contas de token.

Pesquisar Ativos

Filtrar por tipo de token, proprietário e coleção.

Referência searchAssets

Esquemas completos de pedido e resposta.

Primeiros Passos

Transmissão de Dados e Audição de Eventos

APIs de Dados & RPCs

Negociação

Enviando Transações

Carteira como Serviço

Privacidade

Recursos

Solana Fungible Token API: Acesso Completo aos Dados de Tokens

Visão Geral

Quando usar isto

Como funciona

Suporte ao Token-2022

Compatibilidade retroativa

Próximos passos

Obter Tokens SPL

Pesquisar Ativos

Referência searchAssets

​Visão Geral

​Quando usar isto

​Como funciona

​Suporte ao Token-2022

​Compatibilidade retroativa

​Próximos passos

Obter Tokens SPL

Pesquisar Ativos

Referência searchAssets

Visão Geral

Quando usar isto

Como funciona

Suporte ao Token-2022

Compatibilidade retroativa

Próximos passos