OASIS Architecture

System Architecture

OASIS implements a layered architecture with clear separation of concerns. The platform enables applications to interact with multiple providers through a consistent API.

Key Components

• OASIS Web API — RESTful API gateway that exposes OASIS functionality to client applications
• Core Managers — Implements business logic and orchestrates interactions between components
• Provider System — Manages different storage and network providers through a common interface
• OASIS BootLoader — Initializes the system and bootstraps the provider architecture
• OASIS DNA — Configuration system that defines platform behavior and settings

---

Provider Architecture

The provider system is a cornerstone of OASIS, enabling the platform to interact with multiple storage and network technologies through a unified interface.

• Pluggable architecture — Common interface (IOASISProvider) for all providers
• Provider lifecycle — Activation, deactivation, and registration
• Automatic failover — If one provider fails, operations route to available providers
• Data replication — Holons replicated across multiple providers
• Load balancing — Distributes requests efficiently across providers

---

Avatar System

The Avatar system serves as the identity and authentication layer within OASIS.

• User registration — With email verification
• JWT-based authentication — With refresh tokens
• Profile management — Including avatar portraits
• Karma tracking — Rewards and reputation
• Role-based authorization — Wizard/Admin roles

---

Key Concepts

Holons

Holons are the fundamental data objects in OASIS, implementing a hierarchical structure where objects can have parent-child relationships. A holon is both a whole (it can stand alone) and a part (it can belong to a larger structure). Every persistable entity implements the core holon interfaces.

Provider Types

Category	Examples
Storage Providers	MongoDBOASIS, SQLLiteDBOASIS, Neo4jOASIS, AzureCosmosDBOASIS
Network Providers	HoloOASIS, IPFSOASIS, ActivityPubOASIS
Blockchain Providers	EthereumOASIS, SolanaOASIS, ArbitrumOASIS, PolygonOASIS
Other Providers	WRLDMapOASIS, MapboxOASIS, CargoOASIS

---

OASIS Result Pattern

OASIS implements a consistent result pattern through OASISResult<T>, which encapsulates the operation result, success/failure indicators, error messages, and metadata. This provides consistent error handling and response formatting throughout the system.

---