BitFS SDK API 框架设计

本文是 BitFS SDK 的公开 API 蓝图入口，不是 wire 规范，也不是可直接编译的 Go 代码。实际实现必须服从 001–007 协议规范；若本文与编号规范冲突，以编号规范为准。

为避免把协议、外部能力和角色流程混在一个超大文档中，API 框架拆分如下：

文档	说明
01 · 协议基础与 CBOR	包边界、通用约定、错误模型、统一 wire 编解码与纯协议函数。
02 · 外部钩子与数据类型	签名、存储、内容、交易引擎、BSV 节点钩子及关键输入类型。
03 · 角色工作流 API	买方、卖方、仲裁者 API，以及最短端到端调用顺序。
04 · 实施路线	实施先后顺序与必须覆盖的验证场景。

SDK 只构造、验证和保存自证明凭证；网络投递、私钥托管、内容存储、数据库和 BSV 节点均由调用方通过接口接入。数据库记录只用于查找、幂等和卖方交付保护，不能替代原始 CBOR、原始交易和签名。