taiko-shadow
3
总安装量
1
周安装量
#57444
全站排名
安装命令
npx skills add https://github.com/taikoxyz/taiko-ai --skill taiko-shadow
Agent 安装分布
windsurf
1
amp
1
cline
1
qoder
1
opencode
1
cursor
1
Skill 文档
Shadow â Private ETH Transfer on Taiko
Shadow is a privacy-preserving ETH claim system on Taiko L2. An agent deposits ETH to a deterministically-derived “target address” on L1 Ethereum, then claims on Taiko L2 using a ZK proof â without linking depositor and recipient.
Lifecycle
Create deposit â Fund target address (L1) â Generate ZK proof â Claim on L2
Constraints: 1â5 notes per deposit, total ⤠8 ETH, 0.1% protocol fee per claim.
Quick Decision
| Situation | Use |
|---|---|
| Default / automated pipeline | Server (REST API) |
| No Docker server available | CLI (shadowcli.mjs) |
| Scripted proving only | start.sh --prove FILE (see server reference) |
References
- Server & REST API â start.sh flags, 4-stage workflow, full API table
- CLI â shadowcli.mjs subcommands, mine-deposit flags
- Deposit Schema â v2 JSON schema, derivation formulas
- Contracts â deployed addresses, circuit ID, cast queries
Common Errors
| Error | Fix |
|---|---|
insufficient balance: X < Y |
Fund target on L1, wait for checkpoint, retry |
nullifier already consumed |
Note already claimed â skip, check others |
Please install docker first |
Start Docker daemon |
RPC chainId mismatch |
Use L1 RPC matching deposit’s chainId |
DEPOSIT schema validation failed |
See deposit schema |
| Server not responding | Re-run start.sh |
Security
- Deposit file = secret â never commit or log it; loss = unrecoverable ETH
- The target address has no known private key; ETH can only leave via claim
- Shadow provides privacy but does not guarantee full anonymity