用途：为自行构建钱包或自持账户、查看密钥、笔记发现与证明的后端团队提供底层 Starknet 隐私能力。若在已有钱包之上做 dapp，应改用 strk20-wallet-api。
主要能力：TypeScript SDK，提供 createPrivateTransfers 接线，支持 register、deposit、transfer、withdraw、多操作/多代币批处理、shadow accounts（RC.4 称 called sub-accounts）、discoverNotes 笔记发现、discoverRequirement 前置检查，以及证明与发现提供方配置。
安装：npm install @starkware-libs/starknet-privacy-sdk，需 Node.js >= 24。若 npm 返回 404，可从 GitHub Packages 安装（需 GitHub token，即使公开包）：gh auth refresh -h github.com -s read:packages；export NODE_AUTH_TOKEN="$(gh auth token)"；npm config set @starkware-libs:registry https://npm.pkg.github.com --location=project；npm config set '//npm.pkg.github.com/:_authToken' '${NODE_AUTH_TOKEN}' --location=project；npm install @starkware-libs/starknet-privacy-sdk；unset NODE_AUTH_TOKEN。也可固定提交：npm install "starkware-libs/starknet-privacy#<commit-sha>"。
用法要点：viewingKeyProvider 必须返回 bigint，十六进制字符串会静默派生错误通道密钥；provingBlockId 应取 currentBlock - 10 以缓冲 L2 重组；无 proof facts 时省略 proof 键，传空数组会序列化出无效 v3 交易；v3 交易必须带 tip: 0n。透明状态规则要求证明读取的链上状态（查看密钥、存款人代币余额、nullifier 集合）在所选证明基准已存在。
限制：SDK 仍为 release candidate，面向用户的 dapp 宜用稳定的 Wallet API 0.10.4；Python/Rust 后端需以 Node 边车服务运行；ContractDiscoveryProvider 尚未从发布包导出；发现与证明请求携带查看密钥材料，生产环境应启用 OHTTP、固定 publicKeyConfig 并使用 HTTPS；存款需 FPI 筛查签名。文档快照中 sdk__deposit.md 的两笔交易规则已过时。包状态与 shadow-account 文档更新于 2026-09-29，导出与地址可能变动，使用前请核对官方仓库。