⏳ This skill is pending AI review.
Scores will appear once the review pipeline completes.
algorand-development
Comprehensive guide for Algorand development with AlgoKit — project initialization, CLI commands, example search, contract building workflows, ARC standards, and error troubleshooting. This is the parent skill for language-agnostic Algorand development. Use when working with AlgoKit CLI, searching for examples, understanding ARC standards, creating new projects, or troubleshooting errors. Strong triggers include "algokit init", "algokit project run build", "start localnet", "find an example", "search for contract", "ARC-4", "ARC-56", "logic eval error", "transaction rejected", "overspend", "create a new project", "initialize project".
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
OpenClaw Algorand Plugin
🔷 Algorand blockchain integration for OpenClaw — by GoPlausible
Features
- Bundled Algorand MCP Server:
@goplausible/algorand-mcp(pinned to4.4.4, 119 tools, defaults to testnet) — wallet, transactions, smart contracts, TEAL, indexer, DEX, NFD, Haystack Router, Alpha Arcade, x402 payments, knowledge base - x402 Payment Protocol: HTTP-native payments on Algorand via
@goplausible/algorand-mcp'sx402_discover_payment_requirementsandmake_http_request_with_x402tools, plus Bazaar discovery of paid resources (surfaced through mcporter) - Zero-privilege installation: First-load init only writes plain files: an
algorand-mcpentry in~/.mcporter/mcporter.json, and a memory file, a one-lineMEMORY.mdpointer and a marker file in the agent workspace — no shell scripts, no system packages, no keyring installation, nosudo, no post-install hooks - 9 Skills covering development, interaction, x402, DEX aggregation, and prediction markets:
algorand-development— AlgoKit CLI, project creation, general workflowsalgorand-typescript— TypeScript smart contracts (PuyaTs)algorand-python— Python smart contracts (PuyaPy)algorand-interaction— Blockchain interaction via MCP (wallet, transactions, swaps, NFD)algorand-x402-payment— Interact with x402 protected APIs and URLs and fulfill x402 payment flowsalgorand-x402-typescript— x402 payments development in TypeScriptalgorand-x402-python— x402 payments development in Pythonhaystack-router-interaction— Best-price swaps via MCP toolsalpha-arcade-interaction— Prediction markets interaction
Installation
From ClawHub:
clawhub install @goplausible/algorand-plugin
Or from a local checkout of the source code. OpenClaw installs the compiled dist/index.js, so build first:
cd ./path/to/algorand-plugin
npm install
npm run build
openclaw plugins install .
Configuration
On first load (once; a marker file stops it from running again), the plugin:
- Writes the Algorand routing guide into your agent workspace (
memory/algorand-plugin.md) - Adds one line pointing to that guide under
## Plugin Routingin the workspaceMEMORY.md, so the agent reads the guide only when Algorand comes up - Registers
algorand-mcpin~/.mcporter/mcporter.json
To rerun these steps and enable the plugin in OpenClaw's config (the setup wizard asks no questions):
openclaw algorand-plugin setup
openclaw gateway restart
What this plugin writes to your system
The plugin performs only declarative file writes — no shell scripts, no system packages, no privilege elevation, no keyring installation, no D-Bus/loginctl changes.
| Path | When | Purpose |
|---|---|---|
~/.mcporter/mcporter.json | First load + setup | Idempotently adds an algorand-mcp entry pointing at the bundled binary. Existing entries for other servers are preserved. |
<agent-workspace>/memory/algorand-plugin.md | First load + setup | Writes the plugin's Algorand routing guide for the agent. |
<agent-workspace>/MEMORY.md | First load + setup | Adds one line pointing to memory/algorand-plugin.md under ## Plugin Routing, creating the file or the section if missing. The line ends with the marker <!-- algorand-plugin:index -->, so later runs refresh it in place. Existing content is preserved. |
<agent-workspace>/.openclaw/algorand-plugin.initialized | First load | Marker file so first-load init is skipped on subsequent gateway starts. |
~/.openclaw/openclaw.json | When you run openclaw algorand-plugin setup | Adds algorand-plugin to plugins.allow, sets plugins.entries.algorand-plugin.enabled = true, and persists the plugin config. Other settings, including tools.allow, are left as they are. |
The plugin does not:
- Install OS packages (no
apt,brew,pacman,gnome-keyring,libsecret-tools,dbus-user-session). - Elevate privileges or require
sudo. - Run shell scripts,
loginctl linger, or any D-Bus session setup. - Read or back up wallet mnemonics — wallet storage is owned entirely by
@goplausible/algorand-mcp. - Register post-install or post-update hooks.
The source is small and self-contained:
index.ts— plugin entry, CLI registration (setup,status,mcp-config)lib/mcporter.ts— mcporter JSON mergelib/workspace.ts— memory file + MEMORY.md merge + OpenClaw config writer (plugins.allow,plugins.entries.algorand-plugin.enabled)setup.ts— setup wizard screens (no questions asked)
Commands
openclaw algorand-plugin setup # Rerun first-load setup and enable the plugin in OpenClaw config
openclaw algorand-plugin status # Show plugin status (binary, mcporter, config)
openclaw algorand-plugin mcp-config # Show MCP config snippet for external coding agents
MCP Server
The plugin bundles @goplausible/algorand-mcp as an npm dependency. It runs locally via stdio through mcporter.
- 119 tools across 16 categories (wallet, transactions, algod, indexer, NFD, Tinyman, Haystack Router, Pera verification, Alpha Arcade, x402 payments, Bazaar discovery, TEAL, knowledge base, and more)
- Multi-network:
mainnet,testnet,localnet - Secure wallet: private keys not exposed to agents
Wallet persistence is handled by algorand-mcp itself. The plugin does not install, configure, or manage any keyring software — it simply registers the MCP server with mcporter and lets the MCP server own wallet storage.
x402 Payment Protocol
x402 HTTP-native payments on Algorand are handled by @goplausible/algorand-mcp's two x402 tools (surfaced through mcporter), with three Bazaar tools (bazaar_list, bazaar_search, bazaar_get_resource_details) for finding paid resources first:
x402_discover_payment_requirements— probes an x402-protected endpoint and returns the server'saccepts[]array (cost, networks, assets, facilitator) without paying. Use for supervised flows where the user should approve the cost first.make_http_request_with_x402— runs discovery → selects the cheapest affordable Algorand requirement (or one matchingpreferredNetwork) → builds an atomic 2-transaction group (facilitator fee-payer + wallet payment) → signs the payment leg with the active wallet → resends withPAYMENT-SIGNATUREheader → returns the resource plus the settlement readback. PasspaymentRequirements(from discovery),preferredNetwork, andmaxAmountPerRequestas guardrails.
See the algorand-x402-payment skill (references/x402-payment-flow.md) for the payment patterns, Bazaar discovery, and common errors.
Plugin Config
Config lives in ~/.openclaw/openclaw.json under plugins.entries.algorand-plugin:
{
"plugins": {
"allow": ["algorand-plugin"],
"entries": {
"algorand-plugin": {
"enabled": true,
"config": { "enableX402": true }
}
}
}
}
The plugin has no required config keys. setup adds the plugin to plugins.allow (keeping existing entries), sets enabled, and writes enableX402: true. In this version x402 runs entirely through algorand-mcp's tools, so that flag has no effect.
Skills Overview
| Skill | Purpose |
|---|---|
algorand-development | AlgoKit CLI, project creation, general workflows |
algorand-typescript | TypeScript smart contracts (PuyaTs) |
algorand-python | Python smart contracts (PuyaPy) |
algorand-interaction | MCP-based blockchain interaction (wallet, txns, DEX, NFD, x402) |
algorand-x402-payment | Interact with x402 protected APIs and |
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
skills/algorand-development/SKILL.md4.3 KBupstream ↗
--- name: algorand-development description: Comprehensive guide for Algorand development with AlgoKit — project initialization, CLI commands, example search, contract building workflows, ARC standards, and error troubleshooting. This is the parent skill for language-agnostic Algorand development. Use when working with AlgoKit CLI, searching for examples, understanding ARC standards, creating new projects, or troubleshooting errors. Strong triggers include "algokit init", "algokit project run build", "start localnet", "find an example", "search for contract", "ARC-4", "ARC-56", "logic eval error", "transaction rejected", "overspend", "create a new project", "initialize project". --- # Algorand Development This is the aggregated parent skill for language-agnostic Algorand development tools, workflows, and standards. Use the reference files below to find detailed guidance for each topic. ## Quick Start ```bash # Install AlgoKit CLI pipx install algokit # Create a new project algokit init -n my-project -t typescript --answer preset_name production --defaults # Development cycle algokit project run build # Compile contracts algokit project run test # Run tests algokit localnet start # Start local network algokit project deploy localnet # Deploy ``` ## Reference Guide Navigate to the appropriate reference based on your task. ### AlgoKit CLI Commands Build, test, deploy, and manage local networks with AlgoKit CLI. - [use-algokit-cli.md](./references/use-algokit-cli.md) — CLI workflow and common commands - [use-algokit-cli-reference.md](./references/use-algokit-cli-reference.md) — Full CLI command reference ### Searching Algorand Examples Find working contract examples and code patterns from Algorand Foundation repositories using WebFetch with raw GitHub URLs. - [search-algorand-examples.md](./references/search-algorand-examples.md) — Search workflow and priority repos - [search-algorand-examples-reference.md](./references/search-algorand-examples-reference.md) — WebFetch patterns and knowledge base reference ### Creating Projects Initialize new Algorand projects using AlgoKit templates. - [create-project.md](./references/create-project.md) — Project creation workflow - [create-project-reference.md](./references/create-project-reference.md) — Templates, presets, and CLI options ### Building Smart Contracts General workflow for building Algorand smart contracts (language-agnostic steps). - [build-smart-contracts.md](./references/build-smart-contracts.md) — Contract building workflow - [build-smart-contracts-reference.md](./references/build-smart-contracts-reference.md) — Repository priorities and pattern lookups ### Implementing ARC Standards ARC-4 ABI encoding, ARC-32/ARC-56 application specifications, and related standards. - [implement-arc-standards.md](./references/implement-arc-standards.md) — ARC overview and key standards - [implement-arc-standards-arc4.md](./references/implement-arc-standards-arc4.md) — ARC-4 ABI types, encoding, and method invocation - [implement-arc-standards-arc32-arc56.md](./references/implement-arc-standards-arc32-arc56.md) — Application specification format and usage ### Troubleshooting Errors Diagnose and fix common Algorand development errors. - [troubleshoot-errors.md](./references/troubleshoot-errors.md) — Error diagnosis overview - [troubleshoot-errors-contract.md](./references/troubleshoot-errors-contract.md) — Smart contract and logic errors - [troubleshoot-errors-transaction.md](./references/troubleshoot-errors-transaction.md) — Transaction and account errors ## Topic Quick Reference | Topic | Files | Description | | ----- | ----- | ----------- | | AlgoKit CLI | 2 | Build, test, deploy commands and localnet management | | Search Examples | 2 | WebFetch patterns for finding Algorand code examples | | Create Project | 2 | algokit init templates, presets, and options | | Build Contracts | 2 | Language-agnostic contract building workflow | | ARC Standards | 3 | ARC-4 ABI, ARC-32/56 app specs | | Troubleshoot | 3 | Error diagnosis for contracts and transactions | ## How to Use This Skill 1. **Start here** to understand which reference you need 2. **Read the topic `.md`** file for step-by-step guidance 3. **Consult the `-reference.md`** file for detailed API/CLI details 4. **For language-specific content**, see the `algorand-typescript` or `algorand-python` parent skillsREADME.mdupstream ↗
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/goplausible-openclaw-algorand-plugin-skills-algorand-development.md