DAS API란 무엇인가요?
디지털 자산 표준(DAS) API는 Solana의 모든 유형의 디지털 자산에 대한 하나의 통합 인터페이스를 제공하는 오픈 소스 명세입니다:- 일반 NFT (Non-Fungible Tokens)
- 압축 NFT (cNFT, 상태 압축 사용)
- 대체 가능 토큰 (SPL 토큰 및 토큰-2022, 확장 포함)
- 메인넷:
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY - Devnet:
https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
DAS API에 Helius를 사용하는 이유는?
모든 자산 유형, 하나의 API
하나의 인터페이스를 통해 NFT, 압축 NFT 및 대체 가능 토큰 (SPL 및 토큰-2022).
완전한 메타데이터
온체인 및 오프체인 데이터 (Arweave, IPFS)가 함께 인덱싱되어 한 번의 호출로 반환됩니다.
가격 데이터 포함
확인된 토큰의 USD 가격 정보가 잔액과 함께 반환됩니다.
검색 및 필터링
소유자, 컬렉션, 생성자, 권한 또는 풍부한 속성 필터를 기준으로 쿼리합니다.
어떤 메서드를 사용해야 하나요?
대부분의 통합은 세 가지 메서드 중 하나로 시작됩니다. 이 표를 사용하여 적절한 시작점을 선택한 다음, 아래의 전문화된 메서드를 사용하세요.
기본 규칙:
- 정확한 자산 ID를 알고 있나요?
getAsset사용 (또는 여러 개의 경우getAssetBatch사용). - 지갑의 보유 자산을 나열하고 있나요?
getAssetsByOwner사용. - 컬렉션, 토큰 유형, 또는 속성으로 필터링하나요?
searchAssets사용.
주요 메서드
단일 자산
getAsset
ID로 하나의 자산에 대한 전체 데이터.
getAssetBatch
한 번의 요청으로 최대 1,000개 자산.
소유자, 컬렉션 또는 생성자별 자산
getAssetsByOwner
지갑이 보유한 모든 자산, 메타데이터 및 잔액과 함께.
getAssetsByGroup
컬렉션의 모든 자산 (그룹 키
collection).getAssetsByCreator
특정 생성자가 발행한 모든 자산.
getAssetsByAuthority
주어진 권한에 의해 제어되는 모든 자산.
검색
searchAssets
소유자, 컬렉션,
tokenType 및 속성으로 유연하게 필터링.압축 자산 및 증명
getAssetProof
온체인 작업에 필요한 압축 자산에 대한 머클 증명.
getAssetProofBatch
여러 압축 자산에 대한 머클 증명을 한 번에.
getSignaturesForAsset
자산에 대한 거래 서명 기록.
getNftEditions
마스터 NFT에서 인쇄된 모든 에디션.
토큰 계정
getTokenAccounts
잔액과 함께 조폐 또는 소유자별 토큰 계정.
시작하기
자산 가져오기 (NFTs)
단일 자산, 소유자별, 컬렉션별, 증명 및 에디션을 통해 NFT 및 디지털 수집품을 가져옵니다.
SPL 토큰 가져오기
대체 가능 토큰 쿼리: 잔액, 공급량, 보유자 및 토큰 계정.
자산 검색
소유자, 컬렉션, 토큰 유형 및 속성별로 자산을 필터링합니다.
페이지네이션
대규모 결과 집합에 대한 페이지 기반 및 키셋 페이지네이션.
특수 자산 유형 작업하기
대체 가능 토큰
Helius는 DAS API를 확장하여 메타데이터가 없는 일반 SPL 토큰 및 토큰-2022 (및 확장 포함) 등 모든 토큰을 다룹니다. 대체 가능 토큰 지원은getAsset, getAssetsByOwner 및 searchAssets에서 tokenType 매개변수를 사용하여 가능하며, 확인된 토큰 가격은 token_info.price_info에서 반환됩니다.
잔액, 공급량, 보유자 및 토큰 계정 쿼리에 대해서는 SPL 토큰 가져오기 안내서 및 대체 가능 토큰 확장을 참조하세요.
압축 NFT
상태 압축 NFT (cNFT)는 정규 NFT와 동일한 메서드를 사용하여 읽기를 수행합니다 (getAsset, getAssetsByOwner, searchAssets) 그 외에 두 가지 압축 전용 메서드가 추가됩니다:
getAssetProof는 전송 및 소각과 같은 온체인 작업을 확인하고 수행하는 데 필요한 머클 증명을 반환합니다.getSignaturesForAsset는 압축 자산에 대한 거래 내역을 반환합니다.
오프체인 데이터
대부분의 NFT 컬렉션은 추가 메타데이터(속성, 이미지)를 Arweave 또는 IPFS와 같은 오프체인에 저장합니다. DAS API는 이 오프체인 데이터를 인덱스하고 온체인 데이터와 함께 한 번의 호출로 반환합니다.Helius는 오프체인 데이터 변이를 감지할 수 없습니다. 오프체인 데이터는 자산이 온체인에서 다시 나타날 때만 다시 새로 고쳐집니다 (예: 수정될 때). 재색인을 요청하려면 Helius 지원에 문의하세요.
모범 사례
페이지네이션
페이지 1에서 시작합니다 (0이 아님). 100–1,000의 제한을 사용하고 대용량 데이터 세트에는 페이지네이션을 사용하십시오.
오류 처리
모든 응답에서 오류를 확인하고 지수 백오프로 재시도하세요.
성능
가능한 경우 배치 메서드를 사용하고, 응답을 캐시하며, 하나로 해결 가능한 호출을 체이닝하지 마세요.
보안
API 키를 클라이언트 측 코드에서 노출하지 마십시오. 서버를 통해 요청을 프록시하고 CORS 정책을 설정하십시오.
다음 단계
자산 가져오기 (NFTs)
NFT 및 디지털 수집품을 검색하고 쿼리합니다.
DAS API 참조
모든 DAS 메서드의 전체 요청 및 응답 스키마.
DAS API FAQ
자산, 가격 데이터, 사용에 대한 일반적인 질문.