NAV Navbar
Logo

Welcome

Factom Federation

Welcome to the Federation!

The Factom Federation introduces a new network of federated servers that really bring it to the distributed game. After all, Honesty is subversive. So here is what you need to know, at a high-level Factom Federation adds several new features:

These new Factom guides replace all our previous ones. We have covered how to:

Some of these guides are intended for users who know their way around the command line (you should know enough to be dangerous and get yourself out of trouble).

However, don’t despair, we made sure to provide some easy to follow tutorials on how to use Factom with a Graphic User Interface (GUI) even though they still require some basic command line experience.

Foundation Logo

Enterprise Wallet

Introduction

It is our utmost pleasure to present the new “Enterprise Wallet”, it has been completely redesigned from the bottom up with improved functionality, ease of use, and a great new feel.

Find the new features highlighted below:

Here it is in all its glory!

Light Theme

Light Theme

Dark Theme

Dark Theme

Before You Begin

Before attempting to transact factoids (FCT) read these guides thoroughly (at least once). The software is still under Beta, so use the instructions at your risk. Do not use a large amount of Factoids in case there are issues, bugs, or you mistype a command. Phoning a friend after the damage is done will not fix things. Sorry, this is just the way of the Blockchain.

The following directions and commands are optimized for Linux but should work with minor modifications for Mac or Windows. Be aware of slight differences in commands on different platforms:

Mac

./factomd < rest of the command >

Windows

factomd < rest of the command >

Linux

factomd < rest of the command >

Make sure to change the commands accordingly.

The interface you will be using to run Factom Federation software related commands is called:

Give it a try and get familiar before you go any further. Going forward we will use “Terminal” to describe the interface where you type commands, just don’t forget it has a different name in Windows.

FF is composed of three main components:

However to run the wallet you only need the new desktop app (Enterpise Wallet) if used online or the app + factomd if running locally, factom-walletd and factom-cli are only required if you want to run the command line wallet.

Starting Factom Via Bootstrap

Factom takes a while to download the blockchain. It can be expedited by downloading the first 70k blocks via HTTP. Factomd still checks the blockchain on each boot, so it will check for inconsistencies in the download.

Download the blockchain here.

Extract the zip file to your home directory. It will create files in the location:

~/.factom/m2/main-database/ldb/MAIN/factoid_level.db/

Compressed the blockchain is currently about 5 GB and uncompressed is over 9 GB at the time of writing.

Backup Your Wallets!

If you’ve used Factom Genesis (FG), our previous software release, you should have a local wallet file. We highly recommend you backup your (FG) wallet file every time you import or generate a new address. Do read this guide fully, at least once.

If you have never run FG you can skip the backup right now but we strongly recommend backing up your new wallet once you get FF running. Get back to this guide when you are ready to do your backup, don’t forget!

Backup your Factom Genesis (FG) wallet file

Make sure to backup your FG wallet file before you run the new Factom Federation software. The wallet file is called “factoid_wallet_bolt.db” and is located in the .factom folder at the following locations:

To backup your FG wallet file, locate the factoid_wallet_bolt.db file, make a copy, and save it to a location outside the .factom folder such as your documents folder, an external drive, a USB stick, or cloud storage.

Backup your Factom Federation (FF) wallet file

We have two types of wallets for users to choose from when using Enterpise Wallet: Secure Wallet (encrypted) and Not Secure Wallet (unencrypted). The wallet files have different names accordingly:

  1. factom_wallet_encrypted.dbis (encrypted)
  2. factom_wallet.db (unencrypted wallet file)

They are located in the .factom folder at the following locations:

Encrypted Wallet File Locations

Unencrypted Wallet File Locations

Learn more on how to setup a Secure or Not Secure Wallet by following the Choose Your Wallet Type guide.

To backup your FF wallet file, quit factomd and EnterpriseWallet, locate the factom_wallet.db or factom_wallet_encrypted.dbis file, make a copy, and save it to a location outside the .factom folder such as your documents folder, an external drive, a USB stick, or cloud storage.

To create a fresh FF wallet file, quit factomd and EnterpriseWallet then move your wallet file to a safe location out of the .factom folder. There should be no wallet file in the .factom folder. Restart factomd and factom-walletd and a new empty wallet will be generated.

To restore a previous FF wallet file backup, quit factomd and EnterpriseWallet, make sure you have a backup of the current wallet first, then drag & drop the previous backup in the .factom folder, overwrite if needed. Restart factomd and factom-walletd and your previous wallet will now be used instead.

Backup your Factom Federation (FF) wallet seed

You can also backup the Factom Foundation Wallet seed, which is a 12 word passphrase. In the new Factom Foundation Wallet you have the option to save it to a text file in the “Settings” page. It’s as easy as clicking a button. You will see a note that explains how the seed works so read it carefully.

Export Seed Notice

Once exported you can backup the text file somewhere safe, open it and write the seed down, or add it to your favourite password manager.

When you try to import it back you get another warning which you should also read carefully.

Confirm Import

You are a security expert now. You just made your Factoids and Entry Credits proud!

Install Factom Federation (FF)

If you got this far, you are doing well Grasshopper. Ready to get your hands on FF? You will be up and running in a few minutes. Promise.

Here is a step by step guide on how to install FF binaries on Mac, Windows, and Linux.

Step 1 Download the installer for Mac, Windows, or Linux on GitHub. There are various versions, make sure to select the one best suited for your system.

Step 2 Save it to your desktop or downloads folder on your local hard drive.

Step 3 Follow the instructions for your OS.

Mac

This installer is for factomd, factom-walletd, factom-cli, the 3 binaries will be installed in /Applications/Factom/ together with a .factom folder in the root of the local user Home Folder. These are all required to run Factom via command line.

Before you start go to System Preferences/Security & Privacy, click on the lock at the bottom left of the window, type your username and password, then select “Allow apps downloaded from: Anywhere”. At the prompt click on “Allow From Anywhere”.

Security & Privacy

Note that after running the Factom installer it is recommended you revert back your Security & Privacy settings to their original state.

Next, locate the “factom.mpkg.zip” file you just downloaded, double click to unzip it, then double click the “factom.mpkg” file to run the installer.

The installer will open, click continue.

Installer Step 1

Then click install.

Installer Step 2

The installer will prompt for your username and password, you need to have Admin privileges on the Mac (means you need to be able to install applications on your Mac).

Enter your username and password then click Install Software.

Installer Step 3

The installer will proceed with the installation and once finished it will prompt with “The installation was successful.” Then click close.

Installer Step 4

You made it so far, wasn’t that hard wasn’t it?

You are now ready to install Enterprise Wallet.

Windows

This installer is for factomd, factom-walletd, factom-cli, the 3 binaries will be installed in c:\Program Files (x86)\Factom\ or c:\Program Files\Factom\ (depending on your system) together with a .factom folder in the root of the local user Home Folder. These are all required to run Factom via command line.

Next, locate the “FactomInstall-amd64.msi” or “FactomInstall-i386.msi” file you just downloaded in Step 1.

Double click the .msi installer to run it but you may be prompted with the following message.

Windows Prompt 1

Click on “more info” to expand it then select “Run anyway”.

Windows Prompt 2

The Installer will open, click “Next”.

Installer Step 1

Select “I accept the terms in the Licence Agreement” and click “Next” to continue.

Installer Step 2

Make sure Factom is installed into c:\Program Files (x86)\Factom\ folder and click “Next” to continue.

Installer Step 3

Then click “Install”.

Installer Step 4

Select “Yes” to continue if you get the following message.

Windows Prompt 3

When the installation is over select “Finish” to exit the installer.

Installer Step 5

You made it so far, and ready to install Enterprise Wallet.

Linux

This installer is for factomd, factom-walletd, factom-cli, the 3 binaries will be installed on your local drive together with a .factom folder in the root of the local user Home Folder ~/.factom. These are all required to run Factom via command line or the Factom Foundation Wallet.

Download the “factom-amd64.deb” or “factom-i386.deb” installer that suits your system as per Step 1 then run the following command to install.

sudo dpkg -i ./factom-amd64.deb

or

sudo dpkg -i ./factom-i386.deb

We are aware Linux users are hardcore so we made sure one command is all they need to be ready to install Enterprise Wallet!

Install Enterprise Wallet

Enterprise wallet has been updated to be installed as a Desktop Application for Windows, Mac, or Linux. The process of backing up your wallets remains the same, and the desktop app uses the same file locations as the binary version (factom-walletd). This guide will go over the installation of the new Enterprise Wallet.

Here is a step by step guide on how to install Enterprise Wallet on Mac, Windows, and Linux.

Step 1 Download the installer for Mac, Windows, or Linux on GitHub.

These are the file names for the different installers:

Step 2 Save it to your desktop or downloads folder on your local hard drive.

Step 3 Follow the instructions for your OS.

Mac

Double click on the “enterprise-wallet-setup.dmg” file downloaded at Step 1, when prompted drag EnterpriseWallet.app into the Applications folder.

Install Mac Wallet

The wallet will be installed at the following location:

/Applications/EnterpriseWallet.app

Double click the app to launch it or drag to your dock to create a shortcut.

You are ready to Run Enterprise Wallet, however read the guide carefully before you run the app, especially if you have an old wallet file to import.

Windows

Double click on the “enterprise-wallet-setup-amd64.exe” file downloaded at Step 1 to run the wallet installer.

Wait until it loads up.

Install Windows Wallet

Then follow the prompts and click install. Let the intaller finish.

Install Windows Wallet 2

The wallet will be installed at the following location:

C:\Users\YOUR_USERNAME\AppData\Local\Programs\enterprisewallet\EnterpriseWallet.exe

A shortcut will also be added to your desktop for easy launch.

You are ready to Run Enterprise Wallet, however read the guide carefully before you run the app, especially if you have an old wallet file to import.

Linux

For Ubuntu/Debian

Locate the “enterprise-wallet-setup-amd64.deb” file downloaded at Step 1 to run the wallet installer.

Open a terminal window and go to where the .deb is located, for example:

cd ~/Downloads

Install the .deb package with this command:

sudo dpkg -i enterprise-wallet-setup-amd64.deb

Install Linux Wallet

You will be able to run the wallet by simply searching for it in the search bar.

Install Linux Wallet 2

For Redhat/Centos

Locate the “enterprise-wallet-linux.zip” and unzip it into a folder of your choice. Then open a Terminal window and cd to the “linux-unpacked” folder, for example:

cd ~/Desktop/linux-unpacked

Then run the wallet by executing the “enterprisewallet” binary with the following command:

enterprisewallet

You are ready to Run Enterprise Wallet, however read the guide carefully before you run the app, especially if you have an old wallet file to import.

Run Enterprise Wallet

Time to remember Mr. Miyagi’s lesson.

This step will be used every time you need to run Enterprise Wallet, so get familiar with it. Practice makes perfect. Wax on, wax off.

Enterprise Wallet is a desktop app for Mac, Windows and Linux, which allows to run a wallet with a graphic user interface (GUI). There are 2 mothods to run the wallet, choose the one to suit your needs and skills best. Every time you come across “Run Wallet” you need to perform the following steps according to your choice below. These are the basic steps to run the wallet.

Running Enterprise Wallet Online means you can point to a remote factomd node and don’t have to worry about using command line, factomd nor sync the blockchain. This option is probably the one best suited for most users who simply want to send and receive FCT or buy EC.

Running Enterprise Wallet Locally means also having to run factomd locally as well as sync the blockchain which can take a long time and require some command line skills. This option is a bit technical but can turn out to be more reliable as everything runs from your own machine.

Upgrade Your Old Wallet File

If you have run our previous software release “Factom Genesis (FG)” you need to import your FG wallet file (named factoid_wallet_bolt.db) the first time your run the Enterprise Wallet app to make sure all its previous addresses and balances are transferred over. You have learned how to backup your wallet file in our Backup Your Wallet File! guide and you should know if still in the default location within the .factom folder at ~/.factom/factoid_wallet_bolt.db.

If your old wallet file is in the default place you don’t need to do anything, the new wallet will recognize the file and import it automatically. You can simply follow the same instructions for who has never used FG below.

If your wallet file is not in the default location then you need to manually add it to ~/.factom/factoid_wallet_bolt.db.

If by any chance the operation fails, quit the wallet, delete the new wallet file located at ~/.factom/wallet/factoid_wallet.db and launch the wallet again until you get all your addresses back.

Once you are happy continue by following the instructions below to choose your wallet type.

Choose Your Wallet Type

When you launch Enterprise Wallet you have the option to choose a “secure” or a “not secure” wallet, the former is encrypted the latter is unencrypted.

Each option maintains a different wallet file. This means you can have both a non secure, and a secure wallet.

To open either one, just close and relaunch EnterpriseWallet, selecting the one you wish to open.

Online Wallet 00

Secure Wallet

To create a Secure Wallet simply click on the Secure Wallet button.

Online Wallet 00

You will then need to enter a strong password for your wallet, tick the box next to “I acknowledge that if I lose this password and my seed I will lose access to the wallet and its funds”, and finally click the “Proceed to Encrypted Wallet” button to access the Secure Wallet.

This will automatically generate a new “factom_wallet_encrypted.db” file in your .factom folder (which will be encrypted with the password you just chose). You will need the same password every time you want to access your Secure Wallet, make sure to write it down and keep it safe.

Online Wallet 00

This is what a secure wallet will look like:

Online Wallet 00

Once you are happy continue by following the instructions below for either the Online or Local Enterprise Wallet setup.

Not Secure Wallet

To create a Not Secure Wallet simply click on the Not Secure button.

Online Wallet 00

Make sure to tick the box next to “I acknowledge that my private keys will not be encrypted and are thus unprotected”, and finally click the “Proceed to Unencrypted Wallet” button to access the Secure Wallet.

Online Wallet 00

This is what a secure wallet will look like:

Online Wallet 00

Once you are happy continue by following the instructions below for either the Online or Local Enterprise Wallet setup.

Run Enterprise Wallet Online

On Windows, Mac and Linux locate the Enterprise Wallet app and launch it.

At first launch it may show an error message under the “Transactions Tab”.

Online Wallet

The first thing to do is to change the factomd node the wallet is pointing to. Go to “Settings”, by default the wallet uses the local factomd instance at localhost:8088, hence why there was an error.

Online Wallet 2

Now click “Custom Factomd Location” and enter in a valid factomd instance. Use: courtesy-node.factom.com (copy and paste the address in the text field).

Online Wallet 2

Then click “Save Changes”.

You are now using an online version of factomd! No need to sync the whole blockchain, just the transactions.

Once the wallet has synced all transactions it should look like below.

Online Wallet 03

The first thing you may want to do is change the wallet theme, for the purpose of this guide we will use the Dark Theme going forward.

Click on “Settings” on the bottom left and select “Enable dark theme”, then hit “SAVE CHANGES”.

Online Wallet 04

Here’s how it will look like in dark.

Online Wallet 05

Pat yourself on the back for making it this far! You have now run Enterprise Wallet for the first time and managed to change its theme.

Run Enterprise Wallet Locally

This step is required before you run factomd.

In a new Terminal window, run

Mac

cd /Applications/Factom/

Windows

cd C:\Program Files (x86)\Factom\

On Mac, Windows and Linux, run “factomd” first

factomd

Then browse to http://localhost:8090 to see the Control Panel for your local FF node.

node 01

On Windows, Mac and Linux locate the Enterprise Wallet app and launch it.

The wallet may show a warning while your factomd instance is syncing the blockchain.

Wallet 00

Once the wallet has synced all transactions it should look like below.

Wallet 01

The first thing you may want to do is change the wallet theme, for the purpose of this guide we will use the Dark Theme going forward. Click on “Settings” on the bottom left and select “Enable dark theme”, then hit “SAVE CHANGES”.

Wallet 02

Here’s how it will look like in dark.

Wallet 03

Pat yourself on the back for making it this far! You have now run Enterprise Wallet for the first time and you managed to change its theme.

Create A Factoid Address

The first thing you need is most probably a Factoid Address (FA) and it’s very easy to do that with our new wallet. If you haven’t already done so, Run Wallet.

Click on Address Book.

Wallet 03

Then hover with your mouse on the “yellow +” button at the bottom right.

Wallet 04

The button will expand and show “NEW ADDRESS”, then click on it.

Wallet 05

All you need is type a Nickname for the address, also known as “alias”, then click “ADD TO ADDRESS BOOK”. We nicknamed our address FCT01, give it a name that is relevant to you.

Wallet 06

The wallet will prompt you with the newly created FA address and its nickname.

Wallet 07

If you want to, click on “Open address in new tab” to see more details including its QR code.

Wallet 08

If needed, you can quickly copy the address to your smartphone with any QR code reader app, otherwise click “COPY TO CLIPBOARD” to use on your computer instead. Once done click on “MANAGE ADDRESSES” or the X button at the top right to return to your Address Book.

You will see your newly created address in the list.

Wallet 09

Wallet 10

If you click on the blue QR code button on the left of an address you will go back to the QR code screen above.

Wallet 11

If you click on the blue pencil you will be able to edit address details such as its Nickname, and more.

Wallet 12

In the “EDIT FACTOID ADDRESS” screen you can simply change its Nickname by typing over the old one. You can change the Nickname as many times as you want.

Wallet 13

Another thing you notice is the “DISPLAY PRIVATE KEY” button, if you click it, it will show “Displaying private key is disabled in settings”.

Let’s give it a try so you get familiar with another important function. Go to “Settings”, select “Enable ability to export private keys” then hit “SAVE CHANGES”.

Wallet 14

Then go back to your Address Book and click on the “blue pencil” to edit your address. If you now click on “DISPLAY PRIVATE KEY” it will appear on the left.

Wallet 15

You have learned how to generate a new FCT address and quite a few more things in between. (thumbs up)

Create an Entry Credit Address

Perform this step only if you intend to make entries into Factom or want to stock up on Entry Credits (EC) for future use. Remember, ECs are non-transferrable and cannot be sold or traded on an exchange. Make sure you need them before you go ahead.

You are now ready to generate a new Entry Credit (EC) address, it’s very easy with our new wallet.

If you haven’t already, Run Wallet.

Click on Address Book.

Wallet 035

Select “ENTRY CREDIT ADDRESSES”.

Wallet 36

Then hover with your mouse on the “yellow +” button at the bottom right.

Wallet 37

The button will expand and show “NEW ADDRESS”, then click on it.

Wallet 38

All you need is type a Nickname for the address, also known as “alias”, then click “ADD TO ADDRESS BOOK”. We nicknamed our address EC01, give it a name that is relevant to you.

Wallet 39

The wallet will prompt you with the newly created EC address and its nickname.

Wallet 40

If you want to, click on “Open address in new tab” to see more details including its QR code.

Wallet 41

If needed, you can quickly copy the address to your smartphone with any QR code reader app, otherwise click “COPY TO CLIPBOARD” to use on your computer instead. Once done click on “MANAGE ADDRESSES” or the X button at the top right to return to your Address Book.

You will see your newly created address in the list.

Wallet 42

Wallet43

If you click on the blue QR code button on the left of an address you will go back to the QR code screen above.

Wallet 44

If you click on the blue pencil you will be able to edit address details such as its Nickname, and more.

Wallet 45

In the “EDIT ENTRY CREDIT ADDRESS” screen you can simply change its Nickname by typing over the old one. You can change the Nickname as many times as you want.

Wallet 46

Another thing you notice is the “DISPLAY PRIVATE KEY” button, if you click it, it will show “Displaying private key is disabled in settings”.

Let’s give it a try so you get familiar with another important function. Go to “Settings”, select “Enable ability to export private keys” then hit “SAVE CHANGES”.

Wallet 47

Then go back to your Address Book and click on the “blue pencil” to edit your address. If you now click on “DISPLAY PRIVATE KEY” it will appear on the left.

Wallet 48

You have learned how to generate a new FCT address and quite a few more things in between. (thumbs up)

Send and Receive FCT

You can send Factoids (FCT) from your local wallet to a another Factoid Address (FA) within your wallet or a third party. To do so you will need a source address and a destination address to execute the necessary command. You need to perform this action when you want to send FCT to an exchange, a friend, etc. Assuming you have a local FA address containing some FCT you wish to send and have a destination address you will need to:

Run Wallet. (Yes, we know it’s growing on you)

You can receive Factoids using the same instructions below, for instance, if you want to move FCT between two FA addresses within your local wallet. If instead you want to receive FCT from an exchange or a third party, you simply provide your FA Address to the sender. Once sent you can verify the transaction has confirmed as well as your local FCT balance. Our wallet makes it easy to grab the info you need for your FA addresses.

Click on Transactions.

Wallet 49

Then hover with your mouse on the “yellow +” button at the bottom right.

Wallet 50

The button will expand and show “NEW TRANSACTION”, click on it.

Wallet 51

Select “RECEIVE FACTOIDS” from the menu.

Wallet 52

From the “RECEIVE FACTOIDS/ENTRY CREDIT PAGE” you can “COPY TO CLIPBOARD” the FA address and paste where needed as well as use a QR code reader app to do so on a smartphone.

Wallet 53

You are now ready to make you first FCT transaction, it’s very easy with our new wallet.

Click on Transactions.

Wallet 54

Then hover with your mouse on the “yellow +” button at the bottom right.

Wallet 55

The button will expand and show “NEW TRANSACTION”, click on it.

Wallet 56

Select “SEND FACTOIDS” from the menu.

Wallet 57

On the “SEND FACTOIDS” page paste the recipients FA address into the “Type factoid address” field, alternatively select a local address by clicking on the blue address book icon to the right.

Wallet 58

Hovering on the address Nickname shows the actual address, then select it and click “ADD ADDRESS”.

Wallet 59

Next type how many factoids you wish to send and click “VIEW TRANSACTION”. The fee will be added, you can now change the transaction with “EDIT TRANSACTION”, cancel with the “X” at the top right or send with “SEND TRANSACTION”.

Wallet 60

The wallet will prompt you with the outcome of the transaction as well as the Transaction ID.

Wallet 61

You can then go back to your transactions list, select the transaction and get more info about it with “VIEW IN EXPLORER” or “LOCAL EXPLORER”.

Wallet 62

Advanced FCT Transactions

Instructions below are to be used if and when required to have more control over transactions, such as:

Go to settings and select both:

This is to enable the extra features.

Wallet 63

Advanced Transactions

Click on Transactions.

Wallet 64

Then hover with your mouse on the “yellow +” button at the bottom right.

Wallet 65

The button will expand and show “NEW TRANSACTION”, click on it.

Wallet 66

Select “SEND FACTOIDS” from the menu.

Wallet 67

The “SEND FACTOIDS” page presents you with quite a few more options. You can now specify several things such as:

For this example we have selected 1 source address sending 0.1 FCT to recipient and where fees are paid by source. We also clicked “GET NEEDED INPUT” to see how much the transaction would cost in total, including the fee. Once happy select “VIEW TRANSACTION” to reveal the fee.

You are then ready to send or edit/cancel.

Wallet 68

If you decide to send the wallet will notify you with the TxID.

Wallet 69

Signing, Exporting, Importing Transactions

There are times when recurring transactions with multiple inputs and outputs can be time consuming. So instead of having to set all details one by one each time, our wallet allows you to export them to a file reasy to use them at a later date and repeatedly.

To check this handy function select “NEW TRANSACTION”.

Wallet 70

Then choose “IMPORT/EXPORT TRANSACTIONS” from the menu.

Wallet 71

The “IMPORT/EXPORT TRANSACTIONS” page works as previously shown, with multiple input and output addresses, get needed input, etc. Use “EXPORT TRANSACTION” either signed or unsigned with the dedicated tick box check or unchecked. You can also import a previously saved transaction with “IMPORT FROM FILE”.

Wallet 72

You can then choose if exporting or editing the transaction further.

Wallet 73

You have now mastered the advanced wallet features. (high five)

Convert FCT to Entry Credits

“It’s still magic even if you know how it’s done.”

-Terry Pratchett, A Hat Full of Sky

Before we automagically convert Factoids (FCT) to Entry Credits (EC), here is how the spell works. FCT are burned to create ECs. The number of FCT used will be deducted from your wallet’s balance, so don’t freak out when you see your FCT balance reduced. Just look for the newly created ECs on the EC address. Now if you don’t see the newly created ECs, it’s time to freakout and repeat these words, “Houston, we have a problem.” (Disclaimer: Factom has no customer service center in Houston.) Moving on…and getting down to business.

You will need a source address containing some FCT and a destination EC address to be able to to do this. In this example, we assume that you have already created a local EC address (destination) and you have some FCT in your local FA address (source).

To get ECs proceed as follows.

If you haven’t already Run Wallet.

Select “NEW TRANSACTION”.

Wallet 74

Choose “BUY ENTRY CREDITS” from the menu.

Wallet 75

Simply select the amount of EC you’d like to buy and the wallet will figure out the rest and warn you if the balance is insufficient to cater for amount and fee. Our example show we have enough balance after selecting “VIEW TRANSACTION” with the prompt suggesting to either “SEND TRANSACTION” or “EDIT TRANSACTION”.

Wallet 76

We also got confirmation of the transaction together with its ID from the wallet.

Wallet 77

You can then go back to your transactions list, select the transaction and get more info about it with “VIEW IN EXPLORER” or “LOCAL EXPLORER”.

Advanced EC Transactions

Go to settings and select “Enable coin control (specific or multiple input addresses for new transactions)”.

This is to enable the advanced features.

Wallet 78

Then select “NEW TRANSACTION”.

Wallet 79

Choose “BUY ENTRY CREDITS” from the menu.

Wallet 80

You can now select multiple input FA as well as EC addresses. In our example you can see we made an error in the amount of FCT required to buy 1500 EC thanks to “GET NEEDED INPUT” making the right estimate for us. When clicking on “VIEW TRANSACTION” the wallet prompted a warning message.

Wallet 81

So we corrected our mistake by specifying the right anount of FCT required, (1.430535 for 1500 EC).

Wallet 82

The transaction finally went through as we can see from the prompt with TxID

Wallet 83

Once submitted, from your transactions list, select the transaction for info about confirmation, amounts, addresses and more with “VIEW IN EXPLORER” or “LOCAL EXPLORER”.

You made it so far, you will be fine going forward. We have touched all of the advanced wallet features. Have a well deserved break! (clap)

Redeem FCT from Koinify

This section is relevant if you participated in our Software Token Sale hosted by Koinify back in 2015 and haven’t redeemed your Factoids (FCT). Although Koinify closed their operations, they never held your FCT, and you only need your 12-word master passphrase to access your FCT.

The 12-word master passphrase can be used with the Factom Foundation Wallet to create the crypto signatures required to reassign the Factoids to another address or purchase Entry Credits. So go find that magical piece of paper where you wrote down your unique 12-word magic spell and follow the instructions below:

To get hold of your FCT, run the wallet if you haven’t already.

Go to the address book and select “NEW ADDRESS”.

Wallet 84

From the drop down menu select “Import from Koinify phrase”.

Wallet 85

In this example we use the word “yellow” 12 times, yours will be different and unique to yourself. Type it or paste it in the address bar. After adding a Nickname (ours is FCT05) and selecting “ADD TO ADDRESS BOOK” the FCT balance should be assigned to a new FA address and appear in the list of addresses. The balance should also show in the total wallet balance at the top.

Wallet 86

You are a champ! You are ready to use your FCT to trade or buy EC.

Import Private Key

This section is relevant if you have a private key for a FCT or EC address for instance from a previous wallet ot third party.

To get hold of your FCT, run the wallet if you haven’t already.

Go to the address book and select “NEW ADDRESS”.

Wallet 87

From the drop down menu select “Import from Private Key”. Type it or paste it in the address bar. After adding a Nickname (ours is From Old Wallet) and selecting “ADD TO ADDRESS BOOK” the FA address hould appear in the list of addresses. The balance should also show in the total wallet balance at the top.

Wallet 88

Follow the same procedure to import a private key for an EC address.

You are so good at this already! You are ready to use your FCT balance.

Transfer FCT To Secure Wallet

Create Backup of Your Current Wallet

First of all make sure to Backup Your Wallets!

Upgrade Factom Enterprise Wallet

Then upgrade Enterprise Wallet to the latest version by following our Install Enterprise Wallet guide.

Create Secure Wallet & FCT Address

1. Run Enterprise Wallet.

2. On the first screen, choose the “Secure” option.

Online Wallet 00

3. Enter a strong password and write it down – if you forget it and cannot recover it, you will lose access to the factoids that are stored in your Secure Wallet. Tick the checkbox to acknowledge this, and then click “Proceed To Encrypted Wallet” to automatically generate a new “factom_wallet_encrypted.db” file in your .factom folder (which will be encrypted with the password you just chose).

Online Wallet 00

4. From the Enterprise Wallet application, you can now create a new factoid address.

5. Copy the address you generated in the previous step, so that you can fund it with factoids later in the process. You may want to save this in a separate text document for future reference (and to make it easy to copy and paste later on).

6. Once you are sure you have a backup of your wallet data, exit the application, and make sure that it is no longer running.

Create Backup of Your Secure Wallet

Now it’s time to backup your newly created secure wallet (encrypted) by following the Backup Your Wallets! guide.

Send FCT to Your Secure Wallet

1. Once again, run Enterprise Wallet.

2. On the first screen, choose the “Not Secure” option.

Online Wallet 00

On the second screen tick the checkbox and click the “Proceed to Unencrypted Wallet” button.

Online Wallet 00

3. When the wallet has fully loaded, you should see your original factoid balances again. You can now send your factoids to the new Secure Wallet address you just generated by following the Send and Receive FCT Guide.

4. Once you have sent your factoids from the Not Secure wallet addresses to the new, Secure wallet address(es) and waited for the transaction(s) to confirm, exit the application once again and make sure that it is no longer running.

The End

If you have followed the above steps, when you next Run Enterprise Wallet and select the “Secure” option using the password you chose earlier, your balances will include the factoids that you sent to it, and your wallet will be securely encrypted.

Verify FCT and EC Balances

After sending or receiving factoids, importing secret keys, or redeeming your 12-word master passphrase you may want verify your address balances. We’ve provided 2 easy ways to verify your Factoid (FCT) or Entry Credit (EC) balances.

1) With the Factom Control Panel

The Factom Control Panel is easy to use and great for verifying your FA or EC balances. Simply Run Wallet and open the Control Panel web page in your browser: http://localhost:8090/

Find the search bar on the upper right-hand corner of the Factom Control Panel.

Wallet 89

Paste the FA address you wish to verify in the search bar.

Wallet 90

Click GO.

Wallet 91

The Control Panel will display the factoid balance for the FA address under “Amount Available.” In this example, we have a balance of 2 FCT.

Repeat the steps above to verify the balance of an EC address. Paste the EC address you wish to verify in the search bar.

Wallet 92

Click GO.

Wallet 93

The Control Panel will display the Entry Credit balance for the EC address under “Amount Available.” In this example, we have a balance of 20 EC.

You may also use the Control Panel to get more info about Transaction IDs, Block Numbers, Chain IDs, and more.

2) With the Factom Explorer

The Factom Explorer provides information about our blockchain including FA and EC addresses, blocks, entries, and more. From here you may verify your FA or EC balances without running our software. Find the Factom Explorer at https://explorer.factom.org.

Wallet 94

Paste the FA address you wish to verify in the search bar.

Wallet 95

Hit Enter on your keyboard.

Wallet 97

The Explorer will display the balance of the FA address, in this example 1.892 FCT, along with previous transactions.

Now, let’s repeat the steps above to verify the balance of an EC address.

Paste the EC address you wish to verify in the search bar.

Wallet 97

Hit Enter on your keyboard.

Wallet 98

The Explorer will display the balance of the EC address, in this example 3999 EC, along with its previous transactions.

You made it this far and got the knowledge, now is time to teach others how to use Factom! (big grin)

The Factom Explorer

The Factom blockchain comprises of more than 77,000 blocks, at the time of writing. While the majority of the block lookups are done via APIs, the Explorer allows viewers to peruse data manually. The Factom Explorer provides information about the Factom blockchain including Factoid and Entry Credit addresses, blocks, entries, time stamps, transaction IDs and more.

Exploring Factom blocks manually via the Factom Explorer can be very insightful and informative for users looking to understand Factom’s data structure design. Furthermore, it provides important information such as FCT or EC balance visually, without having to run our software. The Factom Explorer is accessible at https://explorer.factom.org.

Overview

The Explorer has 2 tabs, “Explorer” and “Chains”. The “Explorer” tab displays details of the Factom Data Structures including the Directory Blocks with their IDs and block times, KeyMRs, Admin Entries, EC Entries, Factoid Entries, and user generated Entries.

Explorer 1

The “Chains” tab displays details all the Factom chains with their ChainIDs and Chain Names.

ChainID

The ChainID is created by hashing the name of a Factom Chain. ChainID’s are used in the Directory Block, and anywhere else in the protocol that must refer to a Factom Chain.

Chain Names

Chain Names are generated by the user to uniquely identify a Chain. They can be random numbers, a string of text, a public key, or a hash of some private directory path.

The Chain Name can be specified with multiple sequential byte strings. A byte string is similar to a string (a series of characters) – but its content is a sequence of bytes instead of characters. They are treated as different segments of data instead of concatenated, to differentiate trailing bytes of one segment from leading bytes of the next segment.

Explorer 2

Directory Block

Factom is constructed of a hierarchical set of blocks, with the highest being Directory Blocks, which consist of a header and a body. Each Directory Block has a header for unique identification and contains hashes of the Entry Blocks and their respective ChainIDs for entries made during the time period. To link this data together, each Directory Block contains the serial hash of the previous Directory Block. The body of the Directory Block is a series of pairs of ChainIDs and Entry Block Merkle Roots.

The example below displays Directory Block ID 75416. Note that this block was not yet anchored on the Bitcoin blockchain, at the time of writing.

Explorer 3

In the example below Directory Block ID 70405 shows that the block has been anchored on the Bitcoin blockchain.

Click on the “BTC Transaction” and the “Anchor entry” to get further information.

Explorer 4

Within each Directory Block is an Admin Block, an Entry Credit Block, a Factoid Block, and several Entry Blocks. These Factom data structures include different information and are described below.

Explorer 5

Admin Block

The Admin Block contains the signatures and organizational data needed to validate previous and future Directory Blocks. It has a LookupHash, in this case:

69f4bebe76d94054f4bdb0cf56a47cafacae60ce6be76885ecd60252463a6e8e

This is a SHA256 of the entire block. Clicking it displays the Admin Block itself which contains:

The JSON Data includes the references to the previous block such as:

The LookupHash for the current Admin Block, 75416, will be included in the next created Admin Block as the Previous Block Back Reference (PrevBackRefHash) in the near future (about 10 minutes) where it gets referenced. The next Admin Block will also include the same type of data, this creates the Factom Blockchain composed of consecutive blocks with references to previous blocks.

Explorer 6

The 5 entries included in this Admin Block present more information.

Explorer 7

Clicking on any of the entries shows further data such as the Hash, ChainID, Timestamp, Entry Data and JSON Data.

Explorer 8

An Entry is a single data submission made by a user. A collection of entries makes up a Factom Chain. There are certain bookkeeping entries required, but there are no restrictions on the content of an Entry. An Entry is restricted to no more than 10K in size and requires an Entry Credit for every 1K of data. Entry size is so restricted to ensure reasonably fast propagation of Entries through the network, as required by the consensus algorithm. The user can string together multiple entries for larger content.

Entry Credit Block

An Entry Credit (EC) Block is a data structure which packages Chain Commits, Entry Commits, and EC balance increases over a ten-minute period. The Entries are ordered in the Entry Block in the order that they were received by each Federated server. All the Federated servers contribute to the building of the EC Block.

The Entry Credit Block consists of a header and a body. The body is composed of primarily commits and balance increases with minute markers and server markers distributed throughout the body.

Explorer 9

The JSON Data is also shown.

Explorer 10

This particular block contains 57 Entries.

Explorer 11

Factoid Block

Factoid Blocks package Factoid transactions that take place each minute over a ten-minute period. Factoid transactions and their minute markers are arranged in the order in which they were received by the Federated server. Factoid transactions begin with a version number above zero, differentiating them from other types of transactions, and minute markers are included in the ledger Merkle roots.

Explorer 12

In the below list of entries, FCT transactions may be identified by looking at the Totalins and Totalouts.

Explorer 13

Selecting the second entry, more information is displayed about the FCT transaction such as the Tx ID, Timestamp, the Block Height, as well as its FCT Inputs and Outputs.

Explorer 14

Entry Block

Entry Blocks package Entry Hashes of all entries for a particular Factom Chain received over a ten-minute period, arranged in the order in which they were received by the Federated server.

After each ten-minute period, the Merkle Roots for each Entry Block are stored in the Directory Block. Entry Blocks contain Entry Hashes with 10 one-minute markers.

Explorer 15

Entry Data can be viewed by selecting an entry in this Entry Block.

Explorer 16

Selecting the Chain ID redirects to the First Entry display, showing the Chain that the entry was made to and a series of user-populated External Ids.

In this example, a Chain was created to track the DOW 30 stock price for McDonald’s, data provided by Intrinio.

Explorer 17

Selecting the first entry shows the Entry Data.

Explorer 18

Selecting the second entry shows more data and info about its source such as the website, the stock quote date and the quote itself.

Explorer 19

Search for FCT/EC addresses

To use Explorer to verify balances, copy and paste the FA address you wish to verify into the search bar and hit Enter.

Explorer 20

The explorer displays the balance for the FA address, in this example 1.892 FCT, along with previous transactions.

Explorer 21

Similarly, to verify the balance of an EC address, copy and paste the EC address you wish to verify in the search bar and hit Enter.

Explorer 22

Explorer displays the balance for the EC address, in this example 3999 EC, along with previous transactions.

Explorer 23

Search for a Transaction ID

When sending FCT to a third party or exchange, the transaction ID is the proof that the transaction took place and that it is unique. It is important to note and keep them for your records. To search for transaction IDs, copy and paste it into the search bar and hit Enter.

Explorer 24

Explorer displays details of the transaction such as the time it was made and Inputs and Outputs. This example shows that 100 FTC were sent from the input address to the output address, with a transaction fee of 0.006 FCT debited to the sender.

Explorer 25

Search for a Factom Chain

Once a Factom chain is created, Explorer can provide an overview of the chain and the entries made to it. The example below shows the Gutenberg Chain, containing a few thousand entries. The Chain ID is entered into the search bar.

Explorer 26

Explorer returns the Project Gutenberg Chain with all its entries.

Explorer 27

Search for a Block ID

Specific blocks can be pulled up by entering the Block ID (also known as Block Height) into the search bar. The example below shows block 7740.

Explorer 28

After hitting Enter, the Explorer will find the block and present its information.

Explorer 29

You are now equipped to use Factom Explorer to search the Factom Blockchain.

The Factomd Control Panel

Overview

The Factomd Control Panel is the graphical interface for a factomd node. It presents a lot of useful information such as the state of the node, blockchain sync status, connected federated servers, etc.

It also allows to search for transactions IDs, block height, factoid and entry credit addresses, etc, similarly to the Factom Explorer. A very useful tool to have for any Factom user or developer to keep an eye on what’s going on when running factomd on their local machines.

The Control Panel is accessible after running factomd via command line at the following url: http://localhost:8090.

The Control Panel has 2 main windows which are shown below.

The Main Status Page

Control Panel 1

The More Detailed Node Information Page

Control Panel 2

More information on the two pages and their functionality follows below.

Main Status Page

For most users this page will be the main interface to their local factomd node where they can gather at a glance all the info necessary to check its status.

1 - Main Status Page Tab

Use this button to switch to the Main Status Page.

2 - More Detailed Node Information Page Tab

Use this button to switch to the More Detailed Node Information Page.

3 - Search Bar

The search bar allows you to search for a block height, transaction ID, factoid and entry credit address, chain ID, entries, etc, similarly to the Factom Explorer.

This way you’ll be able to search using your local copy of the Factom blockchain instead of having to use the Factom Explorer online.

4 - Node Status and Version Number

This section shows if your factomd node is running or not as well as the version number which is handy to find out if you have the latest software release.

5 - Git Build Number

This section displays the local factomd Git Build Number. A build number is an identifying number assigned to a software release. This, as well as the Version Number above, allow you to check that you are running the latest version of factomd in case there are bug fixes and updates.

6 - Blockchain Sync Status Information

Control Panel 3

Starting from the top, this section displays “Your Block Height” which is the last block synced by your local factomd node, this will update progressively as the blockchain syncs to the last available block.

The “Node Sync Status” (1st pass) and (2nd pass) display a progress bar each (in green) indicating the percentage of the Factom Blockchain that has currently been synced (downloaded) locally. It starts at 0% and ends at 100% where the latter means your node is fully synced and up to date.

There are two “passes” to double check all blocks have successfully synced. The last information displayed is the number of Factom “Federated” and “Audit” servers connected to your local factomd node.

7 - Federated Servers Connections

Control Panel 4

This section displays the number of Federated Servers currently connected to your local factomd node, together with their IP Addresses, Status (online/offline), time connected (duration), data sent and received to and from them.

It also allows to disconnect from a specific federated server when selecting the “Disconnect” button. This is handy in case one of the servers goes offline to try and re-establish a new connection.

8 - Transactions & Entries

The last section at the bottom of the Main Status Page is like a built-in Factom Explorer presenting information about Factoid transactions, Chain/Entry Commits, and the last Directory Block.

All this information is collected via the local copy of the Factom blockchain, since the time your factomd node has been turned on. Once you restart factomd new information will become available.

The “Factoids” tab shows the most recent transactions, by clicking on any of them you’ll be redirected to the actual transaction info.

Control Panel 5

Click on a transaction and the actual transaction is shown, in this case it is a confirmed transaction.

Control Panel 6

Selecting its Transaction ID loads further info such as the transaction Inputs and Outputs, Tx ID and Hash.

Control Panel 7

The “Chain/Entry Commits” tab shows the latest Factom chain and entry commits. To get more info on a particular transaction simply click on its Entry Hash.

On the far right of the page you will also see the “EC COST” which is the amount of Entry Credits used for a specific entry.

Control Panel 8

The “Latest Directory Block” tab shows the last Directory Block generated by the Factom blockchain, when selecting the KeyMR url (in blue) further info for the specific block will be displayed.

Control Panel 9

More Detailed Node Information Page

The More Detailed Node Information page displays details about the local factomd node such as a summary, the process list, the print map, connections, as well as info about the Federated and Audit Servers currently connected to your local node.

Everything in this section is used by developers for debugging purposes. Any user looking at these pages isn’t expected to be able to read it, for most end users the “Main Status” page is all they will ever need to know.

A brief description of each of the tabs is below.

Summary

The “Summary” tab shows critical information describing the internal status of your node. For example “79879[0falad]” shows the number of directory blocks which have been saved to the database. They are only saved once they get past the first minute of the next block.

The three numbers separated by slashes 79877/79880/79881 describe the process lists. The three numbers bracket the different heights of process lists. The first number shows the lowest process list height that has been retained. The second number shows the process list height that is currently being built. The third number is the next height that the leaders will be building as well as the max process list which has been allocated. The “-/8” line shows which minute the leaders are on, minutes range from 0 to 9.

The following column is a series of counters for different type of messages the local node or federated servers are handling such as:

Control Panel 10

Process List

The “Process List” is a list and ordering of messages which will go into the next block. The process list shows all the messages used to create a block that your local node knows about. They are grouped by the different VMs (Virtual Machines), which map to the different servers.

The leftmost column is the item number in that specific VM’s process list for that block. The P indicates that the local node has processed that item in the list. When processed, it is valid per the local rules and updates the local state. Examples of this would be EC and FCT balances. It also changes the status of the TxID to TransactionACK.

The 3rd column with [888888f0] is the server identity which acknowledged the transaction.

The 4th column is the type of transaction: it can be REntry (Reveal Entry), CEntry (Commit Entry), DBSig (Database Signature) and EOM (End of Minute). The EOM tells the other servers that there will be no more messages from that server, and the next server can take over.

The “DBHt: 79880” is the block height followed by the message itself, for example:

– Leader[888888f053] Entry[f23149] ChainID[b4f80cf2d3].

Control Panel 11

Print Map

The “PrintMap” tab shows which of the VMs are responsible for the different segments of the network for each minute over the 10 minute period. The columns show the different VMs. Different servers are responsible for different VMs during different 10 minute periods. The rows are the different minutes in the 10 minute segment.

Control Panel 12

Servers/Authorities

The “Servers/Authorities” tab displays information about all Federated and Audit servers visible to the local factomd node. A server identity is an identifier which is self-bootstrapped and required to be an audit or federated server. An identity is created with this program: https://github.com/FactomProject/serveridentity to this specification: https://github.com/FactomProject/FactomDocs/blob/master/Identity.md.

Each server has their own identity, however, if the same identity is on the network at the same time due to an accident, one or both of the servers will panic. The identity is a more generic construct. It has 4 different levels of public/private keys, which can be used to replace lower level keys such as a Signing Key (to sign transactions) or an Anchor Key (to anchor Merkle Roots of Factom chains in the Bitcoin blockchain).

The “Management Chain” also known as Server Management Chain is more specific to the Federated and Audit servers and contains a key to sign the directory blocks and process list messages.

The “Matryoshka” is currently unused but it will provide a form of deterministic randomness in future contention resolving systems.

Control Panel 13

Servers/Identities

The “Servers/Identities” tab displays information about all Federated and Audit servers as well as the “Skeleton Identity” used to add and remove servers from the network in Milestone 2 (M2). Normally servers fail over between Federated and Audit servers automatically, but adding and subtracting servers is done with the Skeleton Identity.

Control Panel 14

Servers/My Node

The “My Node” tab displays the local factomd node name (FNode0), its Identity ChainID and Signing Key.

Control Panel 15

Connections/Raw

The “Connections/Raw” tab displays all the servers and nodes that are connected to the local factomd node with their status and IP Address.

Control Panel 16

Connections/Other

The “Connections/Other” tab displays all the servers and nodes that are connected to the local factomd node with their status and Identity Hash.

Control Panel 17

The Control Panel is a great tool to visualize, search and gather data about the Factom Network, its Federated and Audit Servers as well as the local factomd node. It is of great help for both end users to quickly check the status of their nodes as well as for developers looking for more in-depth information to allow them to troubleshoot issues.

Useful Factom Tools

Factom Status

To check the status of Factom head over to

http://status.factom.com

It will show you, for example, when the Factom Network is under maintenance.

Factom Live Stats

Another useful tool is the following found at:

https://www.trustedoracle.com/BlockChainStatus

It will show you some live stats for factom such as:

It will present the data in the below format:

{"Records":85775274,"Entries":5981665,"Anchors":68227}

Factoid Live

Finally a third party site, Factoid Live, built by a community member and found at:

https://factoid.live

It can show you the top FCT and EC addresses and their balances. Factom is not responsible for the accuracy of the data presented.