API 集成

针对不同特定版本的 ElectrumX API 服务的集成说明。

v1.5.0

v1.5.0 版本增加了自定义染色和部分染色的功能。

Release (BETA) Atomicals ElectrumX Node v1.5.0, patch 1 · atomicals/atomicals-electrumxGitHub

这些功能同时也带来了破坏性改动，在读取 Atomicals 资产时需要进行适配。

在读取 blockchain.atomicals.listscripthash 这样的列表接口结果时，response.utxos.atomicals 的结构发生了变化。

之前

该字段是 UTXO 包含的 Atomical ID 的字符串列表。

{
  "atomicals": [
    "9025f03bcf9325f6071761b9aee00b462a0b43ed157c336e2e89e07f47ea6f66i0"
  ],
  "height": 847000,
  "index": 0,
  "txid": "b3ab9bf07db9075c1bbdef5638aef4941564a8afa3e0399ea4127285796b9ac1",
  "value": 546,
  "vout": 0
}

现在

该字段是 UTXO 包含的 Atomicals 资产的 ID 及其资产数量的字典。

{
  "atomicals": {
    "9025f03bcf9325f6071761b9aee00b462a0b43ed157c336e2e89e07f47ea6f66i0": 546
  },
  "height": 847000,
  "index": 0,
  "txid": "b3ab9bf07db9075c1bbdef5638aef4941564a8afa3e0399ea4127285796b9ac1",
  "value": 546,
  "vout": 0
}

现在的 Atomicals 资产数量并不一定等于 UTXO 的含聪量，开发者需要适配该结构获取正确的资产数量。