DiamondStorage

🏠 Home > Smart Contracts/Overview > Libraries > DiamondStorage

DiamondStorage.sol is the single source of truth for all on-chain state in the Aurellion Diamond. Every facet reads and writes through the appStorage() accessor, which resolves to a fixed EVM storage slot, preventing collisions across upgrades.

---

Storage Position

bytes32 constant APP_STORAGE_POSITION = keccak256('diamond.app.storage');

function appStorage() internal pure returns (AppStorage storage s) {
    bytes32 position = APP_STORAGE_POSITION;
    assembly { s.slot := position }
}

This deterministic slot means:

• No storage variable can "shift" when new facets are added
• The same struct can be accessed from any facet without a shared import at runtime
• Storage layout upgrades are additive (append-only to avoid slot collisions)

---

RBAC Role Constants

bytes32 constant ADMIN_ROLE       = keccak256("ADMIN_ROLE");
bytes32 constant DRIVER_ROLE      = keccak256("DRIVER_ROLE");
bytes32 constant DISPATCHER_ROLE  = keccak256("DISPATCHER_ROLE");

Roles are checked via ausysRoles[role][address] in AppStorage.

---

AppStorage — Domain Sections

Ownership

Node Registry

ERC-1155 (AssetsFacet)

Aura Asset Registry

CLOB (V1)

CLOB V2 (Production)

Bridge (BridgeFacet)

AuSys (Logistics)

---

Key Struct Definitions

Node

struct Node {
    address owner;
    string nodeType;
    uint256 capacity;
    uint256 createdAt;
    bool active;
    bool validNode;
    string lat;
    string lng;
    string addressName;
}

NodeAsset

struct NodeAsset {
    address token;
    uint256 tokenId;
    uint256 price;
    uint256 capacity;
    uint256 createdAt;
}

AssetDefinition

struct AssetDefinition {
    string name;
    string assetClass;
    Attribute[] attributes;
}

struct Attribute {
    string name;
    string[] values;
    string description;
}

PackedOrder (V2)

struct PackedOrder {
    uint256 makerAndFlags;    // maker(160)|isBuy(1)|orderType(2)|status(2)|TIF(3)|nonce(88)
    uint256 priceAmountFilled; // price(96)|amount(96)|filledAmount(64)
    uint256 expiryCreatedMarket; // expiry(40)|createdAt(40)|marketIndex(32)|baseToken(160)
}

UnifiedOrder

struct UnifiedOrder {
    bytes32 clobOrderId;
    bytes32 clobTradeId;
    bytes32 ausysOrderId;
    address buyer;
    address seller;
    address sellerNode;
    address token;
    uint256 tokenId;
    uint256 tokenQuantity;
    uint256 price;
    uint256 bounty;
    uint256 escrowedAmount;
    uint8 status;         // OrderStatus constants
    uint8 logisticsStatus;
    uint256 createdAt;
    uint256 matchedAt;
    uint256 deliveredAt;
    uint256 settledAt;
    ParcelData deliveryData;
}

AuSysOrder

struct AuSysOrder {
    bytes32 id;
    address token;
    uint256 tokenId;
    uint256 tokenQuantity;
    uint256 price;
    uint256 txFee;
    address buyer;
    address seller;
    bytes32[] journeyIds;
    address[] nodes;
    uint256 requestedTokenQuantity;
    string startLat; string startLng;
    string endLat;   string endLng;
    string startName; string endName;
    uint8 currentStatus;
}

---

RWY Storage (Separate Slot)

RWY state lives in its own storage struct to keep AppStorage manageable:

bytes32 constant RWY_STORAGE_POSITION = keccak256('rwy.app.storage');

Key RWY fields: opportunities, stakerPositions, minOperatorCollateralBps, maxYieldBps, protocolFeeBps, defaultProcessingDays.

See Smart Contracts/Facets/RWYStakingFacet for the full RWY data model.

---

Adding New Storage

Always append to AppStorage. Never reorder, never remove (use "tombstone" bools instead). New domains that require significant state should get their own storage slot like RWYStorage.

---

Related Pages

• Architecture/Diamond Proxy Pattern
• Smart Contracts/Overview
• Smart Contracts/Facets/AssetsFacet