Skip to main content
Version: IOTA

Examples in Java

This section will guide you through several examples using the Java binding of the wallet.rs library. You can also find the code for the examples in the /bindings/java/examples/java-app folder in the official GitHub repository.

git clone -b production https://github.com/iotaledger/wallet.rs
cd wallet.rs/bindings/java

Examples are all collected in a sample project. By default, it runs a node info example, but there are more.

You can run the example with Gradle or Maven using the following commands:

Gradle: ./gradlew examples:java-app:test --info

Maven: cd examples/java-app && mvn test

Backup and Restore​

  1. Create an account manager and set a password:
AccountManager manager = AccountManager.Builder().finish();

manager.setStrongholdPassword("password");
manager.storeMnemonic(AccountSignerType.STRONGHOLD, null);

  1. Create your account:
ClientOptions clientOptions = new ClientOptionsBuilder()
    .withNode("https://api.lb-0.h.chrysalis-devnet.iota.cafe")
    .build();
Account account = manager
    .createAccount(client_options)
    .alias("alias")
    .initialise();
String id = account.id();

  1. Secure your account in a backup file:
// backup the stored accounts to ./backup/${backup_name}
Path backupPath = manager.backup("./backup");
  1. You can import the backup later, or in another application using the following snippet:
manager.importAccounts(backupPath, "password");

Account imported_account_handle = manager.getAccount(id);

That's it! You can now backup and restore your account!

Transfering Funds​

  1. Get or Create your account:
AccountManager manager = AccountManager.Builder().finish();

manager.setStrongholdPassword("password");

// Get account or create a new one
String accountAlias = "alias";
Account account;
try {
    account = manager.getAccount(accountAlias)
} catch (WalletException e) {
    // first we'll create an example account and store it
    manager.storeMnemonic(AccountSignerType.STRONGHOLD, null);
    ClientOptions clientOptions = new ClientOptionsBuilder()
        .withNode("https://api.lb-0.h.chrysalis-devnet.iota.cafe")
        .build();
    account = manager
        .createAccount(client_options)
        .alias(accountAlias)
        .initialise();
}
  1. Generate the address:
Address address = account.generateAddress();
  1. Print and wait:
System.out.println("Send iotas from the faucet to {} and press enter after the transaction got confirmed" +
    address
);

System.in.read();
  1. Send and wait:
System.out.println("Sending transfer...");
Message message = account
    .transfer(
        Transfer.builder(
            AddressWrapper.parse("atoi1qzt0nhsf38nh6rs4p6zs5knqp6psgha9wsv74uajqgjmwc75ugupx3y7x0r"),
            10000000,
            OutputKind.SIGNATURE_LOCKED_DUST_ALLOWANCE),
        )
        .finish(),
    );
System.out.println("Message sent: " + message.id());

Listen to Events​


You can find more advanced examples in the examples folder.