Skip to main content

account

Command

clio create account <creator> <name> <owner_key> [active_key] [OPTIONS]

Description

Create a new account on the blockchain (assumes system contract does not restrict RAM usage)

Synopsis

clio create account
<creator> # REQUIRED: The name of the account creating the new account
<name> # REQUIRED: The name of the new account
<owner_key> # REQUIRED: The owner public key or permission level for the new account
[active_key] # OPTIONAL: The active public key or permission level for the new account
[-h | --help] # Print this help message and exit
[[-x | --expiration] <seconds>] # set the time in seconds before a transaction expires, defaults to 30s
[-f | --force-unique] # force the transaction to be unique. this will consume extra bandwidth and remove any protections against accidently issuing the same transaction multiple times
[-s | --skip-sign] # Specify if unlocked wallet keys should be used to sign transaction
[-j | --json] # print result as JSON
[--json-file <filename>] # save result in json format into a file
[-d | --dont-broadcast] # don't broadcast transaction to the network (just print to stdout)
[--return-packed] # used in conjunction with --dont-broadcast to get the packed transaction
[[-r | --ref-block] <block>] # set the reference block num or block id used for TAPOS (Transaction as Proof-of-Stake)
[--use-old-rpc] # use old RPC push_transaction, rather than new RPC send_transaction
[[-p | --permission] <account@perm>] # An account and permission level to authorize, as in 'account@permission' (defaults to 'creator@active')
[--max-cpu-usage-ms <ms>] # set an upper limit on the milliseconds of CPU usage budget, for the execution of the transaction (defaults to 0 which means no limit)
[--max-net-usage <bytes>] # set an upper limit on the net usage budget, in bytes, for the transaction (defaults to 0 which means no limit)
[--delay-sec <seconds>] # set the delay_sec seconds, defaults to 0s

Examples

The following examples demonstrate how to use the clio create account command:

Create a new account named nick

info

The example below assumes you have access to a local chain and you have authority over sysio key pair.

The command below assumes there are two key pairs generated for nick.

Key pairs can be generated by using clio create key.

WARNING

Before using the command below, ensure you're switched to the root user (run sudo su -) since the wallet is set up under root.

clio create account sysio nick SYS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV SYS6b23j5Yzn8pC1A4UwRhDpu9t47kcyGMp8af1bKKN6sFVUpCVBW -p sysio@active

Output:

executed transaction: ce26710f7fcb73c290aba82810d0fb61a24097f85fc27ea52c25848c228b4254  200 bytes  271 us

# sysio <= sysio::newaccount {"creator":"sysio","name":"nick","owner":{"threshold":1,"keys":[{"key":"SYS4toFS3YXEQCkuuw1aqDLrtHim

warning: transaction executed locally, but may not be confirmed by the network yet ]