# Vana Protocol Documentation

> Vana is an open protocol for user-controlled data portability. Users store personal data in Personal Servers, grant third-party builders access via signed permissions, and revoke access at any time. All consent is recorded onchain on Vana L1. The canonical documentation URL is https://docs.vana.org

## Protocol Reference

- [Personal Servers](https://docs.vana.org/protocol-reference/personal-servers): The protocol participant that stores user data and serves authorized requests. Covers the REST API surface, Web3Signed authorization, hosting options (desktop-bundled, ODL Cloud, self-hosted), data sync, and local data hierarchy.
- [Scopes & Schemas](https://docs.vana.org/protocol-reference/scopes-schemas): Scope taxonomy ({source}.{category}), the schema registry (DataRefinerRegistry), JSON data file format, data connectors, and how to define new scopes.
- [Storage & Encryption](https://docs.vana.org/protocol-reference/storage-encryption): Key derivation (HKDF-SHA256 from wallet signature), OpenPGP password-based encryption, storage backends (Vana Storage, Google Drive, Dropbox, IPFS), the data sync model, and data deletion.
- [Grants & Permissions](https://docs.vana.org/protocol-reference/grants-permissions): EIP-712 typed data grants, grant lifecycle (create, active, revoked, expired), verification, the Connect Data flow via Session Relay, onchain DataPortabilityPermissions contract, and the Builder SDK (@opendatalabs/connect).
- [Identity](https://docs.vana.org/protocol-reference/identity): Wallet-based identity for users and builders, builder registration, app manifests (W3C Web App Manifest with vana block), Personal Server registration via DataPortabilityServers contract, and the Passport authentication abstraction.
- [Full Specification](https://docs.vana.org/protocol-reference/full-specification): The complete normative Data Portability Protocol specification (v1.0.0). Covers all protocol components, data formats, operations, security model, error codes, extensibility, and the Builder SDK.

## Network

- [Vana L1](https://docs.vana.org/network/vana-l1): EVM-compatible blockchain for data portability. Covers what is onchain (registrations, grants, file records, schemas), mainnet and Moksha testnet RPC URLs and chain IDs, and the Data Portability RPC (Gateway).
- [Validators](https://docs.vana.org/network/validators): L1 blockchain validators (Proof-of-Stake consensus, block production, hardware requirements) and Satya data validators (Trusted Execution Environments, Proof of Contribution, Intel TDX).
- [Core Contracts](https://docs.vana.org/network/smart-contracts-addresses): Contract addresses for DataPortabilityPermissions, DataPortabilityServers, DataPortabilityGrantees, staking contracts, and chain utilities. Addresses are the same on Moksha and Mainnet.
- [VANA Token](https://docs.vana.org/network/vana-token): Token overview, utility (network security, transaction fees, staking, governance, data access currency), total supply (120M), distribution schedule, and ERC-20 contract addresses on Ethereum, Base, Arbitrum, BNB, Optimism, and Polygon.
- [Staking & Bridging](https://docs.vana.org/network/staking-bridging): How to stake VANA at stake.vana.org, non-rebasing staking positions, rewards, and how to bridge assets (VANA, USDC.e, USDT, ETH/WETH) via Stargate and Jumper using LayerZero OFT standard.

## Resources

- [Ecosystem](https://docs.vana.org/resources/ecosystem): Projects and applications built on Vana, including ecosystem partners (Stargate, Hyperlane, Quicknode, Chainstack, Gelato, The Graph, Goldsky, Safe, and others).
- [Community & Discord](https://docs.vana.org/resources/community-discord): Join the Vana community on Discord and connect with other builders.
- [Whitepaper](https://docs.vana.org/resources/whitepaper): The Vana whitepaper: "An Open Protocol for Data Sovereignty."
- [Security & Audits](https://docs.vana.org/resources/security): Defense-in-depth security model (chain-level, server-level, encryption-level), audit reports from Nethermind and Hashlock, smart contract governance, and responsible disclosure policy.

## Deprecated URLs

The following URLs are no longer valid. Do not link to them:

- https://docs.vana.org/docs/how-vana-works — REMOVED. See https://docs.vana.org/ and https://docs.vana.org/protocol-reference/personal-servers instead.
- https://docs.vana.org/docs/system-architecture — REMOVED. See https://docs.vana.org/protocol-reference/full-specification instead.
- https://docs.vana.com/api — REMOVED. Old domain. There is no separate API reference; the protocol API is documented inline in the Protocol Reference pages.
- Any URL under https://docs.vana.org/docs/* — REMOVED. The /docs/ prefix is no longer used.
- Any URL under https://docs.vana.com/* — REMOVED. The docs.vana.com domain is deprecated; use docs.vana.org.