RandAOLabs · ClaudeShannon16 · Oct 5, 2025 · Oct 5, 2025 · Oct 5, 2025 · Oct 5, 2025
diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
@@ -16,7 +16,7 @@ jobs:
 
       # Set up Node.js environment
       - name: Setup Node.js environment
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v5
         with:
           node-version: "22"
 

diff --git a/.github/workflows/pr-validation.yml b/.github/workflows/pr-validation.yml
@@ -18,14 +18,14 @@ jobs:
 
       # Set up Node.js environment
       - name: Setup Node.js environment
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v5
         with:
           node-version: "22"
-          cache: 'npm'
+          cache: "npm"
       # Delete package-lock so that install will use latest non breaking
       - name: Delete package-lock.json
         run: rm package-lock.json
-        
+
       # Install project dependencies
       - name: Install dependencies
         run: npm install

diff --git a/docs/developers/aos-lua.mdx b/docs/developers/aos-lua.mdx
@@ -0,0 +1,43 @@
+---
+title: AOS Lua Integration
+sidebar_position: 3
+---
+
+import { RANDAO } from '@arcaogaming/project-links';
+
+# AOS Lua: Embed RANDAO in Your Smart Contracts
+
+Bring decentralized randomness directly into your AOS processes! With RANDAO's Lua integration, you can request verifiable entropy from within your smart contracts—seamless, secure, and on-chain. No external dependencies, just pure randomness powering your AO logic! 🔗
+
+## Why Integrate RANDAO with AOS Lua?
+- **Native On-Chain Access**: Call randomness functions right from your Lua code in AOS processes.
+- **Tamper-Proof Entropy**: Ensure fair outcomes for lotteries, selections, or dynamic behaviors in your contracts.
+- **AO-Optimized**: Built for the AO ecosystem, leveraging Lua's efficiency for high-performance smart contracts.
+
+<div style={{ textAlign: 'center', margin: '3rem 0' }}>
+  <a 
+    href={RANDAO.aosLuaDocs} 
+    className="button button--primary button--lg"
+    style={{ 
+      display: 'inline-flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      padding: '12px 24px',
+      fontSize: '18px',
+      fontWeight: '600',
+      textDecoration: 'none',
+      borderRadius: '8px',
+      transition: 'all 0.2s ease',
+      boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
+      minHeight: '50px'
+    }}
+    target="_blank"
+  >
+    Explore Full AOS Lua Documentation
+  </a>
+</div>
+
+Explore the full details in the <a href={RANDAO.aosLuaDocs} target="_blank">RANDAO AOS Lua Docs</a> and elevate your smart contracts with true decentralization today. Let's build the future of AO! 🌟
+
+<a href={RANDAO.discord} target="_blank"><img alt="Join Discord" src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord"/></a>
+<a href={RANDAO.website} target="_blank"><img alt="RANDAO Website" src="https://img.shields.io/badge/Website-Visit-00D4AA?style=flat&logo=google-chrome"/></a>
diff --git a/docs/developers/javascript.mdx b/docs/developers/javascript.mdx
@@ -0,0 +1,42 @@
+---
+title: JavaScript Integration
+sidebar_position: 2
+---
+
+import { RANDAO } from '@arcaogaming/project-links';
+
+# JavaScript SDK: Unlock RANDAO in Your Apps
+
+Ready to integrate decentralized randomness into your Web3 projects? The RANDAO JavaScript SDK makes it seamless to access all RANDAO functionality right from your browser or Node.js environment. No complex setups—just pure, tamper-proof randomness at your fingertips! 🎲
+
+## Why Choose JavaScript for RANDAO?
+- **Browser-Friendly**: Embed secure randomness in dApps, games, or NFT mints without backend hassles.
+- **Node.js Power**: Build server-side tools, scripts, or APIs with full RANDAO capabilities.
+
+<div style={{ textAlign: 'center', margin: '3rem 0' }}>
+  <a 
+    href={RANDAO.sdkDocs} 
+    className="button button--primary button--lg"
+    style={{ 
+      display: 'inline-flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      padding: '12px 24px',
+      fontSize: '18px',
+      fontWeight: '600',
+      textDecoration: 'none',
+      borderRadius: '8px',
+      transition: 'all 0.2s ease',
+      boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
+      minHeight: '50px'
+    }}
+    target="_blank"
+  >
+    Explore Full SDK Documentation
+  </a>
+</div>
+
+Dive deeper in the <a href={RANDAO.sdkDocs} target="_blank">official SDK documentation</a> and start building fair, decentralized experiences today. Join the randomness revolution! 🚀
+
+<a href={RANDAO.discord} target="_blank"><img alt="Join Discord" src="https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord"/></a>
+<a href={RANDAO.website} target="_blank"><img alt="RANDAO Website" src="https://img.shields.io/badge/Website-Visit-00D4AA?style=flat&logo=google-chrome"/></a>
diff --git a/docs/developers/libraries.md b/docs/developers/libraries.md
diff --git a/docs/developers/start-here.md b/docs/developers/start-here.md
diff --git a/docs/developers/start-here.mdx b/docs/developers/start-here.mdx
@@ -0,0 +1,33 @@
+---
+title: Start Here
+sidebar_position: 1
+---
+
+# Choose Your Integration Path
+
+Select how you want to integrate RANDAO into your projects:
+
+<div className="row">
+  <div className="col col--6">
+    <div className="card shadow--lw" style={{ height: '100%', display: 'flex', flexDirection: 'column' }}>
+      <div className="card__body" style={{ flex: 1 }}>
+        <h3 style={{ textAlign: 'center', marginBottom: '1rem' }}>JavaScript/TypeScript</h3>
+        <p style={{ textAlign: 'center' }}>For front-end dApps and Node.js applications, use our JS SDK to access decentralized randomness seamlessly.</p>
+      </div>
+      <div className="card__footer" style={{ textAlign: 'center', paddingTop: '1rem' }}>
+        <a href="./javascript" className="button button--primary">Get Started with JS/TS</a>
+      </div>
+    </div>
+  </div>
+  <div className="col col--6">
+    <div className="card shadow--lw" style={{ height: '100%', display: 'flex', flexDirection: 'column' }}>
+      <div className="card__body" style={{ flex: 1 }}>
+        <h3 style={{ textAlign: 'center', marginBottom: '1rem' }}>AOS Lua</h3>
+        <p style={{ textAlign: 'center' }}>For secure on-chain randomness in AO smart contracts, integrate RANDAO natively with Lua.</p>
+      </div>
+      <div className="card__footer" style={{ textAlign: 'center', paddingTop: '1rem' }}>
+        <a href="./aos-lua" className="button button--primary">Get Started with AOS Lua</a>
+      </div>
+    </div>
+  </div>
+</div>
diff --git a/docs/investors/_category_.json b/docs/investors/_category_.json
diff --git a/docs/investors/start-here.md b/docs/investors/start-here.md
diff --git a/docs/miners/custom-miner.mdx b/docs/miners/custom-miner.mdx
@@ -0,0 +1,50 @@
+---
+title: Custom Miner
+sidebar_position: 3
+---
+
+import { RANDAO } from '@arcaogaming/project-links';
+
+# Custom Miner: Advanced Docker Setup for Technical Users
+
+For the technically experienced, RANDAO offers pre-built Docker containers for node setup! Take full control of your mining operation with our containerized solution designed for developers and system administrators who want maximum flexibility and customization. 🐳
+
+## Docker-Powered Mining
+Skip the complexity of manual installation and leverage our battle-tested Docker containers. These pre-configured images include all necessary dependencies, optimized settings, and automated scripts to get your custom RANDAO node running in minutes. Perfect for developers who want to integrate RANDAO mining into existing infrastructure or build custom solutions.
+
+## Advanced Features
+- **Container Orchestration**: Deploy with Docker Compose, Kubernetes, or your preferred orchestration platform
+- **Custom Configuration**: Full access to configuration files, logging, and monitoring capabilities  
+- **Scalable Architecture**: Easily scale your mining operation across multiple nodes or cloud instances
+- **Developer-Friendly**: Direct API access and webhook support for custom integrations
+
+## Key Benefits
+- **Rapid Deployment**: Get from Docker pull to mining in under 10 minutes
+- **Infrastructure as Code**: Version-controlled configurations and reproducible deployments
+- **Monitoring & Alerts**: Built-in metrics endpoints and logging for operational visibility
+- **Security First**: Hardened containers with minimal attack surface and regular security updates
+
+<div style={{ textAlign: 'center', margin: '3rem 0' }}>
+  <a 
+    href={RANDAO.customNodeSetup} 
+    className="button button--primary button--lg"
+    style={{ 
+      display: 'inline-flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      padding: '12px 24px',
+      fontSize: '18px',
+      fontWeight: '600',
+      textDecoration: 'none',
+      borderRadius: '8px',
+      transition: 'all 0.2s ease',
+      boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
+      minHeight: '50px'
+    }}
+    target="_blank"
+  >
+    Setup a Custom Miner Today
+  </a>
+</div>
+
+Ready to build the future of decentralized randomness? Join our community of technical contributors on <a href={RANDAO.discord} target="_blank">Discord</a> or explore more at the <a href={RANDAO.website} target="_blank">RANDAO Website</a>. Let's innovate together! 🚀
diff --git a/docs/miners/rng-miner.mdx b/docs/miners/rng-miner.mdx
@@ -0,0 +1,44 @@
+---
+title: RNG Miner
+sidebar_position: 2
+---
+
+import { RANDAO } from '@arcaogaming/project-links';
+
+# RNG Miner: Plug-and-Play Entropy Provider
+
+The RNG Miner is your easy entry into RANDAO mining! This dedicated hardware device lets you contribute secure randomness to the network with minimal effort. Plug it in, connect, and begin earning $RNG rewards immediately—designed for users who want simplicity without sacrificing performance. ⛏️
+
+## Plug-and-Play Earning Model
+Forget complicated setups. The RNG Miner comes pre-configured with everything needed to join the RANDAO provider pool. Once powered on, it automatically generates entropy, participates in rounds, and accumulates rewards to your wallet. It's the hassle-free way to support decentralized randomness and profit from it.
+
+## Key Benefits
+- **Instant Start**: No software installation or configuration—unbox and mine in under 5 minutes.
+- **Hands-Off Operation**: Built-in monitoring and auto-updates keep your miner running smoothly around the clock.
+- **Competitive Rewards**: Hardware optimized for high entropy quality and volume to maximize your $RNG earnings.
+- **User-Friendly Design**: Compact, quiet, and energy-efficient, perfect for home or small-scale operations.
+
+<div style={{ textAlign: 'center', margin: '3rem 0' }}>
+  <a 
+    href={RANDAO.hardwareSite} 
+    className="button button--primary button--lg"
+    style={{ 
+      display: 'inline-flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      padding: '12px 24px',
+      fontSize: '18px',
+      fontWeight: '600',
+      textDecoration: 'none',
+      borderRadius: '8px',
+      transition: 'all 0.2s ease',
+      boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)',
+      minHeight: '50px'
+    }}
+    target="_blank"
+  >
+    Sign Up for the Waitlist
+  </a>
+</div>
+
+Join thousands powering the future of on-chain randomness. For more details, visit the <a href={RANDAO.website} target="_blank">RANDAO Website</a> or chat with us on <a href={RANDAO.discord} target="_blank">Discord</a>. Start mining today!
diff --git a/docs/miners/setting-up-provider-node.md b/docs/miners/setting-up-provider-node.md
diff --git a/docs/miners/start-here.md b/docs/miners/start-here.md
diff --git a/docs/miners/start-here.mdx b/docs/miners/start-here.mdx
@@ -0,0 +1,33 @@
+---
+title: Start Here
+sidebar_position: 1
+---
+
+# Choose Your Mining Path
+
+Select how you want to contribute to the RANDAO network:
+
+<div className="row">
+  <div className="col col--6">
+    <div className="card shadow--lw" style={{ height: '100%', display: 'flex', flexDirection: 'column' }}>
+      <div className="card__body" style={{ flex: 1 }}>
+        <h3 style={{ textAlign: 'center', marginBottom: '1rem' }}>RNG Hardware Miner</h3>
+        <p style={{ textAlign: 'center' }}>Easy plug-and-play hardware for effortless mining. Start earning $RNG rewards with minimal setup.</p>
+      </div>
+      <div className="card__footer" style={{ textAlign: 'center', paddingTop: '1rem' }}>
+        <a href="./rng-miner" className="button button--primary">Get Started with RNG Miner</a>
+      </div>
+    </div>
+  </div>
+  <div className="col col--6">
+    <div className="card shadow--lw" style={{ height: '100%', display: 'flex', flexDirection: 'column' }}>
+      <div className="card__body" style={{ flex: 1 }}>
+        <h3 style={{ textAlign: 'center', marginBottom: '1rem' }}>Custom Mining Setup</h3>
+        <p style={{ textAlign: 'center' }}>For advanced users, deploy custom miners on cloud or on-premise using Docker containers.</p>
+      </div>
+      <div className="card__footer" style={{ textAlign: 'center', paddingTop: '1rem' }}>
+        <a href="./custom-miner" className="button button--primary">Get Started with Custom Setup</a>
+      </div>
+    </div>
+  </div>
+</div>
diff --git a/docs/start-here.md b/docs/start-here.md
diff --git a/docs/start-here.mdx b/docs/start-here.mdx
@@ -0,0 +1,33 @@
+---
+title: RANDAO Start Here
+sidebar_position: 1
+---
+
+# I Want To...
+
+Choose your path to get started with RANDAO—whether you're building or contributing to the network!
+
+<div className="row">
+  <div className="col col--6">
+    <div className="card shadow--lw" style={{ height: '100%', display: 'flex', flexDirection: 'column' }}>
+      <div className="card__body" style={{ flex: 1 }}>
+        <h3 style={{ textAlign: 'center', marginBottom: '1rem' }}>Develop using RANDAO</h3>
+        <p style={{ textAlign: 'center' }}>Integrate decentralized randomness into your dApps, smart contracts, or tools with our easy-to-use SDKs and APIs. Build fair, verifiable experiences for Web3.</p>
+      </div>
+      <div className="card__footer" style={{ textAlign: 'center', paddingTop: '1rem' }}>
+        <a href="/docs/developers/start-here" className="button button--primary">Get Started Developing</a>
+      </div>
+    </div>
+  </div>
+  <div className="col col--6">
+    <div className="card shadow--lw" style={{ height: '100%', display: 'flex', flexDirection: 'column' }}>
+      <div className="card__body" style={{ flex: 1 }}>
+        <h3 style={{ textAlign: 'center', marginBottom: '1rem' }}>Mine $RNG</h3>
+        <p style={{ textAlign: 'center' }}>Contribute entropy to the RANDAO network and earn $RNG rewards. Choose hardware or custom setups to become a provider and power secure randomness.</p>
+      </div>
+      <div className="card__footer" style={{ textAlign: 'center', paddingTop: '1rem' }}>
+        <a href="/docs/miners/start-here" className="button button--primary">Start Mining</a>
+      </div>
+    </div>
+  </div>
+</div>
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
@@ -20,7 +20,11 @@ const config: Config = {
   projectName: 'docs', // Usually your repo name.
 
   onBrokenLinks: 'throw',
-  onBrokenMarkdownLinks: 'warn',
+  markdown: {
+    hooks: {
+      onBrokenMarkdownLinks: 'warn'
+    }
+  },
 
   // Even if you don't use internationalization, you can use this field to set
   // useful metadata like html lang. For example, if your site is Chinese, you