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

# GhostOS

<figure><img src="/files/7QKKStotLxvH0K7bhfN8" alt=""><figcaption></figcaption></figure>

GhostOS is the secure foundation of GhostWare. It is the environment that makes every interaction on Solana private from the moment it starts. When you use GhostOS, your device, location, and wallet data are hidden behind temporary, disposable sessions.

Each time you connect, GhostOS creates an isolated environment that leaves no trace. It feels like a normal Solana session, but every action happens inside a clean shell that disappears when you finish.

### How It Works

1. **Ephemeral Sessions**\
   Every transaction or action runs inside a short-lived virtual space. Once complete, that session is destroyed. No identifiers, cookies, or metadata remain.
2. **Hidden Metadata**\
   Device information and IP data are stripped or rerouted through GhostWare relays. To the network, it looks like a new anonymous client each time.
3. **Isolated Wallet Keys**\
   Private keys never leave the local environment. GhostOS separates wallet signing from the interface layer, so even compromised nodes cannot access sensitive data.
4. **Secure Routing**\
   All connections pass through a layer of encryption and global relays, protecting origin metadata and preventing fingerprinting.

### User Experience

Using GhostOS should feel the same as using a normal Solana wallet. The difference is what happens in the background. Every click and transaction goes through a clean environment with no link to past sessions.

You can:

* Connect your wallet safely.
* Run swaps, send tokens, or create pay links without exposure.
* Sweep stealth addresses into your main wallet securely.

### Why It Matters

Wallets and dApps often leak small pieces of metadata that can reveal user patterns. Over time, those traces can be connected to form a complete picture of who you are. GhostOS breaks that pattern by making every session unique and disposable.

Privacy starts here. GhostOS is the first layer that turns Solana activity into something untraceable and anonymous by design.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ghostwareos.gitbook.io/docs/architecture/ghostos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.