midnight-mcp 0.1.2 → 0.1.3

package/dist/resources/content/docs-content.js

@@ -892,6 +892,282 @@ export circuit unpause(): [] {
 3. **Test pause scenarios** thoroughly
 4. **Document pause conditions** for users
 5. **Consider timelock** for unpause in high-value contracts
+`,
+    "midnight://docs/tokenomics": `# Midnight Tokenomics and Incentives Whitepaper
+
+## Overview
+
+Midnight introduces a novel dual-component tokenomics system with NIGHT (utility token) and DUST (transaction resource), designed for operational predictability, privacy, and cross-chain cooperation.
+
+## Core Pillars
+
+1. **Operational Predictability**: NIGHT generates DUST continuously, enabling transactions without direct token expenditure
+2. **Rational Privacy**: DUST is shielded - transactions don't leave metadata trails
+3. **Cooperative Tokenomics**: Multi-chain architecture enables cross-chain value creation
+4. **Fair Distribution**: Free, multi-phase token distribution (Glacier Drop)
+
+---
+
+## The NIGHT Token
+
+NIGHT is Midnight's native utility token. One NIGHT = 1,000,000 STARs.
+
+### Key Properties
+
+- **Unshielded**: NIGHT transactions are publicly visible on-chain
+- **Transferable**: Can be freely transferred, listed on exchanges, bridged across networks
+- **Total Supply**: 24 billion NIGHT tokens
+- **Non-expendable**: Not consumed to execute transactions
+- **Disinflationary**: Circulating supply expansion slows over time
+- **Multi-chain Native**: Exists natively on both Cardano (as Native Asset) and Midnight
+
+### Stakeholders
+
+- **NIGHT Token Holders**: Control future network governance
+- **Midnight Block Producers (MBPs)**: Validate blocks, receive rewards
+- **Midnight Foundation**: Long-term ecosystem development
+- **On-chain Treasury**: Protocol-managed fund for ecosystem growth
+- **Reserve**: Protocol-managed pool for block production rewards
+
+### Cross-Chain Token States
+
+Tokens can be:
+- **Protocol-locked**: Cannot move or generate DUST
+- **Protocol-unlocked**: Full utility and transferability
+
+Key invariant: A token unlocked on one chain is locked on the other, ensuring effective supply never exceeds 24 billion.
+
+### Cross-Chain Invariants
+
+\`\`\`
+C.R + C.L + C.U = M.R + M.L + M.U = S (24 billion)
+
+Where:
+- C = Cardano, M = Midnight
+- R = Reserve, L = Locked, U = Unlocked
+- S = Total Supply
+\`\`\`
+
+---
+
+## The DUST Resource
+
+DUST is the shielded, renewable resource for transaction fees.
+
+### Key Properties
+
+- **Shielded**: Transactions don't expose wallet addresses or details
+- **Consumable**: Burned when used (not recycled)
+- **Renewable**: Continuously generated by NIGHT holdings
+- **Decaying**: Balance decays when disassociated from generating NIGHT
+- **Non-transferable**: Cannot be bought, sold, or transferred between addresses
+- **MEV-resistant**: Shielding prevents attackers from identifying victims
+
+### DUST Mechanics
+
+**Generation**:
+1. NIGHT holder designates a DUST recipient address
+2. DUST accumulates linearly over time up to a cap
+3. Cap is proportional to associated NIGHT balance
+
+**DUST Cap**: Maximum DUST = f(associated NIGHT balance)
+
+**Usage**:
+- DUST is consumed/burned when used
+- No DUST is collected by block producers
+- Generation resumes after use if below cap
+
+**Decay**:
+- Severing NIGHT association causes linear decay
+- Prevents double-spending through cap enforcement
+
+### DUST Beneficiaries
+
+1. **NIGHT Holders**: Generate and use their own DUST
+2. **DUST Recipients**: Receive DUST generation from NIGHT holders
+3. **DUST Sponsees**: Transactions paid by a DUST holder (enables tokenless UX)
+
+---
+
+## Transaction Fees
+
+### Components
+
+\`\`\`
+TxFee = CongestionRate × TxWeight + MinFee
+\`\`\`
+
+- **Minimum Fee**: Fixed fee preventing DDoS attacks
+- **Congestion Rate**: Dynamic multiplier based on network demand
+- **Transaction Weight**: Based on computational resources (initially storage in KB)
+
+### Block Utilization Target: 50%
+
+- Below 50%: Fees decrease to stimulate activity
+- Above 50%: Fees increase to manage congestion
+- Acts as automatic stabilizer for network efficiency
+
+---
+
+## Block Production & Rewards
+
+### At Launch
+
+- Federated block production by trusted permissioned nodes
+- Initial producers don't receive rewards
+- Progressive decentralization planned
+
+### Moving to Permissionless
+
+- Cardano SPOs can become Midnight Block Producers
+- Selection proportional to delegated ADA stake
+- Dual-network participation doesn't affect Cardano rewards
+
+### Block Reward Formula
+
+**Base Distribution Rate (R)**:
+\`\`\`
+R = π(1 - B - T) / (B × γ)
+
+Where:
+- π = Initial annual inflation rate (~3.14%)
+- B = Reserve allocation percentage
+- T = Treasury allocation percentage
+- γ = Blocks per year
+\`\`\`
+
+**Base Reward**:
+\`\`\`
+Nb = Bo × R
+
+Where Bo = Outstanding tokens in Reserve
+\`\`\`
+
+### Reward Split
+
+Rewards divided between block producer and Treasury based on block utilization:
+
+\`\`\`
+Actual Reward (Na) = Nb × [S + (1 - S) × U]
+Treasury Share (Nt) = Nb - Na
+
+Where:
+- S = Subsidy rate (95% at launch)
+- U = Block utilization ratio
+\`\`\`
+
+- **Full block**: Producer gets 100% of base reward
+- **Empty block**: Producer gets only the subsidy (95%)
+- **Partially full**: Linear interpolation between them
+
+---
+
+## Token Distribution
+
+### Design Principles
+
+- **Broad**: No single party dominates
+- **Inclusive**: Open to participants beyond crypto
+- **Free**: Allocated at no cost
+- **Transparent**: Open-source audited smart contracts
+
+### Phase 1: Glacier Drop (60 days)
+
+**Eligible Networks**:
+- Cardano (50% allocation)
+- Bitcoin (20% allocation)
+- Ethereum, Solana, XRPL, BNB Chain, Avalanche, Brave (remaining 30%, proportional)
+
+**Eligibility**:
+- Minimum $100 USD equivalent in native tokens at snapshot
+- Address not on OFAC sanctions list
+- Random historical snapshot to prevent gaming
+
+**Mechanics**:
+1. Sign message proving address ownership
+2. Provide unused Cardano address for redemption
+3. Tokens initially frozen, thaw during redemption period
+
+### Phase 2: Scavenger Mine (30 days)
+
+- Process unclaimed Glacier Drop tokens
+- Computational puzzles accessible to general public
+- Daily allocation over 30 one-day slots
+
+**Apportionment of Unclaimed Tokens**:
+- ~35% → Midnight Foundation
+- ~30% → Reserve (block rewards)
+- ~10% → Midnight TGE (partnerships/liquidity)
+- ~5% → On-chain Treasury
+- Rest → Scavenger Mine participants + Lost-and-Found
+
+### Phase 3: Lost-and-Found (4 years)
+
+- Second chance for eligible non-claimers from Glacier Drop
+- Fractional allocation of original entitlement
+- After 4 years, unclaimed tokens go to Treasury
+
+### Redemption Period (450 days)
+
+**Thawing Schedule**:
+- Random start day (1-90 days after genesis)
+- 25% unlock at start, then every 90 days
+- Total: 4 unlocks over 360 days
+
+---
+
+## Cooperative Tokenomics
+
+### Capacity Marketplace
+
+Enables non-NIGHT holders to access Midnight:
+
+**Off-chain Models**:
+- DUST generation leasing
+- Broker-managed leasing
+- Babel Station (DUST filling station using ZSwap)
+
+**On-chain Models** (future):
+- Ledger-native capacity leasing
+- On-chain capacity exchange
+
+### Multi-chain Features
+
+**Cross-chain Observability**: Actions on one chain trigger agents on another
+
+**Multichain Signatures**: Treasury can receive fees in other tokens
+
+---
+
+## Governance
+
+### At Launch: Federated
+
+- Select committee with equal powers
+- Multisig mechanism for protocol updates
+- Handles: parameter updates, protocol upgrades, hard forks
+
+### Future: Decentralized On-chain
+
+- Community-centric tools and processes
+- Proposal submission and voting
+- Treasury access for approved proposals
+- Automated protocol updates
+
+---
+
+## Glossary
+
+- **NIGHT**: Midnight's native utility token
+- **STAR**: Smallest subunit of NIGHT (1 NIGHT = 1M STARs)
+- **DUST**: Shielded transaction resource
+- **MBP**: Midnight Block Producer
+- **Reserve**: Protocol-managed token pool for block rewards
+- **Treasury**: Protocol-managed fund for ecosystem growth
+- **Glacier Drop**: Initial free token distribution
+- **Scavenger Mine**: Computational task-based distribution
+- **ZSwap**: Atomic asset swap mechanism for privacy
+- **Babel Station**: Service enabling tokenless transactions
 `,
 };
 //# sourceMappingURL=docs-content.js.map

package/dist/resources/docs.js

@@ -67,6 +67,12 @@ export const documentationResources = [
         description: "Pausable and other security patterns from OpenZeppelin",
         mimeType: "text/markdown",
     },
+    {
+        uri: "midnight://docs/tokenomics",
+        name: "Midnight Tokenomics Whitepaper",
+        description: "Complete tokenomics documentation covering NIGHT token, DUST resource, block rewards, token distribution (Glacier Drop), and cooperative tokenomics",
+        mimeType: "text/markdown",
+    },
 ];
 /**
  * Get documentation content by URI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "midnight-mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",