Skip to content

Latest commit

 

History

History
205 lines (150 loc) · 5.01 KB

basic.md

File metadata and controls

205 lines (150 loc) · 5.01 KB

Blockhain Interaction

Version 1.0.0

English / 中文

The following describes the basic blockchain interaction functions of the Java SDK and defines relevant data structures.

Please use the following methods to initialize OntSDK before launching JAVA SDK.

OntSdk wm = OntSdk.getInstance();
wm.setRpc(rpcUrl);
wm.setRestful(restUrl);
wm.setDefaultConnect(wm.getRestful());
wm.openWalletFile("OntAssetDemo.json");

Note: setRestful indicates that the connection is established using the restful interface, and setRpc indicates that the connection is established using the rpc interface. setDefaultConnect is used to set this as the default connection method.

Basic operation interfaces

Get the current block height

int height = ontSdk.getConnectMgr().getBlockHeight();

Get block

Get block by block height

Block block = ontSdk.getConnect().getBlock(9757);

Get block by block hash

Block block = ontSdk.getConnect().getBlock(blockhash);

Get block json

Get block by block height

Object block = ontSdk.getConnect().getBlockJson(9757);

Get block by block hash

Object block = ontSdk.getConnect().getBlockJson(blockhash);

Get contract code

Get contract code by contract hash

Object contract =  ontSdk.getConnect().getContract(contractHash)

Get contract json by contract hash

Object contractJson = ontSdk.getConnect().getContractJson(hash)

Get balance

Object  balance = ontSdk.getConnect().getBalance(address)

Get blockchain node count

ontSdk.getConnect().getNodeCount();

Get block height

int blockheight = ontSdk.getConnect().getBlockHeight()

Get smartcontract event

Get smartcontract event by block height

Object  event = ontSdk.getConnect().getSmartCodeEvent(height)

Get smartcontract event by transaction hash

Object  event = ontSdk.getConnect().getSmartCodeEvent(hash)

Get block height by transaction hash

int blockheight = ontSdk.getConnect().getBlockHeightByTxHash(txhash)

Get data stored in smart contract by key

String value = ontSdk.getConnect().getStorage(codehash,key)

Get merkle proof

Object proof =  ontSdk.getConnect().getMerkleProof(String hash)

Get transaction

Transaction info = ontSdk.getConnect().getTransaction(hash);

Get transaction json by transaction hash

Object info = ontSdk.getConnect().getTransactionJson(txhash);

Get InvokeTransaction

InvokeCodeTransaction t = (InvokeCodeTransaction) ontSdk.getConnect().getTransaction(hash);

Data structure

Block

Field Type Description
version int Version
prevBlockHash UInt256 Scripthash of the previous block
transactionsRoot UInt256 Merkel root of all the transactions in the block
blockRoot UInt256 Block root
timestamp int Block time stamp, unix time stamp
height int Block height
consensusData long Consensus data
consensusPayload byte[] Consensus payload
nextBookKeeper UInt160 Bookkeeping contract scripthash of the next block
sigData array Signature
bookKeepers array Bookkeepers
hash UInt256 Hash value of the block
transactions Transaction[] Transaction list in the block

Transaction

Field Type Description
version int Version
txType TransactionType Transaction type
nonce int Random number
attributes Attribute[] Transaction attribute list
gasPrice long Gas price
gasLimit long Gas limit
payer Address Account used to pay fee
sigs Sign[] Signature array
payload Payload Payload

Transaction type

Value Type Description
208 int Smart contract deployment
209 int Smart contract invocation
0 int Bookkeeping
4 int Enrollment
5 int Vote

Signature area

Field Type Description
pubKeys array Public key array
M int M
sigData array Signature value array

Fee

Field Type Description
amount long Amount
payer UInt160 Payer

Attribute

Field Type Description
usage AttributeUsage Usage
data byte[] Attribute value

TransactionAttributeUsage

Value Type Description
0 int Nonce
32 int Script
129 int DescriptionUrl
144 int Description