Holocron Console v2.0
Author: K0NxT3D
Type: Cross-Platform Intelligence Console
Database: asn.db (SQLite3)

------------------------------------------------------------
1. Overview
------------------------------------------------------------

Holocron Console v2.0 is a cross-platform intelligence and
autonomous system reconnaissance tool. It provides a fast,
dark-themed interface for querying global ASNs and retrieving
metadata such as organization names, network types, geographic
locations, and full IPv4/IPv6 prefix ranges.

The application is a single standalone Go executable that runs
a local web server and opens the Holocron interface directly in
your browser. No installation, no runtime dependencies, and no
additional packages are required once compiled.

------------------------------------------------------------
2. How Holocron Works
------------------------------------------------------------

When launched, Holocron starts an internal HTTP server
(default: http://localhost:8080) and automatically opens your
default browser.

You can search using:
- ASN (e.g., 7018, AS7018)
- Organization Name
- Network Type
- Location

Search results appear in a dark Sith-style console panel.
Each ASN includes a “Ranges” button that opens a modal window
listing all prefixes associated with that ASN.

Holocron supports:
- Table view of ASN search results
- On-demand IP range retrieval
- CSV export of tables and ranges
- Console-style system log output
- Dark, ancient Sith hacker aesthetic

------------------------------------------------------------
3. The ASN Database (asn.db)
------------------------------------------------------------

Holocron uses a bundled SQLite3 database named “asn.db”.

This database contains:
- Global ASN index
- Organization names
- Types (ISP, hosting, backbone, government, etc.)
- Country / region metadata

A second table links ASNs to CIDR prefixes. These may be
queried directly or supplemented with RipeStat online data
when the user requests IP ranges for an ASN.

Holocron must be run with “asn.db” located in the same folder
as the executable.

------------------------------------------------------------
4. IP Range Collection (RipeStat)
------------------------------------------------------------

When requesting the IP ranges for an ASN, Holocron:
1. Normalizes the ASN (e.g., “7018” becomes “AS7018”)
2. Queries the database for known stored ranges
3. Optionally fetches live prefix announcements from RipeStat
4. Returns a merged, cleaned list of all prefixes
5. Displays the results in a scrollable list inside a modal
6. Allows export to CSV

This provides a near-real-time representation of the ASN’s
announced networks.

------------------------------------------------------------
5. Running Holocron (Linux, macOS, Windows)
------------------------------------------------------------

Holocron is a single Go source file that compiles into a
standalone executable. All three platforms build and run it
in nearly the same way.

------------------------------------------------------------
5.1 Linux
------------------------------------------------------------

Requirements:
- Go 1.20 or newer
- GCC or Clang for SQLite3 CGO support

Build:
    go mod tidy
    go build -o holocron holocron.go

Run:
    ./holocron

Then open:
    http://localhost:8080

------------------------------------------------------------
5.2 macOS
------------------------------------------------------------

Requirements:
- Go 1.20+
- Xcode command-line tools

Build:
    go mod tidy
    go build -o holocron holocron.go

Run:
    ./holocron

The browser will launch automatically.

------------------------------------------------------------
5.3 Windows
------------------------------------------------------------

Requirements:
- Go 1.20+
- MinGW or TDM-GCC (for sqlite3 CGO)

Build:
    go mod tidy
    go build -o holocron.exe holocron.go

Run:
    holocron.exe

Your browser will open to the interface automatically.

------------------------------------------------------------
6. File Export
------------------------------------------------------------

Holocron supports CSV export for:
- All ASN search results
- All IP ranges belonging to a specific ASN

Downloads generate directly from the web interface.

------------------------------------------------------------
7. Troubleshooting
------------------------------------------------------------

If the UI appears broken:
- Clear browser cache
- Ensure CSS is not blocked by extensions

If Holocron says “no such table: asn”:
- Ensure “asn.db” is in the same folder as the executable
- Ensure the database file is not corrupted or empty

If build fails with SQLite errors:
- Install compiler tools (Linux/macOS)
- Or switch to the pure-Go sqlite driver

If the modal scrolls off-screen:
- Reduce browser zoom
- Adjust CSS height (user interface responsive)

------------------------------------------------------------
8. Purpose
------------------------------------------------------------

The Holocron is designed as a fast, self-contained, powerful
analysis console for:
- Network operators
- Cybersecurity researchers
- Reconnaissance workflows
- Autonomous system mapping
- Infrastructure intelligence

The system’s theme reflects a mix of Sith, ancient temple,
templar, and hacker console aesthetics for a unique and
immersive operational environment.

------------------------------------------------------------
9. License
------------------------------------------------------------

No license is enforced by default. Rights retained by the
author (K0NxT3D).

------------------------------------------------------------
End of File
------------------------------------------------------------

