Add atto namespace and CAIP-2 specification

atto/README.md

@@ -0,0 +1,47 @@
+---
+namespace-identifier: atto
+title: Atto Ecosystem
+author: Felipe Rotilho (@rotilho)
+status: Draft
+type: Informational
+created: 2026-03-18
+---
+
+# Namespace for Atto Networks
+
+## Introduction
+
+The `atto` namespace refers to the Atto ecosystem:
+a feeless account-chain payment network where value transfers are represented as native Atto blocks and transactions.
+
+Atto is a native layer-1 system with its own chain model, transaction encoding, and account addressing, all defined by the Atto protocol.
+
+The purpose of this namespace is to provide stable chain identifiers for Atto networks and a neutral reference point for cross-chain tooling built on CAIPs.
+
+## Rationale
+
+Atto needs its own namespace because it introduces a distinct execution and validation model.
+Native account-chain semantics, address encoding, and transaction serialization do not fit under existing namespaces such as EVM, Solana, or Stellar.
+A dedicated namespace allows tools to refer to Atto deployment environments consistently using human-readable CAIP-2 identifiers.
+
+## Governance
+
+This namespace tracks the Atto protocol and its network identifiers as defined by the Atto ecosystem maintainers.
+Future CAIP profiles for Atto should follow this namespace to document account IDs, asset IDs, and other ecosystem-specific conventions.
+Public network naming should remain stable over time to ensure long-term interoperability.
+
+## References
+
+- [Documentation][] - Official documentation for the Atto ecosystem.
+- [Node API Reference][] - Reference for the Atto node RPC and REST interfaces.
+- [Integration Guide][] - Overview of Atto components, integration model, and operational guidance.
+- [GitHub][] - Source code and development resources.
+
+[Documentation]: https://atto.cash/docs
+[Node API Reference]: https://atto.cash/api/node
+[Integration Guide]: https://atto.cash/docs/integration
+[GitHub]: https://github.com/attocash
+
+## Copyright
+
+Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).

atto/caip2.md

@@ -0,0 +1,150 @@
+---
+namespace-identifier: atto-caip2
+title: Atto Namespace - Blockchain ID Specification
+author: Felipe Rotilho (@rotilho)
+discussions-to: https://github.com/ChainAgnostic/namespaces/pull/178
+status: Draft
+type: Standard
+created: 2026-03-18
+requires: CAIP-2
+---
+
+# CAIP-2
+
+*For context, see the [CAIP-2][] specification.*
+
+## Introduction
+
+The `atto` namespace identifies Atto chains.
+Atto is a native layer-1 payment network with an account-chain model, native address format, native transaction
+serialization, and lightweight proof-of-work used for anti-spam rather than consensus.
+
+A CAIP-2 identifier in this namespace takes the form `atto:<reference>`.
+The reference identifies a concrete Atto network environment such as mainnet, beta/test, development, or local/private
+development.
+
+## Specification
+
+### Semantics
+
+The `atto` namespace is intended for chains that use the native Atto protocol and validation model.
+A valid CAIP-2 identifier in this namespace refers to an Atto network that shares Atto's block model, address model,
+signing rules, and proof-of-work rules.
+
+The following references are defined by this draft:
+
+- `live` — Atto mainnet
+- `beta` — Atto public beta / test network
+- `dev` — Atto development network
+- `local` — local or private development network
+
+These references are intentionally short and stable.
+They are meant to be human-readable deployment identifiers rather than hashes of genesis state.
+
+### Syntax
+
+An Atto blockchain ID is a CAIP-2 string with namespace `atto` and a lowercase network reference.
+
+Canonical format:
+
+```text
+atto:<reference>
+```
+
+Reference values currently defined by this draft:
+
+```text
+live | beta | dev | local
+```
+
+Suggested validation regex:
+
+```text
+^atto:(live|beta|dev|local)$
+```
+
+Implementations MUST treat the namespace component as exactly `atto`.
+Implementations SHOULD treat the reference component as lowercase.
+Unknown future references within the `atto` namespace SHOULD be rejected unless explicitly supported by the
+implementation.
+
+### Resolution Mechanics
+
+Resolution of an Atto CAIP-2 identifier is performed by selecting a node or service configured for the corresponding
+Atto network environment.
+The identifier therefore resolves operationally through network-specific Atto infrastructure rather than through
+on-chain contract registries.
+
+For public/shared environments, implementations SHOULD map the following identifiers to their corresponding Atto
+deployments:
+
+- `atto:live` → mainnet infrastructure
+- `atto:beta` → public beta/test infrastructure
+- `atto:dev` → development infrastructure
+- `atto:local` → local/private development infrastructure
+
+If an implementation exposes multiple Atto environments, it MUST ensure that transactions, account state reads, and
+address validation are performed against infrastructure for the selected Atto chain only.
+
+## Rationale
+
+Atto needs a dedicated namespace because its interoperability assumptions are not those of any existing namespace.
+The same client or wallet logic used for EVM, Stellar, or Solana cannot be reused without Atto-specific validation
+logic.
+Atto-native tooling must understand native account-chain state, native address encoding, and Atto-native transaction
+verification.
+
+The references `live`, `beta`, `dev`, and `local` are chosen because they are short, operationally intuitive, and
+consistent with how integrators commonly distinguish production, test, development, and local environments.
+This draft intentionally avoids deriving chain identifiers from opaque hashes or environment-specific values that are
+less legible for wallet and payment tooling.
+
+### Backwards Compatibility
+
+Not applicable.
+
+## Test Cases
+
+```text
+# Atto mainnet
+atto:live
+
+# Atto public beta / test network
+atto:beta
+
+# Atto development network
+atto:dev
+
+# Atto local / private development network
+atto:local
+```
+
+## Additional Considerations
+
+This draft only defines CAIP-2 identifiers for Atto chains.
+Additional Atto namespace profiles may later define:
+
+- CAIP-10 account identifiers for Atto addresses
+- CAIP-19 asset identifiers for the native Atto asset and future asset models, if any
+- Other Atto-specific profiles where cross-chain tooling benefits from explicit namespace guidance
+
+## References
+
+- [Documentation][] - Official documentation for the Atto ecosystem.
+- [Node API Reference][] - Reference for the Atto node RPC and REST interfaces.
+- [Integration Guide][] - Overview of Atto components, integration model, and operational guidance.
+- [GitHub][] - Source code and development resources.
+
+[Documentation]: https://atto.cash/docs
+
+[Node API Reference]: https://atto.cash/api/node
+
+[Integration Guide]: https://atto.cash/docs/integration
+
+[GitHub]: https://github.com/attocash
+
+[CAIP-2]: https://chainagnostic.org/CAIPs/caip-2
+
+## Copyright
+
+Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).