Algorand TypeScript Rules

Critical syntax rules for Algorand TypeScript (PuyaTs) that prevent compiler errors and runtime failures.

File Extension: Contract files must use .algo.ts extension (e.g., Counter.algo.ts).

Overview / Core Workflow

1. Identify the syntax issue or pattern needed
2. Apply the correct AVM-compatible pattern
3. Use clone() for complex types
4. Verify no union types or JavaScript number

How to proceed

1. Check the most critical rules below
2. Consult detailed reference files for specific topics
3. Apply the correct pattern with proper AVM types
4. Build to verify: algokit project run build