This project implements the SDK to interact with a Casper Node. It wraps the Json-RPC requests and maps the results to Java objects.

Dependencies

• Java 8
• Gradle

Build instructions

./gradlew build

Using the Github repository

Using gradle

plugins {
    id("maven-publish")
}
publishing {
    repositories {
        maven {
            name = "GitHubPackages"
            url = uri("https://maven.pkg.github.com/syntifi/casper-sdk")
            credentials {
                username = project.findProperty("gpr.user") ?: System.getenv("USERNAME")
                password = project.findProperty("gpr.key") ?: System.getenv("TOKEN")
            }
        }
    }
    publications {
        gpr(MavenPublication) {
            from(components.java)
        }
    }
}

Using maven

~/.m2/settings.xml:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                      http://maven.apache.org/xsd/settings-1.0.0.xsd">

  <activeProfiles>
    <activeProfile>github</activeProfile>
  </activeProfiles>

  <profiles>
    <profile>
      <id>github</id>
      <repositories>
        <repository>
          <id>central</id>
          <url>https://repo1.maven.org/maven2</url>
        </repository>
        <repository>
          <id>casper-sdk-github</id>
          <url>https://maven.pkg.github.com/syntifi/casper-sdk</url>
          <snapshots>
            <enabled>true</enabled>
          </snapshots>
        </repository>
      </repositories>
    </profile>
  </profiles>

  <servers>
    <server>
      <id>casper-sdk-github</id>
      <username>USERNAME</username>
      <password>TOKEN</password>
    </server>
  </servers>
</settings>

pom.xml

    <dependency>
      <groupId>com.syntifi.casper</groupId>
      <artifactId>casper-sdk</artifactId>
      <version>0.0.1-SNAPSHOT</version>
    </dependency>

How to

1. Set-up a connection

casperService = CasperService.usingPeer("127.0.0.1","7777");

2. Query a block

Retrieve block info by a block identifier

Last block

JsonBlockData result = casperService.getBlock();

By height

JsonBlockData result = casperService.getBlock(new HeightBlockIdentifier(1234));

By hash

JsonBlockData blockData = casperService.getBlock(new HashBlockIdentifier("--hash--"));

3. Query transfers

Retrieve block transfers by a block identifier

Last block

TransferData transferData = casperService.getBlockTransfers();

By block height

TransferData transferData = casperService.getBlockTransfers(new HeightBlockIdentifier(1234));

By block hash

TransferData transferData = casperService.getBlockTransfers(new HashBlockIdentifier("--hash--"));

3. Query state root hash

Retrieve the state root hash given the BlockIdentifier

Last block

StateRootHashData stateRootData = casperService.getStateRootHash();

By block height

StateRootHashData stateRootData = casperService.getStateRootHash(new HeightBlockIdentifier(1234));

By block hash

StateRootHashData stateRootData = casperService.getStateRootHash(new HashBlockIdentifier("--hash--"));

4. Query deploy

Get a Deploy from the network

DeployData deployData = casperService.getDeploy("--hash--");

5. Query peers

Get network peers data

PeerData peerData = casperService.getPeerData();

6. Query stored value

Retrieve a stored value from the network

StoredValueData result = casperService.getStateItem("--stateRootHash--", "key", Arrays.asList("The path components starting from the key as base"));

7. Get node status

Return the current status of the node

StatusData status = casperService.getStatus()

8. Get account info

Returns an Account from the network

By block height

AccountData account = casperService.getStateAccountInfo("--publicKey--", new HeightBlockIdentifier(1234));

By block hash

AccountData account = casperService.getStateAccountInfo("--publicKey--", new HashBlockIdentifier("--hash--"));

9. Get auction info

Returns the Auction info for a given block

By block height

AuctionData auction = casperService.getStateAuctionInfo(new HeightBlockIdentifier(1234));

By block hash

AuctionData auction = casperServiceMainnet.getStateAuctionInfo(new HashBlockIdentifier("--hash--"));

10. Get era info

Returns an EraInfo from the network

By block height

EraInfoData eraInfoData = casperService.getEraInfoBySwitchBlock(new HeightBlockIdentifier(1234));

By block hash

EraInfoData eraInfoData = casperService.getEraInfoBySwitchBlock(new HashBlockIdentifier("--hash--"));

11. Deploy

Sends a deploy to be received by the network

TODO