1. Oracle Blockchain Platform Digital Assets Edition
  2. Create an Instance

2 Create an Instance

As an Oracle Cloud Infrastructure administrator, you can create and set up an Oracle Blockchain Platform Digital Assets Edition instance for your organization.

Before You Create Your Instance

Before you set up Oracle Blockchain Platform Digital Assets Edition using Oracle Cloud Infrastructure Console, Oracle recommends that you take some time to plan your service.

Create a Cloud Account

Activate your Oracle Blockchain Platform Digital Assets Edition and sign in to Oracle Cloud Infrastructure.

Create a Compartment

When you sign up for Oracle Cloud Infrastructure, Oracle creates your tenancy with a root compartment that holds all your cloud resources. You then create additional compartments within the tenancy (root compartment) and corresponding policies to control access to the resources in each compartment. Before you create an Oracle Blockchain Platform instance, Oracle recommends that you set up the compartment where you want the instance to belong.

You create compartments in Oracle Cloud Infrastructure Identity and Access Management (IAM). See:

Plan Your Instance

Editions and Shapes

There are three shapes of Oracle Blockchain Platform Digital Assets Edition available:
  • Medium: 8 OCPUs, 150 GB storage, 4 peers (additional can be added later)
  • Large: 16 OCPUs, 150 GB storage, 6 peers (additional can be added later)
  • X-Large: 32 OCPUs, 150 GB storage, 6 peers (additional can be added later)

If you create a Digital Assets shape, you can scale your Blockchain Platform up or down resulting in a new shape called Digital Assets Custom. See Scale Your Instance for details.

Platform Versions

You can also select which platform version to use, which will determine if your network is running on Hyperledger Fabric v1.4, v2.2, or v2.5. Oracle Blockchain Platform Digital Assets Edition only supports Hyperledger Fabric v2.5 or later.

Billing

Oracle Blockchain Platform OCPU-based meters use high precision billing, meaning that you are billed per second. The minimum billing amount is for one minute; any instance running for less than one minute will still be charged for one minute of time.

For pricing estimates, you can enter your services and resources into the OCI cost estimator: OCI Service Cost Estimator

Create an Oracle Blockchain Platform Digital Assets Edition Instance Using the Console

As an Oracle Cloud Infrastructure administrator, you can create and set up an Oracle Blockchain Platform Digital Assets Edition instance for your organization.

There are two types of Oracle Blockchain Platform instances you can provision:

  • Founder organization: a complete blockchain environment, including a new network to which participants can join later on.

  • Participant instance: if there is already a founder organization you want to join, you can create a participant instance if your credentials provide you with access to the network.

  1. Sign in to your Oracle Cloud Infrastructure account. You must sign in as a federated Oracle Identity Cloud Service user.
  2. In the Console, click the Navigation menu in the top-left corner.
  3. Under Developer Services, select Blockchain Platform.
  4. From the Compartment list, select the compartment in which you want to create the service.
  5. Click Create Blockchain Platform.
  6. Enter a name for your Oracle Blockchain Platform instance.
    The service instance name:
    • Must contain one or more characters.
    • Must not exceed 15 characters.
    • Must start with an ASCII letter: a to z or A to Z.
    • Must contain only ASCII letters or numbers.
    • Must not contain a hyphen.
    • Must not contain any other special characters.
    • Must be unique within the identity domain.
  7. Optionally enter a description of your instance.
  8. Select your platform version. This specifies the version of Hyperledger Fabric you want your instance to run on. The founder and participants must all be on the same version of Hyperledger Fabric.
  9. Select if you are creating a new network, or creating a participant instance to join an existing network.
  10. Select the Oracle Blockchain Platform Digital Assets edition and the appropriate shape. The editions and shapes are described in Plan Your Instance.
  11. Oracle Blockchain Platform includes a certificate authority (CA), which is used to create self-signed certificates for all blockchain nodes in your instance.

    If you want to use certificates from your own certificate authority and use the Oracle Blockchain Platform certificate authority as an intermediary CA, you can upload your CA archive. The certificate you upload will be used to sign the intermediary certificates for Oracle Blockchain Platform nodes, thus including them under your root CA chain.

    The archive is a zip file which contains the following files:
    • CA chain - named ca-chain.pem. The entire CA file sequence from the signing CA to the top-level CA should be present.
    • key - named ca-key.pem. The key should be a 256-bit elliptic curve key. The prime256v1 curve is recommended.
    • certificate - named ca-cert.pem
    The archive must be less than 2MB. The files must directly reside inside the zip archive such that when the archive (.zip) is unzipped, the files are visible in the current directory at the same level as the archive (.zip) file. The files should not be present inside a nested directory inside the archive.
  12. If you want to use tags for your instance, expand the Advanced Options section and add your tags.
  13. Click Create.

It takes about 15 minutes to create the service. Display the Instance page to check the current status.

Verify Your Instance

Navigate to your service in the Oracle Cloud Infrastructure console, and sign in to verify that your Oracle Blockchain Platform Digital Assets Edition instance is up and running.

For more information about signing into the Oracle Cloud Infrastructure console, see Signing In to the Console.

  1. On the Oracle Cloud Infrastructure console, click the Navigation menu in the top-left corner.
  2. Under Developer Services, select Blockchain Platform.
  3. From the Compartment list, select the compartment that you used to create the instance.
  4. Click the name of the new instance.
  5. Click Service Console. This launches the Oracle Blockchain Platform console.

Now that your instance is created, you can manage the instance itself as described in Manage the Lifecycle of an Instance.

You can also manage users, access and permissions as described in Set Up Users and Application Roles.

Digital Assets Page

All of the Oracle Blockchain Platform Digital Assets Edition functionality is available from the Digital Assets page in the console.

After you create an instance, click the Digital Assets tab to open the Digital Assets page. You can access the following panes from the Digital Assets page.

Wholesale CBDC Application
You can use the Wholesale CBDC Application pane to complete the following tasks. For more information, see Wholesale Central Bank Digital Currency Application.
  • Install, deploy, and invoke the wholesale CBDC sample chaincode online.
  • Download the wholesale CBDC sample chaincode package.
  • Download the wholesale CBDC wrapper API package.
  • Download database view definitions, which you can use for analytics and the pre-built web application.
  • Download the sample web application, built in Oracle Visual Builder, and workbooks for use with Oracle Analytics Cloud.
Bond Marketplace Application
You can use the Bond Marketplace Application pane to complete the following tasks. For more information, see Bond Marketplace Application.
  • Download the bond marketplace sample chaincode package.
  • Download the bond marketplace wrapper API package.
Fungible Token Framework
You can use the Fungible Token Framework pane to complete the following tasks.
Non-Fungible Token Framework
You can use the Non-Fungible Token Framework pane to complete the following tasks.
Combined Token Framework
You can use the Combined Token Framework pane to complete the following tasks.