Playground Tutorial
In this step by step tutorial we'll walk through setting up a business network, defining our assets, participants and transactions, and testing our network by creating some participants and an asset, and submitting transactions to change the ownership of the asset from one to another.
Step One: Open the IBM Blockchain Platform: Develop Playground
Open Blockchain Platform Playground. You should see the My Business Network screen. The My Business Networkpage shows you a summary of the business networks you can connect to, and the identities you can use to connect to them. Don't worry about this too much for the time being, as we're going to create our own network.
Step Two: Creating a new business network
Next, we want to create a new business network from scratch. A business network has a couple of defining properties; a name, and an optional description. You can also choose to base a new business network on an existing template, or import your own template.
Click Deploy a new business network under the Web Browser heading to get started.
The new business network needs a name, let's call it
tutorial-network
.Optionally, you can enter a description for your business network.
Next we must select a business network to base ours on, because we want to build the network from scratch, click empty-business-network.
Now that our network is defined, click Deploy.
Step Three: Connecting to the business network
Now that we've created and deployed the business network, you should see a new business network card called adminfor our business network tutorial-network in your wallet. The wallet can contain business network cards to connect to multiple deployed business networks.
When connecting to an external blockchain, business network cards represent everything necessary to connect to a business network. They include connection details, authentication material, and metadata.
To connect to our business network click Connect now under our business network card.
Step Four: Adding a model file
As you can see, we're in the Define tab right now, this tab is where you create and edit the files that make up a business network definition, before deploying them and testing them using the Test tab.
As we selected an empty business network template, we need to define our business network files. The first step is to add a model file. Model files define the assets, participants, transactions, and events in our business network.
For more information on our modeling language, check our documentation.
Click the Add a file button.
Click the Model file and click Add.
Delete the lines of code in the model file and replace it with this:
/**
* My commodity trading network
*/
namespace org.acme.mynetwork
asset Commodity identified by tradingSymbol {
o String tradingSymbol
o String description
o String mainExchange
o Double quantity
--> Trader owner
}
participant Trader identified by tradeId {
o String tradeId
o String firstName
o String lastName
}
transaction Trade {
--> Commodity commodity
--> Trader newOwner
}This domain model defines a single asset type
Commodity
and single participant typeTrader
and a single transaction typeTrade
that is used to modify the owner of a commodity.
Step Five: Adding a transaction processor script file
Now that the domain model has been defined, we can define the transaction logic for the business network. Composer expresses the logic for a business network using JavaScript functions. These functions are automatically executed when a transaction is submitted for processing.
For more information on writing transaction processor functions, check our documentation.
Click the Add a file button.
Click the Script file and click Add.
Delete the lines of code in the script file and replace it with the following code:
/**
* Track the trade of a commodity from one trader to another
* @param {org.acme.mynetwork.Trade} trade - the trade to be processed
* @transaction
*/
function tradeCommodity(trade) {
trade.commodity.owner = trade.newOwner;
return getAssetRegistry('org.acme.mynetwork.Commodity')
.then(function (assetRegistry) {
return assetRegistry.update(trade.commodity);
});
}This function simply changes the
owner
property on a commodity based on thenewOwner
property on an incomingTrade
transaction. It then persists the modifiedCommodity
back into the asset registry, used to storeCommodity
instances.
Step Six: Access control
Access control files define the access control rules for business networks. Our network is simple, so the default access control file doesn't need editing. The basic file gives the current participant networkAdmin
full access to business network and system-level operations.
While you can have multiple model or script files, you can only have one access control file in any business network.
For more information on access control files, check our documentation.
Step Seven: Deploying the updated business network
Now that we have model, script, and access control files, we need to deploy and test our business network.
Click Update to deploy the changes to our business network.
Step Eight: Testing the business network definition
Next, we need to test our business network by creating some participants (in this case Traders), creating an asset (a Commodity), and then using our Trade transaction to change the ownership of the Commodity.
Click the Test tab to get started.
Step Nine: Creating participants
The first thing we should add to our business network is two participants.
Ensure that you have the Trader tab selected on the left, and click Create New Participant in the upper right.
What you can see is the data structure of a Trader participant. We want some easily recognizable data, so delete the code that's there and paste the following:
{
"$class": "org.acme.mynetwork.Trader",
"tradeId": "TRADER1",
"firstName": "Jenny",
"lastName": "Jones"
}Click Create New to create the participant.
You should be able to see the new Trader participant you've created. We need another Trader to test our Tradetransaction though, so create another Trader, but this time, use the following data:
{
"$class": "org.acme.mynetwork.Trader",
"tradeId": "TRADER2",
"firstName": "Amy",
"lastName": "Williams"
}
Make sure that both participants exist in the Trader view before moving on!
Step Ten: Creating an asset
Now that we have two Trader participants, we need something for them to trade. Creating an asset is very similar to creating a participant. The Commodity we're creating will have an owner property indicating that it belongs to the Trader with the tradeId of TRADER1
.
Click the Commodity tab under Assets and click Create New Asset.
Delete the asset data and replace it with the following:
{
"$class": "org.acme.mynetwork.Commodity",
"tradingSymbol": "ABC",
"description": "Test commodity",
"mainExchange": "Euronext",
"quantity": 72.297,
"owner": "resource:org.acme.mynetwork.Trader#TRADER1"
}After creating this asset, you should be able to see it in the Commodity tab.
Step Eleven: Transferring the commodity between the participants
Now that we have two Traders and a Commodity to trade between them, we can test our Trade transaction.
Transactions are the basis of all change in a IBM Blockchain Platform: Develop business network, if you want to experiment with your own after this tutorial, try creating another business network from the My Business Networkscreen and using a more advanced business network template.
To test the Trade transaction:
Click the Submit Transaction button on the left.
Ensure that the transaction type is Trade.
Replace the transaction data with the following, or just change the details:
{
"$class": "org.acme.mynetwork.Trade",
"commodity": "resource:org.acme.mynetwork.Commodity#ABC",
"newOwner": "resource:org.acme.mynetwork.Trader#TRADER2"
}Click Submit.
Check that our asset has changed ownership from
TRADER1
toTRADER2
, by expanding the data section for the asset. You should see that the owner is listed asresource:org.acme.mynetwork.Trader#TRADER2
.To view the full transaction history of our business network, click All Transactions on the left. Here is a list of each transaction as they were submitted. You can see that certain actions we performed using the UI, like creating the Trader participants and the Commodity asset, are recorded as transactions, even though they're not defined as transactions in our business network model. These transactions are known as 'System Transactions' and are common to all business networks, and defined in the IBM Blockchain Platform: Develop Runtime.
Logging out of the business network
Now that transactions have successfully run, we should log out of the business network, ending up at the My Business Network screen where we started.
- In the upper-right of the screen is a button labelled admin. This lists your current identity, to log out, click adminto open the dropdown menu, and click My Business Networks.
What next?
You've completed the initial IBM Blockchain Platform: Develop Playground tutorial, you might want to either begin building your own business network using our other samples or templates.
You might want to try the Developer Tutorial, to get your local development environment setup, generate a REST API and a skeleton web application.
Or you can run IBM Blockchain Platform: Develop Playground locally connected to a real instance of Hyperledger Fabric.
Playground Tutorial的更多相关文章
- blockchain notes
1. IBM blockchain platform https://www.ibm.com/blockchain/platform/ 2. 开源项目hyperledger https://hyper ...
- The IBM Blockchain Platform:Installing the development environment
Follow these instructions to obtain the IBM Blockchain Platform: Develop development tools (primaril ...
- ReactiveCocoa Tutorial
ReactiveCocoa Tutorial – The Definitive Introduction: Part 1/2 ReactiveCocoa教程——明确的介绍:第一部分(共两部分) As ...
- [翻译+山寨]Hangfire Highlighter Tutorial
前言 Hangfire是一个开源且商业免费使用的工具函数库.可以让你非常容易地在ASP.NET应用(也可以不在ASP.NET应用)中执行多种类型的后台任务,而无需自行定制开发和管理基于Windows ...
- Django 1.7 Tutorial 学习笔记
官方教程在这里 : Here 写在前面的废话:)) 以前学习新东西,第一想到的是找本入门教程,按照书上做一遍.现在看了各种网上的入门教程后,我觉得还是看官方Tutorial靠谱.书的弊端一说一大推 本 ...
- thrift 服务端linux C ++ 与客户端 windows python 环境配置(thrift 自带tutorial为例)
关于Thrift文档化的确是做的不好.摸索了很久才终于把跨linux与windows跨C++与python语言的配置成功完成.以下是步骤: 1) Linux下环境配置 ...
- 窥探Swift编程之在Playground上尽情的玩耍
自从苹果公司发布Swift的时候,Xcode上又多了一样新的东西---"Playground".Playground就像操场一样,可以供我们在代码的世界里尽情的玩耍,在本篇博客中就 ...
- Hive Tutorial(上)(Hive 入门指导)
用户指导 Hive 指导 Hive指导 概念 Hive是什么 Hive不是什么 获得和开始 数据单元 类型系统 内置操作符和方法 语言性能 用法和例子(在<下>里面) 概念 Hive是什么 ...
- Home / Python MySQL Tutorial / Calling MySQL Stored Procedures in Python Calling MySQL Stored Procedures in Python
f you are not familiar with MySQL stored procedures or want to review it as a refresher, you can fol ...
随机推荐
- BUPT复试专题—找最小数(2010)
https://www.nowcoder.com/practice/ba91786c4759403992896d859e87a6cd?tpId=67&tqId=29645&rp=0&a ...
- zabbix之Low-level discovery(自动发现)
功能: 自动发现挂载点并自动监控 自动发现网卡并自动监控 创建自动发现挂载点并监控 功能 假如要在monitor_linux模板中创建自动发现挂载点的功能 配置-->模板-->选择模板-- ...
- HDU 4791 Alice's Print Service 水二分
点击打开链接 Alice's Print Service Time Limit: 2000/1000 MS (Java/Others) Memory Limit: 32768/32768 K ( ...
- 系统去掉 Android 4.4.2 的StatusBar和NavigationBar
1. System Bar简单介绍 在Android4.0 (API Level 14)及更高版本号中.System Bar由Status Bar<位于顶部>和Navigation Bar ...
- CodeForces 318D Ants
题目链接 题意: 有n仅仅蚂蚁和m次询问 n仅仅蚂蚁初始所有位于起点(0,0)处.每4仅仅蚂蚁在同一格就会以该格为中心向上下左右四个方向爬一格 一仅仅向上,一仅仅向下,一仅仅向左.一仅仅向右 假设每一 ...
- layer弹出层不居中解决方案,仅显示遮罩,没有弹窗
问题:项目中layer询问层的弹窗仅显示遮罩层,并不显示弹窗…… 原因:图片太多将layer弹窗挤出屏幕下方,看不见了…… 解决方案:让layer的弹出层居中显示 一.问题描述 用layer做操作结果 ...
- Arcgis Engine(ae)接口详解(1):featureClass
//IFeatureClass 来源请自行解决 IFeatureClass featureClass = null; //获取featureClass的各种名称 //PS:featureClass可以 ...
- 项目Beta冲刺(团队7/7)
项目Beta冲刺(团队7/7) 团队名称: 云打印 作业要求: 项目Beta冲刺(团队) 作业目标: 完成项目Beta版本 团队队员 队员学号 队员姓名 个人博客地址 备注 221600412 陈宇 ...
- WPF DataGrid 获取选中 一行 或者 多行
WPF中DataGrid使用时,需要将其SelectedItem转换成DataRowView进行操作 然而SelectedItem 与SelectedItems DataGrid的SelectionU ...
- LeetCode题解(13)--Roman to Integer
https://leetcode.com/problems/roman-to-integer/ 原题: Given a roman numeral, convert it to an integer. ...