Interacting with the Factom community testnet from the command line

The testnet can be interacted with in much the same manner as the Factom main-net.

Testoids (equivalent to Factoids) can be transferred or converted to Test credits (equivalent to Entry credits), chains and entries created, information on transfers and account balances pulled and APIs interfaced.

If you are interested in interacting with the Factom Community Testnet, download the latest appropriate binary release. This will install the factomd, factom-cli and factom-walletd commandline tools. Now download factomd.conf from the testnet toolkit and place it in the appropriate folder. For Ubuntu, this will be in your home folder ~/.factom/m2. For Windows, look in your AppData/Roaming folder.

Open a terminal window and start your local factom node:

factomd -customnet=fct_community_test

This command will start a full factom testnet node. You should allow it to sync with the network (this can/will take hours) before you start interacting with the blockchain. Leave this running and start a new terminal in order to interact with the daemon. Open the control panel at http://localhost:8090 to check the status, or try factom-cli get heights

A full list of CLI commands is available by executing:

factom-cli help

The enterprise wallet

In addition to the commandline tools, you can download the enterprise wallet from https://github.com/FactomProject/distribution#factom-enterprise-wallet

This is a GUI application you can install on any machine, including the one running your node. Go to Settings and uncheck Custom Factomd Location if you are running your node locally. If you are running your Factomd node on a linux server and want to connect to it using the enterprise wallet on your Windows computer, simply check "Custom Factomd Location" on your Windows wallet and type in your server's IP-address followed by the TCP port (8088 is the default testnet API port), for example 192.168.105.55:8088


Some useful commands

Task Command Information
Add Chain factom-cli addchain [-fq] [-n NAME1 -n NAME2 -h HEXNAME3] [-CET] ECADDRESS <STDIN> Create a new Factom Chain. Read data for the First Entry from stdin. Use the Entry Credits from the specified address. -C ChainID. -E EntryHash. -T TxID.
Add Entry factom-cli addentry [-fq] [-n NAME1 -h HEXNAME2 ... -c CHAINID] [-e EXTID1 -e EXTID2 -x HEXEXTID ...] [-CET] ECADDRESS <STDIN> Create a new Factom Entry. Read data for the Entry from stdin. Use the Entry Credits from the specified address. -C ChainID. -E EntryHash. -T TxID.
Check Balance factom-cli balance [-r] ADDRESS If this is an EC Address, returns number of Entry Credits. If this is a Factoid Address, returns the Factoid balance.
Convert Testoids to Test Credits factom-cli buyec [-fqrT] FCTADDRESS ECADDRESS ECAMOUNT Buy ECAMOUNT number of entry credits. -f force. -q quiet. -r Netki DNS resolve. -T TxID.
Export private addresses factom-cli exportaddresses List the private addresses stored in the wallet
Get data factom-cli get allentries / chainhead / dblock / eblock / entry / firstentry / head / heights / walletheight / pendingentries / pendingtransactions / raw / dbheight / abheight / fbheight / ecbheight Get data about Factom Chains, Entries, and Blocks
New TC address factom-cli newecaddress Generate a new Entry Credit Address in the wallet
New Testoid address factom-cli newfctaddress Generate a new Factoid Address in the wallet
Reciept query factom-cli receipt ENTRYHASH Returns a Receipt for a given Entry
Send Testoids factom-cli sendfct [-fqrT] FROMADDRESS TOADDRESS AMOUNT Send Factoids between 2 addresses. -f force. -q quiet. -r Netki DNS resolve. -T TxID.