Skip to content
This repository has been archived by the owner on Mar 8, 2020. It is now read-only.

v0.18.0

Pre-release
Pre-release
Compare
Choose a tag to compare
@fabric-composer-app fabric-composer-app released this 05 Mar 19:39
· 334 commits to master since this release

Composer v0.18.0

Welcome to Hyperledger Composer v0.18.0. Brace yourself, breaking changes are coming! As always with breaking changes, we try to ensure that any breaking change comes with a solid benefit, and the version bump benefits in this release are certainly worth it. 👍

There are two key features in this release:

  1. The ability to specify a cloud based business network card wallet location. Yes, that's right ... you can specify a non-local file system location for where you would like your business network card store to be. We have documentation on this feature that we urge you to check out, within the documentation we also have some example implementations. So why would you want to check this out? Fundamentally this facilitates the creation and operation of cloud based applications... which is quite a big thing really. 💯
  2. We have changed dependencies to use the Fabric Release Candidate (RC1) 🎉

Having softened the breaking change blow with the above features, now is probably a good time to mention that we have changed to using the public key instead of certificate as the identifier for identities. Sorry-not-sorry 😚

The mystery of the moving docs. 🔎 📚 We have two sets of documentation:

  • latest that follows v0.16.x branch and is the 'stable' release. This release enables the building of Business Networks on Hyperledger Fabric 1.0.
  • next that follows the master branch and currently enables the building of Business Networks on Hyperledger Fabric 1.1-preview/alpha
    We have now split the documentation to correspond with the above:
  • latest is on the URL /composer/latest/
  • next is on the URL /composer/next/

Because of the above, you are likely to see breaks in any bookmarks that you have - the 404 page contains a link back to the base documentation so you shouldn't be lost for long. But please ensure that you are looking at the correct documentation for the branch that you want to work from!

This is the release to build projects on top of Hyperledger Fabric v1.1-RC1; if you are looking to build on top of the Fabric v1.0, you will need to use the v0.16.x development stream.

Documentation for Hyperledger Composer is under the 'next' branch which can be found here

Documentation for 0.16.x can be found here

Features

✨ Big enough to be given a shout-out above, #3495 delivers the code for enabling a cloud wallet business network card store, which will facilitate the creation and management of cloud based applications. 👏 Documentation for this feature is delivered under #3502, which you really should check out ... and don't forget to look at the example implementations 👍
#3517, #3520 and #3526 deliver the upgrade to using the Fabric release candidate driver

Documentation

📖 #3502 delivers the documentation surrounding cloud wallets
📖 #3447 delivers a shiny new tutorial on using Google OAUTH2.0 for authentication against the REST server

Breaking Changes

💥 #3489 delivers the change that swaps us to using the public key instead of certificate as the identifier for identities in order to solve issues surrounding re-enrollment in Hyperledger Fabric. This change uses the public key (embedded in the certificate) as the identifier of the identity in the identity registry, which will not change across re-enroll operations. The new certificate will have the existing private key, which will still match the identifier of the identity in the identity registry.
💥 The upgrade to using the Fabric release candidate within #3517, #3520 and #3526, makes this release incompatible with previous Fabric deployments. In order to use this release, you will need to be using Fabric RC1.

Bug Fixes

A small number of bug fixes this week, but we feel that they were worth eliminating:
🐞 #3458 changes the flags being used within the angular generator so that it will successfully stand up a rest server during the full generation process.
🐞 #3444 enables the respecting of a default Enum value in a model file

Notes

⚠️ Business Network Cards are not transferable between v0.16.x and v0.17.x onwards. It will be necessary to manually clear your card store in order to use a different version. Please note that the CLI command to delete a named card will not work correctly if targeting a named card that was created from a different version.

⚠️ The Composer Tools is now setting up a Fabric1.1-RC1 network. Unfortunately only Composer v0.18.0 and above are (and will be) compatible with this alpha driver. There are multiple support splits across differing Fabric levels, so please be careful with what versions are being used:

  • v0.18.0 and above is compatible with the Fabric RC1 driver only
  • v0.17.3 -> v0.17.6 are compatible with Fabric alpha driver only
  • v0.17.0 -> v0.17.2 are compatible with Fabric preview driver only

Conga Comics

Oh yes ... a new release, fantastic features, a version bump and a new Conga Comic. What more could you want?! Big shout out to @EdMoffatt for yet another creation, in fact ... have some emojis too: 🌟 🥇 👍

image 2

Missed out on a Conga Comic, or want to catch up with them all? Fear not, you can view the complete Conga Comic collection at conga-comics