Mojo Wallet

From Mochimo Wiki
Jump to: navigation, search

The Mojo wallet is the official wallet of the Mochimo cryptocurrency. It was released for open beta on December 25, 2018. It is build in Java 8, making it available for all major operating system (Windows, Linux, OS X).

A quick start guide is also available


Installation

Mojo itself is a portable application that does not need to be installed, but requires at least Java version 8 to be installed in order to run. In most cases, double clicking the JAR file is sufficient to run the application. If this fails, it can be started by entering the following command into a CMD or Shell terminal: java -jar [Mojo jar file].

Create a wallet file

  1. Start Mojo and click on New
  2. Enter a name for the wallet (optional) and a password
  3. PBKDF2 value can be change for faster loading of the wallet (at the cost of a lower resistance to a brute force attack)
  4. Default compression GZIP reduce the size of the wallet file
  5. Make sure to write down the seed sphrase (and pass passphrase if any). They will be needed to restore your wallet.


Address management

Address pool

The wallet file contains a pool of addresses which are used during operation (creating a new address, rolling a source address into a change address, etc). When the size of the pool goes to zero it must be expanded before an address can be spent again.

  1. Under tab New, click on Expand and select the number of addresses to generate
  2. Backup the wallet file after the expand is completed

The Mojo wallet will use these addresses as needed to process user requests. Once the pool is exhausted a new expand must be performed (note: expand can be done at any time and certainly before the pool dries out).

Activate an address

Address can be activated from the pool under the tab New. Use Register to activate a tagged address through a fountain. The fountain will register the tag in the network by sending a specific transaction. Depending on the fountain and the network state, the registration can take several block to be processed. Until the registration is completed, the account will display status Activation pending (or Tag not found if the wallet has been closed in the meantime). Once the address is funded, the status will show Active. By default, tag address will show 0 MCM even though the actual balance is 0.000000501 MCM. That is because 0.000000501 MCM is smallest possible amount for an address to exist on the network. Therefore, it is not be possible to spent the totality of a tag address without loosing the tag. For this reason, all tag balance are discounted by 0.000000501 MCM when mode Advanced is not selected.

Use Create without tag if you do not want to use a fountain service or that you are not using a tag. Use Offline registration to skip network checks.

Account dashboard

All addresses can be found under the Accounts tab. By default, only Active and Spent address are being displayed. You can displayed all address by setting the Search field (on the top) to *. You can remove an address (for example a Spent address) from the default dashboard by archiving the address (see Account window).

Account window

Double click add account from the dashboard to open the Account window. This window is account specific and contain all the info about an account. You can copy the name, tag or address of an account into the clipboard by double clicking it. Use the various export option to share an address. The Archive button will flag the account and remove it from the default dashboard.

Import address

Mojo cannot read the CLI legacy *.wal file but allows importing legacy address file *.maddr

You can jump to step 4 to import from a tag

  1. Export the desired address from the legacy CLI wallet. To export the secret along with the address, select yes when prompted Export balance ? y/n and again yes on Export secret? y/n
  2. Open Mojo and navigate to the Import tab
  3. Select the appropriate import (Legacy for legacy address file, QR code or default JSON)
  4. Use tag resolve icon to resolve the tag if needed
  5. Click Add to add the address to the wallet. Use Add offline to skip tag check
  6. If you imported a secret, backup the wallet file

Export address

Account address and secret can be export from the Account window. Different type of export are available:

  1. JSON export (text file)
  2. QR code export ([PNG] file). Note: that QR code holding secrets are colored (instead of black and white)
  3. Legacy export (binary file)

Be careful not to export the secret of an account when sharing your export file with a third party


Receive Mochimo

In order to receive Mochimo, the recipient must provide the sender with an address for which he/she holds the secret. Export the recipient address (see Export address) without the secret and share the export file with the sender. A tag can also be shared in place of a full address.

Send Mochimo

  1. Import the recipient address into the wallet (see Import address)
  2. Make sure there is at least one address available in the pool. If not, Expand the pool (see Address pool)
  3. Navigate to tab Send
  4. Select the source address to spend
  5. Select the destination address
  6. By default, the wallet will automatically activate a new address from the pool as the change address of the transaction. You can specify a change address by unticking the checkbox Roll source address
  7. Input the amount to send. By default, the amount is set in MCM but can be change to Satochi (SMCM) by ticking the checkbox SatoChi
  8. Click Send to send the transaction to the network


Restore from seed phrase

  1. Select Restore from seed phrase from the login frame
  2. Enter a new password for the restored wallet
  3. Enter the original seed phrase (and passphrase if any)
  4. Click Restore
  5. Select the size of the batch of addresses to recover
  6. You can repeat the recovery batch until all balances are recovered


Restore from backup file

  1. Create a new wallet (see Create a wallet file)
  2. Navigate to tab Restore
  3. Select the backup file and input the password
  4. Click Restore
  5. After a while, the restored address will be available on Accounts tab


One-Time-Signature WOTS+ & Tag paradigm

Mochimo uses the quantum proof WOTS+ algorithm to secure transactions. Because this is a One-Time-Signature scheme, the same WOTS+ should never be used more than once in order to remain secured. In order to avoid the burden of exchanging raw WOTS+ of over 4000 character that cannot be reused, Mochimo uses a system of Tag that can be used as a unique identifier to receive and send coin. Unlike the underlying WOTS+, the Tag will never changes and can receive and spent MCM an unlimited amount of times without comprising the security of the funds. When spending a Tag, the Mojo wallet will generate a new address on the Account tab. This new address have the same tag and will received the change balance (Change balance = Original balance - Payment amount - Fee). Once the transaction is completed, the old address (marked Spent) can be archived (from the Account window) and wont be shown in the Account tab anymore.

Payment scenario: send 1 MCM from Tag xxxxxxxxxxxxxxxxxxxxxxxx

  1. Account tag xxxxxxxxxxxxxxxxxxxxxxxx holds balance of 3 MCM
  2. Send 1 MCM from account tag xxxxxxxxxxxxxxxxxxxxxxxx to any address
  3. The original account tag xxxxxxxxxxxxxxxxxxxxxxxx is marked Spent and the balance is 3 MCM
  4. A new account is created with tag xxxxxxxxxxxxxxxxxxxxxxxx. This is the change account. It is marked Transaction pending (or Tag mismatch) and the balance is 0 MCM
  5. The transaction gets included in a block
  6. The original account tag xxxxxxxxxxxxxxxxxxxxxxxx is marked Spent and the balance is 0 MCM
  7. The change account tag xxxxxxxxxxxxxxxxxxxxxxxx is marked Active and the balance is 1.999999500 (3 MCM - 1 MCM - 0.000000500 MCM)
  8. The original account can be archived

Advanced

Offline transaction

On cold wallet:

  1. Navigate to tab Send
  2. Input source, destination and change address (see Send Mochimo)
  3. Tick the checkbox Offline
  4. Input the balance of source address and the amount to send
  5. Click on Sign only
  6. Save the transaction file

On hot wallet:

  1. Navigate to tab Push
  2. Use Import TX to import the transaction file
  3. Click Send to send the transaction to the network

Tor Network

Mojo can be used through the Tor Network .

  1. Install and start Tor Browser
  2. Open a CMD/Shell terminal
  3. Start Mojo with java -Dsocket.proxyHost=localhost -Dsocket.proxyPort=9005 -jar [Mojo jar file]

Note: Mojo have been successfully used on Tails OS with the same command

Settings

Wallet

  • Update heartbeat: how often does the wallet check the height of the network and start an "Update task" for each wallet entry
  • Update timeout: max duration of the "Update task"
  • Update threads: number of threads to process pending "Update task"
  • Resolve timeout: max duration of "Tag resolution" routine
  • Send timeout: max duration of "Send" routine
  • Advanced Mode: activate the advanced features of the wallet (not recommended)

Network

  • Nodes: semi colon separated list of peer's IP
  • Coreip file: file path of peer's IP
  • Providers: semi colon separated list of "Coreip file" provider
  • Port: the port of the network
  • Connect timeout: maximum allowed time to establish a connection to a node
  • Read timeout: maximum allowed time between data reception
  • Retries on timeout: number of retries if a timeout occurs
  • Qorum: number of node to be used when requesting data
  • Map max depth: maximum number of jump when mapping the network
  • Map max size: maximum number nodes to map
  • Map timeout: maximum time allowed to mapping
  • Map heartbeat: how often does the wallet map the network


Command-line interface

Mojo offer a command-line interface (CLI) with features similar to the GUI. The complete list of CLI operations can be seen with the command java -jar [Mojo jar file] -h The CLI interface offers much more flexibility than the GUI and should be used carefully.


Implementation

The Mojo wallet has been developed following the principle of abstraction making it highly flexible and easier to be reviewed. The code is split in several MAVEN modules:

  • mojo-core: the core engine of the wallet responsible for all access to the wallet file
  • mojo-gui-swing: a GUI implementation using JAVA Swing
  • mojo-gui-jfx: a proof of concept GUI implementation using JAVA FX
  • mojo-cli: a CLI implementation
  • mojo-api: a set of interfaces allowing low coupling between the core and the GUI
  • mojo-app: the final Mojo application