> For the complete documentation index, see [llms.txt](https://docs.reloadsol.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.reloadsol.app/readme.md).

# Welcome to ReloadSOL

Complete user and developer documentation for ReloadSOL — a dual-chain batch trading, dust recovery, and algorithmic execution platform for Solana and Robinhood Chain.

**ReloadSOL** is a dual-chain trading and algorithmic execution platform built for **Solana Mainnet** and **Robinhood Chain (EVM Chain ID `4663`)**.

For everyday traders, ReloadSOL turns fragmented wallet dust and multi-token portfolios back into native **SOL** or **ETH** in 1–2 clicks—reclaiming locked Solana token account rent along the way—while also providing multi-token bulk buys, single-pair swaps, real-time charts, cross-chain watchlists, and receipt-verified P\&L tracking.

For quantitative operators and developers, ReloadSOL ships a full institutional-grade automation stack under `/dev/*` and `/admin/*`: multi-domain paper and live strategy engines, Meteora DLMM and Robinhood CLMM liquidity managers, a Semantic Knowledge Graph anti-cabal filter, In-Flight OHLC 3-Pattern exit protection, and an ONNX-served LightGBM machine learning pipeline.

***

## Choose Your Track

| Audience                             | Start Here                                                                                                              | What You Will Learn                                                                                                       |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **New & Active Traders**             | [Quickstart Guide](https://docs.reloadsol.app/getting-started/quickstart.md)                                            | Connect your wallet, sweep dust into SOL/ETH, reclaim rent, execute bulk buys, and track P\&L.                            |
| **Execution & Risk Deep Dive**       | [Order Execution, Slippage & Fees](https://docs.reloadsol.app/public-trading-platform/order-execution-and-mechanics.md) | How Jupiter Swap V2, Kyber, BatchExecutor, dynamic slippage, and pre-sign simulation work.                                |
| **Quant & Strategy Operators**       | [Dev & Admin Console Overview](https://docs.reloadsol.app/developer-and-quant-console/overview-and-access.md)           | Configure strategies, inspect open/closed positions, monitor the 4-phase Viral Runners lifecycle, and audit ML readiness. |
| **Platform Engineers & Integrators** | [System Architecture & Data Layer](https://docs.reloadsol.app/developer-reference/system-architecture.md)               | Docker Compose topology, Postgres/PgBouncer/Redis data flows, REST/SSE API auth tiers, and deployment runbooks.           |

***

## Platform Capabilities at a Glance

```mermaid
flowchart LR
    subgraph Public["Public Trading Platform"]
        A["Bulk Sell & Dust Reload<br/>/sell · /"]
        B["Bulk Buy<br/>/buy"]
        C["Single Swap<br/>/swap"]
        D["Charts & Watchlist<br/>/chart · /knowledge-graph"]
        E["P&L & History<br/>/pnl · /history"]
    end

    subgraph Execution["Dual-Chain Execution Layer"]
        SOL["Solana Mainnet<br/>Jupiter Swap V2 · Shyft RPC<br/>ATA Rent Reclaim"]
        RH["Robinhood Chain 4663<br/>Kyber Aggregator · BatchExecutor<br/>Permit2 · EIP-5792"]
    end

    subgraph Quant["Dev & Quant Engine (/dev & /admin)"]
        S["Strategy Engine<br/>Trending · Signals · MCap · GMGN · Social"]
        L["Liquidity & Arb<br/>Meteora DLMM · RH CLMM · SOL Arb"]
        R["Risk & ML Spine<br/>Knowledge Graph · OHLC Defense · LightGBM ONNX"]
    end

    Public --> Execution
    Quant --> Execution
```

### Supported Networks

| Feature                     | Solana Mainnet (`sol`)                                             | Robinhood Chain (`robinhood`, EVM `4663`)                           |
| --------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------- |
| **Native / Quote Assets**   | SOL, USDC, USDT                                                    | ETH, WETH, USDG                                                     |
| **Primary Swap Aggregator** | Jupiter Swap V2 (`/order` + `/execute`), Lite fallback             | KyberSwap Aggregator (Parent Wallet) / GMGN (Bound Wallet)          |
| **Batch Execution**         | Parallel v0 transactions, single `signAllTransactions` approval    | Atomic `BatchExecutor.sol` (`executeBatch`) → EIP-5792 → Sequential |
| **Dust & Account Cleanup**  | Sellable dust sweep + SPL/Token-2022 burn & empty-ATA rent reclaim | Multi-token ERC-20 batch sell to ETH or custom output token         |
| **Public Access**           | Open to all Solana wallets                                         | Dev-wallet / `RH_WHITELIST` / EVM provider gated                    |
| **Automated Strategies**    | Paper (`sim_only`), Live (`live_only`), and A/B (`ab_parallel`)    | Paper (`sim_only`) + alert-only CLMM monitoring                     |

{% hint style="info" %}
**Non-Custodial by Design (Public Surfaces):** On all public trading pages (`/sell`, `/buy`, `/swap`), ReloadSOL never holds your private keys. Every swap, burn, and account close is simulated against live RPC state before being presented to your browser wallet (Phantom, Rabby, or any EIP-6963 / Solana Wallet Adapter wallet) for explicit signature approval.
{% endhint %}

***

## Core Design Principles

1. **Receipt-Gated Settlement Honesty:** A trade is never marked `confirmed` when a transaction is merely submitted. ReloadSOL tracks `pending` → `confirmed` or `failed` strictly from verified on-chain receipts.
2. **Exact-Bytes Pre-Sign Simulation:** Before your wallet opens a signature prompt, ReloadSOL simulates the exact serialized transaction bytes with a live blockhash (no `replaceRecentBlockhash` shortcuts and no `skipPreflight: true` bypasses).
3. **One Live Price Source:** ReloadSOL forbids hardcoded native asset fallback prices. If live price feeds are unreachable, surfaces explicitly display unavailable state (`—`) rather than fabricating P\&L or USD estimates.
4. **Shadow-First Quant Discipline:** Every new risk gate, knowledge graph veto, and machine learning classifier runs in `shadow` mode first—recording counterfactual outcomes against live 1-minute OHLC bars before enforcement is ever enabled.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.reloadsol.app/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
