Lighter

zk rollup上的永续合约DEX，以USDC计价和结算。交易所对象连接Lighter的永续合约：下单、改单、撤单和设置杠杆都是用API密钥私钥签名的L2交易，查询挂单、历史订单要用同一把私钥生成的鉴权令牌。接入前需要在Lighter创建API密钥，并记下API密钥索引与账户索引。

名称与配置

exchange.GetName()：Futures_Lighter（期货）；别名：zkLighter。

交易对与合约代码

交易对示例：BTC_USDC、ETH_USDC

只有USDC计价的永续合约，交易对写作BTC_USDC，完整代码形如BTC_USDC.swap，其它计价币报错。交易对不区分大小写，返回数据中统一为大写。

Lighter只有永续合约，swap以外的合约代码会报错。

专属IO指令

表中长说明的其余部分：

• cross：Lighter的保证金模式与杠杆在同一笔链上交易里设置，这笔交易同时写入该品种当前的杠杆（先读交易所账户数据中该品种的设置；本次运行60秒内刚设置过的以刚设置的为准；都没有时取该市场的缺省杠杆）。
• api：默认附带用API密钥私钥生成的鉴权令牌（需要填写私钥与账户索引）；sign传false（也可以直接作为第4个参数）时不带令牌，只能用于公开GET接口。raw不是请求体而是参数表（JSON对象或a=1&b=2），非空时整体替换params；GET编入查询串，POST编成表单。不会替调用方签名L2交易。

通用指令base、currency见exchange.IO。

常用用法

设置限价单的存活时长

            javascript
            
            
function main() {
    // 之后的限价单与条件单在下单时刻加10分钟、再加1小时后过期（默认29天）；市价单不受影响
    exchange.IO("expiry", 60 * 60 * 1000)
    var id = exchange.CreateOrder("ETH_USDC.swap", "buy", 2000, 0.01)
    Log("订单ID:", id)
}

用api调用公开接口与带鉴权令牌的账户接口

            javascript
            
            
function main() {
    // 公开接口：第4个参数传false，不带鉴权令牌
    var books = exchange.IO("api", "GET", "/api/v1/orderBooks", {}, false)
    Log("市场数:", books.order_books.length)
    var d = exchange.IO("api", "GET", "/api/v1/orderBookDetails", {market_id: 0}, false)
    Log(d.order_book_details[0].symbol, "最新价:", d.order_book_details[0].last_trade_price)
    // 账户接口默认带鉴权令牌；账户索引可以从GetAccount()的Info中取
    var idx = exchange.GetAccount().Info.account_index
    var params = {account_index: idx, market_id: 0}
    var r = exchange.IO("api", "GET", "/api/v1/accountActiveOrders", params)
    Log("market_id为0的市场挂单数:", r.orders.length)
}

函数支持差异

没有不支持的标准函数。

以回退方式支持：

• exchange.GetRecords：原生周期为1分钟、5分钟、15分钟、30分钟、1小时、4小时、12小时、1天、1周；其它周期由托管者合成。

保证金、账户与模拟盘

保证金模式：用exchange.IO("cross", bool)按合约切换全仓/逐仓，用exchange.SetMarginLevel()设置杠杆。两者在Lighter是同一笔链上交易（UpdateLeverage），每次调用都会发出一笔交易，并且总是同时写入杠杆和保证金模式，另一项保持该品种当前的值：exchange.SetMarginLevel()保留当前保证金模式，exchange.IO("cross", ...)保留当前杠杆。当前值读取交易所账户数据中该品种的设置（没有持仓的品种也有）；本次运行60秒内刚设置过的以刚设置的为准（交易所数据更新有延迟）；都没有时为该市场的缺省杠杆、全仓。exchange.SetMarginLevel()也可在附加参数中传{marginMode: "isolated"}（或cross）同时指定保证金模式。持仓的MarginLevel由交易所持仓数据中的初始保证金率换算。

持仓模式：单向（净）持仓，不支持双向持仓。

账户：「账户索引」决定交易的是主账户还是子账户；账户和持仓按账户索引查询，资产只有USDC一种。

模拟盘：勾选「模拟盘」连接Lighter测试网（https://testnet.zklighter.elliot.ai）。也可以用exchange.SetBase()（或exchange.IO("base", url)）切换接口地址：地址中含testnet时按测试网签名，否则按主网签名。

注意事项