> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/zh/integrations/fireblocks.md).

# Fireblocks

本指南介绍如何将 Phalcon Compliance 与 [Fireblocks](https://www.fireblocks.com/) 配合使用，筛查出站和入站交易中的 AML/CFT 风险。通过结合这两个平台，您可以在出站交易执行前进行筛查，并在 Fireblocks 检测到入站交易时对其进行监控。

## 前提条件

**基本设置所需：**

* 有效的 Phalcon Compliance 账户和 API 密钥（参见 [API 密钥](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/account/api-keys.md)）
* 可访问 Webhook 或 API 的 Fireblocks 工作区

**仅高级设置所需：**

* **API Co-Signer**，用于通过回调处理程序自动筛查出站交易（参见 [Fireblocks Co-Signer 概览](https://developers.fireblocks.com/docs/use-cosigners-for-signing-automation)）
* **手动筛查裁决**，用于手动处理入站交易裁决的工作流（请联系您的 Fireblocks 客户成功经理启用此功能）

## 筛查出站交易

当您的组织通过 Fireblocks 发送资金时，可以使用 Phalcon Compliance 在交易签名并广播**之前**筛查目标地址。有两种方法：

### 选项 1：通过 Phalcon API 预筛查

向 Fireblocks 提交交易前，使用 Phalcon Compliance API 筛查目标地址。您的团队根据风险评估决定是否继续。

**工作原理：**

1. 您的团队通过 [筛查单个地址](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/address-screening/screen-a-single-address.md) API 或 Phalcon 控制面板，将目标地址提交给 Phalcon Compliance。
2. Phalcon Compliance 返回风险评估，包括风险级别、风险指标和风险暴露详情。
3. 您的团队审查结果，并根据内部合规政策作出决定：
   * **风险不可接受** — 拒绝交易。不要将其提交给 Fireblocks。
   * **风险可接受** — 继续在 Fireblocks 中创建交易。
4. 如果接受，通过 Fireblocks API 或控制台将交易提交给 Fireblocks。

<figure><img src="https://1173431473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLVe0rlwDVlmwtHERF9ws%2Fuploads%2Fgit-blob-510225c099a70cfdc6aa2f3c3295359e4fd524d6%2Ffireblocks-outgoing-option1-pre-screening.png?alt=media" alt="Outgoing transaction pre-screening flow: You screen the address through Phalcon Compliance before submitting the transaction to Fireblocks"><figcaption><p>Pre-screening flow: screen the destination address through Phalcon before submitting the transaction to Fireblocks.</p></figcaption></figure>

**要点：**

* 无需额外的基础设施。您只需要 Phalcon API 密钥。
* 您可以配置 Phalcon 的[通知渠道](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/configure/notification-channels.md)，在检测到高风险地址时向相关人员发送提醒。

### 选项 2：使用回调处理程序自动筛查

此方法使用 [API Co-Signer 回调处理程序](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler)，将 Phalcon Compliance 直接集成到 Fireblocks 交易签名工作流中。每笔出站交易都会在 Co-Signer 签名前自动进行筛查。

**工作原理：**

1. 通过 Fireblocks API 发起交易。
2. 交易经过 Fireblocks 交易授权策略 (TAP)。
3. 在您的环境中运行的 API Co-Signer 从 Co-Signer Gateway 接收交易详情。
4. Co-Signer 将交易详情转发给您的**回调处理程序**，这是您部署的自定义 HTTPS 服务器。
5. 您的回调处理程序调用 [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/address-screening/screen-a-single-address.md) 来筛查目标地址。
6. 根据 Phalcon 的风险评估，您的回调处理程序返回一项决定：
   * **批准** — Co-Signer 对交易进行签名，并将签名发送给 Co-Signer Gateway。
   * **拒绝** — Co-Signer 取消交易。

<figure><img src="https://1173431473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLVe0rlwDVlmwtHERF9ws%2Fuploads%2Fgit-blob-38672a87ea0db3d283458130f5e2478f84893be7%2Ffireblocks-outgoing-option2-callback-handler.png?alt=media" alt="Automated outgoing transaction screening flow: Callback Handler integrates Phalcon Compliance into the Fireblocks Co-Signer signing process"><figcaption><p>Automated screening flow: the Callback Handler screens transactions through Phalcon Compliance before the Co-Signer signs.</p></figcaption></figure>

**要点：**

* API Co-Signer 要求回调处理程序在 **30 秒**内返回响应。
* 您可以完全控制回调处理程序中的风险阈值逻辑。
* 有关配置 Co-Signer 的详情，请参见 [Fireblocks 回调处理程序文档](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler)。

## 筛查入站交易

当您的 Fireblocks 工作区收到资金时，可以使用 Phalcon Compliance 筛查发送方地址并评估其风险。有两种方法：

### 选项 1：通过 Webhook 自动筛查

将 Fireblocks Webhook 连接到 Phalcon Compliance，以自动筛查入站交易事件。您可以使用 Phalcon 提供的 Webhook 端点，也可以部署自己的 Webhook 服务器来调用 [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/address-screening/screen-a-single-address.md)。

**工作原理：**

1. 设置 Webhook 端点以接收 Fireblocks 交易事件。您可以使用 Phalcon Compliance 提供的 Webhook URL，也可以部署自己的服务器来调用 [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/address-screening/screen-a-single-address.md)。
2. 在 Fireblocks 工作区中注册 Webhook URL（参见 [Fireblocks Webhooks 文档](https://developers.fireblocks.com/reference/webhooks-overview)）。
3. 检测到入站交易时，Fireblocks 会将事件发送到 Webhook 端点。
4. 系统解析事件，并由 Phalcon Compliance 筛查相关发送方地址。
5. 根据风险评估：
   * **检测到风险** — Phalcon Compliance 中会创建提醒，供您的团队审查。
   * **未检测到风险** — 系统会记录筛查结果。无需采取进一步操作。

<figure><img src="https://1173431473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLVe0rlwDVlmwtHERF9ws%2Fuploads%2Fgit-blob-946b6cf09c4c4be65219e737bd51a2b129fbb426%2Ffireblocks-incoming-option1-webhook.png?alt=media" alt="Automated incoming transaction screening flow: Fireblocks sends events to Phalcon Compliance via webhook for screening"><figcaption><p>Automated incoming screening: Fireblocks sends transaction events to Phalcon Compliance for screening.</p></figcaption></figure>

**要点：**

* 筛查依据 Phalcon Compliance 中配置的风险引擎和阈值。
* 配置[通知渠道](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/configure/notification-channels.md)，在检测到风险时向您的合规团队发送提醒。
* 如果您需要 Webhook 集成设置方面的帮助，请通过 ***<phalcon_support@blocksec.com>*** 联系我们。

### 高级：手动筛查裁决

> 适用于要求对每笔入站交易进行人工审查并明确批准的合规团队。

{% hint style="warning" %}
此功能在 Fireblocks 中仅限部分用户使用。请联系您的 Fireblocks 客户成功经理，为您的工作区启用手动筛查裁决。
{% endhint %}

启用手动筛查裁决后，入站交易会保持 `PENDING_SCREENING` 状态，直到您的合规团队提交裁决。您的团队使用 Phalcon Compliance 评估风险，然后向 Fireblocks 提交裁决。

**工作原理：**

1. 入站交易到达您的 Fireblocks 工作区，并被置于 `PENDING_SCREENING` 状态。
2. 您的合规团队会收到待处理交易通知。
3. 您的团队在 Phalcon Compliance 中筛查发送方地址，并审查风险评估。
4. 根据审查结果，您的团队向 Fireblocks API 提交裁决（`POST /aml/verdict/manual`）：
   * **接受** — 交易将获准处理。
   * **拒绝** — 交易将在 Fireblocks 中被标记并冻结。
5. 如果在 **一小时**内未提交裁决，Fireblocks 会自动拒绝并冻结该交易。

<figure><img src="https://1173431473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLVe0rlwDVlmwtHERF9ws%2Fuploads%2Fgit-blob-ff841d6e61f27e4c54e709879510fda256561c60%2Ffireblocks-incoming-option2-manual-verdict.png?alt=media" alt="Manual incoming transaction screening flow: Compliance team reviews in Phalcon Compliance and submits a verdict to Fireblocks"><figcaption><p>Manual screening: your compliance team reviews the risk in Phalcon Compliance and submits a verdict to Fireblocks.</p></figcaption></figure>

**要点：**

* 手动筛查裁决仅适用于入站交易，不影响出站交易。
* Webhook 方法（选项 1）和手动筛查裁决**不能同时使用** — 您必须选择一种方法来筛查入站交易。
* 一小时超时机制可提供安全保障，但您的团队应尽量及时审查并响应。

## 后续步骤

* [风险引擎](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/configure/risk-engines.md)：自定义符合您合规政策的风险阈值和指标。
* [通知渠道](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/configure/notification-channels.md)：设置高风险活动检测提醒。
* [API 密钥](https://docs.compliance.phalcon.blocksec.com/zh/user-manual/account/api-keys.md)：生成 Phalcon Compliance API 的凭据。
* [API 文档](https://docs.compliance.phalcon.blocksec.com/zh/api-documentation/introduction.md)：查看端点详情和请求/响应示例。
