client-sdk-java
is the official diem Client SDK for the Java programming language.
SPEC = specification LIP-X = Diem Improvement Protocol
jsonrpc
: diem JSON-RPC APIs client. SPECstdlib
: generated code, move stdlib script utils for constructing transaction script playload.types
: generated code, diem on-chain data structure types. Mostly generated code with small extension code for attaching handy functions to generated types.utils
: utility functions, account address utils, currency code, hashing, hex encoding / decoding, transaction utils.AccountIdentifier
&IntentIdentifier
: encoding & decoding diem Account Identifier and Intent URL. LIP-5DiemClient
: interface of JSON-RPC client.DiemException
: root exception of all checked exceptions defined in SDK.PrivateKey
: abstraction for hiding private key details, implement this interface for plugin your customized private key signing logic.Signer
: sign transaction logic.Testnet
: Testnet utility, minting coins, create Testnet client, chain id, Testnet JSON-RPC URL.TransactionMetadata
: utils for creating peer to peer transaction metadata. LIP-4Constants
: static data and JSON-RPC response enum type values.
You can find all of the example code under the src/test/java/com/diem/examples
directory:
Gradle
implementation 'com.diem:client-sdk-java:1.0.2'
Maven
<dependency>
<groupId>com.diem</groupId>
<artifactId>client-sdk-java</artifactId>
<version>1.0.2</version>
</dependency>
gradle build
Jar file location: build/libs/client-sdk-java.jar
gradle test
// checkout diem submodule
git submodule update diem
// reset diem submodule to diem release revision
cd diem
git fetch/checkout/pull origin <revision/branch>
// re-generate stdlib and lcs type classes
gradle gen
// generate jsonrpc types from protobuf definition
gradle generateProto
// confirm everything works
gradle test