@agoric/base-zone

Base Zone Library

Each Zone provides an API that allows the allocation of Exo objects and Stores (object collections) 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; 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, you should instead use @agoric/zone.

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.