========================================
MetaMiner Installation Guide
========================================

STEP 1: Upload Files
--------------------
Upload the entire /metaminer/ directory to:
    /public_html/metaminer/

Or wherever you want MetaMiner to live.


STEP 2: Create Directories
---------------------------
SSH into your server and run:

    cd /path/to/metaminer
    mkdir cache logs
    chmod 777 cache logs


STEP 3: Test the Oracle
------------------------
Visit in your browser:
    https://core.galliumhash.com/metaminer/test-oracle.php

Click "Get Intelligence" button.

If you see JSON output with blockchain intelligence, SUCCESS! ✅

If you see errors:
  - Check database credentials in config.php
  - Ensure MetaBuilder has collected data first
  - Check file permissions


STEP 4: Security (IMPORTANT!)
------------------------------
Once tested successfully:

1. DELETE the test file:
    rm test-oracle.php

2. Protect the directory with .htaccess:
    Create /metaminer/.htaccess with:
    
    <Files "test-oracle.php">
        Require all denied
    </Files>
    
    <Files "oracle-api.php">
        Require all granted
    </Files>

3. Enable IP whitelist in config.php:
    'enable_ip_check' => true


STEP 5: Integration with Space
-------------------------------
When building Space, use this endpoint:

    https://core.galliumhash.com/metaminer/oracle-api.php?action=intelligence

Space will receive the full intelligence package.

Space doesn't know about MetaBuilder. Keep it that way.


========================================
Need Help?
========================================

Check logs:
    tail -f /metaminer/logs/oracle.log

Clear cache manually:
    rm /metaminer/cache/*.json

Force refresh via API:
    https://core.galliumhash.com/metaminer/oracle-api.php?action=refresh

========================================
The Oracle is ready. 🔮
========================================