This repo contains a number of starter applications and smart contracts to help you get started quickly.
You'll need a development environment; Ubuntu or CentOS are good choices; especially if you can run them in VMs.
- One option is to use vagrant to setup your own VM - use this example from @jtonline
- If you have a CentOS or Ubuntu system - here some scripts that show the fastest way to get setup
Get the following extensions depending on your preference of langauge
And the essential
-
code --install-extension ibmblockchain.ibm-blockchain-platform
Clone this repo using git
cd a/suitable/directory/for/coding
git clone https://github.com/hyperledgendary/hackathon-starter.git
Open VSCode, within that open the workspace that is within the hackathon-starter directory.
Do you have a domain in mind? Supply chain for example, or financial asset transfer? It is important to have a domain and scenario in mind, most scenarions are asset based in some way hence the starter applications are based around assets.
Within the solution, there will be contracts and applications. There are basic examples of both of these within this repo and in different langauges. The basic examples are designed to work with each other.
Here are some suggested tutorials to start to understand what you can do.
- Within the IBM Blockchain Platform Extension there are some starter tutorials; worth doing these as they show you how the extension can help you develop.
- It is worth reviewing this longer tutorial https://hyperledger-fabric.readthedocs.io/en/latest/developapps/developing_applications.html
The VSCode extension will ONLY see Contract packages at the root of the workspace. Therefore if you wish to use one of the examples, add the folder directory to the top of the root of the workspace. (right click in the workspace and select 'Add Folder to Workspace...' and then navigate to the contract to use).
When running a client application example, export the Connection Profile and Local wallet to a directory local to the application. For example a _cfg directory within the application. Load the Connection Profile and wallet from there into the application.
It is recommended to use the VSCode extensions to start a running Fabric Infrastructure and to use that to install the contracts.
In the applications there is a _cfg directory, the examples are setup to assume that you've exported the connection profile and wallet from VSCode to that directory.