# Table of Contents - [Dispatching Work - Bless Documentation](#dispatching-work-bless-documentation) - [Cost - Bless Documentation](#cost-bless-documentation) - [CLI Commands - Bless Documentation](#cli-commands-bless-documentation) - [Overview - Bless Documentation](#overview-bless-documentation) - [Local Development - Bless Documentation](#local-development-bless-documentation) - [Deploy Your App - Bless Documentation](#deploy-your-app-bless-documentation) - [Installation - Bless Documentation](#installation-bless-documentation) - [Staking and Rewards - Bless Documentation](#staking-and-rewards-bless-documentation) - [Monad Blockchain - Bless Documentation](#monad-blockchain-bless-documentation) - [Supported Machines - Bless Documentation](#supported-machines-bless-documentation) - [Community - Bless Documentation](#community-bless-documentation) - [Introduction - Bless Documentation](#introduction-bless-documentation) - [Verifying Work - Bless Documentation](#verifying-work-bless-documentation) - [Introduction - Bless Documentation](#introduction-bless-documentation) - [Get Started - Bless Documentation](#get-started-bless-documentation) - [Project Structure - Bless Documentation](#project-structure-bless-documentation) - [Space and Time Database - Bless Documentation](#space-and-time-database-bless-documentation) - [Welcome to Bless - Bless Documentation](#welcome-to-bless-bless-documentation) - [FAQ - Bless Documentation](#faq-bless-documentation) - [Trouble Shooting - Bless Documentation](#trouble-shooting-bless-documentation) - [Getting Support - Bless Documentation](#getting-support-bless-documentation) - [Getting Support - Bless Documentation](#getting-support-bless-documentation) - [Accessing External API - Bless Documentation](#accessing-external-api-bless-documentation) - [Trouble Shooting - Bless Documentation](#trouble-shooting-bless-documentation) - [Managing Your Node - Bless Documentation](#managing-your-node-bless-documentation) - [Hosting Static Websites - Bless Documentation](#hosting-static-websites-bless-documentation) - [Introduction - Bless Documentation](#introduction-bless-documentation) - [Get Started - Bless Documentation](#get-started-bless-documentation) --- # Dispatching Work - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Network Dispatching Work [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [1\. Developer Submission](https://docs.bless.network/learn/network/orchestration#1-developer-submission) * [2\. Task Routing and Matching](https://docs.bless.network/learn/network/orchestration#2-task-routing-and-matching) * [3\. Secure Distribution](https://docs.bless.network/learn/network/orchestration#3-secure-distribution) In the Bless network, compute workloads are distributed to nodes using a combination of decentralized orchestration, resource optimization, and incentivization mechanisms. * * * #### [​](https://docs.bless.network/learn/network/orchestration#1-developer-submission) **1\. Developer Submission** 1. **Workload Request:** * The Developer submits a compute task via the Bless Command Line Interface (e.g., deploying a static site, running an AI model, or executing a dynamic application). * The request includes metadata about the workload, such as: * Resource requirements (CPU, RAM, bandwidth) * Priority and latency expectations * Duration or deadline for task completion 2. **Packaging the Workload:** * The workload is encapsulated in a secure and standardized format (e.g., WebAssembly). This ensures compatibility across all nodes in the network. * * * #### [​](https://docs.bless.network/learn/network/orchestration#2-task-routing-and-matching) **2\. Task Routing and Matching** 1. **Node Discovery:** * The Bless network maintains a real-time registry of active nodes, their geographic locations, and their available resources. * The network then identifies online nodes that match the task’s requirements. 2. **Optimization Algorithms:** * To minimize latency, workloads are routed to nodes closest to the user or end-consumer. * Tasks are distributed based on resource efficiency, ensuring that no single node is overwhelmed while maximizing network utilization. 3. **Incentive Considerations:** * Nodes are prioritized based on their historical performance, uptime, and reliability. * Nodes are rewarded proportionally for their contributions. * * * #### [​](https://docs.bless.network/learn/network/orchestration#3-secure-distribution) **3\. Secure Distribution** 1. **Task Encryption:** * Workloads are encrypted before being sent to nodes to ensure security and privacy. * Each node receives only the data it needs to execute the workload, preventing unauthorized access. 2. **Decentralized Storage Integration:** * For tasks requiring large datasets, the workload might reference external storage systems like IPFS or Arweave. Nodes fetch necessary data using secure protocols. [Verifying Work](https://docs.bless.network/learn/network/verifiability) Assistant Responses are generated using AI and may contain mistakes. --- # Cost - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Cost & Billing Cost [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Testnet Phase (Beta)](https://docs.bless.network/build-on-bless/billing/cost#testnet-phase-beta) [​](https://docs.bless.network/build-on-bless/billing/cost#testnet-phase-beta) Testnet Phase (Beta) ------------------------------------------------------------------------------------------------------ During the testnet phase, all deployments on the Bless Network are free of charge. This allows developers to experiment, build, and deploy applications without any cost while the network is being optimized for scalability and performance. Bless Network is currently in **beta (Testnet)** and is **not yet ready for production use**. Pricing and billing models will be introduced in future mainnet releases. [Local Development](https://docs.bless.network/build-on-bless/deploy/local-development) [Hosting Static Websites](https://docs.bless.network/build-on-bless/tutorials/static-site) Assistant Responses are generated using AI and may contain mistakes. --- # CLI Commands - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation CLI CLI Commands [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Project Management](https://docs.bless.network/build-on-bless/cli/commands#project-management) * [Account and Wallet Management](https://docs.bless.network/build-on-bless/cli/commands#account-and-wallet-management) * [Account Commands](https://docs.bless.network/build-on-bless/cli/commands#account-commands) * [Wallet Commands](https://docs.bless.network/build-on-bless/cli/commands#wallet-commands) * [Getting Help](https://docs.bless.network/build-on-bless/cli/commands#getting-help) The **Bless CLI** provides a set of commands to efficiently manage projects, deployments, accounts, and wallets on the Bless Network. [​](https://docs.bless.network/build-on-bless/cli/commands#project-management) Project Management ---------------------------------------------------------------------------------------------------- Use the following commands to create, build, and deploy your projects: * `init` – Create a new project. * `deploy` – Deploy your project to the Bless Network. * `preview` – Build and launch a local development server. * `manage` – Change the project output type, allowing you to serve a different file format (e.g., HTML for a static site). To build your project without deploying, run: Copy Ask AI npx blessnet options build * * * [​](https://docs.bless.network/build-on-bless/cli/commands#account-and-wallet-management) Account and Wallet Management -------------------------------------------------------------------------------------------------------------------------- Account and wallet management commands can be accessed via the `options` command: Copy Ask AI npx blessnet options account ### [​](https://docs.bless.network/build-on-bless/cli/commands#account-commands) Account Commands * `account` – Manage your Bless Network account. * `account login` – Sign in to your account. * `account logout` – Sign out of your account. ### [​](https://docs.bless.network/build-on-bless/cli/commands#wallet-commands) Wallet Commands * `wallet` – Manage Solana wallets associated with your account. * * * [​](https://docs.bless.network/build-on-bless/cli/commands#getting-help) Getting Help ---------------------------------------------------------------------------------------- If you need assistance while using the CLI, use the `help` or `-h` flag to view a list of available commands: Copy Ask AI npx blessnet help For help with a specific command, append `help` or `-h` after the command: Copy Ask AI npx blessnet options account -h [Overview](https://docs.bless.network/build-on-bless/cli/overview) [Deploy Your App](https://docs.bless.network/build-on-bless/deploy/deploy) Assistant Responses are generated using AI and may contain mistakes. --- # Overview - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation CLI Overview [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Core Features](https://docs.bless.network/build-on-bless/cli/overview#core-features) * [Development Workflow](https://docs.bless.network/build-on-bless/cli/overview#development-workflow) * [Account and Resource Management](https://docs.bless.network/build-on-bless/cli/overview#account-and-resource-management) The **Bless Command Line Interface (CLI)** is the primary tool for deploying and managing applications on the **Bless Network**. It provides a streamlined workflow for project creation, local development, deployment, and resource management. [​](https://docs.bless.network/build-on-bless/cli/overview#core-features) Core Features ------------------------------------------------------------------------------------------ ### [​](https://docs.bless.network/build-on-bless/cli/overview#development-workflow) Development Workflow The Bless CLI simplifies the development process with the following steps: 1. **Project Creation** – Initialize new projects using best-practice templates. 2. **Local Development** – Build and test applications in a local environment. 3. **Deployment** – Deploy applications to the Bless Network with a single command. 4. **Application Management** – Monitor and update deployed applications as needed. ### [​](https://docs.bless.network/build-on-bless/cli/overview#account-and-resource-management) Account and Resource Management The CLI also includes tools for managing your account, wallets, and resource consumption: 1. **Account Management** – Create and manage your developer account. 2. **Wallet Integration** – Manage your Solana wallet address for network interactions. 3. **Resource Monitoring** – Track deployment costs, storage usage, and compute consumption. [Project Structure](https://docs.bless.network/build-on-bless/project-structure) [CLI Commands](https://docs.bless.network/build-on-bless/cli/commands) Assistant Responses are generated using AI and may contain mistakes. --- # Local Development - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Deploy Your App Local Development [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Building and Previewing Locally](https://docs.bless.network/build-on-bless/deploy/local-development#building-and-previewing-locally) ### [​](https://docs.bless.network/build-on-bless/deploy/local-development#building-and-previewing-locally) Building and Previewing Locally To build and preview your app before deployment, use: Copy Ask AI npx blessnet preview This command **compiles your application** and **launches a local development server**, allowing you to test it before going live. If you just want to build your application, use the `npx blessnet options build` command. [Deploy Your App](https://docs.bless.network/build-on-bless/deploy/deploy) [Cost](https://docs.bless.network/build-on-bless/billing/cost) Assistant Responses are generated using AI and may contain mistakes. --- # Deploy Your App - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Deploy Your App Deploy Your App [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Building and Previewing Locally](https://docs.bless.network/build-on-bless/deploy/deploy#building-and-previewing-locally) Deploying your app to Bless Network requires just a single command. If you haven’t already created a project, start by running: Copy Ask AI npx blessnet init cd Once your project is set up, navigate to the project directory and deploy it with: Copy Ask AI npx blessnet deploy This command will automatically **build** your application and **deploy** it to the Bless Network. Upon successful deployment, you will receive: * A **CID (Content Identifier)** for your binary storage on IPFS * A **URL** for accessing your deployed application [​](https://docs.bless.network/build-on-bless/deploy/deploy#building-and-previewing-locally) Building and Previewing Locally ------------------------------------------------------------------------------------------------------------------------------- To build and preview your app before deployment, use: Copy Ask AI npx blessnet preview This command **compiles your application** and **launches a local development server**, allowing you to test it before going live. If you just want to build your application, use the `npx blessnet options build` command. [CLI Commands](https://docs.bless.network/build-on-bless/cli/commands) [Local Development](https://docs.bless.network/build-on-bless/deploy/local-development) Assistant Responses are generated using AI and may contain mistakes. --- # Installation - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Build on Bless Installation [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Prerequisites](https://docs.bless.network/build-on-bless/installation#prerequisites) * [Windows-Specific Requirements](https://docs.bless.network/build-on-bless/installation#windows-specific-requirements) * [Installation](https://docs.bless.network/build-on-bless/installation#installation) * [First-Time Setup](https://docs.bless.network/build-on-bless/installation#first-time-setup) * [CLI Help](https://docs.bless.network/build-on-bless/installation#cli-help) [​](https://docs.bless.network/build-on-bless/installation#prerequisites) Prerequisites ------------------------------------------------------------------------------------------ Before installing the Bless CLI, ensure you have: * `Node.js` (version 18 or higher) * `npm` (Node Package Manager) You can check your installed versions using: Copy Ask AI node -v npm -v If you don’t have Node.js installed, download it from [nodejs.org](https://nodejs.org/) . ### [​](https://docs.bless.network/build-on-bless/installation#windows-specific-requirements) Windows-Specific Requirements For Windows users, additional setup is required: 1 Install Python Download and install [Python from the Microsoft Store](https://apps.microsoft.com/detail/9NCVDN91XZQP?hl=en-us&gl=US&ocid=pdpshare) . 2 Install Visual Studio Code (VS Code) Download and install [Visual Studio Code 2022 Community](https://apps.microsoft.com/detail/XPDCFJDKLZJLP8?hl=en-US&gl=US&ocid=pdpshare) .During the setup process, ensure you select **“Desktop Development with C++”** in the setup configuration. 3 Install Node Version Manager (NVM) Download and install [NVM for Windows](https://github.com/coreybutler/nvm-windows/releases/download/1.2.2/nvm-setup.exe) . NVM allows you to manage multiple Node.js versions easily. * * * [​](https://docs.bless.network/build-on-bless/installation#installation) Installation ---------------------------------------------------------------------------------------- To start using the Bless CLI, run: Using npx Global installation Copy Ask AI npx blessnet Global installation allows you to use the `blessnet` command directly, without the need for the `npx` prefix. #### [​](https://docs.bless.network/build-on-bless/installation#first-time-setup) First-Time Setup On your first run, you’ll be prompted to install the BLESS Runtime: Copy Ask AI ➜ npx blessnet BLESS environment not found. Do you want to install it? (yes/no): y ✔ Installation successful. BLESS environment installed successfully. After installation, the CLI will be ready to use. * * * [​](https://docs.bless.network/build-on-bless/installation#cli-help) CLI Help -------------------------------------------------------------------------------- If you get stuck, use the `help` command to display a list of available commands and usage instructions. Copy Ask AI npx blessnet help [Getting Support](https://docs.bless.network/build-on-bless/support) [Project Structure](https://docs.bless.network/build-on-bless/project-structure) Assistant Responses are generated using AI and may contain mistakes. --- # Staking and Rewards - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Economy Staking and Rewards [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) some text [Supported Machines](https://docs.bless.network/learn/network/runtime) Assistant Responses are generated using AI and may contain mistakes. --- # Monad Blockchain - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Integrationss Monad Blockchain [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Quick Notes](https://docs.bless.network/build-on-bless/integrations/monad#quick-notes) * [Full Example (JS/TS)](https://docs.bless.network/build-on-bless/integrations/monad#full-example-js%2Fts) * [Example Output](https://docs.bless.network/build-on-bless/integrations/monad#example-output) [Monad](https://monad.xyz/) is a high-throughput, EVM-compatible Layer 1 blockchain that exposes the familiar JSON-RPC 2.0 interface. With the Bless SDK’s `fetch` function you can retrieve blocks, initiate transactions, and more, all with a single HTTP POST request. This approach works perfectly in client-side or WASM environments such as Bless nodes. This guide demonstrates a **minimal “latest block” query** using a public testnet RPC. Feel free to substitute another provider (Alchemy, QuickNode, Ankr, etc.) if you need higher rate limits. By the end of this guide you will: * Select a public RPC endpoint * Call `eth_blockNumber` * Convert the hexadecimal result to a decimal block height [​](https://docs.bless.network/build-on-bless/integrations/monad#quick-notes) Quick Notes -------------------------------------------------------------------------------------------- * **No authentication tokens are required** for public endpoints, but each RPC provider enforces its own rate limits. For production workloads, request an API key from a provider like Alchemy or QuickNode to increase those limits. [​](https://docs.bless.network/build-on-bless/integrations/monad#full-example-js%2Fts) Full Example (JS/TS) -------------------------------------------------------------------------------------------------------------- Copy Ask AI async function getEthBlockNumber(url: string) { const response = await fetch(url, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'eth_blockNumber', params: [] }) }) const data = await response.json() const blockNumber = parseInt(data.result, 16) console.log(`Latest block: ${blockNumber} (0x${data.result})`) } // Get the latest block number from the Monad testnet getEthBlockNumber('https://rpc.ankr.com/monad_testnet').catch(console.error) ### [​](https://docs.bless.network/build-on-bless/integrations/monad#example-output) Example Output Copy Ask AI Latest Monad block: 27375104 (0x1a1b2c0) With this snippet, you now have a lightweight, dependency-free way to pull on-chain state from Monad directly in your Bless app. Happy building! [Space and Time Database](https://docs.bless.network/build-on-bless/integrations/space-and-time) Assistant Responses are generated using AI and may contain mistakes. --- # Supported Machines - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Network Supported Machines [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) Bless employs a robust and secure runtime environment to facilitate decentralized computing across a diverse array of devices. This runtime is pivotal in ensuring that computational tasks are executed efficiently, securely, and in isolation from the host system. **Key Features of the Bless Runtime:** 1. **WebAssembly (WASM) Foundation:** * **Performance:** The runtime leverages an optimizing code generator to produce high-quality machine code swiftly. It is fine-tuned for rapid instantiation and minimal overhead during transitions between the host environment and Wasm modules, supporting the scalability of concurrent instances. * **Language Compatibility:** Developers can execute standard bytecode programs compiled from various languages, including C/C++, Rust, Swift, AssemblyScript, and Kotlin. This flexibility allows for the integration of multiple languages within a single application, such as implementing a JavaScript API using Rust. 2. **Security and Isolation:** * **Sandboxed Execution:** The runtime operates within a sandboxed environment, ensuring that computational tasks are isolated from the host system. This design prevents unauthorized access to system resources and maintains the integrity of both the node and the application. * **Resource Allocation:** Specific system resources like CPU, GPU, and RAM are exclusively allocated for Bless Network applications. This ensures that even when the host device is engaged in resource-intensive activities, the performance of Bless applications remains unaffected. 3. **Customizability:** * **Configurable Environment:** The runtime offers a configurable file that provides various options, including imposing additional restrictions on WebAssembly beyond its basic guarantees. This encompasses limits on CPU and memory consumption, allowing for tailored execution environments based on application requirements. [Verifying Work](https://docs.bless.network/learn/network/verifiability) [Staking and Rewards](https://docs.bless.network/learn/economy/staking-and-rewards) Assistant Responses are generated using AI and may contain mistakes. --- # Community - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Documentation Community [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Official Updates](https://docs.bless.network/community#official-updates) * [Just Chatting](https://docs.bless.network/community#just-chatting) * [Support](https://docs.bless.network/community#support) Our community is dedicated to providing value to our members and users. In addition to our platform features, we regularly offer exclusive content, resources, and events for our community members. [​](https://docs.bless.network/community#official-updates) Official Updates ------------------------------------------------------------------------------ [X (Twitter)\ -----------\ \ Most up-to-date Bless news.](https://x.com/theBlessNetwork) [​](https://docs.bless.network/community#just-chatting) Just Chatting ------------------------------------------------------------------------ [Telegram\ --------\ \ Casual community channel to chat with fellow Bless members, ask questions, and share your thoughts.](https://t.me/blessnetofficial) [Discord\ -------\ \ Our Discord server offers more features and channels for different topics, and we also host member-exclusive events there.](https://discord.com/invite/blessnetwork) [​](https://docs.bless.network/community#support) Support ------------------------------------------------------------ Our dedicated support channels are available to help you with any questions or issues you may have. [Discord Support Channel\ -----------------------\ \ A dedicated support channel on Discord.](https://discord.com/invite/blessnetwork) [Getting Support](https://docs.bless.network/support) [Introduction](https://docs.bless.network/run-a-node/introduction) Assistant Responses are generated using AI and may contain mistakes. --- # Introduction - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Documentation Introduction [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [The New Status Quo](https://docs.bless.network/introduction#the-new-status-quo) Imagine an internet powered by the people, for the people. With Bless, your device becomes part of a global, community-driven supercomputer —no more reliance on tech monopolies to provide the internet’s backbone. [​](https://docs.bless.network/introduction#the-new-status-quo) The New Status Quo ------------------------------------------------------------------------------------- Your role is simple but powerful. You’re transforming your device into a compute node that gives unused processing power to a network that puts users first. **You** help build the future of decentralized infrastructure by contributing to a **cloud of people** — a shared, community — run resource built to support the apps and services you already use every day. [Welcome to Bless](https://docs.bless.network/welcome) [Getting Support](https://docs.bless.network/support) Assistant Responses are generated using AI and may contain mistakes. --- # Verifying Work - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Network Verifying Work [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) Bless Network employs a **Dynamic Verification Mechanism** to ensure the integrity and reliability of computational tasks executed across its decentralized platform. This mechanism allows applications to select the most appropriate verification method for each specific task, enhancing both security and efficiency. **Key Components of the Dynamic Verification Mechanism:** 1. **Task-Specific Verification Selection:** * Applications can choose from various verification methods tailored to the nature of the computational task. This flexibility ensures that each task is verified using the most suitable approach, optimizing performance and resource utilization. 2. **Consensus Algorithms:** * For tasks that result in binary outcomes (e.g., yes/no decisions), consensus algorithms like Practical Byzantine Fault Tolerance (pBFT) or RAFT are employed. Nodes participate in a voting process to reach agreement on the task’s result, ensuring fault tolerance and consistency. 3. **Aggregated Data Validation:** * In scenarios where tasks involve data retrieval, such as obtaining price feeds for cryptocurrencies, nodes collect data and compute a weighted average. This method enhances accuracy and mitigates the impact of outliers or erroneous data points. **Benefits of the Dynamic Verification Mechanism:** * **Efficiency:** By selecting verification methods that align with the specific requirements of each task, the network minimizes computational overhead and accelerates processing times. * **Security:** Tailoring verification approaches to task characteristics reduces vulnerabilities and enhances the overall security posture of the network. * **Scalability:** The modular nature of the verification mechanism allows the network to handle a diverse range of computational tasks, supporting scalability as the network grows. [Dispatching Work](https://docs.bless.network/learn/network/orchestration) [Supported Machines](https://docs.bless.network/learn/network/runtime) Assistant Responses are generated using AI and may contain mistakes. --- # Introduction - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Run a Node Introduction [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) Welcome to **Bless Network**, the world’s first shared computer. Unlike traditional cloud services like AWS or Google Cloud, Bless Network enables anyone to contribute their computing power and earn rewards. Currently, there are two ways to participate in the Bless Network: [Browser Extension Node\ ----------------------\ \ A lightweight, easy-to-use option that runs directly in your browser.](https://docs.bless.network/run-a-node/extension-node/get-started) [Native Node (Docker)\ --------------------\ \ A more robust, standalone option for users who want full control and better performance.](https://docs.bless.network/run-a-node/native-node/get-started) [Community](https://docs.bless.network/community) [FAQ](https://docs.bless.network/run-a-node/faq) Assistant Responses are generated using AI and may contain mistakes. --- # Get Started - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Extension Node Get Started [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Next Steps](https://docs.bless.network/run-a-node/extension-node/get-started#next-steps) * [Getting Support](https://docs.bless.network/run-a-node/extension-node/get-started#getting-support) 1 Connect to the Dashboard Sign into the [**Bless Dashboard**](https://bless.network/dashboard) with your preferred login method 2 Download the Extension From your dashboard, you’ll see a large white button to “[Download Extension](https://chromewebstore.google.com/detail/bless/pljbjcehnhcnofmkdbjolghdcjnmekia?hl=en) ”. Head to the Chrome Web Store Bless extension page and hit “Add to Chrome”. 3 Activate and Connect You will automatically be directed to the dashboard where your node should start automatically. Now open your extensions tab and open the browser extension. 4 Start Powering the Network Built for You Roll call takes place every 10 minutes, that time is then added to your dashboard. You’re now receiving real workloads, tailored to your location and system capacity. [​](https://docs.bless.network/run-a-node/extension-node/get-started#next-steps) Next Steps ---------------------------------------------------------------------------------------------- 1. **Explore your Dashboard** Your dashboard is the key to your progress, flick between your active nodes, time accrued, achievements and more. 2. **It’s About Time** The clock starts now. Join the Blessed by running nodes, inviting friends to the network, and diving into community quests. The more you contribute, the faster the clock runs. [​](https://docs.bless.network/run-a-node/extension-node/get-started#getting-support) Getting Support -------------------------------------------------------------------------------------------------------- For any support queries, please join the [Bless Discord Channel](https://discord.gg/blessnetwork) and open a support ticket at the bottom of the channel after verifying. [FAQ](https://docs.bless.network/run-a-node/faq) [Trouble Shooting](https://docs.bless.network/run-a-node/extension-node/trouble-shooting) Assistant Responses are generated using AI and may contain mistakes. --- # Project Structure - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Build on Bless Project Structure [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Creating a New Project](https://docs.bless.network/build-on-bless/project-structure#creating-a-new-project) * [Directory Structure](https://docs.bless.network/build-on-bless/project-structure#directory-structure) * [File & Folder Breakdown](https://docs.bless.network/build-on-bless/project-structure#file-%26-folder-breakdown) * [1\. bls.toml (Project Configuration)](https://docs.bless.network/build-on-bless/project-structure#1-bls-toml-project-configuration) * [2\. index.ts (Main Entry Point)](https://docs.bless.network/build-on-bless/project-structure#2-index-ts-main-entry-point) * [3\. package.json (Dependency Manager)](https://docs.bless.network/build-on-bless/project-structure#3-package-json-dependency-manager) * [4\. TypeScript Configurations (tsconfig.\*.json)](https://docs.bless.network/build-on-bless/project-structure#4-typescript-configurations-tsconfig-json) [​](https://docs.bless.network/build-on-bless/project-structure#creating-a-new-project) Creating a New Project ----------------------------------------------------------------------------------------------------------------- When you create a new Bless project, the Bless CLI automatically sets up a well-structured folder hierarchy. We currently support both JavaScript and TypeScript. To create a new BlessNet project, run: Copy Ask AI npx blessnet init my-first-project cd my-first-project This will generate all the necessary files and folders for your project. [​](https://docs.bless.network/build-on-bless/project-structure#directory-structure) Directory Structure ----------------------------------------------------------------------------------------------------------- A newly initialized Bless project follows this structure: Copy Ask AI . ├── bls.toml # Project configuration ├── index.ts # Entry point ├── package.json # Dependencies ├── tsconfig.base.json # Base TypeScript config ├── tsconfig.debug.json # Debug TypeScript config └── tsconfig.release.json # Release TypeScript config ### [​](https://docs.bless.network/build-on-bless/project-structure#file-%26-folder-breakdown) File & Folder Breakdown #### [​](https://docs.bless.network/build-on-bless/project-structure#1-bls-toml-project-configuration) 1\. bls.toml (Project Configuration) Stores global settings and metadata for your Bless project. This file must not be deleted, as the network uses it to manage configurations. #### [​](https://docs.bless.network/build-on-bless/project-structure#2-index-ts-main-entry-point) 2\. index.ts (Main Entry Point) This is where your project starts execution. Modify this file to define how your application runs. #### [​](https://docs.bless.network/build-on-bless/project-structure#3-package-json-dependency-manager) 3\. package.json (Dependency Manager) Handles project dependencies, scripts, and metadata. #### [​](https://docs.bless.network/build-on-bless/project-structure#4-typescript-configurations-tsconfig-json) 4\. TypeScript Configurations (tsconfig.\*.json) | File | Purpose | | --- | --- | | `tsconfig.base.json` | Shared TypeScript settings for all environments. | | `tsconfig.debug.json` | Optimized for development & debugging. | | `tsconfig.release.json` | Optimized for production builds. | [Installation](https://docs.bless.network/build-on-bless/installation) [Overview](https://docs.bless.network/build-on-bless/cli/overview) Assistant Responses are generated using AI and may contain mistakes. --- # Space and Time Database - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Integrationss Space and Time Database [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Quick Notes](https://docs.bless.network/build-on-bless/integrations/space-and-time#quick-notes) * [Full Example (JS)](https://docs.bless.network/build-on-bless/integrations/space-and-time#full-example-js) * [Example Output](https://docs.bless.network/build-on-bless/integrations/space-and-time#example-output) [Space and Time](https://spaceandtime.io/) is a decentralized data warehouse that lets you run SQL queries against blockchain data, off-chain datasets, or your own custom tables with built-in cryptographic verifiability. This guide shows how to integrate Space and Time with your Bless app using a simple Bitcoin transactions query example. By the end of this guide, you will: * Register a temporary user * Authenticate and obtain an access token * Run a SQL query to fetch Bitcoin transaction data [​](https://docs.bless.network/build-on-bless/integrations/space-and-time#quick-notes) Quick Notes ----------------------------------------------------------------------------------------------------- * A random user is generated for each run in this demo. For production use, replace this with fixed credentials. * An API key from your Space and Time account is required, even for development environments. * The example runs entirely client-side, making it suitable for local development or WASM environments such as Bless nodes. For full API details, refer to the Space and [Time API Documentation](https://docs.makeinfinite.com/reference/secrets-proxy-overview) . [​](https://docs.bless.network/build-on-bless/integrations/space-and-time#full-example-js) Full Example (JS) --------------------------------------------------------------------------------------------------------------- Copy Ask AI function generateRandomPrefix(length = 4) { const chars = 'abcdefghijklmnopqrstuvwxyz' let result = '' for (let i = 0; i < length; i++) { result += chars[Math.floor(Math.random() * chars.length)] } return result } async function registerAndQuery() { const baseUrl = 'https://proxy.api.makeinfinite.dev' const randomPrefix = generateRandomPrefix() const userId = `${randomPrefix}_your_username_here` const password = 'this_is_password_for_above_user_in_the_worker' try { // Step 1: Register user const authResponse = await fetch(`${baseUrl}/auth/register`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ userId, password }) }) if (!authResponse.ok) { console.error('Auth failed:', await authResponse.text()) return } const { accessToken } = await authResponse.json() console.log('✅ Auth success') // Step 2: Run SQL query const queryResponse = await fetch(`${baseUrl}/v1/sql`, { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${accessToken}`, apikey: `sxt_YOUR_API_KEY_HERE` }, body: JSON.stringify({ sqlText: 'SELECT * FROM bitcoin.transactions LIMIT 5' }) }) if (!queryResponse.ok) { console.error('Query failed:', await queryResponse.text()) return } const result = await queryResponse.json() console.log('📦 Query result:', result) } catch (error) { console.error('Error:', error) } } ;(async () => { console.log('🚀 Starting Space and Time Demo') await registerAndQuery() console.log('✅ Done') })() [​](https://docs.bless.network/build-on-bless/integrations/space-and-time#example-output) Example Output ----------------------------------------------------------------------------------------------------------- Running a simple query: Copy Ask AI SELECT * FROM bitcoin.transactions LIMIT 5; Returns results like: Copy Ask AI [\ {\ "BLOCK_NUMBER": 891172,\ "TIME_STAMP": "2025-04-06 08:18:45",\ "TXID": "24d20504131cc44b939c07afded95d0ae97a618710688560a5a8f27d8e00f663",\ "OUTPUTS_VALUE": "1797650",\ "INPUT_COUNT": 1,\ "OUTPUT_COUNT": 2,\ ...\ },\ ...\ ] [Accessing External API](https://docs.bless.network/build-on-bless/tutorials/external-api) [Monad Blockchain](https://docs.bless.network/build-on-bless/integrations/monad) Assistant Responses are generated using AI and may contain mistakes. --- # Welcome to Bless - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Documentation Welcome to Bless [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Our Vision](https://docs.bless.network/welcome#our-vision) * [Join the movement](https://docs.bless.network/welcome#join-the-movement) Bless is a decentralized edge compute network that delivers on-demand CPU and GPU resources close to end users, facilitating access to AI, machine learning, advanced data tools, and the evolving internet landscape. Developers can deploy applications with ultra-low latency and minimal cost, while anyone with spare computing resources can run a node, contributing to the network and earning rewards. [​](https://docs.bless.network/welcome#our-vision) Our Vision ---------------------------------------------------------------- At Bless, we believe that access to compute is a basic human right. In the age of AI and computer-based automation, the ability to harness and utilize compute is as fundamental as access to electricity or clean water. By democratizing computing, we aim to bridge the gap between the haves and the have-nots. We envision a future where computing is accessible, equitable, and beneficial to everyone. By eliminating the need for centralized infrastructure, we reduce costs and complexities for developers while providing opportunities for individuals to turn their idle machines into active participants in the global compute grid. The cause is simple: democratize computing and ensure that the benefits of the web flow back to its users — not just corporations. [​](https://docs.bless.network/welcome#join-the-movement) Join the movement ------------------------------------------------------------------------------ [Run a Node\ ----------\ \ Contribute and start earning](https://docs.bless.network/run-a-node/introduction) [Start Building\ --------------\ \ Explore our Getting Started Guide](https://docs.bless.network/build-on-bless/introduction) [Introduction](https://docs.bless.network/introduction) Assistant Responses are generated using AI and may contain mistakes. --- # FAQ - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Run a Node FAQ [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) * Extension Node * Testnet How many nodes can I run? **One account** can link up to **5 devices**, and **run only one node per device**. Running multiple nodes across browsers will not lead to increased rewards, and could lead to bugs that will not be patched. What devices can I run the extension on? You can install the extension on any device that supports Google Chrome extensions. While it may work on mobile, we strongly recommend using a computer or laptop for better performance, as mobile devices may limit connectivity, drain battery quickly, and experience frequent bugs. Can I use a VPS to run a node? To ensure fairness to all users and simulate the actual environment we’ll be running on Mainnet launch, VPS usage will not be rewarded. Can I run multiple nodes on the same IP address? While this is allowed, our platform has mechanisms in place to ensure fairness. This prevents any advantage based on multiple nodes using the same IP address. How does the Chrome extension use my device’s compute power? The Chrome extension functions as a browser node that processes distributed computational tasks directly on your device. By using a WebAssembly sandbox, the Bless browser node ensures that all operations run securely within an isolated environment, keeping your system safe and uncompromised. What are your data privacy policies for connecting my device? We operate on a fully decentralized network, meaning your participation does not compromise your personal data. Nodes handle workloads in a secure, trustless environment, ensuring privacy throughout. How does Bless ensure fairness across nodes? Bless uses Dynamic Resource Matching, pairing tasks with nodes best suited to handle them. This ensures every task is matched to the best-fit node based on its capabilities, keeping the network balanced and efficient. What is the difference between Bless Node and Bless CLI? Bless Node is a native software or browser extension that any users can install and run to provide compute resources to the Bless Network and earn rewards. Bless CLI is the developer-facing software that allows the application developer to utilize the compute resources on the Bless Network. [Introduction](https://docs.bless.network/run-a-node/introduction) [Get Started](https://docs.bless.network/run-a-node/extension-node/get-started) Assistant Responses are generated using AI and may contain mistakes. --- # Trouble Shooting - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Extension Node Trouble Shooting [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) If you’re experiencing issues with the Bless Extension, this guide provides solutions to the most common problems. If the issue persists, please open a support ticket in the [Bless Discord](https://discord.com/invite/blessnetwork) for further assistance. User already exists with a different type of login You need to log in using the same method and email you originally signed up with.Bless supports three login methods: **Email, GitHub, and Google**. If you’re seeing this error, you’re likely using the wrong login method. Try all available methods to resolve the issue. Unable to verify my device through Web3 Auth Bless currently uses Web3 Auth, an external authentication provider. We are aware of the login issues caused by Web3 Auth’s service and are actively migrating to a more reliable authentication system.If you’re affected, please try again later and bear with us as we complete the transition. Node registration failed This error can occur for several reasons. Try the following solutions: 1. **Temporary Server or Regional Outage** Check our Discord for updates on any ongoing server issues. 2. **Exceeding the 5-Node Limit** Each account can register up to 5 active nodes. If you’re trying to register a 6th node, it won’t launch. To fix this, try retire a node in the Bless Dashboard, under the `My Nodes` page. 3. **General Connection Issues** If none of the above resolve your issue, try these troubleshooting steps: * Clear your browser cache * Log out and log back in (both from the Browser Dashboard and the Extension) * Restart your extension by clicking your profile icon in the Browser Dashboard [Get Started](https://docs.bless.network/run-a-node/extension-node/get-started) [Get Started](https://docs.bless.network/run-a-node/native-node/get-started) Assistant Responses are generated using AI and may contain mistakes. --- # Getting Support - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Build on Bless Getting Support [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Support and Feedback](https://docs.bless.network/build-on-bless/support#support-and-feedback) * [Contributing](https://docs.bless.network/build-on-bless/support#contributing) * [Thank You](https://docs.bless.network/build-on-bless/support#thank-you) [​](https://docs.bless.network/build-on-bless/support#support-and-feedback) Support and Feedback --------------------------------------------------------------------------------------------------- For assistance with the Bless Node, visit the [Support page](https://docs.bless.network/support) in the main documentation section. If you encounter any bugs or have questions while deploying an application, you can start a thread on the [Bless Forum](https://github.com/orgs/blessnetwork/discussions) on GitHub. Our team monitors tickets regularly and strives to respond within **48 hours**. [​](https://docs.bless.network/build-on-bless/support#contributing) Contributing ----------------------------------------------------------------------------------- If you want to contribute to Bless, please check out our [GitHub repositories](https://x.com/theBlessNetwork) . We welcome contributions of all kinds, including bug fixes, feature requests, and documentation improvements. [​](https://docs.bless.network/build-on-bless/support#thank-you) Thank You ----------------------------------------------------------------------------- We’d like to thank everyone who has supported, provided feedback, and contributed to Bless. Your support is greatly appreciated. Thank you. 🙏 [Introduction](https://docs.bless.network/build-on-bless/introduction) [Installation](https://docs.bless.network/build-on-bless/installation) Assistant Responses are generated using AI and may contain mistakes. --- # Getting Support - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Documentation Getting Support [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Support and Feedback](https://docs.bless.network/support#support-and-feedback) * [Contributing](https://docs.bless.network/support#contributing) * [Thank You](https://docs.bless.network/support#thank-you) [​](https://docs.bless.network/support#support-and-feedback) Support and Feedback ------------------------------------------------------------------------------------ For assistance with deploying applications on the Bless Network, visit the [Support page](https://docs.bless.network/build-on-bless/support) in the Build on Bless section. If you have any questions or feedback, please reach out to us via our [Discord (Support Channel)](https://discord.com/invite/blessnetwork) . We normally respond within 48 hours. We would love to hear your thoughts! [​](https://docs.bless.network/support#contributing) Contributing -------------------------------------------------------------------- If you want to contribute to Bless, please check out our [GitHub repositories](https://github.com/blessnetwork) . We welcome contributions of all kinds, including bug fixes, feature requests, and documentation improvements. [​](https://docs.bless.network/support#thank-you) Thank You -------------------------------------------------------------- We’d like to thank everyone who has supported, provided feedback, and contributed to Bless. Your support is greatly appreciated. Thank you. 🙏 [Introduction](https://docs.bless.network/introduction) [Community](https://docs.bless.network/community) Assistant Responses are generated using AI and may contain mistakes. --- # Accessing External API - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Tutorials Accessing External API [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Step 1: Add API Domains to Your bls.toml](https://docs.bless.network/build-on-bless/tutorials/external-api#step-1%3A-add-api-domains-to-your-bls-toml) * [Step 2: Call APIs in Your Code](https://docs.bless.network/build-on-bless/tutorials/external-api#step-2%3A-call-apis-in-your-code) * [Important Notes](https://docs.bless.network/build-on-bless/tutorials/external-api#important-notes) To connect your project to an external API, you’ll need to update your `bls.toml` file with the right permissions before deploying. [​](https://docs.bless.network/build-on-bless/tutorials/external-api#step-1%3A-add-api-domains-to-your-bls-toml) Step 1: Add API Domains to Your `bls.toml` -------------------------------------------------------------------------------------------------------------------------------------------------------------- Open your `bls.toml` file and, under the `[deployment]` section, add a `permissions` line listing your API domains: Copy Ask AI [deployment] permission = "public" nodes = 1 permissions = [ "https://yourapiwebsite/" ] * **Replace** `https://yourapiwebsite/` with your actual API’s base URL. * **Include the full domain and protocol** (e.g., `https://api.example.com/` not just `example.com`). * **Subdomains must be separately listed.** If you’re using both `https://example.com/` and `https://api.example.com/`, you need both in your permissions array. Example with multiple APIs: Copy Ask AI [deployment] permission = "public" nodes = 1 permissions = [ "https://api.example1.com/", "https://api.example2.com/" ] * * * [​](https://docs.bless.network/build-on-bless/tutorials/external-api#step-2%3A-call-apis-in-your-code) Step 2: Call APIs in Your Code ---------------------------------------------------------------------------------------------------------------------------------------- Once your API domains are set up, you can make calls using `fetch` like you normally would: Copy Ask AI async function getData() { const response = await fetch("https://yourapiwebsite/data"); const data = await response.json(); console.log(data); } getData(); * `Only fetch is supported` now. * **The requested URL must exactly match** what you set in `permissions`. * * * [​](https://docs.bless.network/build-on-bless/tutorials/external-api#important-notes) Important Notes -------------------------------------------------------------------------------------------------------- * **Permissions are locked at deploy time.** You can’t update them later without redeploying. * **HTTPS only.** The Shared Computer rejects non-secure HTTP API calls. * **CORS is your responsibility.** Bless doesn’t modify CORS headers. Make sure the API you’re calling allows cross-origin requests. * **Security first.** Only trusted, necessary APIs should be listed. [Hosting Static Websites](https://docs.bless.network/build-on-bless/tutorials/static-site) [Space and Time Database](https://docs.bless.network/build-on-bless/integrations/space-and-time) Assistant Responses are generated using AI and may contain mistakes. --- # Trouble Shooting - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Native Node Trouble Shooting [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) If you’re experiencing issues with the Bless Native Node, this guide provides solutions to the most common problems. If the issue persists, please open a support ticket in the [Bless Discord](https://discord.com/invite/blessnetwork) for further assistance. Node won’t start? 1. Check if port **9527** is already in use Run the following command to check: Terminal Copy Ask AI sudo lsof -i :9527 If the port is in use, either stop the conflicting process or change the port in your Docker command. 2. Verify your `.env` file Ensure all required values are correctly entered and formatted. 3. Check Docker logs for errors Run the following command to inspect logs: Terminal Copy Ask AI docker logs blessnetwork-node 4. Ensure your internet connection is stable A weak or unstable internet connection may prevent your node from connecting to the network. [Managing Your Node](https://docs.bless.network/run-a-node/native-node/node-mgmt) Assistant Responses are generated using AI and may contain mistakes. --- # Managing Your Node - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Native Node Managing Your Node [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Checking Node Logs](https://docs.bless.network/run-a-node/native-node/node-mgmt#checking-node-logs) * [Stopping the Node](https://docs.bless.network/run-a-node/native-node/node-mgmt#stopping-the-node) * [Removing the Node](https://docs.bless.network/run-a-node/native-node/node-mgmt#removing-the-node) * [Persisting Your Node Identity](https://docs.bless.network/run-a-node/native-node/node-mgmt#persisting-your-node-identity) * [Option 1: Store Identity Locally (Recommended)](https://docs.bless.network/run-a-node/native-node/node-mgmt#option-1%3A-store-identity-locally-recommended) * [Option 2: Backup to S3 (Cloud Storage)](https://docs.bless.network/run-a-node/native-node/node-mgmt#option-2%3A-backup-to-s3-cloud-storage) This guide covers essential commands for managing your Bless Node, including checking logs, stopping, and removing your node. It also explains how to persist your node identity to prevent resets when restarting or removing the container. [​](https://docs.bless.network/run-a-node/native-node/node-mgmt#checking-node-logs) Checking Node Logs --------------------------------------------------------------------------------------------------------- To monitor your node’s activity, use: Terminal Copy Ask AI docker logs -f blessnetwork-node [​](https://docs.bless.network/run-a-node/native-node/node-mgmt#stopping-the-node) Stopping the Node ------------------------------------------------------------------------------------------------------- To stop your running node, execute: Terminal Copy Ask AI docker stop blessnetwork-node [​](https://docs.bless.network/run-a-node/native-node/node-mgmt#removing-the-node) Removing the Node ------------------------------------------------------------------------------------------------------- If you need to remove your node container, run: Terminal Copy Ask AI docker rm blessnetwork-node [​](https://docs.bless.network/run-a-node/native-node/node-mgmt#persisting-your-node-identity) Persisting Your Node Identity ------------------------------------------------------------------------------------------------------------------------------- By default, your node identity resets if the container is removed. To prevent this, you can either store it locally using a volume or back up your identity to S3. ### [​](https://docs.bless.network/run-a-node/native-node/node-mgmt#option-1%3A-store-identity-locally-recommended) Option 1: Store Identity Locally (Recommended) To ensure your node identity persists across restarts or container removals, map a local volume: Terminal Copy Ask AI docker run -d \ --name blessnetwork-node \ -p 9527:9527 \ --env-file .env \ -v ${PWD}/node-data:/app/keys \ ghcr.io/blessnetwork/b7s:0.6.6.patch3 This stores your node identity in the `node-data/` directory, preventing it from being lost when the container is removed. ### [​](https://docs.bless.network/run-a-node/native-node/node-mgmt#option-2%3A-backup-to-s3-cloud-storage) Option 2: Backup to S3 (Cloud Storage) If you prefer cloud-based storage, configure your `.env` file with the necessary S3 environment variables. This enables automatic backups of your node identity. [Get Started](https://docs.bless.network/run-a-node/native-node/get-started) [Trouble Shooting](https://docs.bless.network/run-a-node/native-node/trouble-shooting) Assistant Responses are generated using AI and may contain mistakes. --- # Hosting Static Websites - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Tutorials Hosting Static Websites [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Before We Start](https://docs.bless.network/build-on-bless/tutorials/static-site#before-we-start) * [Let’s Get Started](https://docs.bless.network/build-on-bless/tutorials/static-site#let%E2%80%99s-get-started) * [Create Your Project Space](https://docs.bless.network/build-on-bless/tutorials/static-site#create-your-project-space) * [Quick Login Check](https://docs.bless.network/build-on-bless/tutorials/static-site#quick-login-check) * [Building the Website](https://docs.bless.network/build-on-bless/tutorials/static-site#building-the-website) * [Set Up Your Canvas](https://docs.bless.network/build-on-bless/tutorials/static-site#set-up-your-canvas) * [Create Your First Files](https://docs.bless.network/build-on-bless/tutorials/static-site#create-your-first-files) * [Set Up Your Simple Server](https://docs.bless.network/build-on-bless/tutorials/static-site#set-up-your-simple-server) * [Time to Launch](https://docs.bless.network/build-on-bless/tutorials/static-site#time-to-launch) * [Test Drive Locally](https://docs.bless.network/build-on-bless/tutorials/static-site#test-drive-locally) * [Deploy to Bless](https://docs.bless.network/build-on-bless/tutorials/static-site#deploy-to-bless) * [Trouble Shooting](https://docs.bless.network/build-on-bless/tutorials/static-site#trouble-shooting) Ready to launch your website into the decentralized world? Whether you’re building a personal blog, a meme page, or just experimenting with web development, we’ll help you get your site up and running on the Bless Network in no time. This guide is perfect for beginners, but even if you’re an experienced developer, you might pick up some cool tricks along the way. Let’s dive in\\\\! * * * [​](https://docs.bless.network/build-on-bless/tutorials/static-site#before-we-start) Before We Start ------------------------------------------------------------------------------------------------------- Before you begin, you’ll need: * The Bless CLI installed on your computer ([hop over to our installation guide](https://docs.bless.network/build-on-bless/installation) ) * Some basic HTML, CSS, and JavaScript knowledge (but don’t worry, we’ll provide all the code you need\\\\!) * * * [​](https://docs.bless.network/build-on-bless/tutorials/static-site#let%E2%80%99s-get-started) Let’s Get Started ------------------------------------------------------------------------------------------------------------------- ### [​](https://docs.bless.network/build-on-bless/tutorials/static-site#create-your-project-space) Create Your Project Space First, fire up your terminal and run this command to create your new project: Copy Ask AI npx blessnet init When it asks for a name, pick something fun (like `my-awesome-site`). This will create your project template where all the magic will happen. Next, let’s move into your new project: Copy Ask AI cd my-awesome-site ### [​](https://docs.bless.network/build-on-bless/tutorials/static-site#quick-login-check) Quick Login Check Before we proceed further, let’s make sure you’re logged in: Copy Ask AI npx blessnet account login Just follow the email verification prompts, and you’ll be good to go\\\\! * * * [​](https://docs.bless.network/build-on-bless/tutorials/static-site#building-the-website) Building the Website ----------------------------------------------------------------------------------------------------------------- ### [​](https://docs.bless.network/build-on-bless/tutorials/static-site#set-up-your-canvas) Set Up Your Canvas Create a new folder called `public` - this is where all your website files will live. If you want to do it using the terminal, run: Copy Ask AI mkdir public ### [​](https://docs.bless.network/build-on-bless/tutorials/static-site#create-your-first-files) Create Your First Files Let’s create three files that will bring your website to life. Don’t worry about typing everything perfectly - just copy and paste - we’ll walk through each component: 1. `index.html` - This is your main page that visitors will see 2. `style.css` - Makes your website visually appealing with custom styling 3. `script.js` - Adds interactive features to engage your visitors index.html style.css script.js Copy Ask AI Bless Network

Welcome to Blessnet

Bless Network

Powered by The Bless Network

### [​](https://docs.bless.network/build-on-bless/tutorials/static-site#set-up-your-simple-server) Set Up Your Simple Server We are almost there\\! Let’s edit the `index.ts` file in the project root (you need to go back from the `public` folder where you just added the three files). This creates a simple server that will send the three files you just created to the browser accessing your website. index.ts Copy Ask AI import WebServer from '@blockless/sdk-ts/dist/lib/web'; const server = new WebServer(); server.statics('public', '/'); server.start(); * * * [​](https://docs.bless.network/build-on-bless/tutorials/static-site#time-to-launch) Time to Launch ----------------------------------------------------------------------------------------------------- Now, we are ready to deploy and see your website in production! ### [​](https://docs.bless.network/build-on-bless/tutorials/static-site#test-drive-locally) Test Drive Locally Before we show the world, let’s make sure everything looks perfect. Run the following command to test your website locally on your computer. Copy Ask AI npx blessnet preview serve Visit `http://localhost:3000` to see the website you just created come to life\\\\! ### [​](https://docs.bless.network/build-on-bless/tutorials/static-site#deploy-to-bless) Deploy to Bless Now it’s finally time to deploy your website to the Bless Network and show it off to the world\\\\! To do that, run: Copy Ask AI npx blessnet deploy Congratulations\\\\! Your site is now live on the Bless Network\\\\! You’ll get a URL like `https://your-awesome-site.bls.dev` that you can share with everyone. * * * [​](https://docs.bless.network/build-on-bless/tutorials/static-site#trouble-shooting) Trouble Shooting --------------------------------------------------------------------------------------------------------- If you encounter any problems that you cannot solve, we are here to help. Simply start a thread on the [Bless Forum](https://github.com/orgs/blessnetwork/discussions) on GitHub and we will typically respond within **48 hours**. [Cost](https://docs.bless.network/build-on-bless/billing/cost) [Accessing External API](https://docs.bless.network/build-on-bless/tutorials/external-api) Assistant Responses are generated using AI and may contain mistakes. --- # Introduction - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Build on Bless Introduction [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Overview](https://docs.bless.network/build-on-bless/introduction#overview) * [What is Bless?](https://docs.bless.network/build-on-bless/introduction#what-is-bless%3F) * [Supported Languages and Frameworks](https://docs.bless.network/build-on-bless/introduction#supported-languages-and-frameworks) * [Bless CLI](https://docs.bless.network/build-on-bless/introduction#bless-cli) [​](https://docs.bless.network/build-on-bless/introduction#overview) Overview -------------------------------------------------------------------------------- Welcome to the Bless developer documentation. This guide provides everything you need to understand and interact with the Bless Network, from deploying workloads to managing resources using the Bless CLI. Bless is currently in beta (Testnet) and is not yet ready for production use. [​](https://docs.bless.network/build-on-bless/introduction#what-is-bless%3F) What is Bless? ---------------------------------------------------------------------------------------------- Bless is a decentralized alternative to traditional cloud services. Instead of relying on a centralized network of large data centers, it leverages a globally distributed network of nodes to create a shared, decentralized computing infrastructure. Currently, Bless Network has over **4.1 million nodes** online each day. By utilizing previously untapped resources, Bless can offer significantly lower costs compared to traditional cloud providers. This documentation will guide you through developing, deploying, and managing applications on the Bless. To learn more about how Bless differs from traditional cloud solutions, visit the [Learn](https://docs.bless.network/learn/network/) section. [​](https://docs.bless.network/build-on-bless/introduction#supported-languages-and-frameworks) Supported Languages and Frameworks ------------------------------------------------------------------------------------------------------------------------------------ We currently supports both TypeScript and JavaScript applications. Additional language and framework support will be introduced in future updates. For external API calls, see [here](https://docs.bless.network/build-on-bless/external-api/) . [​](https://docs.bless.network/build-on-bless/introduction#bless-cli) Bless CLI ---------------------------------------------------------------------------------- The Bless Command Line Interface (CLI) is your primary tool for deploying applications to the Bless Network. It provides everything you need to manage projects, handle deployments, and maintain resources.[Get Started\ -----------\ \ Install Bless CLI and start building on Bless](https://docs.bless.network/build-on-bless/installation) [Getting Support](https://docs.bless.network/build-on-bless/support) Assistant Responses are generated using AI and may contain mistakes. --- # Get Started - Bless Documentation [Bless Documentation home page![light logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/light.svg)![dark logo](https://mintlify.s3.us-west-1.amazonaws.com/blockless-8c3063e8/public/logo/dark.svg)](https://docs.bless.network/) Search... ⌘KAsk AI Search... Navigation Native Node Get Started [Documentation](https://docs.bless.network/welcome) [Build on Bless](https://docs.bless.network/build-on-bless/introduction) [Learn](https://docs.bless.network/learn/network/orchestration) On this page * [Prerequisites](https://docs.bless.network/run-a-node/native-node/get-started#prerequisites) * [Quick Start](https://docs.bless.network/run-a-node/native-node/get-started#quick-start) * [1\. Create a .env Configuration File](https://docs.bless.network/run-a-node/native-node/get-started#1-create-a-env-configuration-file) * [2\. Start Your Bless Node](https://docs.bless.network/run-a-node/native-node/get-started#2-start-your-bless-node) * [Next Steps](https://docs.bless.network/run-a-node/native-node/get-started#next-steps) This guide will walk you through installing and running a **Bless Native Node** using Docker. [​](https://docs.bless.network/run-a-node/native-node/get-started#prerequisites) Prerequisites ------------------------------------------------------------------------------------------------- Before you begin, ensure you have the following: * A machine (Mac, Windows, or Linux) with internet access. * Docker installed. If not [download here](https://docs.docker.com/get-docker/) . [​](https://docs.bless.network/run-a-node/native-node/get-started#quick-start) Quick Start --------------------------------------------------------------------------------------------- ### [​](https://docs.bless.network/run-a-node/native-node/get-started#1-create-a-env-configuration-file) 1\. Create a `.env` Configuration File First, create a new folder for your node setup. Inside this folder, create a `.env` file and add the following configuration: .env Copy Ask AI NODE_ROLE=worker BOOT_NODES=/ip4/143.244.211.194/tcp/9010/p2p/12D3KooWGuBya7RYHTzZmR7uLJYUXffSPuBUPKnmYSfsgwyjqFuw # (Optional) S3 Backup Configuration AWS_ACCESS_KEY_ID= AWS_SECRET_ACCESS_KEY= KEY_PATH= KEY_PASSWORD= Replace ``, ``, ``, and `` with your actual credentials if using S3 backup. ### [​](https://docs.bless.network/run-a-node/native-node/get-started#2-start-your-bless-node) 2\. Start Your Bless Node Navigate to the folder where your `.env` file is located and run the following command in your terminal to start your node: Terminal Copy Ask AI docker run -d \ --name blessnetwork-node \ -p 9527:9527 \ --env-file .env \ ghcr.io/blessnetwork/b7s:0.6.6.patch3 [​](https://docs.bless.network/run-a-node/native-node/get-started#next-steps) Next Steps ------------------------------------------------------------------------------------------- Your **Bless Node** should now be up and running, actively contributing to the network! Now it’s time to **manage your node** and ensure optimal performance. Check out our [Node Management Guide](https://docs.bless.network/run-a-node/native-node/node-mgmt) for detailed instructions on monitoring, stopping, and backing up your node. If you need further assistance, visit our [Support Channel](https://docs.bless.network/support) for help from the community and support team. [Trouble Shooting](https://docs.bless.network/run-a-node/extension-node/trouble-shooting) [Managing Your Node](https://docs.bless.network/run-a-node/native-node/node-mgmt) Assistant Responses are generated using AI and may contain mistakes. ---