Skip to main content

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.

$ ulimit -n 10000

To start Conflux manually, you need to edit the default configuration file run/hydra.toml:

  • Set public_address according to your public IP. The port should be 32323 by default.
  • Set mining_author to 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:

$ cd run
$ ../target/release/conflux --config hydra.toml

It will start an archive node and begin syncing the Conflux mainnet blockchain.

Note that two new directories (blockchain_db and 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 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 jsonrpc_http_port or jsonrpc_ws_port. 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.

Running Test#

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

  • Linux:

    $ ./dev-support/

    This will automatically run the unit tests in our Rust code and the python tests.

  • Others:

    To run unit tests in Rust:

    $ cargo test --release --all

    To run python integration tests:

    $ ./tests/

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.