zerion-wallet

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Zerion — Wallet Management

Zerion — 钱包管理

Encrypted local wallets stored in the Open Wallet Standard (OWS) vault at

~/.ows/

, AES-256-GCM. Keys never leave the device.

加密的本地钱包存储在

~/.ows/

路径下的Open Wallet Standard (OWS) 容器中，采用AES-256-GCM加密。密钥永远不会离开设备。

Setup

安装设置

If a

zerion

command fails with

command not found

, install once:

bash

npm install -g zerion-cli

Requires Node.js ≥ 20. For auth see the

zerion

umbrella skill.

如果执行

zerion

命令时提示

command not found

，请执行以下命令进行安装：

bash

npm install -g zerion-cli

需要Node.js ≥ 20版本。认证相关内容请查看

zerion

总览技能。

When to use

使用场景

"Create a new wallet"
"Import my wallet from a private key / mnemonic"
"Show my wallets" / "list deposit addresses"
"Back up my recovery phrase"
"Delete this wallet"
"Sync my wallet to the Zerion mobile app"

For on-chain actions with a wallet →

zerion-trading

. For agent-token setup on a wallet →

zerion-agent-management

"创建新钱包"
"通过私钥/助记词导入我的钱包"
"查看我的钱包" / "列出存款地址"
"备份我的恢复短语"
"删除此钱包"
"将我的钱包同步到Zerion移动应用"

如需使用钱包进行链上操作 →

zerion-trading

。如需在钱包上设置agent-token →

zerion-agent-management

。

Wallets and chains

钱包与链

A mnemonic-derived wallet (created via

wallet create

wallet import --mnemonic

) holds both an EVM and a Solana account, so the same wallet can sign on either chain and act as a destination for cross-chain bridges in either direction.

A wallet imported from a single private key holds only one chain's account:

Import flag	Account type	Can swap on	Can be cross-chain destination for
`--mnemonic`	EVM + Solana	both	both
`--evm-key`	EVM only	EVM chains	EVM chains
`--sol-key`	Solana only	Solana	Solana

wallet list

shows which accounts each wallet has. Use this when picking

--to-wallet

for a cross-chain bridge — the destination wallet must have an account on the target chain.

通过助记词生成的钱包（通过

wallet create

或

wallet import --mnemonic

创建）同时拥有EVM和Solana账户，因此同一个钱包可以在任意一条链上签名，也可以作为跨链桥双向转账的目标地址。

通过单个私钥导入的钱包仅拥有一条链的账户：

导入参数	账户类型	可在哪些链上交易	可作为哪些链的跨链转账目标
`--mnemonic`	EVM + Solana	两者均可	两者均可
`--evm-key`	仅EVM	EVM链	EVM链
`--sol-key`	仅Solana	Solana	Solana

wallet list

命令会显示每个钱包拥有的账户。在跨链桥操作中选择

--to-wallet

时，请使用此命令确认目标钱包在目标链上是否有账户。

Agent vs manual operations

Agent操作 vs 手动操作

Operation	Type	Notes
`wallet list` , `wallet fund`	Agent	Read-only. Safe to invoke autonomously.
`wallet create` , `wallet import` , `wallet backup` , `wallet delete` , `wallet sync`	Manual	Require passphrase or interactive input. Humans must run these directly — agents must not call them.

操作	类型	说明
`wallet list` , `wallet fund`	Agent	只读操作。可安全地自主调用。
`wallet create` , `wallet import` , `wallet backup` , `wallet delete` , `wallet sync`	Manual	需要密码或交互式输入。必须由人工直接运行——Agent不得调用这些命令。

Read-only — agents may invoke freely

只读操作 — Agent可自由调用

bash

zerion wallet list                        # All wallets, addresses, active policies
zerion wallet list --search <query>       # Filter by name or address
zerion wallet list --limit <n> --offset <n>   # Paginate
zerion wallet fund --wallet <name>        # Show EVM + Solana deposit addresses

bash

zerion wallet list                        # 查看所有钱包、地址及生效策略
zerion wallet list --search <query>       # 按名称或地址筛选
zerion wallet list --limit <n> --offset <n>   # 分页显示
zerion wallet fund --wallet <name>        # 显示EVM和Solana存款地址

Manual — humans only

手动操作 — 仅人工可执行

These prompt for a passphrase, secret key, or confirmation. Do not invoke from an agent loop.

bash

undefined

这些操作会提示输入密码、密钥或确认信息。请勿在Agent循环中调用。

bash

undefined

Create a fresh encrypted wallet (EVM + Solana, generated locally)

创建一个全新的加密钱包（EVM + Solana，本地生成）

zerion wallet create --name <name>

Import from existing keys (interactive secret prompts — never expose keys in shell history)

从已有密钥导入（交互式密钥提示——切勿在shell历史中暴露密钥）

zerion wallet import --name <name> --evm-key zerion wallet import --name <name> --sol-key zerion wallet import --name <name> --mnemonic

Export the recovery phrase (passphrase required)

导出恢复短语（需要密码）

zerion wallet backup --wallet <name>

Permanently delete (passphrase + confirmation)

永久删除（需要密码+确认）

zerion wallet delete <name>

Sync to the Zerion mobile app via a one-time QR code

通过一次性二维码同步到Zerion移动应用

zerion wallet sync --wallet <name> zerion wallet sync --all

undefined

zerion wallet sync --wallet <name> zerion wallet sync --all

undefined

Setting defaults

设置默认钱包

Wallet-related config is set with

zerion config

bash

zerion config set defaultWallet <name>    # Used when --wallet is omitted
zerion config get defaultWallet
zerion config unset defaultWallet         # Resets to "no default"
zerion config list                        # Show all config (sensitive values redacted)

~/.zerion/config.json

is created with mode 0o600.

钱包相关配置通过

zerion config

命令设置：

bash

zerion config set defaultWallet <name>    # 当省略--wallet参数时使用此默认钱包
zerion config get defaultWallet
zerion config unset defaultWallet         # 重置为无默认钱包
zerion config list                        # 显示所有配置（敏感值已脱敏）

~/.zerion/config.json

文件创建时的权限为0o600。

Typical setup flow (human runs these in order)

典型设置流程（人工按顺序执行）

bash

undefined

bash

undefined

1. Create wallet (passphrase prompt; offers agent-token setup at the end)

1. 创建钱包（提示输入密码；最后会提供agent-token设置选项）

zerion wallet create --name agent-bot

2. Fund it

2. 为钱包充值

zerion wallet fund --wallet agent-bot

→ prints EVM and Solana deposit addresses

→ 打印EVM和Solana存款地址

3. Set as default so future commands omit --wallet

3. 设置为默认钱包，以便后续命令可省略--wallet参数

zerion config set defaultWallet agent-bot

4. (Optional) sync to mobile

4. （可选）同步到移动应用

zerion wallet sync --wallet agent-bot


After step 1's agent-token prompt, the wallet is ready for autonomous trading via `zerion-trading`. To configure agent tokens or policies later → `zerion-agent-management`.

zerion wallet sync --wallet agent-bot


完成步骤1的agent-token设置后，钱包即可通过`zerion-trading`进行自主交易。如需后续配置agent-token或策略，请使用`zerion-agent-management`。

Common errors

常见错误

Code	Cause	Fix
`wallet_exists`	Wallet name already taken	Choose a different name or `wallet delete` first
`wallet_not_found`	Name not in OWS vault	`zerion wallet list` to see existing
`bad_passphrase`	Wrong passphrase entered	Retry; passphrase is set at creation
`bad_mnemonic`	Invalid recovery phrase format	Re-enter; must be valid BIP-39
`bad_evm_key`	Invalid 0x-prefixed hex	Should be 64 hex chars after `0x`
`bad_sol_key`	Invalid base58 keypair	Solana keys are base58, ≥87 chars

错误码	原因	解决方法
`wallet_exists`	钱包名称已被占用	选择其他名称，或先执行 `wallet delete` 删除已有钱包
`wallet_not_found`	名称不在OWS容器中	执行 `zerion wallet list` 查看现有钱包
`bad_passphrase`	输入的密码错误	重试；密码是在创建钱包时设置的
`bad_mnemonic`	恢复短语格式无效	重新输入；必须是有效的BIP-39格式
`bad_evm_key`	无效的0x前缀十六进制密钥	`0x` 后应包含64个十六进制字符
`bad_sol_key`	无效的base58密钥对	Solana密钥为base58格式，长度≥87个字符