@goplausible/openclaw-algorand-plugin 1.8.0 → 1.8.2

package/README.md

@@ -26,7 +26,7 @@
 openclaw plugins install @goplausible/openclaw-algorand-plugin
 ```
 
-Or install from local path:
+Or install from local path if you are running from source code:
 
 ```bash
 openclaw plugins install ./path/to/openclaw-algorand-plugin
@@ -37,21 +37,17 @@ openclaw plugins install ./path/to/openclaw-algorand-plugin
 After installing, run these commands:
 
 ```bash
-# 1. Initialize plugin (write memory file + configure mcporter)
-openclaw algorand-plugin init
-
-# 2. Run interactive setup (keyring persistence + x402 toggle)
+# 1. Setup plugin (memory file + mcporter + interactive config)
 openclaw algorand-plugin setup
 
-# 3. Restart the gateway
+# 2. Restart the gateway
 openclaw gateway restart
 ```
 
 ## Commands
 
 ```bash
-openclaw algorand-plugin init        # Write plugin memory + configure mcporter
-openclaw algorand-plugin setup       # Run interactive setup wizard
+openclaw algorand-plugin setup       # Initialize + configure plugin (memory, mcporter, options)
 openclaw algorand-plugin status      # Show plugin status (binary, mcporter, config)
 openclaw algorand-plugin mcp-config  # Show MCP config snippet for external coding agents
 ```

package/index.ts

@@ -92,6 +92,42 @@ function updatePluginConfig(newConfig: AlgorandPluginConfig): { success: boolean
   }
 }
 
+function stopExistingMcpProcesses(): { stopped: number; message: string } {
+  try {
+    // Find all running algorand-mcp processes
+    const psOutput = execSync("ps aux 2>/dev/null || tasklist 2>/dev/null || echo ''", { encoding: "utf-8" });
+    const lines = psOutput.split("\n").filter((line: string) => line.includes("algorand-mcp") && !line.includes("grep"));
+
+    if (lines.length === 0) {
+      return { stopped: 0, message: "No existing algorand-mcp processes found" };
+    }
+
+    // Extract PIDs and kill them
+    let stopped = 0;
+    for (const line of lines) {
+      const parts = line.trim().split(/\s+/);
+      const pid = parts[1]; // PID is second column in ps aux
+      if (pid && /^\d+$/.test(pid)) {
+        try {
+          execSync(`kill ${pid} 2>/dev/null`, { encoding: "utf-8" });
+          stopped++;
+        } catch {
+          // Process may have already exited
+        }
+      }
+    }
+
+    // Brief wait for processes to terminate
+    if (stopped > 0) {
+      execSync("sleep 1");
+    }
+
+    return { stopped, message: `Stopped ${stopped} existing algorand-mcp process${stopped !== 1 ? "es" : ""}` };
+  } catch {
+    return { stopped: 0, message: "Could not check for existing processes" };
+  }
+}
+
 function configureMcporter(): { success: boolean; message: string } {
   const mcpCommand = getMcpBinaryPath();
 
@@ -221,12 +257,12 @@ export default function register(api: PluginApi) {
         .command("algorand-plugin")
         .description("Algorand blockchain integration (GoPlausible)");
 
-      // Init command - writes plugin memory file AND configures mcporter
+      // Setup command - initializes (memory + mcporter) then runs interactive config
       algorand
-        .command("init")
-        .description("Initialize Algorand plugin (memory file + mcporter config)")
+        .command("setup")
+        .description("Initialize and configure Algorand plugin")
         .action(async () => {
-          console.log("\n🔷 Initializing Algorand plugin...\n");
+          console.log("\n🔷 Setting up Algorand plugin...\n");
 
           const workspacePath = getWorkspacePath(api);
 
@@ -238,7 +274,15 @@ export default function register(api: PluginApi) {
             console.error(`  ❌ ${memResult.message}`);
           }
 
-          // Step 2: Configure mcporter
+          // Step 2: Stop any existing algorand-mcp processes
+          const stopResult = stopExistingMcpProcesses();
+          if (stopResult.stopped > 0) {
+            console.log(`  ✅ ${stopResult.message}`);
+          } else {
+            console.log(`  ℹ️  ${stopResult.message}`);
+          }
+
+          // Step 3: Configure mcporter
           console.log("");
           const mcpResult = configureMcporter();
           if (mcpResult.success) {
@@ -247,15 +291,8 @@ export default function register(api: PluginApi) {
             console.log(`  ⚠️  ${mcpResult.message}`);
           }
 
-          console.log("\n  Run `openclaw algorand-plugin setup` to configure options.");
-          console.log("  Run `mcporter list algorand-mcp --schema` to verify MCP tools.\n");
-        });
-
-      // Setup wizard
-      algorand
-        .command("setup")
-        .description("Run interactive Algorand plugin setup")
-        .action(async () => {
+          // Step 4: Interactive config
+          console.log("");
           const newConfig = await runSetup(pluginConfig);
           if (newConfig) {
             const result = updatePluginConfig(newConfig);
@@ -269,6 +306,8 @@ export default function register(api: PluginApi) {
               console.log(`   "plugins": { "allow": ["${PLUGIN_ID}"], "entries": { "${PLUGIN_ID}": { "config": ${JSON.stringify(newConfig)} } } }\n`);
             }
           }
+
+          console.log("  Run `mcporter list algorand-mcp --schema` to verify MCP tools.\n");
         });
 
       // Status command
@@ -296,7 +335,7 @@ export default function register(api: PluginApi) {
           console.log("");
           console.log("  MCP Server:");
           console.log(`    Binary:    ${mcp.available ? `✅ ${mcp.path}` : "⚠️  Not found"}`);
-          console.log(`    mcporter:  ${mcporterConfigured ? "✅ Configured" : "⚠️  Not configured (run init)"}`);
+          console.log(`    mcporter:  ${mcporterConfigured ? "✅ Configured" : "⚠️  Not configured (run setup)"}`);
           console.log("");
           console.log("  Config:");
           console.log(`    x402:      ${pluginConfig.enableX402 !== false ? "Enabled" : "Disabled"}`);
@@ -353,7 +392,7 @@ export default function register(api: PluginApi) {
           console.log(`    }`);
           console.log(`  }\n`);
           console.log("  Cursor (.cursor/mcp.json) — same format\n");
-          console.log("  Note: OpenClaw uses mcporter. Run `openclaw algorand-plugin init` to configure.\n");
+          console.log("  Note: OpenClaw uses mcporter. Run `openclaw algorand-plugin setup` to configure.\n");
         });
     },
     { commands: ["algorand-plugin"] }
@@ -380,9 +419,8 @@ export default function register(api: PluginApi) {
       } catch { /* ignore on install */ }
 
       console.log("   Next steps:");
-      console.log("   1. Run `openclaw algorand-plugin init` — configure mcporter + add plugin memory");
-      console.log("   2. Run `openclaw algorand-plugin setup` — configure options & add to allow list");
-      console.log("   3. Restart OpenClaw gateway\n");
+      console.log("   1. Run `openclaw algorand-plugin setup` — initialize + configure plugin");
+      console.log("   2. Restart OpenClaw gateway\n");
       console.log(`   Docs: ${GOPLAUSIBLE_SERVICES.website}\n`);
     },
     { name: "algorand.post-install", description: "Show setup instructions on install" }

package/memory/algorand-plugin.md

@@ -1,10 +1,12 @@
 # Algorand Plugin Guide
 
-This plugin enables three core capabilities:
+This plugin enables four core capabilities:
 
 1. **Algorand Development** — Smart contracts, typed clients, React frontends via AlgoKit CLI and skills
-2. **Blockchain Interaction** — Algorand MCP server (107 tools) via mcporter
+2. **Blockchain Interaction** — Algorand MCP server (107 tools) via mcporter (includes Pera asset verification)
 3. **x402 Payment Protocol** — HTTP-native payments with Algorand as first-class chain
+4. **Haystack Router** — DEX aggregator/smart order routing on Algorand (Tinyman V2, Pact, Folks)
+5. **Alpha Arcade** — On-chain prediction markets on Algorand (USDC-denominated, binary/multi-choice)
 
 ## Skill Routing
 
@@ -16,6 +18,10 @@ This plugin enables three core capabilities:
 | Interaction | Blockchain interaction via MCP | `algorand-interaction` |
 | x402 | TypeScript x402 development | `algorand-x402-typescript` |
 | x402 | Python x402 development | `algorand-x402-python` |
+| x402 | Runtime x402 payment (Claude as client) | `algorand-x402-payment` |
+| Haystack | Build swap apps with SDK | `haystack-router-development` |
+| Haystack | Execute swaps via MCP tools | `haystack-router-interaction` |
+| Alpha Arcade | Prediction markets via MCP tools | `alpha-arcade-interaction` |
 
 ## Using Algorand MCP Tools
 
@@ -31,7 +37,7 @@ mcporter call algorand-mcp.get_account_info address=XXXXX network=testnet
 mcporter call algorand-mcp.search_assets name=USDC network=mainnet
 ```
 
-## MCP Tool Categories (101 tools)
+## MCP Tool Categories (107 tools)
 
 - **Wallet** (10) — `wallet_add_account`, `wallet_remove_account`, `wallet_list_accounts`, `wallet_switch_account`, `wallet_get_info`, `wallet_get_assets`, `wallet_sign_transaction`, `wallet_sign_transaction_group`, `wallet_sign_data`, `wallet_optin_asset`
 - **Account Management** (8) — `create_account`, `rekey_account`, `mnemonic_to_mdk`, `mdk_to_mnemonic`, `secret_key_to_mnemonic`, `mnemonic_to_secret_key`, `seed_from_mnemonic`, `mnemonic_from_seed`
@@ -42,9 +48,37 @@ mcporter call algorand-mcp.search_assets name=USDC network=mainnet
 - **Indexer API** (17) — `api_indexer_lookup_account_by_id`, `api_indexer_lookup_account_assets`, `api_indexer_lookup_account_app_local_states`, `api_indexer_lookup_account_created_applications`, `api_indexer_search_for_accounts`, `api_indexer_lookup_applications`, `api_indexer_lookup_application_logs`, `api_indexer_search_for_applications`, `api_indexer_lookup_application_box`, `api_indexer_lookup_application_boxes`, `api_indexer_lookup_asset_by_id`, `api_indexer_lookup_asset_balances`, `api_indexer_lookup_asset_transactions`, `api_indexer_search_for_assets`, `api_indexer_lookup_transaction_by_id`, `api_indexer_lookup_account_transactions`, `api_indexer_search_for_transactions`
 - **NFDomains** (6) — `api_nfd_get_nfd`, `api_nfd_get_nfds_for_addresses`, `api_nfd_get_nfd_activity`, `api_nfd_get_nfd_analytics`, `api_nfd_browse_nfds`, `api_nfd_search_nfds`
 - **Tinyman AMM** (9) — `api_tinyman_get_pool`, `api_tinyman_get_pool_analytics`, `api_tinyman_get_pool_creation_quote`, `api_tinyman_get_liquidity_quote`, `api_tinyman_get_remove_liquidity_quote`, `api_tinyman_get_swap_quote`, `api_tinyman_get_asset_optin_quote`, `api_tinyman_get_validator_optin_quote`, `api_tinyman_get_validator_optout_quote`
-- **ARC-26 URI** (1) — `generate_algorand_uri`
+- **Haystack Router** (3) — `api_haystack_get_swap_quote`, `api_haystack_execute_swap`, `api_haystack_needs_optin`
+- **Pera Asset Verification** (3) — `api_pera_asset_verification_status`, `api_pera_verified_asset_details`, `api_pera_verified_asset_search`
+- **Alpha Arcade** (15) — Read: `alpha_get_live_markets`, `alpha_get_reward_markets`, `alpha_get_market`, `alpha_get_orderbook`, `alpha_get_open_orders`, `alpha_get_positions`. Trade: `alpha_create_limit_order`, `alpha_create_market_order`, `alpha_cancel_order`, `alpha_amend_order`, `alpha_propose_match`, `alpha_split_shares`, `alpha_merge_shares`, `alpha_claim`
+- **ARC-26 URI** (1) — `generate_algorand_qrcode`
 - **Knowledge** (1) — `get_knowledge_doc` (categories: `arcs`, `sdks`, `algokit`, `algokit-utils`, `tealscript`, `puya`, `liquid-auth`, `python`, `developers`, `clis`, `nodes`, `details`)
 
+## QR Code Display (ARC-26 URI)
+
+When generating QR codes with `generate_algorand_qrcode`, the tool returns:
+- UTF-8 text QR code (terminal-friendly)
+- PNG image as base64 (web-friendly)
+- URI string
+
+**Important:** MCP tool output may not render properly through mcporter → exec pipeline.
+After calling the tool, **extract and paste the QR code directly in your response**:
+
+1. Call the tool and capture output
+2. Extract the UTF-8 QR block (Unicode block characters)
+3. Extract the base64 PNG data
+4. Include both in your reply:
+
+```
+[paste UTF-8 QR here]
+```
+
+![QR Code](data:image/png;base64,[paste base64 here])
+
+URI: `algorand://ADDRESS?amount=X&asset=Y`
+
+This ensures the QR renders correctly in both terminal and web interfaces.
+
 ## Key things to remember
 
 - Always check wallet with `wallet_get_info` before blockchain operations
@@ -70,6 +104,7 @@ mcporter call algorand-mcp.search_assets name=USDC network=mainnet
 - **NEVER use PyTEAL or Beaker** — these are legacy. Use Algorand TypeScript or Algorand Python.
 - **NEVER use AlgoExplorer** — obsolete. Use Allo.info for block/account/transaction data.
 - **NFD (.algo names)**: Always use `depositAccount` field for transactions.
+- **Alpha Arcade prices are microunits**: `yesProb`/`noProb` range 0–1,000,000 (NOT percentages). $0.50 = 500,000. Orders require both ALGO (MBR) and USDC (collateral).
 
 ## External resources
 
@@ -81,9 +116,12 @@ mcporter call algorand-mcp.search_assets name=USDC network=mainnet
 - Testnet Faucet: https://lora.algokit.io/testnet/fund
 - Testnet USDC Faucet: https://faucet.circle.com/
 - Algorand Developer Docs: https://dev.algorand.co/
-- Algorand Developer Docs Github : https://github.com/algorandfoundation/devportal
-- Algorand Developer Examples Github : https://github.com/algorandfoundation/devportal-code-examples
-- GoPlausible x402-avm Documentation and Example code : https://github.com/GoPlausible/.github/blob/main/profile/algorand-x402-documentation/README.md
-- GoPlausible x402-avm Examples template Projects : https://github.com/GoPlausible/x402-avm/tree/branch-v2-algorand-publish/examples/
-- CAIP-2 Specification : https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md
-- Coinbase x402 Protocol : https://github.com/coinbase/x402
+- Algorand Developer Docs Github: https://github.com/algorandfoundation/devportal
+- Algorand Developer Examples Github: https://github.com/algorandfoundation/devportal-code-examples
+- GoPlausible x402-avm Documentation and Example code: https://github.com/GoPlausible/.github/blob/main/profile/algorand-x402-documentation/README.md
+- GoPlausible x402-avm Examples template Projects: https://github.com/GoPlausible/x402-avm/tree/branch-v2-algorand-publish/examples/
+- CAIP-2 Specification: https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md
+- Coinbase x402 Protocol: https://github.com/coinbase/x402
+- Haystack Router: https://github.com/TxnLab/haystack-router
+- Alpha Arcade: https://alphaarcade.com
+- Alpha Arcade API: https://platform.alphaarcade.com

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-algorand-plugin",
   "name": "Algorand Integration",
   "description": "Algorand blockchain integration with MCP and skills — by GoPlausible",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "skills": [
     "skills/algorand-development",
     "skills/algorand-typescript",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goplausible/openclaw-algorand-plugin",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "publishConfig": {
     "access": "public"
   },

package/skills/algorand-interaction/SKILL.md

@@ -43,8 +43,8 @@ Key points:
 
 1. **Check wallet**: `wallet_get_info` with target `network` — verify an account exists and is active
 2. **If no accounts**: Guide user to create one with `wallet_add_account` (sets nickname and spending limits)
-3. **If needs funding**: Generate ARC-26 QR with `generate_algorand_uri` or direct to testnet faucet: https://lora.algokit.io/testnet/fund
-4. **If needs USDC funding**: Generate ARC-26 QR with `generate_algorand_uri` or direct to testnet faucet: https://faucet.circle.com/
+3. **If needs funding**: Generate ARC-26 QR with `generate_algorand_qrcode` or direct to testnet faucet: https://lora.algokit.io/testnet/fund
+4. **If needs USDC funding**: Generate ARC-26 QR with `generate_algorand_qrcode` or direct to testnet faucet: https://faucet.circle.com/
 5. **Confirm network**: Always confirm which network (`mainnet`, `testnet`, `localnet`) before transactions
 
 ## Network Selection
@@ -164,7 +164,7 @@ For atomic (all-or-nothing) multi-transaction groups:
 
 **Pera Asset Verification** (3): `api_pera_asset_verification_status`, `api_pera_verified_asset_details`, `api_pera_verified_asset_search` — mainnet asset verification (verified/trusted/suspicious/unverified), detailed asset info with USD value, and search by name/keyword
 
-**ARC-26 URI** (1): `generate_algorand_uri`
+**ARC-26 URI** (1): `generate_algorand_qrcode`
 
 **Knowledge Base** (1): `get_knowledge_doc`
 
@@ -209,6 +209,31 @@ All prices and quantities use **microunits** (1,000,000 = $1.00 or 1 share). Ord
 
 > For detailed Alpha Arcade workflows (orderbook mechanics, multi-choice markets, split/merge shares, claiming, collateral model), load the `alpha-arcade-interaction` skill.
 
+## QR Code Display (ARC-26 URI)
+
+When generating QR codes with `generate_algorand_qrcode`, the tool returns:
+- UTF-8 text QR code (terminal-friendly)
+- PNG image as base64 (web-friendly)
+- URI string
+
+**Important:** MCP tool output may not render properly through mcporter → exec pipeline.
+After calling the tool, **extract and paste the QR code directly in your response**:
+
+1. Call the tool and capture output
+2. Extract the UTF-8 QR block (Unicode block characters)
+3. Extract the base64 PNG data
+4. Include both in your reply:
+
+```
+[paste UTF-8 QR here]
+```
+
+![QR Code](data:image/png;base64,[paste base64 here])
+
+URI: `algorand://ADDRESS?amount=X&asset=Y`
+
+This ensures the QR renders correctly in both terminal and web interfaces.
+
 ## References
 
 For detailed tool documentation:

package/skills/algorand-interaction/references/algorand-mcp.md

@@ -782,20 +782,40 @@ Mainnet asset verification via Pera Wallet API. Use to check if assets are legit
 
 ## ARC-26 URI Tools
 
-### generate_algorand_uri
-- **Purpose**: Generate an Algorand payment URI and QR code per ARC-26 specification
+### generate_algorand_qrcode
+- **Purpose**: Generate an Algorand top up payment or asset transferURI and QR code per ARC-26 specification
 - **Parameters**:
 ```json
 {
   "address": "receiver_address",
   "label": "Payment label",
   "amount": 1000000,
-  "asset": 31566704,
+  "asset": 31566704,// optional, if asset transfer; omit or set to 0 for ALGO
   "note": "Payment note",
-  "xnote": "Exclusive note"
+  "xnote": "Exclusive immutable note"
 }
 ```
-- **Returns**: URI string + SVG QR code
+- **Returns**: UTF-8 text QR code (terminal-friendly), PNG image as base64 (web-friendly), URI string
+
+### QR Code Display
+
+**Important:** MCP tool output may not render properly through mcporter → exec pipeline.
+After calling the tool, **extract and paste the QR code directly in your response**:
+
+1. Call the tool and capture output
+2. Extract the UTF-8 QR block (Unicode block characters)
+3. Extract the base64 PNG data
+4. Include both in your reply:
+
+```
+[paste UTF-8 QR here]
+```
+
+![QR Code](data:image/png;base64,[paste base64 here])
+
+URI: `algorand://ADDRESS?amount=X&asset=Y`
+
+This ensures the QR renders correctly in both terminal and web interfaces.
 
 ---
 

package/skills/algorand-interaction/references/examples-algorand-mcp.md

@@ -23,7 +23,7 @@ wallet_add_account {
 
 ### Step 3: If account needs funding
 ```
-generate_algorand_uri {
+generate_algorand_qrcode {
   "address": "[wallet_address]",
   "amount": 5000000,
   "note": "Fund testnet account"
@@ -33,7 +33,7 @@ Or direct user to: https://lora.algokit.io/testnet/fund
 
 ### Step 4: If account needs USDC funding
 ```
-generate_algorand_uri {
+generate_algorand_qrcode {
   "address": "[wallet_address]",
   "asset": 10458941, // USDC on testnet
   "amount": 1000000, // 1 USDC with 6 decimals
@@ -599,7 +599,7 @@ send_raw_transaction {
 When balance is insufficient, generate an ARC-26 QR code for easy funding:
 
 ```
-generate_algorand_uri {
+generate_algorand_qrcode {
   "address": "[wallet_address]",
   "amount": 5000000,
   "note": "Fund account for transaction"