Skip to main content

Set up a Warden account

Overview​

Before building an application on Warden, it's always required to create and fund a key (account) on a local chain or a testnet. This guide explains how to do it.

To get started with application development, you can set an account on a local chain and then deploy an EVM/WASM contract locally. Alternatively, you can set up an account on Chiado and deploy your contract there.

Some situations may require slightly different or additional steps—for example, you may need to use an existing key instead of a new one or to create a Space. Whenever it happens, refer to useful node commands.

Set up an account on a local chain​

To deploy an EVM contract locally, you need to run a local chain and make sure it's configured properly, as shown in the following steps:

1. Run a local chain​

To learn in detail how to run a local chain, follow this guide: Run a local chain. You can run your chain with custom settings if you configure it manually, but the simplest way is using our just script, as shown below:

To run a local chain with manual settings, follow this guide: Run a local chain: Configure manually

  1. Install Go 1.24 or later.

  2. Install just 1.34.0 or later:

    brew install just

  3. Clone the Warden Protocol repository and navigate to the root directory:

    git clone https://github.com/warden-protocol/wardenprotocol
    cd wardenprotocol

  4. Execute the just script:

    just localnet

    You'll see blocks being produced and height incrementing.

    note

    You can check the settings of your node in the genesis file: $HOME/.warden/config/genesis.json. There you'll find two validator addresses, a Keychain, a Space, and other settings. See accounts, keychains, spaces, etc.

2. Check your key​

  1. Check the list of available keys (local accounts) and note down your key name.

    wardend keys list

    If you used our just script to run the node with default settings, the local account name is shulgin. However, you can create and fund additional keys if needed.

  2. Check the local account balance to make sure it has funds:

    wardend query bank balances shulgin

3. Get your private key​

To deploy an EVM smart contract, you'll also need the private key associated with your account. Run the following command and note down the private key:

wardend keys export shulgin --unarmored-hex --unsafe

Set up an account on Chiado​

1. Connect to Chiado​

To connect to the Chiado testnet, take the following steps:

  1. Install Go 1.24 or later.

  2. Install just 1.34.0 or later:

    brew install just

  3. Clone the Warden Protocol repository and navigate to the root directory:

    git clone --depth 1 --branch v0.6.2 https://github.com/warden-protocol/wardenprotocol
    cd wardenprotocol

  4. Build the binary and initialize the chain's home directory:

    just wardend build
    just wardend install
    wardend init my-chain-moniker

2. Create and fund a key​

Now you need to create a fund a key, as shown below. Alternatively, you can find or restore an existing key. To learn more, see Useful node commands.

  1. To create a new key, run the following command. Specify the key name.

    wardend keys add my-key-name

  2. Write down the mnemonic phrase and public address of the new account. You'll need this information to interact with the chain and restore the account. You may also need the name you specified when creating your key.

    warning

    The seed phrase is the only way to restore your keys. Losing it can result in the irrecoverable loss of WARD tokens.

  3. Fund your key using the Chiado faucet and the public address obtained in the previous step.

  4. Check your balance on Chiado:

    wardend query bank balances my-key-name --node https://rpc.chiado.wardenprotocol.org:443

3. Get your private key​

To deploy an EVM smart contract, you'll also need the private key associated with your account. Run the following command and note down the private key:

wardend keys export my-key-name --unarmored-hex --unsafe

Useful node commands​

This subsection lists some useful node commands typically required to manage your account when deploying a smart contract on Warden.

Note: Chain-specific settings​

Some example node commands vary depending on the chain and initial setup:

Transactions on the Chiado testnet require specifying the following:

  • The chain ID: --chain-id chiado_10010-1
  • The RPC address: --node https://rpc.chiado.wardenprotocol.org:443

If you run a local chain using our script, the chain will have the default settings:

  • The default key name (the genesis account): shulgin
  • The chain ID: warden_1337-1

If you configure a local chain manually, the chain will have custom settings:

  • A custom key name: my-key-name in example commands
  • A a custom chain ID formatted as chain_123-1

Get your chain ID​

In some of the commands, you need to specify your chain ID. The actual value depends on the configuration you used when running your node.

To check your chain ID, run this:

wardend status

See the network field in the output.

tip

If you used our just script to run the node with default settings, the chain ID is warden_1337-1.

Create a key​

To create a new key, run the following command. Specify the key name.

wardend keys add my-key-name

Write down the mnemonic phrase, public address of the new account. You'll need this information to interact with the chain and restore the key. You may also need the name you specified when creating your key.

warning

The seed phrase is the only way to restore your keys. Losing it can result in the irrecoverable loss of WARD tokens.

tip

Keys are created locally, but if you fund your key in a testnet, your account will be automatically registered on the network.

Restore a key​

To restore an existing key, run the command below, specifying the key name. You will be prompted to enter the mnemonic you noted down when creating a key.

wardend keys add my-key-name --recover

Get the key name​

To manage your key, you need to know it's name. If you don't remember the name of an existing key, just run the following command, and it'll list all your keys:

wardend keys list
tip

If you used our just script to run the local node with default settings, the local account name is shulgin. But you can always create additional keys.

Get the private key​

To get the private key associated with your account, run the following command. Specify your key name.

wardend keys export shulgin --unarmored-hex --unsafe

Get the public address​

You can always check your public address by running the following command. Specify your key name.

wardend keys show shulgin --address

Fund a key​

Setting up a local chain involves creating a genesis account with some funds. However, after that you may need to create a new key and transfer assets from the genesis account to the new one. Run the command below, specifying both keys' names:

wardend tx bank send \
  shulgin \
  $(wardend keys show --address my-key-name) \
  1000000000000000000award \
  --chain-id warden_1337-1

To fund your key on Chiado, just use your public address with Chiado faucet.

tip

Keys are created locally, but if you fund your key in a testnet, your account will be automatically registered on the network.

Check the key balance​

After funding your key, you can check your balance by running the following command. Specify your key name.

wardend query bank balances shulgin

Create a Space​

To create a Space, run the following command. Specify your key name and the chain ID:

wardend tx warden new-space \
  --from shulgin \
  --chain-id warden_1337-1
note

A Space is a hub allowing its owner to manage multiple cryptographic keys that identify users and secure the ownership of wallets.

List Spaces​

To get the 5 most recently created Spaces, run the following:

wardend query warden spaces \
  --page-limit 5 \
  --page-reverse

For each Space, this command will return its creator, ID, and owners:

spaces:
- creator: warden1y8jvrg3rmzq4evguakjqqny99au5ys92rnf2l8
  id: "2"
  owners:
  - warden1y8jvrg3rmzq4evguakjqqny99au5ys92rnf2l8
- creator: warden1h7akmejqcrafp3mfpjqamghh89kzmkgjzsy3mc
  id: "1"
  owners:
  - warden1h7akmejqcrafp3mfpjqamghh89kzmkgjzsy3mc

If you've just created a Space and wish to find it, look for one associated with your public address.

Next steps​

After setting up your account on a local chain or a testnet, you can deploy an EVM or WASM contract on Warden: