algorand-devrel
@algorand-devrel Organization
Public Skills
create-typescript-x402-facilitator
by algorand-devrel
Create x402 facilitator services that verify and settle Algorand payments, with optional Bazaar discovery extension for API cataloging. Use when building a facilitator that verifies payment transactions, settles on-chain, implements FacilitatorAvmSigner, creates Express.js facilitator servers, integrates Bazaar discovery for indexing paid resources, or extracts discovery metadata from payment flows. Strong triggers include "create x402 facilitator", "FacilitatorAvmSigner", "verify and settle payment", "facilitator server", "Bazaar discovery", "x402Facilitator", "payment settlement", "facilitator signer", "catalog paid APIs".
create-typescript-x402-paywall
by algorand-devrel
Create paywall UIs for x402-protected endpoints on Algorand and multi-chain. Use when building payment-gated content with server-side middleware and client-side wallet integration, setting up PaywallBuilder with network handlers, integrating with Express/Hono/Next.js, configuring wallet discovery (Pera, Defly, Lute), or building multi-network paywalls (AVM+EVM+SVM). Strong triggers include "create x402 paywall", "PaywallBuilder", "avmPaywall", "payment wall", "paywall middleware", "402 payment page", "paywall HTML", "payment-gated content".
create-python-x402-facilitator
by algorand-devrel
Create Python x402 facilitator services that verify and settle payments on-chain. Use when building a FastAPI-based facilitator, implementing the FacilitatorAvmSigner protocol (sign_transaction, sign_group, simulate_group, send_group, confirm_transaction), registering with register_exact_avm_facilitator, creating multi-network facilitators (EVM+SVM+AVM), or setting up facilitator API endpoints (/verify, /settle, /supported). Strong triggers include "create a Python facilitator", "build a payment facilitator service", "implement FacilitatorAvmSigner", "set up facilitator endpoints", "verify and settle Algorand payments", "fee payer service".
create-python-x402-server
by algorand-devrel
Create x402 payment-protected servers with FastAPI (async) or Flask (sync) for Algorand. Use when building resource servers that require USDC payments, setting up payment middleware, configuring route pricing, or protecting API endpoints with x402. Strong triggers include "create a FastAPI server with x402 payments", "add payment middleware to Flask", "protect my API endpoint with Algorand USDC", "set up x402 resource server in Python", "PaymentMiddlewareASGI setup", "Flask PaymentMiddleware", "how do I accept Algorand payments on my API?", "multi-network payment server", "x402 route configuration".
create-typescript-x402-client
by algorand-devrel
Create x402 HTTP clients with Fetch and Axios that automatically handle 402 payments on Algorand. Use when building applications that consume x402-protected APIs, setting up automatic payment handling with wrapFetchWithPayment or wrapAxiosWithPayment, implementing ClientAvmSigner for browser wallets or Node.js private keys, configuring payment policies, or handling 402 payment flows. Strong triggers include "create x402 client", "wrap fetch with payment", "wrap axios with payment", "automatic 402 payment", "ClientAvmSigner", "pay for API with USDC", "x402 fetch", "x402 axios".
create-typescript-x402-server
by algorand-devrel
Create x402 payment-protected servers with Express.js and Hono. Use when building a resource server that returns 402 Payment Required, setting up payment middleware, configuring protected routes, implementing multi-network support (AVM+EVM+SVM), integrating paywall UI, building facilitator servers, or implementing dynamic pricing. Strong triggers include "create an x402 server", "add payment middleware to Express", "protect routes with x402", "set up payment-gated API", "hono payment middleware", "402 payment required server", "x402 express server", "x402 hono server", "build a facilitator server", "fee abstraction server".
use-typescript-x402-core-avm
by algorand-devrel
Use @x402-avm/core and @x402-avm/avm TypeScript packages directly for custom x402 payment integrations. Use when building custom clients, resource servers, or facilitators with the x402 protocol on Algorand, implementing payment policies, creating AVM signer interfaces, handling transaction groups, or integrating fee abstraction. Strong triggers include "use x402 core package", "create x402 client", "implement facilitator signer", "x402 payment verification", "fee abstraction on Algorand", "register AVM scheme", "transaction group signing", "x402ResourceServer", "x402Client", "x402Facilitator", "ClientAvmSigner", "FacilitatorAvmSigner".
build-smart-contracts
by algorand-devrel
Build Algorand smart contracts using Algorand TypeScript (PuyaTs) or Algorand Python (PuyaPy). Use when creating new smart contracts from scratch, adding features or methods to existing contracts, understanding Algorand contract development patterns, or getting guidance on contract architecture. Strong triggers include "create a smart contract", "write a contract that...", "build a voting contract", "implement an NFT contract", "add a method to the contract".
create-project
by algorand-devrel
Bootstraps production-ready AlgoKit projects for Algorand dApps and smart contracts. Use when initializing new Algorand smart contract projects, setting up development environments from scratch, or scaffolding dApps with pre-configured tooling. Strong triggers include "create a new project", "initialize a new Algorand app", "start a new smart contract", "set up AlgoKit", "scaffold a dApp", "algokit init".
algorand-ts-migration
by algorand-devrel
Migrate smart contracts to Algorand TypeScript 1.0 from either TEALScript or Algorand TypeScript Beta. Use when converting TEALScript contracts to Algorand TypeScript, upgrading Algorand TypeScript beta code to 1.0, user mentions migrating or upgrading to Algorand TypeScript / puya-ts / algo-ts 1.0, or user has TealScript code and wants to modernize it.
algorand-typescript
by algorand-devrel
Syntax rules and patterns for Algorand TypeScript (PuyaTs) smart contracts. Use when writing TypeScript contract code, encountering Puya compiler errors, asking about AVM types or value semantics, needing guidance on storage patterns (GlobalState, BoxMap), or asking about clone(), arrays, or inner transactions. Strong triggers include "Puya compiler error", "How do I use uint64?", "What is clone() for?", "BoxMap not working", "AVM type error", "GlobalState not updating".
test-smart-contracts
by algorand-devrel
Testing patterns for Algorand smart contracts using generated clients and algorandFixture. Use when writing tests for smart contracts, setting up test fixtures and deployment, debugging failing tests, testing multi-user scenarios, or asking about E2E vs unit testing. Strong triggers include "how do I test my contract", "algorandFixture", "test is failing", "LocalNet testing", "vitest setup", "fund contract for boxes".
deploy-react-frontend
by algorand-devrel
Create React frontends for Algorand dApps with wallet integration. Use when creating React frontends that interact with smart contracts, setting up wallet connections (Pera, Defly, Exodus), integrating typed app clients with wallet signers, or building dApp UIs that call contract methods. Strong triggers include "create a frontend for my contract", "add wallet connection to my React app", "how do I call my contract from the frontend?", "set up use-wallet with my typed client", "connect Pera wallet to my dApp", "algorand.setSigner".
implement-arc-standards
by algorand-devrel
Implement Algorand ARC standards in smart contracts and clients. Use when needing to understand ARC-4 ABI encoding or method signatures, working with application specifications (ARC-32 or ARC-56), calling ARC-4 methods from contracts or clients, encountering ABI encoding/decoding issues, or generating typed clients from app specs. Strong triggers include "What is ARC-4?", "How do I encode ABI arguments?", "What's the difference between ARC-32 and ARC-56?", "method selector not matching", "application specification", "arc56.json".
explain-algorand-x402-python
by algorand-devrel
Explain the x402-avm Python package for Algorand payment protocol integration. Use when developers ask about x402 Python package structure, extras installation ([avm], [evm], [svm], [fastapi], [flask], [httpx], [requests], [all]), signer protocols (ClientAvmSigner, FacilitatorAvmSigner), async vs sync variants, registration patterns, or algosdk encoding boundaries. Strong triggers include "how does x402 work in Python?", "explain x402-avm Python package", "what extras do I install?", "ClientAvmSigner vs FacilitatorAvmSigner", "algosdk encoding in x402", "async vs sync x402 Python", "how do I sign Algorand transactions in x402?", "msgpack_decode expects base64".
use-python-x402-core-avm
by algorand-devrel
Use the x402-avm Python package core and AVM mechanism directly for custom integrations. Use when working with x402 core components (x402Client, x402ResourceServer, x402Facilitator), implementing AVM signer protocols, using constants (ALGORAND_TESTNET_CAIP2, USDC ASA IDs), calling utility functions (address validation, amount conversion, transaction encoding), building custom payment flows, creating transaction groups, or understanding fee abstraction. Strong triggers include "use x402 Python SDK directly", "x402 core components", "AVM signer protocol", "Algorand constants", "transaction encoding", "fee abstraction", "custom x402 integration", "ExactAvmScheme", "to_atomic_amount", "decode_transaction_bytes".
create-python-x402-client
by algorand-devrel
Create x402 HTTP clients with httpx (async) or requests (sync) that automatically handle 402 payments on Algorand. Use when building Python HTTP clients that pay for API access, setting up automatic 402 payment handling, implementing ClientAvmSigner for payment signing, or choosing between httpx and requests for x402. Strong triggers include "create a Python x402 client", "httpx with x402 payments", "requests with x402 Algorand", "automatic 402 payment handling in Python", "wrapHttpxWithPayment", "wrapRequestsWithPayment", "x402HttpxClient setup", "x402_requests setup", "how do I pay for API access with Algorand in Python?", "ClientAvmSigner implementation".
explain-algorand-x402-typescript
by algorand-devrel
Explain x402-avm for TypeScript/JavaScript developers. Use when explaining @x402-avm/* package structure, signer interfaces (ClientAvmSigner, FacilitatorAvmSigner), registration patterns (registerExactAvmScheme), builder patterns, constants, utilities, and TypeScript-specific integration patterns. Strong triggers include "how do I use @x402-avm", "explain the TypeScript packages", "what is ClientAvmSigner", "what is FacilitatorAvmSigner", "how to register AVM scheme", "TypeScript x402 signer", "x402 avm package structure", "how does @x402-avm/avm work", "@x402-avm/core imports".
teach-algorand-x402
by algorand-devrel
Teach the x402 protocol with Algorand (AVM) integration. Use when explaining what x402 is, how Algorand integrates as a first-class citizen alongside EVM/SVM, the HTTP 402 payment flow, architecture of the three components (client, server, facilitator), CAIP-2 network identifiers, fee abstraction, ASA support, and both TypeScript and Python package ecosystems. Strong triggers include "what is x402", "how does x402 work with Algorand", "explain the payment flow", "what are the three components", "how do client server and facilitator interact", "x402 architecture", "teach me about x402-avm", "how does fee abstraction work".
create-python-x402-facilitator-bazaar
by algorand-devrel
Create Python x402 facilitator with Bazaar discovery extension for API cataloging. Use when adding Bazaar discovery to x402 resource servers, declaring discovery extensions on payment-gated routes, extracting discovery info on the facilitator side, validating extensions, building API catalogs for paid services, or integrating Bazaar with FastAPI/Flask servers. Strong triggers include "Bazaar discovery extension", "declare_discovery_extension", "API catalog for x402", "resource discovery", "bazaar_resource_server_extension", "extract_discovery_info", "paid API catalog", "machine-readable API menu", "x402 discovery".
create-typescript-x402-nextjs
by algorand-devrel
Create fullstack Next.js apps with x402 payment protection using paymentProxy and withX402. Use when building Next.js applications with payment-gated routes, setting up x402 middleware for API protection, creating paywalls with Algorand payments, or integrating x402 with App Router. Strong triggers include "Next.js x402 paywall", "payment proxy middleware", "withX402 route handler", "paymentProxyFromConfig", "protect Next.js routes with payments", "x402 middleware.ts", "payment-gated API", "Next.js Algorand payments", "@x402-avm/next".
call-smart-contracts
by algorand-devrel
Deploy and interact with Algorand smart contracts using AlgoKit CLI and generated TypeScript clients. Use when deploying contracts to localnet/testnet/mainnet, calling contract methods, reading global/local/box state, opting in or closing out of applications, or writing interaction scripts. Strong triggers include "deploy the contract", "call the increment method", "read the contract state", "opt into the app", "write a script to interact", "getTypedAppClientById".
use-algokit-utils
by algorand-devrel
AlgoKit Utils library for interacting with the Algorand blockchain from TypeScript or Python applications. Use when connecting to Algorand networks (LocalNet, TestNet, MainNet), sending payments or transferring assets, creating and managing accounts, deploying or interacting with smart contracts from client code, or composing transaction groups. NOT for writing smart contract code (use build-smart-contracts skill). Strong triggers include "How do I connect to Algorand?", "send a payment transaction", "create an account", "deploy my contract", "get an AlgorandClient", "AlgorandClient.fromEnvironment".
search-algorand-examples
by algorand-devrel
Search GitHub for Algorand smart contract examples and patterns. Use when finding example implementations of specific patterns (BoxMap, inner transactions), looking up contract feature usage, discovering Algorand repositories, or retrieving files from algorandfoundation repos. Strong triggers include "find an example of...", "show me how to use BoxMap", "search for voting contract examples", "get the code from puya-ts examples", "find Algorand NFT repositories".
troubleshoot-errors
by algorand-devrel
Diagnose and fix common Algorand errors including smart contract failures, transaction rejections, and SDK exceptions. Use when encountering smart contract logic errors or assertion failures, transaction rejections or confirmation timeouts, SDK exceptions (AlgodHTTPError, LogicError), account-related errors (insufficient balance, not opted in), or ABI encoding/decoding errors. Strong triggers include "logic eval error", "assert failed", "overspend", "transaction rejected", "pc=X" in error messages, "opcode budget exceeded", "account not found", "asset not found".
use-algokit-cli
by algorand-devrel
AlgoKit CLI commands for building, testing, and deploying Algorand applications. Use when building or compiling smart contracts, running test suites, deploying to localnet, managing local Algorand network, or understanding the development workflow. Strong triggers include "build the contract", "run the tests", "start localnet", "deploy to localnet", "algokit project run", "localnet status".