Installation

Running a Change Chain Node from Source

Before you begin, ensure your system meets the following software requirements:

Operating System: Ubuntu 18.04 or later (Linux), macOS, or Windows Subsystem for Linux (WSL)
Go Programming Language: Version 1.16 or later
Git: Latest version
gcc (GNU Compiler Collection): For compiling source code

1. Install Go

Linux/macOS

Download and install Go:

# For Linux
wget https://golang.org/dl/go1.17.2.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.17.2.linux-amd64.tar.gz

# For macOS
brew install go

Add Go to your PATH:

bashCopy codeecho "export PATH=$PATH:/usr/local/go/bin" >> ~/.bashrc
source ~/.bashrc

Verify the installation:

bashCopy codego version

Windows

2. Install Git

Linux

bashCopy codesudo apt-get update
sudo apt-get install git

macOS

bashCopy codebrew install git

Windows

3. Install gcc

Linux

bashCopy codesudo apt-get install build-essential

macOS

bashCopy codexcode-select --install

Build and Start the Change Chain Node

1. Set the `GOPATH`

Set your Go workspace directory:

bashCopy codeexport GOPATH=$HOME/go
echo "export GOPATH=$HOME/go" >> ~/.bashrc
source ~/.bashrc

2. Create a Directory in Your `GOPATH`

Create the necessary directories:

bashCopy codemkdir -p $GOPATH/src/github.com/changechain

3. Clone the Change Chain Repository

Navigate to the directory and clone the repository:

bashCopy codecd $GOPATH/src/github.com/changechain
git clone https://github.com/changechain/changechain.git

4. Run the Build Script

Navigate to the cloned repository and run the build script:

bashCopy codecd $GOPATH/src/github.com/changechain/changechain
./scripts/build.sh

This script compiles the Change Chain node and places the executable in the build directory.

5. Start the Node

On Change Chain Mainnet

bashCopy codecd $GOPATH/src/github.com/changechain/changechain
./build/changechain

On Testnet

bashCopy codecd $GOPATH/src/github.com/changechain/changechain
./build/changechain --network-id=testnet

Note: To stop the node, press Ctrl + C.

Run with a Pre-Built Binary

If you prefer to use a pre-built binary instead of building from source, follow these steps:

1. Download

MacOS

Download: changechain-macos-<VERSION>.zip
Unzip:
```
bashCopy codeunzip changechain-macos-<VERSION>.zip
```
The resulting folder changechain-<VERSION> contains the binaries.

Linux (x86_64 PCs or Cloud Providers)

Download: changechain-linux-amd64-<VERSION>.tar.gz
Unzip:
```
bashCopy codetar -xvf changechain-linux-amd64-<VERSION>.tar.gz
```
The resulting folder changechain-<VERSION>-linux contains the binaries.

2. Start the Node

MacOS

Mainnet:

bashCopy code./changechain-<VERSION>/build/changechain

Testnet:

bashCopy code./changechain-<VERSION>/build/changechain --network-id=testnet

Linux

Mainnet:

bashCopy code./changechain-<VERSION>-linux/changechain

Testnet:

bashCopy code./changechain-<VERSION>-linux/changechain --network-id=testnet

Networking

To successfully run the Change Chain node and participate in the network, ensure that your node can accept connections on network port 9651.

Running on a Cloud Provider

If you're running your node on a cloud service like AWS, Azure, or Google Cloud:

Configure your cloud instance's firewall settings to allow inbound and outbound traffic on port 9651.
Ensure your security groups and network access control lists (ACLs) permit traffic on this port.

Running on a Home Connection

If you're running your node from home:

Set up port forwarding on your router to forward external traffic on port 9651 to your machine's local IP address.
Check your computer's firewall settings to allow traffic on port 9651.

Note: To make API calls to your node from other machines, include the argument --http-host=0.0.0.0 when starting the node:

bashCopy code./build/changechain --http-host=0.0.0.0

Bootstrapping

When starting your node for the first time, it needs to catch up with the latest network state, a process known as bootstrapping. This may take several hours depending on your internet connection and hardware performance.

Check Bootstrapping Progress

You can check if your node has finished bootstrapping a particular chain by using the info.isBootstrapped API method.

Example Command

bashCopy codecurl -X POST --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "info.isBootstrapped",
    "params": {
        "chain": "C"
    }
}' -H 'content-type:application/json;' 127.0.0.1:9651/ext/info

Replace "chain": "C" with "X" or "P" to check the status of the other chains.

Interpreting the Response

If the response returns true, the chain has finished bootstrapping.
If the response returns false, the chain is still bootstrapping.

RPC Endpoints

Once your node has bootstrapped, the following RPC endpoints become available:

Change Chain: http://localhost:9651/ext/bc/C

If accessing remotely, replace localhost with your node's public IP address.

For detailed API documentation, refer to the Change Chain API Reference.

PreviousSystem Requirements NextTroubleshooting

Last updated 7 months ago

Installation

Running a Change Chain Node from Source

Before you begin, ensure your system meets the following software requirements:

Operating System: Ubuntu 18.04 or later (Linux), macOS, or Windows Subsystem for Linux (WSL)
Go Programming Language: Version 1.16 or later
Git: Latest version
gcc (GNU Compiler Collection): For compiling source code

1. Install Go

Linux/macOS

Download and install Go:

# For Linux
wget https://golang.org/dl/go1.17.2.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.17.2.linux-amd64.tar.gz

# For macOS
brew install go

Add Go to your PATH:

bashCopy codeecho "export PATH=$PATH:/usr/local/go/bin" >> ~/.bashrc
source ~/.bashrc

Verify the installation:

bashCopy codego version

Windows

Download the Windows installer from the and follow the installation instructions.

2. Install Git

Linux

bashCopy codesudo apt-get update
sudo apt-get install git

macOS

bashCopy codebrew install git

Windows

Download and install Git from the .

3. Install gcc

Linux

bashCopy codesudo apt-get install build-essential

macOS

bashCopy codexcode-select --install

Build and Start the Change Chain Node

1. Set the `GOPATH`

Set your Go workspace directory:

bashCopy codeexport GOPATH=$HOME/go
echo "export GOPATH=$HOME/go" >> ~/.bashrc
source ~/.bashrc

2. Create a Directory in Your `GOPATH`

Create the necessary directories:

bashCopy codemkdir -p $GOPATH/src/github.com/changechain

3. Clone the Change Chain Repository

Navigate to the directory and clone the repository:

bashCopy codecd $GOPATH/src/github.com/changechain
git clone https://github.com/changechain/changechain.git

4. Run the Build Script

Navigate to the cloned repository and run the build script:

bashCopy codecd $GOPATH/src/github.com/changechain/changechain
./scripts/build.sh

This script compiles the Change Chain node and places the executable in the build directory.

5. Start the Node

On Change Chain Mainnet

bashCopy codecd $GOPATH/src/github.com/changechain/changechain
./build/changechain

On Testnet

bashCopy codecd $GOPATH/src/github.com/changechain/changechain
./build/changechain --network-id=testnet

Note: To stop the node, press Ctrl + C.

Run with a Pre-Built Binary

If you prefer to use a pre-built binary instead of building from source, follow these steps:

1. Download

Visit the and download the appropriate version for your operating system.

MacOS

Download: changechain-macos-<VERSION>.zip
Unzip:
```
bashCopy codeunzip changechain-macos-<VERSION>.zip
```
The resulting folder changechain-<VERSION> contains the binaries.

Linux (x86_64 PCs or Cloud Providers)

Download: changechain-linux-amd64-<VERSION>.tar.gz
Unzip:
```
bashCopy codetar -xvf changechain-linux-amd64-<VERSION>.tar.gz
```
The resulting folder changechain-<VERSION>-linux contains the binaries.

2. Start the Node

MacOS

Mainnet:

bashCopy code./changechain-<VERSION>/build/changechain

Testnet:

bashCopy code./changechain-<VERSION>/build/changechain --network-id=testnet

Linux

Mainnet:

bashCopy code./changechain-<VERSION>-linux/changechain

Testnet:

bashCopy code./changechain-<VERSION>-linux/changechain --network-id=testnet

Networking

To successfully run the Change Chain node and participate in the network, ensure that your node can accept connections on network port 9651.

Running on a Cloud Provider

If you're running your node on a cloud service like AWS, Azure, or Google Cloud:

Configure your cloud instance's firewall settings to allow inbound and outbound traffic on port 9651.
Ensure your security groups and network access control lists (ACLs) permit traffic on this port.

Running on a Home Connection

If you're running your node from home:

Set up port forwarding on your router to forward external traffic on port 9651 to your machine's local IP address.
Check your computer's firewall settings to allow traffic on port 9651.

Note: To make API calls to your node from other machines, include the argument --http-host=0.0.0.0 when starting the node:

bashCopy code./build/changechain --http-host=0.0.0.0

Bootstrapping

Check Bootstrapping Progress

You can check if your node has finished bootstrapping a particular chain by using the info.isBootstrapped API method.

Example Command

bashCopy codecurl -X POST --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "info.isBootstrapped",
    "params": {
        "chain": "C"
    }
}' -H 'content-type:application/json;' 127.0.0.1:9651/ext/info

Replace "chain": "C" with "X" or "P" to check the status of the other chains.

Interpreting the Response

If the response returns true, the chain has finished bootstrapping.
If the response returns false, the chain is still bootstrapping.

RPC Endpoints

Once your node has bootstrapped, the following RPC endpoints become available:

Change Chain: http://localhost:9651/ext/bc/C

If accessing remotely, replace localhost with your node's public IP address.

For detailed API documentation, refer to the Change Chain API Reference.

PreviousSystem Requirements NextTroubleshooting

Last updated 7 months ago

Running a Change Chain Node from Source

1. Install Go

2. Install Git

3. Install gcc

Build and Start the Change Chain Node

1. Set the GOPATH

2. Create a Directory in Your GOPATH

3. Clone the Change Chain Repository

4. Run the Build Script

5. Start the Node

Run with a Pre-Built Binary

1. Download

2. Start the Node

Networking

Running on a Cloud Provider

Running on a Home Connection

Bootstrapping

Check Bootstrapping Progress

RPC Endpoints

Running a Change Chain Node from Source

1. Install Go

2. Install Git

3. Install gcc

Build and Start the Change Chain Node

1. Set the GOPATH

2. Create a Directory in Your GOPATH

3. Clone the Change Chain Repository

4. Run the Build Script

5. Start the Node

Run with a Pre-Built Binary

1. Download

2. Start the Node

Networking

Running on a Cloud Provider

Running on a Home Connection

Bootstrapping

Check Bootstrapping Progress

RPC Endpoints

1. Set the `GOPATH`

2. Create a Directory in Your `GOPATH`

1. Set the `GOPATH`

2. Create a Directory in Your `GOPATH`