setup

Create or import a wallet for trading. Required before using buy, sell, send, or balance.

zora setup [options]

Options

Flag	Description
`--create`	Create a new wallet without prompting
`--force`	Overwrite existing wallet without prompting
`--yes`	Skip interactive prompt
`--json`	Machine-readable JSON output

npx @zoralabs/cli setup

 Zora Wallet Setup
 
 ? What would you like to do?
   ❯ Create a new wallet
     Import an existing private key

npx @zoralabs/cli setup --create

 Wallet created
 
 Address  0xb4a06BdD9e0E60FFE22E4E7590842bfD2069034E
 Saved    ~/.config/zora/wallet.json

npx @zoralabs/cli setup --create --json

{
  "address": "0xb4a06BdD9e0E60FFE22E4E7590842bfD2069034E",
  "source": "~/.config/zora/wallet.json"
}

npx @zoralabs/cli setup --create --force

The private key is saved to ~/.config/zora/wallet.json with 0600 permissions (owner-only read/write).

Instead of using setup, set the ZORA_PRIVATE_KEY environment variable:

export ZORA_PRIVATE_KEY=0x...

This takes precedence over the wallet file and is useful for CI/CD, containers, and agent runtimes.