协议

接口与状态参考

详细状态定义、签名规则与已发布 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	读
Reference 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	契约未声明契约未声明，只会返回 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 导入的注册表记录是候选项。候选项既未核验，也不可交易。
代币化股票的发行方可以限制转账。本界面无法保证受限代币能够退出。