Bond Marketplace用のラッパーAPIのデプロイおよびテスト
Wrapper APIパッケージのデプロイ
ラッパーAPIパッケージをデプロイする前に、必要な構成変数を更新する必要があります。一部の構成変数にはデフォルト値がありますが、プレースホルダを含む変数をデフォルト値として手動で更新する必要があります。構成変数は、ラッパーAPIアーカイブのterraform.tfvarsファイルに格納されます。ラッパーAPIのデプロイおよび構成変数の詳細は、卸売CBDCラッパーAPIパッケージおよびOracle Blockchain Platformのブロックチェーン・アプリケーション・ビルダーのラッパー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 |
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メソッドを使用して、参加している金融機関の役員(たとえば、FI-1 Bond Issuer)にminterロールを割り当てます。 - 金融機関役員(債券発行者)は、
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コレクションには、ボンド・マーケットプレイス・チェーンコードをサポートする追加属性およびメソッドが含まれています。次の表に、Bond Marketplaceパッケージに固有のPostmanコレクション変数を示します。
| 可変 | 説明 | デフォルト値 |
|---|---|---|
bc-instance-client-id |
Oracle Blockchain Platformクラウド・サービスのクライアントID。 | bc-instance-client-id |
bc-instance-client-secret |
Oracle Blockchain Platformクラウド・サービスのクライアント・シークレット。 | bc-instance-client-secret |
int-app-client-id |
Oracle Identity Cloud Service (IDCS)機密アプリケーションのクライアントID。CreateIDCSユーザーAPIでIDCSユーザーを作成するために使用されます。
|
アプリケーション内クライアントID |
int-app-client-secret |
IDCS機密アプリケーションのクライアント・シークレット。CreateIDCSユーザーAPIでIDCSユーザーを作成するために使用されます。
|
アプリケーション・クライアント内シークレット |
詳細は、Oracle Blockchain Platformのブロックチェーン・アプリケーション・ビルダーのラッパーAPIパッケージ・コンポーネントを参照してください。