⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v2.4.0

algorand-development

goplausible@goplausible⭐ 3 stars· last commit 5d ago· 1 open issues

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.

—/10

// RATINGS

⭐GitHub Stars
⭐ 3 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

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 to 4.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's x402_discover_payment_requirements and make_http_request_with_x402 tools, plus Bazaar discovery of paid resources (surfaced through mcporter)
  • Zero-privilege installation: First-load init only writes plain files: an algorand-mcp entry in ~/.mcporter/mcporter.json, and a memory file, a one-line MEMORY.md pointer and a marker file in the agent workspace — no shell scripts, no system packages, no keyring installation, no sudo, no post-install hooks
  • 9 Skills covering development, interaction, x402, DEX aggregation, and prediction markets:
    • algorand-development — AlgoKit CLI, project creation, general workflows
    • algorand-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 flows
    • algorand-x402-typescript — x402 payments development in TypeScript
    • algorand-x402-python — x402 payments development in Python
    • haystack-router-interaction — Best-price swaps via MCP tools
    • alpha-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 Routing in the workspace MEMORY.md, so the agent reads the guide only when Algorand comes up
  • Registers algorand-mcp in ~/.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.

PathWhenPurpose
~/.mcporter/mcporter.jsonFirst load + setupIdempotently adds an algorand-mcp entry pointing at the bundled binary. Existing entries for other servers are preserved.
<agent-workspace>/memory/algorand-plugin.mdFirst load + setupWrites the plugin's Algorand routing guide for the agent.
<agent-workspace>/MEMORY.mdFirst load + setupAdds 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.initializedFirst loadMarker file so first-load init is skipped on subsequent gateway starts.
~/.openclaw/openclaw.jsonWhen you run openclaw algorand-plugin setupAdds 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 merge
  • lib/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's accepts[] 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 matching preferredNetwork) → builds an atomic 2-transaction group (facilitator fee-payer + wallet payment) → signs the payment leg with the active wallet → resends with PAYMENT-SIGNATURE header → returns the resource plus the settlement readback. Pass paymentRequirements (from discovery), preferredNetwork, and maxAmountPerRequest as 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

SkillPurpose
algorand-developmentAlgoKit CLI, project creation, general workflows
algorand-typescriptTypeScript smart contracts (PuyaTs)
algorand-pythonPython smart contracts (PuyaPy)
algorand-interactionMCP-based blockchain interaction (wallet, txns, DEX, NFD, x402)
algorand-x402-paymentInteract 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 skills
    
  • README.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

// REPO STATS

3 stars
1 open issues
Last commit: 5d ago