用途：连接 Lighter.xyz（zklighter）ZK-rollup 永续与现货 DEX，用于行情查询、账户与订单管理、仓位与资金管理及模拟交易。
主要能力：市场数据（订单簿、成交、OHLCV、资金费率、24小时量/未平仓/标记价格）；账户查询（仓位、余额、活动订单、PnL、历史）；订单管理（限价/市价/止损/止盈，改单、撤单、一键平仓）；仓位管理（设置杠杆、调整逐仓保证金）；资金管理（提现、永续与现货账户间划转）；跨所资金费率对比（Binance、Bybit、Hyperliquid、Lighter）。
使用方式：Lighter 有两个独立部署，凭证不通用，必须先选网络。会话内先运行 lighter_get_network()；若未选择，需让用户确认是 Ethereum（app.lighter.xyz）还是 Robinhood Chain（robinhoodchain.lighter.xyz），再设 LIGHTER_NETWORK=ethereum 或 robinhood（别名 eth、mainnet、rh、robinhoodchain）。交易需 LIGHTER_PRIVATE_KEY（L2 API 私钥）与 LIGHTER_ACCOUNT_INDEX，可选 LIGHTER_API_KEY_INDEX（默认 2，范围 2-254）；可经环境变量或 ~/.lighter/lighter-agent-kit/credentials 配置，环境变量优先，LIGHTER_API_URL 可覆盖网络选择。只读工具无需密钥但仍需网络。账户索引可通过 lighter_get_account(l1_address="0xabc...") 查询；无账户需先在对应应用连接钱包并充值创建。API 密钥在对应应用的 API keys 页面生成，私钥仅显示一次。永续用裸代码（BTC），现货用带报价对（ETH/USDC）；交易工具接受人类单位并自动换算，响应含 effective_amount 与 effective_price。
模拟盘：lighter_paper_init(collateral=10000, tier="premium") 后使用 lighter_paper_order 等，本地状态、无凭证、不广播；仅永续、仅市价、无挂单、无资金费累积、仅全仓。
限制与安全：写入命令立即签名并广播；lighter_close_all_positions 属高风险，必须先 preview=true 并获用户确认；提现可能进入待处理/领取流程；私钥以 SecretValue 包装，不可读取或显示。模拟盘与实盘存在 PnL 偏差（无 maker 成交、无市场冲击、无延迟与部分成交、无资金费、无逐仓）。网络、账户索引、合约与市场因部署而异，应先用 lighter_get_markets() 核对符号。