Skip to main content

개요

초기에 DAS API는 Metaplex NFT 및 cNFT에 대한 소유 쿼리만 지원했습니다. Helius는 DAS API를 모든 토큰을 지원하도록 확장하여 메타데이터가 없는 일반 SPL 토큰과 Token-2022 (그리고 그 확장자 포함)를 포함합니다. 모든 계정의 모든 토큰(SPL, Token-2022, NFT 및 압축 NFT)에 대한 토큰 잔액을 쿼리할 수 있으며 USD로 된 토큰 가격도 포함됩니다. Solana 토큰은 민트 계정으로 정의됩니다. 예를 들어, USDC의 민트 계정은 EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v입니다. $40의 USDC를 구입하면 40 USDC 토큰을 보유한 토큰 계정이 생성됩니다. 지갑은 서로 다른 토큰에 대해 수백 개의 토큰 계정을 보유할 수 있습니다. Token-2022에 대한 자세한 내용은 Helius 블로그 게시물을 참조하세요.

사용 시기

펀저블 토큰 확장을 사용하여 하나의 DAS 호출로 계정의 자산 — 펀저블 토큰, NFT 및 압축 NFT — 에 대한 통합 보기를 원할 때 사용하세요. 메타데이터 및 USD 가격과 함께 포트폴리오 추적기, 지갑 및 토큰 대시보드에 적합합니다. 메타데이터나 가격 없이 원시 체인 값만 필요할 때는 표준 RPC 토큰 메소드를 사용하세요 (getTokenAccountBalance, getTokenAccountsByOwner, getTokenSupply, getTokenLargestAccounts). 그런 경우 Get SPL Tokens 안내서를 참조하세요.

작동 방식

헬리우스의 펀저블 토큰 확장은 소유권 인덱싱을 중심으로 이루어집니다. 다음 메소드는 계정의 자산에 대한 통합 보기를 제공합니다: getAsset, getAssetsByOwner, 및 searchAssets. 확장자는 계정이 소유한 모든 자산에 대해 쿼리할 수 있는 tokenType라는 추가 필드를 제공합니다. tokenType의 옵션은 다음과 같습니다:
  • fungible: 모든 펀저블 토큰을 반환합니다.
  • nonFungible: 모든 NFT(압축 및 일반 NFT)를 반환합니다.
  • regularNft: 일반 NFT만 반환합니다.
  • compressedNft: 압축 NFT만 반환합니다.
  • all: 모든 토큰을 반환합니다.
예제 요청:
응답에는 JitoSOL과 같은 펀저블 토큰이 포함됩니다. 각 항목에는 총 계정 잔액, 토큰의 프로그램 주소, 관련 토큰 주소, 유통 중인 총 공급량, 가격 정보가 포함됩니다. 아래의 수정된 항목은 관련 필드들을 보여줍니다:

Token-2022 지원

헬리우스는 Token-2022 토큰을 지원하고 그 확장을 파싱합니다. 응답에는 토큰이 Token-2022 프로그램을 사용하는 경우 mint_extensions 필드가 포함됩니다. 아래의 수정된 항목은 BERN에 대한 mint_extensions 필드를 보여줍니다:

역호환성

역호환성을 위해 tokenType가 생략된 경우 원래 DAS와 동일한 동작을 하며 NFT 및 압축 NFT만 반환됩니다.

다음 단계

SPL 토큰 가져오기

잔액, 공급량, 보유자 및 토큰 계정.

자산 검색

tokenType, 소유자, 컬렉션으로 필터링.

searchAssets 참조

전체 요청 및 응답 스키마.