linkex.cclinkex.cc
linkex.ai 實例

公開帳本

linkex.ai Open Tally 帳本對外可達的實時介面——八個端點,無需帳號。

驗證方需要從運營方取得的一切,都由生產閘道公開提供。不需要帳號、不需要 API key。錯誤自我解釋:4XX 響應體會點名該改哪個參數,而不是回一句不透明的「internal error」。

端點給出
/api/receipt/commitments已簽名的期間承諾帳本(include_tokens=1 附 RFC 3161 令牌)
/api/receipt/keys按序號區間界定的簽名密鑰歷史
/api/receipt/bundle單條回執證據包(streamseq
/api/receipt/period帶確定性抽樣回執的期間證明(streamsample,可選 first_seq/last_seq
/api/receipt/commitment-blocks停擺的流及原因——只顯示成功的帳本會讓停擺與安靜看起來一樣
/api/anchor/transparency鏈上錨定帳本(include_entries=1 披露各窗口條目列表)
/api/anchor/stats匯總,含 earliest_window_start_ms——鏈上覆蓋自何時開始
/api/anchor/spec錨定規範原文(?version= 取歷史版本)——取哈希即可復現上鏈的 spec_hash
/api/anchor/page人讀的透明頁,頁腳含完整自核流程

GET /api/receipt/keys

簽名密鑰歷史:每條流的 Ed25519 公鑰,帶半開有效區間(from_seq / until_seq)與退役原因。

curl -s https://linkex.ai/api/receipt/keys
{
  "data": {
    "issuer": "linkex.ai",
    "records": [
      {
        "key_id": "ed25519:3d1aa5da8d32…",
        "stream": "ch:3",
        "public_key": "JgbnqHcMguWJ5O9/cs4uUmJo757gPT3f+YHlObW9zw0=",
        "from_seq": "1",
        "until_seq": "",
        "retired_reason": ""
      }
    ]
  }
}

檢查 1(簽名有效性)對照的是這份公布的歷史——由「對該流該序號區間無效」的密鑰簽出的簽名會失敗,即使簽名本身在數學上成立。key_id 是旁邊那把公鑰的可復算指紋,歷史無法指名一把、公布另一把。

GET /api/receipt/commitments

已簽名的期間承諾鏈——帳本的公開脊柱,以規範化形式提供(被哈希的正是這個對象,十進制字串照舊):

curl -s 'https://linkex.ai/api/receipt/commitments?page_size=1'
{
  "data": [
    {
      "commitment": {
        "spec": "linkex.period-commitment",
        "spec_version": "1",
        "issuer": "linkex.ai",
        "stream": "ch:10",
        "from_ms": "1788570074617",
        "until_ms": "1788570434593",
        "first_seq": "1",
        "last_seq": "5",
        "count": "5",
        "root": "sha256:4c165425c120…",
        "prev_commitment_hash": "sha256:0000…",
        "key_id": "ed25519:3d1aa5da8d32…"
      },
      "hash": "sha256:6572a1f3124a…",
      "signature": "ihHjOrnLjfQ9…",
      "tsa_status": "obtained",
      "tsa_time_ms": 1788652559000,
      "tsa_authority": "CN=DigiCert SHA256 RSA4096 Timestamp Responder…",
      "tsa_url": "http://timestamp.digicert.com"
    }
  ],
  "total": 192
}

協議不變式就在載荷裡可見:數值以字串承載、first_seq/last_seq/count 固定窗口範圍、prev_commitment_hash 把期間連成鏈、整個對象被簽名——且每份承諾把自己的時間戳令牌狀態擺在明處。

GET /api/receipt/bundle/api/receipt/period

兩個證明端點。bundle 返回離線驗證一張回執所需的一切(回執連前後鄰、密鑰歷史、所屬承諾、Merkle 證明);period 返回承諾鏈證明外加按公布抽籤規則抽出的回執——種子就在響應裡,抽籤可復算。完整流程見驗證指南

GET /api/receipt/commitment-blocks

誠實端點:當前承諾構建被阻塞的流,及原因。一個只展示成功的透明介面,會讓停擺的渠道與安靜的渠道無從區分——所以停擺也公布。空列表意味著沒有任何停擺。

/api/anchor/*——鏈上那一段

一條真實記錄,來自 /api/anchor/transparency

{
  "window_start_ms": 1788930000000,
  "window_end_ms": 1788933600000,
  "row_count": 7,
  "data_root": "26770aa06c76624a…",
  "spec_version": "v2",
  "spec_hash": "3103baf64bd4c8af…",
  "prev_anchor_hash": "a422fdfce7d771ac…",
  "payload_hash": "615d2cad73879b8f…",
  "status": "confirmed",
  "chain_network": "eip155:8453",
  "tx_hash": "0xddecf7390d3cebdefd62f9bf6216424c4eeb50de4e0f297864032ef126c9d34c",
  "block_number": 51072548
}

每個字段都可查驗:折疊該窗口的條目(加 include_entries=1)復現 data_root;對 /api/anchor/spec 取哈希復現 spec_hash;重建載荷復現 payload_hash;在任意 Base 瀏覽器打開 tx_hash 比對 32 字節 calldata;並確認 prev_anchor_hash 連到上一個窗口——任何窗口都無法悄悄消失。錨定頁完整走這五步。

/api/anchor/stats 報告匯總與 earliest_window_start_ms——在該時刻之前簽發的承諾有 RFC 3161 時間戳、但早於鏈上覆蓋,是一條寫明的邊界

機器可讀文檔

與主文檔站一樣,本站每一頁都有原始 Markdown 形式——索引見 /llms.txt,全文見 /llms-full.txt

本頁內容