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.
9. Governance execution flow
Sensitive administrative actions follow a staged execution sequence:
- Safe multisignature authorizes an action
- TokenActionRecorder may record the action metadata
- Timelock schedules the operation
- Minimum delay passes
- Timelock executes the operation
- 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
- The minimum delay has passed
- The operation has not already executed
- The operation has not been cancelled
- The grace period has not expired
- 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.
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.