> 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/resources/releases.md). # Releases and compatibility How this documentation, the open-source Bloxchain Protocol, the npm packages and the Bloxchain Platform line up, which versions the pages on this site describe, and what changed and when. ## Versions and compatibility ### Bloxchain Platform The Platform at [bloxchain.app](https://bloxchain.app) ships continuously. There is no numbered public release; features may appear behind the **Alpha · Testnet · Local-first** badge before they are documented here, and this documentation is updated to match the shipped app. * What the Platform looks like today: [Platform guide](/platform-guide/platform.md) * What is planned: [Roadmap](/resources/roadmap.md) * Documentation changes: [Changelog](#changelog) on this page ### Protocol and SDK (open source) The Protocol repository is the source of truth for versions. Releases are tagged on GitHub and the npm packages are published from the same tree. | What you need | Where to look | | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Release notes and tags | [GitHub releases](https://github.com/PracticalParticle/Bloxchain-Protocol/releases) | | Package version | [`sdk/typescript/package.json`](https://github.com/PracticalParticle/Bloxchain-Protocol/blob/99beac2d6e6d7567c23b25cecaf6f4053f31c987/sdk/typescript/package.json) at the pinned commit | | Solidity version and build settings | `foundry.toml` in the repository | | License | MPL-2.0. See [License and terms](/resources/license.md) | | Audit status | [Audit status](/security/audit-status.md) | ### npm packages and version alignment ```bash npm install @bloxchain/sdk @bloxchain/contracts viem ``` | Package | Role | Version at the documentation pin | | ---------------------- | ------------------------------------------------------------ | -------------------------------- | | `@bloxchain/sdk` | TypeScript clients, meta-transaction helpers, engine mirrors | 1.0.0 (tag `sdk-v1.0.0`) | | `@bloxchain/contracts` | ABIs and artifacts for the Protocol contracts | 1.0.0 (tag `contracts-v1.0.0`) | Install both packages at the same release as the contracts you deploy or import. A mismatch between ABI and deployed bytecode is the most common cause of decode errors in custom integrations. See [SDK setup](/developers/sdk-setup.md) and [Production readiness](/developers/deployment/production-readiness.md). ### Official Sepolia deployments The Platform's **Deploy account** dialog uses the official Sepolia addresses by default. The AccountBlox template, the CopyBlox deploy factory and EngineBlox are listed once, with every other number and default, on [Limits and defaults](/resources/limits-and-defaults.md). Verify them on Etherscan before using them from your own code. Contract addresses are specific to one network and one Protocol release, so read them against the pin on this page. Network: Sepolia, chain 11155111. Ethereum mainnet deployments are coming soon. See [Supported networks](/introduction/supported-networks.md). ### Documentation site * Source: [bloxchain-docs](https://github.com/PracticalParticle/bloxchain-docs) on GitHub. * Platform, Guides, Developers, Security and Resources pages are written here. * Protocol pages under [Protocol](/protocol-reference/protocol.md) are vendored from the Protocol repository at a pinned commit and are not edited on this site. ### Protocol documentation pin | Field | Value | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | Upstream | `https://github.com/PracticalParticle/Bloxchain-Protocol.git` | | Pinned commit | [`99beac2d6e6d7567c23b25cecaf6f4053f31c987`](https://github.com/PracticalParticle/Bloxchain-Protocol/tree/99beac2d6e6d7567c23b25cecaf6f4053f31c987) | | Tag at pin | `contracts-v1.0.0` | | Published as | `protocol/*.md` on this site | Every GitHub link on this site that points into the Protocol repository uses this commit, so the code you read matches the pages you read. When the pin advances, the Protocol section and this table are updated together and the change is recorded in the [Changelog](#changelog) below. ## Changelog Documentation and product notes, newest first. ### 2026-09-14: Consistency pass and a limits reference * Added [Limits and defaults](/resources/limits-and-defaults.md): every cap, default and official address in one place. * Sign-in now reads the same everywhere: sign in if you have early access, otherwise join the waitlist from the same dialog. The Free path needs no account and is open to everyone. * Plans are named, never priced. Pricing is shown at checkout or on request; Enterprise is contact us. * Maturity and audit wording standardised: the Platform runs on Sepolia today, Ethereum mainnet is coming soon, and the audit covers the Protocol core framework only. * The site home names the four audiences (individual users, organizations, builders and developers, AI agents) and points each at its entry page. ### 2026-09-13: Documentation remade for the current Platform * New navigation: Introduction, Getting started, Platform guide, Guides, Developers, Protocol, Security, Resources. * All Platform pages rewritten for **Discover**, **Accounts** and the in-account rail (Overview, Assets, Approvals, History, On-chain access, Policies). * Screenshots added for every Platform page and major dialog. * Terminology aligned with the app: Bloxchain Platform, smart account, execution paths, gates, allowlists, signed files. * Stale pages removed, including the previous per-tab workspace, transaction and settings pages and the separate Resources overview and Community pages (community links now live on [Support and community](/resources/support.md)). * Resources refreshed: [FAQ](/resources/faq.md), [Glossary](/resources/glossary.md), [Troubleshooting](/resources/troubleshooting.md), [Roadmap](/resources/roadmap.md), [License and terms](/resources/license.md). ### 2026-07-02: Protocol link normalization * SDK and Protocol reading links point to the **Protocol** section on this site rather than to files in the GitHub repository. * GitHub links for deploy, audits, LICENSE and SECURITY use the **pinned commit** (`contracts-v1.0.0`). * The Protocol section adds a source repository hub; the link sanitizer fixes upstream-only links in vendored pages. ### 2026-07-02: Pre-publish hardening * Removed private package references from public developer guides. * Stripped legacy redirects from the unpublished site. * Linked the Nethermind NM\_0828 audit report on [Audit status](/security/audit-status.md). * Added a Protocol navigation entry for state abstraction versus account abstraction. ### 2026-06: Production readiness and GitBook structure * Added [Production readiness](/developers/deployment/production-readiness.md), a mainnet checklist for the Protocol, the Platform and the SDK. * Established the top-level sections and vendored the Protocol pages from the Protocol repository with a sync script and pin. *Submit documentation corrections through* [*bloxchain-docs issues*](https://github.com/PracticalParticle/bloxchain-docs/issues)*.* ## Related * [Protocol getting started](/protocol-reference/getting-started.md) * [API reference](/protocol-reference/api-reference.md) * [Deployment](/developers/deployment.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/resources/releases.md?ask=&goal= ``` `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.