AOXC Sui Protocol is a modular infrastructure stack designed for secure asset management, verifiable governance, and deterministic cross-chain coordination within the Sui ecosystem.
Institutional Notice
This repository is currently undergoing active development and security hardening.
Core modules are functional, while architecture stabilization, internal audits, and operational safeguards continue to evolve toward production readiness.
AOXC Sui Protocol provides a high-integrity framework for managing Sui-native digital assets under deterministic governance and security guarantees.
The system integrates:
- object-centric asset custody
- governance primitives with multi-layer safeguards
- structured bridge payload validation
- autonomous treasury distribution logic
- AI-assisted operational intelligence
The architecture is designed to preserve protocol integrity while supporting long-term extensibility.
AOXC is Sui-first by design, while still supporting cross-layer coordination with typed payloads.
Why this preference:
- Object-centric security model: strongly typed objects and explicit ownership reduce state ambiguity.
- Deterministic asset lifecycle: easier to reason about custody, transfer, and policy enforcement.
- Move-native safety ergonomics: capability-based access control patterns align with protocol governance hardening.
Where XLayer still matters:
- as an external coordination source for cross-chain signaling,
- for bridge command interoperability through typed payload validation.
In short: this repository treats Sui as the execution/security anchor, and XLayer as an interoperability domain.
Assets are implemented as strongly typed Sui objects ensuring deterministic ownership, traceability, and composability.
DAO governance with timelock enforcement, multi-signature controls, and veto authority for protocol safety.
Rule-based treasury operations managing Coin<T> vault distribution and policy-constrained allocations.
Typed bridge payload structures designed to reduce ambiguity in cross-chain asset operations.
Operational intelligence modules designed to support governance analysis while remaining policy-constrained.
The repository is organized around modular Move packages.
Core protocol logic implemented using the Move programming language.
Primary modules include:
- asset object model
- governance infrastructure
- treasury vault systems
- reputation scoring mechanisms
- protocol circuit breakers
- bridge payload validation
- zk light client verifier
- walrus-backed archive connector
- auto rebalancer for economic mismatch response
- verifier registry for pluggable trust backends
- reserved protocol events for AI-agent forward compatibility
Each module is designed with strict type safety and explicit ownership semantics.
Technical documentation and operational specifications, including the project whitepaper.
Key documents include:
- threat modeling and attack surface evaluation
- formal protocol invariants
- release verification procedures
- indexer operational runbooks
- architecture specifications
- whitepaper (vision, security posture, roadmap to production)
- future readiness plan (audit closure + crypto agility roadmap)
- code audit report (module-by-module findings and action plan)
- architecture alignment (Sui-first execution + XLayer interoperability fit)
- compatibility matrix (EVM + Cardano + Web relay domain mapping)
- audit evidence bundle template (mainnet-candidate release artifacts)
- production-ready report (gas/object/web4 compatibility scoring)
Supporting documentation and technical specifications for AI-assisted operational systems interacting with protocol governance.
aoxcore-sui/
│
├─ sources/ # Move protocol modules
│
├─ docs/ # Technical specifications
│
├─ ai/ # AI integration documentation
│
├─ Move.toml
└─ README.md
Current development emphasizes protocol resilience and operational correctness.
Emergency protocol safety mechanism capable of halting critical operations when invariant violations are detected.
Implementation:
sources/circuit_breaker.move
Structured payload types replace raw byte-level transfer logic, enabling safer cross-chain message verification.
Implementation:
sources/bridge_payload.move
Vault infrastructure managing Coin<T> assets under rule-based distribution policies.
Implementation:
sources/treasury.move
Advanced staking model enabling:
- automated compounding
- slashing logic
- reputation-linked reward flows
Decentralized dataset and model licensing infrastructure enabling AI data routing through Walrus storage protocols.
sources/aoxc.move
Defines the neural asset object model with cryptographic lineage guarantees.
Features include:
- asset provenance
- deterministic ownership transfer
- composable protocol extensions
sources/sentinel_dao.move
Institutional governance module implementing:
- timelocked governance execution
- multi-signature emergency veto
- policy-constrained administrative actions
sources/reputation.move
On-chain scoring system aggregating:
- governance participation
- cross-protocol attestations
- trust signals for protocol operators
Protocol security is enforced through layered validation strategies.
Security components include:
- formal invariant verification
- threat modeling
- release gate validation
- deterministic state transitions
- circuit breaker enforcement
| Document | Focus | Status |
|---|---|---|
| Threat Model | Attack surface analysis | Active |
| Release Checklist | Deployment verification | Mandatory |
| Formal Invariants | Protocol logic constraints | In Review |
| Indexer Runbook | Operational reconciliation | Draft |
Documentation is located within:
docs/
To work with the protocol locally, install the Sui toolchain.
Requirements:
- Sui CLI
- Rust toolchain
- Git
Install Sui:
cargo install --locked --git https://github.com/MystenLabs/sui.git sui
Verify installation:
sui --version
Compile Move modules:
sui move build
Run tests:
sui move test
Deployment instructions and environment preparation guidelines are documented in:
docs/DEPLOYMENT.md
Deployment includes:
- package compilation
- object publishing
- capability assignment
- governance initialization
Typical development cycle:
- implement protocol changes
- update Move module tests
- verify invariants
- run local simulation
- open pull request
- security review and merge
All protocol changes must maintain invariant integrity.
Strategic documentation is available in the /docs directory.
Key documents include:
- Architecture Overview
- Protocol Economy Model
- Gap Analysis
- AI Integration Framework
This project is licensed under the MIT License.
See the LICENSE file for details.
Aşağıdaki yaklaşım, "mainnet’e yakın" test ve release disiplinini minimum baseline olarak önerir.
- Unit/Invariant tests (her PR): input doğrulama, abort-code eşleşmesi, whitelist/allowlist kontrolleri.
- Scenario tests (her PR): bridge -> dao -> treasury akışlarında failure-recovery yolları.
- Release-candidate tests (tag öncesi): deterministik tekrar koşuları + event schema uyumluluğu.
Aşağıdaki kapılar geçmeden merge önerilmez:
move fmt(veya eşdeğer format kontrolü)sui move buildsui move test- Abort-code regression kontrolü (özellikle
errors.movesabitleri) - Docs/spec drift kontrolü (
docs/SPEC.mdile modül davranışı eşleşmeli)
- Commit hash + tag + build metadata
- Test çıktısı ve hashlenmiş artefact seti
- Tehdit modeli güncelleme kaydı
- Değişen modüller için "invariant impact" özeti
- İki imzacıyla release onayı (4-eyes)
bridge_payload katmanı XLayer/EVM + Cardano + web domain id allowlist’i uygular.
Domain’e özel imza/finality doğrulamaları üst katmanda ayrıca zorunlu tutulmalıdır.
Audit evidence template: docs/AUDIT_EVIDENCE_BUNDLE.md.
Bu depoya, AOXCON ve AOXCHAIN entegrasyonu için çoklu klasör yapısı eklendi:
cli/→ Etkileşimli terminal menüsü (python3 cli/aoxchain_cli.py)frontend/→ Hızlı başlangıç frontpage (frontend/index.html)examples/contracts/→ Çoklu Move sözleşme örnekleriscripts/bootstrap.sh→ Build + test otomasyon akışısdk/ts/→ TypeScript istemci SDK başlangıç alanı
Bu yapı, Move tabanlı geliştirme akışını daha modüler ve genişletilebilir hale getirmek için hazırlanmıştır.
python3 cli/aoxchain_cli.py manifest --json
python3 cli/aoxchain_cli.py examples
python3 cli/aoxchain_cli.py build
python3 cli/aoxchain_cli.py test