@goplausible/openclaw-algorand-plugin 1.8.8 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.ts CHANGED
@@ -539,6 +539,30 @@ export default function register(api: PluginApi) {
539
539
  { name: "algorand.post-install", description: "Show setup instructions on install" }
540
540
  );
541
541
 
542
+ // ─────────────────────────────────────────────────────────────
543
+ // Post-update hook
544
+ // ─────────────────────────────────────────────────────────────
545
+ api.registerHook(
546
+ "plugin:post-update",
547
+ async () => {
548
+ console.log("\n🔷 Algorand plugin updated!\n");
549
+
550
+ // Ensure MEMORY.md and memory files are up to date
551
+ const workspacePath = getWorkspacePath(api);
552
+ const memResult = writeMemoryFile(workspacePath);
553
+ if (memResult.success) {
554
+ console.log(` ✅ ${memResult.message}`);
555
+ }
556
+ const memIndexResult = ensureWorkspaceMemoryIndex(workspacePath);
557
+ if (memIndexResult.success) {
558
+ console.log(` ✅ ${memIndexResult.message}`);
559
+ }
560
+
561
+ console.log("\n Restart OpenClaw gateway to apply changes.\n");
562
+ },
563
+ { name: "algorand.post-update", description: "Update memory files on plugin update" }
564
+ );
565
+
542
566
  api.logger.info(`Algorand plugin registered (skills: 6, MCP: ${ALGORAND_MCP.name})`);
543
567
  }
544
568
 
@@ -57,34 +57,30 @@ mcporter call algorand-mcp.search_assets name=USDC network=mainnet
57
57
  ## QR Code Display (ARC-26 URI)
58
58
 
59
59
  When generating QR codes with `generate_algorand_qrcode`, the tool returns:
60
- - UTF-8 text QR code (terminal-friendly)
61
- - PNG image as base64 (web-friendly)
62
- - URI string
60
+ - `qr` — UTF-8 text QR code (terminal-friendly)
61
+ - `uri` the `algorand://` URI string
62
+ - `link` — shareable hosted QR URL (via QRClaw service)
63
+ - `expires_in` — link validity period
63
64
 
64
- **Important:** MCP tool output may not render properly through mcporter → exec pipeline.
65
65
  After calling the tool, **extract and paste the QR code directly in your response**.
66
- **Always include ALL THREE in your reply, using --raw flag with mcporter to get the full output including image data:**
66
+ **Always include all of these in your reply:**
67
67
 
68
- 1. UTF-8 QR block (Unicode block characters) and URI string at the end of the text output.
69
- 2. PNG as markdown image: `![QR](data:image/png;base64,...)`.
70
- 3. **URI string** — always show this, users need it for wallet deep links.
71
- 4. Copy the ENTIRE base64 string exactly — do not reformat, wrap, or edit it.
72
- 5. Verify the ending — PNG base64 typically ends with `==` or a short suffix like `QAAA`.
68
+ 1. **UTF-8 QR block** Unicode block characters from `qr`. Paste inside a code block.
69
+ 2. **URI string** always show this, users need it for wallet deep links.
70
+ 3. **Shareable link** — the hosted QR URL from `link`, so users can share or open it in a browser.
73
71
 
74
72
  ### Steps to include QR code in reply:
75
- 1. Call the tool with --raw flag and capture output
76
- 2. Content's first array member is text and contains the UTF-8 QR block (Unicode block characters) plus URI string
77
- 3. Content's second array member is image and contains the base64 PNG data
78
- 4. Include both in your reply:
73
+ 1. Call the tool and capture output
74
+ 2. Extract `qr`, `uri`, and `link` from the response
75
+ 3. Include in your reply:
79
76
 
80
77
  ```
81
78
  [paste UTF-8 QR here]
82
79
  ```
83
80
 
84
- ![QR Code](data:image/png;base64,[paste base64 here])
81
+ URI: `algorand://...`
85
82
 
86
-
87
- This ensures the QR renders correctly in both terminal and web interfaces.
83
+ Shareable QR: [link URL]
88
84
 
89
85
  ## Key things to remember
90
86
 
@@ -2,7 +2,7 @@
2
2
  "id": "openclaw-algorand-plugin",
3
3
  "name": "Algorand Integration",
4
4
  "description": "Algorand blockchain integration with MCP and skills — by GoPlausible",
5
- "version": "1.8.8",
5
+ "version": "1.9.0",
6
6
  "skills": [
7
7
  "skills/algorand-development",
8
8
  "skills/algorand-typescript",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@goplausible/openclaw-algorand-plugin",
3
- "version": "1.8.8",
3
+ "version": "1.9.0",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },
@@ -212,34 +212,30 @@ All prices and quantities use **microunits** (1,000,000 = $1.00 or 1 share). Ord
212
212
  ## QR Code Display (ARC-26 URI)
213
213
 
214
214
  When generating QR codes with `generate_algorand_qrcode`, the tool returns:
215
- - UTF-8 text QR code (terminal-friendly)
216
- - PNG image as base64 (web-friendly)
217
- - URI string
215
+ - `qr` — UTF-8 text QR code (terminal-friendly)
216
+ - `uri` the `algorand://` URI string
217
+ - `link` — shareable hosted QR URL (via QRClaw service)
218
+ - `expires_in` — link validity period
218
219
 
219
- **Important:** MCP tool output may not render properly through mcporter → exec pipeline.
220
220
  After calling the tool, **extract and paste the QR code directly in your response**.
221
- **Always include ALL THREE in your reply, using --raw flag with mcporter to get the full output including image data:**
221
+ **Always include all of these in your reply:**
222
222
 
223
- 1. UTF-8 QR block (Unicode block characters) and URI string at the end of the text output.
224
- 2. PNG as markdown image: `![QR](data:image/png;base64,...)`.
225
- 3. **URI string** — always show this, users need it for wallet deep links.
226
- 4. Copy the ENTIRE base64 string exactly — do not reformat, wrap, or edit it.
227
- 5. Verify the ending — PNG base64 typically ends with `==` or a short suffix like `QAAA`.
223
+ 1. **UTF-8 QR block** Unicode block characters from `qr`. Paste inside a code block.
224
+ 2. **URI string** always show this, users need it for wallet deep links.
225
+ 3. **Shareable link** — the hosted QR URL from `link`, so users can share or open it in a browser.
228
226
 
229
227
  ### Steps to include QR code in reply:
230
- 1. Call the tool with --raw flag and capture output
231
- 2. Content's first array member is text and contains the UTF-8 QR block (Unicode block characters) plus URI string
232
- 3. Content's second array member is image and contains the base64 PNG data
233
- 4. Include both in your reply:
228
+ 1. Call the tool and capture output
229
+ 2. Extract `qr`, `uri`, and `link` from the response
230
+ 3. Include in your reply:
234
231
 
235
232
  ```
236
233
  [paste UTF-8 QR here]
237
234
  ```
238
235
 
239
- ![QR Code](data:image/png;base64,[paste base64 here])
236
+ URI: `algorand://...`
240
237
 
241
-
242
- This ensures the QR renders correctly in both terminal and web interfaces.
238
+ Shareable QR: [link URL]
243
239
 
244
240
  ## References
245
241
 
@@ -783,44 +783,41 @@ Mainnet asset verification via Pera Wallet API. Use to check if assets are legit
783
783
  ## ARC-26 URI Tools
784
784
 
785
785
  ### generate_algorand_qrcode
786
- - **Purpose**: Generate an Algorand top up payment or asset transferURI and QR code per ARC-26 specification
786
+ - **Purpose**: Generate an Algorand payment URI and QR code per ARC-26 specification via QRClaw service
787
787
  - **Parameters**:
788
788
  ```json
789
789
  {
790
790
  "address": "receiver_address",
791
791
  "label": "Payment label",
792
792
  "amount": 1000000,
793
- "asset": 31566704,// optional, if asset transfer; omit or set to 0 for ALGO
793
+ "asset": 31566704,
794
794
  "note": "Payment note",
795
- "xnote": "Exclusive immutable note"
795
+ "xnote": "Exclusive Immutable note"
796
796
  }
797
797
  ```
798
- - **Returns**: UTF-8 text QR code (terminal-friendly), PNG image as base64 (web-friendly), URI string
798
+ - **Returns**: `qr` (UTF-8 text QR code), `uri` (the `algorand://` URI), `link` (shareable hosted QR URL), `expires_in` (link validity period)
799
799
 
800
800
  ### QR Code Display
801
801
 
802
- **Important:** MCP tool output may not render properly through mcporter → exec pipeline.
803
802
  After calling the tool, **extract and paste the QR code directly in your response**.
804
- **Always include ALL THREE in your reply:**
803
+ **Always include all of these in your reply:**
805
804
 
806
- 1. UTF-8 QR block (Unicode block characters)
807
- 2. PNG as markdown image: `![QR](data:image/png;base64,...)`
808
- 3. **URI string** — always show this, users need it for wallet deep links
805
+ 1. **UTF-8 QR block** Unicode block characters from `qr`. Paste inside a code block.
806
+ 2. **URI string** always show this, users need it for wallet deep links.
807
+ 3. **Shareable link** — the hosted QR URL from `link`, so users can share or open it in a browser.
809
808
 
809
+ **Steps to include QR code in reply:**
810
810
  1. Call the tool and capture output
811
- 2. Extract the UTF-8 QR block (Unicode block characters)
812
- 3. Extract the base64 PNG data
813
- 4. Include both in your reply:
811
+ 2. Extract `qr`, `uri`, and `link` from the response
812
+ 3. Include in your reply:
814
813
 
815
814
  ```
816
815
  [paste UTF-8 QR here]
817
816
  ```
818
817
 
819
- ![QR Code](data:image/png;base64,[paste base64 here])
820
-
821
818
  URI: `algorand://ADDRESS?amount=X&asset=Y`
822
819
 
823
- This ensures the QR renders correctly in both terminal and web interfaces.
820
+ Shareable QR: [link URL]
824
821
 
825
822
  ---
826
823
 
@@ -606,7 +606,7 @@ generate_algorand_qrcode {
606
606
  }
607
607
  ```
608
608
 
609
- The response includes a URI string and SVG QR code that can be scanned with any Algorand-compatible wallet.
609
+ The response includes `qr` (UTF-8 text QR code), `uri` (the `algorand://` URI), `link` (shareable hosted QR URL via QRClaw), and `expires_in` (link validity period). Share the link or display the QR code for scanning with any Algorand-compatible wallet.
610
610
 
611
611
  ---
612
612