WCNWeb3 Capital Network
v1.0接口契约 · 公开 API 边界待发布

围绕证明边界构建。

面向开发者与运营者的文档控制台：快速开始、证明提交、节点记录、Deal/Task、注册表查询与事件 webhook。

打开系统库打开 Wiki

指南章节

04

从快速开始到证明审核

接口族

05

Proof、Nodes、Deals、Registry、Webhooks

语言示例

03

cURL、JavaScript、Python

01 · 定位

Docs 先定义边界，而不是包装卖点。

WCN 的公开文档说明外部构建者如何理解证明对象、已审核节点和事件表面，同时不暴露私有 Deal 文件。

  • 公开页面解释概念和安全字段。
  • 私有证据留在有权限控制的审核层。
  • 公开 API 只有在边界批准后才发布可用性声明。

02 · 访问

每一次写入都要认证，每一份证明都要审核。

目标 API 模型是范围化访问。写入必须可归因、可重试，并能在审核失败时撤回或拒绝。

  • 仅在批准后使用 bearer key。
  • 写操作带 idempotency key。
  • 公开摘要是审核输出，不是原始上传。

03 · 快速开始

提交证明，等待审核，再安全发布。

典型集成会创建 proof packet，收到 in_review 状态，并在摘要被批准后监听签名事件。

  • 为已知 task 创建证明包。
  • 保存返回的 proof id 用于对账。
  • 监听 proof.published，而不是轮询原始证据。

04 · 审核模型

审核层本身就是协议的一部分。

WCN 是证据优先。真正有用的对象不是上传动作，而是经过审核、能支持归因、结算和声誉的 proof object。

  • 拒绝不可验证提交。
  • 区分私有证明和公开证明摘要。
  • 明确争议与撤销路径。

API 参考

POST/v1/proof

Submit a proof

Create a proof packet for review. Public output stays limited to safe summaries; private evidence remains permissioned.

参数

taskstring必填

The reviewed task or deal-task identifier.

evidenceuri必填

A private or content-addressed evidence reference.

idempotency_keystring可选

Prevents duplicate submissions during retries.

错误

401unauthorizedMissing or invalid API key.
409duplicate_submissionThe idempotency key has already been used.
422validation_errorRequired evidence fields are missing or malformed.

请求

example
curl https://api.wcn.network/v1/proof \
  -H "Authorization: Bearer $WCN_KEY" \
  -H "Idempotency-Key: proof_2026_06_30_001" \
  -d '{ "task": "task_8fK2a", "evidence": "ipfs://bafy..." }'

响应

example
{
  "id": "proof_3xQ",
  "status": "in_review",
  "public_summary": null
}

源资料

系统库WCN 72 系统、设计系统与运营文档的原始 HTML 源资料归档。打开系统库 →WikiWCN 概念、证明逻辑、节点系统、治理和路线图的主知识库。阅读 Wiki →开发者保守的开发者入口，记录当前公开 API 边界与集成姿态。查看边界 →

更新记录

v1.0

  • 上线原生 /docs 栏目。
  • 加入 Proof、Nodes、Deals、Registry、Webhooks 五组接口契约。
  • 连通系统库与 Wiki。