HYPERLEDGER FABRIC
ㄴ Developing Applications
ㄴ Application
독자 : Architects, Application and smart contract developers
원장 컨텐츠를 쿼리하거나 원장에 트랜잭션을 제출하면서 application은 블록체인 네트워크와 상호작용할 수 있습니다.
이번 주제는 어플리케이션이 이를 수행하는 방법에 대한 메커니즘을 다룹니다.
우리의 시나리오에서 조직은 기업 어음 스마트 계약 안에서 정의된 issue, buy, redeem 트랜잭션을 불러일으키는 application을 사용하여 PaperNet에 접근허용합니다.
기업 어음을 발행(issue)하기 위한 MagnetoCorp의 application은 기본이며 모든 이해의 주요 포인트입니다.
이번 주제에서는 아래의 항목을 다룹니다.
- The application flow to invoke a smart contract
- How an application uses a wallet and identity
- How an application connects using a gateway
- How to access a particular network
- How to construct a transaction request
- How to submit a transaction
- How to process a transaction response
이해를 돕기 위해 우리는 Hyperledger Fabric과 함께 제공되는 기업 어음 예제 application을 참조합니다.
당신은 다운로드 (Getting Started »Install Samples, Binaries and Docker Images)할 수 있고, 로컬에서 실행(Tutorials » Commercial paper tutorial)할 수 있습니다.
JavaScript와 Java로 작성되었으며, logic은 언어와 무관하므로, 무슨 일이 일어나고 있는지 쉽게 볼 수 있습니다. (샘플은 Go에서도 사용할 수 있습니다.)
Basic Flow (The application flow to invoke a smart contract)
application은 Fabric SDK를 사용하여 블록체인 네트워크와 상호작용합니다.
여기에 application이 기업 어음 스마트 계약을 불러오는 방법에 대한 간단한 다이어그램이 있습니다.
PaperNet application은 기업 어음 스마트 계약을 호출하여 issue 트랜잭션 요청을 제출합니다.
application은 트랜잭션을 제출하기 위해 6가지 기본 단계를 따라야합니다.
- wallet에서 identity를 선택
- gateway에 연결
- 원하는 네트워크에 액세스
- 스마트 계약에 대한 트랜잭션 요청을 구성
- 네트워크에 트랜잭션을 제출
- 응답 처리
일반적인 application이 Fabric SDK를 사용하여 이런 6가지 단계를 수행하는 것을 볼 수 있습니다.
issue.js 파일에서 application code를 찾을 수 있습니다.
브라우저에서 보거나, 다운로드해서 좋아하는 에디터로 열어보세요.
application의 전체 구조를 잠시 살펴보세요. 주석과 공백이 있어도 100줄입니다!
Wallet (How an application uses a wallet and identity)
issue.js의 맨 위에는 두 개의 Fabric 클래스가 범위에 포함된 것을 볼 수 있습니다.
const { FileSystemWallet, Gateway } = require('fabric-network');
node SDK documentation에서 fabric-network 클래스들에 대해 읽어볼 수 있지만, 지금은 MagnetoCorp의 application을 PaperNet에 연결하는데 어떻게 사용하는지 알아봅시다.
application은 다음과 같이 Fabric Wallet 클래스를 사용합니다.
const wallet = new FileSystemWallet('../identity/user/isabella/wallet');
로컬 파일시스템에서 wallet은 wallet(Developing Applications » Application design elements » Wallet)에 어떻게 위치해있는지 알아보세요.
wallet에서 찾은 신분은 issue application을 사용하는 이사벨라라는 사용자를 위한 것입니다.
wallet에는 Fabric network 또는 PaperNet에 접근하기위해 사용하는 일련의 ID(X.509 digital certificates)들이 있습니다.
만약 튜토리얼을 실행하고, 디렉토리를 보면, 이사벨라의 자격 증명이 보일 것입니다.
신분증, 운전면허증, ATM 카드의 디지털 등가물이 들어있는 지갑을 생각해보세요.
그 안에 있는 X.509 digital certificates는 소유자를 조직과 연결하여, 네트워크 채널안에서 권한을 부여합니다.
예를 들어, 이사벨라는 MagnetoCorp의 관리자가 될 수 있으며, 이것은 다른 유저(예를 들어, DigiBank의 Balaji)보다 그녀에게 더 특권을 주게되는 것입니다.
게다가, 스마트 계약은 트랜잭션 context(Developing Applications » Application design elements » Transaction context)를 사용하여 스마트 계약을 처리하는 중에 ID를 검색할 수 있습니다.
지갑은 신원을 보유하고 있지 어떠한 형태의 현금이나 토큰을 보유하지 않습니다.
Gateway (How an application connects using a gateway)
두 번째 주요 클래스는 Fabric Gateway입니다.
가장 중요한 것은 gateway(Developing Applications » Application design elements » Gateway)는 네트워크(우리의 경우 PaperNet)에 접근을 제공하는 하나 이상의 peer를 식별한다는 것입니다.
어떻게 issue.js가 그것의 gateway에 연결하는지 확인하세요.
await gateway.connect(connectionProfile, connectionOptions);
gateway.connect() 는 두가지 중요한 변수를 가지고 있습니다.
- connectionProfile : PaperNet에 대한 gateway로서 peer 집합을 식별하는 connection profile(Developing Applications >> Application design elements >> Connection Profile)의 파일 시스템 위치
- connectionOptions : issue.js와 PaperNet이 상호작용하는 방법을 제어하는데 사용되는 옵션 집합
어떻게 클라이언트 application이 변경될 수 있는 네트워크 토폴로지로부터 자신을 격리하기 위해 gateway를 사용하는지 확인하세요.
connection profile(Developing Applications » Application design elements » Connection Profile)과 connection options(Developing Applications » Application design elements » Connection Options)를 사용하는 네트워크에서 gateway는 트랜잭션 요청을 올바른 peer 노드로 보냅니다.
connection profile ./gateway/connectionProfile.yaml을 살펴보세요. YAML을 사용하여 읽기 쉽게 만들어졌습니다.
JSON 객체로 변환되고 로드되었습니다.
let connectionProfile = yaml.safeLoad(file.readFileSync('./gateway/connectionProfile.yaml', 'utf8'));지금 우리는 profile의 섹션에서 channels: 과 peers: 에만 관심이 있습니다. (상황을 더 잘 설명하기 위해 세부사항을 수정했습니다.)
| channels: papernet: peers: peer1.magnetocorp.com: endorsingPeer: true eventSource: true peer2.digibank.com: endorsingPeer: true eventSource: true peers: peer1.magnetocorp.com: url: grpcs://localhost:7051 grpcOptions: ssl-target-name-override: peer1.magnetocorp.com request-timeout: 120 tlsCACerts: path: certificates/magnetocorp/magnetocorp.com-cert.pem peer2.digibank.com: url: grpcs://localhost:8051 grpcOptions: ssl-target-name-override: peer1.digibank.com tlsCACerts: path: certificates/digibank/digibank.com-cert.pem |
channel: 이 PaperNet: 네트워크 채널, 그리고 그것의 두가지 peer를 식별하는 방법을 확인하세요.
MagnetoCorp는 peer1.magnetocorp.com을 DigiBank는 peer2.digibank.com을 가지고 있으며, 둘 다 peer를 보증하는 역할을 합니다.
해당 네트워크 주소를 포함하여 그들에 연결하는 방법에 대한 세부사항이 포함된 peers: 키를 통해 이러한 peer에 연결합니다.
connection profile은 peer뿐만 아니라 네트워크 채널, 네트워크 주문자, 조직, CA 등 더 많은 정보를 포함하고 있으므로 모든 정보를 이해하지 못하더라도 걱정하지 마세요!
connectionOptions 객체로 주의를 돌려보겠습니다.
let connectionOptions = {
identity: userName,
wallet: wallet
}gateway에 연결하기 위해 identity에 username 그리고 wallet에 wallet을 어떻게 명시하는지 살펴보세요.
code에서 미리 값이 할당되었습니다.
application이 SDK를 대신하여 지능적으로 동작하도록 지시하는데 사용하는 다른 connection options(Developing Applications » Application design elements » Connection Options)이 있습니다.
let connectionOptions = {
identity: userName,
wallet: wallet,
eventHandlerOptions: {
commitTimeout: 100,
strategy: EventStrategies.MSPID_SCOPE_ANYFORTX
},
}여기서 commitTimeout은 SDK는 트랜잭션이 커밋되었는지 알기 위해 100초를 기다리도록합니다.
그리고 strategy: EventStrategies.MSPID_SCOPE_ANYFORTX 는 단일 MagnetoCorp peer가 트랜잭션을 확인한 후 SDK가 application에 알릴 수 있도록 명시합니다.
트랜잭션을 확인하기 위해 MagnetoCorp와 DigiBank의 모든 peer를 요구하는 strategy: EventStrategies.NETWORK_SCOPE_ALLFORTX와는 대조적입니다.
원하는 경우, 어떻게 application이 명시적으로 어떻게 달성하는지에 대한 걱정 없이 connection options이 목표 지향적인 행동을 명시할 수 있는지에 대해 더 읽어보세요.
Network Channel (How to access a particular network)
connectionProfile.yaml 게이트웨이에 정의된 peer들은 PaperNet에 접근하는 issue.js를 제공합니다.
이러한 peer들은 여러 네트워크 채널에 연결될 수 있기 때문에, gateway는 사실 여러 네트워크 채널에 액세스하는 application을 제공합니다.
어떻게 application이 특정 채널을 선택하는지 보세요.
const network = await gateway.getNetwork('PaperNet');위 시점부터 계속 network는 PaperNet에 접근을 제공할 것입니다.
게다가 application이 동시에 다른 네트워크(BondNet 같은)에 접근하려는 경우에도 쉽습니다.
const network2 = await gateway.getNetwork('BondNet');이제 우리 application은 PaperNet과 동시에 두번째 네트워크(BondNet)에 액세스할 수 있습니다.
우리는 Hyperledger Fabric의 강력한 기능인 여러 네트워크 채널에 연결된 여러 gateway peer들의 연결에 의해 appllication이 네트워크들의 네트워크에 참여하는 것을 볼 수 있었습니다.
application은 gateway.connect()에 있는 그들의 지갑 ID에 따라 다른 채널마다 다른 권한을 갖습니다.
Construct request (How to construct a transaction request)
application은 기업 어음을 발행(issue)할 준비가 되었습니다.
이를 하기 위해 CommercialPaperContract를 다시 사용하며, 스마트 계약에 접근하는 것은 상당히 간단합니다.
const contract = await network.getContract('papercontract', 'org.papernet.commercialpaper');application이 name(papercontract)과 명시적인 contract name(org.papernet.commercialpaper)을 정하는지 확인하세요.
Contract name(Developing Applications » Application design elements » Contract names)은 여러 계약을 포함하는 papercontract.js 체인코드 파일에서 하나의 계약을 선택하는 것을 확인하세요.
PaperNet에서 papercontract.js는 papercontract와 함께 설치, 인스턴스화 되었습니다. 관심이 있으면 여러 스마트 계약을 포함하는 체인 코드를 설치하는 방법, 인스턴스화하는 방법을 읽어보세요(Tutorials » Chaincode for Operators).
만약 우리의 application이 동시에 PaperNet이나 BondNet의 다른 계약에 접근을 요청하는 경우도 쉽습니다.
const euroContract = await network.getContract('EuroCommercialPaperContract');
const bondContract = await network2.getContract('BondContract');이 예제에서 어떻게 contract name을 사용하지 않았는지 확인하세요.
우리는 파일당 오직 하나의 스마트 계약을 가지고 있으며, getContract() 가 찾은 첫번째 계약를 사용합니다.
MagnetoCorp가 첫번째 기업 어음을 발행하기위해 사용한 트랜잭션을 상기하세요.
| Txn = issue Issuer = MagnetoCorp Paper = 00001 Issue time = 31 May 2020 09:00:00 EST Maturity date = 30 November 2020 Face value = 5M USD |
이제 이 트랜잭션을 PaperNet에 제출하겠습니다!
Submit transaction (How to submit a transaction)
트랜잭션 제출은 SDK에 단일 메소드 호출입니다.
const issueResponse = await contract.submitTransaction('issue', 'MagnetoCorp', '00001', '2020-05-31', '2020-11-30', '5000000');submitTransaction() 파라미터는 트랜잭션 요청과 어떻게 매치되는지 확인하세요.
스마트 계약의 issue() 메소드를 통과할 그리고 새로운 기업 어음을 만들기위해 사용될 값들 입니다.
특징을 기억하세요.
async issue(ctx, issuer, paperNumber, issueDateTime, maturityDateTime, faceValue) {...}application이 submitTransaction()으로 발행한 후, 스마트 계약은 곧 제어를 받는 것처럼 보일 수 있지만 그렇지는 않습니다.
내부적으로 필요한 보증을 받을 수 있는 네트워크의 올바른 peer에 트랜잭션 요청을 보내기 위해 SDK는 connectionOptions와 connectionProfile의 세부사항을 사용합니다.
그러나 application은 submitTransaction 발행, 모든 것을 처리하는 SDK에 대해 걱정할 필요가 없습니다.
submitTransaction API는 트랜잭션 커밋을 수신하는 과정이 포함되어있음을 확인하세요.
트랜잭션이 성공적으로 주문되고 검증되고 원장에 커밋되었는지 알지 못하기 때문에 커밋을 수신해야합니다.
이제 어떻게 application이 응답을 처리하는지 살펴보겠습니다.
Process response (How to process a transaction response)
어떻게 papercontract.js로부터 issue 트랜잭션이 기업 어음 응답을 반환하는지 확인하세요.
return paper.toBuffer();새로운 paper는 application에 return되기 전에 버퍼로 변환이 필요하다는 약간 특이한 점을 알 수 있습니다.
issue.js 가 기업 어음으로써 응답 버퍼를 원래 상태로 돌아가게 하기 위해 CommercialPaper.fromBuffer() 클래스 메소드를 어떻게 사용하는지 확인하세요.
let paper = CommercialPaper.fromBuffer(issueResponse);
이를 통해 paper는 설명하는 완료 메세지 안에서 자연스럽게 사용될 수 있습니다.
console.log(`${paper.issuer} commercial paper : ${paper.paperNumber} successfully issued for value ${paper.faceValue}`);어떻게 동일한 paper 클래스가 application과 smart contract 둘 다에서 사용되었는지 확인하세요.
만약 이런식으로 코드를 짰다면, 가독성과 재사용에 큰 도움이 될 것입니다.
트랜잭션 요청과 마찬가지로, 스마트 계약이 완료된 후에 application이 제어권을 받는 것처럼 보일 수 있겠지만 그렇지 않습니다.
내부적으로는 SDK는 전체 합의 프로세스를 관리하고 strategy connectionOption에 따라 완료되면 application에 알립니다.
만약 SDK 내부적으로 수행하는 작업에 흥미가 있다면, 자세한 트랜잭션 흐름(Architecture Reference » Transaction Flow)을 읽어보세요.
이게 다 입니다. 이번 주제에서 MagnetoCorp의 application이 PaperNet에서 새로운 기업 어음을 어떻게 발행하는지 조사하며 샘플 application으로부터 스마트 계약을 호출하는 방법을 이해했습니다.
이제 주요 원장과 architecture topic (Developing Applications » Process and Data Design)에서 설계된 스마트 계약 데이터 구조를 조사해봅시다.
출처 ]
hyperledger-fabric.readthedocs.io/en/release-1.4/developapps/application.html