how to create an account
Overview
This how-to guide provides instructions on how to create a new Antelope blockchain account using the cleos
CLI tool. You can use accounts to deploy smart contracts and perform other related blockchain operations. Create one or multiple accounts as part of your development environment setup.
The example in this how-to guide creates a new account named bob, authorized by the default system account eosio, using the cleos
CLI tool.
Before you Begin
Make sure you meet the following requirements:
- Install the currently supported version of
cleos
. [[info | Note]] | The cleos tool is bundled with the Antelope software. Installing Antelope will also install the cleos tool. - Learn about Antelope Accounts and Permissions
- Learn about Asymmetric Cryptography - public key and private key pairs.
- Create public/private keypairs for the
owner
andactive
permissions of an account.
Command Reference
See the following reference guide for cleos
command line usage and related options:
cleos create account
command and its parameters
Procedure
The following step shows how to create a new account bob authorized by the default system account eosio.
- Run the following command to create the new account bob:
cleos create account eosio bob EOS87TQktA5RVse2EguhztfQVEh6XXxBmgkU8b4Y5YnGvtYAoLGNN
Where:
eosio
= the system account that authorizes the creation of a new accountbob
= the name of the new account conforming to account naming conventionsEOS87TQ...AoLGNN
= the owner public key or permission level for the new account (required) [[info | Note]] | To create a new account in the Antelope 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 Antelope blockchain, the default system account used to create a new account is eosio.
Example Output
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 ]
Summary
By following these instructions, you are able to create a new Antelope account in your blockchain environment.