我正在编写一个 DA Ledger 客户端应用程序。速度很慢，因为 API 文档没有解释如何结合提供的服务在 Ledger 上进行简单的创建、读取、更新和删除。
例如，没有允许客户端直接读取给定方的所有联系人的简单服务。首先，客户端需要获取分类帐 ID，然后（我认为）包 ID。等等。有一个服务可以读取活跃的合约，但是不活跃的合约呢？
拥有一些解释和演示如何将各种服务的调用组合到（例如）的文档会很有帮助：
我的应用程序是用 php 编写的。我不一定需要php中的示例，但我只想知道如何使用提供的服务来完成简单的任务。
【问题讨论】：
读取给定方的所有合同
DAML 分类帐本质上是一个事件驱动的系统。因此，它不像传统数据库那样提供查询访问。相反，您的应用程序使用GetTransactionsRequest 订阅TransactionService，并将LEDGER_BEGIN 指定为begin 偏移量。这将为您提供自分类帐启动以来发生的所有 Created 和 Archived 事件。在您的应用程序中，您可以使用这些事件来构建分类帐的表示形式（内存中的或持久的），然后您可以方便地对其进行查询。例如，您可以按合同类型填充字典，为每个 Created 事件添加一个条目，并在收到 Archived 事件时再次删除它。
创建合同或行使选择权
有两种方法可以做到这一点：
在CommandSubmissionService 上通过Submit 提交创建或执行命令，并在CommandCompletionService 上等待成功或错误消息。请注意，接收到此类命令完成消息仅确认该命令可以被分类帐成功接收。它不会包含来自该命令的任何效果（创建和存档事件）。这些您将再次通过上述TransactionService 收到。
通过SubmitAndWait 在CommandService 上提交创建或练习命令。该服务将命令提交和完成结合在对服务器端的同步调用中，因此只有在命令被服务器接受或拒绝后才会返回。使用这种命令提交方式通常更方便，因为它处理了前一种方法所需的一些异步事件处理。
请注意，您可以从使用上述TransactionService 构建的分类帐表示中获取行使选择所需的合约 ID。
【讨论】：