Veil

Cette skill encapsule la CLI @veil-cash/sdk pour rendre les opérations Veil compatibles avec les agents.

Actifs supportés

Ce qu'elle fait

• Gestion des clés : générer et stocker une keypair Veil localement
• Vérification du statut : vérifier la configuration, l'enregistrement et la santé du relay
• Soldes : veil balance (queue + privé) — supporte --pool eth|usdc
• Dépôts via Bankr : construire des transactions non signées compatibles Bankr et demander à Bankr de signer & soumettre (gère l'approbation ERC20 + dépôt pour USDC)
• Actions privées : withdraw, transfer, merge pour ETH ou USDC — exécutées localement avec VEIL_KEY (flux ZK/proof)

Emplacements des fichiers (recommandé)

• Clés Veil : ~/.clawdbot/skills/veil/.env.veil (chmod 600)
• Clé API Bankr : ~/.clawdbot/skills/bankr/config.json

Démarrage rapide

1) Installer le SDK Veil

Option A : Installation npm globale (recommandée)

npm install -g @veil-cash/sdk

Option B : Cloner depuis 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) Configurer l'RPC Base (recommandé)

Veil interroge beaucoup de données blockchain (UTXOs, preuves merkle, etc.), donc les RPC publiques dépasseront probablement les limites de débit. Un RPC dédié d'Alchemy, Infura, ou similaire est recommandé.

Mettez RPC_URL=... dans un de ces emplacements :

• ~/.clawdbot/skills/veil/.env (préféré)
• ou le .env du repo SDK (moins idéal)

Exemple :

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) Rendre les scripts exécutables

chmod +x scripts/*.sh

4) Générer votre keypair Veil

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

5) Vérifier votre configuration

scripts/veil-status.sh

6) Trouver votre adresse Bankr Base

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

7) Vérifier les soldes

# Pool ETH (par défaut)
scripts/veil-balance.sh --address 0xYOUR_BANKR_ADDRESS

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

8) Dépôt via Bankr (signer & soumettre)

# Dépôt ETH
scripts/veil-deposit-via-bankr.sh ETH 0.011 --address 0xYOUR_BANKR_ADDRESS

# Dépôt USDC (gère automatiquement approbation + dépôt)
scripts/veil-deposit-via-bankr.sh USDC 100 --address 0xYOUR_BANKR_ADDRESS

9) Retrait (privé vers public)

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

10) Transfert privé

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

11) Fusionner les UTXOs

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

Références

• Référence SDK — commandes CLI, variables d'environnement, codes d'erreur
• Dépannage — Problèmes courants et conseils de débogage

Remarques

• Pour la signature Bankr, cette skill utilise l'API Agent de Bankr via votre ~/.clawdbot/skills/bankr/config.json local.
• Pour les dépôts USDC via Bankr, la skill soumet automatiquement d'abord la transaction d'approbation ERC20, puis la transaction de dépôt.
• Pour la sécurité du respect de la vie privée : ne commitez jamais les fichiers .env.veil ou .env sur git.