公開帳本
linkex.ai Open Tally 帳本對外可達的實時介面——八個端點,無需帳號。
驗證方需要從運營方取得的一切,都由生產閘道公開提供。不需要帳號、不需要 API key。錯誤自我解釋:4XX 響應體會點名該改哪個參數,而不是回一句不透明的「internal error」。
| 端點 | 給出 |
|---|---|
/api/receipt/commitments | 已簽名的期間承諾帳本(include_tokens=1 附 RFC 3161 令牌) |
/api/receipt/keys | 按序號區間界定的簽名密鑰歷史 |
/api/receipt/bundle | 單條回執證據包(stream、seq) |
/api/receipt/period | 帶確定性抽樣回執的期間證明(stream、sample,可選 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。