Protocol Model

This page defines how the ATAMO protocol operates at the contract and execution level. The system separates token logic, Safe authorization, delayed execution, governance-action recording, and participation coordination in order to restrict unilateral control and make administrative activity observable before completion.

Core protocol components

  • SecureToken proxy and implementation
  • ATAMO Custodian Safe
  • Timelock proxy and implementation
  • TokenActionRecorder governance-action recorder
  • ATMSParticipationVault participation and proposal-support layer

These components operate together so that sensitive administrative actions cannot execute instantly and must pass through a defined authorization and delay process.

1. Official mainnet addresses

Component Address Role
ATAMO Custodian Safe 0xe3b72bdb899364ce86949746D31CCba5f384b949 2-of-3 multisignature governance root
Timelock Proxy 0x2778BC96422AeD7D7Ac7CE21372Aa42c525A86B8 Delayed governance execution layer
Timelock Implementation 0xb0d8dc6a08Cb4F93a795c53867ac990C8ce4B0E0 Current Timelock logic implementation
SecureToken Proxy 0x38604c42c16e29BbFbc5479668453f18cB6cf335 Canonical user-facing ATMS ERC-20 token
SecureToken Implementation 0xD0E06380aF1927c5d929625406d7E9896a80C09c Current token logic implementation
TokenActionRecorder 0xAA7152784479Ed53147A12514602968327c9965E Governance-action metadata recorder
ATMSParticipationVault 0x01273Ef57CE09C4Aa615E3bd95eF2b9DD54fd0E4 Staking, proposal, support, and rewards layer

2. Protocol architecture

ATAMO operates through a separated-control architecture. Token state, Safe authorization, action recording, Timelock scheduling, and participation coordination are not combined into a single wallet or contract path.

This structure is designed to ensure that administrative actions remain constrained, reviewable, and dependent on multiple control steps before execution.

SecureToken

Enforces token accounting, balance tracking, transfer behavior, mint restrictions, pause state, upgrade authorization, and maximum supply.

Custodian Safe

Acts as the 2-of-3 multisignature governance root for sensitive protocol actions.

Timelock

Enforces delay, execution window, dependency checks, cancellation, and delayed execution before administrative actions take effect.

TokenActionRecorder

Records Safe-approved governance action metadata and Timelock execution parameters for mint, pause, unpause, and upgrade actions.

ATMSParticipationVault

Provides staking, staking lots, proposal creation, proposal support, execution-link tracking, and penalty-funded rewards.

3. Governance control chain

The core privileged execution chain is:

ATAMO Custodian Safe → Timelock Proxy → SecureToken Proxy → SecureToken Implementation

The TokenActionRecorder and ATMSParticipationVault support governance coordination and participation, but they do not bypass Timelock execution authority.

4. Token supply enforcement

ATAMO operates with a maximum supply of 200,000,000 ATMS.

Maximum supply in base units is 200000000000000000000000000.

The token contract enforces this cap during mint execution. Any attempt to mint above the maximum supply is rejected by contract logic.

ATAMO does not rely on off-chain policy statements for supply control. Supply enforcement exists at the contract level.

5. Issuance control

Token issuance is restricted to the Timelock-controlled execution path.

Minting is not available to a normal externally owned wallet and is not intended to be executed through direct discretionary action.

The mint path is restricted to Timelock-originated execution through: mintByTimelock(address to, uint256 amountBaseUnits)

Before minting can occur, the contract enforces: totalSupply + amountBaseUnits <= MAX_SUPPLY * 10 ** decimals()

This means issuance cannot exceed the defined supply cap through the normal administrative path.

6. Pause control

The protocol includes pause and unpause mechanisms intended for emergency control.

Pause authority is restricted to the Timelock path and is not designed as an instant single-wallet action.

This mechanism exists as a safety control and not as a routine operational shortcut.

7. Governance action recording

ATAMO separates Safe authorization, governance-action recording, and Timelock execution.

TokenActionRecorder records structured proposal metadata containing the target contract, encoded call data, predecessor dependency, uniqueness salt, and requested delay.

The recorder is Safe-only and does not execute actions itself. Execution still goes through the Timelock.

Supported recorder operation categories

  • MINT_BY_TIMELOCK
  • PAUSE
  • UNPAUSE
  • REQUEST_UPGRADE
  • APPROVE_UPGRADE

This model reduces the recording surface area by restricting recorder proposal types to defined token-administration operations.

8. Multisignature authorization

Governance action recording and Timelock scheduling are controlled by the ATAMO Custodian Safe.

Administrative actions therefore require multisignature approval before entering or progressing through the governance pipeline.

The multisignature Safe acts as the authorization entry point, reducing reliance on a single key holder.

Current Safe threshold: 2 of 3.

9. Governance execution flow

Sensitive administrative actions follow a staged execution sequence:

  1. Safe multisignature authorizes an action
  2. TokenActionRecorder may record the action metadata
  3. Timelock schedules the operation
  4. Minimum delay passes
  5. Timelock executes the operation
  6. Target contract applies the authorized change

Execution path: Safe → TokenActionRecorder → Timelock Scheduling → Delay Period → Execution → Target Contract

This structure is intended to prevent immediate discretionary execution of administrative actions.

10. Timelock enforcement

The Timelock contract is the protocol's delayed execution layer.

When an operation is scheduled, the Timelock records the earliest valid execution time, the latest valid execution time, execution status, and cancellation status.

A scheduled operation can execute only if all required conditions are satisfied.

Execution conditions

  1. The minimum delay has passed
  2. The operation has not already executed
  3. The operation has not been cancelled
  4. The grace period has not expired
  5. Any predecessor dependency has already executed

11. Minimum delay and grace period

Minimum delay

The Timelock enforces a minimum execution delay with a policy floor of 2 days / 172800 seconds.

Administrative actions cannot execute immediately after scheduling.

Grace period

After the delay has passed, execution remains valid only during a grace period with a policy floor of 60 days / 5184000 seconds.

Expired operations become invalid and must be scheduled again.

These rules prevent both instant execution and stale indefinite execution windows.

12. Cancellation controls

Scheduled operations may be cancelled before execution.

Cancellation authority may be held by the Timelock owner and by a designated guardian address.

The guardian functions as an emergency brake only. It does not grant authority to schedule new operations or execute existing ones.

Current deployed guardian: 0xe3b72bdb899364ce86949746D31CCba5f384b949.

13. Upgrade authorization model

The token contract uses an upgradeable architecture, but upgrades are restricted through a multi-step process.

Upgrade authorization is separated into:

  1. upgrade request
  2. upgrade approval
  3. UUPS upgrade execution

The request stage records a commitment hash for the proposed upgrade. The approval stage verifies that commitment and enforces timing constraints before authorization can proceed.

Upgrade verification checks

  • expected nonce verification
  • commit hash verification
  • timing window enforcement
  • Timelock authorization requirement
  • approved implementation matching

14. Upgrade constraints

Upgrades are not designed to function as an instant discretionary control path.

Upgrade requests are subject to a proposal delay of 2 days. If approval does not occur within the defined expiration period of 30 days, the request becomes invalid.

Protocol integrity constraints

  • upgrades must pass through the defined request and approval sequence
  • upgrades cannot execute instantly
  • upgrade activity remains publicly observable before execution
  • the protocol model is intended to preserve supply enforcement and structured authorization
  • upgrades are not presented as an unrestricted arbitrary admin override

Administrative authority exists, but it is structurally restricted by staged approval and delayed execution.

15. Operation identification and dependency control

Timelock operations are identified through a deterministic hash:

keccak256(abi.encode(target, data, predecessor, salt))

This identifier is derived from the operation parameters and allows independent tracking of scheduling, execution, and cancellation.

If a predecessor dependency is specified, execution cannot occur until the predecessor operation has completed.

16. Participation Vault model

ATMSParticipationVault is a separate participation and registry layer. It does not directly execute privileged token governance actions.

The vault supports staking, staking lots, cooldown-based withdrawal requests, early-unstake penalties, penalty-funded rewards, signal submission, proposal creation, weighted proposal support, proposal finalization, and execution-link tracking.

Participation properties

  • minimum participation stake is 50,000 ATMS
  • support threshold is 100,000 ATMS
  • reward eligibility age is 30 days
  • maximum active stake lots per wallet is 5
  • proposal support windows range from 1 day to 180 days
  • proposal creation requires mature active stake
  • support weight is based on reward-share accounting
  • proposal support does not automatically execute protocol changes

17. Observability and transparency

Major governance actions emit on-chain events, including proposal creation, scheduling, execution, cancellation, parameter updates, staking events, proposal support, and proposal finalization.

This allows external observers, monitoring tools, and block explorers to reconstruct governance and participation history directly from blockchain data.

Administrative activity is therefore observable through public on-chain records rather than off-chain claims alone.

18. Release and deployment verification

ATAMO v1.0.0 release verification is based on a signed Git tag and signed SHA256 checksum manifest.

Primary release files:

  • releases/v1.0.0/deployment-manifest.mainnet.json
  • releases/v1.0.0/deployment-records-full.mainnet.json
  • releases/v1.0.0/ATAMO_DEPLOYMENT_STATEMENT_mainnet_2026-05-16.txt
  • releases/v1.0.0/SHA256SUMS
  • releases/v1.0.0/SHA256SUMS.asc

These artifacts support independent verification of contract addresses, deployment records, ownership relationships, release integrity, and governance topology.

19. Security properties

  • token supply is capped at the contract level
  • minting authority is Timelock-restricted
  • administrative actions cannot execute instantly
  • multisignature authorization is required before privileged execution
  • upgrades require staged approval
  • scheduled actions may be cancelled before execution
  • governance activity is publicly observable on-chain
  • participation signaling is separated from execution authority

These properties do not remove administrative authority. They are intended to constrain it, delay it, and make it publicly observable.

20. Operational assumptions

Protocol security depends on the integrity of the multisignature signers, correct Timelock configuration, and active public monitoring of scheduled operations.

If the multisignature authority behaves maliciously, it may still authorize operations within the protocol rules. However, the Timelock delay ensures that such actions remain visible before execution.

ATAMO therefore relies on structured controls and public observability rather than claiming the absence of administrative power.

21. Protocol conclusion

ATAMO combines capped token supply, multisignature authorization, governance-action recording, delayed execution, cancellation capability, staged upgrade approval, and participation coordination into a single protocol control model.

The system is designed to avoid instant unilateral execution of sensitive actions while preserving the ability to manage protocol operations through a transparent and reviewable path.

ATAMO therefore operates as a controlled administrative protocol with verifiable execution rules, rather than as a token managed through unrestricted direct wallet authority.

22. Security Analysis

The ATAMO protocol separates authority, action recording, execution, and participation into distinct layers. This architecture is designed to reduce single-actor control risk and to create a visible review window before sensitive actions complete.

Authorization control

Privileged action authorization is controlled by a 2-of-3 Safe rather than a single operational wallet.

Execution delay

Timelock enforcement prevents immediate execution and creates an observation window for scheduled actions.

Supply protection

Mint execution remains bounded by the contract-level maximum supply check.

Security interpretation

  • administrative actions require multisignature authorization
  • scheduled actions remain cancellable before execution
  • upgrade flow requires staged approval rather than direct replacement
  • governance history can be monitored through on-chain events
  • participation support coordinates visibility but does not bypass Timelock execution
  • the model increases transparency without pretending admin authority does not exist

The security model is therefore based on separation of roles, execution delay, bounded authority, and public observability.