跳到主要内容

Broadcaster

Broadcaster 是可选的交易代发服务:接收完成的公开交易数据与证明,核对部署、报价和授权,模拟后用自己的 EVM 钱包支付原生币 gas。钱包密钥、私密 Note、解密材料和 witness 留在客户端。

用户也可以自行提交。注册表仅帮助发现服务,不授予链上提交权限,也不代表信誉、可用性或付款保证。代发服务可看到公开请求与网络来源,HTTPS 不提供网络匿名性。

服务之间的分工​

组件对接责任
SDK / 钱包构造意图,固定费用,授权、生成证明,保存恢复材料
Protocol RPC提供树、输出、Credit 与注册快照
Broadcaster报价、模拟、预留、提交和跟踪回执
Chain RPC应用独立核验规范回执与原生最终性
Provenance启用策略时核验公开来源证明;不改变 Protocol 的链上证明

Broadcaster 不接收私钥或 witness,不提供钱包托管、任意 EVM 转发、公开手续费提现或订阅接口。

发现与身份校验​

从可信服务配置或已认证的 BroadcasterRegistry 快照取得 endpoint、quoteSigner 和 feeRecipient。与服务响应中的 chainId、protocol、runtimeCodeHash、sender 和 feeRecipient 对照,并使用可信 quoteSigner 验证签名报价。不要仅凭 API 版本或 enabled 字段信任服务。

以下为只读示例,需要 POSIX shell、curl。环境变量 BROADCASTER_BASE_URL 是运营者提供的服务根 URL(不含 /v1),CHAIN_ID 是目标规范十进制 chain ID;远程 endpoint 使用 HTTPS。

: "${BROADCASTER_BASE_URL:?Set the trusted service root URL}"
: "${CHAIN_ID:?Set the expected decimal chain ID}"
BROADCASTER_BASE_URL="${BROADCASTER_BASE_URL%/}"
BROADCASTER_RPC_URL="$BROADCASTER_BASE_URL/v1/chains/$CHAIN_ID"
curl --fail-with-body -sS "$BROADCASTER_BASE_URL/v1"
curl --fail-with-body -sS "$BROADCASTER_RPC_URL" \
-H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":1,"method":"broadcaster_getStatus","params":[]}'

status 包含版本、部署身份、submissionHalted,以及 scheduling 和 provenance 能力。能力与价格由运营者决定。接入前向运营者确认所选部署支持所需方法、预约能力及证明格式;文档中的接口不代表某个公开服务已开放这些能力。

费用在授权之前固定​

服务接受单请求 transact、shield、createCredit、creditDraw、updateCredit、revokeCredit 的规范 SDK calldata。调用者不能提交自己构造的外层聚合;注册地址不属于代发入口。

estimateQuote 根据具体公开意图计算费用参考;getQuote 为最终含费意图签名。调整费用可能改变找零、输入和资金授权,因此必须重建并重新估费,收敛后再授权及证明。报价不是钱包花费授权。

用户支付同 token 的固定公开费用,服务支付原生币 gas。成功执行时费用计入 Protocol 的 token/feeRecipient 余额;回滚时费用与业务状态一起回滚。Credit draw 的用量是 gross,普通收款 Note 为扣费后的净额。创建、更新、撤销 Credit 的费用由 owner 已授权钱包承担;创建授信通常不预存本金。

发送与最终确认分开​

提交返回的 durable id 是服务任务标识,不是 JSON-RPC 请求 id,也不是钱包本地操作 ID。保存完整原始请求后再发送;响应丢失时原样重放,取得同一任务记录,不能重新报价或修改输入来“重试”。

confirmed 表示回执执行成功,reverted 表示执行回滚。它们不等于 finalized;读取独立 confirmation 并按业务政策核验规范链。HTTP 超时也不代表服务没有接单。

继续接入​