> For the complete documentation index, see [llms.txt](https://docs.bloxchain.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bloxchain.app/readme.md).

# Bloxchain Documentation

Bloxchain is a platform for governed blockchain operations. Operate with the **Bloxchain Platform** at [bloxchain.app](https://bloxchain.app), or build with the open-source **Bloxchain Protocol**. Both enforce the same on-chain policy: a request is proposed, waits or collects approvals according to rules stored in the smart account, and only then executes.

{% hint style="info" %}
**Alpha · Local-first.** Official deployments are live on the 15 supported networks, in the Platform and in the Protocol. The Protocol core is audited by Nethermind (NM\_0828), core framework scope. Custom extensions and your own configuration are not covered by that audit. You can use the Platform without an account; everything is stored on your device unless you join an organization.
{% endhint %}

## Start here

| If you want to…                                               | Read                                                                                                                       |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Understand what Bloxchain is and how a governed request works | [What is Bloxchain?](/introduction/what-is-bloxchain.md) → [How governed operations work](/introduction/how-it-works.md)   |
| Deploy your first smart account on Sepolia                    | [Your first smart account](/get-started/quickstart.md)                                                                     |
| Send and approve your first request                           | [Your first governed request](/get-started/first-request.md)                                                               |
| Operate an account someone gave you access to                 | [Operate an account](/platform-guide/operate.md) → [Approvals](/platform-guide/operate/approvals.md)                       |
| Protect your own funds with a second wallet                   | [Personal security account](/guides/personal-security.md)                                                                  |
| Run a treasury where one person requests and another approves | [Team treasury](/guides/team-treasury.md) → [Organization governance](/guides/organization-governance.md)                  |
| Decide who may do what, and enforce it on chain               | [Design roles and permissions](/guides/roles-and-permissions.md) → [Policies](/platform-guide/policies.md)                 |
| Build Bloxchain into your own application                     | [Developer quickstart](/get-started/developer-quickstart.md) → [Integration surfaces](/developers/integration-surfaces.md) |
| Configure an account from code instead of the browser         | [Configure programmatically](/developers/sdk-setup/configure-programmatically.md)                                          |
| Give an AI agent the context to draft a request you approve   | [For AI agents](/developers/for-ai-agents.md) → [Approve with an agent's help](/guides/agent-assisted-requests.md)         |
| Review the security model and the audit                       | [Security](/security/security.md)                                                                                          |
| Look up a cap, a default, or an official address              | [Limits and defaults](/resources/limits-and-defaults.md)                                                                   |

Not sure how much to configure by hand? [Ways to configure an account](/guides/ways-to-configure.md) compares presets, the browser, signed files, the SDK, and agent-assisted setup.

## Site map

| Section                                            | What it covers                                                                                                                                  |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| [Introduction](/introduction/what-is-bloxchain.md) | Concepts: smart accounts, the governed lifecycle, execution paths, Free versus sign-in versus organizations, networks                           |
| [Getting started](/get-started/quickstart.md)      | Short end-to-end walkthroughs for operators and developers                                                                                      |
| [Platform guide](/platform-guide/platform.md)      | Every screen of bloxchain.app: Discover, Accounts, the account rail (Overview, Assets, Approvals, History, On-chain access, Policies), Settings |
| [Guides](/guides/guides.md)                        | Recipes: personal security, team treasury, asset issuance, contract calls, cross-device approval, role design                                   |
| [Developers](/developers/developers.md)            | SDK setup, patterns, examples, Protocol deployment, production readiness                                                                        |
| [Protocol](/protocol-reference/protocol.md)        | Architecture and API reference, synced from the Protocol repository                                                                             |
| [Security](/security/security.md)                  | Security model, audit status, known limitations, disclosure                                                                                     |
| [Resources](/resources/faq.md)                     | FAQ, glossary, [limits and defaults](/resources/limits-and-defaults.md), troubleshooting, roadmap, releases, support, license                   |

## How the pieces fit

```
bloxchain.app (Platform)      @bloxchain/sdk (Protocol SDK)
        │                              │
        └──────────── requests ────────┘
                         ↓
          Smart account on Ethereum (Protocol)
     roles · time lock · permissions · gates · allowlists
```

The Platform and the SDK are two ways to talk to the same smart account. Neither can bypass the policy stored on-chain.

## About this documentation

Pages under [Protocol](/protocol-reference/protocol.md) are copied from the [Bloxchain-Protocol](https://github.com/PracticalParticle/Bloxchain-Protocol) repository at a pinned release; see [Releases and compatibility](/resources/releases.md#protocol-documentation-pin). Everything else is written for the current Platform release and updated with it; see the [Changelog](/resources/releases.md#changelog).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.bloxchain.app/readme.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.