Skip to main content

Class: SignedEventLedger

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:32

Constructors​

Constructor​

new SignedEventLedger(storageAdapter, keyManager, agentId, config, tablePrefix?): SignedEventLedger

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:44

Parameters​

storageAdapter​

LedgerStorageAdapter

keyManager​

AgentKeyManager

agentId​

string

config​

ProvenanceConfig

tablePrefix?​

string = ''

Returns​

SignedEventLedger

Methods​

appendEvent()​

appendEvent(type, payload): Promise<SignedEvent>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:86

Append a new event to the ledger. Serialized via internal queue to maintain hash chain integrity.

Parameters​

type​

ProvenanceEventType

payload​

Record<string, unknown>

Returns​

Promise<SignedEvent>

getAllEvents()​

getAllEvents(): Promise<SignedEvent[]>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:265

Get all events for this agent (ordered by sequence).

Returns​

Promise<SignedEvent[]>

getChainState()​

getChainState(): object

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:278

Get the current chain state (for diagnostics).

Returns​

object

lastHash​

lastHash: string

sequence​

sequence: number

getEvent()​

getEvent(id): Promise<SignedEvent | null>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:173

Get a single event by ID.

Parameters​

id​

string

Returns​

Promise<SignedEvent | null>

getEventCount()​

getEventCount(): Promise<number>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:254

Get the total number of events for this agent.

Returns​

Promise<number>

getEventsByPayloadFilter()​

getEventsByPayloadFilter(filter, types?): Promise<SignedEvent[]>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:210

Get events matching a payload filter (searches JSON payload).

Parameters​

filter​

Record<string, unknown>

types?​

ProvenanceEventType[]

Returns​

Promise<SignedEvent[]>

getEventsByRange()​

getEventsByRange(fromSequence, toSequence): Promise<SignedEvent[]>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:184

Get events in a sequence range (inclusive).

Parameters​

fromSequence​

number

toSequence​

number

Returns​

Promise<SignedEvent[]>

getEventsByType()​

getEventsByType(type): Promise<SignedEvent[]>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:197

Get events by type.

Parameters​

type​

ProvenanceEventType

Returns​

Promise<SignedEvent[]>

getLatestEvent()​

getLatestEvent(): Promise<SignedEvent | null>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:241

Get the latest event.

Returns​

Promise<SignedEvent | null>

initialize()​

initialize(): Promise<void>

Defined in: packages/agentos/src/core/provenance/ledger/SignedEventLedger.ts:62

Initialize the ledger: load the last sequence number and hash from the DB.

Returns​

Promise<void>