# @agoric/base-zone

> Allocation zone abstraction library and heap implementation

Latest version **0.2.0** (published 2026-04-08) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @agoric/base-zone
pnpm add @agoric/base-zone
yarn add @agoric/base-zone
bun add @agoric/base-zone
```

## Health

**Score 55/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.2.0 |
| Published | 2026-04-08 |
| First published | 2023-08-05 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | ^20.9 \|\| ^22.11 |
| Dependencies | 7 |
| Unpacked size | 61.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 357 |
| Author | Agoric |
| Maintainers | warner, erights, mhofman, michaelfig, kriskowal, agoricbot, mujahidkay, gibson042, jimlarson, samsiegart |

## Links

- npm: https://www.npmjs.com/package/@agoric/base-zone
- Repository: https://github.com/Agoric/agoric-sdk
- npm.io page: https://npm.io/package/@agoric/base-zone

## Dependencies (7)

- [@endo/exo](https://npm.io/package/@endo/exo.md) ^1.5.12
- [@endo/far](https://npm.io/package/@endo/far.md) ^1.1.14
- [@endo/common](https://npm.io/package/@endo/common.md) ^1.2.13
- [@endo/errors](https://npm.io/package/@endo/errors.md) ^1.2.13
- [@agoric/store](https://npm.io/package/@agoric/store.md) 0.10.0
- [@endo/patterns](https://npm.io/package/@endo/patterns.md) ^1.7.0
- [@endo/pass-style](https://npm.io/package/@endo/pass-style.md) ^1.6.3

## Recent versions

- 0.2.0 (latest) — 2026-04-08
- 0.1.1-dev-e54b10e.0.e54b10e (dev) — 2026-09-10
- 0.3.0-upgrade-23-dev-224776f.0.224776f (upgrade-23-dev) — 2026-08-12
- 0.3.0-u23.0 (agoric-upgrade-23) — 2026-05-06
- 0.2.1-upgrade-22-dev-0922d04.0.0922d04 (upgrade-22-dev) — 2026-04-08
- 0.1.1-other-dev-d15096d.0.d15096d (other-dev) — 2025-11-13
- 0.2.0-u22.1 (agoric-upgrade-22) — 2025-09-09
- 0.1.1-u21.0.1 (agoric-upgrade-21) — 2025-07-29
- 0.1.1-ymax-v0.2-alpha-dev-8e37faa.0 (ymax-v0.2-alpha-dev) — 2025-07-21
- 0.1.1-upgrade-21-dev-16519b2.0 (upgrade-21-dev) — 2025-06-19
- 0.1.1-u21.0 (community-dev) — 2025-06-19
- 0.1.1-upgrade-19-devnet-dev-5428c4d.0 (upgrade-19-devnet-dev) — 2025-04-24
- 0.1.1-upgrade-20-dev-ef71cfd.0 (upgrade-20-dev) — 2025-04-17
- 0.1.1-u20.0 (agoric-upgrade-20) — 2025-04-17
- 0.1.1-upgrade-19-dev-5428c4d.0 (upgrade-19-dev) — 2025-03-13
- … 1924 more at https://npm.io/package/@agoric/base-zone/versions

## README

# Base Zone Library

Each Zone provides an API that allows the allocation of [Exo objects](https://github.com/endojs/endo/tree/master/packages/exo#readme) and [Stores
(object collections)](../store/README.md) which use the same underlying persistence mechanism.  This
allows library code to be agnostic to whether its objects are backed purely by
the JS heap (ephemeral), pageable out to disk (virtual) or can be revived after
a vat upgrade (durable).

This library is used internally by [@agoric/zone](../zone/README.md); refer to it for more details.  Unless you are an author of a new Zone backing store type, or want to use `makeHeapZone` without introducing build dependencies on [@agoric/vat-data](../vat-data/README.md), you should instead use [@agoric/zone](../zone/README.md).

---

Be aware that both this package `@agoric/base-zone` and `@agoric/store` will move from the agoric-sdk repository to the endo repository and likely renamed `@endo/zone` and `@endo/store`. At that time, we will first deprecate the versions here, then replace them with deprecated stubs that reexport from their new home. We hope to eventually remove even these stubs, depending on the compat cost at that time.

---
_Source: https://npm.io/package/@agoric/base-zone · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._