Docker Compose 验证者部署

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
cd splice-node/docker-compose/验证者
```

2、导出当前版本到环境变量：export IMAGE\_TAG=0.6.2
3. 运行以下命令启动验证者节点，并等待其准备就绪（可能需要几分钟）：

> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> ./start.sh -s "<SPONSOR_SV_URL>" -o "<ONBOARDING_SECRET>" -p "<party_hint>" -m "<MIGRATION_ID>" -w
> ```
>
> 地点：
>
> `<party_hint>` 将用作验证人管理员的参与方 ID 的前缀。
> 格式必须为 `<organization>-<function>-<enumerator>`，例如`myCompany-my钱包-1`。它不能随着时间的推移而更改，因为它是验证者运营方 ID 的一部分。

请注意，验证者可以使用命令 `./stop.sh` 停止，并使用与上面相同的 `start.sh` 命令再次重新启动。其数据将在调用之间保留。在后续调用中，秘密本身可以留空，但`-o`仍然是强制性的，因此应提供`-o ""`参数。

登录钱包界面<注意>

基于 Docker Compose 的验证者部署使用.localhost子域进行寻址，例如钱包.localhost。据报道，.localhost URL 在某些浏览器上不起作用。如果您遇到问题，请尝试使用其他浏览器，例如 Firefox 或 Chrome。如果您在从自定义程序或脚本访问 API 时遇到问题，则可能需要将 HTTP 请求上的 HOST 标头显式设置为目标 .localhost 地址。 </注>

可以在浏览器中通过 http://钱包.localhost 访问钱包 UI。验证人管理员的用户名是administrator。将该名称插入用户名字段并单击Log in，您应该会看到钱包管理员的钱包。

您还可以注销管理员帐户并以任何其他用户名登录。用户第一次登录时，系统会提示一条消息，要求他们确认是否希望加入验证者节点。

登录 CNS UI

您可以在 http://ans.localhost 打开浏览器（请注意，当前默认为ans，而不是cns），并使用同一管理员用户或已通过钱包登录的任何其他用户登录，以便为该用户购买 CNS 条目。

访问 Canton 参与者 API

JSON Ledger API 在 json-ledger-api.localhost:80 下公开。请注意，对于某些客户端，您可能明确需要设置 Host: json-ledger-api.localhost 标头才能正确解决此问题。

gRPC Ledger API 在 grpc-ledger-api.localhost:80 下公开。请注意，对于某些客户端，您可能明确需要设置 :authority: json-ledger-api.localhost 伪标头才能正确解决此问题。

Canton Admin API 默认情况下不公开，因为它尚不支持身份验证。 nginx.conf 中有一个注释掉的部分，如果您确保它不会公开（例如通过网络限制），则可以启用该部分来公开它。

配置身份验证

请参阅身份验证部分，了解如何为验证者设置 OAuth 提供程序的说明。为回调配置的 URL 为 http://钱包.localhost 和 http://ans.localhost。

设置 OAuth 提供程序后，您需要通过在 .env 文件中设置以下环境变量来配置它：

<表> <标题> <tr 类名=“标题”> 姓名 值 </标题>

<正文> AUTH_URL 用于获取 openid-configuration 和 jwks.json 的 OIDC 提供商的 URL。

<tr className="偶">
  <td>AUTH\_JWKS\_URL</td>
  <td>用于获取 <code>jwks.json</code> 的 OIDC 提供商的 URL 通常为 <code>\${AUTH_URL}/.well-known/jwks.json</code>。</td>
</tr>

<tr className="奇数">
  <td>AUTH\_WELLKNOWN\_URL</td>
  <td>用于获取 <code>openid-configuration</code> 的 OIDC 提供商的 URL 通常为 <code>\${AUTH_URL}/.well-known/openid-configuration</code>。</td>
</tr>

<tr className="偶">
  <td>LEDGER\_API\_AUTH\_AUDIENCE</td>
  <td>参与者账本 API 的受众，例如<code>[https://ledger\_api.example.com](https://ledger_api.example.com)</code>。这将为参与者设置 <code>ledger-api.auth-services.target-audience</code> 配置。</td>
</tr>

<tr className="奇数">
  <td>LEDGER\_API\_AUTH\_SCOPE</td>
  <td>参与者账本 API 的范围。这将设置参与者的 <code>ledger-api.auth-services.target-scope</code> 配置。可选。</td>
</tr>

<tr className="偶">
  <td>验证者\_AUTH\_AUDIENCE</td>
  <td>验证者后端 API 的受众。例如<code>[https://验证者.example.com](https://验证者.example.com)</code>。</td>
</tr><tr className="奇数">
  <td>VALIDATOR\_AUTH\_CLIENT\_ID</td>
  <td>验证者应用后端的 OAuth 应用的客户端 ID。</td>
</tr>

<tr className="偶">
  <td>VALIDATOR\_AUTH\_CLIENT\_SECRET</td>
  <td>验证者应用后端的 OAuth 应用的客户端密钥。</td>
</tr>

<tr className="奇数">
  <td>LEDGER\_API\_ADMIN\_USER</td>
  <td>应与为验证者应用程序颁发的 JWT 的 `sub` 字段匹配。对于某些身份验证提供程序，这将形成为 <code>CLIENT\_ID\@clients</code>。</td>
</tr>

<tr className="偶">
  <td>钱包\_ADMIN\_USER</td>
  <td>应以钱包管理员身份登录的用户的用户ID。请注意，这应该是完整的用户 ID，例如 <code>auth0|43b68e1e4978b000cefba352</code>，<em>而不仅仅是</em>后缀 <code>43b68e1e4978b000cefba352</code>。</td>
</tr>

<tr className="奇数">
  <td>钱包\_UI\_CLIENT\_ID</td>
  <td>钱包 UI 的 OAuth 应用程序的客户端 ID。</td>
</tr>

<tr className="偶">
  <td>ANS\_UI\_CLIENT\_ID</td>
  <td>CNS UI 的 OAuth 应用程序的客户端 ID。</td>
</tr>

<tr className="奇数">
  <td>联系\_POINT</td>
  <td>您的验证者节点的联系点，其他节点运营商可以使用该联系点在需要时与您联系（slack 用户名或电子邮件地址）。可选</td>
</tr>

为了在部署中启用身份验证，请将-a标志添加到start.sh命令，如下所示：

./start.sh -s "<SPONSOR_SV_URL>" -o "<ONBOARDING_SECRET>" -p "<party_hint>" -m "<MIGRATION_ID>" -w -a

如果您已经在计算机上部署了未经身份验证的验证者，则可以通过使用 ./stop.sh 停止验证者并使用 -a 标志重新启动它，将其迁移到经过身份验证的验证者，如上所述。验证者操作者用户将自动迁移，WALLET_ADMIN_USER变量指示的用户将与验证者操作者方关联。如果您还让其他用户加入您的验证者，这些用户将不会自动迁移，您需要手动将 OAuth 用户与其相应方关联。为此，首先记下所有相关用户的参与方 ID（在停止未经身份验证的验证者之前执行此操作），例如通过从钱包用户界面的右上角复制它们。现在，对于您想要迁移的每个用户，请按照 Splice 钱包部分的用户、各方和钱包中的说明将用户与一方关联起来，但将管理方 ID 替换为您希望与每个用户关联的一方 ID。

配置自动流量购买

您的节点配置为按量付费自动购买流量（请参阅自动购买流量）。为了满足您的需求，您可以设置环境变量，例如：

export TARGET_TRAFFIC_THROUGHPUT=20000 # target throughput in bytes/second
export MIN_TRAFFIC_TOPUP_INTERVAL="1m" # minimum interval between top-ups

每次成功充值时，验证者应用都会购买 `top-up amount` 大约 `targetThroughput * minTopupInterval` 字节的流量（具体金额可能因四舍五入而异）。 `minTopupInterval` 允许验证者操作员控制自动充值发生的上限频率。如果充值金额低于同步器范围的`minTopupAmount`（请参阅[流量参数](https://docs.canton.network/global-synchronizer/deployment/synchronizer-流量#流量-parameters)），`minTopupInterval`会自动拉伸，以便在尊重配置的`targetThroughput`的同时至少购买`minTopupAmount`字节的流量。

当满足以下所有条件时，将触发下一次充值：

• 可用的[额外流量余额](https://docs.canton.network/global-synchronizer/deployment/synchronizer-流量#流量-accounting-what-counts-as-流量)低于配置的充值金额（即低于`targetThroughput * minTopupInterval`）。
• 自上次充值以来至少已过去 `minTopupInterval`。
• 验证者的钱包中有足够的 CC 来购买流量的充值金额（DevNet 上除外，验证者应用程序将自动挖掘足够的代币来购买流量）。

验证者会从超级验证者那里获得少量的免费流量，足以提交充值交易。但是，如果提交了很多其他交易，则可能会遇到免费流量也耗尽的情况，从而验证者无法提交充值交易。免费流量补贴逐步持续积累。在没有提交交易的情况下，免费流量大约需要二十分钟才能积累到最大可能。如果您在未购买流量的情况下提交过多交易而耗尽了流量余额，请暂停您的验证者节点（验证者应用和参与者）二十分钟，以积累免费流量余额。

配置扫描和自动接受转让优惠

您可以选择将验证者配置为在其托管的某些方的余额超过特定阈值时自动创建向网络上其他方的转移要约。

每当``的余额超过`maxBalanceUSD`时，验证者就会自动向``创建转账要约，金额将`minBalanceUSD`留在发送者的钱包中。请注意，您需要知道发送方和接收方的参与方 ID，可以从相应用户的钱包 UI（位于右上角）复制该 ID。因此，一旦知道了参与方 ID，就需要在初始部署后的第二步中将其应用于 Helm 图表。

每当验证者收到从``到``的转账要约时，它都会自动接受。与扫描类似，必须知道参与方 ID 才能应用此配置。

为此，请填写以下部分并将以下附加配置添加到您的验证者环境中：

# sweep by transferring directly through the transfer preapproval of the receiver,
# if set to false sweeping creates transfer offers that need to be accepted on the receiver side.
# Note that this refers to the preapprovals described in /appdev/modules/m7-canton-coin-preapprovals
# and not to auto accepting transfers. Auto accept transfers does not setup preapproval contracts that allow
# for a direct transfer but just automates the acceptance of the transfer offer so in that case
# useTransferPreapproval should be set to false.
services:
  验证者:
    environment:
       - |
          ADDITIONAL_CONFIG_WALLET_SWEEP=
            canton.验证者-apps.验证者_backend.钱包-sweep {
              "<senderPartyId1>" {
                max-balance-usd = 1000
                min-balance-usd = 100
                receiver = "<receiverPartyId>"
                use-transfer-preapproval = false
              }
            }

同样，您可以将验证者配置为自动接受网络上某些方的转账要约。为此，请添加以下附加配置：

   services:
     验证者:
       environment:
          - |
             ADDITIONAL_CONFIG_AUTO_ACCEPT_TRANSFERS=
               canton.验证者-apps.验证者_backend.auto-accept-transfers {
                 "<receiverPartyId>" {
                   from-parties = ["<senderPartyId1>", "<senderPartyId2>"]
                 }
               }

与 systemd 和其他 init 系统集成

如果您想通过 systemd 或类似的 init 系统管理验证者，请创建一个使用正确参数调用 start.sh 脚本的服务。但是，请注意，start.sh 使用 -d/--detach 选项调用 docker compose up，因此脚本会在容器启动后退出，而不是继续运行。

您需要确保您的服务此时不会停止 docker compose。要完成此操作，请使用 systemd 设置 RemainAfterExit=true。有关更多详细信息，请参阅 systemd 文档。如果您使用另一个 init 系统，请查找类似的选项以确保 docker compose 在脚本退出后继续运行。

或者，您可以编辑脚本以删除 -d 选项，以便脚本继续运行。

本文由 CC Privacy Club 根据 Canton Network 官方文档（CC-BY-4.0）整理翻译，仅供学习；实现细节以官方最新版本为准。