perp-cli 0.14.3 → 0.16.0

package/dist/exchanges/venues/create-helpers.d.ts

@@ -2,7 +2,7 @@
  * Adapter construction for the pre-existing venues (pacifica / hyperliquid /
  * lighter / lighter-rh / aster) — the single creation path that replaced the
  * three copies in src/index.ts (getAdapter / _initWithOws / getAdapterForExchange)
- * and the MCP server's getOrCreateAdapter (design §10.2).
+ * and the MCP server's getOrCreateAdapter.
  *
  * Signer tiers, as before: agent (Tier 1) → OWS master (Tier 2) → raw PK (Tier 3).
  * Which tier signs a given request is still decided inside each adapter.

package/dist/exchanges/venues/create-helpers.js

@@ -2,7 +2,7 @@
  * Adapter construction for the pre-existing venues (pacifica / hyperliquid /
  * lighter / lighter-rh / aster) — the single creation path that replaced the
  * three copies in src/index.ts (getAdapter / _initWithOws / getAdapterForExchange)
- * and the MCP server's getOrCreateAdapter (design §10.2).
+ * and the MCP server's getOrCreateAdapter.
  *
  * Signer tiers, as before: agent (Tier 1) → OWS master (Tier 2) → raw PK (Tier 3).
  * Which tier signs a given request is still decided inside each adapter.
@@ -84,7 +84,7 @@ export async function createPacifica(ctx) {
         adapter = new PacificaAdapter(parseSolanaKeypair(creds.pk), ctx.network, true);
     }
     else {
-        // Read-only: no key material. index.ts:143 Keypair.generate() recorded as out of scope (§10.11).
+        // Read-only: no key material. index.ts:143 Keypair.generate() recorded as out of scope.
         adapter = new PacificaAdapter(Keypair.generate(), ctx.network, false);
     }
     const agent = await legacyAgentOf(ctx, creds, "pacifica");
@@ -138,7 +138,7 @@ export async function createHyperliquid(ctx) {
 export async function createLighterFamily(venue, ctx) {
     const creds = effectiveCredentials(ctx);
     if (venue === "lighter-rh" && creds.pk !== null) {
-        // Design §10.3: the Lighter RH master key is an OWS wallet only — no env / raw-PK tier.
+        // The Lighter RH master key is an OWS wallet only — no env / raw-PK tier.
         throw new PerpError("NO_ENV_TIER", "Lighter RH does not accept a raw private key (env / --private-key / local wallet)", {
             remediation: "Import the key into OWS (perp wallet import, key via hidden prompt / stdin) and run with --ows <wallet>, or register an agent: perp wallet agent approve lighter-rh",
         });

package/dist/exchanges/venues/extended.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Extended (formerly X10) — perps order book on Starknet, USD collateral. MARKET DATA ONLY in this
+ * version, through the OFFICIAL public REST API (https://api.docs.extended.exchange/).
+ *
+ *  - roles are ["marketData"]: every account / trading / funds / agent / builder / bot path
+ *    refuses with CAPABILITY_UNSUPPORTED before any request (venue.ts roleUnsupported(), with the
+ *    readOnlyRemediation below). There is no Extended order, signing (Stark), transfer or account
+ *    code at all; trading is planned for a later release.
+ *  - Hosts (docs "Mainnet" / "Testnet"): mainnet api.starknet.extended.exchange, testnet (Sepolia)
+ *    api.starknet.sepolia.extended.exchange. The old api.extended.exchange answers 404.
+ *  - Every request must carry a User-Agent header (docs "Mandatory headers"; none → HTTP 403).
+ *  - Funding (docs "Get funding rates history", docs.extended.exchange funding-payments): applied
+ *    once per hour; marketStats.fundingRate is the current hour's ACCRUING rate (recomputed every
+ *    minute) as a FRACTION per hour — see extended/public.ts.
+ * Not registered here; the registry module owns registerVenue().
+ */
+import type { VenueDefinition } from "../venue.js";
+export declare const EXTENDED_DOCS_URL = "https://api.docs.extended.exchange/";
+/** The remediation of every role refusal (owner decision: phase 1 is read-only). */
+export declare const EXTENDED_READ_ONLY_REMEDIATION = "Extended is read-only (market data) in this version; trading is planned for a later release. Market data: perp -e extended market list|prices|info|book|trades|funding|kline";
+export declare const extendedVenue: VenueDefinition;

package/dist/exchanges/venues/extended.js

@@ -0,0 +1,96 @@
+/**
+ * Extended (formerly X10) — perps order book on Starknet, USD collateral. MARKET DATA ONLY in this
+ * version, through the OFFICIAL public REST API (https://api.docs.extended.exchange/).
+ *
+ *  - roles are ["marketData"]: every account / trading / funds / agent / builder / bot path
+ *    refuses with CAPABILITY_UNSUPPORTED before any request (venue.ts roleUnsupported(), with the
+ *    readOnlyRemediation below). There is no Extended order, signing (Stark), transfer or account
+ *    code at all; trading is planned for a later release.
+ *  - Hosts (docs "Mainnet" / "Testnet"): mainnet api.starknet.extended.exchange, testnet (Sepolia)
+ *    api.starknet.sepolia.extended.exchange. The old api.extended.exchange answers 404.
+ *  - Every request must carry a User-Agent header (docs "Mandatory headers"; none → HTTP 403).
+ *  - Funding (docs "Get funding rates history", docs.extended.exchange funding-payments): applied
+ *    once per hour; marketStats.fundingRate is the current hour's ACCRUING rate (recomputed every
+ *    minute) as a FRACTION per hour — see extended/public.ts.
+ * Not registered here; the registry module owns registerVenue().
+ */
+export const EXTENDED_DOCS_URL = "https://api.docs.extended.exchange/";
+/** The remediation of every role refusal (owner decision: phase 1 is read-only). */
+export const EXTENDED_READ_ONLY_REMEDIATION = "Extended is read-only (market data) in this version; trading is planned for a later release. Market data: perp -e extended market list|prices|info|book|trades|funding|kline";
+/** Lazy: public.ts is only loaded when market data is actually requested. */
+const publicData = {
+    async fetchFundingRates(net) {
+        return (await import("../extended/public.js")).extendedPublicData.fetchFundingRates(net);
+    },
+    async fetchMarkets(net) {
+        return (await import("../extended/public.js")).extendedPublicData.fetchMarkets(net);
+    },
+};
+export const extendedVenue = {
+    id: "extended",
+    aliases: ["ext", "x10"],
+    displayName: "Extended",
+    family: "extended",
+    masterKeyKind: "none",
+    agentKeyKind: "none",
+    secretStorage: { kind: "none", dir: null },
+    networks: {
+        mainnet: {
+            restUrl: "https://api.starknet.extended.exchange/api/v1",
+            wsUrl: "wss://api.starknet.extended.exchange/stream.extended.exchange/v1",
+            explorerUrl: null,
+            signingChainId: null,
+            settlementChain: "starknet",
+            collateral: ["USD"],
+            collateralAssetIndex: null,
+            rpcUrl: null,
+            depositPins: null,
+        },
+        testnet: {
+            restUrl: "https://api.starknet.sepolia.extended.exchange/api/v1",
+            // The docs' SDK config (TESTNET_CONFIG stream_url). Unused (no ws codec); live 2026-10-19 it
+            // answered HTTP 403 to a public stream (api.starknet.sepolia… answered 503) — unverified.
+            wsUrl: "wss://starknet.sepolia.extended.exchange/stream.extended.exchange/v1",
+            explorerUrl: null,
+            signingChainId: null,
+            settlementChain: "starknet",
+            collateral: ["USD"],
+            collateralAssetIndex: null,
+            rpcUrl: null,
+            depositPins: null,
+        },
+    },
+    // Funding is applied once per hour on every perpetual market; the published rate is per hour.
+    fundingRateBasis: { kind: "perHours", hours: 1 },
+    settlementIntervalHours: 1,
+    // Not verified: the unit / sign of marketStats.fundingRate is not checked against a settled account
+    // funding payment (needs an account; RISEx's bar). Partial evidence only: docs + one recorded
+    // settlement (src/__tests__/fixtures/extended/funding-settlement-evidence.json — last accruing value
+    // == applied print on 8 markets, 5 of them at the baseline). And `_24_5` equities print 0 while
+    // their underlying is closed (TSLA_24_5: 34 of 43 weekend prints were 0), so hourly × 8760
+    // overstates them. Until settled against payments Extended is not a funding-arb venue.
+    fundingVerified: false,
+    roles: ["marketData"],
+    capabilities: null,
+    // Docs "Rate Limits": default tier 1,000 requests/minute per IP, all endpoints throttled by IP.
+    // 15/s sustained (900/min) leaves headroom for other processes on the same IP.
+    rateLimit: { capacity: 50, refillPerSec: 15, weights: null },
+    // docs.extended.exchange/extended-resources/legal/restricted-countries (2026-10-19), Category A;
+    // Ukraine is restricted only for Crimea / Donetsk / Kherson / Luhansk / Zaporizhzhia (no alpha-2).
+    // Warning-only and shown with credentials — unused while the venue is market data only.
+    restrictedRegions: ["AF", "CA", "HK", "CU", "IR", "IQ", "YE", "KP", "RU", "SY", "SC", "GB", "US"],
+    symbolIdentity: "baseTicker",
+    publicData,
+    spot: null,
+    // Unused (no trading role); the field is required by the definition shape.
+    maxSlippageBps: 1,
+    builderFee: null,
+    apiStatus: { kind: "official" },
+    gatedRoles: null,
+    readOnlyRemediation: EXTENDED_READ_ONLY_REMEDIATION,
+    // A public-only adapter: market data works, every account / trading method refuses.
+    async create(ctx) {
+        const { ExtendedPublicAdapter } = await import("../extended/adapter.js");
+        return new ExtendedPublicAdapter(extendedVenue, ctx.network);
+    },
+};

package/dist/exchanges/venues/grvt.d.ts

@@ -0,0 +1,30 @@
+/**
+ * GRVT venue definition — MARKET DATA ONLY in this version (official, documented API).
+ *
+ * GRVT (api-docs.grvt.io) is a hybrid perps exchange (off-chain matching, ZK-validium settlement on
+ * GRVT chain 325), USDT collateral. perp-cli reads its public Market Data REST API
+ * (`POST https://market-data.grvt.io/full/v1/<endpoint>`, no key) and nothing else:
+ *  - roles are ["marketData"]: every account / trading / funds / agent / builder / bot path refuses
+ *    with CAPABILITY_UNSUPPORTED before any request (venue.ts roleUnsupported(), with the
+ *    readOnlyRemediation below). There is no GRVT order, signing, transfer or account code at all.
+ *  - funding is unverified (fundingVerified false): the ticker's `funding_rate` is the venue's
+ *    indicative rate for the active interval (a moving estimate of the next payment, "predicted"),
+ *    quoted in percent per the market's own funding interval (4 h or 8 h, per instrument). The
+ *    percent unit is documented for settled history (/full/v1/funding "percentage points") and
+ *    observed identical in magnitude on the ticker (whose schema says "centibeeps"); it is not yet
+ *    checked against settled funding payments (an authenticated read) — kept out of arb ranking
+ *    unless --include-unverified.
+ * Not registered here; the registry module owns registerVenue().
+ */
+import type { RateLimitPolicy, VenueDefinition } from "../venue.js";
+export declare const GRVT_DOCS_URL = "https://api-docs.grvt.io";
+/** Uniform refusal text for every write / signer / setup-trading path on GRVT. */
+export declare const GRVT_READ_ONLY_REMEDIATION = "GRVT is read-only (market data) in this version; trading is planned for a later release";
+/**
+ * help.grvt.io "What are the rate limitations on Grvt?" — REST Market Data, every tier, per minute:
+ * GetInstrument / MiniTicker / Ticker 1500, all others 500 (WS JSON-RPC calls count too). Two token
+ * buckets sized so that no 60 s window can exceed the limit (capacity + 60 s × refill ≤ limit).
+ */
+export declare const GRVT_TICKER_RATE_LIMIT: RateLimitPolicy;
+export declare const GRVT_OTHER_RATE_LIMIT: RateLimitPolicy;
+export declare const grvtVenue: VenueDefinition;

package/dist/exchanges/venues/grvt.js

@@ -0,0 +1,98 @@
+/**
+ * GRVT venue definition — MARKET DATA ONLY in this version (official, documented API).
+ *
+ * GRVT (api-docs.grvt.io) is a hybrid perps exchange (off-chain matching, ZK-validium settlement on
+ * GRVT chain 325), USDT collateral. perp-cli reads its public Market Data REST API
+ * (`POST https://market-data.grvt.io/full/v1/<endpoint>`, no key) and nothing else:
+ *  - roles are ["marketData"]: every account / trading / funds / agent / builder / bot path refuses
+ *    with CAPABILITY_UNSUPPORTED before any request (venue.ts roleUnsupported(), with the
+ *    readOnlyRemediation below). There is no GRVT order, signing, transfer or account code at all.
+ *  - funding is unverified (fundingVerified false): the ticker's `funding_rate` is the venue's
+ *    indicative rate for the active interval (a moving estimate of the next payment, "predicted"),
+ *    quoted in percent per the market's own funding interval (4 h or 8 h, per instrument). The
+ *    percent unit is documented for settled history (/full/v1/funding "percentage points") and
+ *    observed identical in magnitude on the ticker (whose schema says "centibeeps"); it is not yet
+ *    checked against settled funding payments (an authenticated read) — kept out of arb ranking
+ *    unless --include-unverified.
+ * Not registered here; the registry module owns registerVenue().
+ */
+export const GRVT_DOCS_URL = "https://api-docs.grvt.io";
+/** Uniform refusal text for every write / signer / setup-trading path on GRVT. */
+export const GRVT_READ_ONLY_REMEDIATION = "GRVT is read-only (market data) in this version; trading is planned for a later release";
+/**
+ * help.grvt.io "What are the rate limitations on Grvt?" — REST Market Data, every tier, per minute:
+ * GetInstrument / MiniTicker / Ticker 1500, all others 500 (WS JSON-RPC calls count too). Two token
+ * buckets sized so that no 60 s window can exceed the limit (capacity + 60 s × refill ≤ limit).
+ */
+export const GRVT_TICKER_RATE_LIMIT = { capacity: 750, refillPerSec: 12, weights: null };
+export const GRVT_OTHER_RATE_LIMIT = { capacity: 250, refillPerSec: 4, weights: null };
+/** Lazy: public.ts is only loaded when market data is actually requested. */
+const publicData = {
+    async fetchFundingRates(net) {
+        return (await import("../grvt/public.js")).grvtPublicData.fetchFundingRates(net);
+    },
+    async fetchMarkets(net) {
+        return (await import("../grvt/public.js")).grvtPublicData.fetchMarkets(net);
+    },
+};
+export const grvtVenue = {
+    id: "grvt",
+    aliases: ["grv"],
+    displayName: "GRVT",
+    family: "grvt",
+    masterKeyKind: "none",
+    agentKeyKind: "none",
+    secretStorage: { kind: "none", dir: null },
+    networks: {
+        // grvt-pysdk grvt_raw_env.py (PROD / TESTNET); the docs' "Try it out" uses the same hosts.
+        mainnet: {
+            restUrl: "https://market-data.grvt.io",
+            wsUrl: "wss://market-data.grvt.io/ws/full",
+            explorerUrl: null,
+            signingChainId: null,
+            settlementChain: "offchain",
+            collateral: ["USDT"],
+            collateralAssetIndex: null,
+            rpcUrl: null,
+            depositPins: null,
+        },
+        testnet: {
+            restUrl: "https://market-data.testnet.grvt.io",
+            wsUrl: "wss://market-data.testnet.grvt.io/ws/full",
+            explorerUrl: null,
+            signingChainId: null,
+            settlementChain: "offchain",
+            collateral: ["USDT"],
+            collateralAssetIndex: null,
+            rpcUrl: null,
+            depositPins: null,
+        },
+    },
+    // Per instrument: funding_interval_hours is 8 or 4 (live 2026-10-19: 124 × 8 h, 60 × 4 h).
+    fundingRateBasis: "perMarket",
+    settlementIntervalHours: "perMarket",
+    fundingVerified: false,
+    roles: ["marketData"],
+    // Not a release gate (nothing is implemented and switched off): the venue has no trading code yet.
+    gatedRoles: null,
+    capabilities: null,
+    // "All others" bucket (instruments, book, trade, funding, kline, margin_rules); the ticker bucket
+    // is GRVT_TICKER_RATE_LIMIT (grvt/client.ts picks per endpoint).
+    rateLimit: GRVT_OTHER_RATE_LIMIT,
+    // help.grvt.io/en/articles/9711621-restricted-jurisdictions (also Crimea / Donetsk / Luhansk /
+    // Kherson / Zaporizhzhya / Sevastopol regions). Trading needs KYC — relevant once trading lands.
+    restrictedRegions: ["US", "PR", "AS", "GU", "MP", "VI", "SG", "HK", "KP", "IR", "MM", "BY", "CU", "AF", "CA", "LY", "RU", "SO", "SS", "SD", "SY"],
+    symbolIdentity: "baseTicker",
+    publicData,
+    spot: null,
+    // Unused (no trading role); the field is required by the definition shape.
+    maxSlippageBps: 1,
+    builderFee: null,
+    apiStatus: { kind: "official" },
+    readOnlyRemediation: GRVT_READ_ONLY_REMEDIATION,
+    // A public-only adapter: market data works, every account / trading method refuses.
+    async create(ctx) {
+        const { GrvtPublicAdapter } = await import("../grvt/adapter.js");
+        return new GrvtPublicAdapter(grvtVenue, ctx.network);
+    },
+};

package/dist/exchanges/venues/hyperliquid.d.ts

@@ -1,7 +1,7 @@
 /**
- * Hyperliquid venue definition (design §10.1, §10.8, §10.13 #4).
+ * Hyperliquid venue definition.
  * HIP-3 dexes are not venues: they are selected via VenueCreateContext.hlDex.
- * Adapter + public-data code are loaded lazily (§10.10).
+ * Adapter + public-data code are loaded lazily.
  */
 import type { Network, VenueDefinition } from "../venue.js";
 /**

package/dist/exchanges/venues/hyperliquid.js

@@ -1,7 +1,7 @@
 /**
- * Hyperliquid venue definition (design §10.1, §10.8, §10.13 #4).
+ * Hyperliquid venue definition.
  * HIP-3 dexes are not venues: they are selected via VenueCreateContext.hlDex.
- * Adapter + public-data code are loaded lazily (§10.10).
+ * Adapter + public-data code are loaded lazily.
  */
 import { BUILDER_FEE_CAPABILITIES } from "../builder-fee.js";
 /**
@@ -26,6 +26,15 @@ const publicData = {
     async fetchMarkets(net) {
         return (await import("../../funding/legacy-public.js")).legacyPublicData("hyperliquid").fetchMarkets(net);
     },
+    // Keyless positions of any account by public address (account positions --address).
+    addressKind: "evm",
+    async fetchPositionsByAddress(net, address) {
+        return (await import("../public-positions.js")).hyperliquidPositionsByAddress(net, address);
+    },
+    // Keyless balances of any account by public address (account balance --address).
+    async fetchBalanceByAddress(net, address) {
+        return (await import("../public-balances.js")).hyperliquidBalanceByAddress(net, address);
+    },
 };
 export const hyperliquidVenue = {
     id: "hyperliquid",
@@ -36,7 +45,7 @@ export const hyperliquidVenue = {
     agentKeyKind: "evm",
     secretStorage: { kind: "ows-wallet", dir: null },
     // REST: src/exchanges/hyperliquid.ts; mainnet WS: src/dashboard/ws-feeds.ts.
-    // Testnet WS is not in code → null. signingChainId: L1 action phantom-agent domain (hyperliquid.ts).
+    // Testnet WS per the HL websocket docs (opened in the 2026-10-13 ws probe). signingChainId: L1 action phantom-agent domain (hyperliquid.ts).
     networks: {
         mainnet: {
             restUrl: "https://api.hyperliquid.xyz",
@@ -51,7 +60,7 @@ export const hyperliquidVenue = {
         },
         testnet: {
             restUrl: "https://api.hyperliquid-testnet.xyz",
-            wsUrl: null,
+            wsUrl: "wss://api.hyperliquid-testnet.xyz/ws",
             explorerUrl: null,
             signingChainId: 1337,
             settlementChain: "hyperliquid",
@@ -65,11 +74,12 @@ export const hyperliquidVenue = {
     settlementIntervalHours: 1,
     fundingVerified: true,
     roles: ["marketData", "account", "trading"],
-    // marketOrder: IOC limit at a protection price (§13.2/§13.10 #5). Declared reference
+    gatedRoles: null,
+    // marketOrder: IOC limit at a protection price. Declared reference
     // price = l2Book mid ((best bid + best ask) / 2) for native perps, HIP-3 and spot —
     // no runtime substitute; a one-sided/empty book → PRICE_STALE. Rounding: 5 significant
     // figures, max 6 − szDecimals (perp) / 8 − szDecimals (spot) decimals, toward crossing.
-    // tpsl stays "separateOrders": HL `normalTpsl` grouping was evaluated (§13.10 #12) and not
+    // tpsl stays "separateOrders": HL `normalTpsl` grouping was evaluated and not
     // used — its children have a fixed size equal to the parent and are fully cancelled when
     // a partially filled parent is cancelled (HL docs, TP/SL orders), so a partially filled
     // IOC entry would be left unprotected; separateOrders sizes TP/SL to the verified fill.
@@ -92,7 +102,7 @@ export const hyperliquidVenue = {
     // HL docs "Rate limits and user limits": REST requests share an aggregated
     // weight of 1200/min per IP. Exchange actions weigh 1 (unbatched); light info
     // requests 2; most info requests 20; userRole 60.
-    // Declared only — per §10.9 the limiter is applied to new venues + lighter-rh.
+    // Declared only — per the limiter is applied to new venues + lighter-rh.
     rateLimit: {
         capacity: 1200,
         refillPerSec: 20,
@@ -104,7 +114,7 @@ export const hyperliquidVenue = {
     restrictedRegions: [],
     symbolIdentity: "baseTicker",
     publicData,
-    // §12: spot USDC is shared with perp margin when the account is unified (isUnifiedAccount, read at init).
+    // spot USDC is shared with perp margin when the account is unified (isUnifiedAccount, read at init).
     spot: {
         accountModel: "runtime",
         quoteAssets: { mainnet: ["USDC"], testnet: ["USDC"] },
@@ -122,5 +132,6 @@ export const hyperliquidVenue = {
     },
     maxSlippageBps: 5000,
     builderFee: BUILDER_FEE_CAPABILITIES["hyperliquid"],
+    apiStatus: { kind: "official" },
     create: async (ctx) => (await import("./create-helpers.js")).createHyperliquid(ctx),
 };

package/dist/exchanges/venues/index.d.ts

@@ -10,7 +10,12 @@ import { lighterVenue } from "./lighter.js";
 import { ondoVenue } from "./ondo.js";
 import { pacificaVenue } from "./pacifica.js";
 import { qfexVenue } from "./qfex.js";
-export declare const ALL_VENUES: readonly [import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition];
+import { risexVenue } from "./risex.js";
+import { txflowVenue } from "./txflow.js";
+import { variationalVenue } from "./variational.js";
+import { grvtVenue } from "./grvt.js";
+import { extendedVenue } from "./extended.js";
+export declare const ALL_VENUES: readonly [import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition, import("../venue.js").VenueDefinition];
 /** Idempotent: registers all venues on first call, no-op afterwards. */
 export declare function ensureVenuesRegistered(): void;
-export { pacificaVenue, hyperliquidVenue, lighterVenue, asterVenue, lighterRhVenue, ondoVenue, arcusVenue, qfexVenue, };
+export { pacificaVenue, hyperliquidVenue, lighterVenue, asterVenue, lighterRhVenue, ondoVenue, arcusVenue, qfexVenue, risexVenue, txflowVenue, variationalVenue, grvtVenue, extendedVenue, };

package/dist/exchanges/venues/index.js

@@ -11,9 +11,15 @@ import { lighterVenue } from "./lighter.js";
 import { ondoVenue } from "./ondo.js";
 import { pacificaVenue } from "./pacifica.js";
 import { qfexVenue } from "./qfex.js";
+import { risexVenue } from "./risex.js";
+import { txflowVenue } from "./txflow.js";
+import { variationalVenue } from "./variational.js";
+import { grvtVenue } from "./grvt.js";
+import { extendedVenue } from "./extended.js";
 export const ALL_VENUES = [
     pacificaVenue, hyperliquidVenue, lighterVenue, asterVenue,
-    lighterRhVenue, ondoVenue, arcusVenue, qfexVenue,
+    lighterRhVenue, ondoVenue, arcusVenue, qfexVenue, risexVenue, txflowVenue, variationalVenue, grvtVenue,
+    extendedVenue,
 ];
 /** Idempotent: registers all venues on first call, no-op afterwards. */
 export function ensureVenuesRegistered() {
@@ -23,4 +29,4 @@ export function ensureVenuesRegistered() {
     }
 }
 ensureVenuesRegistered();
-export { pacificaVenue, hyperliquidVenue, lighterVenue, asterVenue, lighterRhVenue, ondoVenue, arcusVenue, qfexVenue, };
+export { pacificaVenue, hyperliquidVenue, lighterVenue, asterVenue, lighterRhVenue, ondoVenue, arcusVenue, qfexVenue, risexVenue, txflowVenue, variationalVenue, grvtVenue, extendedVenue, };

package/dist/exchanges/venues/lighter-family.d.ts

@@ -1,6 +1,5 @@
 /**
  * Lighter-family constants shared by the `lighter` and `lighter-rh` venues
- * (design §4 "Lighter RH" row, §10.3–§10.5, §10.8, §10.13 #4).
  *
  * Both venues run the same API/engine and the same LighterAdapter class; they
  * differ only in the values below. This module has no runtime imports so venue
@@ -11,8 +10,7 @@ export type LighterVenueId = "lighter" | "lighter-rh";
 /**
  * Lighter (main). REST hosts are the values LighterAdapter used before
  * venue-parameterization. Mainnet WS is the one ws-feeds.ts connects to.
- * Testnet WS is not in code or docs we hold → null (a WS upgrade on
- * wss://testnet.zklighter.elliot.ai/stream answered 101 on 2026-09-30, but that is a probe, not a source).
+ * Testnet WS per apidocs.lighter.xyz websocket-reference (opened in the 2026-10-13 ws probe).
  * explorerUrl is the explorer API host; callers append `/api/...`
  * (lighter-spot.ts uses `${explorerUrl}/api/markets`). The testnet explorer host
  * is the one lighter-ts-sdk documented (`https://testnet.explorer.elliot.ai/api`).
@@ -30,7 +28,8 @@ export declare const LIGHTER_NETWORKS: {
  * explorerUrl is the explorer **API** host (`https://explorerapi.rh.lighter.xyz/api/`,
  * rate-limits.md); no UI explorer URL is documented.
  * Testnet WS is not documented → null (a WS upgrade on
- * wss://api.rh-testnet.lighter.xyz/stream answered 101 on 2026-09-30).
+ * wss://api.rh-testnet.lighter.xyz/stream answered 101 on 2026-09-30, but HTTP 403 from
+ * CloudFront in the 2026-10-13 ws probe).
  * Testnet explorer is not documented → null.
  * rpcUrl (mainnet): Robinhood Chain RPC — the L1 the RH contract lives on
  * (GET /api/v1/layer1BasicInfo l1_providers chainId 4663; eth_chainId 0x1237 verified
@@ -46,22 +45,21 @@ export declare function lighterFamilyNetworks(venue: LighterVenueId): {
     testnet: VenueNetworkConfig;
 };
 /**
- * §10.8 + §10.13 #4 + §13.3. timeInForce lists the CLI inputs the adapter accepts:
+ * timeInForce lists the CLI inputs the adapter accepts:
  * GTC is mapped to GTT (28-day expiry, LIGHTER_GTT_EXPIRY_MS) by LighterAdapter.limitOrder;
  * ALO is sent as time-in-force 2 (POST_ONLY); FOK is not offered.
- * clientOrderId (§13.10 #9): Lighter `clientOrderIndex`, a numeric id — CLI format rule
+ * clientOrderId: Lighter `clientOrderIndex`, a numeric id — CLI format rule
  * in LIGHTER_CLIENT_ORDER_INDEX_MAX / lighterClientOrderIndex() (lighter.ts).
  */
 export declare const LIGHTER_CAPABILITIES: VenueCapabilities;
 /**
  * GTC/GTT (and post-only) resting-order lifetime on both Lighter venues: orderExpiry -1 is
  * resolved to now + 28 days by LighterWasmSigner (the venue allows 5 min – 30 days).
- * Recorded as the execution record's expiry for GTC→GTT (§13.10 #14).
+ * Recorded as the execution record's expiry for GTC→GTT.
  */
 export declare const LIGHTER_GTT_EXPIRY_MS: number;
 /**
- * The ONE declared reference price for slippage-bounded orders on both Lighter venues
- * (§13.10 #5): mid of best bid / best ask from `/api/v1/orderBookOrders`. Replaces
+ * The ONE declared reference price for slippage-bounded orders on both Lighter venues: mid of best bid / best ask from `/api/v1/orderBookOrders`. Replaces
  * orderBookDetails `last_trade_price` (stale on thin RH stock books). No runtime
  * substitute: a missing side → PRICE_STALE before anything is sent.
  */

package/dist/exchanges/venues/lighter-family.js

@@ -1,6 +1,5 @@
 /**
  * Lighter-family constants shared by the `lighter` and `lighter-rh` venues
- * (design §4 "Lighter RH" row, §10.3–§10.5, §10.8, §10.13 #4).
  *
  * Both venues run the same API/engine and the same LighterAdapter class; they
  * differ only in the values below. This module has no runtime imports so venue
@@ -9,8 +8,7 @@
 /**
  * Lighter (main). REST hosts are the values LighterAdapter used before
  * venue-parameterization. Mainnet WS is the one ws-feeds.ts connects to.
- * Testnet WS is not in code or docs we hold → null (a WS upgrade on
- * wss://testnet.zklighter.elliot.ai/stream answered 101 on 2026-09-30, but that is a probe, not a source).
+ * Testnet WS per apidocs.lighter.xyz websocket-reference (opened in the 2026-10-13 ws probe).
  * explorerUrl is the explorer API host; callers append `/api/...`
  * (lighter-spot.ts uses `${explorerUrl}/api/markets`). The testnet explorer host
  * is the one lighter-ts-sdk documented (`https://testnet.explorer.elliot.ai/api`).
@@ -29,7 +27,7 @@ export const LIGHTER_NETWORKS = {
     },
     testnet: {
         restUrl: "https://testnet.zklighter.elliot.ai",
-        wsUrl: null,
+        wsUrl: "wss://testnet.zklighter.elliot.ai/stream",
         explorerUrl: "https://testnet.explorer.elliot.ai",
         signingChainId: 300,
         settlementChain: "ethereum",
@@ -48,7 +46,8 @@ export const LIGHTER_NETWORKS = {
  * explorerUrl is the explorer **API** host (`https://explorerapi.rh.lighter.xyz/api/`,
  * rate-limits.md); no UI explorer URL is documented.
  * Testnet WS is not documented → null (a WS upgrade on
- * wss://api.rh-testnet.lighter.xyz/stream answered 101 on 2026-09-30).
+ * wss://api.rh-testnet.lighter.xyz/stream answered 101 on 2026-09-30, but HTTP 403 from
+ * CloudFront in the 2026-10-13 ws probe).
  * Testnet explorer is not documented → null.
  * rpcUrl (mainnet): Robinhood Chain RPC — the L1 the RH contract lives on
  * (GET /api/v1/layer1BasicInfo l1_providers chainId 4663; eth_chainId 0x1237 verified
@@ -98,17 +97,17 @@ export function lighterFamilyNetworks(venue) {
     }
 }
 /**
- * §10.8 + §10.13 #4 + §13.3. timeInForce lists the CLI inputs the adapter accepts:
+ * timeInForce lists the CLI inputs the adapter accepts:
  * GTC is mapped to GTT (28-day expiry, LIGHTER_GTT_EXPIRY_MS) by LighterAdapter.limitOrder;
  * ALO is sent as time-in-force 2 (POST_ONLY); FOK is not offered.
- * clientOrderId (§13.10 #9): Lighter `clientOrderIndex`, a numeric id — CLI format rule
+ * clientOrderId: Lighter `clientOrderIndex`, a numeric id — CLI format rule
  * in LIGHTER_CLIENT_ORDER_INDEX_MAX / lighterClientOrderIndex() (lighter.ts).
  */
 export const LIGHTER_CAPABILITIES = {
     marketOrder: "slippageBounded",
     // ALO → time-in-force 2 = POST_ONLY (apidocs trading.md; signed by the official lighter-go
     // v1.0.9 WASM). Testnet confirmation that a crossing post-only is cancelled
-    // (canceled-post-only) is still pending (design §11).
+    // (canceled-post-only) is still pending.
     timeInForce: ["GTC", "GTT", "IOC", "ALO"],
     reduceOnlyTif: null,
     clientOrderId: true,
@@ -122,12 +121,11 @@ export const LIGHTER_CAPABILITIES = {
 /**
  * GTC/GTT (and post-only) resting-order lifetime on both Lighter venues: orderExpiry -1 is
  * resolved to now + 28 days by LighterWasmSigner (the venue allows 5 min – 30 days).
- * Recorded as the execution record's expiry for GTC→GTT (§13.10 #14).
+ * Recorded as the execution record's expiry for GTC→GTT.
  */
 export const LIGHTER_GTT_EXPIRY_MS = 28 * 24 * 60 * 60 * 1000;
 /**
- * The ONE declared reference price for slippage-bounded orders on both Lighter venues
- * (§13.10 #5): mid of best bid / best ask from `/api/v1/orderBookOrders`. Replaces
+ * The ONE declared reference price for slippage-bounded orders on both Lighter venues: mid of best bid / best ask from `/api/v1/orderBookOrders`. Replaces
  * orderBookDetails `last_trade_price` (stale on thin RH stock books). No runtime
  * substitute: a missing side → PRICE_STALE before anything is sent.
  */

package/dist/exchanges/venues/lighter-rh.d.ts

@@ -1,7 +1,7 @@
 /**
- * Lighter RH venue definition (design §4 "Lighter RH", §10.1, §10.3, §10.8).
+ * Lighter RH venue definition.
  * Same engine/adapter as Lighter; USDG collateral on the Robinhood chain.
- * Master key = OWS wallet only (no env / raw-PK tier); referral off (§10.3).
+ * Master key = OWS wallet only (no env / raw-PK tier); referral off.
  */
 import type { VenueDefinition } from "../venue.js";
 export declare const lighterRhVenue: VenueDefinition;

package/dist/exchanges/venues/lighter-rh.js

@@ -1,7 +1,7 @@
 /**
- * Lighter RH venue definition (design §4 "Lighter RH", §10.1, §10.3, §10.8).
+ * Lighter RH venue definition.
  * Same engine/adapter as Lighter; USDG collateral on the Robinhood chain.
- * Master key = OWS wallet only (no env / raw-PK tier); referral off (§10.3).
+ * Master key = OWS wallet only (no env / raw-PK tier); referral off.
  */
 import { LIGHTER_RH_CAPABILITIES, LIGHTER_RH_NETWORKS, LIGHTER_RH_RATE_LIMIT } from "./lighter-family.js";
 import { BUILDER_FEE_CAPABILITIES } from "../builder-fee.js";
@@ -9,8 +9,17 @@ const publicData = {
     async fetchFundingRates(net) {
         return (await import("../lighter-public.js")).lighterPublicData("lighter-rh").fetchFundingRates(net);
     },
-    async fetchMarkets(net) {
-        return (await import("../lighter-public.js")).lighterPublicData("lighter-rh").fetchMarkets(net);
+    async fetchMarkets(net, opts) {
+        return (await import("../lighter-public.js")).lighterPublicData("lighter-rh").fetchMarkets(net, opts);
+    },
+    // Keyless positions of any account by public address (account positions --address).
+    addressKind: "evm",
+    async fetchPositionsByAddress(net, address, opts) {
+        return (await import("../public-positions.js")).lighterPositionsByAddress("lighter-rh", net, address, opts);
+    },
+    // Keyless balances of any account by public address (account balance --address).
+    async fetchBalanceByAddress(net, address, opts) {
+        return (await import("../public-balances.js")).lighterBalanceByAddress("lighter-rh", net, address, opts);
     },
 };
 export const lighterRhVenue = {
@@ -22,18 +31,20 @@ export const lighterRhVenue = {
     agentKeyKind: "lighter-l2",
     secretStorage: { kind: "perp-keystore", dir: "lighter-rh-agents" },
     networks: LIGHTER_RH_NETWORKS,
-    // "Lighter RH is the same API/engine as Lighter" → Lighter's basis/interval (§10.1; live-data check pending).
-    fundingRateBasis: { kind: "perHours", hours: 8 },
+    // "Lighter RH is the same API/engine as Lighter" → Lighter's basis/interval (live-data check pending).
+    // The market rows' fundingRate is the settled hourly rate (WS market_stats, lighter-public.ts).
+    fundingRateBasis: { kind: "perHours", hours: 1 },
     settlementIntervalHours: 1,
     fundingVerified: true,
     roles: ["marketData", "account", "trading"],
+    gatedRoles: null,
     capabilities: LIGHTER_RH_CAPABILITIES,
-    // Applied by the rate limiter (§10.9: new venues + lighter-rh).
+    // Applied by the rate limiter (new venues + lighter-rh).
     rateLimit: LIGHTER_RH_RATE_LIMIT,
     restrictedRegions: [],
     symbolIdentity: "baseTicker",
     publicData,
-    // §12: per account (account_trading_mode, read by LighterSpotAdapter.init): Unified (1) shares
+    // per account (account_trading_mode, read by LighterSpotAdapter.init): Unified (1) shares
     // the collateral between spot and perp (no transfer); Classic (0) = separate spot balance +
     // self-transfer of the venue collateral.
     spot: {
@@ -54,5 +65,6 @@ export const lighterRhVenue = {
     },
     maxSlippageBps: 5000,
     builderFee: BUILDER_FEE_CAPABILITIES["lighter-rh"],
+    apiStatus: { kind: "official" },
     create: async (ctx) => (await import("./create-helpers.js")).createLighterFamily("lighter-rh", ctx),
 };

package/dist/exchanges/venues/lighter.d.ts

@@ -1,5 +1,5 @@
 /**
- * Lighter (main) venue definition (design §10.1, §10.8, §10.13 #4).
+ * Lighter (main) venue definition.
  * Shares LighterAdapter and constants with lighter-rh (./lighter-family.ts).
  */
 import type { VenueDefinition } from "../venue.js";