shll-skills 2.0.6 → 2.0.7

package/SKILL.md

@@ -91,11 +91,23 @@ Show the result, then ask: *"Do you already have a SHLL Agent token-id (a number
 
 ### Step 3: Create agent — YOU do this, not the user
 
-Ask ONE question: *"How many days do you want to rent? (default: 1 day, you can extend later)"*
+**3a.** YOU query available agent templates:
+```bash
+shll-run listings
+```
+
+Show the user a clear list:
+*"Here are the available agents:"*
+
+| # | Name | Type | Price/day | Min days |
+|---|------|------|-----------|----------|
+| 1 | LLM Trader Agent | llm_trader | 0.0005 BNB | 1 |
+
+*"Which one do you want? And how many days? (default: 1 day, can extend later)"*
 
-Then YOU execute immediately (do NOT show the command to the user, just run it):
+**3b.** Once user picks, YOU execute:
 ```bash
-shll-run setup-guide --listing-id <LISTING_ID> --days <DAYS>
+shll-run setup-guide --listing-id <SELECTED_ID> --days <DAYS>
 ```
 
 Take the `setupUrl` from the JSON output and tell the user:
@@ -142,7 +154,8 @@ Examples:
 |---------|-------------|
 | `shll-run generate-wallet` | Create a new operator wallet (address + private key) |
 | `shll-run balance` | Check operator wallet BNB balance |
-| `shll-run setup-guide -l <LISTING> -d <DAYS>` | Output setup instructions + shll.run link for secure onboarding |
+| `shll-run listings` | List all available agent templates (name, type, price) |
+| `shll-run setup-guide [-l <LISTING>] [-d <DAYS>]` | Output setup link for onboarding (defaults: auto listing-id, 1 day) |
 | ~~`shll-run init`~~ | **DEPRECATED** — insecure single-wallet mode |
 
 ### Trading

package/dist/index.js

@@ -507,6 +507,7 @@ var DEFAULT_NFA = "0xe98dcdbf370d7b52c9a2b88f79bef514a5375a2b";
 var DEFAULT_GUARD = "0x25d17ea0e3bcb8ca08a2bfe917e817afc05dbbb3";
 var DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
 var DEFAULT_LISTING_MANAGER = "0x322E7b1DaefE32E3D25defEA731C6384425E5A9f";
+var DEFAULT_LISTING_ID = "0x792d9b08749fd9739b7e57217daa08a673042fe9e1e1c35545e99acb72c12186";
 var PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
 var WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
 var TOKEN_REGISTRY = {
@@ -1466,7 +1467,42 @@ configCmd.action(async (opts) => {
     process.exit(1);
   }
 });
-var setupGuideCmd = new import_commander.Command("setup-guide").description("Output step-by-step instructions for secure dual-wallet agent setup").requiredOption("-l, --listing-id <bytes32>", "Template listing ID (bytes32 hex)").requiredOption("-d, --days <number>", "Number of days to rent").option("-r, --rpc <url>", "BSC RPC URL", DEFAULT_RPC).option("--listing-manager <address>", "ListingManagerV2 address", DEFAULT_LISTING_MANAGER).option("--nfa-address <address>", "AgentNFA contract address", DEFAULT_NFA);
+var DEFAULT_INDEXER = "https://indexer.shll.run";
+var listingsCmd = new import_commander.Command("listings").description("List all available agent templates for rent").option("--indexer <url>", "Indexer API URL", DEFAULT_INDEXER).action(async (opts) => {
+  try {
+    const indexerUrl = opts.indexer || DEFAULT_INDEXER;
+    const res = await fetch(`${indexerUrl}/api/listings`);
+    if (!res.ok) {
+      output({ status: "error", message: `Indexer returned ${res.status}` });
+      process.exit(1);
+    }
+    const data = await res.json();
+    const available = data.items.filter((l) => l.active);
+    if (available.length === 0) {
+      output({ status: "success", message: "No active listings found.", listings: [] });
+      return;
+    }
+    const listings = available.map((l) => ({
+      listingId: l.id,
+      name: l.agentName || "Unnamed Agent",
+      type: l.agentType || "unknown",
+      pricePerDayBNB: (Number(l.pricePerDay) / 1e18).toFixed(6),
+      minDays: l.minDays,
+      nfa: l.nfa
+    }));
+    output({
+      status: "success",
+      count: listings.length,
+      listings,
+      hint: "Use the listingId with setup-guide: shll-run setup-guide --listing-id <ID> --days <N>"
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    output({ status: "error", message });
+    process.exit(1);
+  }
+});
+var setupGuideCmd = new import_commander.Command("setup-guide").description("Output step-by-step instructions for secure dual-wallet agent setup").option("-l, --listing-id <bytes32>", "Template listing ID (bytes32 hex)", DEFAULT_LISTING_ID).option("-d, --days <number>", "Number of days to rent", "1").option("-r, --rpc <url>", "BSC RPC URL", DEFAULT_RPC).option("--listing-manager <address>", "ListingManagerV2 address", DEFAULT_LISTING_MANAGER).option("--nfa-address <address>", "AgentNFA contract address", DEFAULT_NFA);
 setupGuideCmd.action(async (opts) => {
   try {
     const pk = process.env.RUNNER_PRIVATE_KEY;
@@ -1626,6 +1662,7 @@ program.addCommand(transferCmd);
 program.addCommand(policiesCmd);
 program.addCommand(configCmd);
 program.addCommand(setupGuideCmd);
+program.addCommand(listingsCmd);
 program.addCommand(genWalletCmd);
 program.addCommand(balanceCmd);
 program.parse(process.argv);

package/dist/index.mjs

@@ -517,6 +517,7 @@ var DEFAULT_NFA = "0xe98dcdbf370d7b52c9a2b88f79bef514a5375a2b";
 var DEFAULT_GUARD = "0x25d17ea0e3bcb8ca08a2bfe917e817afc05dbbb3";
 var DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
 var DEFAULT_LISTING_MANAGER = "0x322E7b1DaefE32E3D25defEA731C6384425E5A9f";
+var DEFAULT_LISTING_ID = "0x792d9b08749fd9739b7e57217daa08a673042fe9e1e1c35545e99acb72c12186";
 var PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
 var WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
 var TOKEN_REGISTRY = {
@@ -1476,7 +1477,42 @@ configCmd.action(async (opts) => {
     process.exit(1);
   }
 });
-var setupGuideCmd = new Command("setup-guide").description("Output step-by-step instructions for secure dual-wallet agent setup").requiredOption("-l, --listing-id <bytes32>", "Template listing ID (bytes32 hex)").requiredOption("-d, --days <number>", "Number of days to rent").option("-r, --rpc <url>", "BSC RPC URL", DEFAULT_RPC).option("--listing-manager <address>", "ListingManagerV2 address", DEFAULT_LISTING_MANAGER).option("--nfa-address <address>", "AgentNFA contract address", DEFAULT_NFA);
+var DEFAULT_INDEXER = "https://indexer.shll.run";
+var listingsCmd = new Command("listings").description("List all available agent templates for rent").option("--indexer <url>", "Indexer API URL", DEFAULT_INDEXER).action(async (opts) => {
+  try {
+    const indexerUrl = opts.indexer || DEFAULT_INDEXER;
+    const res = await fetch(`${indexerUrl}/api/listings`);
+    if (!res.ok) {
+      output({ status: "error", message: `Indexer returned ${res.status}` });
+      process.exit(1);
+    }
+    const data = await res.json();
+    const available = data.items.filter((l) => l.active);
+    if (available.length === 0) {
+      output({ status: "success", message: "No active listings found.", listings: [] });
+      return;
+    }
+    const listings = available.map((l) => ({
+      listingId: l.id,
+      name: l.agentName || "Unnamed Agent",
+      type: l.agentType || "unknown",
+      pricePerDayBNB: (Number(l.pricePerDay) / 1e18).toFixed(6),
+      minDays: l.minDays,
+      nfa: l.nfa
+    }));
+    output({
+      status: "success",
+      count: listings.length,
+      listings,
+      hint: "Use the listingId with setup-guide: shll-run setup-guide --listing-id <ID> --days <N>"
+    });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown error";
+    output({ status: "error", message });
+    process.exit(1);
+  }
+});
+var setupGuideCmd = new Command("setup-guide").description("Output step-by-step instructions for secure dual-wallet agent setup").option("-l, --listing-id <bytes32>", "Template listing ID (bytes32 hex)", DEFAULT_LISTING_ID).option("-d, --days <number>", "Number of days to rent", "1").option("-r, --rpc <url>", "BSC RPC URL", DEFAULT_RPC).option("--listing-manager <address>", "ListingManagerV2 address", DEFAULT_LISTING_MANAGER).option("--nfa-address <address>", "AgentNFA contract address", DEFAULT_NFA);
 setupGuideCmd.action(async (opts) => {
   try {
     const pk = process.env.RUNNER_PRIVATE_KEY;
@@ -1636,6 +1672,7 @@ program.addCommand(transferCmd);
 program.addCommand(policiesCmd);
 program.addCommand(configCmd);
 program.addCommand(setupGuideCmd);
+program.addCommand(listingsCmd);
 program.addCommand(genWalletCmd);
 program.addCommand(balanceCmd);
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "shll-skills",
-    "version": "2.0.6",
+    "version": "2.0.7",
     "description": "SHLL Agent Runtime Skill for OpenClaw",
     "main": "dist/index.js",
     "bin": {

package/src/index.ts

@@ -20,6 +20,7 @@ const DEFAULT_NFA = "0xe98dcdbf370d7b52c9a2b88f79bef514a5375a2b";
 const DEFAULT_GUARD = "0x25d17ea0e3bcb8ca08a2bfe917e817afc05dbbb3";
 const DEFAULT_RPC = "https://bsc-dataseed1.binance.org";
 const DEFAULT_LISTING_MANAGER = "0x322E7b1DaefE32E3D25defEA731C6384425E5A9f";
+const DEFAULT_LISTING_ID = "0x792d9b08749fd9739b7e57217daa08a673042fe9e1e1c35545e99acb72c12186";
 const PANCAKE_V2_ROUTER = "0x10ED43C718714eb63d5aA57B78B54704E256024E";
 const WBNB = "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
 
@@ -1240,11 +1241,68 @@ configCmd.action(async (opts) => {
     }
 });
 
+// -- Subcommand: listings (query available agent templates) --------
+const DEFAULT_INDEXER = "https://indexer.shll.run";
+
+const listingsCmd = new Command("listings")
+    .description("List all available agent templates for rent")
+    .option("--indexer <url>", "Indexer API URL", DEFAULT_INDEXER)
+    .action(async (opts) => {
+        try {
+            const indexerUrl = opts.indexer || DEFAULT_INDEXER;
+            const res = await fetch(`${indexerUrl}/api/listings`);
+            if (!res.ok) {
+                output({ status: "error", message: `Indexer returned ${res.status}` });
+                process.exit(1);
+            }
+            const data = await res.json() as {
+                items: Array<{
+                    id: string;
+                    agentName: string;
+                    agentType: string;
+                    pricePerDay: string;
+                    minDays: number;
+                    active: boolean;
+                    nfa: string;
+                    tokenId: string;
+                    owner: string;
+                }>;
+                count: number;
+            };
+
+            const available = data.items.filter((l) => l.active);
+            if (available.length === 0) {
+                output({ status: "success", message: "No active listings found.", listings: [] });
+                return;
+            }
+
+            const listings = available.map((l) => ({
+                listingId: l.id,
+                name: l.agentName || "Unnamed Agent",
+                type: l.agentType || "unknown",
+                pricePerDayBNB: (Number(l.pricePerDay) / 1e18).toFixed(6),
+                minDays: l.minDays,
+                nfa: l.nfa,
+            }));
+
+            output({
+                status: "success",
+                count: listings.length,
+                listings,
+                hint: "Use the listingId with setup-guide: shll-run setup-guide --listing-id <ID> --days <N>",
+            });
+        } catch (error: unknown) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            output({ status: "error", message });
+            process.exit(1);
+        }
+    });
+
 // -- Subcommand: setup-guide (secure dual-wallet onboarding) ------
 const setupGuideCmd = new Command("setup-guide")
     .description("Output step-by-step instructions for secure dual-wallet agent setup")
-    .requiredOption("-l, --listing-id <bytes32>", "Template listing ID (bytes32 hex)")
-    .requiredOption("-d, --days <number>", "Number of days to rent")
+    .option("-l, --listing-id <bytes32>", "Template listing ID (bytes32 hex)", DEFAULT_LISTING_ID)
+    .option("-d, --days <number>", "Number of days to rent", "1")
     .option("-r, --rpc <url>", "BSC RPC URL", DEFAULT_RPC)
     .option("--listing-manager <address>", "ListingManagerV2 address", DEFAULT_LISTING_MANAGER)
     .option("--nfa-address <address>", "AgentNFA contract address", DEFAULT_NFA);
@@ -1433,6 +1491,7 @@ program.addCommand(transferCmd);
 program.addCommand(policiesCmd);
 program.addCommand(configCmd);
 program.addCommand(setupGuideCmd);
+program.addCommand(listingsCmd);
 program.addCommand(genWalletCmd);
 program.addCommand(balanceCmd);
 program.parse(process.argv);