递归

沙盒化的一个重要例外是递归：访问“ord”的“/content”允许端点，允许铭文访问其他端点的内容通过请求 /content/<INSCRIPTION_ID> 来获取铭文。

由于对递归端点的更改可能会破坏依赖它们的铭文，递归端点具有向后兼容性保证，这是ord server的其他端点所不具备的。具体来说：

递归端点将不会被移除。
Object fields returned by recursive endpoints will not be renamed or change types

递归端点返回的对象字段将不会被重命名或更改类型。

这有许多有趣的用例：

重新混合现有铭文的内容。
将代码、图像、音频或样式表片段发布为公共的共享资源。
生成艺术收藏，其中算法使用JavaScript刻写，并从具有独特种子的多个铭文中实例化。
生成个人资料图片集，其中包含配件和属性刻录为单独的图像，或刻录在共享纹理图集中，然后组合，拼贴风格，在多个铭文中以独特的组合。

The inscription id at <INDEX> of all inscriptions on a sat. <INDEX> may be a negative number to index from the back. 0 being the first and -1 being the most recent for example. Requires index with --index-sats flag.

示例

curl -s \
  http://0.0.0.0:80/r/sat/153899938226999/at/-1

{
  "id": "488c32e4dfcdc0fa376c2c2af2d572a12f4d33d3245689d1a9f74167f1e14678i0"
}

GET /r/sat/<SAT_NUMBER>/at/<INDEX>/content

Description

The content of the inscription at <INDEX> on a sat. <INDEX> may be a negative number to index from the back. 0 being the first and -1 being the most recent. Requires index with --index-sats flag.

示例

Fetch the content of the most recently created inscription on sat 289488340427831.

curl -s \
  http://0.0.0.0:80/r/sat/289488340427831/at/-1/content

Hello, world!

GET /r/tx/<TRANSACTION_ID>

Description

Get hex-encoded transaction with <TRANSACTION_ID>. In the event of a future change to Bitcoin that changes transaction serialization in a backwards-incompatible fashion, such as SegWit, this endpoint is guaranteed to remain backwards compatible.

示例

curl -s http://0.0.0.0:80/r/tx/60bcf821240064a9c55225c4f01711b0ebbcab39aa3fafeefe4299ab158536fa

"0100000000010183572872dcb32bee57003d53c2b8dbb5bc5819ff6478052599911f7778d1c7bd0000000000fdffffff011027000000000000225120e41e0cba05c6ac797cf543ff9a6c619a91a53813e59146d1e32ea89747b111a603407aa50d93d6fc01265fd52d3edc93af4e009ccc1a704ce1b5cb8ede1412a5df31eba587d080b3dc903ceb9002ed9d921aad323fd44d7b4dc2a1ad2ea12d4360424d20c7a3a38df198a4fcde7d5dac5819ed19ff4d25bb893c9511f8e1f51d59326effac0063036f7264010118746578742f706c61696e3b636861727365743d7574662d3800077072696d65730a6821c1c7a3a38df198a4fcde7d5dac5819ed19ff4d25bb893c9511f8e1f51d59326eff00000000"

GET /r/utxo/<OUTPOINT>

Description

Get assets held by an unspent transaction output.

示例

Unspent transaction output with server without any indices:

curl -s \
  http://0.0.0.0:80/r/utxo/4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b:0

{
  "inscriptions": null,
  "runes": null,
  "sat_ranges": null,
  "value": 5000000000
}

With rune, inscription, and sat index:

curl -s \
  http://0.0.0.0:80/r/utxo/626860df36c1047194866c6812f04c15ab84f3690e7cc06fd600c841f1943e05:0

{
  "inscriptions": [
    "6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0"
  ],
  "runes": {
    "UNCOMMON•GOODS": {
      "amount": 6845,
      "divisibility": 0,
      "symbol": "⧉"
    }
  },
  "sat_ranges": [
    [
      1905800627509113,
      1905800627509443
    ]
  ],
  "value": 330
}

注意： <SAT_NUMBER> 仅允许使用sat的实际数字，不允许使用度数、百分位数或小数等其他sat表示法。我们可能会在将来考虑支持这些表示法。

Responses from most of the above recursive endpoints are JSON. For backwards compatibility, some endpoints are supported which only return plain-text responses.

/blockheight：最新区块高度。
/blockhash：最新的块哈希。
/blockhash/<HEIGHT>：给定块高度的块哈希。
/blocktime：最新块的 UNIX 时间戳。

See examples for on-chain examples of inscriptions that feature this functionality.

Ordinal Theory Handbook