跳转到主要内容

概述

数字资产标准(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:
DAS 方法以命名对象("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。可以用它判断响应数据的新鲜程度。

错误

后续步骤

资产对象

资产响应可能包含的所有字段。

分页

使用页码、游标或范围浏览大型结果集。