如何获取特定节点参与者的PartyAndCertificate？及调用指定Corda子流的方法

我来帮你梳理这两个问题的解决方案，都是Corda开发中比较常见的场景：

PartyAndCertificate包含了节点的身份信息和对应的证书链，是Corda中用于身份验证和交易签署的核心对象，常见的获取方式有以下几种：

• 通过本地身份服务查询：如果你知道目标节点的X500全称，直接用serviceHub.identityService来获取。比如：

  val targetX500 = X500Name.parse("O=PartyA,L=London,C=GB")
  val partyAndCert = serviceHub.identityService.wellKnownPartyFromX500Name(targetX500) as? PartyAndCertificate
  

  如果返回的是Party类型（仅包含X500名称和公钥），可以再通过公钥反向查询完整证书：

  val party = serviceHub.identityService.wellKnownPartyFromX500Name(targetX500)!!
  val partyAndCert = serviceHub.identityService.partyFromKey(party.owningKey) as PartyAndCertificate
  

• 通过网络映射服务获取：如果目标节点是网络中的peer，可以通过网络映射缓存查询其完整节点信息，从中提取证书：

  val targetX500 = X500Name.parse("O=PartyA,L=London,C=GB")
  val nodeInfo = serviceHub.networkMapCache.getPeerByLegalName(targetX500)!!
  val partyAndCert = nodeInfo.legalIdentitiesAndCerts.first { it.name == targetX500 }
  

• 从现有交易/状态中提取：如果你的流程已经在处理包含目标节点的状态或交易，直接从参与者集合中获取即可。比如状态的participants字段通常是List<AbstractParty>，可以解析为PartyAndCertificate：

  val abstractParty = state.participants.first { it.owningKey == targetKey }
  val partyAndCert = serviceHub.identityService.partyFromKey(abstractParty.owningKey) as PartyAndCertificate
  

这个generateSpend是Corda Finance模块提供的标准工具流，用于快速构建现金转账交易，帮你处理现金UTXO的拆分、合并逻辑，具体使用步骤如下：

1. 确认依赖配置 #

首先要确保你的CorDapp项目已经引入了Corda Finance模块的依赖。如果是Gradle项目，在build.gradle中添加：

cordapp project(":corda-finance")

这样才能正确导入net.corda.finance包下的相关类。

2. 准备调用参数 #

子流需要的6个参数中，大部分都可以从你的流程类中直接获取：

• services: ServiceHub：直接用FlowLogic类自带的serviceHub属性即可。
• tx: TransactionBuilder：可以初始化一个空的Builder，指定网络中的公证人：

  val notary = serviceHub.networkMapCache.notaryIdentities.first()
  val txBuilder = TransactionBuilder(notary)
  

• amount: Amount<Currency>：注意金额单位是币种的最小单位（比如美元是分，英镑是便士），例如：

  val transferAmount = Amount(50000, Currency.getInstance("USD")) // 500美元
  

• ourIdentity: PartyAndCertificate：当前节点的身份证书，直接从本地节点信息中获取：

  val ourIdentity = serviceHub.myInfo.legalIdentitiesAndCerts.first()
  

• to: AbstractParty：收款方的身份，可以是Party或PartyAndCertificate类型，用前面提到的任意一种方式获取即可。
• onlyFromParties: Set<AbstractParty>：可选参数，限制只能从指定的现金持有者账户扣款，默认是空集合（不限制）。

3. 调用子流并处理结果 #

调用后会返回一个Pair<TransactionBuilder, List<PublicKey>>，其中：

• 第一个元素是已经添加了现金转账指令的TransactionBuilder，你可以继续在上面添加其他状态、命令等。
• 第二个元素是需要签署该交易的公钥列表，通常包含当前节点的签名密钥，需要完成签名才能继续流程。

完整的调用示例：

// 1. 初始化基础TransactionBuilder
val notary = serviceHub.networkMapCache.notaryIdentities.first()
var txBuilder = TransactionBuilder(notary)

// 2. 准备参数
val transferAmount = Amount(1000000, Currency.getInstance("GBP")) // 1000英镑
val ourIdentity = serviceHub.myInfo.legalIdentitiesAndCerts.first()
val toParty = serviceHub.identityService.wellKnownPartyFromX500Name(X500Name.parse("O=PartyB,L=New York,C=US"))!!

// 3. 调用generateSpend子流
val (updatedTx, signingKeys) = generateSpend(serviceHub, txBuilder, transferAmount, ourIdentity, toParty)

// 4. 完成本地签名
signingKeys.forEach { key ->
    updatedTx.signWith(serviceHub.keyManagementService.signingKey)
}

// 后续可以继续添加其他组件、收集对方签名、提交交易等

4. 注意事项 #

• 确保收款方的身份已经在本地节点的身份服务中存在，否则会抛出身份解析异常。
• 如果指定了onlyFromParties，要确保这些节点持有足够的现金余额，否则子流会因余额不足抛出错误。
• 子流内部已经处理了现金状态的拆分和合并，无需手动管理UTXO，大大简化了现金转账的开发流程。

内容的提问来源于stack exchange，提问作者zhangyx395