Skip to content

Latest commit

 

History

History
151 lines (129 loc) · 3.29 KB

README.md

File metadata and controls

151 lines (129 loc) · 3.29 KB
Raw

Panacea Java SDK

Installation

Gradle

repositories {
    maven {
        url = "https://maven.pkg.github.com/medibloc/panacea-java"
        // GitHub Packages credentials
        credentials {
            username = System.getenv("GPR_USER")
            password = System.getenv("GPR_API_KEY")
        }
    }
    mavenCentral()
}

dependencies {
    implementation 'org.medibloc.panacea:panacea-java:2.2.0'
}

Feature

  • The functions we support are as follows.
    • Broadcast tx
    • Get account / balance / tx(s) / block / node
    • Get aol(topic,record)
    • Get did document
    • Get denom / pnft

Broadcast tx

Send Coin

  • Create a PanaceaGrpcClient object.
ManagedChannel channel = ManagedChannelBuilder.forTarget("{ip or domain}:{port}")
            .usePlaintext()
            .build();
PanaceaGrpcClient client = new PanaceaGrpcClient(channel);
  • Create a Wallet and init.
  • Required your mnemonic.
Wallet wallet = Wallet.createWalletFromMnemonicCode(mnemonic, "panacea", 0);
wallet.ensureWalletIsReady(client);
  • Make msg.
  • Create MsgSend here.
Coin sendCoin = Coins.createCoin("umed", "100000000");
MsgSend msg = MsgSend.newBuilder()
        .addAmount(sendCoin)
        .setFromAddress(ownerAddress)
        .setToAddress(toAddress)
        .build();
  • Create BroadcastTxRequest with Fee
Fee fee = Transactions.createFee(Coins.createCoin("umed", "1000"), 200000);
BroadcastTxRequest request = Transactions.createBroadcastTxRequest(
        wallet,
        msg,
        "send coin",
        fee,
        BroadcastMode.BROADCAST_MODE_BLOCK);
BroadcastMode Description
BROADCAST_MODE_BLOCK Waits for the tx to be committed in a block.
BROADCAST_MODE_SYNC Waits for a CheckTx execution response only.
BROADCAST_MODE_ASYNC Returns immediately (transaction might fail)
  • Now do broadcast.
TxResponse response = client.broadcast(request);
Assert.assertEquals(0, response.getCode());

Query

  • You simply need to call method.

Account

BaseAccount account = client.getAccount(ownerAddress);
String publicKey = CryptoUtils.getPublicKeyFrom(account);

Balance

Coin ownerCoin = client.getBalance(ownerAddress, "umed");

Node

DefaultNodeInfo nodeInfo = client.getNodeInfo();

Tx

Tx tx = client.getTx(txHash);

TxResponse

TxResponse txResponse = client.getTxResponse(txHash);

Txs

List<Tx> txs = client.getTxsByHeight(height);

TxResponses

List<TxResponse> txResponses = client.getTxResponsesByHeight(height);

Txs and TxResponses with pagination

int offset = 0, limit = 2, total = 0;
while (true) {
    PageRequest pagination = PageRequest.newBuilder().setOffset(offset).setLimit(limit).setCountTotal(true).build();
    GetTxsEventResponse resp = client.getTxsByHeight(height, pagination);
    
    List<Tx> txs = resp.getTxsList();
    List<TxResponse> txResponses = resp.getTxResponsesList();

    offset += resp.getTxsCount();
    total += resp.getTxsCount();
    if (total >= resp.getPagination().getTotal()) {
        break;
    }
}

Block

Block block = client.getBlockByHeight(height);

LastBlock

Block block = client.getLatestBlock();