chore: update changelog for spec 21

Author: saiintbrisson

CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## Spec 21
+
+This release introduces major architectural changes to enable decentralized economic relationships, improved governance flexibility, and preparation for off-chain service integration. The changes span several months of development focused on creating a more sophisticated and scalable network.
+
+### Major Features
+
+#### Permission System (permission0 pallet)
+
+A comprehensive permission framework that revolutionizes how agents interact economically within the network:
+
+- Agents can now share their token emissions with contributors through recursive permission trees. Supports percentage-based streams or fixed amounts, with flexible distribution controls (manual, automatic threshold, scheduled).
+- Permissions can be managed by arbiters (multi-sig groups) for enhanced security and decentralized control.
+- Governance powers are now granular with specific permissions for application review, whitelist management, and penalty control. Replaces the old curator system with a more flexible approach.
+- Built-in protections against double-spending and infinite recursion ensure tokenomics.
+
+#### Namespace System
+
+A hierarchical naming system that functions as decentralized DNS/capability listing for agent services:
+
+- Agents can create dot-separated paths like `agent.alice.api.v2` to organize their off-chain services.
+- Owning a namespace gives control over all sub-paths, enabling structured delegation of services.
+- Base fees go to treasury while refundable deposits incentivize efficient storage use.
+- Namespaces can be delegated through the permission system, enabling complex service architectures.
+
+#### Agent Management Improvements
+
+- Agent names are automatically converted to namespace-compliant format (lowercase, no spaces) during the upgrade.
+- Curators can now freeze/unfreeze agents, adding a new governance tool for spam control.
+- Agent metadata updates now have cooldowns to prevent spam and ensure stability.
+- Burn parameters adjusted for better economic balance during high registration activity.
+
+#### Economic Enhancements
+
+- All transaction fees now flow to the treasury instead of being burned, providing sustainable funding for network development.
+- Only whitelisted agents receive emissions, ensuring quality participants chosen by the DAO are rewarded.
+- Permission holders can dynamically adjust how they distribute received emissions.
+- Distribution remainders are now properly accumulated, preventing token loss.
+
+#### Developer Experience
+
+- Proof-of-work based faucet for obtaining testnet tokens, preventing abuse while maintaining accessibility.
+- Comprehensive docs for all pallets now auto-published to GitHub Pages.
+- New `torus0_namespacePathCreationCost` RPC for calculating namespace fees upfront.
+- Integrated coverage reporting with `cargo xtask coverage` for maintaining code quality.
+
+### Bug Fixes & Safety Improvements
+
+- Critical fix ensuring stakes are properly refunded before clearing storage during de-registration.
+- Banned arithmetic side effects throughout the runtime, using saturating operations to prevent overflows.
+- All agents now automatically delegate weights to allocators, simplifying the onboarding process.
+
+### Governance Changes
+
+- Instead of all-or-nothing curator status, specific permissions can be granted.
+- Improved with better event emissions and clearer execution flows.
+- Now integrated with the permission system for more flexible control.
+
+### Infrastructure
+
+- Enhanced GitHub Actions for automated testing, documentation, and Docker builds.
+- Added development container configuration for consistent environments.
+- Migrated CI infrastructure for better performance.
+
+This release represents a fundamental evolution of the Torus Network, creating the foundation for a truly decentralized economy where agents can form complex relationships, share resources, and organize their services in meaningful ways.
+
 ## Spec version 12
 
 ### Critical Migration & Bug Fix
@@ -50,7 +115,7 @@ You can find the migration here:
 
 The migration calculates the difference between `TotalStake` (which remained **correctly** unchanged) and sums all actual stakes on the network. The difference is then sent to a recovery account, and redistributed to the original stakers via script
 
-**Original Stakers (OS)** 
+**Original Stakers (OS)**
 
 ```text
 5CuBSdUuBeLVxtzrTtrdiCjipEgjbvUoMJjxrss4T9f1MEoZ: 178467095451535513057748
@@ -87,4 +152,3 @@ The migration calculates the difference between `TotalStake` (which remained **c
 - Applied saturating arithmetic in various runtime and pallet modules to prevent overflow issues.
 - Improved arithmetic safety and robustness in emission and governance modules.
 - Refined author identification and gas limit calculations with safer arithmetic operations.
-