# Welcome

X-Cash is a privacy-focused crypto ecosystem founded in **2018**. This repository contains the official documentation for users, node operators, delegates, and developers.

**X-Cash: Your money. Your privacy. Your governance.**

**Quick links**

* Website: [xcash.tech](https://xcash.tech)
* Migration portal: [xcash.tech/migration](https://xcash.tech/migration)
* Roadmap: [xcash.tech/roadmap](https://xcash.tech/roadmap)
* X-Wallet (web): [xwallet.xcash.tech](https://xwallet.xcash.tech)
* Explorer (X-Plorer): [xplorer.xcash.tech](https://xplorer.xcash.tech)
* GitHub org: [github.com/xcash-tech](https://github.com/xcash-tech)

## What X-Cash is building

X-Cash is designed as a **payment system first**: simple private payments for everyday users and small businesses, without requiring them to understand blockchain.

At the protocol level, X-Cash operates a privacy-focused **Layer-1** network with Monero-inspired (CryptoNote-based) privacy foundations. At the product level, X-Cash focuses on usability: one wallet, clear choices, and simple actions.

X-Cash is built as an ecosystem rather than a single product, with user experience as a core design principle.

Core pillars documented in this repo:

* **FlexPrivacy (Hybrid Transactions):** choose private or public transactions on the same network, on a per-transaction basis.
* **DPoPS (Delegated Proof of Private Stake):** a stake-based consensus designed for privacy coins, with delegate voting and BFT-style verification.
* **EVM interoperability:** built-in migration/bridging path to the EVM ecosystem (including Base) so X-Cash isn’t isolated from liquidity and applications.
* **Scalability & extensibility:** roadmap-aligned work including upgraded L1 infrastructure and future expansion paths.

If you're looking for the technical background, start with the papers:

* Hybrid Transactions: `Library → Yellowpaper - Hybrid Transactions`
* DPoPS design: `Delegate node & staking → Technical Design`

## Ecosystem components

X-Cash is intentionally packaged as a set of user-facing products on top of a privacy L1:

### Ecosystem map

{% @mermaid/diagram content="flowchart LR
user\["Users & businesses"] --> wallet\["X-Wallet"]
legacy\["Legacy X-Cash chain (migration)"] -.->|Claim / snapshot| wallet

subgraph L1\["Privacy-first Layer 1"]
l1\["X-Cash L1 network"]
delegates\["Delegates (DPoPS)"]
governance\["Staking & governance"]
delegates -->|Block production + BFT verification| l1
l1 --> governance
governance -->|Voting signals| delegates
end

subgraph EVM\["EVM ecosystem"]
base\["Base (ERC-20)"]
dapps\["DeFi & dApps"]
base --> dapps
end

wallet -->|FlexPrivacy transactions| l1
wallet -->|Migration / bridge| base
base -->|Bridge to native XCASH| l1

explorer\["X-Plorer"] <-->|Read-only explorer| l1
wallet --> quest\["X-Quest"]
wallet --> payment\["X-Payment (in development)"]
" %}

### X-Wallet

X-Wallet is the primary interface of the ecosystem: a non-custodial browser wallet designed to make sending and managing assets understandable for non-technical users. It includes a privacy toggle, staking interface, and access to migration flows.

* Web wallet: [xwallet.xcash.tech](https://xwallet.xcash.tech)

### Privacy & transactions (FlexPrivacy)

FlexPrivacy (Hybrid Transactions) provides optional privacy in a unified model: users can choose **private** or **transparent** transactions from the same wallet UX, depending on context.

### EVM interoperability

X-Cash includes a native, built-in migration mechanism between:

* the X-Cash Layer-1 network
* the EVM ecosystem (including Base and other Ethereum-compatible chains)

This provides access to DeFi and liquidity when needed, while preserving the ability to return to the privacy-focused Layer-1.

### X-Payment (in development)

X-Payment is a payment system in development focused on real commerce: mobile-first payment flows, instant peer-to-peer payments, and merchant tooling for small and medium businesses.

### Supporting apps

* X-Plorer (explorer): [xplorer.xcash.tech](https://xplorer.xcash.tech)
* X-Quest (community): [xquest.xcash.tech](https://xquest.xcash.tech)

## Migration to the new X-Cash network (in progress)

X-Cash is currently running an **ongoing migration from the legacy blockchain to a new X-Cash network**. The migration is designed to be handled in the browser through X-Wallet, and the process is announced ahead of time (including the claim window).

High-level flow (see the official page for the latest details and timing):

1. **Open X-Wallet and claim** using your existing wallet credentials (you will need your 24/25-word seed phrase). Wait for full wallet sync.
2. **Receive new tokens on Base (ERC-20)** at a **1:1** ratio (for immediate liquidity and DeFi access while the new L1 launches).
3. **Legacy chain sunsets / new X-Cash L1 launches** with upgraded privacy layer and DPoPS consensus.
4. **Swap Base tokens → native XCASH on the new L1** via the built-in bridge to unlock full L1 features (privacy, staking, governance).
5. **Polygon WXCASH holders** can swap to the new Base token via X-Wallet.

Read the full process + FAQ: [xcash.tech/migration](https://xcash.tech/migration)

## Roadmap (where we’re headed)

The roadmap describes the project’s direction across three horizons:

* **Near-term (Foundation & Launch):** new X-Cash L1 network, token migration, community airdrop, Base integration, DAO activation, and an enhanced X-Wallet experience.
* **Mid-term (Scaling & Expansion):** higher-throughput scaling (zk-rollup L2), smart-contract sidechains, privacy-preserving DeFi primitives, and delegate performance tooling.
* **Long-term (Ecosystem maturity):** cross-chain swap protocol, expanded mobile wallet experiences, privacy-preserving NFTs, and additional privacy-first applications.

Latest roadmap status: [xcash.tech/roadmap](https://xcash.tech/roadmap)

## Get started

Use the table below to jump straight to what you need.

| What are you looking for?                      | Where to start                                                                                                                                                                                                                                                                |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **I need to migrate legacy XCASH / WXCASH.**   | Use the official [migration guide](https://xcash.tech/migration)                                                                                                                                                                                                              |
| **I want to use a wallet.**                    | <ul><li>Web wallet: <a href="https://xwallet.xcash.tech">xwallet.xcash.tech</a></li><li>Android wallet: <a href="https://github.com/Xcash-Tech/xcash-cake-wallet-legacy/releases">Android 10+</a></li><li><a href="/pages/URRJFRKH7Oy9hiWpYMvY">CLI wallet docs</a></li></ul> |
| **I want to use RPC (wallet/daemon).**         | RPC index: [applications/rpc-calls/README.md](/applications/rpc-calls.md)                                                                                                                                                                                                     |
| **I want to import/export a blockchain file.** | [applications/xcash-blockchain-export.md](/applications/xcash-blockchain-export.md) and [applications/xcash-blockchain-import.md](/applications/xcash-blockchain-import.md)                                                                                                   |

Tip: the full documentation navigation is in [SUMMARY.md](https://github.com/Xcash-Tech/xcash-docs/blob/master/SUMMARY.md).

## Community & support

* Discord: [discord.gg/2bm4UuqYZT](https://discord.gg/2bm4UuqYZT)
* X (Twitter): [x.com/XcashTech](https://x.com/XcashTech)
* Telegram: [t.me/xcashtech](https://t.me/xcashtech)
* Reddit: [reddit.com/r/xcash](https://www.reddit.com/r/xcash)
* Explorer: [xplorer.xcash.tech](https://xplorer.xcash.tech)

## Repository scope

This repository contains documentation. For source code and releases, see the GitHub organization:

* [github.com/xcash-tech](https://github.com/xcash-tech)


---

# Agent Instructions: 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:

```
GET https://docs.xcash.tech/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
