Lighter

核心用法

Lighter Skill 提供对零知识 Rollup 订单簿 DEX 的完整交互能力，涵盖市场数据查询、账户管理与交易执行三大模块：

• 无认证读取：通过 markets.py、orderbook.py、trades.py 获取市场列表、深度盘口与成交历史
• 账户操作：使用 account.py 查询余额与持仓，需配置 LIGHTER_API_KEY 与 LIGHTER_ACCOUNT_INDEX
• 交易执行：调用 order.py 下达限价/市价订单，支持 ETH-USD、BTC-USD、SOL-USD 等永续合约市场

技术实现基于官方 Python SDK，关键约束包括：订单类型与时间效力必须使用整型枚举（0=限价/1=市价）、价格与数量需转换为原子单位（×10⁸）、市价单推荐 create_market_order() 以规避 SDK 已知的 order_expiry bug。

显著优点

• 零费率架构：零售用户享受零交易手续费，ZK-Rollup 批量结算显著降低 Gas 成本
• 性能优势：毫秒级延迟，支持每秒数万订单吞吐量，兼顾链上可验证性与 CEX 级体验
• 资本背书：Founders Fund、Robinhood、Coinbase Ventures 等知名机构投资，增强协议可信度
• 透明可审计：全量操作附带 ZK 证明，以太坊主网作为安全基底，满足合规审计需求

潜在缺点与局限性

• 密钥管理复杂度：需同时管理 ETH 私钥（仅初始化）、Lighter API Key（签名交易）与账户索引，多凭证体系增加泄露面
• 地理限制：明确存在司法管辖区限制，部分国家/地区用户可能无法合法访问
• SDK 成熟度：已知 order_expiry 参数 bug，需绕过 create_order() 使用专用函数，代码稳定性存疑
• 生态封闭性：仅支持 Lighter 自建 ZK-Rollup（Chain ID 300），跨链资产桥接依赖官方基础设施

适合人群

• 高频零售交易者：追求零费率与低延迟，能接受自托管钱包方案
• 量化策略开发者：需要程序化访问订单簿数据与自动化下单
• ZK 技术验证者：关注全量可验证交易历史的研究者与审计机构

常规风险

• 密钥泄露：API Key 泄露可导致账户资产被恶意交易，必须存储于安全凭证管理器并定期轮换
• 智能合约风险：ZK 电路与 Rollup 合约虽经审计，仍存在未披露漏洞可能
• 运营方风险：Elliot Technology 作为开发实体，存在政策变更或节点停机风险
• 法律合规：用户需自行确认所在地监管合规性，违反条款可能导致账户冻结

核心用法

Lighter Skill 是连接 Lighter 协议（基于 ZK-Rollup 的订单簿 DEX）的专用交易工具。用户通过该技能可执行：市场数据查询（无需凭证）、账户余额查看、持仓管理以及下单交易。核心依赖 Python SDK 与官方 API 交互，支持 ETH、BTC、SOL 等主流永续合约市场。

使用前需完成三步配置：获取以太坊地址对应的 Account Index、通过官方脚本生成 API Key、设置环境变量。交易时采用原子单位（×10⁸）计价，支持限价/市价单及 GTC/IOC 订单类型。

显著优点

极速零费：基于自研 ZK 基础设施，实现毫秒级延迟与零售用户零交易费用，吞吐量达数万 TPS。机构背书：获 Founders Fund、Robinhood、Coinbase Ventures 等知名机构投资，技术可信度较高。安全架构：全操作零知识证明可验证，以太坊作为安全基底层。代码规范：静态分析无危险函数，API 密钥强制环境变量读取，无硬编码敏感信息。隐私合规：通过 GDPR 数据保护检查，无私密数据外泄风险。

潜在缺点与局限性

地理限制：Lighter 对特定司法管辖区设限，部分用户可能无法访问。第三方依赖：核心功能依赖 lighter-sdk 外部包，若官方 SDK 更新或存在漏洞将影响功能。网络依赖：所有操作需连接官方 API，离线或网络中断时无法使用。资金风险：加密货币交易本身存在市场波动风险，技能层面无法规避。认知门槛：需理解 ZK-Rollup、原子单位、Account Index 等概念，对新手不够友好。

适合的目标群体

DeFi 交易者：熟悉去中心化交易、追求低延迟零费用的活跃交易者。量化开发者：需程序化接入订单簿 DEX 进行策略开发的工程师。机构套利者：对吞吐量与结算速度有较高要求的专业团队。ZK 技术探索者：希望体验零知识证明在实际金融场景应用的研究者。

常规风险提醒

密钥管理风险：API Key 与私钥由用户自行保管，泄露将导致账户资金损失。务必使用专用"burner wallet"，定期轮换密钥。SDK 漏洞风险：尽管当前无已知 CVE，但 lighter-sdk 更新可能引入 Breaking Change 或安全问题，建议锁定版本并审查源码。市场与合规风险：加密货币价格波动剧烈，且需自行确认所在地区合规性。API 可用性风险：官方服务端点故障或维护时将影响全部功能。误操作风险：原子单位换算错误可能导致订单金额偏差，需仔细核对参数。