Import
Usage
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
settlementId | string | null | Yes | The settlement UUID. Pass null to skip fetching. |
Return Type
| Property | Type | Description |
|---|---|---|
events | SettlementEvent[] | Array of events, ordered chronologically. |
isLoading | boolean | true during fetch. |
error | string | null | Error message if fetch failed. |
refetch | () => Promise<void> | Manually re-fetch events. |
SettlementEvent
| Property | Type | Description |
|---|---|---|
id | string | Event UUID. |
settlement_id | string | The settlement this event belongs to. |
from_state | string | undefined | Previous state (undefined for the initial event). |
to_state | string | The state after this transition. |
triggered_by | string | What triggered the transition (e.g., "system:engine", "m2m:platform"). |
evidence_hash | string | undefined | SHA-256 hash of the transition evidence (on-chain). |
created_at | string | ISO 8601 timestamp. |