Blockchain: šta nam treba da izgradimo PoC?

Oči se boje, a ruke se trzaju!

U prethodnim člancima smo razmatrali tehnologije na kojima se temelje blokchaini (Šta nam treba da izgradimo blockchain?) i primjere koji se mogu realizovati pomoću njih (Šta nam treba za izradu slučaja?). 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?

Blockchain: šta nam treba da izgradimo PoC?

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:

Blockchain: šta nam treba da izgradimo PoC?

Službenu verziju o tome šta je Hyperledger Fabric možete pročitati na sajtu, 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:

Blockchain: šta nam treba da izgradimo PoC?

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 gossip protokol.
  • 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 broker poruka Kafka, za razvoj i testiranje Solo.

CallFlow

Blockchain: šta nam treba da izgradimo PoC?

  • 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 klasičnog BFT 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 (vidi odeljak 'Forks');
  • 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: Origins Architecture ili ovde: Hyperledger Fabric: A Distributed Operating System for Permissioned Blockchains.

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:

Blockchain: šta nam treba da izgradimo PoC?

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 IBM cloudu. 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:

Blockchain: šta nam treba da izgradimo PoC?

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

Blockchain: šta nam treba da izgradimo PoC?

Kreiramo korisnike:

Blockchain: šta nam treba da izgradimo PoC?

Kreiramo Channel i nazivamo ga citcoin:

Blockchain: šta nam treba da izgradimo PoC?

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

Blockchain: šta nam treba da izgradimo PoC?

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:

Blockchain: šta nam treba da izgradimo PoC?

Pogledamo transakciju za instalaciju pametnog ugovora:

Blockchain: šta nam treba da izgradimo PoC?

Pogledamo detalje o našem Channelu:

Blockchain: šta nam treba da izgradimo PoC?

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):

Blockchain: šta nam treba da izgradimo PoC?

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: Full Stack Web App using Vue.js & Express.js. 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 sajt „Postman“ — š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: www.citcoin.info. 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:

Blockchain: šta nam treba da izgradimo PoC?

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

Blockchain: šta nam treba da izgradimo PoC?

Pribavljamo spisak svih dostupnih naloga:

Blockchain: šta nam treba da izgradimo PoC?

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

Blockchain: šta nam treba da izgradimo PoC?

U logu pratimo izvršavanje transakcija:

Blockchain: šta nam treba da izgradimo PoC?

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

Blockchain: šta nam treba da izgradimo PoC?

I ukupni spisak transakcija:

Blockchain: šta nam treba da izgradimo PoC?

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 GitHub. 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

Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere 🔥 Kupite pouzdan hosting za sajtove uz zaštitu od DDoS, VPS VDS servere | ProHoster