Initialize Configuration
Flow CLI uses a state to operate which is called configuration (usually flow.json
file).
Before using commands that require this configuration we must initialize the project by
using the init command. Read more about state configuration here.
_10flow init
Example Usage
_10> flow init_10_10Configuration initialized_10Service account: 0xf8d6e0586b0a20c7_10_10Start emulator by running: 'flow emulator' _10Reset configuration using: 'flow init --reset'
Error Handling
Existing configuration will cause the error below.
You should initialize in an empty folder or reset configuration using --reset
flag
or by removing the configuration file first.
_10❌ Command Error: configuration already exists at: flow.json, if you want to reset configuration use the reset flag
Global Configuration
Flow supports global configuration which is a flow.json
file saved in your home
directory and loaded as the first configuration file wherever you execute the CLI command.
Please be aware that global configuration has the lowest priority and is overwritten
by any other configuration file if they exist (if flow.json
exist in your current
directory it will overwrite properties in global configuration, but only those which overlap).
You can generate a global configuration using --global
flag.
Command example: flow init --global
.
Global flow configuration is saved as:
- MacOs:
~/flow.json
- Linux:
~/flow.json
- Windows:
C:\Users\$USER\flow.json
Flags
Reset
- Flag:
--reset
Using this flag will reset the existing configuration and create a new one.
Global
- Flag:
--global
Using this flag will create a global Flow configuration.
Service Private Key
- Flag:
--service-private-key
- Valid inputs: a hex-encoded private key in raw form.
Private key used on the default service account.
Service Key Signature Algorithm
- Flag:
--service-sig-algo
- Valid inputs:
"ECDSA_P256", "ECDSA_secp256k1"
- Default:
"ECDSA_P256"
Specify the ECDSA signature algorithm for the provided public key.
Flow supports the secp256k1 and P-256 curves.
Service Key Hash Algorithm
- Flag:
--service-hash-algo
- Valid inputs:
"SHA2_256", "SHA3_256"
- Default:
"SHA3_256"
Specify the hashing algorithm that will be paired with the public key upon account creation.
Log
- Flag:
--log
- Short Flag:
-l
- Valid inputs:
none
,error
,debug
- Default:
info
Specify the log level. Control how much output you want to see while command execution.