Using Zedwallet

atomsett edited this page Sep 4, 2018 · 6 revisions

Using Zedwallet

Screenshot

Here's a quick image of zedwallet in action:

zedwallet

Downloading

Binary distributions can be found: here.

Select the appropriate file for the target platform (Windows, Mac, Linux).

Binaries are provided in .zip format, while source code is provided in .zip and .tar.gz format.

Installing

Installing on Windows

Extract the .zip file (turtlecoin-...-windows.zip).

Installing on Mac

Extract the .zip file:

unzip turtlecoin-...-mac.zip

Installing on Linux

Extract the .zip file:

unzip turtlecoin-...-linux.zip

Synchronizing the Blockchain

Running TurtleCoind will start the TurtleCoind network daemon, which will connect to the network and begin downloading and verifying the TurtleCoin blockchain.

Because the blockchain is constantly growing, the file size always increases (the blockchain is currently over 35 GB), and TurtleCoind must verify every block, which is both CPU and disk intensive. An SSD with at least this much free disk space is recommended, unless you plan to use remote nodes.

Using Checkpoints

In versions 0.4.3+ you can sync a fresh chain from block 0 much quicker by using checkpoints. Follow this guide to learn more.

Windows

Run the TurtleCoind.exe executable extracted from the Windows binary zip:

Mac / Linux

Run the TurtleCoind binary extracted from the .zip download:

./TurtleCoind

Using Zedwallet

With TurtleCoind still running in the background or another terminal/shell/command prompt, open zedwallet:

Windows

Run the zedwallet.exe executable from the extracted folder.

Mac / Linux

./zedwallet

Using Zedwallet commands

Zedwallet has a twin command system; a numerical shortcut for navigating the menu, and typed commands you can access directly. The more you use Zedwallet the more typed commands you'll pick up. This guide is written using the written commnand system. Feel free to use the numbers associated with the command.

Creating a Wallet

To create a wallet, type create and press enter:

Welcome, please choose an option below:

 1	open                     Open a wallet already on your system
 2	create                   Create a new wallet
 3	seed_restore             Restore a wallet using a seed phrase of words
 4	key_restore              Restore a wallet using a view and spend key
 5	view_wallet              Import a view only wallet
 6	exit                     Exit the program

What would you like to do?: create
What would you like to call your new wallet?: trtl
Give your new wallet a password: **************
Confirm your new password: **************
Welcome to your new wallet, here is your payment address:
TRTLuxqfDys1pfQ1omkHMVViY4sFh6My5Ff3HBY8XPp3cJBkEfD7romVyzKug3mb9NNR4A8kEjZxZ9CHUgWckBSpPfbxnWAQUGL

Please copy your secret keys and mnemonic seed and store them in a secure location: 
Private spend key:
41c834f7c26e12373e5c39a9c9b1f8beb665324ad0d098cabda1234567b5d30f

Private view key:
df51e85dfa4fe48d0123475ec966124b1234c98abda6789060fe6d69b503490b

Mnemonic seed:
truth neon vials ignore butterfly cactus soggy vibrate meant wizard awesome fountain axis skater itself egotistic pumpkins ultimate foaming fatal request sifting merger egotistic fierce

If you lose these your wallet cannot be recreated!


Your wallet is syncing with the network in the background.
Until this is completed new transactions might not show up.
Use the status command to check the progress.

 1	advanced                 List available advanced commands
 2	address                  Display your payment address
 3	balance                  Display how much TRTL you have
 4	backup                   Backup your private keys and/or seed
 5	exit                     Exit and save your wallet
 6	help                     List this help message
 7	transfer                 Send TRTL to someone

[TRTL trtl]: 

Opening a Wallet

To open an existing wallet; type open and press enter:


 1	open                     Open a wallet already on your system
 2	create                   Create a new wallet
 3	seed_restore             Restore a wallet using a seed phrase of words
 4	key_restore              Restore a wallet using a view and spend key
 5	view_wallet              Import a view only wallet
 6	exit                     Exit the program

What would you like to do?: 1
What is the name of the wallet you want to open?: trtl
Enter password: ***********

Making initial contact with TurtleCoind.
Please wait, this sometimes can take a long time...


Your wallet TRTLuxqfDys1pfQ1omkHMVViY4sFh6My5Ff3HBY8XPp3cJBkEfD7romVyzKug3mb9NNR4A8kEjZxZ9CHUgWckBSpPfbxnWAQUGL has been successfully opened!

Your TurtleCoind isn't fully synced yet!
Until you are fully synced, you won't be able to send transactions,
and your balance may be missing or incorrect!

Scanning through the blockchain to find any new transactions you received
whilst your wallet wasn't open.
Please wait, this may take some time.


Finished scanning blockchain!

 1	advanced                 List available advanced commands
 2	address                  Display your payment address
 3	balance                  Display how much TRTL you have
 4	backup                   Backup your private keys and/or seed
 5	exit                     Exit and save your wallet
 6	help                     List this help message
 7	transfer                 Send TRTL to someone

[TRTL trtl]: 

Viewing Wallet Address

To view a wallet's public address; at the menu, type address and press enter.

[TRTL trtl]: address
TRTLuxqfDys1pfQ1omkHMVViY4sFh6My5Ff3HBY8XPp3cJBkEfD7romVyzKug3mb9NNR4A8kEjZxZ9CHUgWckBSpPfbxnWAQUGL
[TRTL trtl]:

Exporting Keys

Each TurtleCoin wallet is essentially, just a pair of keys (View Key and Spend Key) from which the public address is derived. It is very important to export these keys and back them up somewhere that is safe and secure (meaning somewhere reliable/permanent that no one else can access).

In the event of a lost or corrupted wallet file, computer crash, etc., the View Key and Spend Key are the only way to restore a wallet and recover the funds it holds.

DO NOT SHARE IT WITH ANYONE. Anyone who has these can access your funds and has complete control over your wallet.

To print your keys; at the menu type backup and press enter. The View Key and Spend Key will appear. Copy them and store them safely and securely.

[TRTL trtl]: backup
Enter password: **********
Private spend key: 41c834f7c26e12373e5c39a9c9b1f8beb665324ad0d098cabda1234567b5d30f
Private view key: df51e85dfa4fe48d0123475ec966124b1234c98abda6789060fe6d69b503490b
Mnemonic seed: truth neon vials ignore butterfly cactus soggy vibrate meant wizard awesome fountain axis skater itself egotistic pumpkins ultimate foaming fatal request sifting merger egotistic fierce
[TRTL trtl]:

Viewing Wallet Balance

To view your wallet's balance; at the menu, type balance and press enter:

[TRTL trtl]: balance
Available balance: 1000.00 TRTL
Locked (unconfirmed) balance: 100.00 TRTL
Total balance: 1100.00 TRTL
[TRTL trtl]:

Sending TurtleCoin Transactions

To send Turtlecoin; at the Zedwallet menu:

  • Type: transfer and press enter

  • Type/paste the address you want to send the TRTL to and press enter

  • Type the amount of TRTL you want to send (like 100) and press enter

  • Press enter to use the default fee of 0.1 TRTL (or set it higher if you're sending a large amount of TRTL)

  • Enter the payment ID if the recipient has provided one. Check the payment ID section if you're not sure when/how to use it

  • If you make a mistake or need to stop the transaction, type cancel at any time

  • Confirm that the details are correct and enter y. If something is amiss, enter n and follow the steps again

  • Enter your password

Depending on the amount you transfer, you may need to wait a while for confirmation. If you have had too many small incoming transactions, or the amount you wish to send is too large; either break up your transfer into several smaller amounts, or optimise your wallet.

Example:

transfer

Optimizing your Wallet

Fusion transactions take all your (small) incoming payments and combine them into bigger ones, allowing you to send huge sums at once!

To optimize your wallet, type optimize and press enter:

[TRTL trtl]: optimize
Attempting to optimize your wallet to allow you to send large amounts at once. 
This may take a very long time!
Do you want to proceed? (Y/n): y
Running optimization round 1...
Full optimization completed!
[TRTL trtl]: 

When it is completed, it will print out a green message Full optimization completed!

optimize

Payment ID

Because transactions on the TurtleCoin blockchain are privatized, in some situations a payment ID is necessary for the recipient to be able to determine where the payment came from, for instance when depositing to an exchange or other service.

You need it if you're sending TRTL to an exchange, the tipbot or RainBorg.

To send a transaction with a payment ID, enter it when prompted to.

p-id

Note that typically, the service/recipient will generate and provide the required payment ID.

Exiting the Wallet

Wallets loaded into the zedwallet client must be synced with the blockchain in order to properly calculate balance, view transaction history, etc.

It is important to properly save the wallet data before exiting zedwallet so that the synchronized data is not lost.

To save a wallet's data and exit; at the menu, type exit and press enter:

[TRTL trtl]: exit
Shutting down...
Saving wallet file...
Shutting down wallet interface...
Shutting down node connection...
Bye.

Recovering your Wallet

Private Spend and View Keys

To restore a wallet using spend and view keys; at the menu type seed_restore and press enter:

 1	open                     Open a wallet already on your system
 2	create                   Create a new wallet
 3	seed_restore             Restore a wallet using a seed phrase of words
 4	key_restore              Restore a wallet using a view and spend key
 5	view_wallet              Import a view only wallet
 6	exit                     Exit the program

What would you like to do?: seed_restore
Enter your private spend key: 41c834f7c26e12373e5c39a9c9b1f8beb665324ad0d098cabda1234567b5d30f
Enter your private view key: df51e85dfa4fe48d0123475ec966124b1234c98abda6789060fe6d69b503490b
What would you like to call your new wallet?: trtl2
Give your new wallet a password: ***********
Confirm your new password: ***********
What height would you like to begin scanning your wallet from?

This can greatly speed up the initial wallet scanning process.

If you do not know the exact height, err on the side of caution so transactions do not get missed.

Hit enter for the sub-optimal default of zero: 748000

Making initial contact with TurtleCoind.
Please wait, this sometimes can take a long time...


Your wallet TRTLuxqfDys1pfQ1omkHMVViY4sFh6My5Ff3HBY8XPp3cJBkEfD7romVyzKug3mb9NNR4A8kEjZxZ9CHUgWckBSpPfbxnWAQUGL has been successfully imported!

Your TurtleCoind isn't fully synced yet!
Until you are fully synced, you won't be able to send transactions,
and your balance may be missing or incorrect!

Scanning through the blockchain to find transactions that belong to you.
Please wait, this will take some time.


Finished scanning blockchain!

 1	advanced                 List available advanced commands
 2	address                  Display your payment address
 3	balance                  Display how much TRTL you have
 4	backup                   Backup your private keys and/or seed
 5	exit                     Exit and save your wallet
 6	help                     List this help message
 7	transfer                 Send TRTL to someone

[TRTL trtl2]: 

Other Commands

To see a list of additional commands not already covered; at the menu type advanced and press enter:

 1	advanced                 List available advanced commands
 2	address                  Display your payment address
 3	balance                  Display how much TRTL you have
 4	backup                   Backup your private keys and/or seed
 5	exit                     Exit and save your wallet
 6	help                     List this help message
 7	transfer                 Send TRTL to someone

[TRTL trtl]: advanced

 8	ab_add                   Add a person to your address book
 9	ab_delete                Delete a person in your address book
 10	ab_list                  List everyone in your address book
 11	ab_send                  Send TRTL to someone in your address book
 12	change_password          Change your wallet password
 13	make_integrated_address  Make a combined address + payment ID
 14	incoming_transfers       Show incoming transfers
 15	list_transfers           Show all transfers
 16	optimize                 Optimize your wallet to send large amounts
 17	outgoing_transfers       Show outgoing transfers
 18	reset                    Recheck the chain from zero for transactions
 19	save                     Save your wallet state
 20	save_csv                 Save all wallet transactions to a CSV file
 21	send_all                 Send all your balance to someone
 22	status                   Display sync status and network hashrate

Help

To see the main menu of commands; type help and press enter:

[TRTL trtl]: help

 1	advanced                 List available advanced commands
 2	address                  Display your payment address
 3	balance                  Display how much TRTL you have
 4	backup                   Backup your private keys and/or seed
 5	exit                     Exit and save your wallet
 6	help                     List this help message
 7	transfer                 Send TRTL to someone

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.