Skip to content

@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 ​

StorageNamespace

Returns ​

Promise<{ reset: boolean; }>

Implementation of ​

StorageAdapter.open


get() ​

get(key): Promise<Uint8Array<ArrayBufferLike> | undefined>

Defined in: src/storage/memory.ts:33

Parameters ​

key ​

string

Returns ​

Promise<Uint8Array<ArrayBufferLike> | undefined>

Implementation of ​

StorageAdapter.get


put() ​

put(key, value): Promise<void>

Defined in: src/storage/memory.ts:39

Parameters ​

key ​

string

value ​

Uint8Array

Returns ​

Promise<void>

Implementation of ​

StorageAdapter.put


del() ​

del(key): Promise<void>

Defined in: src/storage/memory.ts:44

Parameters ​

key ​

string

Returns ​

Promise<void>

Implementation of ​

StorageAdapter.del


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 ​

StorageAdapter.update


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 ​

StorageAdapter.batch


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 ​

StorageAdapter.list


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>

Implementation of ​

StorageAdapter.close