xuper-java-sdk

https://github.com/xuperchain/xuper-java-sdk
Admin
Java SDK for XuperChain, providing functionalities to interact with the blockchain.
Tokens:1,594
Snippets:25
Trust Score:7.2
License:Apache-2.0
Update:4 months ago
Show doc for...
Tokens:
Raw
### Query Account Balance Details

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Get detailed balance information for an account, which may include different token types or other specifics. Returns an array of BalDetails.

```java
XuperClient.BalDetails[] result = client.getBalanceDetails("XC1111111111111111@xuper");
```

--------------------------------

### Invoke WASM Contract

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Invoke a function within a deployed WASM contract. This example shows how to increase a counter. It prints the transaction ID, response body, and gas used.

```java
Map<String, byte[]> args = new HashMap<>();
args.put("key", "icexin".getBytes());
Transaction tx = client.invokeContract(account, "wasm", "counter", "increase", args);
System.out.println("txid: " + tx.getTxid());
System.out.println("response: " + tx.getContractResponse().getBodyStr());
System.out.println("gas: " + tx.getGasUsed());
```

--------------------------------

### Import Account from Local Keys

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Load an existing account from local key files. Ensure the keys directory is correctly specified.

```java
// Import account from local keys
Account account = Account.create("./keys");
```

--------------------------------

### Create XuperClient Instance

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Initialize the XuperClient to connect to the Xuperchain network. Specify the host and port of the node.

```java
XuperClient client = new XuperClient("127.0.0.1:37101");
```

--------------------------------

### Configure SDK Path

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Set the configuration file path for the SDK, especially if using the endorsement feature. The configuration file is typically located in the conf directory.

```java
Config.setConfigPath("./conf/sdk.yaml");
```

--------------------------------

### Create New Account and Mnemonic

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Generate a new account with a specified number of words for the mnemonic. The address and mnemonic are then printed.

```java
// Import account from local keys
Account account = Account.create(1, 2);
System.out.println(account.getAddress());
System.out.println(account.getMnemonic());
```

--------------------------------

### Deploy EVM Contract

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Deploy an Ethereum Virtual Machine (EVM) contract. Requires the contract's ABI, binary code, name, and initial arguments. The `xuperClient` variable is assumed to be initialized.

```java
String abi = "[{"inputs":[{"internalType":"uint256"......";
String bin = "6080604......";

Map<String, String> args = new HashMap<>();
args.put("num", "5889");

Transaction t = client.deployEVMContract(account, bin.getBytes(), abi.getBytes(), contractName, args);
System.out.println("txID:" + t.getTxid());
```

--------------------------------

### Create Contract Account

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Create a new contract account on the Xuperchain network using an existing account. The contract account name must follow the format XC... @xuper.

```java
// The account name is XC1111111111111111@xuper
client.createContractAccount(account, "1111111111111111");
```

--------------------------------

### Deploy WASM Contract

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Deploy a WebAssembly (WASM) contract to the Xuperchain network. This requires setting the contract account, providing the contract code, name, runtime, and initial arguments.

```java
// Using a contract account to deploy contract
account.setContractAccount("XC1111111111111111@xuper");
Map<String, byte[]> args = new HashMap<>();
args.put("creator", "icexin".getBytes());
String codePath = "./counter.wasm";
byte[] code = Files.readAllBytes(Paths.get(codePath));
// the runtime is c
client.deployWasmContract(account, code, "counter", "c", args);
```

--------------------------------

### Query Account Balance

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Retrieve the balance of a specific account on the Xuperchain network. The balance is returned as a BigInteger.

```java
BigInteger result = client.getBalance("XC1111111111111111@xuper");
```

--------------------------------

### Add Maven Dependency

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Include the Xuper Java SDK in your Maven project by adding this dependency to your pom.xml file.

```xml
<dependency>
  <groupId>com.baidu.xuper</groupId>
  <artifactId>xuper-java-sdk</artifactId>
  <version>0.2.0</version>
</dependency>
```

--------------------------------

### Query EVM Contract Method

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Query a method on an EVM contract without sending a transaction. This is typically used for reading state. The `xuperClient` variable is assumed to be initialized.

```java
Transaction t2 = xuperClient.queryEVMContract(account, contractName, "retrieve", null);
System.out.println("tx res getMessage:" + t2.getContractResponse().getMessage());
System.out.println("tx res getBodyStr:" + t2.getContractResponse().getBodyStr());
```

--------------------------------

### Invoke Payable EVM Contract Method

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Invoke a payable method on an EVM contract. The `Amount` parameter can be null if no Xuper is transferred to the contract. The `xuperClient` variable is assumed to be initialized.

```java
// storagepay is a payable method. Amount param can be NULL if there is no need to transfer to the contract.
Transaction t1 = xuperClient.invokeEVMContract(account, contractName, "storepay", args, BigInteger.ONE);
System.out.println("txID:" + t1.getTxid());
System.out.println("tx gas:" + t1.getGasUsed());
```

--------------------------------

### Transfer Xuper to Contract Account

Source: https://github.com/xuperchain/xuper-java-sdk/blob/master/README.md

Transfer a specified amount of Xuper tokens from one account to another, typically a contract account. The last parameter is the memo.

```java
client.transfer(account, "XC1111111111111111@xuper", BigInteger.valueOf(1000000), "1");
```
Tokens:
Raw