Files
aitbc/website/docs/docs-miners.html
oib 86e5c6f1a3 feat: Convert HTML documentation to markdown and add web format
- Convert all HTML documentation files to markdown format in /docs folder
- Add markdown links to HTML documentation pages
- Update all aitbc.io references to aitbc.bubuit.net
- Create HTML web format versions of key documentation files
- Update documentation index to show both HTML and web format options
- Add flowchart documentation explaining CLI job submission process
2026-01-29 15:06:36 +01:00

409 lines
20 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Miner Documentation - AITBC</title>
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
<link rel="stylesheet" href="css/docs.css">
</head>
<body>
<!-- Header -->
<header class="text-white shadow-lg" style="background: var(--bg-white); position: fixed; width: 100%; top: 0; z-index: 1000; box-shadow: 0 1px 3px rgba(0,0,0,0.1);">
<div class="container" style="max-width: 1200px; margin: 0 auto; padding: 0 20px;">
<div style="display: flex; align-items: center; justify-content: space-between; padding: 1rem 0;">
<div style="display: flex; align-items: center; gap: 0.75rem;">
<i class="fas fa-cube" style="font-size: 2rem; color: var(--primary-color);"></i>
<h1 style="font-size: 1.5rem; font-weight: bold; margin: 0; color: var(--text-dark);">AITBC</h1>
</div>
<nav style="display: flex; align-items: center; gap: 1.5rem;">
<a href="/" style="background: transparent !important; color: var(--text-dark) !important; padding: 0.5rem 0.75rem; border-radius: 0.5rem; font-weight: 500; text-decoration: none; display: inline-flex; align-items: center;">Home</a>
<a href="/explorer/" style="background: transparent !important; color: var(--text-dark) !important; padding: 0.5rem 0.75rem; border-radius: 0.5rem; font-weight: 500; text-decoration: none; display: inline-flex; align-items: center;">Explorer</a>
<a href="/Exchange/" style="background: transparent !important; color: var(--text-dark) !important; padding: 0.5rem 0.75rem; border-radius: 0.5rem; font-weight: 500; text-decoration: none; display: inline-flex; align-items: center;">Exchange</a>
<a href="/docs/index.html" style="background: transparent !important; color: var(--text-dark) !important; padding: 0.5rem 0.75rem; border-radius: 0.5rem; font-weight: 500; text-decoration: none; display: inline-flex; align-items: center;">Documentation</a>
<button id="themeToggle" class="theme-toggle" style="background: rgba(59, 130, 246, 0.1) !important; color: var(--primary-color) !important; border: 2px solid var(--primary-color); padding: 0.5rem 1rem; border-radius: 0.5rem; cursor: pointer; font-size: 1rem;">🌞</button>
</nav>
</div>
</div>
</header>
<!-- Main Content -->
<main>
<div class="container">
<div class="doc-header">
<span class="audience-badge">For Miners</span>
<h1>Start Mining AITBC</h1>
<p>Complete guide to becoming a successful AITBC miner and earning rewards</p>
</div>
<!-- Quick Stats -->
<div class="quick-stats">
<div class="stat-card">
<div class="stat-value">15-25%</div>
<div class="stat-label">Annual ROI</div>
</div>
<div class="stat-card">
<div class="stat-value">1000 AITBC</div>
<div class="stat-label">Minimum Stake</div>
</div>
<div class="stat-card">
<div class="stat-value">24/7</div>
<div class="stat-label">Mining Rewards</div>
</div>
<div class="stat-card">
<div class="stat-value">Low</div>
<div class="stat-label">Hardware Requirements</div>
</div>
</div>
<!-- Getting Started -->
<section class="content-section">
<div class="alert alert-info" style="margin-bottom: 2rem;">
<strong>📚 Also available in Markdown:</strong>
<a href="https://gitea.bubuit.net/oib/aitbc/src/branch/main/docs/miner-documentation.md" target="_blank" style="color: inherit; text-decoration: underline;">View this documentation in markdown format</a> for easier contribution and version control.
</div>
<h2>Getting Started</h2>
<p>AITBC mining combines Proof of Authority and Proof of Stake, offering multiple ways to participate and earn rewards.</p>
<h3>Mining Options</h3>
<ul>
<li><strong>Authority Mining</strong>: Become a trusted authority node (invitation only)</li>
<li><strong>Stake Mining</strong>: Stake AITBC tokens and earn rewards</li>
<li><strong>GPU Mining</strong>: ✅ OPERATIONAL - Provide compute power for AI/ML workloads via Ollama (RTX 4060 Ti tested)</li>
<li><strong>Hybrid Mining</strong>: Combine staking with compute provision</li>
</ul>
<div class="alert alert-info" style="margin-top: 1.5rem; padding: 1rem; background: linear-gradient(135deg, rgba(16, 185, 129, 0.1) 0%, rgba(59, 130, 246, 0.1) 100%); border-left: 4px solid var(--success-color); border-radius: 8px;">
<strong>🎉 Latest Achievement (January 2026):</strong> Real GPU miner successfully deployed with NVIDIA RTX 4060 Ti! Processing jobs in 11-25 seconds with verified receipt generation. Earn 0.02 AITBC per GPU second with 13+ Ollama models available.
</div>
<h3>Quick Start</h3>
<div class="step">
<div class="step-number">1</div>
<div class="step-content">
<h4>Download & Install</h4>
<p>Get the AITBC mining software for your platform</p>
<div class="code-block">
# Linux/macOS
curl -O https://gitea.bubuit.net/oib/aitbc/releases/download/v1.0.0/aitbc-miner-v1.0.0.tar.gz
tar -xzf aitbc-miner-v1.0.0.tar.gz
cd aitbc-miner
# Windows
# Download from https://gitea.bubuit.net/oib/aitbc/releases</div>
</div>
</div>
<div class="step">
<div class="step-number">2</div>
<div class="step-content">
<h4>Configure Your Node</h4>
<p>Set up your mining configuration</p>
<div class="code-block">
# Create configuration
./aitbc-miner config init
# Edit configuration
nano ~/.aitbc/miner.toml</div>
</div>
</div>
<div class="step">
<div class="step-number">3</div>
<div class="step-content">
<h4>Stake Tokens</h4>
<p>Lock your AITBC tokens to start earning</p>
<div class="code-block">
# Stake 1000 AITBC
./aitbc-miner stake 1000 --wallet YOUR_WALLET_ADDRESS</div>
</div>
</div>
<div class="step">
<div class="step-number">4</div>
<div class="step-content">
<h4>Start Mining</h4>
<p>Launch your mining node</p>
<div class="code-block">
# Start mining
./aitbc-miner start --mode stake</div>
</div>
</div>
</section>
<!-- Hardware Requirements -->
<section class="content-section">
<h2>Hardware Requirements</h2>
<div class="requirements-grid">
<div class="requirement-card">
<h4><i class="fas fa-microchip"></i> CPU</h4>
<p>4+ cores (8+ recommended for GPU mining)</p>
</div>
<div class="requirement-card">
<h4><i class="fas fa-memory"></i> RAM</h4>
<p>8GB minimum (16GB+ for GPU mining)</p>
</div>
<div class="requirement-card">
<h4><i class="fas fa-hdd"></i> Storage</h4>
<p>100GB SSD (500GB+ for full node)</p>
</div>
<div class="requirement-card">
<h4><i class="fas fa-network-wired"></i> Network</h4>
<p>Stable broadband (100Mbps+)</p>
</div>
<div class="requirement-card">
<h4><i class="fas fa-rocket"></i> GPU (Operational)</h4>
<p><strong>✅ Tested:</strong> NVIDIA RTX 4060 Ti (16GB)<br>
Recommended: RTX 3080+ or AMD RX 6800+<br>
<em>Ollama integration included</em></p>
</div>
<div class="requirement-card">
<h4><i class="fas fa-shield-alt"></i> Security</h4>
<p>HSM recommended for large stakes</p>
</div>
</div>
<div class="alert alert-info">
<strong>✅ GPU Mining Live:</strong> Host GPU miner operational with Ollama integration. Process LLM inference jobs (llama3.2, mistral, deepseek, etc.) and earn 0.02 AITBC per GPU second. Systemd service configuration available for production deployment.
</div>
</section>
<!-- Profit Calculator -->
<section class="calculator">
<h3><i class="fas fa-calculator"></i> Profit Calculator</h3>
<div class="calc-row">
<div class="calc-input">
<label for="stakeAmount">Stake Amount (AITBC)</label>
<input type="number" id="stakeAmount" value="10000" oninput="calculateProfit()">
</div>
<div class="calc-input">
<label for="apy">Expected APY (%)</label>
<input type="number" id="apy" value="20" oninput="calculateProfit()">
</div>
</div>
<div class="calc-row">
<div class="calc-input">
<label for="tokenPrice">Token Price (USD)</label>
<input type="number" id="tokenPrice" value="2.50" step="0.01" oninput="calculateProfit()">
</div>
<div class="calc-input">
<label for="gpuRewards">GPU Rewards (USD/month)</label>
<input type="number" id="gpuRewards" value="0" oninput="calculateProfit()">
</div>
</div>
<div class="calc-result">
<div>Estimated Monthly Earnings</div>
<div class="calc-result-value" id="monthlyEarnings">$416.67</div>
<div>Estimated Annual Earnings</div>
<div class="calc-result-value" id="annualEarnings">$5,000.00</div>
</div>
</section>
<!-- Mining Strategies -->
<section class="content-section">
<h2>Mining Strategies</h2>
<h3>1. Pure Staking</h3>
<p>The simplest approach - stake your tokens and earn passive income.</p>
<ul>
<li>Pros: Low maintenance, predictable returns</li>
<li>Cons: Lower rewards than active mining</li>
<li>Best for: Long-term holders, passive investors</li>
</ul>
<h3>2. GPU Mining</h3>
<p>Provide compute power for AI/ML workloads and earn additional rewards.</p>
<ul>
<li>Pros: Higher rewards, supports the network</li>
<li>Cons: Higher hardware costs, more maintenance</li>
<li>Best for: Technical users with GPU hardware</li>
</ul>
<h3>3. Authority Mining</h3>
<p>Apply to become a trusted authority node (invitation only).</p>
<ul>
<li>Pros: Highest rewards, network influence</li>
<li>Cons: High requirements, strict vetting</li>
<li>Best for: Established organizations, experienced miners</li>
</ul>
<h3>4. Hybrid Approach</h3>
<p>Combine staking with GPU mining for maximum returns.</p>
<ul>
<li>Pros: Diversified income streams</li>
<li>Cons: Complex setup, higher initial cost</li>
<li>Best for: Experienced miners seeking optimization</li>
</ul>
</section>
<!-- Security Best Practices -->
<section class="content-section">
<h2>Security Best Practices</h2>
<div class="alert alert-danger">
<strong>Important:</strong> Never share your private keys or wallet passwords with anyone!
</div>
<h3>Wallet Security</h3>
<ul>
<li>Use a hardware wallet for large stakes</li>
<li>Enable two-factor authentication</li>
<li>Keep your wallet software updated</li>
<li>Backup your wallet securely (offline)</li>
<li>Use a dedicated mining wallet</li>
</ul>
<h3>Node Security</h3>
<ul>
<li>Keep your operating system updated</li>
<li>Use a firewall to restrict access</li>
<li>Monitor for unusual activity</li>
<li>Use VPN for additional privacy</li>
<li>Regular security audits</li>
</ul>
<h3>Operational Security</h3>
<ul>
<li>Diversify your stake across multiple nodes</li>
<li>Use automated monitoring and alerts</li>
<li>Have backup power and internet</li>
<li>Document your recovery procedures</li>
<li>Join the community for security updates</li>
</ul>
</section>
<!-- Troubleshooting -->
<section class="content-section">
<h2>Troubleshooting</h2>
<h3>Common Issues</h3>
<div class="faq-item">
<div class="faq-question">Node won't start?</div>
<div class="faq-answer">
Check your configuration file syntax and ensure all required ports are open. Use <code>./aitbc-miner check-config</code> to validate your setup.
</div>
</div>
<div class="faq-item">
<div class="faq-question">Low mining rewards?</div>
<div class="faq-answer">
Ensure your node is online 24/7, check your stake amount, and verify you're running the latest version. Network conditions also affect rewards.
</div>
</div>
<div class="faq-item">
<div class="faq-question">Sync issues?</div>
<div class="faq-answer">
Try resyncing with <code>./aitbc-miner sync --reset</code>. Check your internet connection and disk space.
</div>
</div>
<div class="faq-item">
<div class="faq-question">GPU not detected?</div>
<div class="faq-answer">
Install latest GPU drivers, verify CUDA/OpenCL support, and check <code>./aitbc-miner gpu check</code>.
</div>
</div>
<h3>Getting Help</h3>
<ul>
<li>Check the logs: <code>./aitbc-miner logs</code></li>
<li>Visit our Discord community</li>
<li>Search issues on Gitea</li>
<li>Email support: aitbc@bubuit.net</li>
</ul>
</section>
<!-- FAQ -->
<section class="content-section">
<h2>Frequently Asked Questions</h2>
<div class="faq-item">
<div class="faq-question">How much can I earn mining AITBC?</div>
<div class="faq-answer">
Earnings vary based on stake amount, network participation, and whether you provide GPU compute. Typical APY ranges from 15-25% for staking, with GPU mining adding additional rewards.
</div>
</div>
<div class="faq-item">
<div class="faq-question">When do I get paid?</div>
<div class="faq-answer">
Rewards are distributed daily and automatically credited to your wallet. You can withdraw anytime after the initial lock period.
</div>
</div>
<div class="faq-item">
<div class="faq-question">Can I run multiple nodes?</div>
<div class="faq-answer">
Yes, you can run multiple nodes but each requires separate stakes. This can provide redundancy and potentially higher rewards.
</div>
</div>
<div class="faq-item">
<div class="faq-question">What happens if my node goes offline?</div>
<div class="faq-answer">
You won't earn rewards while offline, but your stake remains safe. Extended downtime may affect your reputation score.
</div>
</div>
<div class="faq-item">
<div class="faq-question">How do I become an authority node?</div>
<div class="faq-answer">
Authority nodes require invitation based on community contribution, technical expertise, and stake amount. Apply through the community forum.
</div>
</div>
</section>
</div>
</main>
<!-- Footer -->
<footer>
<div class="container">
<p>&copy; 2025 AITBC. All rights reserved.</p>
</div>
</footer>
<script>
// Profit Calculator
function calculateProfit() {
const stake = parseFloat(document.getElementById('stakeAmount').value) || 0;
const apy = parseFloat(document.getElementById('apy').value) || 0;
const price = parseFloat(document.getElementById('tokenPrice').value) || 0;
const gpuRewards = parseFloat(document.getElementById('gpuRewards').value) || 0;
const monthlyStakeRewards = (stake * (apy / 100) / 12) * price;
const monthlyEarnings = monthlyStakeRewards + gpuRewards;
const annualEarnings = monthlyEarnings * 12;
document.getElementById('monthlyEarnings').textContent = `$${monthlyEarnings.toFixed(2)}`;
document.getElementById('annualEarnings').textContent = `$${annualEarnings.toFixed(2)}`;
}
// Initialize calculator
calculateProfit();
</script>
<script>
// Check for saved theme preference or default to dark mode
const currentTheme = localStorage.getItem('theme') || 'dark';
if (currentTheme === 'light') {
document.body.classList.add('light');
const btn = document.getElementById('themeToggle');
if (btn) btn.textContent = '🌙';
}
// Theme toggle functionality
const themeBtn = document.getElementById('themeToggle');
if (themeBtn) {
themeBtn.addEventListener('click', function() {
document.body.classList.toggle('light');
const isLight = document.body.classList.contains('light');
localStorage.setItem('theme', isLight ? 'light' : 'dark');
this.textContent = isLight ? '🌙' : '🌞';
});
}
</script></body>
</html>