# Demos Network Documentation > Technical documentation for the Demos Network - a borderless interconnectivity layer enabling seamless interoperability across various chains and web contexts. ## Docs - [Introduction](https://docs.kynesys.xyz/introduction/overview.md): Welcome to the Demos Network technical documentation - a borderless interconnectivity layer enabling seamless interoperability across various chains and web contexts. - [What Is Demos Network](https://docs.kynesys.xyz/introduction/what-is-demos-network.md): The Demos Network represents a groundbreaking advancement in blockchain technology, acting as a borderless interconnectivity layer that enables seamle... - [Demos Network Architecture](https://docs.kynesys.xyz/introduction/demos-network-architecture.md): The Demos Network primarily consists of two main parts, divided into the repositories `sdks` and `node`. - [Quick Start](https://docs.kynesys.xyz/introduction/quick-start.md): Get up and running with the DEMOS SDK in under 5 minutes. This tutorial walks you through installation, wallet setup, and your first blockchain queries. - [FAQ](https://docs.kynesys.xyz/faq.md): Frequently asked questions about the Demos Network, SDK, and getting started. - [Node Setup](https://docs.kynesys.xyz/cookbook/overview.md): Platform-specific guides for setting up and running a DEMOS Network node locally for development and testing. - [Project Setup](https://docs.kynesys.xyz/cookbook/project-setup/overview.md): Platform-specific guides for setting up and running a Demos Network node locally. - [Run The Project (macOS)](https://docs.kynesys.xyz/cookbook/project-setup/run-the-project-macos.md): Run a Demos Network node on macOS using Docker Compose (recommended) or bare metal. - [Run The Project (Ubuntu)](https://docs.kynesys.xyz/cookbook/project-setup/run-the-project-ubuntu.md): Run a Demos Network node on Ubuntu using Docker Compose (recommended) or bare metal. - [Run the Project (Windows)](https://docs.kynesys.xyz/cookbook/project-setup/run-the-project-windows/overview.md): Run a Demos Network node on Windows via WSL 2 + Docker Compose (recommended) or bare metal. - [WSL 2 Setup](https://docs.kynesys.xyz/cookbook/project-setup/run-the-project-windows/wsl-2-setup.md): Install and configure WSL 2 on Windows 10 and 11 — the recommended host for both Docker Compose and bare-metal Demos node setups. - [Issue Troubleshooting](https://docs.kynesys.xyz/cookbook/project-setup/run-the-project-windows/issue-troubleshooting.md): Common issues and fixes when running a Demos node on Windows via WSL 2 + Docker Compose, or bare metal. - [Getting Started](https://docs.kynesys.xyz/sdk/getting-started.md): Install the latest version of the SDK with: - [WebSDK](https://docs.kynesys.xyz/sdk/websdk/overview.md): The DEMOS WebSDK is a collection of tools that help you communicate with a DEMOS node. - [Authentication](https://docs.kynesys.xyz/sdk/websdk/authentication/overview.md): To get started with the Demos sdk, you need to create master seed for your wallet. The master seed is a 12 or 24 word mnemonic that can be used to rec... - [Fido2 Passkeys](https://docs.kynesys.xyz/sdk/websdk/authentication/fido2-passkeys/overview.md): The Demos SDK offers secure methods to generate or recover private keys using a FIDO2 hardware key, which are then usable across the entire Demos netw... - [Under The Hood Fido2 Passkeys](https://docs.kynesys.xyz/sdk/websdk/authentication/fido2-passkeys/under-the-hood.md): This chapter provides a detailed explanation of how `hmywallet`, along with its Demos wrapper, securely leverages a FIDO2 device to accurately derive ... - [Nodecalls](https://docs.kynesys.xyz/sdk/websdk/nodecalls.md): Read blockchain state via the WebSDK's get* methods. Covers blocks, transactions, addresses, validators, governance, fork detection, and message signing. - [Transactions](https://docs.kynesys.xyz/sdk/websdk/transactions/overview.md): There are 4 types of transactions in DEMOS. - [Programmatic Transactions](https://docs.kynesys.xyz/sdk/websdk/transactions/programmatic-transactions.md): Collapse the classic build → sign → confirm → broadcast flow into a single demos.run.* call per transaction type, with an automatic fee ceiling. - [Amounts & Denominations](https://docs.kynesys.xyz/sdk/websdk/transactions/denominations.md): How to pass amounts to DEMOS transactions: DEM, OS, BigInt, and the sub-DEM precision guard. - [Creating A Transaction](https://docs.kynesys.xyz/sdk/websdk/transactions/creating-a-transaction.md): A DEMOS crosschain transcation contains instructions to execute a signed payload for [supported blockchains](../../cross-chain/#supported-blockchains)... - [Signing A Transaction](https://docs.kynesys.xyz/sdk/websdk/transactions/signing-a-transaction.md): To sign a transaction, you need to connect your master seed to a `Demos` instance. - [Broadcasting A Transaction](https://docs.kynesys.xyz/sdk/websdk/transactions/broadcasting-a-transaction.md): The DEMOS transaction broadcasting system works as a 2 step process. - [Validator Staking](https://docs.kynesys.xyz/sdk/websdk/validator-staking/overview.md): SDK builders for validator staking transactions. Protocol details live under Backend / Validator Lifecycle. - [Governance](https://docs.kynesys.xyz/sdk/websdk/governance/overview.md): SDK builders for proposal + vote transactions. Protocol details live under Backend / Network Governance. - [Quickstart — End-to-End](https://docs.kynesys.xyz/sdk/websdk/governance/quickstart.md): Stake as a validator, raise a proposal, gather votes, and watch it activate — all from one terminal. - [L2PS SDK](https://docs.kynesys.xyz/sdk/websdk/l2ps/overview.md): Encrypt and decrypt transactions for participation in a Layer 2 Privacy Subnet (L2PS). The SDK exposes a small singleton-registry API for managing per-subnet AES-GCM keys. - [Instant Messaging](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/overview.md): End-to-end encrypted, post-quantum messaging through the Demos SDK, with two client classes for two different delivery models. - [What Is The Instant Messaging Protocol](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/what-is-the-instant-messaging-protocol.md): An L2PS-backed, end-to-end encrypted messaging protocol with persistence, history, and offline delivery — plus a legacy signaling-only path for transient relay. - [Architecture Overview](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/architecture-overview.md): The two messaging servers (ports 3005 and 3006), the two client classes, and the L2PS persistence pipeline. - [Encryption](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/encryption.md): Both messaging clients share the same ml-kem-aes end-to-end encryption layer. - [Quickstart](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/quickstart.md): Connect, send, receive, and read history with L2PSMessagingPeer. - [Try it in the browser (POC)](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/try-in-the-poc.md): Register two peers and exchange messages from a browser using the L2PS Wallet POC's Messaging tab — no code required. - [Message Types](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/message-types.md): Wire-protocol message types for L2PSMessagingPeer (port 3006) and the legacy MessagingPeer (port 3005). - [API Reference](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/api-reference.md): Complete method reference for L2PSMessagingPeer (primary) and MessagingPeer (legacy). - [FAQ](https://docs.kynesys.xyz/sdk/websdk/instant-messaging/faq.md): Common questions about the L2PSMessagingPeer (primary) and the legacy MessagingPeer. - [Cross Chain](https://docs.kynesys.xyz/sdk/cross-chain/overview.md): The cross chain (XM) SDKs help you create payloads to interact with other blockchains from DEMOS. These SDKs are divided into 2: - [General Layout Of The Xm Sdks](https://docs.kynesys.xyz/sdk/cross-chain/general-layout-of-the-xm-sdks.md): All the crosschain SDKs share the same interface, with a few blockchain-specific methods occuring on some SDKS. - [Evm](https://docs.kynesys.xyz/sdk/cross-chain/evm.md): The Ethereum Virtual Machine (EVM) is the runtime environment for smart contracts in Ethereum. It's a fundamental part of the Ethereum network and is ... - [Btc](https://docs.kynesys.xyz/sdk/cross-chain/btc.md): The Bitcoin SDK provides an interface to interact with Bitcoin blockchains using SegWit (P2WPKH) transactions. It supports wallet connectivity, transa... - [Solana](https://docs.kynesys.xyz/sdk/cross-chain/solana.md): Solana runs on the following core concepts: - [Aptos](https://docs.kynesys.xyz/sdk/cross-chain/aptos.md): The Aptos blockchain uses the Move programming language and provides a powerful environment for smart contracts and decentralized applications. The De... - [Multiversx Egld](https://docs.kynesys.xyz/sdk/cross-chain/multiversx-egld.md): MultiversX (formerly Elrond) is a highly scalable, fast, and secure blockchain platform for distributed apps, enterprise use cases, and the new intern... - [Near](https://docs.kynesys.xyz/sdk/cross-chain/near.md): NEAR is a user-friendly, scalable layer-1 blockchain platform that uses a sharded proof-of-stake consensus mechanism. It features human-readable accou... - [Ton](https://docs.kynesys.xyz/sdk/cross-chain/ton.md): The Open Network (TON) is a decentralized and open internet, created by the community using a technology designed by Telegram. - [Xrpl](https://docs.kynesys.xyz/sdk/cross-chain/xrpl.md): The XRP Ledger is a decentralized cryptographic ledger powered by a network of peer-to-peer servers. It is fast, energy efficient, and reliable, with ... - [Ten](https://docs.kynesys.xyz/sdk/cross-chain/ten.md): TEN integration is in progress — the SDK class exists but is not yet usable. - [Tron](https://docs.kynesys.xyz/sdk/cross-chain/tron.md): TRON is a decentralized blockchain platform that focuses on high-throughput, scalability, and content distribution. The DEMOS TRON SDK lets you prepare and sign TRX transfer payloads from a Demos transaction. - [Ibc](https://docs.kynesys.xyz/sdk/cross-chain/ibc.md): Inter-Blockchain Communication Protocol (IBC) is a blockchain interoperability protocol used by 110+ chains. It enables secure, permissionless, featur... - [Identities](https://docs.kynesys.xyz/sdk/cross-chain/identities.md): You can associate a crosschain identity with a DEMOS address by creating a signature using your private key and sending it to the DEMOS network. - [Unstoppable Domains](https://docs.kynesys.xyz/sdk/cross-chain/unstoppable-domains.md): Unstoppable Domains(UD) provides user-owned, blockchain-based domain names that serve as universal digital identities for the decentralized web. You can link your Web3 unstoppable domain as an identity using the Demos SDK by following this guide. - [The Xmscript](https://docs.kynesys.xyz/sdk/cross-chain/the-xmscript.md): The `XMScript` is a JSON script that dictates how a cross chain should be broadcasted to another blockchain from a DEMOS node. - [Demoswork](https://docs.kynesys.xyz/sdk/demoswork.md): DemosWork is a module that helps you create a script (DemosScript) that can be executed on the omniweb. - [Utilities](https://docs.kynesys.xyz/sdk/utilities.md): Helper functions exported from @kynesyslabs/demosdk/utils — sleep, address validation, hex/object conversion, and Uint8Array Base64 encoding. - [Storage Programs](https://docs.kynesys.xyz/sdk/storage-programs/overview.md): Storage Programs are a powerful key-value storage solution built into the Demos Network, providing developers with decentralized, persistent data stor... - [Getting Started](https://docs.kynesys.xyz/sdk/storage-programs/getting-started.md): Create, write to, and read from your first Storage Program against the v4.0.3 SDK. - [Access Control](https://docs.kynesys.xyz/sdk/storage-programs/access-control.md): Configure who can read, write, and delete a Storage Program using the v4.0.3 ACL: owner, public, and restricted modes plus allowlists, blacklists, and groups. - [Operations](https://docs.kynesys.xyz/sdk/storage-programs/operations.md): When to use each Storage Program operation, the pre-flight checks each one needs, and how it slots into the build / sign / confirm / broadcast flow. - [Rpc Queries](https://docs.kynesys.xyz/sdk/storage-programs/rpc-queries.md): Read Storage Programs over RPC — when to use the SDK helper vs. the lower-level rpcCall, and what each of the 9 node endpoints does. - [Api Reference](https://docs.kynesys.xyz/sdk/storage-programs/api-reference.md): Method-signature reference for the v4.0.3 Storage Programs SDK: every Demos accessor, StorageProgram static helper, payload type, and constant. - [Code Examples](https://docs.kynesys.xyz/sdk/cookbook/overview.md): Practical examples and recipes for common SDK use cases including storage programs, transactions, and swaps. - [Storage Programs](https://docs.kynesys.xyz/sdk/cookbook/storage-programs/overview.md): Practical patterns that show how to combine the Storage Program SDK primitives in real-world applications. - [Examples](https://docs.kynesys.xyz/sdk/cookbook/storage-programs/examples.md): Concrete, end-to-end recipes for Storage Programs against the v4.0.3 SDK. - [Demoswork](https://docs.kynesys.xyz/sdk/cookbook/demoswork/overview.md): Learn how to create and manage work steps in the Demos network - [Creating Work Steps](https://docs.kynesys.xyz/sdk/cookbook/demoswork/creating-work-steps.md): You can create a web2 workstep to performa a `GET` request to `https://icanhazip.com` using the `prepareWeb2Step` function. - [Conditional Operation](https://docs.kynesys.xyz/sdk/cookbook/demoswork/conditional-operation.md): There are two ways to go about creating a conditional operation. - [Base Operation](https://docs.kynesys.xyz/sdk/cookbook/demoswork/base-operation.md): The base operation allow you to group work steps and operations for execution without any additional logic. - [Signing And Broadcasting](https://docs.kynesys.xyz/sdk/cookbook/demoswork/signing-and-broadcasting.md): To convert a Demoswork object to a transaction, use the `prepareDemosWorkPayload` function. - [Transactions](https://docs.kynesys.xyz/sdk/cookbook/transactions/overview.md): Learn about transaction types and patterns in the Demos network - [Crosschain Transaction](https://docs.kynesys.xyz/sdk/cookbook/transactions/crosschain-transaction.md): You can perform a crosschain transaction via the DEMOS network with the help of the DEMOS sdk. - [Native Transactions](https://docs.kynesys.xyz/sdk/cookbook/transactions/native-transactions.md): You can send DEM using the Demos sdk as shown below: - [Swap](https://docs.kynesys.xyz/sdk/cookbook/swap/overview.md): Learn how to perform cross-chain token swaps using the Demos SDK. - [Crosschain Swap](https://docs.kynesys.xyz/sdk/cookbook/swap/crosschain-swap.md): Swap tokens between chains using the SDK's RubicBridge integration. - [Evm Contract Write Transactions](https://docs.kynesys.xyz/sdk/cookbook/evm-contract-write-transactions.md): The `contract_write` operation enables interaction with smart contracts on EVM-compatible blockchains through the Demos Network. This functionality al... - [Web2](https://docs.kynesys.xyz/sdk/web2/overview.md): The Web2 proxy system allows you to make HTTP requests through the Demos network. Requests are verified by a network of attestation nodes, ensuring da... - [Quick Start](https://docs.kynesys.xyz/sdk/web2/quick-start.md): The Web2 proxy system enables HTTP requests through the Demos network, providing privacy and attestation capabilities through DAHR (Data Agnostic HTTP... - [Key Server OAuth](https://docs.kynesys.xyz/sdk/web2/keyserver-oauth.md): Verify user ownership of GitHub and Discord accounts with DAHR attestation using the KeyServerClient. - [Dahr Api Reference](https://docs.kynesys.xyz/sdk/web2/dahr-api-reference/overview.md): The DAHR (Data Agnostic HTTPS Relay) class handles proxied HTTP requests with attestation. Each instance maintains its own session and provides attest... - [Types](https://docs.kynesys.xyz/sdk/web2/dahr-api-reference/types.md): The Web2 proxy supports standard HTTP methods through the `Web2Method` type: - [TLSNotary](https://docs.kynesys.xyz/sdk/web2/tlsnotary/overview.md): Cryptographic attestation for sensitive web data using TLS session proofs. TLSNotary provides verifiable proofs of web content without revealing the full response to the network. - [Build a TLSNotary Webapp](https://docs.kynesys.xyz/sdk/web2/tlsnotary/build-tlsnotary-webapp.md): Step-by-step tutorial to build a browser-based TLSNotary attestation application - [Integrate TLSNotary (Any Framework)](https://docs.kynesys.xyz/sdk/web2/tlsnotary/iframe-integration.md): Use TLSNotary from Vite, Next.js, SvelteKit, or any non-webpack framework via a lightweight iframe client. Zero WASM configuration required. - [TLSNotary API Reference](https://docs.kynesys.xyz/sdk/web2/tlsnotary/api-reference.md): API reference for TLSNotary cryptographic attestation in the Demos SDK - [TLSNotary Use Cases](https://docs.kynesys.xyz/sdk/web2/tlsnotary/use-cases.md): Common use cases for TLSNotary cryptographic attestation - [Making Requests](https://docs.kynesys.xyz/sdk/web2/making-requests.md): How to make GET and POST requests with custom headers using the DAHR proxy. - [Identities](https://docs.kynesys.xyz/sdk/web2/identities/overview.md): You can associate your web2 account to your DEMOS using the DEMOS sdk. - [Twitter](https://docs.kynesys.xyz/sdk/web2/identities/twitter.md): You can associate your Twitter account with your DEMOS address by following these steps: - [Github](https://docs.kynesys.xyz/sdk/web2/identities/github.md): You can associate your GitHub account with your DEMOS address using gist-based verification. - [Discord](https://docs.kynesys.xyz/sdk/web2/identities/discord.md): You can associate your Discord account with your DEMOS address using message-based verification. - [Telegram](https://docs.kynesys.xyz/sdk/web2/identities/telegram.md): You can associate your Telegram account with your DEMOS address by following these steps. This page provides two integration styles: - [Nomis](https://docs.kynesys.xyz/sdk/web2/identities/nomis.md): Link a Nomis wallet score to your DEMOS address. Nomis provides on-chain reputation scores derived from wallet activity across multiple chains. - [Ethos](https://docs.kynesys.xyz/sdk/web2/identities/ethos.md): Link an Ethos reputation score to your DEMOS address. Ethos provides peer-reviewed credibility scores for EVM wallets. - [Human Passport](https://docs.kynesys.xyz/sdk/web2/identities/human-passport.md): Prove humanity for your DEMOS address using Human Passport (formerly Gitcoin Passport). Verifies you are a unique human via on-chain stamps and off-chain attestations. - [Unstoppable Domains](https://docs.kynesys.xyz/sdk/web2/identities/unstoppable-domains.md): Link an Unstoppable Domain (e.g., brad.crypto) to your DEMOS address. Supports EVM and Solana signing flows. - [Bridges](https://docs.kynesys.xyz/sdk/bridges/overview.md): Cross-chain bridge integrations for transferring assets between blockchains. - [Rubic Bridge Test](https://docs.kynesys.xyz/sdk/bridges/rubic-bridge-test.md): Run the Rubic bridge integration tests in `rubic.test.ts`. - [Post Quantum Cryptography](https://docs.kynesys.xyz/sdk/post-quantum-cryptography.md): Demos support use of the following Quantum safe signing algorithms for transaction and transmission signing: - [Changelog](https://docs.kynesys.xyz/sdk/changelog.md): Track the latest updates, improvements, and new features in the DEMOS SDK. - [Demos Providers Discovery Mechanism](https://docs.kynesys.xyz/frontend/demos-providers-discovery-mechanism.md): This mechanism allows for the discovery of multiple providers without race conditions. The injected providers communicate with the DApp through window... - [Demos Wallet Provider Api](https://docs.kynesys.xyz/frontend/demos-wallet-provider-api/overview.md): The injected provider exposes a small surface: - [Wallet Provider Api Methods](https://docs.kynesys.xyz/frontend/demos-wallet-provider-api/wallet-provider-api-methods.md): Call each via `provider.request({ method: '', params: [...] })` unless noted otherwise. - [Internal Mechanisms](https://docs.kynesys.xyz/backend/internal-mechanisms/overview.md): Explore the internal workings of the Demos Network including time synchronization and cross-context identities. - [Network Time Synchronization](https://docs.kynesys.xyz/backend/internal-mechanisms/network-time-synchronization.md): As Demos network is strongly based on correct communication between nodes, the protocol's way to synchronize timestamps and to have a reliable network... - [Cross Context Identities](https://docs.kynesys.xyz/backend/internal-mechanisms/cross-context-identities.md): Demos Network employs a variety of techniques for different chains and protocols, which is a core aspect of numerous Demos protocol mechanisms, includ... - [Validator Lifecycle](https://docs.kynesys.xyz/backend/validator-lifecycle/overview.md): On-chain validator state machine: registration, top-up, unstake lock, exit. Protocol-side mechanics enforced by every node. - [Stackable Genesis](https://docs.kynesys.xyz/backend/network-governance/overview.md): On-chain governance for network parameters: validators propose changes, vote with stake-weighted supermajority, and activation lands deterministically across every node. - [Global Change Registry](https://docs.kynesys.xyz/backend/global-change-registry/overview.md): As the blockchain expands, storing all required information in each block to compute the current state of the blockchain becomes impractical. To addre... - [Gcr Structure](https://docs.kynesys.xyz/backend/global-change-registry/gcr-structure.md): The following schema shows the internal database structure of the GCR. - [How Is GCR Synced](https://docs.kynesys.xyz/backend/global-change-registry/how-is-gcr-synced.md): How transactions are partitioned, applied concurrently across independent groups, and merged back into a deterministic GCR state. - [Consensus Mechanism](https://docs.kynesys.xyz/backend/consensus-mechanism/overview.md): The landscape of blockchain technology is poised for transformation to achieve widespread adoption and growth. Traditional consensus mechanisms fall s... - [Unparalleled Scalability](https://docs.kynesys.xyz/backend/consensus-mechanism/unparalleled-scalability.md): How PoR-BFT achieves high throughput through dynamic shard composition and parallel block validation. - [Decentralization In PoR-BFT](https://docs.kynesys.xyz/backend/consensus-mechanism/decentralization-in-por-bft.md): Node distribution, governance structure, and economic incentives that ensure true decentralization. - [Enhanced Security](https://docs.kynesys.xyz/backend/consensus-mechanism/enhanced-security.md): Byzantine Fault Tolerance and malicious node exclusion mechanisms in PoR-BFT. - [Comparative Advantage](https://docs.kynesys.xyz/backend/consensus-mechanism/comparative-advantage.md): Comparison of PoR-BFT against PoW, PoS, PoA, and EVM-based consensus mechanisms. - [Addressing Potential Criticisms](https://docs.kynesys.xyz/backend/consensus-mechanism/addressing-potential-criticisms.md): Responses to common concerns about PoR-BFT implementation complexity and node manipulation. - [Conclusion](https://docs.kynesys.xyz/backend/consensus-mechanism/conclusion.md): As we continue to innovate in this rapidly evolving field, it is evident that the future of blockchain technology lies with frameworks like PoR-BFT. B... - [Network Forks](https://docs.kynesys.xyz/backend/network-forks/overview.md): Hard-fork machinery used to schedule and activate consensus-rule changes on the Demos Network at deterministic block heights. - [L2PS Subnet Framework](https://docs.kynesys.xyz/backend/l2ps-subnet-framework/overview.md): Layer 2 Privacy Subnets provide encrypted, private transactions on top of the public L1 blockchain with batch rollups and ZK proofs. - [How L2PS Transactions Are Handled](https://docs.kynesys.xyz/backend/l2ps-subnet-framework/how-are-l2ps-transactions-handled.md): Lifecycle of an L2PS transaction: client-side encryption, node-side decryption + validation, batch aggregation, ZK proof, and L1 confirmation. - [L2PS Quick Start](https://docs.kynesys.xyz/backend/l2ps-subnet-framework/quickstart.md): Complete guide to set up and test L2PS (Layer 2 Privacy Subnets) with ZK proofs. - [ZK Identity Overview](https://docs.kynesys.xyz/backend/zk-identity/overview.md): Privacy-preserving identity attestation using zero-knowledge proofs and nullifiers. - [ZK Setup Guide](https://docs.kynesys.xyz/backend/zk-identity/setup.md): How to setup and generate ZK keys for the Identity System. - [ZK API Reference](https://docs.kynesys.xyz/backend/zk-identity/api-reference.md): Transaction types and data structures for ZK Identity. - [Storage Programs](https://docs.kynesys.xyz/backend/storage-programs/overview.md): Storage Programs are first-class key–value containers that live inside the Demos Network's Global Change Registry (GCR). This document describes how t... - [Communications Stack](https://docs.kynesys.xyz/backend/communications-stack.md): Overview of the Demos node's networking layers: P2P transport, JSON-RPC, the Web2 proxy, and the real-time messaging servers. - [Web2 Proxy (DAHR)](https://docs.kynesys.xyz/backend/communications-stack/web2-proxy-dahr.md): Relay arbitrary HTTPS requests through a Demos node via the web2ProxyRequest RPC method, with deterministic response hashing for attestation. - [Real-time Messaging](https://docs.kynesys.xyz/backend/communications-stack/messaging.md): The WebRTC signaling server and the L2PS-backed messaging server that relay end-to-end encrypted instant messages between peers. - [JSON-RPC Methods](https://docs.kynesys.xyz/backend/api-reference/rpc-methods.md): The node's JSON-RPC over HTTP interface: top-level methods and the nodeCall read-only handler registry. - [HTTP Endpoints](https://docs.kynesys.xyz/backend/api-reference/http-endpoints.md): Plain HTTP GET endpoints and REST route groups served by the node alongside the JSON-RPC interface. - [Health and Readiness](https://docs.kynesys.xyz/backend/operations/health-and-readiness.md): The /health, /health/subsystems, and /info endpoints a Demos node exposes for load balancers, Kubernetes probes, and uptime monitoring. - [Metrics Reference](https://docs.kynesys.xyz/backend/operations/metrics-reference.md): The Prometheus metrics a Demos node exposes on /metrics, including names, types, labels, and histogram buckets. - [Protected Endpoints](https://docs.kynesys.xyz/backend/operations/protected-endpoints.md): The SUDO-gated RPC methods a Demos node exposes (rate-limit/unblock, getCampaignData, awardPoints), how authorization works, and their parameters. - [Referral System](https://docs.kynesys.xyz/backend/incentives/referral-system.md): How Demos nodes generate referral codes, validate them, and award bonus points to referrers and referred users during identity linking. - [Points System](https://docs.kynesys.xyz/backend/incentives/points-system.md): How Demos nodes award reputation points for linking Web2 and Web3 identities, where points are stored in the GCR, and the public award/deduct method surface. - [Overview](https://docs.kynesys.xyz/backend/mcp-server/overview.md): MCP (Model Context Protocol) is an open standard that allows AI assistants to connect to external data sources and tools. The Demos Network MCP integr... - [Configuration](https://docs.kynesys.xyz/backend/mcp-server/configuration.md): The MCP server is configured through environment variables in your `.env` file: - [Architecture](https://docs.kynesys.xyz/backend/mcp-server/architecture.md): The MCP server is integrated into the main node process following the same patterns as the signaling server: - [Monitoring Endpoint](https://docs.kynesys.xyz/backend/mcp-server/monitoring-endpoint.md): The node provides a dedicated `/mcp` endpoint to check MCP server status: - [Available Tools](https://docs.kynesys.xyz/backend/mcp-server/available-tools.md): The MCP server automatically provides these tools when started with your node: - [Client Usage](https://docs.kynesys.xyz/backend/mcp-server/client-usage.md): When enabled, the node starts the MCP server with SSE transport, making it accessible remotely: - [Troubleshooting](https://docs.kynesys.xyz/backend/mcp-server/troubleshooting.md): Enable debug logging for MCP operations: - [Bridges](https://docs.kynesys.xyz/backend/bridges/overview.md): Backend bridge implementations for cross-chain asset transfers and liquidity aggregation. - [Rubic Bridge](https://docs.kynesys.xyz/backend/bridges/rubic-bridge.md): Node-side handling of the Rubic cross-chain bridge — quotes, executes, and mocks trades on behalf of SDK clients. - [Developers Testbed](https://docs.kynesys.xyz/backend/developers-testbed/overview.md): This section explains how to launch a Demos node once you have access to the repository. - [Setting Up The Environment](https://docs.kynesys.xyz/backend/developers-testbed/setting-up-the-environment.md): Running a Demos node requires **Bun**. - [Setting Up The Repository](https://docs.kynesys.xyz/backend/developers-testbed/setting-up-the-repository.md): The first step is to clone and set up the Demos node repository. - [Installing Dependencies](https://docs.kynesys.xyz/backend/developers-testbed/installing-dependencies.md): Installing dependencies is handled entirely through **Bun**. - [Node Configuration](https://docs.kynesys.xyz/backend/developers-testbed/node-configuration.md): Reference for the `.env` variables consumed by a Demos node, with the differences between Track 1 (Docker Compose) and Track 2 (bare metal `./run`) called out. - [Running The Node](https://docs.kynesys.xyz/backend/developers-testbed/running-the-node.md): Start, stop, and operate a Demos node — Track 1 (Docker Compose, recommended) or Track 2 (bare metal `./run`, advanced). - [Miscellaneous](https://docs.kynesys.xyz/backend/miscellaneous/overview.md): Additional guides for database management, node backups, and testnet configuration. - [Browsing The Postgres DB via psql](https://docs.kynesys.xyz/backend/miscellaneous/browsing-the-postgres-db-via-psql.md): Connect to the node's Postgres database from either the Docker Compose stack (Track 1) or the bare-metal sidecar (Track 2). - [Backing Up And Restoring A Node](https://docs.kynesys.xyz/backend/miscellaneous/backing-up-and-restoring-a-node.md): Back up and restore a Demos node identity and chain state for both the Docker Compose stack (Track 1) and the bare-metal `./run` install (Track 2). - [Joining The Testnet Using A Custom Genesis](https://docs.kynesys.xyz/backend/miscellaneous/joining-the-testnet-using-a-custom-genesis.md): Replace the bundled genesis with a network-specific one so a fresh node can sync against an existing Demos network. Covers Track 1 (Docker Compose) and Track 2 (bare metal). ## OpenAPI Specs - [openapi](https://docs.kynesys.xyz/api-reference/openapi.json) ## Optional - [API Reference](https://kynesyslabs.github.io/demosdk-api-ref/index.html) - [Discord](https://discord.gg/SdRqbKEcEJ) - [Status](https://status.demos.sh/) - [Explorer](https://explorer.demos.sh)