Oči se boje, a ruke se trzaju!
U prethodnim člancima smo razmatrali tehnologije na kojima se temelje blokchaini () i primjere koji se mogu realizovati pomoću njih (). Došlo je vreme da se uhvatimo u koštac s radom! Za realizaciju pilot projekata i PoC (Proof of Concept) preferiram koristiti oblake, jer su dostupni sa bilo kojeg mesta na svetu i, često, ne treba gubiti vreme na dosadnu instalaciju okruženja, jer postoje unapred instalirane konfiguracije. Dakle, hajde da napravimo nešto jednostavno, na primer, mrežu za prenos kovanica između učesnika i nazovemo je skromno Citcoin. Za to ćemo koristiti IBM oblak i univerzalni blokchain Hyperledger Fabric. Prvo, razjasnimo zašto se Hyperledger Fabric naziva univerzalnim blokchainom?

Hyperledger Fabric — univerzalni blokchain
Govoreći uopšte, univerzalni informacijski sistem je:
- Skup servera i programsko jezgro koje izvršava poslovnu logiku;
- Interfejsi za interakciju sa sistemom;
- Sredstva za registraciju, autentifikaciju i autorizaciju uređaja / ljudi;
- Baza podataka koja čuva operativne i arhivske podatke:

Službenu verziju o tome šta je Hyperledger Fabric možete pročitati na , a ako ukratko, Hyperledger Fabric je open-source platforma koja omogućava izgradnju zatvorenih blokchaina i izvršavanje proizvoljnih pametnih ugovora, napisanih na programskim jezicima JS i Go. Pogledajmo detaljno arhitekturu Hyperledger Fabric i uverimo se da je to univerzalni sistem, u kojem postoji samo specifičnost pohranljavanja i zapisivanja podataka. Specifičnost se sastoji u tome da se podaci, kao i u svim blokchainima, čuvaju u blokovima koji se stavljaju u blokchain samo ako su učesnici postigli konsenzus i nakon zapisivanja podaci se ne mogu neprimetno ispraviti ili obrisati.
Arhitektura Hyperledger Fabric
Na dijagramu je prikazana arhitektura Hyperledger Fabric:

Organizacije — organizacije sadrže peer-ove, tako da blokchain postoji zahvaljujući podršci organizacija. Različite organizacije mogu ući u jedan channel.
Channel — logička struktura koja okuplja peer-ove u grupe, tako da se formira blokchain. Hyperledger Fabric može istovremeno obraditi više blokchaina sa različitom poslovnom logikom.
Provider usluga članstva (MSP) — to je CA (Certificate Authority) za izdavanje identiteta i dodeljivanje uloga. Za kreiranje node-a potrebno je komunicirati s MSP-om.
Peer nodovi — provjeravaju transakcije, čuvaju blokčejn, izvršavaju pametne ugovore i komuniciraju s aplikacijama. Peer-ovi imaju identitet (digitalni certifikat) koji izdaje MSP. Za razliku od mreže Bitcoin ili Etherium, gdje su svi nodovi ravnopravni, u Hyperledger Fabric nodovi igraju različite uloge:
- Peer može biti endorsing peer (EP) i izvršavati pametne ugovore.
- Committing peer (CP) — samo čuvaju podatke u blokčejnu i ažuriraju „World state“.
- Anchor Peer (AP) — ako u blokčejnu učestvuje više organizacija, onda se ankor peer-ovi koriste za povezivanje među njima. Svaka organizacija treba imati jedan ili više ankor peer-ova. Uz pomoć AP, svaki peer u organizaciji može dobiti informacije o svim peer-ovima u drugim organizacijama. Za sinhronizaciju informacija među AP-ima koristi se .
- Leader Peer — ako organizacija ima više peer-ova, samo lider peer će primati blokove iz Ordering service i davati ih ostalim peer-ovima. Lider se može određivati statički ili se dinamički bira od strane peer-ova u organizaciji. Za sinhronizaciju informacija o liderima takođe se koristi gossip protokol.
Assets — entiteti koji imaju vrednost i čuvaju se u blokčejnu. Konkretno, to su key-value podaci u JSON formatu. Upravo se ti podaci beleže u blokčejn „Blockchain“. Oni imaju istoriju koja se čuva u blokčejnu i trenutno stanje koje se čuva u bazi podataka „World state“. Strukture podataka se popunjavaju proizvoljno u zavisnosti od poslovnih zadataka. Nema obaveznih polja, jedina preporuka je da asset-i treba da imaju vlasnika i predstavljaju vrednost.
Ledger — sastoji se od blokčejna „Blockchain“ i baze podataka „World state“, u kojoj se čuva trenutno stanje asset-a. World state koristi LevelDB ili CouchDB.
Pametni ugovor — pomoću pametnih ugovora sprovodi se poslovna logika sistema. U Hyperledger Fabric pametni ugovori se nazivaju chaincode. Pomoću chaincode definišu se asset-i i transakcije nad njima. Govoreći tehničkim jezikom, pametni ugovori su softverski moduli implementirani na programskim jezicima JS ili Go.
Endorsement policy — za svakog chaincode može se postaviti politika koliko i od koga je potrebno očekivati potvrde za transakciju. Ako politika nije postavljena, prema zadatku se koristi: “transakciju mora potvrditi bilo koji član (member) bilo koje organizacije u channel”. Primeri politika:
- Transakciju mora potvrditi bilo koji administrator organizacije;
- Mora da potvrdi bilo koji član (member) ili klijent organizacije;
- Mora da potvrdi bilo koji peer organizacije.
Usluga naručivanja — pakira transakcije u blokove i šalje ih peer-ovima u channel. Garantuje isporuku poruka svim peer-ovima u mreži. Za industrijske sisteme koristi se , za razvoj i testiranje .
CallFlow

- Aplikacija komunicira sa Hyperledger Fabric koristeći Go, Node.js ili Java SDK;
- Klijent kreira transakciju tx i šalje je na endorsing peer-ove;
- Peer proverava potpis klijenta, izvršava transakciju i šalje endorsement signature nazad klijentu. Chaincode se izvršavaju samo na endorsing peer-ovima, a rezultat njihovog izvršenja se šalje svim peer-ovima. Ovaj način rada se naziva — PBFT (Practical Byzantine Fault Tolerant) konsenzus. Razlikuje se od po tome što se poruka šalje i očekuje potvrda ne od svih učesnika, već samo od određenog skupa;
- Nakon što klijent primi broj odgovora koji se poklapa sa endorsement policy, šalje transakciju na Uslugu naručivanja;
- Usluga naručivanja formira blok i šalje ga svim committing peer-ovima. Usluga naručivanja obezbeđuje sekvencijalno zapisivanje blokova, čime se isključuje tzv. ledger fork ();
- Peer-ovi dobijaju blok, ponovo provere endorsement policy, upisuju blok u blockchain i menjaju stanje u 'World state' DB.
Tj. dolazi do podele uloga između nodova. To obezbeđuje skalabilnost i sigurnost blockchain-a:
- Pametni ugovori (chaincode) se izvršavaju na endorsing peer-ovima. To obezbeđuje poverljivost pametnih ugovora, jer se ne čuvaju kod svih učesnika, već samo na endorsing peer-ovima.
- Ordering mora raditi brzo. To se obezbeđuje time što Ordering samo formira blok i šalje ga na fiksnu grupu leader peer-ova.
- Committing peers samo čuvaju blockchain — može ih biti mnogo i ne zahtevaju veliku snagu i trenutni rad.
Detaljnije arhitektonska rešenja Hyperledger Fabric i zašto funkcionišu ovako, a ne inače, možete pogledati ovde: ili ovde: .
Dakle, Hyperledger Fabric je zaista univerzalni sistem, putem kojeg se može:
- Implementirati proizvoljnu poslovnu logiku koristeći mehanizam pametnih ugovora;
- Upisujte i preuzimajte podatke iz blockchain baze podataka u JSON formatu;
- Obezbjedite i provjerite pristup API-ju koristeći ovlaštenje certifikata.
Sada kada smo malo bolje razumeli specifičnosti Hyperledger Fabric, hajde da konačno uradimo nešto korisno!
Postavljanje blockchain-a
Postavljanje zadatka
Zadatak je implementirati Citcoin mrežu sa sljedećim funkcijama: kreirati račun, dobiti saldo, dopuniti račun, prebaciti novčiće sa jednog računa na drugi. Nacrtat ćemo objektni model, koji ćemo kasnije realizovati u pametnom ugovoru. Dakle, imat ćemo račune koji se identifikuju imenima (name) i imaju saldo (balance), kao i listu računa. Računi i lista računa su u terminima Hyperledger Fabric sredstva (assets). Stoga, imaju istoriju i trenutnu stanje. Pokušaću to vizualno prikazati:

Gornje figure prikazuju trenutno stanje, koje se čuva u bazi "World state". Ispod njih su figure koje prikazuju istoriju, koja se čuva u blockchain-u. Trenutno stanje sredstava mijenja se transakcijama. Sredstvo se mijenja u potpunosti, tako da se kao rezultat izvršenja transakcije stvara novi objekat, dok se trenutno stanje sredstva prenosi u istoriju.
IBM Cloud
Kreiramo nalog u . Da biste koristili blockchain platformu, potrebno je da je nadogradite na Pay-As-You-Go. Ovaj proces može potrajati, jer IBM traži dodatne informacije i provodi ručne provere. Sa pozitivne strane, mogu reći da IBM ima solidne obrazovne materijale koji omogućavaju postavljanje Hyperledger Fabric u njihovom oblaku. Svideo mi se sledeći ciklus članaka i primera:
Dole su screenshotovi IBM Blockchain platforme. Ovo nije uputstvo za kreiranje blockchain-a, već samo demonstracija obima zadatka. Dakle, za naše ciljeve pravimo jednu Organizaciju:

U njoj stvaramo čvorove: Orderer CA, Org1 CA, Orderer Peer:

Kreiramo korisnike:

Kreiramo Channel i nazivamo ga citcoin:

U suštini, Channel je blockchain, pa počinje s nul blokom (Genesis block):

Pišemo Pametni Ugovor
/*
* Citcoin smart-contract v1.5 for Hyperledger Fabric
* (c) Alexey Sushkov, 2019
*/
'use strict';
const { Contract } = require('fabric-contract-api');
const maxAccounts = 5;
class CitcoinEvents extends Contract {
async instantiate(ctx) {
console.info('instantiate');
let emptyList = [];
await ctx.stub.putState('accounts', Buffer.from(JSON.stringify(emptyList)));
}
// Get all accounts
async GetAccounts(ctx) {
// Get account list:
let accounts = '{}'
let accountsData = await ctx.stub.getState('accounts');
if (accountsData) {
accounts = JSON.parse(accountsData.toString());
} else {
throw new Error('accounts not found');
}
return accountsData.toString()
}
// add a account object to the blockchain state identifited by their name
async AddAccount(ctx, name, balance) {
// this is account data:
let account = {
name: name,
balance: Number(balance),
type: 'account',
};
// create account:
await ctx.stub.putState(name, Buffer.from(JSON.stringify(account)));
// Add account to list:
let accountsData = await ctx.stub.getState('accounts');
if (accountsData) {
let accounts = JSON.parse(accountsData.toString());
if (accounts.length < maxAccounts)
{
accounts.push(name);
await ctx.stub.putState('accounts', Buffer.from(JSON.stringify(accounts)));
} else {
throw new Error('Max accounts number reached');
}
} else {
throw new Error('accounts not found');
}
// return object
return JSON.stringify(account);
}
// Sends money from Account to Account
async SendFrom(ctx, fromAccount, toAccount, value) {
// get Account from
let fromData = await ctx.stub.getState(fromAccount);
let from;
if (fromData) {
from = JSON.parse(fromData.toString());
if (from.type !== 'account') {
throw new Error('wrong from type');
}
} else {
throw new Error('Accout from not found');
}
// get Account to
let toData = await ctx.stub.getState(toAccount);
let to;
if (toData) {
to = JSON.parse(toData.toString());
if (to.type !== 'account') {
throw new Error('wrong to type');
}
} else {
throw new Error('Accout to not found');
}
// update the balances
if ((from.balance - Number(value)) >= 0 ) {
from.balance -= Number(value);
to.balance += Number(value);
} else {
throw new Error('From Account: not enought balance');
}
await ctx.stub.putState(from.name, Buffer.from(JSON.stringify(from)));
await ctx.stub.putState(to.name, Buffer.from(JSON.stringify(to)));
// define and set Event
let Event = {
type: "SendFrom",
from: from.name,
to: to.name,
balanceFrom: from.balance,
balanceTo: to.balance,
value: value
};
await ctx.stub.setEvent('SendFrom', Buffer.from(JSON.stringify(Event)));
// return to object
return JSON.stringify(from);
}
// get the state from key
async GetState(ctx, key) {
let data = await ctx.stub.getState(key);
let jsonData = JSON.parse(data.toString());
return JSON.stringify(jsonData);
}
// GetBalance
async GetBalance(ctx, accountName) {
let data = await ctx.stub.getState(accountName);
let jsonData = JSON.parse(data.toString());
return JSON.stringify(jsonData);
}
// Refill own balance
async RefillBalance(ctx, toAccount, value) {
// get Account to
let toData = await ctx.stub.getState(toAccount);
let to;
if (toData) {
to = JSON.parse(toData.toString());
if (to.type !== 'account') {
throw new Error('wrong to type');
}
} else {
throw new Error('Accout to not found');
}
// update the balance
to.balance += Number(value);
await ctx.stub.putState(to.name, Buffer.from(JSON.stringify(to)));
// define and set Event
let Event = {
type: "RefillBalance",
to: to.name,
balanceTo: to.balance,
value: value
};
await ctx.stub.setEvent('RefillBalance', Buffer.from(JSON.stringify(Event)));
// return to object
return JSON.stringify(from);
}
}
module.exports = CitcoinEvents;
Intuitivno, ovde bi sve trebalo da bude jasno:
- Postoji nekoliko funkcija (AddAccount, GetAccounts, SendFrom, GetBalance, RefillBalance) koje će demo program pozivati putem Hyperledger Fabric API-ja.
- Funkcije SendFrom i RefillBalance generišu događaje (Event) koje će demo program primati.
- Funkcija instantiate — poziva se samo jednom prilikom instanciranja pametnog ugovora. U stvarnosti, ona se poziva ne samo jednom, već svaki put kada se promeni verzija pametnog ugovora. Stoga inicijalizacija liste sa praznim nizom — to je loša ideja, budući da ćemo, pri promeni verzije pametnog ugovora, izgubiti trenutnu listu. Ali ništa, tek učim).
- Računi (Account) i lista računa (accounts) — to su JSON strukture podataka. Za manipulaciju podacima koristi se JS.
- Aktuelnu vrednost imovine (asset) može se dobiti pozivom funkcije getState, a ažurirati putem putState.
- Prilikom kreiranja računa poziva se funkcija AddAccount, u kojoj se vrši poređenje sa maksimalnim brojem računa u blokčejnu (maxAccounts = 5). I ovde postoji greška (primetili ste?), koja dovodi do beskrajnog rasta broja računa. Takvih grešaka treba izbegavati)
Zatim učitamo pametni ugovor u Channel i instanciramo ga:

Pogledamo transakciju za instalaciju pametnog ugovora:

Pogledamo detalje o našem Channelu:

Kao rezultat dobijamo sledeću shemu blokčejn mreže u oblaku IBM. Takođe, na shemi se nalazi demo program, pokrenut u oblaku Amazon na virtuelnom serveru (detailed informacije o njemu biće u sledećem delu):

Kreiranje GUI za pozive Hyperledger Fabric API-a
Hyperledger Fabric ima API koji se može koristiti za:
- Kreiranje channel-a;
- Povezivanje peera sa channel-om;
- Instaliranje i instanciranje pametnih ugovora u channel-u;
- Poziv transakcija;
- Zahtевanje informacija iz blokčejna.
Razvoj aplikacije
U našoj demo aplikaciji koristićemo API samo za pozivanje transakcija i zahtev informacija, pošto smo ostale korake već uradili, koristeći blokčejn platformu IBM. Pišemo GUI koristeći standardni tehnološki skup: Express.js + Vue.js + Node.js. O tome kako započeti kreiranje modernih web aplikacija može se napisati poseban članak. Ovde ću ostaviti link na seriju predavanja koja mi se najviše dopala: . Kao rezultat, nastala je klijentsko-server aplikacija sa poznatim grafičkim interfejsom u stilu Material Design-a od Google-a. REST API između klijenta i servera sastoji se od nekoliko poziva:
- HyperledgerDemo/v1/init — inicijalizovati blokčejn;
- HyperledgerDemo/v1/accounts/list — dobiti listu svih računa;
- HyperledgerDemo/v1/account?name=Bob&balance=100 — kreirati Bobov račun;
- HyperledgerDemo/v1/info?account=Bob — dobiti informacije o Bobovom računu;
- HyperledgerDemo/v1/transaction?from=Bob&to=Alice&volume=2 — preneti dva novčića od Boba do Alise;
- HyperledgerDemo/v1/disconnect — zatvaranje veze sa blokčejnom.
Opis API sa primerima je stavljen na — široko poznati program za testiranje HTTP API-ja.
Demo aplikacija u oblaku Amazon
Aplikaciju sam postavio na Amazon, jer IBM još uvek nije uspeo da unapredi moj nalog i omogući mi da kreiram virtuelne servere. Kao šlag na tortu, dodao sam domen: . Održavaću malo server uključenim, a zatim ću ga isključiti, jer se plaća zakup, a citcoin kovanice još nisu kotirane na berzi) U članak stavljam screenshot-ove demo verzije, kako bi bila jasna logika rada. Demo aplikacija može:
- Inicijalizovati blokčejn;
- Kreirati nalog (ali trenutno novi nalog ne može biti kreiran, jer je u blokčejnu dostignut maksimalan broj naloga naveden u pametnom ugovoru);
- Pribaviti spisak naloga;
- Prenositi citcoin kovanice između Alice, Bob i Alex;
- Prikazivati događaje (ali trenutno događaje nije moguće prikazati, pa je u interfejsu napisano da događaji nisu podržani radi jednostavnosti);
- Logovati aktivnosti.
Prvo inicijalizujemo blokčejn:

Zatim otvaramo svoj nalog, ne prepuštajući sreće sa balansom:

Pribavljamo spisak svih dostupnih naloga:

Biramo pošiljaoca i primaoca, i uzimamo njihove balanse. Ako su pošiljalac i primalac isti, doći će do dopune njegovog računa:

U logu pratimo izvršavanje transakcija:

S tim, sa demo programom je to sve. Dalje možemo pogledati našu transakciju u blokčejnu:

I ukupni spisak transakcija:

Ovim smo uspešno završili implementaciju PoC za izradu Citcoin mreže. Šta još treba učiniti da Citcoin postane potpuna mreža za prenos kovanica? Veoma malo:
- Na fazi kreiranja naloga implementirati generaciju privatnog / javnog ključa. Privatni ključ treba da bude sačuvan kod korisnika naloga, a javni u blokčejnu.
- Izvršiti prenos kovanica, u kojem se za identifikaciju korisnika koristi ne ime, već javni ključ.
- Šifrovati transakcije koje idu od korisnika na server njegovim privatnim ključem.
Zaključak
Implementirali smo Citcoin mrežu sa funkcijama: dodavanje naloga, dobijanje balansa, dopunjavanje svog računa, prenos kovanica sa jednog računa na drugi. Dakle, šta nas je koštalo da izgradimo PoC?
- Trebalo je proučiti blokčejn uopšte i Hyperledger Fabric posebno;
- Naučiti kako da koristimo oblake IBM ili Amazon;
- Naučiti programski jezik JS i neki web okvir;
- Ako su neki podaci potrebni za skladištenje izvan blockchaina, potrebno je naučiti kako se integrirati, na primjer, s PostgreSQL;
- I posljednje na listi, no ne i po važnosti — bez znanja Linux-a u modernom svijetu nećeš daleko dogurati!)
Naravno, nije raketna nauka, ali ćeš se morati potruditi!
Izvori na GitHubu
Izvore sam stavio na . Kratki opis repozitorija:
Katalog „server“ — Node.js server
Katalog „client“ — Node.js klijent
Katalog „blockchain“ (vrijednosti parametara i ključevi, naravno, nisu radni i navedeni su samo za primjer):
- contract — izvorni kod pametnog ugovora
- wallet — korisnički ključevi za korištenje Hyperledger Fabric API.
- *.cds — kompilirane verzije pametnih ugovora
- *.json datoteke — primjeri konfiguracijskih datoteka za korištenje Hyperledger Fabric API
To je tek početak!
Izvor: habr.com
