> 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 · Testnet · Local-first.** The Platform runs on Sepolia today. Ethereum mainnet is coming soon. 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.