# Zama SDK

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/zama

为机密智能合约提供加密、解密与权限工具。本条聚焦当前Zama SDK的委托解密：核链上委托、合约范围Permit、传播状态与余额读取，区分当前SDK和legacy Relayer SDK。

官方入口：https://docs.zama.org/protocol/sdk
类别：开发与基础设施
网络：Ethereum、Polygon、Ethereum Sepolia
访问条件：文档公开可读；真实解密需要适用链、密文访问权、签名Permit及可用Relayer。官方托管Ethereum/Polygon主网Relayer需要API key，Sepolia测试网不需key；浏览器应用的主网key应由后端保管。文档可读不代表个人已具权限。
费用：链上委托和撤销涉及网络Gas；不能把Sepolia无需API key等同主网所有操作免费。已读页面未确定个人实际协议费、Relayer商业费或每笔总成本。

## 用途
- 核委托人与读取方权限、期限及传播状态
- 区分解密失败、无密文与真实零余额

## 使用边界
- Datawallet Team署名原生JSONLD首发9月24日、修改9月25日；页面将后者标完整复核日期并披露affiliate，编辑政策的实测和独立性仅为其自述。只记一次具体产品方法评论，不采用评分、TVL、币价或安全判断证明采用规模；人工/AI生产及具体商业关系未独立核实。
- 当前默认包为@zama-fhe/sdk与React配套，旧Relayer SDK文章不代表现行接口；主网鉴权、测试网匿名和钱包Permit是不同层次。
- 链上委托与本地Permit分别设范围和期限；删除本地缓存不等于撤销链上委托，也不能收回已读出的明文。
- 加密保护数值，地址、交易存在、时间、Gas及shield/unshield金额仍可公开；可读依赖Relayer/KMS可用性，未验证实际账户、配置或交易。

## 操作教程
- [Zama委托解密排错：链上委托、Permit与余额缺值](https://lianxiaozhi.com/tools/guides/zama-delegated-balance-permit-scope)：按已有脱敏材料核谁可读哪个合约、何时有效，以及传播延迟、权限不足和真实零余额的区别。

## 相关知识

## 官方依据
- [Datawallet：Zama产品、开发权限与风险评论（含affiliate披露）](https://www.datawallet.com/crypto/zama-explained)
- [Zama：当前SDK与legacy Relayer SDK区别](https://docs.zama.org/protocol/sdk)
- [Zama：主网与Sepolia Relayer鉴权范围](https://docs.zama.org/protocol/sdk/guides/authentication.md)
- [Zama：Permit范围、到期与本地撤除](https://docs.zama.org/protocol/sdk/concepts/permit-model.md)
- [Zama：委托解密、传播、结果及撤销](https://docs.zama.org/protocol/sdk/guides/delegated-decryption.md)
- [Zama：权限、传播与缺密文错误](https://docs.zama.org/protocol/sdk/guides/handle-errors.md)
- [Zama：可见元数据与密钥存储边界（选读）](https://docs.zama.org/protocol/sdk/concepts/security-model.md)