为债券市场部署和测试包装器 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 的典型流程流遵循以下基本步骤。- 管理员使用
createUserAccount和createTokenAccount方法为所有用户创建单个 NFT 帐户。 - 管理员使用
addRole方法将 minter 角色分配给参与金融机构的负责人（例如FI-1 Bond Issuer）。 - 金融机构官员（债券发行人）使用
createBondToken方法以小数 NFT 形式发行债券。 - 金融机构负责人使用
getTokenById方法检查和确认已发行债券的详细信息。 - 债券购买者（例如
FI User）使用atomicTransaction方法调用purchaseToken方法来购买小数 NFT 债券，并使用批发 CBDC 链代码进行付款。 - 购买者使用
balanceOfBatch方法验证其钱包中的债券收据。 - 购买者使用
getAccountBalance方法（批发 CBDC 链代码）来确认其批发 CBDC 钱包中的转移。 - 债券发行人使用
atomicTransaction方法调用payInterest方法，以使用批发 CBDC 链代码向债券持有人支付定期利息。 - 购买者使用
requestTokenRedemption方法在债券到期后提交赎回其债券的请求。 - 金融机构负责人使用
atomicTransaction方法调用approveTokenRedemption方法来批准赎回请求，并将批发 CBDC 资金转移给债券持有人。 - 债券持有人使用
balanceOfBatch方法（债券市场链代码）和getAccountBalance方法（批发 CBDC 链代码）来验证债券是否已兑换，以及在批发 CBDC 钱包中收到资金。
Postman 集合
债券市场包装 API 包中的 Postman 集合包括支持债券市场链代码的其他属性和方法。有关更多信息，请参见 Wrapper API Package Components 。