API 版本与兼容性

版本方式

BlockVectra API 采用路径版本 /v1。

兼容的变更

以下变更属于兼容变更，不升版本，客户端必须忽略未知字段：

• 新增字段
• 新增 error.data.reason 取值
• 新增端点
• 新增可选参数

客户端遇到不认识的 reason，按同一错误对象里的 retryable 处理。详见错误参考页。

不兼容的变更

只有以下不兼容变更才会升 /v2：

• 删除字段
• 改变字段含义
• 改变返回粒度

不属于接口版本变化

链和方法的上下线由 GET /v1/chains 实时反映，属于运营配置，不算接口版本变化。

价格与 CU 权重

价格表实时来自 GET /v1/plans 的 method_weights，与计费使用同一份。最新价格与计费规则见定价页。

给 Agent 与 SDK 作者的建议

由上述规则直接推出的建议：

1. 忽略未知字段：客户端必须忽略未知字段。
2. 未知 reason 看 retryable：遇到不认识的 reason，按同一错误对象里的 retryable 处理。