对接入方而言，Foreshock 是什么

你会读到这里，是因为你账本上游的资产可能被冻结，而你更希望在贷记之前知道，而不是之后。这一节写给接入这条链路的工程师。

API 回答三个问题

暴露面。 你自己的哪些地址当前与某个执法事件相关、以什么关系、有多严重。GET /v1/exposure 按游标顺序返回你已登记地址簿上的匹配。

筛查。 权威名单对某个地址的说法，以及第三方供应商的说法；每一条答案都带一个引用，指向产生它的上游原始响应的不可变快照。POST /v1/screen/address。

裁决。 一笔入金是否可以贷记、挂起还是拒绝，并写入一条只追加的裁决记录与证据引用。POST /v1/decide/deposit。

只有第三个产生具有约束力的裁决。筛查是对一个地址的报告，它不决定任何事。

你发出什么，收回什么

你发出的是引用，不是身份。地址簿登记一次，此后每个答复都用一个不透明的 customer_address_ref 指向其中一条，且只有你的账户能解析它。入金用 deposit_ref、chain、tx_hash、from_address、to_address、asset、amount_usd 描述，如果你保留了自己的 user_ref 与 kyc_ref，也一并传入。

收回的是一条匹配、一份筛查结果或一个裁决——并且在每一条路径上，都会附带「我们现在看不看得见」。coverage_health 随暴露面结果返回，可在 GET /v1/coverage 单独查询，并在筛查与裁决接口上被压缩成 Foreshock-Coverage-Health 响应头。

API 刻意不返回的东西

• 执法事件所针对的那个地址。
• 关系是如何被判定出来的任何细节。
• 任何非终态执法数据的批量导出。
• 任何合成风险分数。供应商结果按各自的量纲并列返回，不换算、不合并。不存在能加上 Foreshock 分数的 debug 或 verbose 模式——因为压根不存在这样的模式。
• 对「你会提前多久拿到消息」的任何承诺。可见性是各发行方治理结构的副产品，不是 Foreshock 提供的能力，发行方随时可以改变执行方式。

Foreshock 不是什么

它不做 KYC。kyc_ref 是你自己的引用，被存储与回显，从不被评估。

它不持有任何可移动资金的私钥。这是采集器的架构事实，不是一句政策承诺。

它不转移资金、不冻结任何东西、不代表你行动。所有动作都留在你这一侧。产品定位是提前拒收——拒绝贷记——仅此而已。

接下来读什么

先读「一次接入长什么样」，然后在写第一个请求之前读「fail-closed 客户端契约」。本文档其余部分都默认你已经读过它。