Agent skill

veil

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.

Stars 1,058
Forks 394

Install this agent skill to your Project

npx add-skill https://github.com/BankrBot/skills/tree/main/veil

Metadata

Additional technical details for this skill

clawdbot
{
    "emoji": "\ud83c\udf2a\ufe0f",
    "homepage": "https://veil.cash",
    "requires": {
        "bins": [
            "node",
            "curl",
            "jq"
        ]
    }
}

SKILL.md

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.

Expand your agent's capabilities with these related and highly-rated skills.

BankrBot/skills

bankr

AI-powered crypto trading agent, wallet API, and LLM gateway via natural language. Use when the user wants to trade crypto, check portfolio balances (with PnL and NFTs), view token prices, search tokens, transfer crypto, manage NFTs, use leverage, bet on Polymarket, deploy tokens, set up automated trading, sign and submit raw transactions, or access LLM models through the Bankr LLM gateway funded by your Bankr wallet. Supports Base, Ethereum, Polygon, Solana, and Unichain.

1,058 394
Explore
BankrBot/skills

neynar

Interact with Farcaster via Neynar API. Use when the user wants to read Farcaster feeds, look up users, post casts, search content, or interact with the Farcaster social protocol. Requires NEYNAR_API_KEY.

1,058 394
Explore
BankrBot/skills

hydrex

Interact with Hydrex liquidity pools on Base. Use when the user wants to lock HYDX for voting power, check voting power for gauge voting, vote on liquidity pool strategies, view pool information, check voting weights, participate in Hydrex governance, deposit single-sided liquidity into auto-managed vaults to earn Hydrex yields, claim oHYDX rewards from incentive campaigns, or exercise oHYDX into veHYDX. Uses Bankr for transaction execution.

1,058 394
Explore
BankrBot/skills

zyfai

Earn yield on any Ethereum wallet on Base, Arbitrum, and Plasma. Use when a user wants passive DeFi yield on their funds. Deploys a non-custodial deterministic subaccount (Safe) linked to their EOA, enables automated yield optimization, and lets them deposit/withdraw anytime.

1,058 394
Explore
BankrBot/skills

base

Placeholder for Base skill.

1,058 394
Explore
BankrBot/skills

0xwork

Find and complete paid tasks on the 0xWork decentralized marketplace (Base chain, USDC escrow). Use when: the agent wants to earn money/USDC by doing work, discover available tasks, claim a bounty, submit deliverables, post tasks with bounties, check earnings or wallet balance, sell digital products, list services, or set up as a 0xWork worker/poster. Task categories: Writing, Research, Social, Creative, Code, Data. NOT for: managing the 0xWork platform or frontend development.

1,058 394
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results