Using your wallet

Janus 2.0.0 shows your Unigrid wallet: its balance, its addresses and its history. It does not send, stake or run gridnodes yet, so it is a way to look at a wallet and to keep its recovery phrase safe, not yet to spend from it. What Janus does not do yet lists the rest.

Everything Janus shows comes from the legacy ledger: a copy of the Unigrid chain, frozen at one block and signed by the Unigrid Foundation. Janus gets it through Hedgehog, the Unigrid node program, which it downloads and starts for you. Nothing that happened after that block is shown.

Starting out

The first time, Janus opens on a welcome screen with two choices:

  • Create a new wallet: a fresh wallet with its own 12-word recovery phrase.
  • Import existing wallet: a wallet you already have.

On later starts Janus goes straight to the wallet you used last. To go back to the welcome screen, see How to reset your wallet.

Create a new wallet

  1. Choose Create a new wallet. Janus shows 12 words. Write them down, in order, on paper, and keep them somewhere safe. Anyone who has the words can control the wallet, and nobody can bring them back if you lose them. Click I saved it →.
  2. Janus asks you to prove it: tap the words in the order you wrote them. Reset starts over and Back shows the words again. Continue → is available once the order is right.
  3. Choose a password of at least 8 characters, and type it again to repeat it. You cannot paste into these boxes, so that you know the password by heart. Click Create wallet →.

The password seals the recovery phrase on your computer. Viewing your wallet never asks for it. The phrase follows the standard Ethereum derivation path m/44'/60'/0'/0, and Janus keeps its first 10 addresses, so other wallets that follow the standard find the same addresses from the same words.

Import an existing wallet

Choose Import existing wallet. There are up to three ways in:

Choice When to use it
Use the wallet on this computer You ran the older Unigrid wallet here. Janus found its wallet.dat, and shows where.
Choose a wallet.dat or wallet dump A backup of a wallet.dat, a file made with dumpwallet, or a wallet from elsewhere.
Restore from recovery phrase You have the 12 words of a wallet made with Janus. Enter your 12 words instead.

The first choice only appears when Janus finds a wallet.dat where the older wallet kept it:

System Folder
Windows %APPDATA%\UNIGRID, usually C:\Users\<you>\AppData\Roaming\UNIGRID
macOS ~/Library/Application Support/UNIGRID
Linux ~/.unigrid

Otherwise Janus says “No wallet was found” and names the folder it looked in.

A wallet.dat

Janus makes a copy of the file in .janus/backups, and tells you where: “A copy was saved to …”. Then Continue → opens the wallet.

Janus reads only the public part of the file, the addresses, so it never asks for the passphrase of an encrypted wallet, and your original wallet.dat is not changed. It also means Janus cannot spend from it. The private keys stay in your wallet.dat, so keep that file safe. See Backing up your wallet.

A wallet dump

A dump is a text file that the older wallet’s dumpwallet command writes. It holds your private keys in the clear, which is why Janus handles it differently:

  1. Choose the file and click Continue →.
  2. Janus gives you a new recovery phrase. Write it down and confirm it, as for a new wallet.
  3. Choose a password. Janus seals the private keys of the dump under the new phrase and password, in a file in .janus/wallets.

Janus does not copy the dump. It says: “Keep the dump until your wallet is saved, then delete it.” Before you delete it, read Backing up your wallet.

A recovery phrase

Type the 12 words in order, or paste the whole phrase into the first box, and click Continue →. Then choose a password, which can be a new one. If the wallet’s file is still in .janus/wallets, it is replaced, and the legacy keys it holds stay with it.

Getting your wallet ready

After you choose a wallet, Janus shows “Getting your wallet ready” and the steps it goes through:

  1. Downloading Hedgehog (~90 MB), only the first time, or when the Hedgehog on your computer is not the release this Janus needs. Janus checks the download against a checksum and the Unigrid Foundation’s signature before it runs it.
  2. Starting Hedgehog
  3. Downloading the legacy ledger (~314 MB), which Hedgehog does by itself the first time.
  4. Reading wallet history: Janus asks Hedgehog about each address of the wallet. A wallet with many addresses takes a while.

Each step shows a percentage when Janus knows one. Hedgehog keeps what it downloads, so later starts are shorter. If a step fails, see Troubleshooting.

The dashboard

The chip in the top right corner of the window reads LEDGER FROZEN · BLOCK <n> · SIGNED: the block the ledger stops at, and that its signature checked out. The Dashboard tab shows:

  • Total balance in UGD, with a line “Includes … UGD awaiting mint” when the network has promised coins to your addresses that are not minted yet. They count in the total.
  • A bar chart of the balance over the last 24 months, and “Ledger frozen at block … · signed by the Unigrid Foundation”.
  • Addresses: how many hold funds (Holding funds), how many only have a history (History only) and how many were never used (Never used).
  • Transactions, Active (the period in which the wallet was used) and Funded addresses. Click one to see more.
  • Recent activity, with view all → to open the full list.

Click Funded addresses to see the addresses that hold funds, each with its balance, its share of the total, its number of transactions and the month of the last one. Filter by address narrows the list, ‹ Previous and Next › page through it, and View activity → opens the history of one address.

Activity

The Activity tab lists every transaction, newest first, grouped by month.

  • The four boxes at the top, Received, Sent, Rewards and Net, add up the whole history. Clicking a box filters the list the same way the buttons below do, and Net shows everything. Rewards are what mining and staking earned.
  • All, Received, Sent and Rewards filter the list. Search address or txid narrows it to transactions that mention what you type.
  • Each row shows what it was, Received ↓, Sent ↑, Mined ✦ or Staked ◈, an address, the amount and the time. Click a row for its status, its number of confirmations, its block, the transaction id and all of its addresses.
  • Show more loads the next transactions.

Export CSV saves the history to a file you choose, unigrid-legacy-history.csv unless you name it otherwise. The columns are time,height,txid,kind,amount,addresses. Janus confirms with “Saved to …”, or says “Could not save to …” when it cannot write there.

What Janus does not do yet

The tabs Gridnodes, Domains, Proxy and Settings are there but switched off, with the note “Coming in a later release”. In 2.0.0 Janus cannot:

  • send or receive coins, or stake them,
  • set up, start or vote with gridnodes,
  • lock or unlock a wallet, or change a password,
  • update itself. New versions are on the Releases page.