mcpField
V
veil

veil

github.com/bankrbot安全1.2k197 次安装5 天前更新
代码仓库

关于 veil

Veil 是面向 Agent 的 @veil-cash/sdk CLI 封装，用于执行 ETH 和 USDC 隐私操作。它提供本地密钥管理、余额与状态检查、Bankr 辅助存款，以及私密转账、提现和合并。

主要功能

  1. 01生成并本地保存 Veil 密钥对
  2. 02检查配置、注册和中继状态
  3. 03查看 ETH 和 USDC 余额
  4. 04生成兼容 Bankr 的存款交易
  5. 05私密提现、转账和合并

适用场景

  1. 01查看 ETH 或 USDC 池余额
  2. 02通过 Bankr 存入资产
  3. 03私密转移 ETH 或 USDC
  4. 04提现或合并 Veil 资金

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bankrbot/skills --skill veil

安装后在 Claude Code 中输入/veil确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

catalog.json
README.md
references/
sdk-reference.md
troubleshooting.md
scripts/
_common.sh
veil-balance.sh
veil-bankr-prompt.sh
veil-bankr-submit-tx.sh
veil-deposit-unsigned.sh
veil-deposit-via-bankr.sh
veil-init.sh
veil-keypair.sh
veil-merge.sh
veil-private-balance.sh
veil-queue-balance.sh
veil-status.sh
veil-transfer.sh
veil-withdraw.sh
templates/
env.example
env.veil.example

详细介绍

Veil

此技能封装了 @veil-cash/sdk CLI，让 Agent 能够轻松执行 Veil 操作。

支持的资产

资产小数位说明
ETH18原生 ETH（通过 WETH）
USDC6Base 上的 USDC

功能

  • 密钥管理：在本地生成并存储 Veil 密钥对
  • 状态检查：验证配置、注册状态和中继健康状况
  • 余额：veil balance（队列 + 私有余额）——支持 --pool eth|usdc
  • 通过 Bankr 存款：构建 兼容 Bankr 的未签名交易，并让 Bankr 签名和提交（USDC 会自动处理 ERC20 授权和存款）
  • 私有操作：针对 ETH 或 USDC 执行 withdraw、transfer、merge——使用 VEIL_KEY 在本地执行（ZK/证明流程）

文件位置（推荐）

  • Veil 密钥：~/.clawdbot/skills/veil/.env.veil （chmod 600）
  • Bankr API 密钥：~/.clawdbot/skills/bankr/config.json

快速开始

1) 安装 Veil SDK

选项 A：全局安装 npm 包（推荐）

npm install -g @veil-cash/sdk

选项 B：从 GitHub 克隆

mkdir -p ~/.openclaw/workspace/repos
cd ~/.openclaw/workspace/repos
git clone https://github.com/veildotcash/veildotcash-sdk.git
cd veildotcash-sdk
npm ci && npm run build
2) 配置 Base RPC（推荐）

Veil 会查询大量区块链数据（UTXO、Merkle 证明等），因此公共 RPC 很可能会触发速率限制。建议使用 Alchemy、Infura 或类似服务提供的专用 RPC。

在以下其中一个文件中添加 RPC_URL=...：

  • ~/.clawdbot/skills/veil/.env （首选）
  • 或 SDK 仓库中的 .env（不太理想）

示例：

mkdir -p ~/.clawdbot/skills/veil
cat > ~/.clawdbot/skills/veil/.env << 'EOF'
RPC_URL=https://base-mainnet.g.alchemy.com/v2/YOUR_KEY
EOF
chmod 600 ~/.clawdbot/skills/veil/.env
3) 将脚本设为可执行
chmod +x scripts/*.sh
4) 生成 Veil 密钥对
scripts/veil-init.sh
scripts/veil-keypair.sh
5) 检查设置
scripts/veil-status.sh
6) 查找 Bankr Base 地址
scripts/veil-bankr-prompt.sh "What is my Base wallet address? Respond with just the address."
7) 检查余额
# ETH pool (default)
scripts/veil-balance.sh --address 0xYOUR_BANKR_ADDRESS

# USDC pool
scripts/veil-balance.sh --address 0xYOUR_BANKR_ADDRESS --pool usdc
8) 通过 Bankr 存款（签名并提交）
# Deposit ETH
scripts/veil-deposit-via-bankr.sh ETH 0.011 --address 0xYOUR_BANKR_ADDRESS

# Deposit USDC (auto-handles approve + deposit)
scripts/veil-deposit-via-bankr.sh USDC 100 --address 0xYOUR_BANKR_ADDRESS
9) 提款（从私有账户转至公开账户）
scripts/veil-withdraw.sh ETH 0.007 0xYOUR_BANKR_ADDRESS
scripts/veil-withdraw.sh USDC 50 0xRECIPIENT
10) 私密转账
scripts/veil-transfer.sh ETH 0.01 0xRECIPIENT
scripts/veil-transfer.sh USDC 25 0xRECIPIENT
11) 合并 UTXO
scripts/veil-merge.sh ETH 0.1
scripts/veil-merge.sh USDC 100

参考资料

注意事项

  • 对于 Bankr 签名，此技能通过本地的 ~/.clawdbot/skills/bankr/config.json 使用 Bankr Agent API。
  • 对于通过 Bankr 进行的 USDC 存款，此技能会先自动提交 ERC20 授权交易，然后再提交存款交易。
  • 为保护隐私，切勿将 .env.veil 或 .env 文件提交到 git。

评论

支持 Markdown