This CLI tool simplifies the process of developing applications and interacting with zkSync Era.
- Node.js v18.x / NPM
- Yarn
You can install this program globally with npm i -g zksync-cli
or run the commands direcly via NPX with npx zksync-cli@latest {COMMAND}
.
-
zksync-cli help
: Provides detailed information about each command. -
zksync-cli create {PROJECT_NAME}
: creates a new project in the given project name. If not provided, creates the project in the current folder, although this requires the folder to be empty. -
zksync-cli deposit
: deposits funds from L1 to L2 (local, testnet or mainnet). It will ask to enter: network, recipient wallet, amount in ETH (eg 0.1) and the private key of the wallet you're sending the funds from. -
zksync-cli withdraw
: withdraws funds from zkSync 2.0 to L1 (Goerli testnet). It will ask to enter: network, recipient wallet, amount in ETH (eg 0.1) and the private key of the wallet you're sending the funds from. -
zksync-cli confirm-withdraw
: confirms withdrawal of funds from zkSync 2.0 to L1 (Goerli testnet). It will ask to enter: network, withdrawal transaction address and the private key of the wallet you sent the funds from. -
zksync-cli <command> --help
: Provides detailed information about how to use a specific command. Replace with the name of the command you want help with (e.g., create, deposit, withdraw, confirm-withdraw). -
zksync-cli --version
: Returns the current version.
--zeek
: zeek, the dev cat, will search for an inspirational quote and provide to you at the end of any command.--l1-rpc-url
: override the default L1 rpc URL whenlocalnet
is selected as the network. Usage--l1-rpc-url=http://...
.--l2-rpc-url
: override the default L2 rpc URL whenlocalnet
is selected as the network. Usage--l1-rpc-url=http://...
.
- Install all dendencies with
npm i
. - This project was build with Typescript. Run
npm run build
to compile code in/src
into/bin
.
To create a version run:
git tag v0.1.3 // with the correspondent tag
git push --tags
β οΈ This project does not have unit tests yet π€
Proper tests will be included soon. For now, you can test new changes locally by installing this package globably with npm i -g
.
zkSync-cli tracks its usage for the single purpose of providing data so it can be improved. Data is fully anonymized. If you want to disable the tracking, set the environment variable NO_TRACKING to true
.