Releases: hyperledger-archives/composer
v0.17.2
Composer v0.17.2
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.
A new reporting tool and some minor documentation edits this week as we work on the improvement proposals ... if you want to see what we are planning and help suggest criteria, then please do read and contribute to them 👀
New Features
This release includes an experimental reporting tool that should help us diagnose configuration issues by retrieving system information relating to the node environment. It is bundled in with the composer CLI and can be run via the command composer report.
Bug Fixes
Fixes this week are restricted to documentation enhancement:
🐝 #3180 fixes a grammatical error in the API documentation (well spotted @ElOpio 👍 )
🐝 #3159 fixes a link in our documentation to point to the 'next' version of Composer Playground
🐝 #3103 rectifies an out of date reference in the contributing guide and improves the identity-issue reference documentation (thanks @Navdevl 👍 )
Notes
Conga Comics
Now the staple of the release notes, our resident artist @EdMoffatt has set the bar to a record block height with the latest issue. Quite simply hyper-legendary.
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
v0.17.1
Composer v0.17.1
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.
Bug Fixes
Some minor bug fixes this week as we work on the improvement proposals ... if you want to see what we are planning and help suggest criteria, then please do read and contribute to them 👍
Fixes this week are restricted to documentation enhancement:
🐝 #3145 updates the information in our multi-org tutorial
🐝 #3163 updates a global reference in the developer tutorial
🐝 #3166 updates and enhances the multi-org tutorial
Notes
Conga Comics
A new release clearly needs a new CongaComic, and true to form our resident artist @EdMoffatt has mined another gem.
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
v0.17.0
Composer V0.17.0
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.
This release contains numerous breaking changes:
🎉 Targets Hyperledger Fabric v1.1-preview
🎉 We now use native NodeJS
🎉 We use a common connection profile
Now that you have been suitably warned, you might be thinking "why would I be interested in this version?". Well, the breaking changes are exactly why you would want to be using this version! In fact, read more about the above changes within the features section below 👍
Features
✨ The Hyperledger Fabric v1.1-Preview images permit the use of native nodeJS code execution, a feature that we have been desperate to take advantage of ... and now we do! We have completely changed the way in which the composer chaincode is deployed and executed within Fabric. Doing this has enabled us to drop the use of Ductape, meaning that we have removed a significant limitation with regards to performance in terms of execution speed and memory usage.
✨ With the uptake of node8, it is now possible to use node8 syntax in your transaction processor functions - we have updated the sample networks to show how this can be done if you are not familiar with the syntax. Please make sure that you are using the correct version of Node 👍
✨ Composer has been updated to make use of Hyperledger Fabric common connection profiles. We have updated our tutorials to show how to deploy a Hyperledger Composer blockchain business network to Hyperledger Fabric for both single and multiple organizations. These tutorials explain how the common connection profile can be created to target a Hyperledger Fabric topology.
Notes
Conga Comics
A new release would simply not be the same without a new CongaComic, and true to form our resident artist has produced a new edition to satisfy the growing fan base.
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
v0.16.3
Composer V0.16.3
This is the recommended release to build projects on top of Hyperledger Fabric v1.0, if you are looking to build on top of the Fabric v1.1-preview, you will need to use the v0.17.x development stream.
Bug Fixes
Minimal bug fixes in this release, minor fixes include:
🐞 #3085 Gives Abstract types to the loopback connector, which enables correct Java client generation
🐞 #3090 Enables dynamic logging
🐞 #3097 Adds identity identifiers into error messages
🐞 #3107 Prevents the existence of multiple 'same' business network definitions
🐞 #3110 Adds transaction IDs to logging information
Conga Comics
For those that may have missed the Christmas CongaComic special, fear not ... all the comics are kept very safe. Besides, we would hate for you to miss an @EdMoffatt creation!
Missed out on a Conga Comic, or want to catch up with them all? You can view the complete Conga Comic collection at conga-comics
v0.16.2
Composer V0.16.2
This is the recommended release to build projects on top of Hyperledger Fabric v1.0, if you are looking to build on top of the Fabric v1.1-preview, you will need to use the v0.17.x development stream.
Documentation changes
So last week we announced that we are going to be working on two branches: the stable 0.16.x stream and the 0.17.x development stream. This week we have made changes to enable documentation availability for both of these branches as they diverge.
Bug Fixes
Minimal bug fixes in this release, minor fixes include:
🐞 #2959 Fixes a minor styling issue with an SVG
🐞 #2906 Fixes a minor issue in the Playground, where the last business network to be accessed was displayed in the login page.
Conga Comics
I think we can now safely assume that there cannot be a release without a Conga Comic. With this in mind, we locked our resident artist @EdMoffatt in a room and refused to let him out until he produced the next in the series.
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
v0.16.1
Composer V0.16.1
This is the recommended release to build projects on top of Hyperledger Fabric v1.0, if you are looking to build on top of the Fabric v1.1-preview, you will need to use the v0.17.x development stream.
Documentation changes
So last week we announced that we are going to be working on two branches: the stable 0.16.x stream and the 0.17.x development stream. This week we have made changes to enable documentation availability for both of these branches as they diverge.
Bug Fixes
Minimal bug fixes in this release, minor fixes include:
🐞 #2959 Fixes a minor styling issue with an SVG
🐞 #2906 Fixes a minor issue in the Playground, where the last business network to be accessed was displayed in the login page.
Conga Comics
I think we can now safely assume that there cannot be a release without a Conga Comic. With this in mind, we locked our resident artist @EdMoffatt in a room and refused to let him out until he produced the next in the series.
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
v0.16.0
Composer V0.16.0
Welcome to v0.16.0 of Hyperledger Composer. In a break from tradition, we are making a Tuesday release. Don't worry, we have not gone totally crazy though... apart from @nklincoln 😉
If you have not read it yet, we recommend that you read this mailing list post that explains these plans:
https://lists.hyperledger.org/pipermail/hyperledger-composer/2017-November/000044.html
Hyperledger Composer v0.16.0 is a feature complete, stable release that users can use to build their projects on top of Hyperledger Fabric v1.0. We strongly recommend that you use this release and any subsequent bug fix releases (v0.16.1, v0.16.2) to build your projects on top of Hyperledger Fabric v1.0. 💪 🥇 👍
In the mean time, we're gearing up to deliver the changes that will move the development stream for Hyperledger Composer onto Hyperledger Fabric v1.1-preview, and completely break compatibility with Hyperledger Fabric v1.0. 💥
The development stream is gonna start getting a bit unstable from v0.17.0 onwards, so once again; we strongly recommend that you use this release and any subsequent bug fix releases (v0.16.1, v0.16.2) to build your projects on top of Hyperledger Fabric v1.0. Have I said it enough times yet? 😁 👍
Before we cut Hyperledger Composer v0.16.0, we wanted to ensure that it was super shiny, so the primary content of this release is related to documentation and bug fixes... including a fix to a nasty regression that @sstone1 put in 🐧
Documentation changes
- We have changed the API reference to be completely contained within the Main documentation pages, and we no longer have links to the 'old-style' API reference.
- We have updated the REST server documentation for deploying the REST server.
Bug Fixes
Fixes in this release include
- 🐞 #2840 Enables the import of models with transactions that extend transactions in other namespaces.
- 🐞 #2865 Prevents the undeploy of a Business Network in the web profile if deleting a Business Network Card when other cards for the same network exist.
Conga Comics
Not wanting to disappoint the fans, and to make the point that the change here is essentially a version bump, @EdMoffatt has an equivalent contribution to #CongaComics... an essential part of the release notes!
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
v0.15.2
Composer V0.15.2
Welcome to v0.15.2 of Hyperledger Composer. The Congas have been busy tackling issues to help perfect your Composing experience this week and consequently this release contains no breaking changes 👍
Tutorials
Following from last weeks tutorial extension, you can now find a tutorial on how to deploy Composer to a multi-organisation Hyperledger Fabric. We would encourage you to look through this 📖
Known Issues
Bug Fixes
Lots of code commits this week, delivering some significant improvements. We'd like to point out up front that we have put Composer on a Thanksgiving diet, and we now have a unified Business Network Card store between the runtime and Playground UI. Of course there are lots of other items worthy of mention, with some cherry-picked items for you here:
🐞 #2761, #2762 and #2763 deliver memory utilisation improvements through modifications to ductape
🐞 #2769 and #2785 are the first set of changes related to optimising ACL rule execution
🐞 #2770 and #2774 are some very welcome contributions from @lucasdf to fix broken links and formatting issues 👍
🐞 #2771 enables the use of multiple conditions in a 'where' clause when using query
🐞 #2781 prevents hangs within a hosted Playground when loading sample models if there is no internet connection
🐞 #2783, #278, #2795 and #2804 are runtime changes to help improve Composer performance 🐎
🐞 #2614 and #2807 enable Playground to use the same Business Network Card store as the runtime. This change really deserves some more words attributed to it, since we can't emphasise enough just how important this is. In fact, have an emoji too 🏅
🐞 #2814 makes some edits to the documentation
🐞 #2607 Prevents extending types from overriding identifiers in super types
🐞 #2823 updates the one line installer to work with cards
Conga Comics
Not wanting to disappoint the fans, @EdMoffatt has another addition to #CongaComics... an essential part of the release notes!
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
v0.15.1
Composer V0.15.1
Hello and welcome to v0.15.1 of Hyperledger Composer. This release contains no breaking changes, nor new code features. The Congas have been busy tackling issues to help perfect your Composing experience.
Tutorials
There is a new tutorial within the documentation, which relates to configuring your very own single organisation Composer network on Hyperledger Fabric. It explains the use of crypto-material, building connection profiles, creating Administrative Business Network Cards, installing the Composer runtime, and starting a Business Network ... we urge you to check it out in order to get a deeper understanding of how to create your own bespoke deployments, and look out for an inbound multi-organisation tutorial 👍
Sharing Business Network Cards
Sharing cards with other users
If you are running a fabric locally on your machine using our fabric development server or via our one line installer, the connection profile for these environments will either have urls of localhost or have urls specific to a local docker network referencing the locally running fabric on your machine. This means you cannot share your business network cards with other users to be able to have them connect to your business network running on your machine.
Ensuring cards can be shared
To ensure a card can be shared with another user (see above) or with other components of Hyperledger Composer you must
- Import the card
- Ping the business network using that card
- Export the card with a new name. This is the card you can now share
Known Issues
We have come across permission denied mkdir .... errors when trying to import a business network card into playground when moving between native and docker systems. This is a known issue (#2675) that the Congas will be working on as a priority
Bug Fixes
This week the Congas have been busy tackling as many issues as possible. Those of relevance for mention include:
🐞 #2661 introduces more accessible buttons in the Playground Identity Registry
🐞 #2697 fixes the Playground update button enablement for edge case business network states
🐞 #2595 enables the handling of concepts and enums in the serialiser
🐞 #2670 adds a tooltip hover text to show the fully qualified Participant name in the Playground Identity Registry
🐞 #2704 fixes an identity bind issue, enabling the specification of a certificate at point of call
🐞 #2728 enables the use of CONTAINS within an operator in a query file, accessed via the REST server.
🐞 #2707 fixes a bug in the CLI command for identity request
🐞 #2724 enables the retrieval of a set of fully resolved objects through query
🐞 #2717 changes the way in which you can interact with the side navigation on the Documentation ... no more automatic expands 👍
🐞 #2616 enables the use of Playground when you have no internet connection 😱
Conga Comics
Thanks to @EdMoffatt for making yet another addition to #CongaComics... your reward for reading the release notes!
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
v0.15.0
Composer V0.15.0
Hello and welcome to v0.15.0 of Hyperledger Composer. This release contains breaking changes around the administrative access for the runtime as well as an upgrade to to Node8. Whilst you may not be able to asynch-await the CongaComic, please promisify that you read the details of these changes.
Features
✨ Business Network Cards within the CLI. Playground users will already be familiar with the concept of Business Network Cards. These have now been applied throughout Composer and are now used by the runtime components. The consequence of this is that all CLI commands have been changed to reference --card instead of a named connection profile and identity. This is a disruptive change, but now the model is consistent through the complete Hyperledger Composer stack, which ties Composer Playground and the runtime together very nicely indeed 👍
Being such a large change, we have an updated tutorial that takes you through the basic use of the business network cards with the command line, and of course the CLI reference documentation has been updated to match the changes 📖
✨ Just like the CLI, the Composer REST Server now makes use of ... yup, you guessed it - Business Network Cards! Business Network Cards are now the only way that you can connect to and use the REST Server, as demonstrated nicely by the updated developer tutorial
✨ Node8 has now entered LTS, which makes it the default version of node used when following our installation guide. We have now updated the code base to use Node 8.9, and we will be making use of all the benefits that this level of NodeJS provides 🎉
If you have previously configured your system following the Composer guides, you can upgrade your version of NodeJS using the command nvm install --lts.
Business Network Card Notes
👉 Currently the Playground and runtime use separate file stores, this means that if you were to import a Business Network Card in Playground, it will not show up when running a composer card list command from the CLI.
👉 Business Network Cards created and generated while using our dev server can only be shared on the same machine. Equally, cards created and generated from docker playground and rest-server can only be shared on docker containers in the same network (also cards between environments 2 and 3 cannot be shared either even if on the same machine). By 'shared', we mean to convey the ability to use the same card across the Composer stack, and/or for multiple persons to use the same card concurrently (subject to connection profile restrictions).
👉 Business Network Cards that only contain secrets are not shareable. To guarantee a card can be shared perform the following steps:
composer card import(if the card has not been imported already)composer network pingusing the cardcomposer card export
The resulting card can be shared (subject to above restrictions)
👉 Due to the change in Business Network Cards, we recommend that when upgrading, you should delete all existing connection profiles and credentials that exist under ~/.composer-connection-profiles and ~/.composer-credentials
Bug Fixes
Not content with delivering business network card continuity across Composer, the congas have been busy tackling as many issues as possible. These include:
🐞 #2575 and #2554 relate to fixes for the default json generation when testing business networks in Playground.
🐞 #2597 prevents errors being thrown in Playground if you have made breaking changes to a model file, having already created Resources from the (now invalid) model. You will not be able to see them, but you will be able to continue working with the new definitions.
🐞 #2637 enables support for Passport usernames that contain an @ character within the REST server
Conga Comics
Never one to disappoint, our resident artist @EdMoffatt has a fresh new addition to the expanding #CongaComics collection... just make sure you have read the release notes first!
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