如何在Corda中添加自定义货币类型并设置其汇率（如1egy=2$）

嘿，我来帮你搞定在Corda里添加自定义货币的事儿！针对你要引入的"egy"货币（1 egy = 2 $），下面是具体的实现步骤，都是实战里常用的操作：

Corda的net.corda.core.contracts.Currency类默认支持ISO 4217标准货币，但也完全允许创建非ISO自定义货币。下面分步骤实现你的需求：

1. 创建自定义货币实例 #

你可以直接用Currency.getInstance()方法生成非ISO货币，只需要传入货币代码和小数位数（比如如果"egy"没有分币单位，小数位数设为0；如果有细分就设为2）：

// 定义egy货币：代码用大写"EGY"（和标准货币风格统一），小数位数0
val EGY = Currency.getInstance("EGY", 0)
// 美元可以直接调用内置实例
val USD = Currency.getInstance("USD")

小提醒：非ISO货币的代码尽量用大写，避免和标准货币混淆，也方便节点间识别。

2. 在状态类中使用自定义货币 #

接下来把自定义货币用到你的资产状态里，比如创建一个EgyptianPoundState或者在通用的现金状态里兼容它：

data class CustomCurrencyState(
    val amount: Amount<Currency>,
    val holder: Party,
    override val participants: List<Party> = listOf(holder)
) : ContractState {
    // 状态的其他业务逻辑...
}

// 示例：创建一个100 egy的状态实例
val egyAmount = Amount(100, EGY) // 因为小数位数是0，直接传数量即可；如果是2的话要乘以100（比如100 egy = 100*100 分）
val egyState = CustomCurrencyState(egyAmount, ourIdentity)

3. 实现汇率转换逻辑（1 egy = 2 USD） #

Corda本身不会自动维护货币汇率，所以你需要在合约或流程里手动实现转换规则，这里给两种常用方案：

方案一：在合约中验证汇率合规性 #

如果是做egy和USD的兑换交易，合约里可以加规则确保金额符合汇率：

class CustomCurrencyContract : Contract {
    companion object {
        const val ID = "com.yourpackage.CustomCurrencyContract"
        // 硬编码汇率（如果需要动态调整，可以改成从状态读取）
        private val EGY_TO_USD_RATE = 2L
    }

    override fun verify(tx: LedgerTransaction) {
        val exchangeCommand = tx.commands.requireSingleCommand<Commands.Exchange>()
        val inputEgyState = tx.inputsOfType<CustomCurrencyState>().single { it.amount.token == EGY }
        val outputUsdState = tx.outputsOfType<CustomCurrencyState>().single { it.amount.token == USD }

        // 验证兑换金额是否符合1 egy = 2 USD的规则
        val expectedUsdQuantity = inputEgyState.amount.quantity * EGY_TO_USD_RATE
        require(outputUsdState.amount.quantity == expectedUsdQuantity) {
            "兑换金额不符合汇率：1 EGY 应兑换 2 USD"
        }
        // 其他验证规则（比如签名、参与者权限等）...
    }

    interface Commands : CommandData {
        class Exchange : Commands
    }
}

方案二：在流程中计算等价金额 #

如果只是在流程里需要转换金额（比如生成交易前计算），可以写一个工具方法：

fun convertEgyToUsd(egyAmount: Amount<Currency>): Amount<Currency> {
    require(egyAmount.token == EGY) { "仅支持EGY转USD" }
    val usdQuantity = egyAmount.quantity * 2 // 对应1 egy = 2 USD
    return Amount(usdQuantity, USD)
}

4. 节点配置中注册自定义货币（可选但推荐） #

如果要让整个Corda网络的节点都能识别"egy"，可以在节点的node.conf配置文件里注册它：

customCurrencies=[
    {
        code="EGY"
        displayName="Egyptian Custom Currency"
        defaultFractionDigits=0
    }
]

这样节点启动时会加载这个自定义货币，其他节点只要同步配置，就能正确解析相关交易。

额外注意点 #

• 非ISO货币在跨节点交易时，所有参与节点都需要知道这个货币的定义（要么配置文件注册，要么代码里统一定义），否则会解析失败。
• 如果汇率需要动态调整，不要硬编码在合约里，可以单独做一个ExchangeRateState，让有权限的节点更新汇率值，合约从这个状态读取最新汇率。

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