, , , ,

WorldLand Private Network Programming

Seungmin Kim Avatar
Seungmin Kim

·

Overview

Private Network Setup and Environment Configuration Guide for Learning the WorldLand Client

WorldLand

ECCPoW Proof-of-Work Blockchain Network Based on Ethereum Virtual Machine (EVM)

https://worldland.foundation

https://github.com/cryptoecc/WorldLand

WorldLand Client

  • A program for individual users or computers to participate in the blockchain network.
  • When the client is executed, it joins the network as a WorldLand node.

1. Install dependencies and clone

The setup process varies depending on the operating system.

  • Linux 

Copied!

sudo apt update sudo apt upgrade sudo apt install gcc sudo apt install make sudo apt install snapd sudo snap install go --classic git clone https://github.com/smin-k/WorldLand_BCAI
  • Mac

Copied!

sudo brew update 
sudo brew upgrade sudo brew install gcc sudo brew install make sudo brew install snap sudo brew install go git clone <https://github.com/smin-k/WorldLand_BCAI>
  • Window (installation process is complex)

1. Install Chocolatey

The Chocolatey package manager simplifies installing the required build tools.

Open PowerShell as administrator. 


Copied!

PS C:\\WINDOWS\\system32>

In PowerShell, check that Get-ExecutionPolicy isn’t Restricted.

PS C:\\WINDOWS\\system32> Get-ExecutionPolicy

If restricted, change it to AllSigned or Bypass:

PS C:\\WINDOWS\\system32> Set-ExecutionPolicy AllSigned

or

PS C:\\WINDOWS\\system32> Set-ExecutionPolicy Bypass -Scope Process

Then run: Copy 


Copied!

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('<https://community.chocolatey.org/install.ps1>'))

Once the command completes without errors, Chocolatey is ready to use.

2. Installation

Run these commands in an administrator command prompt to install the build tools:

These commands will set up your path environment variable. 


Copied!

C:\\Windows\\system32> choco install git C:\\Windows\\system32> choco install golang C:\\Windows\\system32> choco install mingw

Launch a new command prompt to use the updated path. To install WorldLand, create a Go workspace directory and build the source code: 


Copied!

C:\\Users\\xxx> git clone https://github.com/smin-k/WorldLand_BCAI 
C:\\Users\\xxx> cd WorldLand/ C:\\Users\\xxx\\src\\github.com\\cryptoecc\\WorldLand> go get -u -v golang.org/x/net/context C:\\Users\\xxx\\src\\github.com\\cryptoecc\\WorldLand> go install -v ./cmd/...

If you encounter a fatal: detected dubious ownership in repository at error, run this command: git config --global --add safe.directory "USER_DATA_DIR"

If the build fails, try: 


Copied!

C:\\Users\\xxx\\src\\github.com\\cryptoecc\\WorldLand> go mod tidy

Installation complete!

The WorldLand blockchain establishes P2P connections through port 30303 and handles RPC API requests through port 8545.

2. Firewall settings

  • Linux 

Copied!

sudo ufw allow 30303/tcp
sudo ufw allow 30303/udp
sudo ufw allow 8545/tcp
sudo ufw allow 8545/udp
sudo ufw reload
sudo ufw status
  • Windows

Copied!

New-NetFirewallRule -DisplayName "Open 30303 TCP" -Direction Inbound -LocalPort 30303 -Protocol TCP -Action Allow
New-NetFirewallRule -DisplayName "Open 30303 UDP" -Direction Inbound -LocalPort 30303 -Protocol UDP -Action Allow
New-NetFirewallRule -DisplayName "Open 8545 TCP" -Direction Inbound -LocalPort 30303 -Protocol TCP -Action Allow
New-NetFirewallRule -DisplayName "Open 8545 UDP" -Direction Inbound -LocalPort 30303 -Protocol UDP -Action Allow
  • mac

Copied!

sudo nano /etc/pf.conf
pass in proto tcp from any to any port 30303
pass in proto udp from any to any port 30303
pass in proto tcp from any to any port 8545
pass in proto udp from any to any port 8545
sudo pfctl -f /etc/pf.conf
sudo pfctl -e

3. Connect to Router

Since port forwarding is not possible on the GIST internal network, we will build the WorldLand private network within a local router network.

Please connect to the router network below and remember your IP address carefully.

Network Name: BCAI

Password: compress

Private Network Setup

Unlike a public mainnet, a private blockchain network is restricted to authorized users only.

In this course, we will set up a private network that operates exclusively within the class environment.

Genesis Block

A fundamental component for configuring the network protocol

Allows for the initial setup of network parameters

Once created, the protocol of the genesis block cannot be modified

Changing the protocol later may lead to a hard fork

The configuration file is typically stored locally on each client

Genesis Block of the WorldLand Seoul(Mainnet)

Copied!

func DefaultSeoulGenesisBlock() *Genesis {
    balanceStr := "40996800000000000000000000"
    balance, _ := new(big.Int).SetString(balanceStr, 10)
    return &Genesis{
        Config:     params.SeoulChainConfig,
        Nonce:      103,
        Timestamp:  1691449688,
        ExtraData:  []byte("Worldland Seoul"),
        GasLimit:   30000000,
        Difficulty: big.NewInt(1023),
        Alloc: map[common.Address]GenesisAccount{
            common.HexToAddress("0x8C98EAeA19F1B9B36af58e7d7E78e0F1df8138f0"): { Balance: balance },
        },
    }
}

Copied!

SeoulChainConfig = &ChainConfig{
    ChainID:             big.NewInt(103),
    HomesteadBlock:      big.NewInt(0),
    DAOForkBlock:        nil,
    DAOForkSupport:      true,
    EIP150Block:         big.NewInt(0),
    EIP155Block:         big.NewInt(0),
    EIP158Block:         big.NewInt(0),
    ByzantiumBlock:      big.NewInt(0),
    ConstantinopleBlock: big.NewInt(0),
    PetersburgBlock:     big.NewInt(0),
    IstanbulBlock:       big.NewInt(0),
    BerlinBlock:         big.NewInt(0),
    LondonBlock:         big.NewInt(0),
    WorldlandBlock:      big.NewInt(0),
    SeoulBlock:          big.NewInt(0),
    AnnapurnaBlock:      big.NewInt(2_520_000),
    HalvingEndTime:      big.NewInt(25_228_800),
    Eccpow:              new(EccpowConfig),
}

We have pre-written the code to allow easy implementation of a hard fork:

https://github.com/smin-k/WorldLand_BCAI

Genesis Block Modifications

Average Block Time: Determines how frequently new blocks are generated.

Block Reward: The amount of cryptocurrency rewarded to the miner who successfully adds a new block

Chain ID: A unique identifier for the blockchain network.

Prevents replay attacks between different Ethereum-based networks (e.g., public mainnet and private testnet).

BCAIgensis.json

The genesis block of a private network must be created using an external file.

Everyone must use the same genesis block file!!


Copied!

{
    "config": {
        "chainId": 331,
        "homesteadBlock": 0,
        "daoForkBlock": null,
        "daoForkSupport": true,
        "eip150Block": 0,
        "eip155Block": 0,
        "eip158Block": 0,
        "byzantiumBlock": 0,
        "constantinopleBlock": 0,
        "petersburgBlock": 0,
        "istanbulBlock": 0,
        "berlinBlock": 0,
        "londonBlock": 0,
        "worldlandBlock": 0,
        "seoulBlock": 0,
        "annapurnaBlock": 0,
        "bcaiBlock": 0,
        "eccpow": { },
    },
    "difficulty": "1023",
    "gasLimit": "2100000",
    "alloc": {
    }
}
Adding a genesis file.

If you are using Windows, remove ./ from the beginning of the command.


Copied!

./WorldLand_BCAI/build/bin/worldland --datadir BCAInetwork init BCAIgensis.json
Start Worldland Node

Copied!

./WorldLand_BCAI/build/bin/worldland --networkid 331 --datadir BCAInetwork --port 30303 --http --http.addr "ip adrress" --http.api "eth,net,web3"
console

Peer

In public blockchain networks, peers are typically discovered using a peer discovery algorithm. However, in private networks, the small network size makes automatic peer discovery difficult, so peers must be added manually.

You can add peers using their enode addresses.

To do so, you first need to find your own enode address.


Copied!

admin.nodeinfo.enode

Please upload your enode address using the link below.

https://docs.google.com/spreadsheets/d/1JHNnxN6r3qAk5wq-b9e_KKAMsO_Cr2yW_lDc8FIn5TA/edit?usp=sharing

add peer command


Copied!

admin.addPeer("")
admin.peers

If a peer running the WorldLand client appears in the peer list, the connection was successful!

Account Creation and Block Mining

Account Creation

Copied!

personal.newAccount(YOUR_PASSWORD)

result


Copied!

INFO [08-06|21:33:36.241] Your new key was generated               address=0xb8C941069cC2B71B1a00dB15E6E00A200d387039
WARN [08-06|21:33:36.241] Please backup your key file!             path=/home/hskim/Documents/geth-test/keystore/UTC--2019-08-06T12-33-34.442823142Z--b8c941069cc2b71b1a00db15e6e00a200d387039
WARN [08-06|21:33:36.241] Please remember your password!
"0xb8c941069cc2b71b1a00db15e6e00a200d387039"

Note: Be sure to remember your password!

Check account list: eth.accounts


Copied!

eth.accounts
["0xb8c941069cc2b71b1a00db15e6e00a200d387039"]
Mining

Check Account Balance

To check the WLC balance of your account before mining, use the command:
eth.getBalance("YOUR_ADDRESS")


Copied!

eth.getBalance("0xb8c941069cc2b71b1a00db15e6e00a200d387039")
0

or


Copied!

eth.getBalance(eth.accounts[0])
0

Three Commands for Setting Miner Address and Starting Mining:

miner.setEtherbase(address)
Set the miner address and specify the account to receive rewards.

miner.start(number of threads)
Start mining (you can specify the number of threads).
More threads can be used depending on the number of CPU cores.

miner.stop()
Stop mining.

You must choose which account to use for mining.


Copied!

miner.setEtherbase("0xb8c941069cc2b71b1a00db15e6e00a200d387039")
true

start mining


Copied!

miner.start()
null
INFO [08-06|21:42:38.198] Updated mining threads                   threads=1
INFO [08-06|21:42:38.198] Transaction pool price threshold updated price=1000000000
null
INFO [08-06|21:42:38.198] Commit new mining work                   number=1 sealhash=4bb421…3f463a uncles=0 txs=0 gas=0 fees=0 elapsed=325.066µs
INFO [08-06|21:42:40.752] Successfully sealed new block            number=1 sealhash=4bb421…3f463a hash=4b2b78…4808f6 elapsed=2.554s
INFO [08-06|21:42:40.752] 🔨 mined potential block                  number=1 hash=4b2b78…4808f6

...

INFO [08-06|21:42:56.174] 🔨 mined potential block                  number=9 hash=2faebb…8be693
INFO [08-06|21:42:56.174] Commit new mining work                   number=10 sealhash=384aa6…cb0596 uncles=0 txs=0 gas=0 fees=0 elapsed=179.463µs

Stop mining


Copied!

miner.stop()
null

Check mined WLC:


Copied!

eth.getBalance("0xb8c941069cc2b71b1a00db15e6e00a200d387039")
45000000000000000000

Displayed in wei units (1 WLC = 10¹⁸ wei, similar to satoshi in Bitcoin)

To check the balance in WLC units, use the following command:


Copied!

> web3.fromWei(eth.getBalance("0xb8c941069cc2b71b1a00db15e6e00a200d387039"), "wlc")
45

Connect Wallet

1. Install Metamask

Go to the Chrome Web Store, search for the MetaMask extension, and add it.

After installation, click the puzzle-shaped expansion icon on the top right corner to find MetaMask.

2. Run Metamask

Click the Create Wallet button and enter your password.

A 12-word phrase appears. Only this phrase can recover your wallet, so be careful not to expose it.

Write down your Secret Recovery Phrase

Write down this 12-word Secret Recovery Phrase and save it in a place that you trust and only you can access.

When the wallet creation is complete, you can see the wallet screen as shown below.

3. Connect Worldland to Metamask

먼저 우리는 월드랜드 네트워크를 메타마스크에 연결해야합니다.

월드랜드 서울 네트워크는 월드랜드 홈페이지의 walletconect 버튼을 통해 쉽게 연결할 수있습니다.

그러나 우리는 프리베이트 네트워크를 연결해야합니다. 우리는 개인의 노드 클라이언트와 지갑 주소를 연결합니다.


Click the Network selection box.


Click the Add Network button.

Fill in the blanks using the Network table above.

Enter the following information:

Currency Symbol: WLC

Network Name: WorldLand Private

RPC URL: http://127.0.0.1:8545

Chain ID: 331

WorldLand account to metamask

We have connected the WorldLand client to MetaMask, but the wallet address used for mining is not automatically added.
Let’s walk through the steps to manually import the mined account into MetaMask.

Locating Your Key File:

  • The private key file for your account is stored in the YOUR_DATADIR/keystore folder.
  • If no custom path is set, the default location is ~/.ethereum.
  • On Windows, the file is typically located at:
    C:\Users\[Your Username]\AppData\Local\Ethereum\[seoul or gwangju]\keystore

Importing the Account into MetaMask:

  1. Open MetaMask and switch the network to “WorldLand Private”.
  2. Select “Import Account” from the menu.
  3. Under Select Type, choose JSON File, then upload your keystore file.
  4. Enter the password you used when creating the account.

⚠️ Note: This process may take up to 5 minutes depending on your system.

Once completed, your mined account will be successfully imported into MetaMask and ready for use! ✅

Metamask account to WorldLand

반대로 우리는 메타마스크 지갑 또한 월드랜드에 추가할 수 있습니다.

You can find Account details in the menu to the right of your Metamask account.

Press the export private key button and enter the password to obtain the private key.

Enter the obtained private key and password into the WorldLand console.


Copied!

web3.personal.importRawKey("PRIVATE_KEY", "METAMASK_PASSWORD")

Copy


Copied!

> eth.accounts
["0xb8c941069cc2b71b1a00db15e6e00a200d387039"]

then can you check account 🙂