How To Create An Account

Goal

Create a new EOSIO blockchain account

Before you begin

  • Install the currently supported version of cleos
Note

The cleos tool is bundled with the EOSIO software. Installing EOSIO will also install the cleos tool.

  • Acquire functional understanding of the following:

  • Created an Owner and an Active key pair
  • Import a private key to the wallet which can authorize on behalf of a creator account

Steps

Command

cleos create account [creator account name] [new account name][OwnerKey] [ActiveKey]

Where:

[creator account name] = name of the existing account that authorizes the creation of a new account

[new account name] = The name of the new account account adhering to EOSIO account naming conventions

[OwnerKey] = The owner permissions linked to the ownership of the account

[ActiveKey] = The active permissions linked with the creator account

Recommend

ActiveKey is optional but recommended.

Note

To create a new account in the EOSIO blockchain, an existing account, also referred to as a creator account, is required to authorize the creation of a new account. For a newly created EOSIO blockchain, the default system account used to create a new account is eosio.

Example Output

cleos create account eosio bob EOS87TQktA5RVse2EguhztfQVEh6XXxBmgkU8b4Y5YnGvtYAoLGNN
executed transaction: 4d65a274de9f809f9926b74c3c54aadc0947020bcfb6dd96043d1bcd9c46604c  200 bytes  166 us
#         eosio <= eosio::newaccount            {"creator":"eosio","name":"bob","owner":{"threshold":1,"keys":[{"key":"EOS87TQktA5RVse2EguhztfQVEh6X...
warning: transaction executed locally, but may not be confirmed by the network yet         ]