Digital Assets Edition Enhancements

Oracle Blockchain Platform Digital Assets Edition includes an enhanced version of Blockchain App Builder.

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

  • Automatic generation of complete chaincode applications for wholesale CBDC and bond marketplace scenarios.
  • 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.
  • Support for chaincode events, which can send real-time notifications and trigger workflows.
  • Support for endorsement parameters in generated 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.
  • New account, role, and transaction functions in the extended Token Taxonomy Framework standard.
  • Enhancements to the CLI and the Visual Studio Code extension UI.

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.