为债券市场部署和测试包装器 API
部署包装器 API 程序包
必须先更新所需的配置变量，然后才能部署包装 API 软件包。某些配置变量具有默认值，但必须手动更新包含占位符作为其默认值的任何变量。配置变量存储在包装器 API 档案中的 terraform.tfvars 文件中。有关部署包装 API 和配置变量的更多信息，请参见 Wholesale CBDC Wrapper API Package 和 Wrapper APIs in Blockchain App Builder for Oracle Blockchain Platform 。下表列出了债券市场包装器 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 |
BondMarketplace |
要为其生成包装器 API 的链代码的名称。 |
blockchain_sync |
true |
要包括在 API 调用的有效负载中的同步值。 |
blockchain_timeout |
6000 |
要包括在 API 调用的有效负载中的超时值。 |
vcn_display_name |
BondMarketplace |
OCI 虚拟云网络的显示名称。 |
application_display_name |
BondMarketplace |
OCI 应用程序的显示名称。 |
gateway_display_name |
BondMarketplace |
API 网关的显示名称。 |
deployment_display_name |
BondMarketplace |
API 网关中部署的显示名称。 |
deployment_path_prefix |
/BondMarketplace |
API 网关中的部署路径前缀，用于指定路由的部署路径。deployment_path_prefix 变量必须以斜杠 (/) 开头。
|
ocir_repo_name |
bondmarketplace |
OCI 注册表资料档案库名称。ocir_repo_name 变量必须全部为小写字母。
|
policy_name |
BondMarketplace |
该策略的名称，通过为组织中的组和区间定义的权限来控制对 API 的管理和访问 |
债券市场示例流程流
使用债券市场包装器 API 的典型流程流遵循以下基本步骤。- 管理员使用
createUserAccount和createTokenAccount方法为所有用户创建单个 NFT 帐户。 - 管理员使用
addRole方法将 minter 角色分配给参与金融机构的负责人（例如FI-1 Bond Issuer）。 - 金融机构官员（债券发行人）使用
createBondToken方法以小数 NFT 形式发行债券。 - 金融机构负责人使用
getTokenById方法检查和确认已发行债券的详细信息。 - 债券购买者（例如组织用户）使用
atomicTransaction方法调用purchaseToken方法来购买小数 NFT 债券，并使用批发 CBDC 链代码进行付款。 - 购买者使用
balanceOfBatch方法验证其钱包中的债券收据。 - 购买者使用
getAccountBalance方法（批发 CBDC 链代码）来确认其批发 CBDC 钱包中的转移。 - 债券发行人使用
atomicTransaction方法调用payInterest方法，以使用批发 CBDC 链代码向债券持有人支付定期利息。 - 购买者使用
requestTokenRedemption方法在债券到期后提交赎回其债券的请求。 - 金融机构负责人使用
atomicTransaction方法调用approveTokenRedemption方法来批准赎回请求，并将批发 CBDC 资金转移给债券持有人。 - 债券持有人使用
balanceOfBatch方法（债券市场链代码）和getAccountBalance方法（批发 CBDC 链代码）来验证债券是否已兑换，以及在批发 CBDC 钱包中收到资金。
Postman 集合
债券市场包装 API 软件包中的 Postman 集合包括支持债券市场链代码的其他属性和方法。下表显示了特定于债券市场包的 Postman 集合变量。
| 变量 | 说明 | 默认值 |
|---|---|---|
bc-instance-client-id |
Oracle Blockchain Platform 云服务的客户端 ID。 | bc- 实例 - 客户机 - 标识 |
bc-instance-client-secret |
Oracle Blockchain Platform 云服务的客户端密钥。 | bc 实例 - 客户端 - 密钥 |
int-app-client-id |
Oracle Identity Cloud Service (IDCS) 机密应用程序的客户端 ID，用于在 CreateIDCS 用户 API 中创建 IDCS 用户。
|
int-app-client-id |
int-app-client-secret |
IDCS 机密应用程序的客户端密钥，用于在 CreateIDCS 用户 API 中创建 IDCS 用户。
|
内部应用程序客户端密钥 |
有关详细信息，请参阅 Blockchain App Builder for Oracle Blockchain Platform 中的 Wrapper API Package Components 。