Comprehensive guide for Algorand TypeScript (PuyaTs) smart contract development — syntax rules, migration, testing, deployment, React frontends, AlgoKit Utils, ARC standards, and troubleshooting. This is the parent skill for all TypeScript-specific Algorand content. Use when writing TypeScript contract code, encountering Puya compiler errors, migrating from TEALScript or beta, testing contracts with Vitest, deploying with typed clients, building React frontends, or using AlgoKit Utils in TypeScript. Strong triggers include "Puya compiler error", "uint64", "clone()", "BoxMap", ".algo.ts", "migrate from TEALScript", "algorandFixture", "vitest", "deploy contract", "call method", "React frontend", "use-wallet", "AlgorandClient TypeScript", "npm install algokit-utils".
This is the aggregated parent skill for all TypeScript-specific Algorand development. Use the reference files below to find detailed guidance for each topic.
# Create TypeScript project
algokit init -n my-project -t typescript --answer preset_name production --defaults
# Install AlgoKit Utils
npm install @algorandfoundation/algokit-utils
# Development cycle
algokit project run build # Compile .algo.ts contracts
algokit project run test # Run Vitest tests
Contract files must use .algo.ts extension. Use AVM types (uint64, bytes), never JavaScript number. Always clone() complex types.
Navigate to the appropriate reference based on your task. Each topic has one or more files.
Critical syntax rules for Algorand TypeScript (PuyaTs) that prevent compiler errors.
Migrate from TEALScript or Algorand TypeScript Beta to 1.0.
Write integration and unit tests using algorandFixture and Vitest.
Deploy and interact with contracts using generated TypeScript clients.
Build React frontends with wallet integration and typed contract clients.
Initialize TypeScript AlgoKit projects with proper templates and presets.
TypeScript-specific contract building with PuyaTs.
Interact with Algorand from TypeScript applications.
TypeScript implementations of ARC-4, ARC-32, and ARC-56.
TypeScript-specific error diagnosis and fixes.
| Topic | Files | Description | | ----- | ----- | ----------- | | Syntax Rules | 6 | PuyaTs types, storage, methods, transactions | | Migration | 3 | TEALScript and beta migration guides | | Testing | 3 | Vitest integration and unit tests | | Calling Contracts | 2 | Deployment and typed client interaction | | React Frontends | 3 | Wallet integration and dApp UI | | Create Project | 2 | TypeScript template initialization | | Build Contracts | 2 | TypeScript-focused contract building | | AlgoKit Utils | 2 | AlgorandClient TypeScript API | | ARC Standards | 3 | TypeScript ARC implementations | | Troubleshoot | 3 | TypeScript error fixes |
.md file for step-by-step guidancealgorand-development parent skillnpx skills add GoPlausible/Algorand TypeScript（PuyaTs）下载完整 Skill 目录，包含 SKILL.md 及所有相关文件
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer