Other help topics
• External link: Gocoin Homepage with User manual
Home
The home page of Gocoin's WebUI consists fo the following parts.
Wallet
In this section you see the balance of your currently selected wallet.
You can download the balance.zip file that is needed by gocoin's wallet app in order to spend any of the bitcoins from this wallet.
You can also peek at all the unspent outputs belonging to your currently selected wallet.
Last Block
Information about the top most block of the block chain known to your node.
Network
Network related information and statistics, concerning the node.
Others
Some other data related to your running node.
In this section you can also order the node (its garbage collector engine) to free as much memory as possible.
Edit configuration
If you press this button a text area will appear with JSON encoded content of the gocoin client configuration file.
See some help about its content here.
Change the values you need an press either Apply or Apply & Save.
If you do not save, the changes will not be permanent and will get undone at the next shut down of the node.
To cancel editing, press the Cancel button reload the page.
Save configuration
Whenever you have made any changes to a running node and you want to apply they permanently, press this button to do so.
Shutting down the node
Press the Shutdown Node button and confirm to shut down the node.
Note that after the node is off, you will not be able to launch it from the web interface (it will shut down as well).
Wallet
At this page you can check a balance of each address of you currently selected wallet, as well as quickly switch between all your available wallets.
Special wallets
There are three wallets with a fixed name that have a special meaning:
- ADDRESS - this is your address book (the addresses you will be able to select at MakeTx page)
- DEFAULT - this is the wallet that is always loaded when the node starts
- UNUSED - this is wallet where you can move the addresses that you are no longer planing to use (to remove them from your wallets, though still being able to monitor a balance on them, just in case)
Address book
The address book is a special kind of wallet. You can select it only at this page - when you leave the page, it will switch back to the default wallet.
On the Wallet page you can edit the address book just like any other wallet.
Editing wallet
Select a wallet that you wish to edit, end press Edit.
After you are done press Save wallet & Recalc balance button.
Adding wallets
To add a new wallet press the Edit button, enter the new wallet's name in
File Name filed, place the desired content of the wallet in the text area
and press the Save wallet & Recalc balance button.
Deleting wallets
You cannot delete wallet files from the web interface.
In order to delete a wallet you need to remove the wallet file from the
wallet/ folder (that is a sub-folder in your gocoin's data dir),
Hidden wallets
You can have a wallet that won't be visible on the list. Just give it a file name that starts with a dot (.)
Including wallets
You can include a content (addressees) of one wallet in another. In order to do this, inside the parent wallet put a line like this:
@filename
(make sure that the @ character is the first one in the line)
The wallets you include can be of a hidden type. In fact, including hidden wallets inside parent wallets is their only meaning of their existence.
MakeTx
Create a transaction to be further signed by gocoin's wallet.
It will also crate a raw transaction, which you can sign by any other wallet (e.g. bitcoin-qt).
Payment details
Fill in the outputs of the transaction, the fee and the change address.
If you need more outputs, press the + add output link.
Note that mBTC values and the value of Change are read-only.
Estimated tx size
Note that the estimated transaction size may not be accurate.
It always assumes compressed public keys and 2 of 3 required signatures in case of unknown P2SH input scripts (without corresponding JSON files in wallet/multisig/).
Select Inputs
Select the unspent outputs that you want to have in the transaction.
Obviously they must carry enough bitcoins to satisfy your output volume along with the fee - only then Download payment.zip button will be enabled.
Download payment.zip
If the button is not enabled, something in the forms is filled in incorrectly.
Otherwise press it to download payment.zip, which you will need to extract at your wallet machine.
Then execute the payment command (by default it will be in file pay_cmd.txt) and the wallet shall create and sign the transaction, just as you have defined it here.
Network
The current network connections to other bitcoin peers.
Incoming connections
Click in the link [Switch ON/OFF] (right from the label
Listening for incoming TCP connections)
to switch between allowing or blocking remote connections coming to your node from internet.
Note that switching on this does not automatically mean that peers will be able to connect to your node.
In most cases you will also need to configure your network gateway to allow incoming connections at the desired TCP port and route them to the host running the node.
Also mind that the recent versions of Satoshi client will not connect to your node on any port other then the default one (that is 8333, or 18333 for testnet).
Note that you need to save configuration at the Home page to make the change permanent.
Peer statistics
Click on any row in the network connections table to see detailed info about each peer.
The info appears as a text box, below the table.
Drop a connection
Click on
icon at the right column of a row describing a peer connection to disconnect from it.
Transactions
Transactions memory pool, broadcasting and routing control.
Memory pool
If the memory pool is disabled the node only operates on the full blocks and never downloads any transactions.
To enable/disable memory pool click the [Switch ON/OFF] link next to the "Memory pool" label.
Note that you need to save configuration at the Home page to make the change permanent.
Relay transactions
Having the memory pool enabled, you can setup your node to either relay incoming transactions, or not.
Press the [Switch ON/OFF] link right from the label to switch this option on/off.
Note that you need to save configuration at the Home page to make the change permanent.
Accepted transactions
The value on the button shows how many transactions are there in the memory pool - click on it to see the list.
Your own transaction (loaded locally) always appear on the top of the list.
The Sent column in the table says to how many times the transaction's data was sent to a peer and (after slash) how many times the inv was sent out.
If the transaction was blocked from being relayed (assuming that the relaying was enabled), the Extras column will show the reason.
Own transactions
Locally loaded transactions appear on a light-red background and they have three special icons at the right side of the row.
• Clicking on
- orders the node to broadcast a transaction to one random peer (useful for privacy purposes)
• Clicking on
- broadcasts the transaction to all the currently connected peers.
• Clicking on
- removes (unloads) the transaction from the memory pool.
UTXOs spent in memory
The number shows how many inputs are currently considered spent by the transactions that have been accepted into the memory pool.
When an input is on this list any new transaction that tries to re-use it will be rejected as a double-spend.
Rejected transactions
The value of the button next to the label shows you how many transactions were not accepted into the memory pool.
You will see their list when clicking the button, along with the reason of the rejection.
The node maintains this list to avoid downloading transactions that it had already rejected once.
Transactions are removed from this list either when they get mined into a block or when the node decides to expire them.
Transactions waiting for inputs
Here you can check transactions that are waiting for inputs, assuming that you allowed such transaction into memory pool,
which is controlled by configuration parameter TXPool.AllowMemInputs.
Transactions being processed
Number of transaction in the network queue.
These are transactions that are already received from the network (via tx command), but have not been yet processed by the memory pool handler.
In most cases both the number should be equal.
Blocks
This page shows an information about the recent blocks added to the block chain.
Miners
This page shows an information about the block chain mining statistic.
LoadTx
Allows to quickly import own transaction to the memory pool.
The transaction must be in a raw (hex-encoded) format with no spaces, nor any other characters except hex digits.
If the operation succeeds you will end up in Transactions page that will display the decoded transaction data.
In order to send you transaction out, make sure to broadcast it after loading.
Counters
The node's internal real time counters and statistics.