@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 +24 -0
- package/memory/algorand-plugin.md +13 -17
- package/openclaw.plugin.json +1 -1
- package/package.json +1 -1
- package/skills/algorand-interaction/SKILL.md +13 -17
- package/skills/algorand-interaction/references/algorand-mcp.md +12 -15
- package/skills/algorand-interaction/references/examples-algorand-mcp.md +1 -1
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
|
-
-
|
|
62
|
-
-
|
|
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
|
|
66
|
+
**Always include all of these in your reply:**
|
|
67
67
|
|
|
68
|
-
1. UTF-8 QR block
|
|
69
|
-
2.
|
|
70
|
-
3. **
|
|
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
|
|
76
|
-
2.
|
|
77
|
-
3.
|
|
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
|
-
|
|
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
|
|
package/openclaw.plugin.json
CHANGED
|
@@ -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.
|
|
5
|
+
"version": "1.9.0",
|
|
6
6
|
"skills": [
|
|
7
7
|
"skills/algorand-development",
|
|
8
8
|
"skills/algorand-typescript",
|
package/package.json
CHANGED
|
@@ -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
|
-
-
|
|
217
|
-
-
|
|
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
|
|
221
|
+
**Always include all of these in your reply:**
|
|
222
222
|
|
|
223
|
-
1. UTF-8 QR block
|
|
224
|
-
2.
|
|
225
|
-
3. **
|
|
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
|
|
231
|
-
2.
|
|
232
|
-
3.
|
|
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
|
-
|
|
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
|
|
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
|
|
793
|
+
"asset": 31566704,
|
|
794
794
|
"note": "Payment note",
|
|
795
|
-
"xnote": "Exclusive
|
|
795
|
+
"xnote": "Exclusive Immutable note"
|
|
796
796
|
}
|
|
797
797
|
```
|
|
798
|
-
- **Returns**: UTF-8 text QR code (
|
|
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
|
|
803
|
+
**Always include all of these in your reply:**
|
|
805
804
|
|
|
806
|
-
1. UTF-8 QR block
|
|
807
|
-
2.
|
|
808
|
-
3. **
|
|
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
|
|
812
|
-
3.
|
|
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
|
-

|
|
820
|
-
|
|
821
818
|
URI: `algorand://ADDRESS?amount=X&asset=Y`
|
|
822
819
|
|
|
823
|
-
|
|
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
|
|
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
|
|