Digital Assets Edition Enhancements

The enhanced version of Blockchain App Builder supports additional functions beyond those supported by the base version.

Oracle Blockchain Platform Digital Assets Edition includes an enhanced version of Blockchain App Builder and other functionality including sample applications to support wholesale central bank digital currency (CBDC), bond marketplaces, stablecoins, and generic token frameworks. For more information, see Oracle Blockchain Platform Digital Assets Edition.

The following functions are supported by the enhanced version of Blockchain App Builder.

• Automatic generation of complete chaincode applications for the following scenarios, which are described in Oracle Blockchain Platform Digital Assets Edition.
  • Wholesale CBDC Chaincode Package
  • Confidential Wholesale CBDC Chaincode Package
  • Stablecoin Chaincode Package
  • Bond Marketplace Chaincode Package
  • Fungible Token Framework Chaincode Package
  • Non-Fungible Token Framework Chaincode Package
  • Combined Token Framework Chaincode Package
• Automatic generation of wrapper API packages for API Gateway, with dedicated endpoints for each chaincode method. You can configure the names of the endpoints to match your organization's naming conventions. The following wrapper API packages are described in Oracle Blockchain Platform Digital Assets Edition.
  • Wholesale CBDC Wrapper API Package
  • Confidential Wholesale CBDC Wrapper API Package
  • Stablecoin Wrapper API Package
  • Bond Marketplace Wrapper API Package
  • Fungible Token Framework Wrapper API Package
  • Non-Fungible Token Framework Wrapper API Package
  • Combined Token Framework Wrapper API Package
• Support for chaincode events, which can send real-time notifications and trigger workflows. For more information, see Chaincode Events.
• Support for endorsement parameters in generated Postman collections. For more information, see Enhancements to Postman Collections.
• Support for chaincodes that use the extended Token Taxonomy Framework standard to restrict confidential or sensitive data so that it is accessible only to the organizations involved in the transaction. For more information, see Confidential Transactions Model.
• New account, role, and transaction functions in the extended Token Taxonomy Framework standard. For more information, see Token Taxonomy Framework Enhancements.
• Enhancements to the CLI and the Visual Studio Code extension UI, described in the following section.

CLI Enhancements

The ochain invoke command supports the following additional optional arguments.

Transient Map

Option: -t, --transient

Specifies key/value pairs for the transient map as a JSON string.

Example:

ochain invoke <method> 's01' 's10' \
  -r <remote OBP URL> -u <username> -s <password> \
  -t '{"key": "value"}'

Headers

Option: -H, --headers

Specifies additional headers as key/value pairs in JSON format. The Content-Type: application/json header is set by default and cannot be overridden. Do not include it in custom headers.

Example:

ochain invoke <method> 's01' 's10' \
  -r <remote OBP URL> -u <username> -s <password> \
  -H '{"confidential-transaction": "true"}'

Endorsers

Option: -e, --endorsers

Specifies endorser peer URLs to use as a JSON array of strings. You cannot use this option in combination with the -S, --sameorgendorser option to use endorsers from the same organization.

Example:

ochain invoke <method> 's01' 's10' \
  -r <remote OBP URL> -u <username> -s <password> \
  -e '["org1-xyz-abc.blockchain.ocp.oraclecloud.com:20009", "org1-xyz-abc.blockchain.ocp.oraclecloud.com:20010"]'

Same Organization Endorsers

Option: -S, --sameorgendorser

A Boolean flag that indicates whether to use endorsers from the same organization. You cannot use this option in combination with the -e, --endorsers option to specify endorsers.

Example:

ochain invoke <method> 's01' 's10' \
  -r <remote OBP URL> -u <username> -s <password> \
  -S true

The following example shows all of the optional parameters:

ochain invoke <method> 's01' 's10' \
  -r <remote OBP URL> -u <username> -s <password> \
  -H '{"confidential-transaction": "true"}' \
  -S false \
  -t '{"key": "value"}' \
  -e '["org1-xyz-abc.blockchain.ocp.oraclecloud.com:20009", "org1-xyz-abc.blockchain.ocp.oraclecloud.com:20010"]'

Visual Studio Code Extension Enhancements

The options for transient maps, headers, endorsers, and same organization endorsers are available in the Execute pane for remote environments. When you select a remote environment, the Show Advanced Options control is available. Click Show Advanced Options to set these options for the currently selected method (function). If you select a different method, the advanced options are reset.

For each advanced option, you can add and remove values and select or clear the options to include when the method is called. The Same Org Endorsers checkbox is available on the Endorsing Peers dialog box. If you select Same Org Endorsers, any endorsing peers that you specified manually are ignored. Instead the transaction will be endorsed by peers from the same organization as the user.

For confidential chaincodes, the Confidential-Transaction: true header is set by default for all methods in the Visual Studio Code extension. You can edit this header.