Composer v0.18.2

Welcome to Hyperledger Composer v0.18.2 👋 In this release we move to supporting Hyperledger Fabric v1.1 GA 🎉 so please do consider this change in support level when deploying your business networks - if unsure, check with the support level statement below 👍

In addition to the change in supported Hyperledger Fabric level, we have some extra treats in the form of features to help enhance your composing delight.

This is the release to build projects on top of Hyperledger Fabric v1.1 GA; 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

✨ #3569 New event handling system utilising the new fabric 1.1 channel event mechanism. This ensures that only events from the channel the business network is deployed on are emitted to listeners, it also adds reliability if the event source cannot be contacted. Finally only events for successfully comitted transactions are emitted (whereas before events were emitted regardless of transaction being committed or not) ✨ #3619 Ability to query other servers in the same organisation rather than be fixed to the same server if it cannot be communicated with ✨ #3610 improve the information around credentials when performing a Composer card list on a specific card ✨ #3599 Yo Business Network Generator improvements to give you ACL rules and cucumber tests for free ✨ #3604 New Icon for the Rest Server

Bug Fixes

🐞 #3609 Corrections to CTO modeling language docs (thanks to @npenzin 👍 ) 🐞 #3548 Corrections to BusinessNetworkConnection reference (thanks to @kenjisiu-ibmhk 👍 )

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 Fabric 1.1 GA network. Unfortunately only Composer v0.18.2 and above are (and will be) compatible with this version. There are multiple support splits across differing Fabric levels, so please be careful with what versions are being used:

• v0.18.2 and above is compatible with Fabric 1.1 GA only
• v0.18.0 -> v0.18.1 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

Good news to all CongaComic fans - whilst our resident artist @EdMoffatt is currently at a conference, we managed to secure the next comic in the series before he was permitted to set foot on the aircraft 👍

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

Composer v0.18.1

Welcome to Hyperledger Composer v0.18.1.

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

✨ #3528 exposes request to transaction processor functions, enabling the calling of HTTP or REST APIs from transaction processor functions. This allows you to move complex computation off the blockchain. For more information, please check out the updated documentation.

Community Contributions

Hyperledger Composer v0.18.0 delivered the ability to use cloud hosted wallets. This enables your wallet store to be held on a different local file location, or within a cloud based service. We would like to give a big shout out to @Rmannn for producing and open sourcing composer-wallet-s3, which is a Hyperledger Composer wallet implementation using Amazon S3 as the store. 👍

Bug Fixes

🐞 #3535 ensures that the Composer version is set within generated package files 🐞 #3538 ensures that the correct wallet is being used during a card import 🐞 #3550 enables the use of cards with certificates in the REST server when in multi-user mode

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

A release simply would not be the same without a CongaComic - fortunately our resident artist @EdMoffatt has completed the snow themed two-parter ⛄️

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

Composer v0.16.6

This is the release to build projects on top of Hyperledger Fabric v1.0; if you are looking to build on top of Fabric v1.1, you will need to use the v0.18.x development stream. A summary table of the latest Composer releases can be found on our main Wiki page here

Documentation for 0.16.x can be found here

Features

Two features in this release: ✨ #3564 upgrades Composer to use the Fabric 1.0.5 Node SDK ✨ #3493 adds a new NodeRed tutorial

Bug Fixes

🐞 #3560 fixes a regression in the REST server when in multi-user mode.

Conga Comics

A release simply would not be the same without a CongaComic - fortunately our resident artist @EdMoffatt has completed the snow themed two-parter ⛄️

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

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: 🌟 🥇 👍

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

Composer v0.16.5

This is the release to build projects on top of Hyperledger Fabric v1.0; if you are looking to build on top of Fabric v1.1, you will need to use the v0.17.x development stream. A summary table of the latest Composer releases can be found on our main Wiki page here

Documentation for 0.16.x can be found here

Features

Main feature in this release. ✨ #3475 Enhancement to Hardware Security Model (HSM) Support. The new enhancement enables client application to use the most restrictive Crypto User role of the HSM. 🎉

📖 Documentation for HSM can be found in our getting started guide contributing notes, for installing softhsm locally, and the connection profile page detailing the HSM support within a connection profile.

Build improvements with this release.

⚡️ #3471 Build checks for all required NPM modules before building the docker images

Conga Comics

A new release clearly needs a new CongaComic, and what the world needs is more Block Norris jokes. The good news is that we have a ready supply of both, crafted by our resident artist @EdMoffatt

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

Composer v0.17.6

This is the release to build projects on top of Hyperledger Fabric v1.1-alpha; 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 v0.17.x is under the 'next' branch which can be found here

Documentation for 0.16.x can be found here

Welcome to Hyperledger Composer v0.17.6. The highlight this week (spoiler alert) is a newly styled Angular generator for your business networks- keep your eyes open for additional features to the Angular generator over the next few weeks 👌

Features

As mentioned above, the key feature in this release is delivered within #3440: a newly styled Asset page that results from the Angular generator 😍 This delivery represents the first in the set of improvements that are being delivered under the Improvement Proposal for the Angular generator

Bug Fixes

Another week of eliminating code issues sees: ⚡️ #3417 adds a missing sha.js dependancy ⚡️ #3427 addresses uncaught errors within Playground ⚡️ #3443 updates error messages returned by the model manager

We have also updated the documentation with: 📖 #3424 adds information about endorsement policies during upgrade

Notes

⚠️ Business Network Cards are not transferable between v0.16.x and v0.17.x. 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-alpha network. Unfortunately only Composer v0.17.3 and above are (and will be) compatible with this alpha driver. Composer v0.17.3 and above are not compatible with the fabric preview driver. In the interest of being absolutely explicit:

• v0.17.3 and above are compatible with fabric alpha driver only
• v0.17.0 -> v0.17.2 are compatible with fabric preview driver only

Conga Comics

A newly styled Angular generator and a fresh new Conga Comic ... everybody loves release day. A big thanks to @EdMoffatt for another comic in the series, all the fans appreciate your efforts 👍

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

Composer v0.17.5

This is the release to build projects on top of Hyperledger Fabric v1.1-alpha; 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 v0.17.x is under the 'next' branch which can be found here

Documentation for 0.16.x can be found here

Welcome to Hyperledger Composer v0.17.5, which contains the addition of HSM support, schema validation of connection profiles when generating business network cards, runtime API extensions, linking of business network cards to the identity registry, and a host of bug fixes. Read the full notes for more details, then treat yourself to a Conga Comic once finished!

Features

Not content with enabling use of the native Fabric API in Transaction Processor Functions, we have more functionality coming in this release via: ✨ #3358 adds schema based validation of your connection profile when creating business network cards ✨ #3391 adds getCurrentIdentity() to the runtime API and ping response ✨ #3397 enables linking of business network cards to the identity registry ✨ #3395 adds HSM support to the master branch of Hyperledger Composer. HSM is hardware cryptographic engine and key store for storing private keys. Storing private keys in a HSM provides higher security 🔐

📖 Documentation for HSM can be found in our getting started guide contributing notes, for installing softhsm locally, and the connection profile page detailing the HSM support within a connection profile.

Bug Fixes

Not content with new features and functionality, the congas have been busy fixing bugs in the code, with the following pull requests being worthy of mention: ⚡️ #3379 and #3405 provide minor fixes within the documentation pages ⚡️ #3390 ensures that the .card extension is added during composer card export if one is not specified ⚡️ #3398 fixes the output for the setLogLevel CLI command ⚡️ #3396 is a playground fix to prevent errors being shown when modals are closed via the ESC key ⚡️ #3404 is a playground fix to prevent error output in the console when cancelling a transaction ⚡️ #3401 is a playground fix to prevent users from creating an identity with the same name as one that is activated

Notes

⚠️ Business Network Cards are not transferable between v0.16.x and v0.17.x. 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-alpha network. Unfortunately only Composer v0.17.3 and above are (and will be) compatible with this alpha driver. Composer v0.17.3 is not compatible with the fabric preview driver. In the interest of being absolutely explicit:

• v0.17.3 and above compatible with fabric alpha driver only
• v0.17.0 -> v0.17.2 compatible with fabric preview driver only

Conga Comics

Due to the release of HSM in the master branch, we feel that it is only appropriate to repeat the HSM themed Conga Comic featuring Block Norris, who legend has it, when adding blocks to the ledger, the entire ledger shifts left to accommodate them.

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

Composer v0.16.4

This is the release to build projects on top of Hyperledger Fabric v1.0; if you are looking to build on top of Fabric v1.1, you will need to use the v0.17.x development stream. A summary table of the latest Composer releases can be found on our main Wiki page here

Documentation for 0.16.x can be found here

Features

One main features in this release. ✨ #3339 and #3368 deliver Hardware Security Model (HSM) Support. HSM is hardware cryptographic engine and key store for storing private keys. Storing private keys in a HSM provides higher security. 🎉

📖 Documentation for HSM can be found in our getting started guide contributing notes, for installing softhsm locally, and the connection profile page detailing the HSM support within a connection profile.

Bug Fixes

Several bug fixes, build improvements and document updates with this release. ⚡️ #3267 and #3269 are documentation updates ⚡️ #3325 fix for composer network upgrade requiring business network name in the card ⚡️ #3326 fix to only add card to store on import only if identity import is successful

Conga Comics

A new release clearly needs a new CongaComic, and what the world needs is more Block Norris jokes. The good news is that we have a ready supply of both, crafted by our resident artist @EdMoffatt

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

Composer v0.17.4

This is the release to build projects on top of Hyperledger Fabric v1.1-alpha; 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 v0.17.x is under the 'next' branch which can be found here

Documentation for 0.16.x can be found here

Welcome to Hyperledger Composer v0.17.4 - this release has some major code and documentation features that we hope make your experience using Composer even better. Along with new tutorials, we have unlocked access to the full Fabric shim API within Transaction Processor Functions - but be careful... with great power comes great responsibility!

Features

Two main code features in this release, but two good ones ... we will let you decide your favourite 😉 We also have two new tutorials in place to help you get up to speed with Composer concepts faster 🐎

✨ #3277 enables the loading of model files from a URL, which means you can take advantage of the growing model file ecosystem 👍 A shout out to @dselman for this external contribution 🎉 ✨ #3318 is a significant feature. It exposes the Fabric shim API, meaning that you can directly call the shim API within your Transaction Processor Functions and gain access to any of the Fabric shim API features that you have been craving. This feature is documented via a tutorial and the reference guide for Transaction Processor Functions. It is safe to say that invoking the Fabric shim API within your TPFs falls firmly under 'power user' mode 🤖

📖 As mentioned above, we have a tutorial for calling the Fabric shim API directly within your Transaction Processor Functions 📖 Ever wanted a tutorial on the Access Control Language? Well good news ... we now have a tutorial for ACLs

Bug Fixes

A bug fixing delight this week, with issues being closed in the runtime, playground and the docs ... we are aiming to fix all of them (and new ones raised 😱 ) but if there is one that you have a particular interest in seeing addressed ... please inform us.

⚡️ #3228, #3294, #3279, #3327, #3321, and #3331 are documentation updates ⚡️ #3324 restricts card addition to the card store to only occur when identity import is successful. ⚡️ #3330 closes #2891 and #2411, addressing upgrade and add endorsement policy support ⚡️ #3354 closes #3353, preventing a modification to the CCP

Notes

⚠️ Business Network Cards are not transferable between v0.16.x and v0.17.x. 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-alpha network. Unfortunately only Composer v0.17.3 and above are (and will be) compatible with this alpha driver. Composer v0.17.3 is not compatible with the fabric preview driver. In the interest of being absolutely explicit:

• v0.17.3 and above compatible with fabric alpha driver only
• v0.17.0 -> v0.17.2 compatible with fabric preview driver only

Conga Comics

Not wanting to disappoint the Conga Comic fans, @EdMoffatt has another end-of-release-notes treat. If (as we suspect) you have skipped straight to the comic, please scroll back up and read the notes ... you could even treat yourself to following the shim API tutorial, after which you can claim new Jedi-like TPF powers 💪

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

Composer v0.17.3

This is the release to build projects on top of Hyperledger Fabric v1.1-preview; 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 v0.17.x is under the 'next' branch which can be found here

Documentation for 0.16.x can be found here

There is a big change in the underlying Fabric support that is now in place - please read the notes section below as this is likely to impact you.

Updates

✨ #3257 Updates the yo generator to use Node8 ✨ #3262 Updates the Composer runtime to use the Fabric 1.1-alpha driver ✨ #3261 Changes examples within the documentation to use Node8 syntax ✨ #3282 Adds a readme file for the composer-report module ✨ #3284 Adds documentation on using the angular generator 👍

Bug Fixes

🐝 #3209 Updates the connection profile within our tutorial documentation 🐝 #3243 Resolves issue #2937, which was preventing the addition of new assets to a registry obtained via a getRegistry() call 🐝 #3179 adds to the Ubuntu pre-reqs script to install unzip 🐝 #3286 Updates the playground card creation text to correctly reference the level of Fabric being used 🐝 #3284 Updates documentation to remove references to unsupported levels of Fabric

Notes

⚠️ Business Network Cards are not transferable between v0.16.x and v0.17.x. 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 will now be setting up a Fabric1.1-alpha network. Unfortunately only Composer v0.17.3 and above are (and will be) compatible with this alpha driver. Composer v0.17.3 is not compatible with the fabric preview driver. In the interest of being absolutely explicit:

• v0.17.3 and above compatible with fabric alpha driver only
• v0.17.0 -> v0.17.2 compatible with fabric preview driver only

Conga Comics

Another Conga Comic from our resident artist @EdMoffatt, who this week finds himself having to break into reality in order to raise the bar from the already favourite 'darth-conga edition' ...

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