为债券市场部署和测试包装器 API

部署包装器 API 程序包

必须先更新所需的配置变量,然后才能部署包装器 API 程序包。某些配置变量具有默认值,但您必须手动更新包含占位符作为其默认值的任何变量。配置变量存储在包装器 API 归档文件的 terraform.tfvars 文件中。有关部署包装 API 以及有关配置变量的更多信息,请参见包装器 API批发 CBDC 包装器 API 程序包。下表列出了债券市场包装器 API 程序包的配置变量及其默认值。

变量名称 默认值 说明
compartment_ocid <compartment_ocid> Oracle Cloud Infrastructure (OCI) 中区间的 OCID。
compartment_name <compartment_name> OCI 区间的名称。
identity_domain <identity_domain> 要使用的身份域。
blockchain_channel <blockchain_channel> 部署链代码的 Oracle Blockchain Platform 渠道的名称。
blockchain_url <blockchain_url> 与链代码部署关联的 Oracle Blockchain Platform URL。
idcs_url <idcs_url> Identity Cloud Service 的 URL。
idcs_port <idcs_port> Identity Cloud Service 的端口号。
cbdc_chaincode <cbdc_chaincode> 批发 CBDC 链代码的名称。
cbdc_channel <cbdc_channel> 部署批发 CBDC 链代码的渠道。
isolation_level <isolation_level> 原子事务处理的隔离级别。通常为 serializable
blockchain_chaincode WholesaleCBDC 要为其生成包装器 API 的链代码的名称。
blockchain_sync true 要包括在 API 调用的有效负载中的同步值。
blockchain_timeout 6000 要包括在 API 调用的有效负载中的超时值。
vcn_display_name WholesaleCBDC OCI 虚拟云网络的显示名称。
application_display_name WholesaleCBDC OCI 应用程序的显示名称。
gateway_display_name WholesaleCBDC API 网关的显示名称。
deployment_display_name WholesaleCBDC API 网关中部署的显示名称。
deployment_path_prefix /WholesaleCBDC API 网关中的部署路径前缀,用于指定路由的部署路径。deployment_path_prefix 变量必须以斜杠 (/) 开头。
ocir_repo_name wholesalecbdc OCI 注册表资料档案库名称。ocir_repo_name 变量必须全部为小写字母。
policy_name WholesaleCBDC 通过为组织内的组和区间定义的权限,可以进行受控管理和访问 API 的策略的名称

债券市场示例流程流

使用债券市场包装器 API 的典型流程流遵循以下基本步骤。
  1. 管理员使用 createUserAccountcreateTokenAccount 方法为所有用户创建单个 NFT 帐户。
  2. 管理员使用 addRole 方法将 minter 角色分配给参与金融机构的负责人(例如 FI-1 Bond Issuer)。
  3. 金融机构官员(债券发行人)使用 createBondToken 方法以小数 NFT 形式发行债券。
  4. 金融机构负责人使用 getTokenById 方法检查和确认已发行债券的详细信息。
  5. 债券购买者(例如 FI User)使用 atomicTransaction 方法调用 purchaseToken 方法来购买小数 NFT 债券,并使用批发 CBDC 链代码进行付款。
  6. 购买者使用 balanceOfBatch 方法验证其钱包中的债券收据。
  7. 购买者使用 getAccountBalance 方法(批发 CBDC 链代码)来确认其批发 CBDC 钱包中的转移。
  8. 债券发行人使用 atomicTransaction 方法调用 payInterest 方法,以使用批发 CBDC 链代码向债券持有人支付定期利息。
  9. 购买者使用 requestTokenRedemption 方法在债券到期后提交赎回其债券的请求。
  10. 金融机构负责人使用 atomicTransaction 方法调用 approveTokenRedemption 方法来批准赎回请求,并将批发 CBDC 资金转移给债券持有人。
  11. 债券持有人使用 balanceOfBatch 方法(债券市场链代码)和 getAccountBalance 方法(批发 CBDC 链代码)来验证债券是否已兑换,以及在批发 CBDC 钱包中收到资金。

Postman 集合

债券市场包装 API 包中的 Postman 集合包括支持债券市场链代码的其他属性和方法。有关更多信息,请参见 Wrapper API Package Components