API взаимозаменяемых токенов Solana: полный доступ к данным токенов

Обзор

Изначально DAS API поддерживал только запросы о владении NFT и cNFT Metaplex. Helius расширил DAS API, добавив поддержку всех токенов, включая обычные токены SPL (без метаданных) и Token-2022 (вместе с их расширениями). Вы можете запрашивать балансы токенов любого аккаунта по всем токенам (SPL, Token-2022, NFT и сжатым NFT), включая цены токенов в USD. Токен Solana определяется его аккаунтом минта. Например, аккаунт минта USDC — EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v. Когда вы покупаете USDC на сумму $40, создается токен-аккаунт, в котором хранятся 40 токенов USDC. Кошелек может содержать сотни токен-аккаунтов для разных токенов. Подробнее о Token-2022 читайте в статье блога Helius.

Когда использовать

Используйте расширение взаимозаменяемых токенов, если вам нужно получить единое представление активов аккаунта — взаимозаменяемых токенов, NFT и сжатых NFT — одним вызовом DAS вместе с метаданными и ценами в USD. Это подходящий вариант для трекеров портфелей, кошельков и панелей мониторинга токенов. Используйте стандартные методы RPC для токенов (getTokenAccountBalance, getTokenAccountsByOwner, getTokenSupply, getTokenLargestAccounts), если вам нужны только необработанные ончейн-значения — баланс отдельного аккаунта, общее предложение или крупнейшие держатели — без метаданных и цен. Подробнее см. в руководстве по получению токенов SPL.

Как это работает

Расширение Helius для взаимозаменяемых токенов основано на индексировании владения. Следующие методы предоставляют единое представление активов аккаунта: getAsset, getAssetsByOwner и searchAssets. Расширение добавляет дополнительное поле tokenType, которое позволяет запрашивать все принадлежащие аккаунту активы, включая взаимозаменяемые токены и токены Token-2022. Доступные значения tokenType:

fungible: Возвращает все взаимозаменяемые токены.
nonFungible: Возвращает все NFT (сжатые и обычные).
regularNft: Возвращает только обычные NFT.
compressedNft: Возвращает только сжатые NFT.
all: Возвращает все токены.

Пример запроса:

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

Теперь ответ включает взаимозаменяемые токены, такие как JitoSOL. Каждый элемент содержит общий баланс аккаунта, адрес программы токена, адрес связанного токен-аккаунта, общий объем предложения в обращении и сведения о цене. В сокращенном элементе ниже показаны соответствующие поля:

{
    "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"
        }
    }
    // ...
}

Поддержка Token-2022

Helius поддерживает токены Token-2022 и обрабатывает их расширения. Если токен использует программу Token-2022, ответ включает поле mint_extensions. В сокращенном элементе ниже показано поле mint_extensions для 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"
        }
    }
    // ...
}

Обратная совместимость

Для обеспечения обратной совместимости при отсутствии tokenType поведение идентично исходному DAS: возвращаются только NFT и сжатые NFT.

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

Следующие шаги

Get SPL Tokens

Балансы, предложение, держатели и токен-аккаунты.

Search Assets

Фильтрация по tokenType, владельцу и коллекции.

searchAssets reference

Полные схемы запроса и ответа.

Начало работы

Потоковая передача данных и отслеживание событий

API данных и RPC

Торговля

Отправка транзакций

Кошелек как услуга

Конфиденциальность

Ресурсы

API взаимозаменяемых токенов Solana: полный доступ к данным токенов

Обзор

Когда использовать

Как это работает

Поддержка Token-2022

Обратная совместимость

Следующие шаги

Get SPL Tokens

Search Assets

searchAssets reference

​Обзор

​Когда использовать

​Как это работает

​Поддержка Token-2022

​Обратная совместимость

​Следующие шаги

Get SPL Tokens

Search Assets

searchAssets reference

Обзор

Когда использовать

Как это работает

Поддержка Token-2022

Обратная совместимость

Следующие шаги