PUBLIC READ-ONLY API

把鏈上證據,
接進你的產品。

一個固定範圍、無錢包、無簽名、無交易的 OP Mainnet 觀測端點。 四個固定來源中至少兩個完全一致才回傳 Tier A 數值。

GEThttps://montrevane.com/api/transparency
METHODSGET / HEADOPTIONS for CORS
QUORUMmin 2 of 4same finalized block
WRITESNone405 on mutation
PRICE DATANoneraw evidence only

01 · QUICKSTART

三種入口,
都先處理失敗狀態

cURL
curl --fail-with-body \
  --header "Accept: application/json" \
  https://montrevane.com/api/transparency
JavaScript
const response = await fetch("https://montrevane.com/api/transparency", {
  headers: { Accept: "application/json" },
});

const snapshot = await response.json();

if (response.ok && snapshot.state === "verified") {
  console.log(snapshot.blockNumber, snapshot.observations);
} else {
  // conflict / unavailable: do not substitute project-declared values
  console.warn(snapshot.error?.code, snapshot.state);
}
Zero-dependency SDK
// First download the published module into your project:
// curl --fail-with-body https://montrevane.com/sdk/mtvrn-transparency.mjs \
//   --output ./vendor/mtvrn-transparency.mjs
import { getTransparencySnapshot } from
  "./vendor/mtvrn-transparency.mjs";

const result = await getTransparencySnapshot();
if (result.ok) {
  console.log(result.snapshot.blockNumber, result.snapshot.observations);
} else {
  console.warn(result.status, result.state, result.error.message);
}

Download and vendor the published module before importing it. The static file URL is a distribution artifact, not a cross-origin CDN; the SDK then calls the CORS-enabled public API from your application.

整合方必須檢查 HTTP status、stateobservations。 只有 200 + verified + observations 可以顯示數值。

02 · RESPONSE STATES

無法驗證時,
回傳空值而不是猜測

200

verified · Tier A

至少兩個固定 RPC 在同一 finalized block 的 block hash 與全部觀測值完全一致。

409

conflict · Tier U

已有足夠回應,但沒有兩個來源形成相同證據;不得顯示鏈上數值。

503

unavailable · Tier U

不足兩個固定來源完成驗證;可稍後重試,但不得以預設值或舊值冒充。

400 / 405

request rejected

查詢參數與所有寫入方法都被拒絕;地址、RPC 與方法固定在伺服器端。

03 · SAFE USE CASES

適合證據整合,
不適合交易決策

適合

Treasury/pool 監控、研究報告、盡職調查介面、資料品質示範、OP 生態儀表板與獨立重現。

不適合

報價、交易路由、清算、估值、circulating supply 判定、投資招攬、安全保證或自動資產操作。

04 · DESIGN PARTNER PILOT

用一個真實案例,
驗證產品是否有用

這是非約束性的整合討論框架;不是 Optimism、Uniswap、Safe、交易所或參與專案的背書。

01

Treasury evidence

把固定 Safe、threshold、餘額與證據時間接入專案揭露頁。

02

Liquidity risk

呈現 pool、LP NFT owner、fee tier 與失敗狀態,不計算價格或投資評分。

03

Due-diligence export

以 JSON/OpenAPI 供研究或審查流程重現指定 finalized block 的原始證據。

04

Evidence feedback

公開可重現問題與修復;沒有使用者、整合或成果時就如實記為零。

不要求錢包、不以送幣換推薦、不虛構合作。任何公開案例都必須取得對方書面同意。

提出 design partner pilot

05 · MACHINE-READABLE

公開介面,
可自行驗證