Corda Token SDK：如何设置代币encumbered（受限）状态并在转账选币时排除该类代币

核心结论 #

Corda官方Token SDK的原生设计完全能覆盖你的需求：既可以为代币设置受限（encumbered）状态、绑定对应的解锁规则，也能在节点选取待转账的可用代币时自动排除未解锁的受限代币，不需要从零开发底层的账本一致性逻辑。

受限状态的实现方式 #

你可以直接基于Token SDK内置的EncumberableTokenState接口实现代币的受限属性，实际落地开发的流程很直接：

• 所有需要支持受限规则的代币状态，直接实现EncumberableTokenState接口就行，这个接口本身就内置了两个核心定义：
  • isEncumbered: Boolean：用来标记当前代币是否处于受限状态
  • encumbranceRef: StateRef?：指向与当前代币绑定的解锁条件状态的账本引用，Corda框架会强制做账本一致性校验，保证这个代币状态和绑定的解锁状态必须同生共死，不能单独被转移或者消耗
• 当你（也就是转出方Party A）要给Party B转受限代币时，只需要在构造交易的输出状态时，把这次转出的代币状态的isEncumbered设为true，同时把双方之前约定的解锁条件（比如“到指定日期自动解锁”“完成配套履约交易后解锁”）对应的可验证状态，作为额外的输出写到同一笔交易里，把两个状态的encumbranceRef互相绑定就完成了。交易上链之后，Party B账本上收到的这部分代币就会处于受限状态，只有当绑定的解锁状态被合规消费、或者满足预设规则时，代币的受限状态才会自动解除。

受限代币的自动过滤逻辑 #

Corda Token SDK的默认代币选择器（TokenSelection）原生就支持受限代币的自动排除，不需要额外写自定义的过滤代码：

• 节点发起代币转账时，默认的代币选择器会遍历钱包里所有可用的UTXO状态，对实现了EncumberableTokenState接口的状态，会自动调用接口内置的isAvailableForSpending()方法判断这个状态是不是可以花费
• 当方法返回false（也就是对应代币处于没解锁的受限状态）时，选择器会直接跳过这个状态，根本不会把它纳入待选的可花费代币范围
• 这就意味着Party B发起自有代币转账的时候，系统会自动把所有没满足解锁条件的受限代币排除在外，完全匹配你提的业务要求。

个性化场景的扩展 #

如果你的业务有比较特殊的自定义受限规则，也可以灵活扩展实现：

• 直接在自定义代币状态里加专属的受限标记字段（比如受限类型、解锁阈值、关联的业务规则ID等）
• 自定义实现TokenSelection接口，在筛选可花费代币的时候，按照你的业务规则读取状态上的受限字段，判断要不要把这个状态放进可选范围
• 提醒一下，如果没有特别的需求，优先用内置的EncumberableTokenState接口，它的状态绑定逻辑是Corda账本层提供的一致性保障，能避免出现受限代币被违规转移的风险。

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