協議

介面與狀態參考

詳細狀態定義、簽名規則與已發布 API 能力。

買一隻股票和持有一個指數，是兩種不同的產品

它們在持有什麼、誰托管、怎麼退出這三件事上不同。介面不會把兩者混為一談。

差異項	直接買入代幣進你的錢包	持有指數金庫份額
持有什麼	bStock 代幣本身，在它自己的合約地址上。	持有籃子的金庫所發行的 ERC-20 份額。
托管	你的錢包。成交之後我們不碰它。	非托管合約。沒有任何平台錢包持有用戶資產。
如何退出	在有路由時，原路賣回。	按比例實物贖回：你拿到的是底層代幣，不是現金。
發行方限制	直接作用於你。一次凍結就會讓你無法轉帳。	逐腿作用。任何一腿受限，整筆贖回回滾。
據以操作的價格	帶截止時間與最小輸出的可執行報價。	固定塊上的預覽。它不是成交承諾。
調倉	由你自己做。我們不持倉，也不發出任何指令。	只能通過經審核的配方，在治理之下、固定限額之內進行。
什麼時候選它	你想要某一個標的，並且想把代幣拿在手裡。	你想用一個倉位拿到一個主題，並且希望權重由合約校驗。

兩者相同的部分

資產的身份都是鏈 ID 加地址，而不是 symbol；都經過同一條證據鏈准入；發行方都能凍結或限制；兩者都不承諾你能退出。

今天開放了什麼

執行條件因路徑而異：指數份額取決於已登記金庫在當前鏈的實時能力；直接買入需要可執行路由與真實深度測量。設定地址、測試證據與生產許可是獨立維度。

核驗狀態

表示來源與代碼出處，不表示資產是否可用。

測試網技術狀態 · DISCOVERED	由歸檔來源導入的候選項，尚無任何確認。
測試網技術狀態 · SOURCE_REVIEW	發行方文件正在審核。
測試網技術狀態 · ONCHAIN_VERIFIED	已在固定區塊記錄鏈上能力證據。
測試網技術狀態 · VERIFIED	來源與鏈上證據均經獨立審核通過。
測試網技術狀態 · REVOKED	先前的批准已撤回，應視為未核驗。

操作許可

表示資產是否可用及可用方向，與核驗狀態獨立判定。

僅展示	僅可展示。不得新增敞口，也不得用於基金。
可操作	在註冊表現行規則下允許操作。
僅可退出	不得新增敞口，已有敞口可退出。
已暫停	連受影響的退出也不允許，相關操作預期會失敗。
已撤銷	終態。不得新增敞口；僅在代幣本身仍允許轉帳時可退出。

為什麼兩者分開

一項資產可以來源完全核驗而仍為僅展示；此前已激活的資產也可以在證據不變的情況下被暫停。把兩者合併成一個標記，會掩蓋「已核對發行方文件」與「可以用它構建基金」之間的區別。

能力狀態

對尚未實現的能力，API 返回 503 CAPABILITY_UNAVAILABLE。本介面將其顯示為不可用，不會替換成空清單、零餘額或交易成功。

能力	介面	狀態	寫簽名
資產註冊表目錄	GET /v1/assets	已實現	讀
資產核驗出處	GET /v1/assets/{address}/verification	已實現	讀
已歸檔官方來源	GET /v1/assets/{address}/sources	已實現	讀
固定塊代幣能力	GET /v1/assets/{address}/capabilities	已實現	讀
參考價格發布	GET /v1/assets/{address}/pricing	已實現需要已許可價格源，缺失時返回 503	讀
公開地址核驗	POST /v1/assets/verify	已實現	讀
錢包登入	POST /v1/auth/verify	已實現	讀
工作階段與角色	GET /v1/auth/session	已實現	是
業務寫 challenge	POST /v1/auth/operation-challenge	已實現	是
已發布策略發現	GET /v1/indexes	已實現	讀
策略草稿	POST /v1/indexes	已實現	逐次簽名
策略發布	POST /v1/indexes/{id}/publish	已實現	逐次簽名
只讀分享鏈接	GET /v1/indexes/by-slug/{slug}	已實現	讀
確定性事實核查	GET /v1/indexes/{id}/advisory	已實現需要已許可價格源，缺失時返回 503	讀
歷史回測	GET /v1/indexes/{id}/backtest	已實現需要已許可價格源，缺失時返回 503	讀
個人觀察清單	GET /v1/me/watchlist	已實現	是
運行鏈與部署能力	GET /v1/capabilities	已實現	讀
測試網固定規範區塊實物預覽	GET /v1/funds/{id}/preview	已實現需要已部署合約地址	讀
已登記基金目錄	GET /v1/funds	已實現	讀
固定塊基金持倉	GET /v1/funds/{id}/holdings	已實現需要 canonical 固定塊快照，缺失時返回 503	讀
參考 NAV	GET /v1/funds/{id}/nav	已實現需要已許可價格源，缺失時返回 503	讀
稀疏 NAV 歷史	GET /v1/funds/{id}/nav/history	已實現需要已許可價格源，缺失時返回 503	讀
基金活動	GET /v1/funds/{id}/transactions	已實現需要 canonical 固定塊快照，缺失時返回 503	讀
錢包持倉	GET /v1/portfolio	已實現需要 canonical 固定塊快照，缺失時返回 503	是
錢包活動	GET /v1/portfolio/transactions	已實現需要 canonical 固定塊快照，缺失時返回 503	是
交易意圖	POST /v1/transactions/intents	已實現	逐次簽名
資產復核隊列	GET /v1/admin/assets/pending	已實現	是
資產來源審核	POST /v1/admin/assets/{address}/review	已實現	逐次簽名
資產激活	POST /v1/admin/assets/{address}/activate	已實現	逐次簽名
受限基金申請	POST /v1/fund-applications	已實現	逐次簽名
基金治理記錄	GET /v1/admin/funds/{id}/governance	已實現	是
舊版一籃子報價	GET /v1/quotes/basket	API 契約尚未宣告API 契約尚未宣告；回傳 503	讀
一籃子買入報價	POST /v1/quotes/basket-buy	已實現需要經審路由 provider，預設 503，成功也僅為模擬	逐次簽名
一籃子賣出報價	POST /v1/quotes/basket-sell	已實現需要經審路由 provider，預設 503，成功也僅為模擬	逐次簽名
Vault 申購報價	POST /v1/quotes/vault-deposit	已實現需要經審路由 provider，預設 503，成功也僅為模擬	逐次簽名
Vault 贖回報價	POST /v1/quotes/vault-redeem	已實現需要經審路由 provider，預設 503，成功也僅為模擬	逐次簽名

業務寫如何授權

登入工作階段只證明身份，不授權任何變更。每個寫請求把正文序列化一次，對這些精確字節做 SHA-256，向伺服器端取一個綁定該方法、路徑與哈希的一次性 challenge，由錢包簽署伺服器端給出的完整消息，然後發送同一份字節以及 nonce 與簽名。改動一個字節、路徑或方法都會使簽名失效。

已成功的 nonce 不能復用，介面也不會靜默重複建立同一條記錄。回應丟失時，先按 nonce 查詢結果，再決定是否重發。

錢包登入意味著什麼

登入通過簽署伺服器端生成的消息，證明你控制某個地址，並在 8 小時內授權 API 調用。它不授權代幣轉帳、授權額度或基金操作，也不賦予審核者或治理角色。

金額如何處理

鏈上原始數量是整數，以 BigInt 或精確十進制字符串承載。介面不對金額執行浮點運算；在契約公布 multiplier 標度之前，也不施加任何 multiplier。

風險與限制

未設定 RPC 節點

本部署已禁用鏈上讀取。錢包連接與登入仍可使用，因為它們走錢包自身的 provider。

生產交易不可用

合約操作取決於當前鏈的部署與上線門檻。設定測試網地址不代表生產已開放；測試網當前能力請檢視具體基金頁面。

主網生產仍禁用。測試網部署與合成測試資產不等於通過生產上線門檻。
未公布價格來源、Reference NAV 或可執行報價。preview 不構成成交承諾。
由 seed 導入的註冊表記錄是候選項。候選項既未核驗，也不可交易。
代幣化股票的發行方可以限制轉帳。本介面無法保證受限代幣能夠退出。