> 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/developers/integration-surfaces.md).

# Integration surfaces

Three ways to work with Bloxchain — often combined on the **same contract address**.

## bloxchain.app (hosted Console)

| Aspect             | Detail                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------- |
| **What**           | Browser workspace for operators — non-custodial                                                                     |
| **Keys**           | Your wallets; we do not hold private keys                                                                           |
| **Best for**       | Treasury ops, policy setup, approvals without custom UI                                                             |
| **Implementation** | Hosted web application built and operated by Particle; enforces the same on-chain rules as the open-source Protocol |

[Get started](/platform-bloxchain.app/start.md)

## @bloxchain/sdk (TypeScript)

| Aspect       | Detail                                                                                                      |
| ------------ | ----------------------------------------------------------------------------------------------------------- |
| **What**     | Open-source SDK from [Bloxchain-Protocol](https://github.com/PracticalParticle/Bloxchain-Protocol) releases |
| **Control**  | You run infrastructure and signing policy                                                                   |
| **Best for** | Automation, embedded flows, CI/CD deploys                                                                   |

[Quick start](/getting-started/quickstart.md) · [Core patterns](/developers/sdk-core-patterns.md)

Integrators pin **`@bloxchain/sdk`** and **`@bloxchain/contracts`** to the same Protocol tag they deploy. The Console and custom integrations share the same on-chain policy layer — use the public SDK documentation for integration work.

## Bloxchain Protocol (Solidity)

| Aspect       | Detail                                                                                                                                        |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| **What**     | On-chain Account-style contracts — source of truth                                                                                            |
| **Control**  | You deploy and govern bytecode; official CopyBlox clones are **immutable** ([Deployment](/developers/deployment.md#immutable-vs-upgradeable)) |
| **Best for** | Custom modules, extensions, audited baselines                                                                                                 |

[Deployment guide](/developers/deployment.md) · [Protocol getting started](/protocol/getting-started.md) (imported)

## Hybrid (common)

Use **Console for humans** and **SDK for automation** against the same deployment. Policy changes still require governed on-chain operations.

## Version alignment

Pin Protocol tag, npm SDK, and deployed bytecode to the same release — [Releases](/resources/releases.md).


---

# 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/developers/integration-surfaces.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.