Upgrading a CorDapp to Corda Enterprise Edition 4.8

Upgrading from Corda open source

Before upgrading to Corda Enterprise Edition 4.8, upgrade your CorDapp to Corda open source 4.8. See upgrading CorDapps to newer platform versions for detailed instructions.

You don’t need to re-compile your CorDapp to Corda Enterprise for it to run on Corda Enterprise. If you want your CorDapp to be compatible with nodes running open source, then compile it against Corda open source 4.x. However, if you want to leverage specific features of Corda Enterprise, such as third-party commercial database support, and don’t envisage your CorDapp being run in an open source production environment, then follow the re-compiling for Corda Enterprise Edition 4.8 guide.

Re-compiling for Corda Enterprise Edition 4.8

To re-compile your CorDapp for Corda Enterprise Edition 4.8, you need to:

1. Update your Gradle build file as follows.

corda_release_distribution = 'com.r3.corda'
corda_core_release_distribution = 'net.corda'
corda_release_version = '4.8'
corda_core_release_version = '4.8'
corda_gradle_plugins_version = '5.0.12'
kotlin_version = '1.2.71'
quasar_version = '0.7.13_r3'

2. Specify an additional repository entry pointing to the location of the Corda Enterprise distribution and Corda dependencies. Any dependencies on corda-core and/or corda-serialization must use the corda_core_release_distribution and corda_core_release_version. As Corda is moving to an open core model, these core APIs are only available in open source and need to be imported from there. Therefore, a repository entry pointing to a matching Corda open source version is required.

3. Update your quasar.jar file. If your project is based on one of the official CordApp templates, you’ll likely have a lib/quasar.jar file checked in. You’ll only use this if you use the JUnit runner in IntelliJ. In the latest release of the CorDapp templates, this directory has been removed.

For example:

repositories {
    // Example for Corda Enterprise
    maven {
        credentials {
            username "username"
            password "XXXXX"
        }
        url 'https://artifactory.mycompany.com/artifactory/corda-enterprise'
    }

    // Dependency on Corda open source
    maven { url 'https://download.corda.net/maven/corda-releases' }
    maven { url 'https://download.corda.net/maven/corda-dependencies' }

    // Corda dependencies for the patched Quasar version
    maven { url "https://download.corda.net/maven/corda-dependencies" } // access to the patched Quasar version
}

You can do either of the following:

• Upgrade your quasar.jar file to the version consistent with your Corda version.
• Delete your lib directory and switch to using the Gradle test runner.

You can find instructions for both options in running tests in Intellij.

4. Check you’re using Corda Gradle plugins version 5.0.12, and that Corda Enterprise dependencies are referenced with the right distribution.

For example:

cordaCompile "net.corda:corda-core:$corda_release_version"
testCompile "net.corda:corda-node-driver:$corda_release_version"

Becomes:

cordaCompile "$corda_core_release_distribution:corda-core:$corda_core_release_version" // core depends on open source
testCompile "$corda_release_distribution:corda-node-driver:$corda_release_version"     // node based tests from Enterprise

cordapp "$os_corda_release_distribution:corda-finance-contracts:$os_corda_release_version"

Upgrading from Enterprise 4.3 or earlier

Corda Enterprise Edition 4.4 moves towards an open core strategy. Therefore, the common APIs are only available in Corda open source, and Corda Enterprise has a binary dependency on the matching open source version. As a result, any CorDapps written against Corda Enterprise Edition 4.4 or later will have to depend on the open source version of corda-core.

Therefore, you have to add the following variables to your build configuration:

corda_core_release_distribution = 'net.corda'
corda_core_release_version = '4.8'

Any dependency on corda-core (or corda-serialization) has to use these new variables to depend on the open source version of those libraries, as follows:

cordaCompile "$corda_release_distribution:corda-core:$corda_release_version"

Becomes:

cordaCompile "$corda_core_release_distribution:corda-core:$corda_core_release_version"

Upgrading from Corda Enterprise 3.x

You can only upgrade to Corda Enterprise Edition 4.8 from a previous 4.x version. To upgrade from 3.x, first upgrade to 4.x and then to 4.8. For example, 3.3 to 4.5, and then 4.5 to 4.8.