Class: SignedEventLedger
Defined in: packages/agentos/src/safety/provenance/ledger/SignedEventLedger.ts:32
Constructors
Constructor
new SignedEventLedger(
storageAdapter,keyManager,agentId,config,tablePrefix?):SignedEventLedger
Defined in: packages/agentos/src/safety/provenance/ledger/SignedEventLedger.ts:44
Parameters
storageAdapter
LedgerStorageAdapter
keyManager
agentId
string
config
tablePrefix?
string = ''
Returns
SignedEventLedger
Methods
appendEvent()
appendEvent(
type,payload):Promise<SignedEvent>
Defined in: packages/agentos/src/safety/provenance/ledger/SignedEventLedger.ts:86
Append a new event to the ledger. Serialized via internal queue to maintain hash chain integrity.
Parameters
type
payload
Record<string, unknown>
Returns
Promise<SignedEvent>
getAllEvents()
getAllEvents():
Promise<SignedEvent[]>
Defined in: packages/agentos/src/safety/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/safety/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/safety/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/safety/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/safety/provenance/ledger/SignedEventLedger.ts:210
Get events matching a payload filter (searches JSON payload).
Parameters
filter
Record<string, unknown>
types?
Returns
Promise<SignedEvent[]>
getEventsByRange()
getEventsByRange(
fromSequence,toSequence):Promise<SignedEvent[]>
Defined in: packages/agentos/src/safety/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/safety/provenance/ledger/SignedEventLedger.ts:197
Get events by type.
Parameters
type
Returns
Promise<SignedEvent[]>
getLatestEvent()
getLatestEvent():
Promise<SignedEvent|null>
Defined in: packages/agentos/src/safety/provenance/ledger/SignedEventLedger.ts:241
Get the latest event.
Returns
Promise<SignedEvent | null>
initialize()
initialize():
Promise<void>
Defined in: packages/agentos/src/safety/provenance/ledger/SignedEventLedger.ts:62
Initialize the ledger: load the last sequence number and hash from the DB.
Returns
Promise<void>