नमस्कार, हेब्र!

उन लोगों के लिए जो ब्लॉकचेन के विषय में रुचि रखते हैं, यह कोई रहस्य नहीं है कि सार्वजनिक ब्लॉकचेन, जैसे कि इथेरेम , बिटकॉइन , ज़कैश , आदि के अलावा, उनके "उद्यम (निजी)" "भाई" भी हैं जो कुछ तरीकों से सार्वजनिक नेटवर्क से बेहतर हैं, लेकिन कुछ में वे उन्हें खो देते हैं। सबसे प्रसिद्ध नेटवर्कों में, मुझे लगता है कि आप कोरम (विक्रेता - जेपी मॉर्गन चेस ), पेंटीहोन (विक्रेता - पेगासीस ) और हाइपरलेगर ( लिनक्स फाउंडेशन द्वारा प्रबंधित) का नाम दे सकते हैं। इस तथ्य के बावजूद कि बहुत सारे सार्वजनिक फैसले हैं, व्यवसाय निजी ब्लॉकचेन में तेजी से दिलचस्पी ले रहा है क्योंकि वे गोपनीयता के आवश्यक स्तर को प्रदान करने में सक्षम हैं, लेनदेन तेजी से और इसी तरह से होते हैं। निजी और सार्वजनिक ब्लॉकचेन के बीच अंतर, साथ ही उनके फायदे और नुकसान, इस लेख का विषय नहीं हैं। यदि आप इसके बारे में पढ़ने में रुचि रखते हैं, तो, उदाहरण के लिए, इस तरह का एक लेख।

इस लेख में, मैं आपको बताना चाहूंगा कि आप निजी और सार्वजनिक लेनदेन के लिए अपने अनुप्रयोगों को विकसित करने के लिए कोरम ब्लॉकचैन का उपयोग कैसे कर सकते हैं। क्षमताओं को प्रदर्शित करने के लिए, हम एक छोटा जावा / स्प्रिंग एप्लिकेशन लिखेंगे जो स्मार्ट कॉन्ट्रैक्ट्स को तैनात (तैनात) करने, लेनदेन को निष्पादित करने और स्मार्ट कॉन्ट्रैक्ट से डेटा पढ़ने के लिए अनुरोध स्वीकार करेगा। वास्तव में, यहाँ प्रौद्योगिकी ढेर है जिसका उपयोग लेख में किया जाएगा:

• जावा 8
• गाद 5.2.1
• वसंत की रूपरेखा
• Web3j (Ethereum जैसे नेटवर्क में सार्वजनिक लेनदेन के साथ काम करने के लिए पुस्तकालय)
• Web3j-quorum (कोरम नेटवर्क में निजी लेनदेन के साथ काम करने के लिए पुस्तकालय)

कोरम के बारे में कुछ सामान्य जानकारी

क्वोरम गीथहब पर खुले स्रोत कोड के साथ एक परियोजना है , जिसका उद्देश्य एक ब्लॉकचेन प्रदान करना है जो न केवल सार्वजनिक रूप से बल्कि निजी मोड में भी लेनदेन करना संभव होगा। तकनीकी दृष्टिकोण से, कोरम एक एथेरियम अपग्रेड है, इसमें निजी लेनदेन करने में सक्षम होने के लिए अपने स्वयं के संशोधित गेथ क्लाइंट भी हैं।

एक महत्वपूर्ण अतिरिक्त एन्क्लेव सेवाएं भी हैं, जो कि आपस में निजी लेनदेन के भंडारण, एन्क्रिप्शन और वितरण के लिए जिम्मेदार हैं। अब 2 ऐसी एन्क्लेव सेवाएं हैं:

1. नक्षत्र - हास्केल, एन्क्लेव के पहले संस्करण में लिखा गया है, लेकिन अब यह अब विकसित नहीं होता है, और भविष्य में सबसे अधिक संभावना है कि इसे एक नए के पक्ष में छोड़ दिया जाएगा;
2. टेसेरा - एक नई सेवा, जिसे जावा में लिखा गया है , जेपी मॉर्गन चेस के डेवलपर्स द्वारा समर्थित है, के पास डेटाबेस और संवेदनशील जानकारी के प्रबंधन के साथ एकीकरण के लिए अधिक विकल्प हैं (उदाहरण के लिए, रहस्यों को प्रबंधित करने के लिए HashiCorp वॉल्ट के साथ एकीकरण का एक विकल्प है)।

लेनदेन के लिए, साधारण एथेरियम के इंटरफ़ेस के दृष्टिकोण से , बहुत कुछ नहीं बदला गया है (और यह अच्छा है)। निजी लेनदेन भेजने के लिए, लेन-देन के बारे में सामान्य जानकारी के अलावा, आपको PrivateFor पैरामीटर को भी निर्दिष्ट करना होगा - यह लाइनों का सरणी है , और ये लाइनें एन्क्लेव नोड की सार्वजनिक कुंजी हैं। इन कुंजियों का उपयोग करके, पेलोड लेनदेन को एन्क्रिप्ट किया जाता है और ब्लॉकचेन के अंदर टेसेरा नोड्स के बीच भुगतान वितरित किया जाता है।

कोरम के साथ एक गहरे परिचित के लिए, यह कैसे काम करता है, और ब्लॉकचेन नेटवर्क कैसे बढ़ाएं, आप इसे आधिकारिक वेबसाइट (प्रलेखन के लिए एक लिंक, साथ ही एक परीक्षण ब्लॉकचैन लॉन्च करने के तरीके पर ट्यूटोरियल के लिंक के साथ पा सकते हैं, मैं लेख के अंत में छोड़ दूंगा)।

जावा अनुप्रयोग विकास

एक उदाहरण के रूप में, मैं जावा / स्प्रिंग में लिखा एक छोटा RESTful API दिखाऊंगा, ग्रेडल के साथ बिल्ड और डिपेंडेंसी मैनेजमेंट टूल के रूप में जो स्मार्ट कॉन्ट्रैक्ट को ब्लॉकचेन में लोड करेगा, कॉन्ट्रैक्ट की स्थिति को बदलने का कार्य करेगा और स्मार्ट कॉन्ट्रैक्ट से स्टेट को पढ़ेगा।

विकास शुरू करने से पहले, मुझे कुछ स्पष्ट करना होगा। इस तथ्य के बावजूद कि कोरम में आधिकारिक तौर पर 2 लेनदेन विकल्प हैं, मैं उन्हें 3 प्रकारों में विभाजित करना पसंद करता हूं:

1. सार्वजनिक लेनदेन - लेनदेन पूरी तरह से सभी नेटवर्क प्रतिभागियों ( पेलोड सहित) को दिखाई देते हैं, एन्क्लेव नोड लेनदेन को संसाधित करने या संग्रहीत करने में भाग नहीं लेता है। कोरम में सार्वजनिक लेनदेन इथेरेम नेटवर्क में लेनदेन से अलग नहीं है;
2. अनुमत लेनदेन - लेनदेन अनिवार्य रूप से निजी हैं, लेकिन कई नेटवर्क प्रतिभागियों के लिए, अर्थात् सार्वजनिक नेटवर्क पर, हमें लेनदेन और इसके निष्पादन की स्थिति के बारे में जानकारी है, लेकिन सार्वजनिक नेटवर्क पर वास्तविक पेलोड के बजाय, हमारे पास केवल 64-बिट हैश स्ट्रिंग है, जो है एक एन्क्लेव नोड में एक वास्तविक पेलोड के लिए एक पहचानकर्ता द्वारा, एन्क्लेव नोड खुद को लेनदेन के लिए संकेतित पार्टियों के बीच पेलोड पर हस्ताक्षर करने, एन्क्रिप्ट करने, भंडारण करने और वितरित करने के लिए जिम्मेदार है;
3. निजी लेनदेन - इसमें अनुमति से भिन्न है कि यह लेनदेन केवल उस नोड के लिए उपलब्ध है जिसने इस लेनदेन को बनाया है, अन्य नेटवर्क प्रतिभागी पेलोड लेनदेन नहीं देख सकते हैं।
   मैं इस वर्गीकरण का उपयोग पूरे लेख में करूंगा।

शुरू करने के लिए, मैं आपको दिखाऊंगा कि बिल्ड फ़ाइल gradle.build - gradle.build :

 plugins { id 'org.springframework.boot' version '2.1.6.RELEASE' id 'java' } apply plugin: 'io.spring.dependency-management' group = 'com.github' version = '1.0' sourceCompatibility = '1.8' configurations { compileOnly { extendsFrom annotationProcessor } } repositories { mavenCentral() } test { testLogging.showStandardStreams = true } dependencies { implementation 'org.springframework.boot:spring-boot-starter-webflux' implementation group: 'org.web3j', name: 'quorum', version: '4.0.6' implementation group: 'org.web3j', name: 'core', version: '4.1.0' implementation group: 'org.web3j', name: 'codegen', version: '4.1.0' compileOnly 'org.projectlombok:lombok' annotationProcessor 'org.projectlombok:lombok' annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor' testImplementation 'org.springframework.boot:spring-boot-starter-test' testImplementation 'io.projectreactor:reactor-test' } task generateWrappers(type: JavaExec) { group 'Demo' description 'Generates wrappers for smart-contracts' classpath = sourceSets.main.runtimeClasspath main = 'com.github.quorum.utils.WrappersGenerator' } 

थोड़ा स्पष्टीकरण:

1. org.web3j.core - कोरम नेटवर्क पर org.web3j.core नेटवर्क और सार्वजनिक लेनदेन पर लेनदेन के साथ काम करने के लिए निर्भरता
2. org.web3j.quorum - कोरम नेटवर्क पर निजी लेनदेन के साथ काम करने के लिए निर्भरता
3. org.web3j.codegen - org.web3j.codegen स्मार्ट कॉन्ट्रैक्ट्स के लिए org.web3j.codegen उत्पन्न करने के लिए निर्भरता
4. जेनरवैपर्स - सॉलिडिटी स्मार्ट कॉन्ट्रैक्ट से जावा रैपर उत्पन्न करने के लिए ग्रैडल-टास्क

अगला, मैं आपको स्मार्ट कॉन्ट्रैक्ट कोड QuorumDemo.sol जिसका उपयोग इस लेख में किया जाएगा: QuorumDemo.sol फ़ाइल:

 pragma solidity 0.5.0; /** * @dev Smart-Contract for demonstration purposes. */ contract QuorumDemo { string public user; /** * @dev Rewrite user name in storage. */ function writeUser(string calldata _user) public { user = _user; } } 

अनुबंध को जानबूझकर सरल बनाया गया है, लेकिन यह हमारे लेख के उद्देश्यों के लिए पर्याप्त है। यदि आप सॉलिडिटी जानते हैं, तो आप स्पष्टीकरण को छोड़ सकते हैं:

• string public user - प्रकार स्ट्रिंग और नाम उपयोगकर्ता का एक सार्वजनिक चर। जावा के विपरीत, सॉलिडिटी स्वचालित रूप से सार्वजनिक चर के लिए एक गेट्टर बनाता है, इसलिए आपको इसे मैन्युअल रूप से लागू करने की आवश्यकता नहीं है।
• function writeUser(...) - एक चर के मान को बदलने का कार्य, वास्तव में - सेटर ।

स्मार्ट कॉन्ट्रैक्ट से Java-wrapper बनाने के लिए, आपको फ़ाइल को किसी भी नाम के साथ src/main/solidity/contracts QuorumDemo.sol src/main/solidity/contracts फ़ोल्डर में QuorumDemo.sol , उदाहरण के लिए QuorumDemo.sol ।
अगला, कमांड के साथ ग्रैडल-वर्क जेनरेटर्स चलाएं:

 gradle generateWrappers 

इस कार्य को पूरा करने के बाद, src/main/java/com/github/quorum/component/wrappers Java-आवरण तैयार किया जाएगा, जो पहले से ही Java कोड में उपयोग किया जा सकता है।

बैकएंड के लिए लेनदेन पर हस्ताक्षर करने में सक्षम होने के लिए, हमें भेजने से पहले पेलोड लेनदेन प्राप्त करने में सक्षम होना चाहिए। ऐसा करने के लिए, इसे सीधे जावा-आवरण वर्ग से प्राप्त करना अच्छा होगा। यहां मैंने रैपर के अंदर 2 तरीके बनाए। पहली विधि बस अनुबंध के एबीआई को वापस करती है, जिसका उपयोग एक नया स्मार्ट अनुबंध डाउनलोड करने के लिए किया जा सकता है। दूसरी विधि एक स्मार्ट अनुबंध की स्थिति को बदलने के लिए लेनदेन का गठन है। यहाँ इन विधियों के लिए कोड है:

 public static String getBinary() { return BINARY; } public static String getDataOnWriteUser(final String user) { final Function function = new Function( FUNC_WRITEUSER, Arrays.asList(new Utf8String(user)), Collections.emptyList() ); return FunctionEncoder.encode(function); } 

उन्हें उत्पन्न जावा-आवरण में डालकर, आप लेनदेन के लिए पेलोड प्राप्त कर सकते हैं।

अगला, हमें निजी और सार्वजनिक लेनदेन के लिए समान इंटरफ़ेस के साथ, ब्लॉकचैन में लेनदेन भेजने के लिए एक सुविधाजनक तरीका चाहिए। इसलिए, मैंने लेनदेन प्रबंधक इंटरफ़ेस और इसके कार्यान्वयन के 2 बनाए:

1. निजी लेनदेन भेजने के लिए TesseraTransactionManager
2. सार्वजनिक लेनदेन भेजने के लिए GethTransactionManager

चलो उन्हें अलग ले जाएं। TesseraTransactionManager कोड:

 @Slf4j public class TesseraTransactionManager implements TransactionManager { private static final byte ATTEMPTS = 20; private static final int SLEEP_DURATION = 100; private final Quorum quorum; private final String fromAddress; private final QuorumTransactionManager quorumTxManager; private final TransactionReceiptProcessor txReceiptProcessor; public TesseraTransactionManager( Quorum quorum, Credentials credentials, String publicKey, List<String> privateFor, Tessera tessera ) { this.quorum = quorum; this.fromAddress = credentials.getAddress(); this.quorumTxManager = new QuorumTransactionManager(quorum, credentials, publicKey, privateFor, tessera); this.txReceiptProcessor = new PollingTransactionReceiptProcessor(quorum, SLEEP_DURATION, ATTEMPTS); } @Override public TransactionReceipt executeTransaction( final BigInteger gasPrice, final BigInteger gasLimit, final String to, final String data) { while (true) { try { final EthSendTransaction ethSendTx = sendTransaction(gasPrice, gasLimit, to, data); if (ethSendTx.hasError() && NONCE_TOO_LOW_ERROR_MESSAGE.equals(ethSendTx.getError().getMessage())) { log.warn("[BLOCKCHAIN] try to re-send transaction cause error {}", ethSendTx.getError().getMessage()); continue; } return processResponse(ethSendTx); } catch (TransactionException ex) { log.error("[BLOCKCHAIN] exception while receiving TransactionReceipt from Quorum node", ex); throw new RuntimeException(ex); } catch (Exception ex) { log.error("[BLOCKCHAIN] exception while sending transaction to Quorum node", ex); throw new RuntimeException(ex); } } } private EthSendTransaction sendTransaction( final BigInteger gasPrice, final BigInteger gasLimit, final String to, final String data) throws IOException { final BigInteger nonce = getNonce(); final RawTransaction rawTransaction = RawTransaction.createTransaction(nonce, gasPrice, gasLimit, to, data); return this.quorumTxManager.signAndSend(rawTransaction); } private TransactionReceipt processResponse(final EthSendTransaction transactionResponse) throws IOException, TransactionException { if (transactionResponse.hasError()) { throw new RuntimeException( "[BLOCKCHAIN] error processing transaction request: " + transactionResponse.getError().getMessage() ); } final String transactionHash = transactionResponse.getTransactionHash(); return this.txReceiptProcessor.waitForTransactionReceipt(transactionHash); } private BigInteger getNonce() throws IOException { final EthGetTransactionCount ethGetTxCount = this.quorum.ethGetTransactionCount( this.fromAddress, DefaultBlockParameterName.PENDING).send(); return ethGetTxCount.getTransactionCount(); } } 

• TransactionReceipt executeTransaction(...) - इंटरफ़ेस का कार्यान्वयन, नेटवर्क पर लेनदेन करने और यदि वे होते हैं तो त्रुटियों को संभालने के लिए एक विधि। लेनदेन के परिणाम के साथ एक वस्तु लौटाता है;
• EthSendTransaction sendTransaction(...) - EthSendTransaction sendTransaction(...) लेनदेन पर हस्ताक्षर करने और भेजने के लिए एक विधि। लेनदेन की स्थिति और उसके हैश के साथ एक वस्तु लौटाता है;
• TransactionReceipt processResponse(...) - एक विधि जो लेनदेन के पूरा होने तक प्रतीक्षा करती है और इसके निष्पादन के बाद TransactionReceipt को वापस कर देती है;
• BigInteger getNonce() - नेटवर्क से " BigInteger getNonce() " लौटाता है।

और GethTransactionManager कोड:

 @Slf4j public class GethTransactionManager extends FastRawTransactionManager implements TransactionManager { private static final byte ATTEMPTS = 20; private static final int SLEEP_DURATION = 100; private final TransactionReceiptProcessor txReceiptProcessor; public GethTransactionManager(Web3j web3j, Credentials credentials) { this(web3j, credentials, new PollingTransactionReceiptProcessor(web3j, SLEEP_DURATION, ATTEMPTS)); } public GethTransactionManager(Web3j web3j, Credentials credentials, TransactionReceiptProcessor txReceiptProcessor) { super(web3j, credentials, txReceiptProcessor); this.txReceiptProcessor = txReceiptProcessor; } @Override public TransactionReceipt executeTransaction( final BigInteger gasPrice, final BigInteger gasLimit, final String to, final String data) { while (true) { try { final EthSendTransaction ethSendTx = sendTransaction(gasPrice, gasLimit, to, data, BigInteger.ZERO); if (ethSendTx != null && ethSendTx.hasError() && NONCE_TOO_LOW_ERROR_MESSAGE.equals(ethSendTx.getError().getMessage())) { log.warn("[BLOCKCHAIN] try to re-send transaction cause error: {}", ethSendTx.getError().getMessage()); continue; } return this.txReceiptProcessor.waitForTransactionReceipt(ethSendTx.getTransactionHash()); } catch (TransactionException ex) { log.error("[BLOCKCHAIN] exception while receiving TransactionReceipt from Quorum node", ex); throw new RuntimeException(ex); } catch (IOException ex) { log.error("[BLOCKCHAIN] exception while sending transaction to Quorum node", ex); throw new RuntimeException(ex); } } } @Override public EthSendTransaction sendTransaction( final BigInteger gasPrice, final BigInteger gasLimit, final String to, final String data, final BigInteger value ) throws IOException { return super.sendTransaction(gasPrice, gasLimit.add(BigInteger.valueOf(21_000L)), to, data, value); } } 

• TransactionReceipt executeTransaction(...) - इंटरफ़ेस का कार्यान्वयन, नेटवर्क पर लेनदेन करने और यदि वे होते हैं तो त्रुटियों को संभालने के लिए एक विधि। लेनदेन के परिणाम के साथ एक वस्तु लौटाता है;
• EthSendTransaction sendTransaction(...) एक विधि है जो EthSendTransaction sendTransaction(...) विधि को कॉल करता है।

एपीआई के लिए आने वाले अनुरोधों के लिए हैंडलर:

 @Slf4j @Component public class RequestHandler { private final Web3j web3j; private final Quorum quorum; private final Tessera tessera; private final Credentials credentials; private final BlockchainConfig blockchainConfig; private String deployedContract; @Autowired public RequestHandler( @Qualifier("initWeb3j") Web3j web3j, Quorum quorum, Tessera tessera, Credentials credentials, BlockchainConfig blockchainConfig ) { this.web3j = web3j; this.quorum = quorum; this.tessera = tessera; this.credentials = credentials; this.blockchainConfig = blockchainConfig; } /** * Deploy new smart-contract. * * @param serverRequest * - {@link ServerRequest} object with request information * @return {@link ServerResponse} object with response data */ public Mono<ServerResponse> deployContract(final ServerRequest serverRequest) { return serverRequest .bodyToMono(APIRequest.class) .map(this::getTransactionManager) .map(this::deployContract) .flatMap(this::generateResponse); } private TransactionManager getTransactionManager(final APIRequest apiRequest) { log.info("[HANDLER] privateFor = {}", apiRequest.getPrivateFor()); TransactionManager txManager; if (isPrivate(apiRequest.getPrivateFor())) { if (apiRequest.getPrivateFor().size() == 0) { apiRequest.getPrivateFor().add(this.blockchainConfig.getTesseraPublicKey()); } txManager = new TesseraTransactionManager(this.quorum, this.credentials, this.blockchainConfig.getTesseraPublicKey(), apiRequest.getPrivateFor(), this.tessera); } else { txManager = new GethTransactionManager(this.web3j, this.credentials); } return txManager; } private boolean isPrivate(final List<String> limitedTo) { return limitedTo == null || limitedTo.size() == 0 || !limitedTo.get(0).equals("public"); } private APIResponse deployContract(final TransactionManager txManager) { log.info("[HANDLER] deploying new smart-contract"); final String data = QuorumDemo.getBinary(); final TransactionReceipt txReceipt = txManager.executeTransaction(GAS_PRICE, DEPLOY_GAS_LIMIT, null, data); final APIResponse apiResponse = APIResponse.newInstance(txReceipt); this.deployedContract = txReceipt.getContractAddress(); log.info("[HANDLER] contract has been successfully deployed. Result: {}", apiResponse.getMap()); return apiResponse; } private Mono<ServerResponse> generateResponse(final APIResponse apiResponse) { return ServerResponse .ok() .body(Mono.just(apiResponse.getMap()), Map.class); } /** * Send transaction on update user in smart-contract. * * @param serverRequest * - {@link ServerRequest} object with request information * @return {@link ServerResponse} object with response data */ public Mono<ServerResponse> updateUser(final ServerRequest serverRequest) { return serverRequest .bodyToMono(APIRequest.class) .map(this::sendTransaction) .flatMap(this::generateResponse); } private APIResponse sendTransaction(final APIRequest apiRequest) { final TransactionManager txManager = getTransactionManager(apiRequest); log.info("[HANDLER] sending new transaction"); final String data = QuorumDemo.getDataOnWriteUser(apiRequest.getUser()); final TransactionReceipt txReceipt = txManager.executeTransaction(GAS_PRICE, TX_GAS_LIMIT, this.deployedContract, data); final APIResponse apiResponse = APIResponse.newInstance(txReceipt); log.info("[HANDLER] transaction has been successfully executed. Result: {}", apiResponse.getMap()); return apiResponse; } /** * Read user from smart-contract. * * @param serverRequest * - {@link ServerRequest} object with request information * @return {@link ServerResponse} object with response data */ public Mono<ServerResponse> getUser(final ServerRequest serverRequest) { final APIResponse apiResponse = getUser(); return generateResponse(apiResponse); } private APIResponse getUser() { log.info("[HANDLER] reading user from smart-contract"); final QuorumDemo quorumDemo = QuorumDemo.load(this.deployedContract, this.web3j, this.credentials, new StaticGasProvider(GAS_PRICE, DEPLOY_GAS_LIMIT)); final String user = readUserFromSmartContract(quorumDemo); final APIResponse apiResponse = APIResponse.newInstance(user); log.info("[HANDLER] user: '{}'", user); return apiResponse; } private String readUserFromSmartContract(final QuorumDemo quorumDemo) { try { return quorumDemo.user().send().getValue(); } catch (Exception ex) { log.info("[HANDLER] exception while reading user from smart-contract: {}", ex); return null; } } } 

अब मैं समझाऊंगा कि कौन से तरीके क्या जिम्मेदार हैं।
Mono<ServerResponse> deployContract(...) विधि Mono<ServerResponse> deployContract(...) - सार्वजनिक और निजी दोनों तरह से स्मार्ट अनुबंध को Mono<ServerResponse> deployContract(...) के सामान्य तर्क का वर्णन करता है।
TransactionManager getTransactionManager(...) विधि TransactionManager getTransactionManager(...) - लेन-देन के प्रकार के आधार पर लेनदेन प्रबंधक के कार्यान्वयन का उद्देश्य देता है। इसके लिए, अनुरोध पैरामीटर में PrivateFor पैरामीटर होगा, जो टेसेरा सार्वजनिक कुंजी के तारों की एक सरणी है।
boolean isPrivate(...) विधि boolean isPrivate(...) - "सही" लौटाता है यदि प्राइवेटफ़ोर पैरामीटर या तो खाली ( निजी लेनदेन) है या सार्वजनिक कुंजी ( अनुमति प्राप्त लेनदेन) की एक सूची है। यदि निजीफ़ॉर्म पैरामीटर रिक्त नहीं है, तो "गलत" लौटाता है, और पहला एरे तत्व "पब्लिक" के बराबर है।
APIResponse deployContract(...) विधि - APIResponse deployContract(...) को तैनाती लेनदेन भेजता है।
Mono<ServerResponse> generateResponse(...) विधि Mono<ServerResponse> generateResponse(...) - क्लाइंट के प्रतिसाद के साथ एक वस्तु उत्पन्न करता है।
Mono<ServerResponse> updateUser(...) विधि Mono<ServerResponse> updateUser(...) - स्मार्ट अनुबंध की स्थिति को बदलने के लिए लेनदेन के सामान्य तर्क का वर्णन करता है।
APIResponse sendTransaction(...) विधि - APIResponse sendTransaction(...) एक राज्य परिवर्तन लेनदेन भेजता है।
APIResponse getUser() विधि - एक स्मार्ट अनुबंध से जानकारी पढ़ने के लिए सामान्य तर्क का वर्णन करता है और ग्राहक की प्रतिक्रिया देता है।
String readUserFromSmartContract(...) विधि String readUserFromSmartContract(...) - स्मार्ट अनुबंध से स्थिति पढ़ता है और परिणाम देता है।

पूरा एप्लिकेशन कोड GitHub रिपॉजिटरी में उपलब्ध है, एक लिंक जो इस लेख के अंत में होगा।

निरीक्षण

सभी 3 प्रकार के लेनदेन का परीक्षण करने के लिए, मैंने परीक्षण कक्षाएं (कोड GitHub रिपॉजिटरी में है) लिखा। ऐसा करने के लिए, मैंने 3 क्वोरम नोड्स (3 गेथ नोड्स + 3 टेसेरा नोड्स) के साथ एक ब्लॉकचेन को तैनात किया। 3 कोरम नोड सभी प्रकार के लेनदेन को सत्यापित करने के लिए आवश्यक न्यूनतम नोड हैं। यदि आप इसे स्वयं आजमाना चाहते हैं तो इसे ध्यान में रखें।

सार्वजनिक लेनदेन

एक सार्वजनिक लेनदेन के साथ एक परीक्षण मामले को निष्पादित करने के लिए, आपको निम्नलिखित कमांड चलाना होगा:

 gradle test --tests *.PublicTransactionsTests 

यह परीक्षण मामला 3 एपीआई अनुरोध भेजेगा। पहला ब्लॉकचैन को स्मार्ट अनुबंध की तैनाती है, दूसरा अनुबंध की स्थिति में परिवर्तन है और तीसरा अनुरोध स्मार्ट अनुबंध से जानकारी को पढ़ना है। परीक्षण के परिणामस्वरूप, आप लगभग निम्न लॉग देखेंगे (आपके नेटवर्क पर पते अलग-अलग होंगे, साथ ही लेनदेन हैश भी होंगे):

 [HANDLER] privateFor = [public] [HANDLER] deploying new smart-contract [HANDLER] contract has been successfully deployed. Result: {contract_address=0xf9425b94e459805da09950f5988071692d925097, transaction_hash=0x31bc179f8cd12c640d1663f3df51ce6da1fbc2875f2b724c3911108fcd19a5d0} [HANDLER] privateFor = [public] [HANDLER] sending new transaction [HANDLER] transaction has been successfully executed. Result: {contract_address=null, transaction_hash=0x33ba66d5deec33f3142bfa190a0d37d0ff07c2e66b06037f5b5ff9578154a3ff} [HANDLER] reading user from smart-contract [HANDLER] user: 'Public Test User' 

सामान्य तौर पर, ये लॉग इंगित करते हैं कि सभी 3 ऑपरेशन सफल रहे थे। पहले 3 लॉग - स्मार्ट अनुबंध की तैनाती के लिए अनुरोध से संबंधित हैं, अगले 3 लॉग - लेन-देन से संबंधित हैं, और अंतिम 2 - स्मार्ट अनुबंध से जानकारी पढ़ने के लिए।
तथ्य यह है कि अनुबंध को लोड करने के परिणाम में हम contract_address देखते हैं, लेकिन एक साधारण लेनदेन के मामले में - नहीं, यह बिल्कुल सामान्य है, क्योंकि दूसरी बार हम अनुबंध को तैनात नहीं करते हैं, लेकिन मौजूदा स्मार्ट अनुबंध पर लेनदेन करते हैं।

अब देखते हैं कि Geth हमें क्या दिखाता है , ग्राहक की Geth प्रक्रिया IPC इंटरफ़ेस से कनेक्ट करने के लिए निम्नलिखित कमांड निष्पादित करें:

 geth attach /path/to/ipc 

हम इस प्रक्रिया के लिए "अभ्यस्त" हो जाने के बाद, आप सभी आवश्यक जानकारी की पूरी तरह से समीक्षा कर सकते हैं। आइए कमांड को निष्पादित करके एक नए स्मार्ट अनुबंध की तैनाती पर TransactionReceipt लेनदेन को देखें (लेन-देन हैश सेट किया जाना चाहिए और परीक्षण लॉग से लिया जाना चाहिए):

 web3.eth.getTransactionReceipt('0x31bc179f8cd12c640d1663f3df51ce6da1fbc2875f2b724c3911108fcd19a5d0'); 

परिणामस्वरूप, हम निम्नलिखित देखते हैं:

हम निम्नलिखित मापदंडों में रुचि रखते हैं:

• "contractAddress" - यदि "शून्य" नहीं है, तो हम समझते हैं कि यह एक स्मार्ट अनुबंध की तैनाती के लिए एक लेनदेन है;
• "स्थिति" - इस मामले में, यह "0x1" के बराबर है - जिसका अर्थ है कि लेनदेन सफल था।

और चलिए लेन-देन को ही देखते हैं। कमांड चलाकर:

 web3.eth.getTransaction('0x31bc179f8cd12c640d1663f3df51ce6da1fbc2875f2b724c3911108fcd19a5d0'); 

परिणाम:

यहाँ हम निम्नलिखित मापदंडों में रुचि रखते हैं:

• "इनपुट" एक पेलोड लेनदेन है;
• "v" - सामान्य तौर पर, यह डिजिटल हस्ताक्षर एल्गोरिदम ईसीडीएसए के लिए एक पैरामीटर है, लेकिन अब हम कुछ और में रुचि रखते हैं - चर का अर्थ। यह महत्वपूर्ण है क्योंकि सार्वजनिक और निजी लेनदेन में यह अलग होगा। "Ix1c" ("दशमलव प्रणाली में 28") और "0x1b" ("दशमलव प्रणाली में 27") सार्वजनिक लेनदेन के लिए विशिष्ट हैं, और "0x25" ("दशमलव प्रणाली में 37") और "0x26 (" 38 "दशमलव में) प्रणाली) - ये निजी लेनदेन कोड हैं।

आप यह भी देख सकते हैं कि अन्य नोड्स पर जानकारी जो हमने देखी थी, उससे भिन्न नहीं है।

अब आप स्मार्ट अनुबंध के लेनदेन की स्थिति में परिवर्तन देख सकते हैं। कमांड चलाएँ:

 web3.eth.getTransactionReceipt('0x33ba66d5deec33f3142bfa190a0d37d0ff07c2e66b06037f5b5ff9578154a3ff'); 

परिणाम:

हम निम्नलिखित मापदंडों में रुचि रखते हैं:

• "टू" - हम देखते हैं कि लेनदेन सिर्फ प्रतीक्षित स्मार्ट अनुबंध के लिए गया था;
• "स्थिति" - यह "0x1" के बराबर है, जिसका अर्थ है कि लेनदेन सफल था।

लेन-देन:

कुछ भी असामान्य नहीं है, लेकिन आप अन्य नोड्स पर जानकारी की जांच कर सकते हैं, यह उपयोगी है।

निजी लेन-देन

एक निजी लेनदेन के साथ एक परीक्षण मामले को निष्पादित करने के लिए, आपको निम्नलिखित कमांड चलाना होगा:

 gradle test --tests *.PrivateTransactionsTests 

सार्वजनिक लेनदेन के साथ परीक्षण के मामले में, यह परीक्षण मामला एक नए स्मार्ट अनुबंध को तैनात करेगा, एक राज्य परिवर्तन लेनदेन को निष्पादित करेगा और स्मार्ट अनुबंध में परिवर्तन से जानकारी पढ़ेगा।

परिणामस्वरूप, प्रोग्राम निम्नलिखित लॉग लिखेगा:

 [HANDLER] privateFor = [] [HANDLER] deploying new smart-contract [HANDLER] contract has been successfully deployed. Result: {contract_address=0x3e2284d92842f781b83cc7e56fbb074ab15f9a90, transaction_hash=0x8fd619bd9a526f83e29d7b417551e174862f7503ef430eb45793509d05039595} [HANDLER] privateFor = [] [HANDLER] sending new transaction [HANDLER] transaction has been successfully executed. Result: {contract_address=null, transaction_hash=0x72a0458a7b313c8a1c18269ae160e140c6a6e41cb2fd087c64cf665b08a6aefb} [HANDLER] reading user from smart-contract [HANDLER] user: 'Private Test User' 

सार्वजनिक लेनदेन के साथ तुलना में बदलाव, प्राइवेटफ़ोर पैरामीटर है - अब इसमें एक खाली सरणी का मूल्य है।
TransactionReceipt लिए TransactionReceipt की जाँच करें। टीम:

 web3.eth.getTransactionReceipt('0x8fd619bd9a526f83e29d7b417551e174862f7503ef430eb45793509d05039595'); 

परिणाम:

सार्वजनिक लेन-देन की तुलना में परिवर्तनों में से, यह कहने योग्य है कि आप लेनदेन पर खर्च होने वाली गैस की राशि नहीं देखेंगे - GasUsed और संचयी GasUsed का मूल्य "0" है।
अब हम लेन-देन को ही देखें। कमांड चलाएँ:

 web3.eth.getTransaction('0x8fd619bd9a526f83e29d7b417551e174862f7503ef430eb45793509d05039595'); 

परिणामस्वरूप, हम इसे देखेंगे:

इस लेनदेन में क्या ध्यान देने योग्य है:

1. जैसा कि मैंने इस लेख की शुरुआत में उल्लेख किया था, वास्तविक पेलोड लेनदेन के बजाय, आपको इनपुट फ़ील्ड में 64 बाइट्स (128 वर्णों) की एक निश्चित रेखा दिखाई देगी। यह रेखा टेसेरा भंडार में डेटा के लिए पहचानकर्ता है, आप टेसेरा के अनुरोध पर वास्तविक डेटा प्राप्त कर सकते हैं।
2. "v" - सार्वजनिक लेनदेन के रूप में कोड "0x1c" या "0x1b" के बजाय, निजी लेनदेन के लिए आपको "0x26" या "0x25" दिखाई देगा।

अब अनुबंध की स्थिति (आप पहले से ही आज्ञाओं को जानते हैं) को बदलने के लिए TransactionReceipt और लेनदेन को स्वयं देखें। परिणाम:

सिद्धांत रूप में, हम इस निजी लेनदेन से कुछ भी नया नहीं सीखेंगे।

अनुमति के लेन-देन

चूंकि ये भी निजी लेनदेन हैं, इसलिए वे केवल 1 नोड के लिए निजी हैं, लेकिन कई के लिए, ऐसे लेनदेन के परिणाम निजी लेनदेन से भिन्न नहीं होंगे। यदि आप निजी नोड में निर्दिष्ट नोड से जानकारी प्राप्त करने का प्रयास करते हैं और ऐसे नोड से जिसकी सार्वजनिक कुंजी निजीफ़ोर में पंजीकृत नहीं है (आप पहली नोड से जानकारी प्राप्त कर सकते हैं और दूसरी से नहीं कर सकते हैं)।
कई नेटवर्क प्रतिभागियों (लेनदेन की अनुमति) के लिए लेनदेन के साथ एक टेस्ट केस चलाने के लिए, आपको निम्नलिखित कमांड चलाने की आवश्यकता है:

 gradle test --tests *.PermissionTransactionsTests 

जावा एपीआई लॉग:

 [HANDLER] privateFor = [wQTHrl/eqa7TvOz9XJcazsp4ZuncfxHb8c1J1njIOGA=] [HANDLER] deploying new smart-contract [HANDLER] contract has been successfully deployed. Result: {contract_address=0xf1cc0ba22bd0d18fc9acb22dd57795a3f2fb4ebd, transaction_hash=0x585980bec88aa8a0fe5caffe6d6f24b82d3cd381fcf72fdd8e2102ce67799f01} [HANDLER] privateFor = [wQTHrl/eqa7TvOz9XJcazsp4ZuncfxHb8c1J1njIOGA=] [HANDLER] sending new transaction [HANDLER] transaction has been successfully executed. Result: {contract_address=null, transaction_hash=0x47edc0d00fa9447b2da9f5a78f44602f96145497238cb1ce1d879afb351a3cbe} [HANDLER] reading user from smart-contract [HANDLER] user: 'Permissioned Test User' 

नए स्मार्ट अनुबंध, TransactionReceipt और स्वयं लेनदेन की तैनाती पर, Geth क्लाइंट में परिणाम क्रमशः:

और राज्य परिवर्तन लेनदेन, TransactionReceipt और स्वयं लेनदेन:

HTTP अनुरोध

इस तथ्य के बावजूद कि हमने देखा कि कैसे सार्वजनिक लेन-देन गेद ग्राहक के दृष्टिकोण से निजी लोगों से अलग है, यह जानकारी प्राप्त करने पर वास्तविक प्रतिबंध नहीं दिखाता है। इसलिए, आपको यह दिखाने के लिए कि आपके लेन-देन को पढ़ने वाले नोड्स की संख्या को सीमित करना वास्तव में संभव है, मैं स्मार्ट अनुबंध से जानकारी पढ़ने के लिए 3 नोड्स के लिए CURL का उपयोग करके कई अनुरोध करूंगा (अनुरोध निजी और प्रचलित लेनदेन की चिंता करेंगे)।
HTTP अनुरोधों में अनुरोध निकाय में 2 पैरामीटर होंगे:

1. "एंडपॉइंट" - कोरम नोड के लिए सीधे समापन बिंदु, आपको नोड से कनेक्ट करने की आवश्यकता है।
2. "contractAddress" उस अनुबंध का पता है जिसमें से डेटा पढ़ा जाएगा।

मेरे मामले में, "एंडोपिंट" में एक होस्ट होगा - लोकलहोस्ट - लेकिन 3 कोरम नोड के लिए अलग-अलग पोर्ट: 22000 (इस नोड से सभी लेनदेन किए गए थे), 22001 (इसकी सार्वजनिक कुंजी अनुमत लेनदेन में निर्दिष्ट की गई थी), 22002 (एक्सेस नहीं होनी चाहिए) जानकारी)।

आइए एक निजी लेनदेन से शुरू करें (केवल 22000 पोर्ट पर एक नोड को एक स्मार्ट अनुबंध में जानकारी देखने में सक्षम होना चाहिए)।

लेनदेन करने वाले नोड पर CURL अनुरोध:

 curl -X POST \ http://127.0.0.1:8080/user \ -H 'Content-Type: application/json' \ -d '{ "endpoint": "http://127.0.0.1:22000", "contractAddress": "0x3e2284d92842f781b83cc7e56fbb074ab15f9a90" }' 

परिणामस्वरूप, हमें निम्नलिखित मिला:

 {"data":{"user":"Private Test User"}} 

इसका मतलब यह है कि नोड में एक स्मार्ट अनुबंध में जानकारी देखने की क्षमता है।

अब देखते हैं कि 22001 पोर्ट पर नोड हमें क्या देता है। CURL अनुरोध:

 curl -X POST \ http://127.0.0.1:8080/user \ -H 'Content-Type: application/json' \ -d '{ "endpoint": "http://127.0.0.1:22001", "contractAddress": "0x3e2284d92842f781b83cc7e56fbb074ab15f9a90" }' 

बहुत बढ़िया! :

 {"data":{"status_code":500,"description":"Something went wrong"}} 

, - — !

, 3- . CURL :

 curl -X POST \ http://127.0.0.1:8080/user \ -H 'Content-Type: application/json' \ -d '{ "endpoint": "http://127.0.0.1:22002", "contractAddress": "0x3e2284d92842f781b83cc7e56fbb074ab15f9a90" }' 

बहुत बढ़िया! API :

 {"data":{"status_code":500,"description":"Something went wrong"}} 

, . "permissioned" .

CURL "permissioned" - , 22000:

 curl -X POST \ http://127.0.0.1:8080/user \ -H 'Content-Type: application/json' \ -d '{ "endpoint": "http://127.0.0.1:22000", "contractAddress": "0xf1cc0ba22bd0d18fc9acb22dd57795a3f2fb4ebd" }' 

:

 {"data":{"user":"Permissioned Test User"}} 

, , , .

- , -, . CURL :

 curl -X POST \ http://127.0.0.1:8080/user \ -H 'Content-Type: application/json' \ -d '{ "endpoint": "http://127.0.0.1:22001", "contractAddress": "0xf1cc0ba22bd0d18fc9acb22dd57795a3f2fb4ebd" }' 

बहुत बढ़िया! :

 {"data":{"user":"Permissioned Test User"}} 

, , . CURL :

 curl -X POST \ http://127.0.0.1:8080/user \ -H 'Content-Type: application/json' \ -d '{ "endpoint": "http://127.0.0.1:22002", "contractAddress": "0xf1cc0ba22bd0d18fc9acb22dd57795a3f2fb4ebd" }' 

बहुत बढ़िया! -. .

निष्कर्ष

, Quorum blockchain Java . , - .

:

1. Quorum
2. Quorum
3. GitHub
4. Quorum Slack

आपका ध्यान के लिए धन्यवाद!