Run a Node
Here we walk through how to quickly setup conflux full node to join the conflux network and how to use Conflux wallet to manage your account, transfer Conflux token, and deploy smart contract.
#Running a Conflux Node
First, please Get a Conflux Client or Compile from Source.
On Linux and Mac systems, before running a node, make sure that you increase the number of open file descriptors allowed for each process.
To start Conflux manually, you need to edit the default configuration file
public_addressaccording to your public IP. The port should be 32323 by default.
mining_authorto the account address to receive mining reward.
- Conflux team has maintained some full nodes for the test net, and they have been provided as
bootnodes. If you want to use other nodes to bootstrap your new node, you should edit this entry.
Note that the default max open file limit on Linux/Mac may not be enough for a Conflux node, and it's suggested to set the value to 10000. You can set this by running
ulimit -n 10000 on the command line window before continuing.
Then you can run the following commands:
It will start an archive node and begin syncing the Conflux mainnet blockchain.
Note that two new directories (
net_config) will be created in the current working directory (
run ) to keep the persistent data. Please do not remove them unless data are corrupt or you want to start a fresh new node.
To restart a node, just run the same command line in the same directory.
#Configuring Conflux Full Node
Conflux can be configured using either the CLI options or a config file. Should the CLI flags and the config file disagree about a setting, the CLI takes precedence.
The config file follows the format of TOML. The path of the configuration file can be set with the CLI option
--config path/to/conflux.toml. A default configuration file
hydra.toml with every configuration explained has been provided in the directory
run, and you can start customizing your configuration from there.
You can list all CLI options by running
$ ./conflux --help. The vast majority of CLI options map to a setting in the TOML file, for example
--public-address 127.0.0.1:32323 can be set by creating a config file:
If you are going to set up a node and let it join the Conflux mainnet(testnet), you need to set the
public_address appropriately. It should be set as the IP address of your node which can be accessed publicly from Internet. If your node is covered under a public gateway, you can get its public address by searching "ip" in Google.
If you want to let your node participate the mining process, you need to enable it by setting
start_mining as "true" and
mining_author as the account address that receives the mining reward.
If you want to open the http or websocket RPC, you need to enable it by setting
Note that to serve transaction-related RPCs,
persist_tx_index should also be set to
true or the node will only be able to handle very recent transactions.
We have both unit tests written in Rust and integration tests written in python. After you make some modifications to the code, you can run these tests to see if the system still runs correctly.
First, you need to install the dependencies as instructed in Install Test Dependencies.
Then you can run the tests as follows
This will automatically run the unit tests in our Rust code and the python tests.
To run unit tests in Rust:$ cargo test --release --all
To run python integration tests:$ ./tests/test_all.py
#Creating a wallet
You can use Fluent Wallet to create a wallet. It will provide you a seed phrase (used to restore your wallet if you close it) and a password (used to unlock your wallet if you lock it when you leave your computer). Once a wallet is created, you can then manage your account addresses, send transactions, and deploy smart contract.
In order to issue on-chain operations, you will need Conflux tokens. On the testnet, you can periodically (100 CFX token per hour) get CFX tokens from the faucet Dapp.
For developing smart contracts, you can use Conflux Studio to write, compile, and deploy your contract.