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 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.

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

The wallet file is called “factom_wallet.db” and is located in the .factom folder at the following locations:

To backup your FF wallet file, quit factomd and EnterpriseWallet, locate the factom_wallet.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.

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.

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\ 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 factom.msi 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.deb installer as per Step 1 then run the following command to install.

sudo dpkg -i ./factom-amd64.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.

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 .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 .msi 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

Locate the .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

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.

Run Enterprise Wallet Online

If you have previously used 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.

If you have never used FG, 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: factomd-live.cloudapp.net:8088 (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

README FIRST - Starting Factom

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 bootup, 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.

After factomd boots and downloads the remaining blocks, it likely is not keeping up with minutes. To see if it is, on the control panel click the “More Detailed Node Information” button. Towards the right of the top line there will be a field “-/ 0”. If the 0 number does not increase after a minute, then it is not keeping up with minutes.

In most cases factomd will need to be restarted after synching to the latest blockchain.

Run Enterprise Wallet

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

Once you are synced, in a new Terminal window browse (cd) to the location of your FF installation as you did above (Mac and Windows only).

If you have previously used 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 to run the the wallet below.

If you have never used FG, 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.

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.

Useful Factom Tools

Factom Status

To check the status of Factom head over to

http://factomstatus.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:

http://presentfactom.cloudapp.net:8080/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.