概述
数字资产标准(DAS)API 是读取 Solana 资产的统一接口。一组 JSON-RPC 方法即可覆盖所有资产类型,因此你无需自己解码 Token Metadata 账户、重放 Bubblegum 交易或合并代币账户。 DAS API 索引以下内容:- NFT 和可编程 NFT(Metaplex Token Metadata)
- 压缩 NFT(Bubblegum v1 和 v2),包括 Merkle 证明
- MPL Core 资产和合集
- 同质化代币(SPL Token 和 Token-2022),在可用时附带美元价格
- 主版本 NFT 的可打印版本
- Token-2022 扩展和代币铭文
端点
DAS 方法与标准 Solana RPC 使用同一个端点。将请求连同你的 API key 发送到你的 OrbitFlare RPC URL:"params": { ... })而非位置数组的形式接收参数。
有关如何创建 API key 并在请求中传递它,请参阅身份验证。
方法
资产
getAsset
按 ID 获取单个资产。
getAssetBatch
在一次调用中按 ID 获取最多 1,000 个资产。
getAssetsByOwner
列出某个钱包拥有的资产。
getAssetsByGroup
列出某个合集中的资产。
getAssetsByCreator
列出由某个地址创建的资产。
getAssetsByAuthority
列出由某个更新权限控制的资产。
searchAssets
按所有者、创作者、合集、接口等条件搜索资产。
压缩 NFT
getAssetProof
获取压缩资产的 Merkle 证明。
getAssetProofBatch
获取多个压缩资产的 Merkle 证明。
getAssetWithProof
在一次调用中获取压缩资产及其证明。
getSignaturesForAsset
列出涉及某个压缩资产的交易。
代币和版本
getTokenAccounts
按所有者或按 mint 列出代币账户。
getNftEditions
列出某个主版本 NFT 的已打印版本。
兼容性
DAS API 采用标准的 DAS 方法名称、参数和响应结构。如果你已经在使用其他服务商的 DAS API,只需将客户端指向你的 OrbitFlare 端点,其余代码保持不变。- 批量方法同时响应两个名称:
getAssetBatch和getAssets,getAssetProofBatch和getAssetProofs。 getSignaturesForAsset也可以通过getAssetSignatures调用。- 大多数方法也接受 snake_case 名称,例如
get_asset或get_assets_by_owner。例外是getAssetsByAuthority和getSignaturesForAsset。 getTokenAccounts和getNftEditions既接受owner和mint,也接受ownerAddress和mintAddress。- 显示选项可以通过
options或displayOptions发送。
目前尚不支持
requireFullIndex: true。设置了该选项的请求会以 -32602 被拒绝,而不是在没有该保证的情况下返回结果。请参阅显示选项。响应
- 单资产方法返回一个资产对象。
- 列表方法返回一页资产对象,附带
total、limit、页码或游标标记,以及last_indexed_slot。请参阅分页。 last_indexed_slot是索引已处理的最新 slot。可以用它判断响应数据的新鲜程度。
错误
后续步骤
资产对象
资产响应可能包含的所有字段。
分页
使用页码、游标或范围浏览大型结果集。