hyperledger-labs / convector

Smart Contract Systems the easy way. Open source development framework.

CONVECTOR SUITE

The Convector Suite is an Open Source Suite for Enterprise Blockchain Networks created and maintained by WorldSibu. It is composed of a group of Development tools for Hyperledger Fabric and aims to be an agnostic toolset.

WorldSibu is an enterprise development platform for private blockchain systems. Creators of the open source suite Convector, as well as the enterprise offering Forma, the blockchain infrastructure automation platform with multi-cloud capabilities.

The Convector Suite is targeted at beginners and experts alike. For newcomers to the blockchain world is the easiest and fastest way to create great code. For experts it's the means to efficiently create scalable and secure code. The Convector Suite follows modern coding paradigms and was built from the ground up to run in multiple ledger technologies.

The Convector Suite main components are:

• Convector Smart Contracts - JavaScript-based Development Framework for Enterprise Smart Contract Systems
• Hurley - the easiest way to quickly setup your Hyperledger development environment. Instead of learning all the config files required and navigating tons of yaml files, just do hurl new and focus on your smart contract.
• Convector CLI - the fastest and easiest way to build a new Convector Smart Contracts project. It is fully integrated with Hurley as well.
• Convector REST Server - a RESTful API generator from a Convector smart contract. One command and you can expose your smart contract to the world.

Some key links:

• Official Documentation site.
• Official tutorial for begginers
• Github code examples and Code examples directory
• Video tutorials

Have doubts, want to collaborate or just meet other Convector devs around the world? Join the Discord (Chat) Community

What is Convector Smart Contracts?

Convector is a JavaScript-based Development Framework for Enterprise Smart Contract Systems. Its goal is to make it easier for developers to create, test and deploy enterprise-grade blockchain-based systems by abstracting complexities that make it hard to get started, plus a collection of tools that speed up your go-to-market.

For now, we only support Hyperledger Fabric, so this documentation is for using Convector Smart Contracts on Hyperledger Fabric.

Model/Controller pattern. Convector is designed to help you write reusable pieces of code that describe the nature of what a developer can do in a blockchain. A blockchain, in the developer’s eyes, is no more than a data layer protected by a logic layer defining the rules of what the outside world can do in with the inner data. Thus, a really comfortable way of writing chaincode logic (smart contracts) is by having Models describing the shape of the data and Controllers describing the actions and rules that apply to the models.

Create your first blockchain project

Make sure you meet the pre-requisites.

npm i -g @worldsibu/convector-cli
conv new car
cd car
npm install

# Start your local blockchain network
npm run env:restart

# Install the smart contract
npm run cc:start -- car

# Send your first transaction to the blockchain - Wait a few seconds!
hurl invoke car car_create '{"id":"car1","name":"jetta", "created":1,"modified":1}'

# See your new record created in the blockchain by visiting: http://localhost:5084/_utils/#database/ch1_car/_all_docs

Then, you can visit the official Docs Site, automatically add a REST API, or build it and deploy it to an enterprise blockchain network.

Assumptions

This documentation assumes that you are familiar with JavaScript, TypeScript, and Hyperledger Fabric (at least the basics!).

Are you looking for an option to Hyperledger Composer?

Yes, we are also aware that Composer's development has experienced some changes and a lot of people are facing uncertainty. If you are one of the devs looking for a way to create smart contract systems with native chaincodes in JavaScript, you are in the right place. You may find this resource valuable on how to Migrate from Composer to Convector.

Support

• Product Hunt profile
• For recommendations, feature requests, or bugs go to our issues section.
• News on Convector, subscribe to our Newsletter
• Need support? Chat directly with our team, join our Discord