Merge branch 'release-v1.0.0-beta8'

Author: Brord van Wierst

README.md

@@ -69,12 +69,23 @@ To download the IOTA Java client library and its dependencies, you can use one o
 
     ```gradle
     dependencies {
-        compile 'com.github.iotaledger:iota-java:1.0.0-beta7'
+        compile 'com.github.iotaledger:iota-java:1.0.0-beta8'
     }
     ```
     
 ### Downloading the library with Maven
+#### Through Maven central
+1. Add the following repository to your root `pom.xml` file:
+    ```xml
+    <dependency>
+        <groupId>org.iota</groupId>
+        <artifactId>jota</artifactId>
+        <classifier>jar-with-dependencies</classifier>
+        <version>1.0.0-beta8</version>
+    </dependency>
+    ```
 
+#### Through Jitpack
 1. Add the following repository to your root `pom.xml` file:
     ```xml
     <repositories>
@@ -96,7 +107,7 @@ To download the IOTA Java client library and its dependencies, you can use one o
     ```
     
 3. Change the value of the `<version>` tag to either a release number or the first 10 characters of a Git commit hash:
-`<version>efdc784d8a9ef</version>` or `<version>1.0.0-beta7</version>`
+`<version>efdc784d8a9ef</version>` or `<version>1.0.0-beta8</version>`
 
 **Note:** Find the latest version on the [Jitpack](https://jitpack.io/#iotaledger/iota-java) page.
 
@@ -108,7 +119,8 @@ To download the IOTA Java client library and its dependencies, you can use one o
     * jota
     * jota-parent
 
-2. Reference the jota directory in your project
+2. Import and reference the jota directory in your project
+For example in Eclipse: `right mouse on your project -> Properties -> Java Build Path -> Projects -> Add 'jota'`
 
 3. In the jota directory, run the following command:
 
@@ -181,7 +193,60 @@ Here are some of the most commonly used API functions:
 We have a list of test cases on the [`src/test/java` directory][tests] that you can use as a reference when developing apps with IOTA.
 A good starter is the [`IotaAPITest` case](https://github.com/iotaledger/iota-java/blob/master/jota/src/test/java/org/iota/jota/IotaAPITest.java).
 
+### Creating and broadcasting transactions
+This example shows you how to create and send a transaction to an IRI node by calling the `prepareTransfers()` method and piping the prepared bundle to the `sendTrytes()` method.
+
+```java
+String fromAddr = "G9OPCBSQZO9GUNOYLLJYY ... JCF9TCDSZAU9VSOCZPC";
+String toAddr =   "TKGLOMEGTJWXIKDTF9CAV ... 9Q9RHCNDXTLGJYJPYM9";
+
+// difficulty of the proof of work required to attach a transaction on the tangle
+int mwm = 14;
+
+// how many milestones back to start the random walk from
+int depth = 3;
+
+// create a transfer to the given recipient address
+// optionally define a message and tag
+List<Transfer> transfers = new LinkedList<>();
+transfers.add(new Transfer(toAddr, 80, "MESSAGE", "TAG"));
+
+// create inputs for the transfer, this address contains 100 iota
+List<Input> inputs = new LinkedList<>();
+inputs.add(new Input(fromAddr, 100, 0, Constants.MAX_SECURITY_LEVEL));
+
+// create an address for the remainder.
+// in this case we will have 20 iotas as the remainder, since we spend 1000 from our input
+// address and only send 80 to the recipient.
+String remainder = api.generateNewAddresses(
+            new AddressRequest.Builder(seed, Constants.MAX_SECURITY_LEVEL).amount(1).checksum(true).build()
+        ).first();
+
+// Prepare the transfer by creating a bundle with the given transfers and inputs.
+// The result are trytes ready for PoW.
+List<String> trytes = api.prepareTransfers(seed, 3, transfers, remainder , inputs, null, false);
+
+// You can decrease your chance of sending to a spent address by checking the address before
+// broadcasting your bundle.
+WereAddressesSpentFromResponse spent = api.wereAddressesSpentFrom(transfers.get(0).getAddress());
+if (spent.getStates()[0]) {
+    System.out.println("Recipient address is spent from, aborting transfer");
+    return;
+}
+
+// at this point the bundle trytes are signed.
+// now we need to:
+// 1. select two tips
+// 2. do proof-of-work
+// 3. broadcast the bundle
+// 4. store the bundle
+// sendTrytes() conveniently does the steps above for us.
+List<Transaction> bundle = api.sendTrytes(trytes.toArray(new String[0]), depth, mwm, null);
+System.out.println("broadcasted bundle with tail tx hash: " + bundle.get(0));
+```
+
 ## Change logs:
+- Changes in [**1.0.0-beta8**](https://github.com/iotaledger/iota-java/compare/1.0.0-beta7...1.0.0-beta8)
 - Changes in [**1.0.0-beta7**](https://github.com/iotaledger/iota-java/compare/1.0.0-beta6...1.0.0-beta7)
 - Changes in [**1.0.0-beta6**](https://github.com/iotaledger/iota-java/compare/1.0.0-beta5...1.0.0-beta6)
 - Changes in [**1.0.0-beta5**](https://github.com/iotaledger/iota-java/compare/1.0.0-beta4...1.0.0-beta5)

docs/iota-java/addRemainder.md

@@ -1,5 +1,5 @@
 
-# [addRemainder](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L1529)
+# [addRemainder](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L1527)
  List<String> addRemainder(String seed , int security , List<[Input](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Input.java)> inputs , [Bundle](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Bundle.java) bundle , String tag , long totalValue , String remainderAddress , List<String> signatureFragments)
 
 Uses input, and adds to the bundle, untill `totalValue` is reached. If there is a remainder left on the last input, a remainder transfer is added.
@@ -41,7 +41,7 @@ Uses input, and adds to the bundle, untill `totalValue` is reached. If there is
  IotaAPI iotaAPI = new IotaAPI.Builder().build();
 
 try { 
-    List<String> response = iotaAPI.addRemainder("YOUR9SECRET9SEED9999999...", 3, new List<Input>(new Input[]{inputs, inputs}), bundle, "TAG9TIGHDELJXFHN9KLKZHVGBST", 284, "LTWUDWCICFHSWYOXMBWXEYQGBJNAKHCXIQGSTOQOTJR9DBOOVYGZ9NLHAK9FGCSXWKTBPBBMOVZMJBHKJ", new List<String>(new String[]{"PSDFHESDBFMKIEGSKIYHTIQEC ... BDVYKAQWWAGBZBPSFVKWBY9YB", "PSXXTETHXPZPIUQNMCORDIOOG ... QCFIIPMYGROYCQAMKSNIUDJPG"}));
+    List<String> response = iotaAPI.addRemainder("YOUR9SECRET9SEED9999999...", 3, new List<Input>(new Input[]{inputs, inputs}), bundle, "TAG9QXJKVCMJTZKDLKBDJOFUNBG", 694, "YSSJTOKAUD9OVFEGQUPN9GRHEZAOUFGYUMJAVWTK9RVSTXGJMH9JPSLIWDPVXFXMIVIFCFF9DENNVILDV", new List<String>(new String[]{"IANOICEWWXZAPDVKYHHVFHBCP ... ZGCSQDTXDPRTRPHHTZOFCRPYA", "LYSKNTDRWDLVCFXDHVKSDDVPY ... SWCBVCPPELYHKWUGEFWMZUFER"}));
 } catch (ArgumentException e) { 
     // Handle error
     e.printStackTrace(); 

docs/iota-java/bundlesFromAddresses.md

@@ -29,7 +29,7 @@ Internal function to get the formatted bundles of a list of addresses.
  IotaAPI iotaAPI = new IotaAPI.Builder().build();
 
 try { 
-    Bundle[] response = iotaAPI.bundlesFromAddresses(false, new String[]{"UTSPUMBBRHRCVMPKAWDRXIFUYHOYLJGTZ9DTRIQJFD9UFDYCNLFQBV9LTOMGASNPWVFMCAMKVKOCVNZKG", "WAZEFGAKXRACVFNEP9JXYPASTZVBYXF9UNHKUHRUDWDBETAJYD9OFWBOJON9FDQRRBTVXZMCMMTLZLRWH"});
+    Bundle[] response = iotaAPI.bundlesFromAddresses(false, new String[]{"RMQYYPYZKJQOWHDJPXDFUB9NYFWDUNNUBHIQRYUZBYGHKMDDWFLURDCIUVYHGVNQJMFQSPCUNETZFPIPZ", "WALYAJHFLXYTGDTSRTEJZCDKIMAKJZSKEFVBVPUYYFSQDWUXP9TFGXOYSFVQTRZBDTRKYBYMKBJIDWNLZ"});
 } catch (ArgumentException e) { 
     // Handle error
     e.printStackTrace(); 

docs/iota-java/checkWereAddressSpentFrom.md

@@ -1,5 +1,5 @@
 
-# [checkWereAddressSpentFrom](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L948)
+# [checkWereAddressSpentFrom](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L950)
  boolean[] checkWereAddressSpentFrom(String[] addresses)
 
 Check if a list of addresses was ever spent from, in the current epoch, or in previous epochs. Addresses must have a checksum.
@@ -27,7 +27,7 @@ Check if a list of addresses was ever spent from, in the current epoch, or in pr
  IotaAPI iotaAPI = new IotaAPI.Builder().build();
 
 try { 
-    boolean[] response = iotaAPI.checkWereAddressSpentFrom(new String[]{"LFR9BZETOYCK99HAUF9QCKHNFKWRSGMUSWCBES99LBQNLA9FPZHZWOXALDUYBUUYSSCVECENJXIKVKFOT", "RUIZBLTGKNUQN9K9MFTODKMM9VXLKWAHVYATRFIC9COFBMXO9POVTRVBSZAEICJSFFAHWZLPMU9AEWKIE"});
+    boolean[] response = iotaAPI.checkWereAddressSpentFrom(new String[]{"SEGOBHYIZQQSGZNAZKJGATEUEGVNFOQFOOWIEVKNWPEJ9VVMZBWJVYTDQMYZLOVGYYPFUVMXJABVAOMOI", "YCQ9OYOHBKCNTF9ELDWMXIZIMOZSWTCWRKKRHIL9SFKPFZIBTYOSGUQJZQJYSAEIFNVEKLBRAOSORCWUU"});
 } catch (ArgumentException e) { 
     // Handle error
     e.printStackTrace(); 

docs/iota-java/findTransactionObjectsByAddresses.md

@@ -1,5 +1,5 @@
 
-# [findTransactionObjectsByAddresses](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L396)
+# [findTransactionObjectsByAddresses](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L398)
  List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java)> findTransactionObjectsByAddresses(String[] addresses)
 
 Wrapper function: Finds transactions, gets trytes and turns it into [Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java) objects.
@@ -12,7 +12,6 @@ Wrapper function: Finds transactions, gets trytes and turns it into [Transaction
 
 ## Output
 List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java)>, which contains the following fields:
-
 | Return type | Description |
 |--|--|
 | long attachmentTimestampLowerBound |  |
@@ -42,16 +41,16 @@ List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/
 ## Related APIs (link to other product documentation)
 | API     | Description |
 |:---------------|:--------|
-| [findTransactionsByAddresses(String...)](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPICore.java#L308) | Find the transactions by addresses with checksum |
-| [findTransactionsObjectsByHashes](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L370) | Wrapper function: get trytes and turns into [Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java) objects. Gets the trytes and transaction object from a list of transaction hashes. |
+| [findTransactionsByAddresses(String...)](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPICore.java#L319) | Find the transactions by addresses with checksum |
+| [findTransactionsObjectsByHashes](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L372) | Wrapper function: get trytes and turns into [Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java) objects. Gets the trytes and transaction object from a list of transaction hashes. |
 
  ## Example
 
  ```Java
  IotaAPI iotaAPI = new IotaAPI.Builder().build();
 
 try { 
-    List<Transaction> response = iotaAPI.findTransactionObjectsByAddresses(new String[]{"GHIALCNSUKFIOHCNZOWRAVNRJTMEHWTRBNMMCLCZAXPDWXTUXPWCUOIRKWKX9YXYNS9JGPNCIURDYBNDY", "BYANZHOP9YKVFFWJZGBDTGFBNRTUQGEFXWMJNTOACZ9IRETPQX9EKMFNTVJFYRCKWCKFQAQXXD9JVSQBX"});
+    List<Transaction> response = iotaAPI.findTransactionObjectsByAddresses(new String[]{"AJCSWDXXBPNZ9ZPDNPR99QQYLTBEDZYBOBHFHCYBJWJWUXQZTWMARLQOBIRUXKMFODVDVCXVZRICOK9OK", "EMA9ZMWSUTEVURWHCOSNTAASRPOKIVTNPSPAHXGILBMTHBYCILIJYNCWRPWFOYMVQRWPCGRYJUVAFSRFT"});
 } catch (ArgumentException e) { 
     // Handle error
     e.printStackTrace(); 

docs/iota-java/findTransactionObjectsByApprovees.md

@@ -1,5 +1,5 @@
 
-# [findTransactionObjectsByApprovees](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L435)
+# [findTransactionObjectsByApprovees](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L437)
  List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java)> findTransactionObjectsByApprovees(String[] approvees)
 
 Wrapper function: Finds transactions, gets trytes and turns it into [Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java) objects.
@@ -12,7 +12,6 @@ Wrapper function: Finds transactions, gets trytes and turns it into [Transaction
 
 ## Output
 List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java)>, which contains the following fields:
-
 | Return type | Description |
 |--|--|
 | long attachmentTimestampLowerBound |  |
@@ -42,15 +41,15 @@ List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/
 ## Related APIs (link to other product documentation)
 | API     | Description |
 |:---------------|:--------|
-| [findTransactionsByApprovees](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPICore.java#L334) | Find the transactions by approvees |
+| [findTransactionsByApprovees](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPICore.java#L345) | Find the transactions by approvees |
 
  ## Example
 
  ```Java
  IotaAPI iotaAPI = new IotaAPI.Builder().build();
 
 try { 
-    List<Transaction> response = iotaAPI.findTransactionObjectsByApprovees(new String[]{"WSOLQGWRUZEPMZUKRDVDADHVESYRLOWOEHCWONIIT9HSPBZLEGQNYIHVKLMIEZYTPADXJYBOVNNYCPCYJ", "MFZMSUNPKPLDMTWQSPIMULPIZGBENUCSHYORAVNQPTKGKIXLTPUVPJHNJQLRNZHNZXOFGUUMIHDZPWNWP"});
+    List<Transaction> response = iotaAPI.findTransactionObjectsByApprovees(new String[]{"TMIPRULGWLBQOUSQCFCMMOXUZNWBDSSXIJAXUVFFYWDJIGIRLQHUXJJAORAYPBAUYNCEHMDLIJRLYFNPJ", "LUWGMJBHQZYWGUGAYYUYCQ9KYFMA9MDFW9OWIHAYMZNRYPJETBVXQAQQAJXDVLCQHG9BSTTVWHPJHKKKW"});
 } catch (ArgumentException e) { 
     // Handle error
     e.printStackTrace(); 

docs/iota-java/findTransactionObjectsByTag.md

@@ -1,5 +1,5 @@
 
-# [findTransactionObjectsByTag](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L416)
+# [findTransactionObjectsByTag](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L418)
  List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java)> findTransactionObjectsByTag(String[] tags)
 
 Wrapper function: Finds transactions, gets trytes and turns it into [Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java) objects.
@@ -12,7 +12,6 @@ Wrapper function: Finds transactions, gets trytes and turns it into [Transaction
 
 ## Output
 List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java)>, which contains the following fields:
-
 | Return type | Description |
 |--|--|
 | long attachmentTimestampLowerBound |  |
@@ -42,16 +41,16 @@ List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/
 ## Related APIs (link to other product documentation)
 | API     | Description |
 |:---------------|:--------|
-| [findTransactionsByTags(String...)](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPICore.java#L361) | Find the transactions by tags |
-| [findTransactionsObjectsByHashes](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L370) | Wrapper function: get trytes and turns into [Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java) objects. Gets the trytes and transaction object from a list of transaction hashes. |
+| [findTransactionsByTags(String...)](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPICore.java#L372) | Find the transactions by tags |
+| [findTransactionsObjectsByHashes](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L372) | Wrapper function: get trytes and turns into [Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java) objects. Gets the trytes and transaction object from a list of transaction hashes. |
 
  ## Example
 
  ```Java
  IotaAPI iotaAPI = new IotaAPI.Builder().build();
 
 try { 
-    List<Transaction> response = iotaAPI.findTransactionObjectsByTag(new String[]{"TAG9RODSMKAQRHOSDABVIGIMVYM", "TAG9XVOVWUZPEYGUUJFHEJRTDXL"});
+    List<Transaction> response = iotaAPI.findTransactionObjectsByTag(new String[]{"TAG9RQWWNKCLKYYTNHKEZSFPDNJ", "TAG9LIZMXWNNLW9NXEEWAXDWYJE"});
 } catch (ArgumentException e) { 
     // Handle error
     e.printStackTrace(); 

docs/iota-java/findTransactionsObjectsByHashes.md

@@ -1,5 +1,5 @@
 
-# [findTransactionsObjectsByHashes](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L370)
+# [findTransactionsObjectsByHashes](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPI.java#L372)
  List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java)> findTransactionsObjectsByHashes(String[] hashes)
 
 Wrapper function: get trytes and turns into [Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java) objects. Gets the trytes and transaction object from a list of transaction hashes.
@@ -12,7 +12,6 @@ Wrapper function: get trytes and turns into [Transaction](https://github.com/iot
 
 ## Output
 List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java)>, which contains the following fields:
-
 | Return type | Description |
 |--|--|
 | long attachmentTimestampLowerBound |  |
@@ -42,15 +41,15 @@ List<[Transaction](https://github.com/iotaledger/iota-java/blob/master/jota/src/
 ## Related APIs (link to other product documentation)
 | API     | Description |
 |:---------------|:--------|
-| [getTrytes(String...)](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPICore.java#L408) | Returns the raw transaction data (trytes) of a specific transaction. These trytes can then be easily converted into the actual transaction object. You can use [Transaction(String)](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java#L145) for conversion to an object. |
+| [getTrytes(String...)](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/IotaAPICore.java#L419) | Returns the raw transaction data (trytes) of a specific transaction. These trytes can then be easily converted into the actual transaction object. You can use [Transaction(String)](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/model/Transaction.java#L145) for conversion to an object. |
 
  ## Example
 
  ```Java
  IotaAPI iotaAPI = new IotaAPI.Builder().build();
 
 try { 
-    List<Transaction> response = iotaAPI.findTransactionsObjectsByHashes(new String[]{"JQXBUOXGAFOTMXJZXHFYSC9RBYJTWTFDNFTXID9Z9XRJOTHZOFKPZJLCWPBASCCAWGOFNUVKFWLNUPNHZ", "YZVXFBPDEUAUIXEQI99YXWUYCLNEN9ZJZUNVWRKFNRQATZPGTXVISRMOYYTYQLKJYQWKAJHDSDEWIMCWI"});
+    List<Transaction> response = iotaAPI.findTransactionsObjectsByHashes(new String[]{"CFFLBAXADNSMSIN9OUBLYAIANNKRFFOOWKAIUJHFOSCNLKWJROMLCDVDMCLWJEUDKZIAFQA9JPATXWNKN", "WLVSUYHXSJCQPFJEXRMENFNWJHC9RHGEPDBWTROFELSCAUPMDXVPMKHNHVMSHPKBLEVWNHRDKMPMHRV9E"});
 } catch (ArgumentException e) { 
     // Handle error
     e.printStackTrace(); 

docs/iota-java/generateNewAddresses.md

@@ -12,7 +12,6 @@ Generates new addresses, meaning addresses which were not spend from, according
 
 ## Output
 [GetNewAddressResponse](https://github.com/iotaledger/iota-java/blob/master/jota/src/main/java/org/iota/jota/dto/response/GetNewAddressResponse.java), which contains the following fields:
-
 | Return type | Description |
 |--|--|
 | Long duration | Gets the duration. |