openclaw-looloo 0.1.1

package/README.md

@@ -0,0 +1,77 @@
+# openclaw-looloo
+
+`openclaw-looloo` is the phase 1 OpenClaw plugin for LooLoo.
+
+It lets users:
+
+- discover new internal-market tokens
+- inspect token summaries
+- check current positions
+- fetch buy and sell quotes
+- create website confirmation links for trades
+
+## Phase 1 scope
+
+This package is intentionally limited to the phase 1 workflow:
+
+- `OpenClaw` handles discovery, quote lookup, and trade intent creation
+- `looloo.lol` handles final wallet confirmation
+
+This plugin does **not**:
+
+- sign transactions directly
+- submit onchain trades directly
+- run unattended auto-trading
+- launch new tokens
+
+## Install
+
+```bash
+openclaw plugins install openclaw-looloo
+```
+
+## Configure
+
+Create an automation key from `looloo.lol`:
+
+1. Open `Settings -> OpenClaw`
+2. Create an automation key
+3. Copy the key once when shown
+
+Set the plugin config or environment variables:
+
+```bash
+export LOOLOO_API_BASE="https://looloo.lol"
+export LOOLOO_AUTOMATION_KEY="llak_..."
+```
+
+## Tools
+
+- `discover_new_tokens`
+- `get_token_summary`
+- `get_positions`
+- `quote_trade`
+- `create_trade_intent`
+- `get_automation_profile`
+
+## Example flow
+
+1. Discover or inspect a token from chat.
+2. Ask for a quote.
+3. Create a trade intent.
+4. Open the returned `confirmUrl`.
+5. Confirm the transaction in `looloo.lol` with the user's wallet.
+
+## Example prompts
+
+- `Scan the newest LooLoo internal-market tokens`
+- `Show me a summary for 0xTokenAddress`
+- `Quote a buy of 0.05 ETH for 0xTokenAddress`
+- `Create a trade intent to sell 100000 tokens`
+- `Show my current LooLoo positions`
+
+## Notes
+
+- Phase 1 only supports the `internal` market.
+- Notifications should use the user's existing OpenClaw chat channel.
+- The plugin is an execution helper, not a profit guarantee or autonomous trading bot.

package/openclaw.plugin.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "name": "openclaw-looloo",
+  "displayName": "LooLoo",
+  "version": "0.1.1",
+  "description": "Phase 1 LooLoo plugin for token discovery, quotes, positions, and website trade confirmation links.",
+  "entry": "./src/index.mjs",
+  "skills": [
+    "./skills/looloo-discovery/SKILL.md",
+    "./skills/looloo-trading/SKILL.md"
+  ]
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "openclaw-looloo",
+  "version": "0.1.1",
+  "description": "Phase 1 OpenClaw plugin for LooLoo discovery, quotes, positions, and trade intents.",
+  "type": "module",
+  "main": "./src/index.mjs",
+  "openclaw.extensions": [
+    "./openclaw.plugin.json"
+  ],
+  "files": [
+    "openclaw.plugin.json",
+    "README.md",
+    "src",
+    "skills"
+  ],
+  "scripts": {
+    "lint": "node --check ./src/index.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "openclaw",
+    "looloo",
+    "plugin",
+    "skills",
+    "trading",
+    "automation",
+    "phase-1"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "openclaw-looloo": "file:openclaw-looloo-0.1.1.tgz"
+  }
+}

package/skills/looloo-discovery/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: looloo-discovery
+description: Use this skill when the user wants to discover new LooLoo tokens, inspect token activity, or review current positions from OpenClaw.
+---
+
+# LooLoo Discovery
+
+Use the bundled `openclaw-looloo` plugin tools instead of calling the raw API directly.
+
+## Use this skill for
+
+- scanning new internal-market tokens
+- reviewing one token's recent trades and top holders
+- checking the authenticated wallet's current positions
+
+## Workflow
+
+1. Call `discover_new_tokens` for a market-wide scan.
+2. If the user narrows to one token, call `get_token_summary`.
+3. If the user asks about their wallet, call `get_positions`.
+4. Summarize the strongest signals briefly and keep raw JSON available if needed.
+
+## Notes
+
+- Phase 1 only supports the `internal` market.
+- OpenClaw should return notifications through the user's existing chat channel.
+- Do not imply guaranteed profits; frame results as discovery and execution support.

package/skills/looloo-trading/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: looloo-trading
+description: Use this skill when the user wants a LooLoo trade quote or a website confirmation link for a buy or sell.
+---
+
+# LooLoo Trading
+
+Phase 1 trading is quote-first and wallet-confirmed.
+
+## Use this skill for
+
+- quoting a buy or sell on the LooLoo internal market
+- creating a confirmation link that sends the user back to `looloo.lol`
+
+## Workflow
+
+1. Call `quote_trade` with `tokenAddress`, `side`, and either `amountETH` or `amountToken`.
+2. Show the quote summary and confirm the side and size with the user.
+3. Call `create_trade_intent` only after the user explicitly wants to continue.
+4. Return the `confirmUrl` and explain that the final wallet signature happens on the LooLoo website.
+
+## Notes
+
+- Phase 1 does not support unattended execution.
+- The plugin does not hold keys or sign transactions.
+- If the API rejects an intent, surface the policy error directly because it usually comes from the user's risk settings.

package/src/index.mjs

@@ -0,0 +1,270 @@
+const DEFAULT_API_BASE = "https://looloo.lol";
+
+function getConfig(overrides = {}) {
+  const apiBase = (overrides.apiBase || process.env.LOOLOO_API_BASE || DEFAULT_API_BASE).replace(/\/+$/, "");
+  const apiKey = overrides.apiKey || process.env.LOOLOO_AUTOMATION_KEY || "";
+  if (!apiKey) {
+    throw new Error("LOOLOO_AUTOMATION_KEY is required");
+  }
+  return { apiBase, apiKey };
+}
+
+async function request(path, options = {}, overrides = {}) {
+  const { apiBase, apiKey } = getConfig(overrides);
+  const url = `${apiBase}${path}`;
+  const headers = {
+    Accept: "application/json",
+    Authorization: `Bearer ${apiKey}`,
+    ...options.headers,
+  };
+  if (options.body && !headers["Content-Type"]) {
+    headers["Content-Type"] = "application/json";
+  }
+
+  const response = await fetch(url, {
+    ...options,
+    headers,
+  });
+
+  const raw = await response.text();
+  let data = null;
+  if (raw) {
+    try {
+      data = JSON.parse(raw);
+    } catch (error) {
+      throw new Error(`Unexpected response from ${path}: ${raw}`);
+    }
+  }
+
+  if (!response.ok) {
+    const message =
+      (data && (data.error || data.message || data.details)) ||
+      response.statusText ||
+      `HTTP ${response.status}`;
+    throw new Error(message);
+  }
+
+  return data;
+}
+
+function toQuery(params = {}) {
+  const entries = Object.entries(params).filter(([, value]) => value !== undefined && value !== null && value !== "");
+  if (entries.length === 0) {
+    return "";
+  }
+  const query = new URLSearchParams();
+  for (const [key, value] of entries) {
+    query.set(key, String(value));
+  }
+  return `?${query.toString()}`;
+}
+
+async function discoverNewTokens(input = {}, overrides = {}) {
+  const params = {
+    limit: input.limit,
+    market: input.market || "internal",
+  };
+  return request(`/v1/automation/discover${toQuery(params)}`, { method: "GET" }, overrides);
+}
+
+async function getTokenSummary(input = {}, overrides = {}) {
+  if (!input.tokenAddress) {
+    throw new Error("tokenAddress is required");
+  }
+  return request(`/v1/automation/tokens/${encodeURIComponent(input.tokenAddress)}`, { method: "GET" }, overrides);
+}
+
+async function getPositions(input = {}, overrides = {}) {
+  const params = {
+    limit: input.limit,
+    market: input.market || "internal",
+  };
+  return request(`/v1/automation/positions${toQuery(params)}`, { method: "GET" }, overrides);
+}
+
+async function quoteTrade(input = {}, overrides = {}) {
+  if (!input.tokenAddress) {
+    throw new Error("tokenAddress is required");
+  }
+  if (!input.side) {
+    throw new Error("side is required");
+  }
+  return request(
+    "/v1/automation/trades/quote",
+    {
+      method: "POST",
+      body: JSON.stringify({
+        tokenAddress: input.tokenAddress,
+        side: input.side,
+        amountETH: input.amountETH || "",
+        amountToken: input.amountToken || "",
+      }),
+    },
+    overrides,
+  );
+}
+
+async function createTradeIntent(input = {}, overrides = {}) {
+  if (!input.tokenAddress) {
+    throw new Error("tokenAddress is required");
+  }
+  if (!input.side) {
+    throw new Error("side is required");
+  }
+  return request(
+    "/v1/automation/trade-intents",
+    {
+      method: "POST",
+      body: JSON.stringify({
+        tokenAddress: input.tokenAddress,
+        side: input.side,
+        amountETH: input.amountETH || "",
+        amountToken: input.amountToken || "",
+      }),
+    },
+    overrides,
+  );
+}
+
+async function getAutomationProfile(_input = {}, overrides = {}) {
+  return request("/v1/automation/me", { method: "GET" }, overrides);
+}
+
+function jsonResult(data) {
+  return {
+    content: [
+      {
+        type: "json",
+        json: data,
+      },
+    ],
+  };
+}
+
+export const tools = [
+  {
+    name: "discover_new_tokens",
+    description: "List the newest LooLoo tokens for the internal market.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "integer", minimum: 1, maximum: 100 },
+        market: { type: "string", enum: ["internal"] },
+      },
+    },
+    async run(input, context) {
+      return jsonResult(await discoverNewTokens(input, context?.config));
+    },
+  },
+  {
+    name: "get_token_summary",
+    description: "Fetch one token summary with latest trades and top holders.",
+    inputSchema: {
+      type: "object",
+      required: ["tokenAddress"],
+      properties: {
+        tokenAddress: { type: "string" },
+      },
+    },
+    async run(input, context) {
+      return jsonResult(await getTokenSummary(input, context?.config));
+    },
+  },
+  {
+    name: "get_positions",
+    description: "Fetch the authenticated wallet's current LooLoo positions.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "integer", minimum: 1, maximum: 100 },
+        market: { type: "string", enum: ["internal"] },
+      },
+    },
+    async run(input, context) {
+      return jsonResult(await getPositions(input, context?.config));
+    },
+  },
+  {
+    name: "quote_trade",
+    description: "Get a quote for a buy or sell on the LooLoo internal market.",
+    inputSchema: {
+      type: "object",
+      required: ["tokenAddress", "side"],
+      properties: {
+        tokenAddress: { type: "string" },
+        side: { type: "string", enum: ["buy", "sell"] },
+        amountETH: { type: "string" },
+        amountToken: { type: "string" },
+      },
+    },
+    async run(input, context) {
+      return jsonResult(await quoteTrade(input, context?.config));
+    },
+  },
+  {
+    name: "create_trade_intent",
+    description: "Create a website confirmation link for a quoted trade.",
+    inputSchema: {
+      type: "object",
+      required: ["tokenAddress", "side"],
+      properties: {
+        tokenAddress: { type: "string" },
+        side: { type: "string", enum: ["buy", "sell"] },
+        amountETH: { type: "string" },
+        amountToken: { type: "string" },
+      },
+    },
+    async run(input, context) {
+      return jsonResult(await createTradeIntent(input, context?.config));
+    },
+  },
+  {
+    name: "get_automation_profile",
+    description: "Inspect the active LooLoo automation identity and scopes.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+    },
+    async run(input, context) {
+      return jsonResult(await getAutomationProfile(input, context?.config));
+    },
+  },
+];
+
+export function createPlugin(overrides = {}) {
+  return {
+    name: "openclaw-looloo",
+    configSchema: {
+      type: "object",
+      properties: {
+        apiBase: {
+          type: "string",
+          description: "Base URL for the LooLoo API.",
+          default: DEFAULT_API_BASE,
+        },
+        apiKey: {
+          type: "string",
+          description: "Automation key created from looloo.lol settings.",
+        },
+      },
+      required: ["apiKey"],
+    },
+    tools: tools.map((tool) => ({
+      ...tool,
+      run: (input, context = {}) => tool.run(input, { ...context, config: { ...overrides, ...context.config } }),
+    })),
+  };
+}
+
+export {
+  DEFAULT_API_BASE,
+  createTradeIntent,
+  discoverNewTokens,
+  getAutomationProfile,
+  getPositions,
+  getTokenSummary,
+  quoteTrade,
+  request,
+};
+
+export default createPlugin();