veil

Original：🇺🇸 English

Not Translated

14 scripts

Privacy and shielded transactions on Base via Veil Cash (veil.cash). Deposit ETH or USDC into private pools, withdraw/transfer privately using ZK proofs. Manage Veil keypairs, check private/queue balances across all pools, and submit deposits via Bankr. Use when the user wants anonymous or private transactions, shielded transfers, or ZK-based privacy on Base.

2installs

Sourcebankrbot/skills

Added on2026-03-10

NPX Install

npx skill4agent add bankrbot/skills veil

SKILL.md Content

Veil

This skill wraps the

@veil-cash/sdk

CLI to make Veil operations agent-friendly.

Supported Assets

Asset	Decimals	Description
ETH	18	Native ETH (via WETH)
USDC	6	USDC on Base

What it does

Key management: generate and store a Veil keypair locally
Status check: verify configuration, registration, and relay health
Balances:
```
veil balance
```
(queue + private) — supports
```
--pool eth|usdc
```
Deposits via Bankr: build Bankr-compatible unsigned transactions and ask Bankr to sign & submit (handles ERC20 approve + deposit for USDC)
Private actions:
```
withdraw
```
,
```
transfer
```
,
```
merge
```
for ETH or USDC — executed locally using
```
VEIL_KEY
```
(ZK/proof flow)

File locations (recommended)

Veil keys:
```
~/.clawdbot/skills/veil/.env.veil
```
(chmod 600)
Bankr API key:
```
~/.clawdbot/skills/bankr/config.json
```

Quick start

1) Install the Veil SDK

Option A: Global npm install (recommended)

bash

npm install -g @veil-cash/sdk

Option B: Clone from GitHub

bash

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) Configure Base RPC (recommended)

Veil queries a lot of blockchain data (UTXOs, merkle proofs, etc.), so public RPCs will likely hit rate limits. A dedicated RPC from Alchemy, Infura, or similar is recommended.

Put

RPC_URL=...

in one of these:

```
~/.clawdbot/skills/veil/.env
```
(preferred)
or the SDK repo
```
.env
```
(less ideal)

Example:

bash

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) Make scripts executable

bash

chmod +x scripts/*.sh

4) Generate your Veil keypair

bash

scripts/veil-init.sh
scripts/veil-keypair.sh

5) Check your setup

bash

scripts/veil-status.sh

6) Find your Bankr Base address

bash

scripts/veil-bankr-prompt.sh "What is my Base wallet address? Respond with just the address."

7) Check balances

bash

# ETH pool (default)
scripts/veil-balance.sh --address 0xYOUR_BANKR_ADDRESS

# USDC pool
scripts/veil-balance.sh --address 0xYOUR_BANKR_ADDRESS --pool usdc

8) Deposit via Bankr (sign & submit)

bash

# 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) Withdraw (private to public)

bash

scripts/veil-withdraw.sh ETH 0.007 0xYOUR_BANKR_ADDRESS
scripts/veil-withdraw.sh USDC 50 0xRECIPIENT

10) Transfer privately

bash

scripts/veil-transfer.sh ETH 0.01 0xRECIPIENT
scripts/veil-transfer.sh USDC 25 0xRECIPIENT

11) Merge UTXOs

bash

scripts/veil-merge.sh ETH 0.1
scripts/veil-merge.sh USDC 100

References

SDK Reference — CLI commands, environment variables, error codes
Troubleshooting — Common issues and debugging tips

Notes

For Bankr signing, this skill uses Bankr's Agent API via your local
```
~/.clawdbot/skills/bankr/config.json
```
.
For USDC deposits via Bankr, the skill automatically submits the ERC20 approval transaction first, then the deposit transaction.
For privacy safety: never commit
```
.env.veil
```
or
```
.env
```
files to git.