@armada/sdk / index / MemoryStorageAdapter
Class: MemoryStorageAdapter
Defined in: src/storage/memory.ts:7
Raw environment KV. The SDK provides IndexedDBStorageAdapter (browser) and a classic-level adapter (node). Higher layers wrap this with encryption + schema versioning; chain-public data may be stored plaintext, decrypted note data is AEAD-encrypted under a rootSecret-derived key. Multi-instance safe: no process-wide lock files.
Implements
Constructors
Constructor
new MemoryStorageAdapter():
MemoryStorageAdapter
Returns
MemoryStorageAdapter
Methods
open()
open(
namespace):Promise<{reset:boolean; }>
Defined in: src/storage/memory.ts:18
Bind the store to namespace. Returns { reset: true } when a namespace mismatch (a redeploy under a preserved identity) triggered a chain-state reset, so the instance can surface it as telemetry. Opening an already-open adapter under a DIFFERENT namespace throws StorageConflictError (it would wipe the chain state of whoever is using it); the same namespace again is a no-op.
Parameters
namespace
Returns
Promise<{ reset: boolean; }>
Implementation of
get()
get(
key):Promise<Uint8Array<ArrayBufferLike> |undefined>
Defined in: src/storage/memory.ts:33
Parameters
key
string
Returns
Promise<Uint8Array<ArrayBufferLike> | undefined>
Implementation of
put()
put(
key,value):Promise<void>
Defined in: src/storage/memory.ts:39
Parameters
key
string
value
Uint8Array
Returns
Promise<void>
Implementation of
del()
del(
key):Promise<void>
Defined in: src/storage/memory.ts:44
Parameters
key
string
Returns
Promise<void>
Implementation of
update()
update(
key,fn):Promise<Uint8Array<ArrayBufferLike> |undefined>
Defined in: src/storage/memory.ts:50
Atomic read-modify-write: fn gets the current value (or undefined) and returns the new one (undefined deletes the record). Atomic with respect to every other write to this adapter. fn MUST be synchronous: an IndexedDB transaction commits as soon as it awaits anything else. Resolves to the value stored.
Parameters
key
string
fn
(current) => Uint8Array<ArrayBufferLike> | undefined
Returns
Promise<Uint8Array<ArrayBufferLike> | undefined>
Implementation of
batch()
batch(
ops):Promise<void>
Defined in: src/storage/memory.ts:62
Apply ops in order as one atomic write: all of them land, or none do.
Parameters
ops
readonly StorageOp[]
Returns
Promise<void>
Implementation of
list()
list(
prefix):AsyncIterable<{key:string;value:Uint8Array; }>
Defined in: src/storage/memory.ts:71
Iterate entries whose key starts with prefix, in key order.
Parameters
prefix
string
Returns
AsyncIterable<{ key: string; value: Uint8Array; }>
Implementation of
resetChainState()
resetChainState():
Promise<void>
Defined in: src/storage/memory.ts:77
Targeted reset of chain-derived namespaces, preserving identity records.
Returns
Promise<void>
Implementation of
StorageAdapter.resetChainState
close()
close():
Promise<void>
Defined in: src/storage/memory.ts:86
Returns
Promise<void>