Account Management

WARNING

Account security is very important in blockchain networks. You should make sure that your account's private key and password are inaccessible to anyone but yourself. If someone else obtains your account's private key and password, they can control all assets associated with your account.

Keep your account safe and backed up!

WorldLand's node client has an internal account management tool. However, for better security, an off-client account management tool is desirable.

Clef is an external account management tool supported by WorldLand. It can be run separately from the client and operates on independent hardware. Clef requires manual review of account-related actions by the owner, and is more secure than traditional account management because signing is done inside Clef.

Clef

Clef Init

Clef must be initialized before creating an account. Determine the path for Clef and pass the repository path to the clef init command:

./clef init /CLEF_DIR/clefdata

DANGER

Please remember the master seed generated and keep it safe. The master seed gives you access to all accounts managed by Clef.

Connecting WorldLand and Clef

In order for Clef and WorldLand to communicate, Clef needs to know:

• The Chain ID of the network
• The location of the node's keystore (usually inside the node data directory)

Run the following command to start Clef configured for WorldLand nodes connecting to the Seoul Mainnet (Chain ID: 103):

./clef -chainid 103 -keystore ~/WorldLand_DIR/keystore \
       -configdir /CLEF_DIR/clef --http

TIP

For the Gwangju Testnet, modify the chain ID to 10359.

Clef starts running in the terminal, displaying a disclaimer and prompting to click "OK":

WARNING!

Clef is an account management tool. It may, like any software,
contain bugs. Please take care to:
  - backup your keystore files,
  - verify that the keystore(s) can be opened with your password.

Enter 'ok' to proceed:
>

WorldLand can be started in a separate terminal. To connect to Clef, make sure the data directory matches the path provided to Clef and pass the location of the Clef IPC file (saved to the path provided in the --configdir flag).

New Account

A new key file is added to the keystore for WorldLand. A JSON response is returned with the new account address in the result field.

The newly created key file can be found in /keystore/, a subfolder of the node directory.

List Accounts

In the Clef console, use the following CLI command to list your accounts:

> eth.accounts

You can also list all wallets managed by Clef.

Import Account

Clef supports creating an account using a pre-existing private key. You can bring the address created in a wallet such as MetaMask to Clef:

> web3.personal.importRawKey("PRIVATE_KEY", "PASSWORD")

Account Update

You can update the password for an existing account through Clef's interface.