@goplausible/openclaw-algorand-plugin 1.9.3 → 1.9.5

package/memory/MEMORY.md

@@ -23,7 +23,14 @@
 * `alpha-arcade-interaction` — Load for prediction market trading via MCP tools (browse markets, place orders, manage positions).
 
 ### QR Codes
-* `generate_algorand_qrcode` returns `qr` (UTF-8 text QR), `uri` (algorand:// URI), `link` (shareable hosted QR URL via QRClaw), and `expires_in` (link validity). Always include the UTF-8 QR block, URI string, and shareable link in your response.
+* `generate_algorand_qrcode` returns `qr` (UTF-8 text QR), `uri` (algorand:// URI), `link` (shareable hosted QR URL via QRClaw), and `expires_in` (link validity).
+* **Channel-aware output**: In TUI/Web channels, include UTF-8 QR block + URI + shareable link. In social channels (Telegram, Discord, WhatsApp, Slack, etc.), skip the QR block (too bulky) and show only URI + shareable link.
+
+### Transaction ID Delivery
+* ALWAYS present transaction IDs to the user after any successful transaction submission.
+* **Mainnet** explorer link: `https://allo.info/tx/{txId}`
+* **Testnet** explorer link: `https://lora.algokit.io/testnet/transaction/{txId}`
+* This applies to ALL transaction types: payments, transfers, opt-ins, app calls, atomic groups, Haystack swaps, Alpha Arcade trades, and x402 payments.
 
 ### Documentation
 * Use `get_knowledge_doc` MCP tool for Algorand developer documentation (categories: arcs, sdks, algokit, algokit-utils, tealscript, puya, liquid-auth, python, developers, clis, nodes, details).

package/memory/algorand-plugin.md

@@ -62,26 +62,39 @@ When generating QR codes with `generate_algorand_qrcode`, the tool returns:
 - `link` — shareable hosted QR URL (via QRClaw service)
 - `expires_in` — link validity period
 
-After calling the tool, **extract and paste the QR code directly in your response**.
-**Always include all of these in your reply:**
+**Channel-Aware Output:**
 
-1. **UTF-8 QR block** — Unicode block characters from `qr`. Paste inside a code block.
-2. **URI string** — always show this, users need it for wallet deep links.
-3. **Shareable link** — the hosted QR URL from `link`, so users can share or open it in a browser.
+After calling `generate_algorand_qrcode`, tailor output to the channel:
 
-### Steps to include QR code in reply:
-1. Call the tool and capture output
-2. Extract `qr`, `uri`, and `link` from the response
-3. Include in your reply:
+**TUI / Web channels** (terminal, web UI, canvas):
+1. **UTF-8 QR block** — paste the Unicode block characters from `qr` inside a code fence
+2. **URI string** — the `algorand://` URI for wallet deep links
+3. **Shareable link** — the hosted QR URL from `link`
 
+Example:
 ```
 [paste UTF-8 QR here]
 ```
-
 URI: `algorand://...`
-
 Shareable QR: [link URL]
 
+**Social channels** (Telegram, Discord, WhatsApp, Signal, Slack, IRC, etc.):
+- **Skip** the UTF-8 QR block — too bulky for chat
+- Show only:
+  - **URI string** — for wallet deep links
+  - **Shareable link** — renders nicely in-app as a clickable QR image
+
+## Post-Transaction: Deliver Transaction ID
+
+**ALWAYS** present the transaction ID to the user after any successful transaction. Use the correct explorer link:
+
+| Network | Explorer Link Template |
+|---------|----------------------|
+| `mainnet` | `https://allo.info/tx/{txId}` |
+| `testnet` | `https://lora.algokit.io/testnet/transaction/{txId}` |
+
+This applies to ALL operations that yield a transaction ID: payments, asset transfers, opt-ins, app calls, atomic groups, Haystack Router swaps, Alpha Arcade trades, and x402 payments.
+
 ## Key things to remember
 
 - Always check wallet with `wallet_get_info` before blockchain operations

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.9.3",
+  "version": "1.9.5",
   "skills": [
     "skills/algorand-development",
     "skills/algorand-typescript",

package/package.json

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

package/skills/algorand-interaction/SKILL.md

@@ -110,7 +110,26 @@ Always check asset's `decimals` field with `api_algod_get_asset_by_id` before co
 | 3 | `make_*_txn` | Build the transaction |
 | 4 | `wallet_sign_transaction` | Sign with active wallet account (enforces limits) |
 | 5 | `send_raw_transaction` | Submit signed transaction to network |
-| 6 | Query tools | Verify result on-chain |
+| 6 | **Present txID** | Show transaction ID with explorer link (see below) |
+
+### Post-Transaction: Deliver Transaction ID
+
+**ALWAYS** present the transaction ID to the user after any successful transaction submission. Use the correct explorer link based on the network:
+
+| Network | Explorer Link Template |
+|---------|----------------------|
+| `mainnet` | `https://allo.info/tx/{txId}` |
+| `testnet` | `https://lora.algokit.io/testnet/transaction/{txId}` |
+
+Example output after a testnet transaction:
+> Transaction confirmed! `TXID123...`
+> View on explorer: https://lora.algokit.io/testnet/transaction/TXID123...
+
+Example output after a mainnet transaction:
+> Transaction confirmed! `TXID456...`
+> View on explorer: https://allo.info/tx/TXID456...
+
+This applies to ALL transaction types: payments, asset transfers, opt-ins, app calls, atomic groups, and any other operation that yields a transaction ID.
 
 ### One-Step Asset Opt-In
 
@@ -128,6 +147,7 @@ When the user provides their own secret key (not using the wallet):
 | 1 | `make_*_txn` | Build the transaction |
 | 2 | `sign_transaction` | Sign with provided secret key hex |
 | 3 | `send_raw_transaction` | Submit signed transaction |
+| 4 | **Present txID** | Show transaction ID with explorer link |
 
 ## Atomic Group Transaction Workflow
 
@@ -139,6 +159,7 @@ For atomic (all-or-nothing) multi-transaction groups:
 | 2 | `assign_group_id` | Assign group ID to all transactions |
 | 3 | `wallet_sign_transaction_group` | Sign all transactions in group with wallet |
 | 4 | `send_raw_transaction` | Submit all signed transactions |
+| 5 | **Present txIDs** | Show all transaction IDs with explorer links |
 
 ## Tool Categories
 
@@ -229,26 +250,28 @@ All prices and quantities use **microunits** (1,000,000 = $1.00 or 1 share). Ord
 - `link` — shareable hosted QR URL (via QRClaw service)
 - `expires_in` — link validity period
 
-After calling the tool, **extract and paste the QR code directly in your response**.
-**Always include all of these in your reply:**
+**Channel-Aware Output:**
 
-1. **UTF-8 QR block** — Unicode block characters from `qr`. Paste inside a code block.
-2. **URI string** — always show this, users need it for wallet deep links.
-3. **Shareable link** — the hosted QR URL from `link`, so users can share or open it in a browser.
+After calling `generate_algorand_qrcode`, tailor output to the channel:
 
-### Steps to include QR code in reply:
-1. Call the tool and capture output
-2. Extract `qr`, `uri`, and `link` from the response
-3. Include in your reply:
+**TUI / Web channels** (terminal, web UI, canvas):
+1. **UTF-8 QR block** — paste the Unicode block characters from `qr` inside a code fence
+2. **URI string** — the `algorand://` URI for wallet deep links
+3. **Shareable link** — the hosted QR URL from `link`
 
+Example:
 ```
 [paste UTF-8 QR here]
 ```
-
 URI: `algorand://...`
-
 Shareable QR: [link URL]
 
+**Social channels** (Telegram, Discord, WhatsApp, Signal, Slack, IRC, etc.):
+- **Skip** the UTF-8 QR block — too bulky for chat
+- Show only:
+  - **URI string** — for wallet deep links
+  - **Shareable link** — renders nicely in-app as a clickable QR image
+
 ## References
 
 For detailed tool documentation:

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

@@ -799,26 +799,28 @@ Mainnet asset verification via Pera Wallet API. Use to check if assets are legit
 
 ### QR Code Display
 
-After calling the tool, **extract and paste the QR code directly in your response**.
-**Always include all of these in your reply:**
+**Channel-Aware Output:**
 
-1. **UTF-8 QR block** — Unicode block characters from `qr`. Paste inside a code block.
-2. **URI string** — always show this, users need it for wallet deep links.
-3. **Shareable link** — the hosted QR URL from `link`, so users can share or open it in a browser.
+After calling `generate_algorand_qrcode`, tailor output to the channel:
 
-**Steps to include QR code in reply:**
-1. Call the tool and capture output
-2. Extract `qr`, `uri`, and `link` from the response
-3. Include in your reply:
+**TUI / Web channels** (terminal, web UI, canvas):
+1. **UTF-8 QR block** — paste the Unicode block characters from `qr` inside a code fence
+2. **URI string** — the `algorand://` URI for wallet deep links
+3. **Shareable link** — the hosted QR URL from `link`
 
+Example:
 ```
 [paste UTF-8 QR here]
 ```
-
 URI: `algorand://ADDRESS?amount=X&asset=Y`
-
 Shareable QR: [link URL]
 
+**Social channels** (Telegram, Discord, WhatsApp, Signal, Slack, IRC, etc.):
+- **Skip** the UTF-8 QR block — too bulky for chat
+- Show only:
+  - **URI string** — for wallet deep links
+  - **Shareable link** — renders nicely in-app as a clickable QR image
+
 ---
 
 ## Knowledge Base Tools

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

@@ -79,10 +79,21 @@ send_raw_transaction {
 }
 ```
 
-### Step 5: Verify (optional)
+### Step 5: Present transaction ID to user
+
+**ALWAYS** show the transaction ID with the correct explorer link:
+
+- **Mainnet**: `https://allo.info/tx/{txId}`
+- **Testnet**: `https://lora.algokit.io/testnet/transaction/{txId}`
+
+Example (testnet):
+> Transaction confirmed! `[txID_from_step_4]`
+> View on explorer: https://lora.algokit.io/testnet/transaction/[txID_from_step_4]
+
+Optionally verify on-chain:
 ```
 api_indexer_lookup_transaction_by_id {
-  "txId": "[txID_from_step_3]",
+  "txId": "[txID_from_step_4]",
   "network": "testnet"
 }
 ```
@@ -100,7 +111,7 @@ wallet_optin_asset {
 }
 ```
 
-This creates, signs, and submits the opt-in transaction in a single call.
+This creates, signs, and submits the opt-in transaction in a single call. Present the returned txID with explorer link.
 
 ---
 
@@ -142,6 +153,12 @@ send_raw_transaction {
 }
 ```
 
+### Step 5: Present transaction ID to user
+
+Show the txID with explorer link:
+- **Testnet**: `https://lora.algokit.io/testnet/transaction/{txId}`
+- **Mainnet**: `https://allo.info/tx/{txId}`
+
 ---
 
 ## Asset Transfer Workflow (USDC Example)
@@ -204,6 +221,12 @@ send_raw_transaction {
 }
 ```
 
+### Step 8: Present transaction ID to user
+
+Show the txID with explorer link:
+- **Testnet**: `https://lora.algokit.io/testnet/transaction/{txId}`
+- **Mainnet**: `https://allo.info/tx/{txId}`
+
 ---
 
 ## Atomic Group Transaction Workflow
@@ -252,6 +275,12 @@ send_raw_transaction {
 
 > Atomic groups are all-or-nothing: either all transactions succeed or none do.
 
+### Step 5: Present transaction IDs to user
+
+Show all txIDs from the group with explorer links:
+- **Testnet**: `https://lora.algokit.io/testnet/transaction/{txId}`
+- **Mainnet**: `https://allo.info/tx/{txId}`
+
 ---
 
 ## Create an ASA (Algorand Standard Asset)
@@ -299,6 +328,12 @@ api_algod_get_pending_transaction {
 ```
 > The `asset-index` field in the response contains the new ASA ID.
 
+### Step 5: Present transaction ID to user
+
+Show the txID with explorer link:
+- **Testnet**: `https://lora.algokit.io/testnet/transaction/{txId}`
+- **Mainnet**: `https://allo.info/tx/{txId}`
+
 ---
 
 ## Deploy a Smart Contract
@@ -347,6 +382,12 @@ send_raw_transaction {
 }
 ```
 
+### Step 5: Present transaction ID to user
+
+Show the txID with explorer link:
+- **Testnet**: `https://lora.algokit.io/testnet/transaction/{txId}`
+- **Mainnet**: `https://allo.info/tx/{txId}`
+
 ---
 
 ## NFD Lookup
@@ -592,6 +633,12 @@ send_raw_transaction {
 }
 ```
 
+### Step 4: Present transaction ID to user
+
+Show the txID with explorer link:
+- **Testnet**: `https://lora.algokit.io/testnet/transaction/{txId}`
+- **Mainnet**: `https://allo.info/tx/{txId}`
+
 ---
 
 ## Top-Up QR Code (Insufficient Funds)

package/skills/alpha-arcade-interaction/SKILL.md

@@ -138,6 +138,7 @@ If a trade fails with an "overspend" error, the wallet lacks sufficient ALGO or
 2. `get_orderbook` — check available liquidity
 3. `create_market_order` (auto-matches) or `create_limit_order` (rests on book)
 4. Save the returned `escrowAppId` — you need it to cancel
+5. **Present txID** — show transaction ID with explorer link (see Post-Transaction below)
 
 ### Checking your portfolio
 1. `get_positions` — see all YES/NO token balances with market titles and asset IDs
@@ -151,15 +152,29 @@ If a trade fails with an "overspend" error, the wallet lacks sufficient ALGO or
 ### Cancelling an order
 1. `get_open_orders` — find the `escrowAppId` and `owner` address
 2. `cancel_order` with `marketAppId`, `escrowAppId`, and `orderOwner`
+3. **Present txID** — show transaction ID with explorer link
 
 ### Claiming from a resolved market
 1. `get_positions` — find markets with token balances; note the `yesAssetId` or `noAssetId`
 2. `claim` with `marketAppId` and the winning token's `assetId`
+3. **Present txID** — show transaction ID with explorer link
 
 ### Providing liquidity (split/merge)
 1. `split_shares` — convert USDC into equal YES + NO tokens
 2. Place limit orders on both sides of the book for market making
 3. `merge_shares` — convert matched YES + NO tokens back to USDC
+4. **Present txIDs** — show transaction IDs with explorer links for each operation
+
+## Post-Transaction: Deliver Transaction ID
+
+**ALWAYS** present the transaction ID to the user after any successful trading operation (orders, cancellations, amendments, claims, splits, merges). Use the correct explorer link based on the network:
+
+| Network | Explorer Link Template |
+|---------|----------------------|
+| `mainnet` | `https://allo.info/tx/{txId}` |
+| `testnet` | `https://lora.algokit.io/testnet/transaction/{txId}` |
+
+This applies to all Alpha Arcade trading tools: `create_market_order`, `create_limit_order`, `cancel_order`, `amend_order`, `propose_match`, `split_shares`, `merge_shares`, and `claim`.
 
 ## Common Pitfalls
 

package/skills/haystack-router-interaction/SKILL.md

@@ -76,6 +76,10 @@ All-in-one swap: quote → sign (via wallet) → submit → confirm. Uses the ac
 
 Returns: status, confirmedRound, txIds, signer, nickname, quote details,
          summary (inputAmount, outputAmount, totalFees, transactionCount)
+
+ALWAYS present txIds to user with explorer links after execution:
+  Mainnet: https://allo.info/tx/{txId}
+  Testnet: https://lora.algokit.io/testnet/transaction/{txId}
 ```
 
 ### `api_haystack_needs_optin`
@@ -109,6 +113,11 @@ Step 3: Preview quote (recommended — show user before executing)
 Step 4: User confirms → Execute
   → api_haystack_execute_swap { fromASAID, toASAID, amount, slippage, network }
   → Returns confirmed result with summary
+
+Step 5: Present transaction IDs to user
+  → Show all txIds from the response with explorer links:
+     Mainnet: https://allo.info/tx/{txId}
+     Testnet: https://lora.algokit.io/testnet/transaction/{txId}
 ```
 
 **Key rules:**