veil について
Veilは、ETHとUSDCのプライベート操作向けに@veil-cash/sdk CLIをエージェント向けにラップします。ローカルでの鍵管理、残高・状態確認、Bankr経由の入金、非公開の送金・出金・統合に対応します。
主な機能
- 01Veilキーペアの生成とローカル保存
- 02設定、登録、リレー状態の確認
- 03ETHとUSDCの残高確認
- 04Bankr互換の入金トランザクション作成
- 05非公開の出金、送金、統合
活用シーン
- 01ETHまたはUSDCプールの残高確認
- 02Bankr経由での資産入金
- 03ETHまたはUSDCの非公開送金
- 04Veil資金の出金または統合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bankrbot/ skills --skill veilインストール後、Claude Code で/veilを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
catalog.jsonREADME.mdreferences/sdk-reference.mdtroubleshooting.mdscripts/_common.shveil-balance.shveil-bankr-prompt.shveil-bankr-submit-tx.shveil-deposit-unsigned.shveil-deposit-via-bankr.shveil-init.shveil-keypair.shveil-merge.shveil-private-balance.shveil-queue-balance.shveil-status.shveil-transfer.shveil-withdraw.shtemplates/env.exampleenv.veil.example詳細
Veil
このスキルは @veil-cash/sdk CLI をラップし、エージェントが Veil を操作しやすくします。
対応アセット
| アセット | 小数桁数 | 説明 |
|---|---|---|
| ETH | 18 | ネイティブ ETH(WETH 経由) |
| USDC | 6 | Base 上の 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、マークル証明など)を照会するため、パブリック RPC ではレート制限に達する可能性が高いです。Alchemy、Infura などの専用 RPC を推奨します。
次のいずれか 1 つに 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
参考資料
- SDK リファレンス — CLI コマンド、環境変数、エラーコード
- トラブルシューティング — よくある問題とデバッグのヒント
注意事項
- Bankr による署名では、このスキルはローカルの
~/.clawdbot/skills/bankr/config.jsonを通じて Bankr の Agent API を使用します。 - Bankr 経由の USDC 入金では、このスキルがまず ERC20 承認トランザクションを自動で送信し、次に入金トランザクションを送信します。
- プライバシー保護のため、
.env.veilまたは.envファイルを git にコミットしないでください。
コメント
Markdown 対応