{
  "schemaVersion": "1.0",
  "item": {
    "slug": "lighter",
    "name": "Lighter",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/aviclaw/lighter",
    "canonicalUrl": "https://clawhub.ai/aviclaw/lighter",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/lighter",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=lighter",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "USAGE.md",
      "requirements.txt",
      "scripts/account.py",
      "scripts/get_account_index.py",
      "scripts/markets.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/lighter"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/lighter",
    "agentPageUrl": "https://openagent3.xyz/skills/lighter/agent",
    "manifestUrl": "https://openagent3.xyz/skills/lighter/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/lighter/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Lighter Protocol",
        "body": "Trade on Lighter - a zero-knowledge rollup orderbook DEX with millisecond latency and zero fees."
      },
      {
        "title": "Quick Start (Read-Only)",
        "body": "# Markets are public - no credentials needed\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/orderBooks\""
      },
      {
        "title": "What is Lighter?",
        "body": "Zero fees for retail traders\nMillisecond latency\nZK proofs of all operations\nBacked by Founders Fund, Robinhood, Coinbase Ventures\n\nAPI Endpoint: https://mainnet.zklighter.elliot.ai\nChain ID: 300"
      },
      {
        "title": "Third-Party Dependencies",
        "body": "This skill can work with just requests library for read-only operations. For signing orders, you have two options:\n\nOption A: Minimal (Read-Only)\n\npip install requests\n\nOnly for public data (markets, order books, prices).\n\nOption B: Full Trading\nRequires the official Lighter SDK. Review and verify before installing:\n\nSDK Repository: https://github.com/elliottech/lighter-python\nVerify the repository owner, stars, and code before running any setup"
      },
      {
        "title": "External Code",
        "body": "Only proceed with external SDK if you:\n\nHave reviewed the GitHub repository\nUnderstand what the code does\nUse a dedicated burner wallet, not your main wallet"
      },
      {
        "title": "Environment Variables",
        "body": "VariableRequiredDescriptionWhere to FindLIGHTER_API_KEYFor ordersAPI key from Lighter SDK setupSee \"Getting an API Key\" section belowLIGHTER_ACCOUNT_INDEXFor ordersYour Lighter subaccount index (0-252)See \"Getting Your Account Index\" section belowLIGHTER_L1_ADDRESSOptionalYour ETH address (0x...) used on LighterYour MetaMask/Wallet address"
      },
      {
        "title": "Setting Up Your Credentials",
        "body": "Step 1: Get your L1 Address\n\nThis is your Ethereum address (e.g., 0x1234...abcd)\nUse the same wallet you connect to Lighter dashboard\n\nStep 2: Get your Account Index\n\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/accountsByL1Address?l1_address=YOUR_ETH_ADDRESS\"\n\nResponse returns sub_accounts[].index — that's your account index (typically 0 for main account).\n\nStep 3: Get your API Key\n\nInstall Lighter Python SDK: pip install lighter-python\nFollow the setup guide: https://github.com/elliottech/lighter-python/blob/main/examples/system_setup.py\nThe SDK generates API keys tied to your account\nStore the private key securely — never commit to git\n\nQuick test (read-only, no credentials):\n\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/orderBooks\""
      },
      {
        "title": "Public Endpoints (No Auth)",
        "body": "# List all markets\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/orderBooks\"\n\n# Get order book\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/orderBook?market_id=1\"\n\n# Get recent trades\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/trades?market_id=1\""
      },
      {
        "title": "Authenticated Endpoints",
        "body": "# Account balance (requires API key in header)\ncurl -H \"x-api-key: $LIGHTER_API_KEY\" \\\n  \"https://mainnet.zklighter.elliot.ai/api/v1/account?by=index&value=$LIGHTER_ACCOUNT_INDEX\""
      },
      {
        "title": "Getting Your Account Index",
        "body": "See \"Setting Up Your Credentials\" table above for the quick curl command."
      },
      {
        "title": "Getting an API Key",
        "body": "See \"Setting Up Your Credentials\" table above for the step-by-step guide."
      },
      {
        "title": "Common Issues",
        "body": "\"Restricted jurisdiction\":\n\nLighter has geographic restrictions - ensure compliance with their terms\n\nSDK signing issues:\n\nUse create_market_order() instead of create_order() for more reliable execution"
      },
      {
        "title": "Market IDs",
        "body": "IDSymbol1ETH-USD2BTC-USD3SOL-USD"
      },
      {
        "title": "Links",
        "body": "API: https://mainnet.zklighter.elliot.ai\nDashboard: https://dashboard.zklighter.io\nSDK: https://github.com/elliottech/lighter-python"
      },
      {
        "title": "Additional Examples",
        "body": "See USAGE.md in this skill folder for:\n\nDetailed curl commands for all endpoints\nOrder book and trade queries\nAccount and position checks\nSigned transaction flow (nonce → sign → broadcast)\n\nDisclaimer: Review all external code before running. Use dedicated wallets for trading."
      }
    ],
    "body": "Lighter Protocol\n\nTrade on Lighter - a zero-knowledge rollup orderbook DEX with millisecond latency and zero fees.\n\nQuick Start (Read-Only)\n# Markets are public - no credentials needed\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/orderBooks\"\n\nWhat is Lighter?\nZero fees for retail traders\nMillisecond latency\nZK proofs of all operations\nBacked by Founders Fund, Robinhood, Coinbase Ventures\n\nAPI Endpoint: https://mainnet.zklighter.elliot.ai Chain ID: 300\n\n⚠️ Security Considerations\nThird-Party Dependencies\n\nThis skill can work with just requests library for read-only operations. For signing orders, you have two options:\n\nOption A: Minimal (Read-Only)\n\npip install requests\n\n\nOnly for public data (markets, order books, prices).\n\nOption B: Full Trading Requires the official Lighter SDK. Review and verify before installing:\n\nSDK Repository: https://github.com/elliottech/lighter-python\nVerify the repository owner, stars, and code before running any setup\nExternal Code\n\nOnly proceed with external SDK if you:\n\nHave reviewed the GitHub repository\nUnderstand what the code does\nUse a dedicated burner wallet, not your main wallet\nEnvironment Variables\nVariable\tRequired\tDescription\tWhere to Find\nLIGHTER_API_KEY\tFor orders\tAPI key from Lighter SDK setup\tSee \"Getting an API Key\" section below\nLIGHTER_ACCOUNT_INDEX\tFor orders\tYour Lighter subaccount index (0-252)\tSee \"Getting Your Account Index\" section below\nLIGHTER_L1_ADDRESS\tOptional\tYour ETH address (0x...) used on Lighter\tYour MetaMask/Wallet address\nSetting Up Your Credentials\n\nStep 1: Get your L1 Address\n\nThis is your Ethereum address (e.g., 0x1234...abcd)\nUse the same wallet you connect to Lighter dashboard\n\nStep 2: Get your Account Index\n\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/accountsByL1Address?l1_address=YOUR_ETH_ADDRESS\"\n\n\nResponse returns sub_accounts[].index — that's your account index (typically 0 for main account).\n\nStep 3: Get your API Key\n\nInstall Lighter Python SDK: pip install lighter-python\nFollow the setup guide: https://github.com/elliottech/lighter-python/blob/main/examples/system_setup.py\nThe SDK generates API keys tied to your account\nStore the private key securely — never commit to git\n\nQuick test (read-only, no credentials):\n\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/orderBooks\"\n\nAPI Usage\nPublic Endpoints (No Auth)\n# List all markets\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/orderBooks\"\n\n# Get order book\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/orderBook?market_id=1\"\n\n# Get recent trades\ncurl \"https://mainnet.zklighter.elliot.ai/api/v1/trades?market_id=1\"\n\nAuthenticated Endpoints\n# Account balance (requires API key in header)\ncurl -H \"x-api-key: $LIGHTER_API_KEY\" \\\n  \"https://mainnet.zklighter.elliot.ai/api/v1/account?by=index&value=$LIGHTER_ACCOUNT_INDEX\"\n\nGetting Your Account Index\n\nSee \"Setting Up Your Credentials\" table above for the quick curl command.\n\nGetting an API Key\n\nSee \"Setting Up Your Credentials\" table above for the step-by-step guide.\n\nCommon Issues\n\n\"Restricted jurisdiction\":\n\nLighter has geographic restrictions - ensure compliance with their terms\n\nSDK signing issues:\n\nUse create_market_order() instead of create_order() for more reliable execution\nMarket IDs\nID\tSymbol\n1\tETH-USD\n2\tBTC-USD\n3\tSOL-USD\nLinks\nAPI: https://mainnet.zklighter.elliot.ai\nDashboard: https://dashboard.zklighter.io\nSDK: https://github.com/elliottech/lighter-python\nAdditional Examples\n\nSee USAGE.md in this skill folder for:\n\nDetailed curl commands for all endpoints\nOrder book and trade queries\nAccount and position checks\nSigned transaction flow (nonce → sign → broadcast)\n\nDisclaimer: Review all external code before running. Use dedicated wallets for trading."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/aviclaw/lighter",
    "publisherUrl": "https://clawhub.ai/aviclaw/lighter",
    "owner": "aviclaw",
    "version": "2.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/lighter",
    "downloadUrl": "https://openagent3.xyz/downloads/lighter",
    "agentUrl": "https://openagent3.xyz/skills/lighter/agent",
    "manifestUrl": "https://openagent3.xyz/skills/lighter/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/lighter/agent.md"
  }
}