MuonStorage (0.8.5)

The MuonStorage library provides a storage slot for Muon-related configuration data. LibMuon modules read settings from it: signature validity periods, application identifiers, public keys, and trusted gateway addresses.

---

Data Structures

These structures define the signature and configuration data types used across the Muon ecosystem.

SchnorrSign

Schnorr signature used for cryptographic verification.

• signature: The signature (uint256).

• owner: Address that generated the signature.

• nonce: Extra parameter for uniqueness (prevents replay attacks).

struct SchnorrSign {
    uint256 signature;
    address owner;
    address nonce;
}

---

PublicKey

Public key for signature verification.

• x: The x-coordinate on the elliptic curve.

• parity: Parity of the y-coordinate, used to recover the full public key.

struct PublicKey {
    uint256 x;
    uint8 parity;
}

---

SingleUpnlSig

Verifies a single unrealized profit and loss (uPnl) computation for one party.

• reqId: Unique identifier for the request.

• timestamp: Time the signature was generated.

• upnl: The computed uPnl (positive or negative).

• gatewaySignature: Secondary signature from Muon.

• sigs: SchnorrSign structure holding the primary signature.

struct SingleUpnlSig {
    bytes reqId;
    uint256 timestamp;
    int256 upnl;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

SingleUpnlAndPriceSig

Extends SingleUpnlSig with asset price information.

• price: Asset price used in uPnl verification.

struct SingleUpnlAndPriceSig {
    bytes reqId;
    uint256 timestamp;
    int256 upnl;
    uint256 price;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

PairUpnlSig

uPnl values for two parties (PartyA and PartyB).

• upnlPartyA: uPnl for PartyA.

• upnlPartyB: uPnl for PartyB.

struct PairUpnlSig {
    bytes reqId;
    uint256 timestamp;
    int256 upnlPartyA;
    int256 upnlPartyB;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

PairUpnlAndPriceSig

Combines pair uPnl data with price information.

• price: Asset price used in both parties' uPnl calculations.

struct PairUpnlAndPriceSig {
    bytes reqId;
    uint256 timestamp;
    int256 upnlPartyA;
    int256 upnlPartyB;
    uint256 price;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

PairUpnlAndPricesSig

Extends the pair uPnl and price data to multiple symbols.

• symbolIds: Array of symbol identifiers.

• prices: Array of corresponding prices.

struct PairUpnlAndPricesSig {
    bytes reqId;
    uint256 timestamp;
    int256 upnlPartyA;
    int256 upnlPartyB;
    uint256[] symbolIds;
    uint256[] prices;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

DeferredLiquidationSig

For deferred liquidation, where access revocation or delayed processing is needed.

• liquidationBlockNumber: Block number when insolvency was detected.

• liquidationTimestamp: Timestamp of insolvency.

• liquidationAllocatedBalance: Allocated balance at insolvency.

• liquidationId: Unique liquidation event identifier.

• upnl: uPnl at insolvency.

• totalUnrealizedLoss: Total loss triggering liquidation.

• symbolIds & prices: Arrays of the symbol IDs involved and their prices.

struct DeferredLiquidationSig {
    bytes reqId;
    uint256 timestamp;
    uint256 liquidationBlockNumber;
    uint256 liquidationTimestamp;
    uint256 liquidationAllocatedBalance;
    bytes liquidationId;
    int256 upnl;
    int256 totalUnrealizedLoss;
    uint256[] symbolIds;
    uint256[] prices;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

LiquidationSig

Like DeferredLiquidationSig, but for immediate liquidation.

struct LiquidationSig {
    bytes reqId;
    uint256 timestamp;
    bytes liquidationId;
    int256 upnl;
    int256 totalUnrealizedLoss;
    uint256[] symbolIds;
    uint256[] prices;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

QuotePriceSig

Verifies price data for multiple quotes at once.

• quoteIds: Array of quote identifiers.

• prices: Corresponding price for each quote.

struct QuotePriceSig {
    bytes reqId;
    uint256 timestamp;
    uint256[] quoteIds;
    uint256[] prices;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

HighLowPriceSig

Price range information for a single symbol.

• symbolId: Trading symbol identifier.

• highest: Highest observed price in the period.

• lowest: Lowest observed price in the period.

• averagePrice: Average price over the period.

• startTime & endTime: Time window the prices were observed over.

• currentPrice: Current price used for calculations.

• upnlPartyB & upnlPartyA: uPnl values for both parties (if applicable).

struct HighLowPriceSig {
    bytes reqId;
    uint256 timestamp;
    uint256 symbolId;
    uint256 highest;
    uint256 lowest;
    uint256 averagePrice;
    uint256 startTime;
    uint256 endTime;
    int256 upnlPartyB;
    int256 upnlPartyA;
    uint256 currentPrice;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

QuoteSettlementData

Settlement data for a quote.

• quoteId: Quote identifier.

• currentPrice: Price at settlement.

• partyBUpnlIndex: Index of which PartyB uPnl is used.

struct QuoteSettlementData {
    uint256 quoteId;
    uint256 currentPrice;
    uint8 partyBUpnlIndex;
}

---

SettlementSig

Aggregates quote settlement data and overall uPnl information during settlement.

• quotesSettlementsData: Array of QuoteSettlementData structures.

• upnlPartyBs: Array of uPnl values for PartyBs.

• upnlPartyA: uPnl value for PartyA.

struct SettlementSig {
    bytes reqId;
    uint256 timestamp;
    QuoteSettlementData[] quotesSettlementsData;
    int256[] upnlPartyBs;
    int256 upnlPartyA;
    bytes gatewaySignature;
    SchnorrSign sigs;
}

---

MuonStorage Library

The MuonStorage library reserves a storage slot for all Muon-related configuration data. It exposes one method to access the layout, and through it the Muon settings.

Storage Layout

The layout struct holds:

• upnlValidTime: How long (in seconds) a uPnl signature stays valid.

• priceValidTime: Validity period for price data.

• priceQuantityValidTime: Currently unused; may be removed in a future update.

• muonAppId: Unique identifier for the Muon application.

• muonPublicKey: The public key (type PublicKey) used to verify signatures.

• validGateway: Address of the trusted gateway whose signatures are accepted.

library MuonStorage {
    bytes32 internal constant MUON_STORAGE_SLOT = keccak256("diamond.standard.storage.muon");

    struct Layout {
        uint256 upnlValidTime;
        uint256 priceValidTime;
        uint256 priceQuantityValidTime; // UNUSED: Should be deleted later
        uint256 muonAppId;
        PublicKey muonPublicKey;
        address validGateway;
    }

    function layout() internal pure returns (Layout storage l) {
        bytes32 slot = MUON_STORAGE_SLOT;
        assembly {
            l.slot := slot
        }
    }
}