holdingsHistory
suspend fun holdingsHistory(partyId: String, beginExclusive: Long = 0, endInclusive: Long? = null): List<TokenStandardClient.HoldingsChange>
The party's holdings history between two offsets: every committed update that created or archived one of its CIP-0056 holdings, oldest first, with transfer-level HoldingsChange.summary rows. Defaults to genesis → current ledger end (a finite read).
Implementation note: archive events carry no payload, so the stream is always walked from ledger begin — creations seen along the way resolve later archives (holding amounts/owners, transfer views of accepted instructions) even when beginExclusive> 0; only updates past beginExclusive are returned. On a pruned participant the walk starts at the retained history's begin, and archives of pre-retention holdings surface as bare contract ids.