diff --git a/atto/README.md b/atto/README.md new file mode 100644 index 0000000..9d1a369 --- /dev/null +++ b/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/). diff --git a/atto/caip2.md b/atto/caip2.md new file mode 100644 index 0000000..67370a8 --- /dev/null +++ b/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:`. +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 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/).