¶ Hecate Connector API Client SDK
¶ 라이브러리 추가
- jar File
- gradle
dependencies {
compile fileTree(dir: 'libs', include: '*.jar')
}
- maven
<properties>
<project.libs>${project.basedir}/libs</project.libs>
</properties>
<dependencies>
<!-- https://mvnrepository.com/artifact/com.google.code.gson/gson -->
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.9</version>
</dependency>
<dependency>
<groupId>com.uracle.hecate.client</groupId>
<artifactId>com.uracle.hecate.client</artifactId>
<version>1.3.0</version>
<scope>system</scope>
<systemPath>${project.libs}/hecate-connector-client-v1.3.0.jar</systemPath>
</dependency>
</dependencies>
¶ Hecate Connector API 아르고 기능 예제
- 데이터 조회
// Rest API 요청할 인스턴스 생성
RestHelper rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.POST)
.build();
// 아르고 제안서 생성
AergoConnectorProposal proposal = new AergoConnectorProposal();
proposal.setSmartContract(SMARTCONTRACT); // 스마트컨트랙트 주소
proposal.setWalletAddress(WALLET_ADDRESS); // 지갑 주소
proposal.setFuncName(FUNCNAME); // 호출 할 스마트 컨트랙트 메소드명
proposal.setRawData(RAWDATA); // 전달 할 파라미터 값
// 데이터 조회 요청 및 응답 데이터
result = rt.transfer(proposal).receive();
- 데이터 저장
// Rest API 요청할 인스턴스 생성
RestHelper rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.POST)
.build();
// 아르고 제안서 생성
AergoConnectorProposal proposal = new AergoConnectorProposal();
proposal.setSmartContract(SMARTCONTRACT); // 스마트컨트랙트 주소
proposal.setWalletAddress(WALLET_ADDRESS); // 지갑 주소
proposal.setFuncName(FUNCNAME); // 호출 할 스마트 컨트랙트 메소드명
final String name= "hihi";
final String age = "59";
final String sex = "W";
LinkedTreeMap<String, Object> params = new LinkedTreeMap<>();
params.put("name", name);
params.put("age", age);
params.put("sex", sex);
proposal.setRawData(params); // 전달 할 파라미터 값
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer(proposal).receive();
- 트랜잭션 저장(Commit)
// Rest API 요청할 인스턴스 생성
RestHelper rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.POST)
.build();
// 아르고 제안서 생성
AergoConnectorProposal proposal = new AergoConnectorProposal();
proposal.setWalletAddress(WALLET_ADDRESS); // 지갑 주소
final String name= "hihi";
final String age = "59";
final String sex = "W";
LinkedTreeMap<String, Object> params = new LinkedTreeMap<>();
params.put("name", name);
params.put("age", age);
params.put("sex", sex);
proposal.setRawData(params); // 전달 할 파라미터 값
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer(proposal).receive();
- 트랜잭션(거래) 영수증 저장
// Rest API 요청할 인스턴스 생성
RestHelper rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.GET)
.build();
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer().receive();
- Wallet 발급
// Rest API 요청할 인스턴스 생성
rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.GET)
.build();
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer().receive();
- Wallet Nonce 업데이트
사용 가능한 버전 1.3.2이상
final String REST_API_NONCE_UPDATE = "/bc/aergo/wallet/0xa6eb7e9e4c3a8745c3f68c2443a1630a938adf0a/nonce";
String result = null;
String url = CommonUtil.generateUrl(ROOT_URI, REST_API_NONCE_UPDATE);
RestHelper rt = null;
// Rest API 요청할 인스턴스 생성
RestHelper rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.PATCH)
.build();
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer().receive();
- 블록 조회 By BlockHash
String url = CommonUtil.generateUrl(ROOT_URI, REST_API_BLOCK_SPECIFIC).concat("/" + BLOCKHASH);
RestHelper rt = null;
try {
// Rest API 요청할 인스턴스 생성
rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.GET)
.build();
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer().receive();
}
- 블록 조회 By BlockHeight
String url = CommonUtil.generateUrl(ROOT_URI, REST_API_BLOCK_SPECIFIC).concat("/" + BLOCKNUMBER);
RestHelper rt = null;
try {
// Rest API 요청할 인스턴스 생성
rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.GET)
.build();
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer().receive();
}
- 블록 메타 정보 조회 By BlockHash
String url = CommonUtil.generateUrl(ROOT_URI, REST_API_BLOCK_SPECIFIC).concat("/" + BLOCKHASH);
RestHelper rt = null;
try {
// Rest API 요청할 인스턴스 생성
rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.GET)
.build();
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer().receive();
- 블록 메타 정보 조회 By BlockHeight
String url = CommonUtil.generateUrl(ROOT_URI, REST_API_BLOCK_SPECIFIC).concat("/" + BLOCKNUMBER);
RestHelper rt = null;
try {
// Rest API 요청할 인스턴스 생성
rt = new RestHelper
.Builder(url)
.setHttpMethod(HttpMethodType.GET)
.build();
// 데이터 저장 또는 업데이트 요청 및 응답 데이터
result = rt.transfer().receive();
}
¶ 개발 시 주의사항
- hecate-connector-client-v1.x.x.jar에서 제공하는 RestHelper Class를 사용하지않고 담당자 또는 개발자가 사용하는 REST FUL 인터페이스가 있을 시 AergoConnectorProposal Class를 Json Serialize 또는 Json Deserialize 진행 할 경우 아래의 이미지와 같이 GsonInitializer Class로 진행하여야 한다
Gson gson = GsonInitializer.getInstance().getGson();
// Json Serialize
AergoConnectorProposal proposal = new AergoConnectorProposal();
proposal.setSmartContract("ethereum smartcontract");
proposal.setFuncName("hello world");
proposal.setRawData("This is Sample Data!");
String jsonProposal = gson.toJson(proposal);
System.out.println(jsonProposal);
// Json Deserialize
AergoConnectorProposal deProposal = gson.fromJson(jsonProposal, AergoConnectorProposal.class);