# Lumera Protocol

## Docs

- [LumeScope Actions API reference](https://docs.lumera.io/api/actions.md): Query Cascade and Sense actions on the Lumera network with decoded metadata, lifecycle details, and aggregated statistics.
- [CometBFT RPC reference](https://docs.lumera.io/api/cometbft-rpc.md): Query blocks, transactions, and validator sets through the consensus RPC that every Lumera node serves on port 26657.
- [EVM JSON-RPC reference](https://docs.lumera.io/api/evm-jsonrpc.md): Call standard Ethereum JSON-RPC methods on Lumera EVM nodes over HTTP and WebSocket.
- [CascadeService gRPC reference](https://docs.lumera.io/api/grpc/cascade-service.md): CascadeService provides streaming gRPC RPCs for registering files in Cascade permanent storage and downloading stored data from a Lumera SuperNode.
- [SupernodeService gRPC reference](https://docs.lumera.io/api/grpc/supernode-service.md): Query system status and resource metrics for a Lumera SuperNode over gRPC, including CPU, memory, storage, P2P, and DHT data.
- [Deploy LumeScope with Docker](https://docs.lumera.io/api/lumescope.md): Run your own LumeScope instance with Docker to aggregate Lumera action metadata, SuperNode metrics, and network stats.
- [Lumera REST API overview](https://docs.lumera.io/api/overview.md): Learn the base URLs, authentication model, and response format for the LumeScope and LCD REST APIs.
- [SN-API REST gateway reference](https://docs.lumera.io/api/sn-api.md): Upload and download Cascade files through the REST gateway that fronts the SuperNode network.
- [LumeScope SuperNodes API reference](https://docs.lumera.io/api/supernodes.md): Query SuperNode hardware metrics, payment statistics, version compatibility matrix, and availability status using the LumeScope read-only REST API.
- [Protocol architecture](https://docs.lumera.io/architecture.md): How Lumera's layered architecture coordinates consensus, protocol services, and decentralized execution.
- [Set up the Cascade client](https://docs.lumera.io/cascade/client-setup.md): Create a Lumera client with network presets, custom endpoints, and a wallet signer.
- [Cascade download lifecycle](https://docs.lumera.io/cascade/concepts/download-lifecycle.md): How the SDK authenticates, tracks, and streams a file download from SuperNodes.
- [RaptorQ erasure coding in Cascade](https://docs.lumera.io/cascade/concepts/erasure-coding.md): Why Cascade uses RaptorQ fountain codes and how LEP-1 derives layout IDs.
- [Interchain accounts and Cascade](https://docs.lumera.io/cascade/concepts/interchain-accounts.md): Use Cascade storage from any IBC-connected Cosmos chain through ICS-27.
- [Cascade upload lifecycle](https://docs.lumera.io/cascade/concepts/upload-lifecycle.md): Phase by phase internals of a Cascade upload from file hash to permanent storage.
- [Handle Cascade errors](https://docs.lumera.io/cascade/error-handling.md): Diagnose common Cascade failures, tune retries and timeouts, and understand automatic refunds.
- [Cascade Everlight overview](https://docs.lumera.io/cascade/everlight/overview.md): Learn how Everlight funds ongoing Cascade storage from a single upfront payment.
- [How Everlight payments work](https://docs.lumera.io/cascade/everlight/payments.md): See how the Everlight SN Pool collects funding and pays SuperNodes for retained Cascade data.
- [Everlight for SuperNode operators](https://docs.lumera.io/cascade/everlight/supernode-operators.md): Understand the STORAGE_FULL state, payout eligibility, and what Everlight means for your node.
- [Build a browser app](https://docs.lumera.io/cascade/guides/browser-app.md): Build a Vite and TypeScript single page app that stores files on Cascade through Keplr.
- [Store encrypted files on Cascade](https://docs.lumera.io/cascade/guides/encrypted-storage.md): Encrypt files client-side with wallet-derived keys before uploading them to Cascade.
- [Use the SDK in Node.js](https://docs.lumera.io/cascade/guides/nodejs.md): Run the Lumera JavaScript SDK on a server with a programmatic signer.
- [Research Archive example app](https://docs.lumera.io/cascade/guides/research-archive.md): Explore a decentralized academic publishing platform built on Cascade.
- [How Cascade works](https://docs.lumera.io/cascade/how-cascade-works.md): Follow an upload from on-chain registration to permanent storage across the SuperNode network.
- [Install the Cascade SDKs](https://docs.lumera.io/cascade/installation.md): Install the JavaScript and Go SDKs and prepare your bundler for the browser.
- [Cascade](https://docs.lumera.io/cascade/overview.md): The technical model behind Cascade: content addressing, RaptorQ fountain coding, availability commitments, storage challenges, and self-healing.
- [Interchain accounts in practice](https://docs.lumera.io/cross-chain/interchain-accounts.md): Run the full ICS-27 Cascade flow from a controller chain with the Go SDK.
- [Cross-chain storage on Lumera](https://docs.lumera.io/cross-chain/overview.md): Use Cascade as the permanent storage layer for apps on any chain.
- [Cross-chain integration patterns](https://docs.lumera.io/cross-chain/patterns.md): Three proven ways to write to Cascade from an app on another chain.
- [Hermes relayer setup for Lumera](https://docs.lumera.io/cross-chain/relayer-setup.md): The Lumera values to plug into a standard Hermes chain configuration.
- [Ecosystem](https://docs.lumera.io/ecosystem.md): Official applications, developer tools, infrastructure, wallets, and community resources for the Lumera Protocol.
- [Get testnet LUME](https://docs.lumera.io/faucet.md): Request free testnet LUME from the faucet on the Lumera Portal.
- [Protocol Governance](https://docs.lumera.io/governance.md): How the Lumera Protocol evolves through on-chain governance.
- [Lumera Hub Overview](https://docs.lumera.io/hub/overview.md): Lumera Hub is the official cross-platform app for the Lumera network on web, desktop, and mobile.
- [Lumera Hub Wallet Guide](https://docs.lumera.io/hub/wallet.md): Create or import a Lumera wallet in Lumera Hub and manage, send, and stake your LUME.
- [Lumera Protocol](https://docs.lumera.io/index.md): Infrastructure for permanent, provable data and decentralized intelligent services.
- [The Five Foundational Capabilities](https://docs.lumera.io/intelligence-layer/capabilities.md): The five capabilities the Intelligence Layer is built from, how they depend on each other, and which are available today.
- [Durable Memory](https://docs.lumera.io/intelligence-layer/durable-memory.md): Persistent, integrity-checked state that outlives a session, and how the Protocol provides it at more than one temperature.
- [Agent Memory](https://docs.lumera.io/intelligence-layer/durable-memory/agent-memory.md): Append-only, client-encrypted memory for autonomous agents, anchored in Cascade with retention proven on chain.
- [Economic Coordination](https://docs.lumera.io/intelligence-layer/economic-coordination.md): How the Protocol funds work, holds it in escrow, and settles it without bilateral relationships between participants.
- [Escrow and Settlement](https://docs.lumera.io/intelligence-layer/economic-coordination/escrow-and-settlement.md): How the Protocol holds a service fee during execution and releases it only against verified completion.
- [Service Pricing](https://docs.lumera.io/intelligence-layer/economic-coordination/service-pricing.md): How Protocol Service fees are calculated, what they include, and which parameters governance controls.
- [Identity](https://docs.lumera.io/intelligence-layer/identity.md): How the Protocol represents participants, delegates authority, and records verifiable claims about them.
- [LumeraID](https://docs.lumera.io/intelligence-layer/identity/lumeraid.md): How identity works on Lumera today: addresses as identities, ADR-036 signatures, and how access to private objects is enforced.
- [What Is the Intelligence Layer?](https://docs.lumera.io/intelligence-layer/overview.md): The part of the Protocol concerned with autonomous software, and the gap in existing infrastructure it addresses.
- [Architectural Principles](https://docs.lumera.io/intelligence-layer/principles.md): The design rules that govern how capabilities are added to the Protocol, and what each one means in practice.
- [Trust](https://docs.lumera.io/intelligence-layer/trust.md): How the Protocol turns identity, receipts, and settlement history into a verifiable record participants can use to evaluate each other.
- [Trust Graph](https://docs.lumera.io/intelligence-layer/trust/trust-graph.md): The reputation mechanics running on Lumera today, the evidence they are compiled from, and how scores decay and drive enforcement.
- [Verifiable Execution](https://docs.lumera.io/intelligence-layer/verifiable-execution.md): How work is requested, performed by SuperNodes, evidenced by receipts, and settled only on confirmed completion.
- [Actions and the Action Lifecycle](https://docs.lumera.io/intelligence-layer/verifiable-execution/actions.md): How work is requested on Lumera, the states an action moves through, and why the lifecycle is the Protocol's extension point.
- [Networks and Endpoints](https://docs.lumera.io/networks.md): Network configuration, public endpoints, genesis files, and connection information for Lumera Mainnet and Testnet.
- [Protocol Economics](https://docs.lumera.io/protocol-revenue.md): How issuance, transaction fees, protocol-service revenue, and long-term sustainability work across Lumera.
- [Governance Proposals](https://docs.lumera.io/protocol/governance.md): Submitting proposals, voting, software upgrades, and protocol parameter changes on Lumera.
- [Lumera module reference](https://docs.lumera.io/protocol/modules.md): A guided map of the custom, EVM, and standard modules on the Lumera chain.
- [Sense content authentication](https://docs.lumera.io/protocol/sense.md): Submit a file for AI powered near-duplicate analysis and record the result permanently on chain.
- [Get started with Lumera](https://docs.lumera.io/quickstart.md): Connect to a Lumera network, fund an address, and pick the path for what you are building.
- [Run a SuperNode](https://docs.lumera.io/quickstart-supernode.md): What it takes to extend your validator with a SuperNode, condensed to one page.
- [Run a Validator](https://docs.lumera.io/quickstart-validator.md): What it takes to run a Lumera validator, condensed to one page.
- [Go SDK](https://docs.lumera.io/sdk/go.md): Build server-side applications and CLI tools that upload to Cascade and query the Lumera chain.
- [Go SDK reference](https://docs.lumera.io/sdk/go-reference.md): Config fields, client surfaces, ICA helpers, and crypto utilities in the Lumera Go SDK.
- [JavaScript SDK](https://docs.lumera.io/sdk/javascript.md): Install the Lumera JavaScript SDK and store your first file on Cascade.
- [JavaScript SDK reference](https://docs.lumera.io/sdk/javascript-reference.md): Every method, option, and status value in the Lumera JavaScript SDK.
- [lumerad CLI reference](https://docs.lumera.io/sdk/lumerad-cli.md): Use the lumerad command line tool to query chain state, submit transactions, manage keys, and work with Lumera modules.
- [rq-go RaptorQ library](https://docs.lumera.io/sdk/raptorq.md): Use the rq-go library to encode files into fault-tolerant RaptorQ symbols and reconstruct them even with missing data.
- [Rust SDK](https://docs.lumera.io/sdk/rust.md): Build server-side Rust applications and CLI tools that store and retrieve files on Cascade.
- [Rust SDK reference](https://docs.lumera.io/sdk/rust-reference.md): Modules, settings, client surfaces, and helpers in the Lumera Rust SDK.
- [Connect MetaMask to Lumera](https://docs.lumera.io/smart-contracts/connect-metamask.md): Add the Lumera EVM network to MetaMask and work with both address formats.
- [Deploy a contract with Remix](https://docs.lumera.io/smart-contracts/deploy-with-remix.md): Compile, deploy, and call a Solidity contract on Lumera with Remix and MetaMask.
- [Explore the JSON-RPC catalog](https://docs.lumera.io/smart-contracts/openrpc-playground.md): Discover every JSON-RPC method a Lumera node supports through the OpenRPC spec.
- [Smart contracts on Lumera](https://docs.lumera.io/smart-contracts/overview.md): Deploy Solidity contracts on Lumera with standard Ethereum tooling and reach native modules through precompiles.
- [The Action precompile](https://docs.lumera.io/smart-contracts/precompiles/action.md): Request and query Cascade and Sense actions from Solidity contracts.
- [The CosmWasm to EVM bridge](https://docs.lumera.io/smart-contracts/precompiles/cosmwasm-bridge.md): Call CosmWasm contracts from Solidity and the reverse through the Wasm precompile.
- [EVM precompiles on Lumera](https://docs.lumera.io/smart-contracts/precompiles/overview.md): Native chain features exposed to Solidity contracts at fixed addresses.
- [Standard Cosmos EVM precompiles](https://docs.lumera.io/smart-contracts/precompiles/standard.md): Eight precompiles that expose core Cosmos modules to Solidity.
- [The SuperNode precompile](https://docs.lumera.io/smart-contracts/precompiles/supernode.md): Read SuperNode registration state and metrics from Solidity contracts.
- [Compliance and Enforcement](https://docs.lumera.io/supernodes/enforcement.md): The states a SuperNode can occupy, how storage claims are challenged, and what happens when a node fails.
- [SuperNode node setup](https://docs.lumera.io/supernodes/node-setup.md): Install sn-manager on a dedicated server, open the firewall, and initialize your SuperNode.
- [SuperNode operations and troubleshooting](https://docs.lumera.io/supernodes/operations.md): Day to day SuperNode operations, monitoring, upgrades, configuration reference, and troubleshooting.
- [Run a SuperNode on Lumera](https://docs.lumera.io/supernodes/overview.md): Pair a dedicated SuperNode server with your validator to serve Cascade, Sense, and AI workloads for extra rewards.
- [Register your SuperNode](https://docs.lumera.io/supernodes/register.md): Fund the SuperNode account, delegate stake, and register the SuperNode on chain.
- [LUME Token](https://docs.lumera.io/token.md): The native asset of Lumera, used for protocol services, network security, settlement, and governance.
- [v1.20.0 EVM upgrade](https://docs.lumera.io/upgrades/evm-upgrade.md): The Aurora Convergence release added full EVM support and changed how account keys derive.
- [Create a mainnet validator](https://docs.lumera.io/validators/mainnet/create-validator.md): Create a secured wallet, fund it, and register your validator on lumera-mainnet-1.
- [Mainnet node setup](https://docs.lumera.io/validators/mainnet/node-setup.md): Install dependencies and lumerad, then sync your Lumera mainnet node from a snapshot.
- [Mainnet validator operations](https://docs.lumera.io/validators/mainnet/operations.md): Day-to-day operations, chain upgrades, monitoring, and troubleshooting for a Lumera mainnet validator.
- [Run a validator on Lumera](https://docs.lumera.io/validators/overview.md): Run a validator on Lumera mainnet or testnet and help secure the network.
- [Create a testnet validator](https://docs.lumera.io/validators/testnet/create-validator.md): Create a wallet, fund it from the faucet, and register your validator on lumera-testnet-2.
- [Testnet node setup](https://docs.lumera.io/validators/testnet/node-setup.md): Install dependencies and lumerad, then sync your Lumera testnet node from a snapshot.
- [Testnet validator operations](https://docs.lumera.io/validators/testnet/operations.md): Day-to-day operations, chain upgrades, monitoring, and troubleshooting for a Lumera testnet validator.