Initial models

src/main/java/io/zold/api/Network.java

@@ -35,15 +35,14 @@ public interface Network extends Iterable<Remote> {
     /**
      * Push the wallet to the network. The network will select the
      * remote node with the highest score (with a minimum of {@code 16}).
-     * @param wallet the wallet
-     * @return whether {@code wallet} was successfully pushed or not
+     * @param wallet The wallet
      */
-    boolean push(Wallet wallet);
+    void push(Wallet wallet);
 
     /**
      * Pull a wallet from the network.
-     * @param id the wallet's {@link Wallet#id() id}
-     * @return the wallet
+     * @param id The wallet's {@link Wallet#id() id}
+     * @return The wallet
      */
     Wallet pull(Long id);
 }

src/main/java/io/zold/api/Remote.java

@@ -34,7 +34,7 @@
 public interface Remote {
     /**
      * This remote node's score.
-     * @return the score
+     * @return The score
      */
     Score score();
 }

src/main/java/io/zold/api/Score.java

@@ -24,6 +24,8 @@
 
 package io.zold.api;
 
+import org.cactoos.Text;
+
 /**
  * A remote node's score, equal to its number of suffixes.
  *
@@ -33,8 +35,9 @@
  */
 public interface Score extends Comparable<Score> {
     /**
-     * The suffixes associated with this score.
-     * @return suffixes for this score
+     * The suffixes associated with this score. Each suffix is a text of the
+     * form {@code /[a-zA-Z0-9]+/}.
+     * @return Suffixes for this score
      */
-    Iterable<Suffix> suffixes();
+    Iterable<Text> suffixes();
 }

src/main/java/io/zold/api/Transaction.java

@@ -25,21 +25,16 @@
 package io.zold.api;
 
 /**
+ * A payment transaction.
  *
  * @author George Aristy ([email protected])
  * @version $Id$
  * @since 0.1
  */
 public interface Transaction {
-    /**
-     * Its ID.
-     * @return id of this transaction
-     */
-    char id();
-
     /**
      * Amount involved in this transaction.
-     * @return the amount
+     * @return The amount
      */
-    Amount amount();
+    long amount();
 }

src/main/java/io/zold/api/Wallet.java

@@ -31,32 +31,33 @@
  * @version $Id$
  * @since 0.1
  */
+@SuppressWarnings("PMD.ShortMethodName")
 public interface Wallet {
     /**
-     * 64-bit unsigned integer.
-     * @return 
+     * This wallet's ID: an unsigned 64-bit integer.
+     * @return This wallet's id
+     * @checkstyle MethodName (2 lines)
      */
     long id();
 
     /**
      * Make a payment.
-     * @param amt amount to pay
-     * @param bnf wallet ID of beneficiary
-     * @return the transaction
+     * @param amt Amount to pay in zents
+     * @param bnf Wallet ID of beneficiary
      */
-    Transaction pay(Amount amt, char bnf);
+    void pay(long amt, char bnf);
 
     /**
      * Merge both {@code this} and {@code other}. Fails if they are not the
      * same wallet, as identified by their {@link #id() id}.
-     * @param other other wallet
-     * @return the merged wallet
+     * @param other Other wallet
+     * @return The merged wallet
      */
     Wallet merge(Wallet other);
 
     /**
      * This wallet's ledger.
-     * @return this wallet's ledger
+     * @return This wallet's ledger
      */
     Iterable<Transaction> ledger();
 }

src/main/java/io/zold/api/Wallets.java

@@ -34,16 +34,7 @@
 public interface Wallets extends Iterable<Wallet> {
     /**
      * Create a wallet.
-     * @return the new wallet
+     * @return The new wallet
      */
     Wallet create();
-
-    /**
-     * Add/merge the wallet with our wallets.
-     * @param walt the wallet
-     * @return {@code walt} if we did not have this wallet, or a new
-     *   instance of the same wallet if {@code walt} was merged with
-     *   one we already had
-     */
-    Wallet merge(Wallet walt);
 }