Professional Documents
Culture Documents
PDF Blockchain in Action 1St Edition Bina Ramamurthy Ebook Full Chapter
PDF Blockchain in Action 1St Edition Bina Ramamurthy Ebook Full Chapter
Ramamurthy
Visit to download the full and correct content document:
https://textbookfull.com/product/blockchain-in-action-1st-edition-bina-ramamurthy/
More products digital (pdf, epub, mobi) instant
download maybe you interests ...
https://textbookfull.com/product/blockchain-in-action-1st-
edition-bina-ramamurthy-2/
https://textbookfull.com/product/analyzing-blockchain-in-
healthcare-applicability-and-empirical-evidence-of-blockchain-
technology-in-health-science-1st-edition-chaudhary/
https://textbookfull.com/product/ethiopian-migrant-domestic-
workers-migrant-agency-and-social-change-bina-fernandez/
https://textbookfull.com/product/docker-in-action-1st-edition-
jeff-nickoloff/
Scalatra in Action 1st Edition Dave Hrycyszyn
https://textbookfull.com/product/scalatra-in-action-1st-edition-
dave-hrycyszyn/
https://textbookfull.com/product/akka-in-action-1st-edition-
raymond-roestenburg/
https://textbookfull.com/product/mesos-in-action-1st-edition-
roger-ignazio/
https://textbookfull.com/product/nim-in-action-1st-edition-
dominik-picheta/
https://textbookfull.com/product/redux-in-action-1st-edition-
marc-garreau/
IN ACTION
Bina Ramamurthy
MANNING
Blockchain in Action
BINA RAMAMURTHY
MANNING
SHELTER ISLAND
For online information and ordering of this and other Manning books, please visit
www.manning.com. The publisher offers discounts on this book when ordered in quantity.
For more information, please contact
Special Sales Department
Manning Publications Co.
20 Baldwin Road
PO Box 761
Shelter Island, NY 11964
Email: orders@manning.com
Many of the designations used by manufacturers and sellers to distinguish their products are
claimed as trademarks. Where those designations appear in the book, and Manning
Publications was aware of a trademark claim, the designations have been printed in initial caps
or all caps.
Recognizing the importance of preserving what has been written, it is Manning’s policy to have
the books we publish printed on acid-free paper, and we exert our best efforts to that end.
Recognizing also our responsibility to conserve the resources of our planet, Manning books are
printed on paper that is at least 15 percent recycled and processed without the use of elemental
chlorine.
ISBN 9781617296086
Printed in the United States of America
1 2 3 4 5 6 7 8 9 10 – SP – 24 23 22 21 20 19
I dedicate this book to my grandmother, Thanjavur Avva,
for her unconditional love and affection to me,
and compassion and generosity to everyone.
brief contents
PART 1 GETTING STARTED WITH BLOCKCHAIN PROGRAMMING .............1
1 ■ Blockchain basics 3
2 ■ Smart contracts 22
3 ■ Techniques for trust and integrity 54
4 ■ From smart contracts to Dapps 79
v
contents
Preface xv
Acknowledgments xvii
About this book xviii
About the author xxii
About the cover illustration xxiii
1 Blockchain basics
1.1
3
From Bitcoin to blockchain 4
1.2 What is a blockchain? 6
1.3 Blockchain programming 8
Decentralized infrastructure 8 ■
Distributed ledger technology 11
Disintermediation protocol 14 ■
Trust enabler 15
1.4 Motivating scenarios 16
Automatic and consistent data collection 17 Timely information
■
1.5 Retrospective 19
1.6 Summary 20
vii
viii CONTENTS
2 Smart contracts
2.1
22
The concept of a smart contract 23
Bitcoin transactions versus smart contract transactions 24 ■
What
does a smart contract do? 25
2.2 Design of a smart contract 25
A use case diagram for the counter 26 Data assets, peer ■
and testing 46
2.8 Smart contract design considerations 52
2.9 Best practices 52
2.10 Summary 53
3.3 Testing 70
Positive tests 71 ■
Negative tests 72
3.4 Using modifiers, require(), and revert() 73
3.5 Assert() declarations 74
CONTENTS ix
Testing with the web UI 138 Accessing on-chain data using the
■
interest 190
7.5 Retrospective 191
7.6 Best practices 191
7.7 Summary 192
CONTENTS xi
application 205
8.5 Deploying BlindAuction-Dapp on Infura 206
Setting up the blind auction environment 206 Decentralized ■
9 Tokenization of assets
9.1 Ethereum standards
227
228
Ethereum improvement proposal 229 ERC20 token ■
xv
xvi PREFACE
technical editor and began this book project: Blockchain in Action. The project took two
years to complete. I realize that a print book project with hands-on examples is different
from a MOOC—much more complex and challenging. But here it is: the completed
product. I enjoyed every minute I spent writing this book, and the effort was worth it.
I liked thinking about blockchain concepts, exploring them, discovering useful prob-
lems to solve, and then describing them to an audience that is not in front of me.
Because blockchain is an emerging technology, few resources are available to help
practitioners get started with application development in this area. This book
addresses that need. This book covers end-to-end development of blockchain-based
Dapp. I chose to use the Ethereum blockchain platform because its code is open
source. Tools such as the Solidity compiler for smart contracts, the Remix IDE for
exploration, the Truffle suite of tools for Dapp development and testing, the test
chains Ganache and Ropsten, Infura for cloud deployment of smart contracts, and
the MetaMask wallet have worked well for my team for the past four years. These tools
work in unison to provide seamless learning as well as a prototyping environment.
I hope you enjoy reading the book as much as I did creating its content.
Acknowledgments
I’d like to thank my family for supporting me through this challenging project, espe-
cially my husband, Kumar, for his encouragement and unwavering support through
the years. I also would like to thank our daughters Nethra and Nainita for being my
cheerleaders throughout this project.
Next, I’d like to acknowledge the team at Manning: Christina Taylor, my develop-
ment editor; Deirdre Hiam, my project editor; Keir Simpson, my copy editor; Melody
Dolab, my proofreader; Kyle Smith, my technical development editor; Ivan Martinović,
my review editor; and the reviewers, whose feedback made this contents of this book
useful and technically sound: Alessandro Campeis, Angelo Costa, Attoh-Okine Nii,
Borko Djurkovic, Christophe Boschmans, Danny Chin, David DiMaria, Frederick Schil-
ler, Garry Turkington, Glenn Swonk, Hilde Van Gysel, Jose San Leandro, Krzysztof
Kamyczek, Luis Moux, Michael Jensen, Noreen Dertinger, Richard B. Ward, Ron
Lease, Sambasiva Andaluri, Sheik Uduman Ali M, Shobha Iyer, Tim Holmes, Victor
Durán, and Zalán Somogyváry. Special thanks to the technical proofreader, Valentin
Crettaz, who ran the code and gave me some valuable feedback on the Dapps and
token standards.
I thank all my students and research team members, who have been my source of
inspiration with their relentless eagerness to learn about blockchain.
xvii
About this book
Blockchain in Action is a comprehensive resource for designing and developing
blockchain-based decentralized applications (Dapps). The resources in this book will
help you get started with smart contracts and blockchain application development.
The book provides enough details to help you understand blockchain without going
into theoretical material.
The design and development of smart contracts and Dapps are illustrated by seven
applications, each focusing on a certain aspect of blockchain. Several essential tools
(Remix, Ganache, MetaMask, Truffle, Ropsten, and Infura) and techniques (encryp-
tion and digital signing) are introduced to demonstrate the development and deploy-
ment of Dapps on the Ethereum test chain. The core ideas of blockchain—trust and
integrity, security and privacy, on-chain and off-chain data, and operations—are cov-
ered in detail with examples. The blockchain concepts are explained with more than
150 annotated figures and screenshots.
The codebase provided for the six fully developed Dapps is a valuable resource for
blockchain application developers. The development of smart contracts and Dapps is
explained in an incremental fashion. A standard directory structure and single-page
web UI help you quickly configure, migrate, and transact with the Dapps. You may find
some of the chapters to be lengthy, because a new blockchain concept is introduced
with a Dapp and explained further with a second Dapp. Special techniques (such as off-
chain and on-chain data), design principles, and best practices round up the explora-
tion to offer a clear roadmap to robust smart contract and Dapp development.
xviii
ABOUT THIS BOOK xix
Chapter 7 focuses on the web3 API of Ethereum that enables web applications to
access the underlying blockchain services. The blockchain side-channel concept is
introduced to illustrate the use of web3 in a micropayment channel (MPC) applica-
tion for massive plastics cleanup (MPC-Dapp).
Chapter 8 discusses deploying the smart contracts developed on a public cloudlike
infrastructure called Infura. Infura is a web3 provider, and a gateway to public block-
chains such as Ropsten (mainnet and IPFS). Public deployment on Infura and Rop-
sten is illustrated by deploying MPC and blind auction smart contracts.
Part 3 (chapters 9–12) is about expanding your view of the Ethereum Dapps eco-
system with tokens, Ethereum standards, automated testing, and a roadmap for real-
world application development.
Chapter 9 is about the tokenization of digital assets. A RES4-Dapp, a real estate
token, is developed based on the Ethereum standard for non-fungible token ERC721.
Chapter 10 is fully dedicated to writing test scripts and running them by using Truf-
fle’s JS-based testing frameworks. Automated test script writing is illustrated by three
smart contracts already discussed in the book: counter, ballot, and blind auction.
Chapter 11 provides an end-to-end roadmap of all the concepts, tools, and tech-
niques discussed so far and brings them together in an application for educational
credentialing: DCC-Dapp.
Chapter 12 reviews the road ahead, which is strewn with challenges, and explores
the fantastic opportunities for you to contribute.
Two appendices are provided to help you with the design process.
Appendix A offers a refresher on design representation using Unified Modeling
Language (UML). It illustrates structural, behavioral, and interaction modeling and
diagrams that are used in the design of smart contracts.
Appendix B captures the design principles introduced in the book for guiding
blockchain application development.
In general, a reader should start with chapter 1 and move sequentially through chap-
ter 8. The chapters in part 3 can be explored in any order of interest. Chapter 10 (on
testing), for example, can be read any time after chapter 5. I encourage you to do so.
A developer who wants to be proficient in smart contract design and Dapp devel-
opment should try to follow along with the code examples in the chapters and learn
from them.
Source code for the examples in this book is available for download from the pub-
lisher’s website at https://www.manning.com/books/blockchain-in-action.
xxii
About the cover illustration
The figure on the cover of Blockchain in Action is captioned “Fille de Bulgarie,” or “Bul-
garian Girl.” The illustration is taken from a collection of dress costumes from various
countries by Jacques Grasset de Saint-Sauveur (1757–1810), titled Costumes de Différents
Pays, published in France in 1788. Each illustration is finely drawn and colored by
hand. The rich variety of Grasset de Saint-Sauveur’s collection reminds us vividly of
how culturally apart the world’s towns and regions were just 200 years ago. Isolated
from one another, people spoke different dialects and languages. In the streets or in
the countryside, it was easy to identify where they lived and what their trade or station
in life was just by their dress.
The way we dress has changed since then, and the diversity by region, so rich at the
time, has faded away. It is now hard to tell apart the inhabitants of different conti-
nents, let alone different towns, regions, or countrieis. Perhaps we have traded cul-
tural diversity for a more varied personal life—certainly for a more varied and fast-
paced technological life.
At a time when it is hard to tell one computer book from another, Manning cele-
brates the inventiveness and initiative of the computer business with book covers
based on the rich diversity of regional life of two centuries ago, brought back to life by
Grasset de Saint-Sauveur’s pictures.
xxiii
Part 1
In the latter part of 2008 and early 2009, centralized systems of the world’s financial
markets—enabled by large intermediaries such as banks and investment firms—
failed and began to crumble. Trust in these systems eroded, and panic set in all
over the world with the collapse of financial markets. It was at this juncture that a
mysterious person or persons introduced to the world a working model of a peer-
to-peer decentralized digital currency system (with no central authority or adminis-
tration) called Bitcoin. The trust intermediation in this system was realized via soft-
ware that would later be named blockchain. Blockchain provided the software-based
verification, validation, recording, and integrity essentials for currency transfers.
Even though Bitcoin appeared to have launched suddenly in 2009, the idea of a
working digital currency has been a quest since the dawn of computing. Bitcoin’s
3
4 CHAPTER 1 Blockchain basics
Blue skies and sunshine and a rippling silver sea, all nature
jocund and gay, and for the first time in her young life Meriel was
unresponsive to the appeal. The romance had gone out of life. The
man she had learned to love was a thief—a thief. She told herself
fiercely that she no longer loved him, that she had never loved him,
but the ache at her heart gave the lie to the declaration.
The perpetual ache at her heart! If she could only have shared
the burden with Mrs. Marven, taken advantage of her Aunt's
sympathetic counsel, sobbed out her trouble and her despair on that
motherly breast, the pain would have been easier to bear. But she
could not do that. Thief though he was, Meriel could not betray Guy's
confidence.
Mrs. Marven wondered at the girl's reticence. Yet she waited in
patience for the confidence which was not yet given. Sooner or later
she felt it would be given to her. Her husband had told her of Guy's
conversation with him. She gathered that no ordinary blow had
shattered her darling's romance, and, though she longed to counsel
and to comfort, to mingle her tears with Meriel's, yet she did not
press her for the confidence which was withheld.
Yet, though the girl suffered, she strove to put her misery from
her, to busy herself with trivial duties. She went to the garden, but
she could not remain amongst the flowers. Her glance fell on a rose
Guy had tied. Now it was battered by the storm, and shapeless—like
her romance. She passed through the garden, across the meadow,
and on to the sea-wall. She desired to be alone, that was all. She
strolled idly along, unseeing anything but the tide slowly rising over
the mud, quite unconscious of the approach of an acquaintance.
Mr. Hildebrand Flurscheim had recognised Meriel while yet
some distance away, and had hastened his footsteps. He had
wondered that she was alone, but congratulated himself on the fact,
for then Guy would probably be alone, too. He wanted a private
conference with Guy. He, too, had been troubled greatly in his
thoughts during the previous day and night. Ever since Cornelius
Jessel had revealed to him the fact that one item of his missing
property was in Guy's possession, he had been rejoicing in the
thought that vengeance on his spoliators was soon to be within his
reach. Not that he wholly trusted the valet's word. The shadow-man
was not possessed of a confidence-inspiring personality, but the man
had not asked for any cash on account for the information he had
furnished. Flurscheim judged that the informer must have been quite
convinced as to the truth of his information, or he would not have
been so confiding. Flurscheim had arranged with him to secure the
miniature so that he might identify it. After that his course would be
simple. The police would do the rest. He blessed the lucky chance
which had brought him to recognise the strange likeness which
existed between Meriel and the missing miniature. But for that
curious coincidence he might never have had the opportunity of
getting on the track of his missing treasures.
Meriel had been correct in her intuition when she read another
meaning in his warning to Guy to beware of the approaching storm.
He could not resist the jest. But then the events which had
immediately followed played havoc with his plans and projects.
Guy had saved his life. Would the man who had robbed him
have done that? Hildebrand Flurscheim set great store by his life.
When he felt himself falling, when the water closed over his head, a
great horror possessed him. He struggled madly, blindly, against the
fearful thing. Then a strong hand had gripped him. He had still
struggled until dimly he had comprehended that a cool voice was
commanding him to be still, telling him that he was safe. The words
repeated again and again had impressed themselves upon his
consciousness. He had ceased to struggle. He had trusted entirely to
the strong hand which supported him. Then, he knew not how, other
hands had lifted him up and taken him into a boat. He had opened
his eyes and seen Guy clamber up over the stern, had heard him
say, "Not much the matter, eh, Mr. Flurscheim?"
The experience seemed to have lasted hours. He said little, but
he had insisted, when Guy was put aboard the Witch, on shaking the
young man's hand. And when, afterwards, the horror of those
moments returned to him there was renewed in his mind the feeling
of gratitude to his preserver. He was glad that it was in his power to
repay in some measure the debt of gratitude he owed. Guy had
given his life. Well, he could give Guy liberty. Yet he was not
altogether satisfied in his mind. He had no reason for thinking that
Guy had worked single-handed, and he saw no reason why other
parties should be participants in his gratitude. Yet, rather than Guy
should suffer, all the guilty parties should escape. Certainly the
experience of being at hand-grips with death had wrought a
wonderful change in Mr. Hildebrand Flurscheim's views, for it was
with this determination in his mind that he left his yacht, intending to
call at the Hall and tell Guy of Jessel's communication, and of his
determination not to act upon the information.
Not until he was a yard away and he spoke, did Meriel
recognise the connoisseur. A shadow of annoyance crossed her
face. This man seemed to her to be the cause, though a perfectly
innocent cause, of Guy's undoing. She bowed slightly, and would
have passed by, but Flurscheim stood in her path.
"Pardon me, Miss Challys," he said, "can you tell me where I
can find Mr. Guy Hora? I have something of importance to say to
him."
There was a shade of agitation in his voice. Meriel was startled.
Again the thought came to her, "Did he suspect Guy? Was that the
explanation of the presence of himself and his yacht at Whitsea?"
She strove to answer steadily.
"Mr. Hora left for London by the first train this morning."
An exclamation of annoyance escaped Flurscheim. "It is most
important that I should see him at once. Most important. Will you
give me his address? I must send him a wire immediately."
The colour left her face. She trembled. She was sure now that
Flurscheim knew who had robbed him of his treasures, that his
anxiety was due to the fear lest the robber should escape him. How
could she warn Guy? How could she refuse to supply Flurscheim
with the address he asked? Even if she were to refuse, her aunt or
uncle would give it. They knew of no reason why it should be kept
secret.
Flurscheim saw her hesitation, and a strange suspicion
germinated in his mind. "Surely she is not one of the gang," he
thought.
His intent gaze increased her discomposure. His suspicions
increased. He ventured a bold stroke.
"I wish to make some return for the service Mr. Hora has
rendered me," he said quietly. "Facts have come to my knowledge
which go to show that he is in considerable danger. If you do not
trust me, will you convey to him the warning?"
Again she looked at him doubtingly. "You would be his friend?"
she asked amazedly.
"If Mr. Hora will allow me," he answered, and seeing that she
still hesitated, he continued earnestly. "Will you not believe me, Miss
Challys, when I say that I would do anything in my power to save Mr.
Hora from a fate which would mean absolute ruin to him. May I go so
far as to say that if you are in the slightest degree interested in his
welfare you will not waste any time in communicating to him the
message I will give you."
There was a deep feeling expressed more in his tone than the
words he used. Instinctively Meriel felt that he was to be trusted.
"I will give you Guy—Mr. Hora's address," she remarked. "I
cannot communicate with him myself."
"Why—I thought——" he remarked and paused.
Meriel did not pretend to misunderstand the swiftly checked
exclamation. She shook her head sadly.
"I am a very unhappy girl, Mr. Flurscheim," she said, and despite
her efforts tears mounted to her eyes.
"There! There! There! Say no more," interrupted the
connoisseur hastily. "Misunderstandings will occur between young
people."
Meriel again shook her head. "Yesterday Mr. Hora told me
something regarding himself which I could not have suspected; part
of what he told me concerned you, Mr. Flurscheim, and—so he has
gone."
"Then the miniature did not come into his possession by
accident!" ejaculated Flurscheim. "And all the time I was hoping that
it had."
"No," said Meriel. "It was no accident." The words slipped from
her. Flurscheim realised that she knew all about the robbery. He
began to question her eagerly, but she would answer him nothing.
Already she had been betrayed into a confidence which she
regretted, and when he realised her difficulty, he ceased to ask for
details.
"It makes no difference in my intentions," he said. "Whether Mr.
Hora was himself the burglar who stole my picture and the
miniatures, or whether he was only one of the parties who handled
them afterwards, would make no difference to my course of action. If
he is warned immediately there will be time for him to clear out of the
way. If not——" He shrugged his shoulders expressively.
"But why?" asked Meriel.
Flurscheim repeated the story Jessel had told him.
"I can keep the man's mouth closed for a certain time," he said,
"but sooner or later he will blab it out, and once the police get on the
track——" Again he shrugged his shoulders.
Meriel was more than ever amazed at the Jew's attitude. She let
some of her surprise escape in speech.
"You, knowing where some of your valuables are, are willing to
forego all chance of their recovery, to let the—the thief—go
unpunished? You who everybody says had determined to spend the
whole of the rest of your life on the recovery."
The Jew spread out the palms of his hands in a
characteristically racial gesture.
"The rest of my life," he said. "My life would have been ended
yesterday but for Mr. Guy Hora. Strange as it may seem, life is very
good in my eyes. I might never have known how good but for my
accident. It was slipping away and he gave it back to me. That was a
debt which I must repay. Miss Challys, never yet have I failed to
meet every obligation that I have incurred. Ask Christian or Jew who
has ever had dealings with me if Hildebrand Flurscheim has ever
failed to take up his bond when it became due."
She murmured something about the nobility of his attitude, but
he would not accept any such complimentary description.
"It is just my business point of view," he remarked drily.
"Suppose I put the value of the pictures at fifty thousand pounds.
Personally I would give double that amount for my life, though I
should very much doubt whether anybody else would give as many
pence."
Laughter and tears strove for mastery in her face.
"You have greatly relieved my mind, Mr. Flurscheim," she said
softly. "Though I shall never see Mr. Hora again, yet I—I could not
bear to think of him in prison."
"You had better see him again, and quickly, too, if you want to
keep him out of it," snapped the Jew promptly in response. "It will
want a woman's hand to do that, and from what I have observed you
are about the only person in the world who has half a chance of
succeeding."
The direct attack, voicing the thought she had striven to
suppress, brought the colour surging to her cheeks. "Don't you
understand," she cried. "He is a thief—a thief."
"He seems to be a rare plucky one anyway," answered
Flurscheim. Meriel laughed hysterically. "There! There! There!" said
the connoisseur in his most soothing manner, "I didn't mean to hurt
you, and I can see you are very much upset. Perhaps we will talk
over this bad business later and see what we can manage between
us."
There was so much kindness in his manner, so real a delicacy in
his whole attitude, that Meriel felt more than ever inclined to confide
the whole story to him. He was a man of the world. He owed Guy a
debt of gratitude. She had not promised Guy to keep silence. He had
never asked her, for he had realised that the request would have
been an insult. There was little time to argue the matter with herself.
Flurscheim was impatient to depart. She obeyed the impulse.
"Mr. Flurscheim," she said, "will you treat what I tell you as
strictly confidential, and take no action without my permission?"
"I give you my word," he said gravely.
Meriel glanced round her. No living soul was in sight. They stood
alone upon the sea-wall. Flurscheim noted her glance.
"There's no chance of being overheard," he remarked. At a little
distance was a stile in a rail fence which separated one meadow
from another. Flurscheim pointed to it.
"Come along," he said brusquely, and there the girl made known
to her companion the story of Guy's life as she had heard it from his
lips.
"He is not so greatly to blame, is he, Mr. Flurscheim?" she
asked eagerly, when she had finished the narration. "And yet nothing
can alter the fact that he is a thief."
The Jew had listened with growing amazement. To him the story
seemed the wildest, maddest romance he had ever heard. He could
scarcely believe his ears. To Meriel's appeal he could only reply at
first with an Hebraic invocation, uttered beneath his breath. Then he
asked, "And you really think he was telling the truth?"
"If you had seen his face, you would have had no need to ask
the question," she answered sorrowfully.
"It's the tallest story I've ever heard," he remarked. "But whether
true or not, if we want to do anything for him the first step is to get
him out of the hands of that old scoundrel of a father, and," he
added, "I am more than ever convinced that only a woman can do
that. Think it over, Miss Challys, think it over." He glanced at his
watch. "Now if you will give me his address, I will be off. I have a
number of things to do before returning to town."
She gave him the address. She responded heartily to his
farewell, and as she stood watching him as he hastened along the
path towards the quay it seemed to her that already the burden of
her trouble was lightened. She trusted Flurscheim implicitly, and yet
twenty-four hours previously she would have been prepared to
assert that he would have been the last person in the world of whom
she would have taken counsel in her distress.
Not that her mind was at rest. She merely was relieved from
anxiety as regards Guy's immediate safety. As to the future there
was no trace of a silver lining to the clouds. Guy and she had parted.
Yet Flurscheim's words stuck in her brain. "Only a woman could help
him." Only a woman!
CHAPTER XXIV
INSPECTOR KENLY CONTEMPLATES ACTION