Using the NEO-GUI Client
Downloading the client
The client itself does not require any installation. Download and extract the files to a location of your choice, then double-click neo-gui.exe to open the client. If there are any problems with the process and the client cannot be used normally, please keep the error.log file located in the same directory as neo-gui, then contact our technical staff to assist you in solving the problem.
The neo-gui client is compatible with the following versions of Windows: Windows 7 (Service Pack 1) / Windows 8 / Windows 10.
Windows10 pre-version of the system requires installation .NET Framework 4.6.2.
Synchronizing blockchain data
The client must be fully synchronized before use. The bottom left hand corner indicates the number of blocks synchronized and the total number of blocks in the network (see example below). These numbers will update regularly.
In order to speed up network synchronzation you can download a copy of the blockchain up to a certain blockheight. This means the client will only need to sync the additional blocks from the NEO network rather than the entire blockchain.
To begin, download the file located at https://www.neo.org/client/chain.acc.zip
Close the neo-gui client and open chain.acc.zip. Extract the chain.acc file in the neo-gui folder as shown in the figure below:
After re-opening the neo-gui client you will see that the client is now synchronized up to a certain point and the client will now continue synchronizing the rest of the blockchain. As shown in the figure below:
When synchronized to a certain point, the file (chain.acc) will be deleted and synchronization from the NEO network will continue. As shown in the figure below:
The data beside "Height" correspond to wallet height/client height/blockchain. When you open a wallet, the wallet height data is displayed.
A wallet file stores a reference to your NEO, GAS, and account information in a database with .json or .db3 extension. This file is very important and must be backed up securely.
Loss of either the wallet file or wallet password will result in the loss of your assets. Please ensure that the wallet file is securely stored and remember the wallet password.
This is used to track assets in a NEO block.
Account information includes: Address, private key, public key, type.
Address: The equivalent of a bank account or bank card number, used to receive assets during transactions.
Type: Neo.Wallets.SignatureContract Indicates that the address consists of a public key and is a 1-of-1 multi-signed address. Neo.Wallets.MultiSigContract indicates that the address consists of multiple public keys and is a m-of-n multi-signature address, which is used for smart contracts.
Private key: A 256-bit random number, kept by the user and not known publicly. This represents the user account ownership and the ownership of the assets within the account.
Public key: Each private key has a matching public key (Note: Public key, and private key information can be viewed by right clicking on the address.)
At no point should the private key be disclosed to others. Once the private key is disclosed, it may result in the loss of your assets.
The assets of the account, asset information, including: Assets (NEO, GAS, the user created by the assets), type, balance, and the issuer.
A record of all transaction information associated with the account.
Transfer of assets to a recipient address. If the asset type is NEO, both parties are required to confirm with their signature. Other types of asset transfer can be conducted without confirmation for both parties.
Carries out online asset exchange between two parties, where both parties have to confirm before the successful exchange of assets can occur.
Signing of information, is to signify confirmation of the information by the signer. For transactions involving equity allocation and transfer of assets, the signature is required as proof of consent by the parties involved.
Creating a new user-issued asset in the NEO block. The user can define the type, name, total, etc. of the asset and specify the administrator account of the asset. The creation of assets need to consume a certain amount of NEO as an additional service fee, the current price is 10,000 GAS. (Test network fee is one percent of the main network)
Within the upper limits of the total amount set by the asset creator, the asset is issued to the address specified by the issuer. Distribution of assets consumes a certain amount of small coins as an additional service fee, the current price is 500 GAS. (Test network fee is one percent of the main network)
Those who want to be a NEO validator are required to register by election. Through the deposit of a certain amount of NEO, validator qualifications may be obtained. This function is not currently supported. Please wait for further updates.
Holders of NEO can vote on the validator candidates and this voting mechanism will determine if a validator is selected. This function is not currently supported. Please wait for further updates.
After signing, the transaction information is broadcasted to the entire network, where confirmation by a node, completes the transaction. At the moment, this feature only appears in the signature.
After importing the address of the other party as the monitoring address, you will be able to view the assets at that address.
Create the wallet database
Click on the
create the wallet database, pop-up
Browseto select the wallet file storage location, and set the file name, and then click Save.
repeat passwordand save your own password.
OKand the wallet will be successfully created, which by default will come with a standard account. It should be noted that due to the role of change mechanism, the remainder of the assets will be transferred to the first address by default. Thus, there is a need to back up the corresponding private key and wallet.
Open the wallet database
Every time the client is re-opened, you will need to click
open wallet databaseto select which wallet file to open, as the picture shows:
Browseto select the wallet (usually the default is the last open wallet)
Select one of the file format to open: NEP-6 (.json) or SQLite (.db3)
Clients earlier than Neo GUI v2.5.2 support only .db3 files.
Enter the password, and click
OKto enter the wallet.
If opening an old .db3 wallet, you need to choose whether to upgrade the wallet to the new NEP-6 format according to the prompted message.
After upgraded, the NEP-6 wallet can be shared among multiple clients, e.g. mobile, PC, or Web site. But it cannot be opened in the clients earlier than Neo GUI v2.5.2.
Can be used to modify the wallet password.
After changing the password, please remember to backup wallet again as any previous wallet backups will not contain the new password.
Rebuild the wallet index
This option is used to restore errors in the client when an exception occurs. The Wallet Index may need to be rebuilt in the following cases:
- After the import of a private key.
- A transaction that has not been confirmed after a long time.
- The wallet assets show errors and blockchain data does not match.
- Switching between the main net and test net.
As the current block height is very high, rebuilding the wallet index can take several minutes. Please be patient.
Token Asset Transfer
Click on the
+, and enter the transfer information.
Equity asset transfer
Click on the
+, and enter the transfer information.
Click OK, as shown in the display, where more signatures are shown to be required:
Signature function see signature.
This function is used to simplify the transfer of the same asset to a different addresses.
The data format is
address transfer amount (separated by spaces).
It should be noted that the data format should be entered in accordance with the above criteria as extra spaces are likely to lead to transfer failure.
This function is used to record the information of the transaction on the NEO block-chain. The NEO blockchain browser can be used to locate transaction information.
At the moment there is no requirement for the message format.
The remarks for the transaction can be found on the NEO blockchain browser
Initiating a deal
This transaction requires both parties to initiate a transaction request in order to determine the asset details being sent to the corresponding recipient.
Click OK to generate the transaction request. We can use the transaction request to obtain details on the terms sent by the corresponding party.
Merging of the deal
After closing the initiated transaction request window you will be shown the merge transaction request interface.
This causes the other party's transaction request to be displayed. To verify the legitimacy of the other party's request, click verify. Depending the legitimacy of the request, one can either choose to accept or refuse.
If you choose to accept then the two sides need to sign and broadcast. For details, see Signature.
This causes the transaction sent by the other party to be pasted within the input box. Click on
sign, and the output data will be generated. At the same time, the
broadcastbutton will be displayed.
broadcast, and the transaction will be sent. This transaction is now complete and a transaction ID (TXID) will be shown once the transaction is successful.
Extraction of GAS
GAS is generated with each new block and will be allocated to the address of NEO holders. (The number within the brackets of the balance of assets is the number of GAS that can be claimed) At any time, the NEO holder can initiate a claim to redeem these GAS to the corresponding address of the NEO. At the moment, only the PC version of the client has the functionality to extract GAS.
The specific steps are:
- Transfer all the NEO within the wallet using a transfer operation. (It is possible to send the NEO straight to the current address) Once the claim for the GAS is settled, the GAS can be withdrawn. (Refer to the white paper for technical explanation of this process).
Request a certificate
Note that this feature can only generate a certificate application file, the user will still need to go to the relevant digital certificate authority to apply for a certificate.
Request certificate, and fill in the request form according to the instructions given.
The generated file will be as shown in the following figure:
There are two types of assets, Token and Share. Using Token as an example, fill in the following:
It should be noted that the registration of assets incurs a significant fee. (The main network fee is 10000 GAS, test network fee is 100 NEO coins) Please exercise caution.
It should be noted that the distribution of assets incurs a significant fee. (The main network fee is 500 NEO coins, test network fee is 5 NEO coins) Please exercise caution, and choose one-time distribution if possible.
This function is used to register as a NEO blockchain validator candidate.
It should be noted that the election incurs a significant fee. (The main network fee is 1000 GAS, test network fee is 10 GAS) Please exercise caution. The validator function is not available yet, please wait for further updates.