Events

This catalog covers custom events from the controller, pool, governance, price aggregator, and DeFindex adapter. Decode each event by its emitting contract address and exact ordered topics. The position NFT also emits standard token events for mint, transfer, and burn. Library ownership and access-control events need separate decoders.

Subscribe to both the controller and pool. The pool publishes market state and full market parameters.

Reading the payloads

Custom events below use fixed Soroban Symbol topics. Match each symbol in order. Standard library events can also place indexed fields in topics. Payload encoding is one of three shapes:

Format	Payload
`map` (default)	An `ScMap` whose keys are the field names sorted alphabetically, not in declaration order. Read by key.
`vec`	An `ScVec` of the fields in declaration order. Read by position.
`single-value`	The struct has one field and the payload is that field’s value, with no wrapper.

UpdatePositionBatchEvent uses vec. PoolMarketStateBatchEvent and PoolMarketParamsBatchEvent use single-value. All other events below use map. A nested #[contracttype] struct with named fields encodes as an alphabetically-keyed map; one with unnamed fields (a tuple struct) encodes as a vector in declaration order. Field tables use the numeric scales defined in Data types. Raw asset units use token decimals; read those from the token contract or PoolMarketParamsBatchEvent. Pool timestamps are milliseconds.

`PositionAction` values

PositionAction is a unit-only enum with #[repr(u32)], so it appears on the wire as a plain u32. It tags each leg inside UpdatePositionBatchEvent.

Variant	Value	Meaning
`Supply`	0	Collateral added by a plain supply, or by the deposit leg of a strategy.
`Borrow`	1	Debt taken by a plain borrow.
`Withdraw`	2	Collateral removed by a plain withdraw.
`Repay`	3	Debt repaid by a plain repay.
`LiqRepay`	4	Debt retired on the liquidated account.
`LiqSeize`	5	Collateral debited from the liquidated account. Gross of the protocol fee, in both seize modes.
`Multiply`	6	Debt borrowed by the leverage leg of `multiply`.
`ParamUpd`	7	Supply position rewritten by a risk-parameter refresh; no funds move.
`SwDebtR`	8	Both legs of `swap_debt`: the new borrow and the repay of the old debt.
`SwColWd`	9	Collateral withdrawn to be swapped by `swap_collateral`.
`RpColWd`	10	Collateral withdrawn to be swapped by `repay_debt_with_collateral`.
`RpColR`	11	Debt repaid from swap proceeds in `repay_debt_with_collateral`.
`CloseWd`	12	Full withdrawal of a collateral position when a position is closed out.
`Migrate`	13	Position moved in from an external Blend pool.
`RpColNet`	14	Collateral netted directly against same-asset debt — no swap, no token movement.
`LiqCredit`	15	Collateral credited to a share-credit liquidator’s receiving account. Net of the protocol fee.
`FlashPos`	16	Strategy-debt mint for `flash_position`.

LiqSeize is gross, LiqCredit is net. In share-credit mode the protocol fee is withheld in shares. Subtracting the two native-unit amount fields is not an exact fee calculation because gross and net shares are rounded separately. Summing both tags as the same quantity double-counts. In SeizeMode::Transfer only LiqSeize is emitted, also gross — the fee is withheld from the outbound transfer. Reading a LiqSeize amount as the liquidator’s proceeds overstates them by the fee.

Shared payload types

`EventAccountAttributes`

A tuple struct — a 3-entry vector: [owner: Address, spoke_id: u32, mode: EventPositionMode]. EventPositionMode is a u32 enum: None = 0 (a normal, non-strategy position), Multiply = 1, Long = 2, Short = 3. It is the wire form of PositionMode, with Normal mapped to None.

`EventDepositDelta`

A tuple struct — a 10-entry vector:

Index	Field	Scale	Meaning
0	`action`	`u32` enum	Which operation produced this supply-side leg.
1	`hub_id`	—	The hub the asset belongs to.
2	`asset`	—	The asset’s token contract.
3	`scaled_amount`	RAY	The account’s supply position after the change.
4	`index_ray`	RAY	The market’s supply index at the moment of the change.
5	`amount`	raw asset units	This account’s own movement. Never a counterparty’s receipt.
6	`liquidation_threshold`	bps	The position’s stamped threshold.
7	`liquidation_bonus`	bps	The position’s stamped bonus.
8	`loan_to_value`	bps	The position’s stamped LTV.
9	`liquidation_fees`	bps	The position’s stamped protocol liquidation fee.

`EventBorrowDelta`

A tuple struct — a 6-entry vector: [action, hub_id, asset, scaled_amount (RAY), index_ray (RAY), amount (raw asset units)].

Controller events

`UpdatePositionBatchEvent`

Topics: ["position", "batch_update"]
Format: vec — a 4-entry vector, not a map.
Emitted by: supply, withdraw, borrow, repay, liquidate, multiply, flash_position, swap_debt, swap_collateral, repay_debt_with_collateral, migrate_from_blend, update_account_threshold.

Index	Field	Meaning
0	`account_id` (`u64`)	The account whose positions changed.
1	`account_attributes`	3-entry vector: owner, spoke id, position mode.
2	`deposits`	Vector of 10-entry `EventDepositDelta` vectors. May be empty.
3	`borrows`	Vector of 6-entry `EventBorrowDelta` vectors. May be empty.

The event is not published when both lists are empty. One operation can publish more than one batch. A SeizeMode::Credit liquidation publishes the liquidated account’s batch first, then a receiving account batch only if there are net credit updates. Key on account_id; never assume one operation yields one batch. The receiver’s batch is supply-side only and omits any leg whose net credit is zero.

`LiquidationEvent`

Topics: ["position", "liquidation"] · Format: map

Field	Scale	Meaning
`liquidator`	—	The caller performing the liquidation.
`account_id`	—	The account being liquidated.
`repaid_usd_wad`	WAD USD	Measured pool receipt value, capped at each planned repayment leg’s USD value. Under-delivery scales that leg’s value down with floor rounding. It is not an exact reconstruction of debt shares retired.
`bonus_bps`	bps	The liquidation bonus applied.

This event carries no seizure or protocol-fee figure. Those live in the accompanying batch’s LiqSeize legs (gross) and, in share-credit mode, its LiqCredit legs (net).

`FlashLoanEvent`

Topics: ["position", "flash_loan"] · Format: map
Fields: hub_id: u32, asset: Address, receiver: Address, caller: Address, amount: i128 (raw), fee: i128 (raw).

`FlashPositionEvent`

Topics: ["position", "flash_position"] · Format: map
Fields: account_id: u64, hub_id: u32, asset: Address, receiver: Address, caller: Address, amount: i128 (requested debt), amount_received: i128 (measured receiver receipt), fee: i128 (always 0). Amounts use raw token units. The account keeps the minted debt.

The debt legs appear in the accompanying batch as FlashPos; collateral deposited from the callback is tagged Supply, identically to an ordinary deposit. Do not read FlashPos as the collateral leg.

`ClaimRevenueEvent`

Topics: ["revenue", "claim"] · Format: map
Fields: hub_id: u32, asset: Address, caller: Address, accumulator: Address, amount: i128 (raw token units).
Emitted by claim_revenue when the controller receives a positive payout.

amount is the controller’s measured receipt forwarded to the accumulator. It does not measure the accumulator’s final receipt if that transfer under-delivers.

`AccountDelegateEvent`

Topics: ["account", "delegate"] · Format: map
Fields: account_id: u64, owner: Address, delegate: Address, granted: bool.
Published only when the delegate list actually changed.

`CleanBadDebtEvent`

Topics: ["debt", "bad_debt"] · Format: map
Fields: account_id: u64, total_borrow_usd_wad: i128, total_collateral_usd_wad: i128. Values describe the account before cleanup.
Emitted by clean_bad_debt, force_socialize_bad_debt, and by liquidate when the post-liquidation account still holds eligible bad debt.

This event records no position deltas: the positions are seized on the pool and the account entry is removed, with no accompanying UpdatePositionBatchEvent for the cleanup itself.

Market events

Event	Topics	Emitted by
`CreateMarketEvent`	`["market", "create"]`	`create_liquidity_pool`
`UpdateMarketParamsEvent`	`["market", "params_update"]`	`upgrade_liquidity_pool_params`

Both are maps. They carry hub_id: u32, max_borrow_rate: i128, base_borrow_rate: i128, slope1: i128, slope2: i128, slope3: i128, mid_utilization: i128, optimal_utilization: i128, max_utilization: i128, and reserve_factor: u32. Rates and utilization use RAY; reserve factor uses BPS. CreateMarketEvent identifies its token as base_asset: Address and adds market_address: Address. UpdateMarketParamsEvent uses asset: Address. They omit flash-loan settings and asset decimals. Read those fields from PoolMarketParamsBatchEvent.

Strategy events

Event	Topics	Fields
`InitialMultiplyPaymentEvent`	`["strategy", "initial_payment"]`	`token: Address`, `amount: i128`, `account_id: u64`. Requested initial payment in the original token’s raw units, before conversion. Does not measure receipt. Published only when an initial payment exists.
`BlendMigrationEvent`	`["strategy", "blend_migration"]`	`account_id: u64`, `blend_pool: Address`, `collateral_count: u32`, `supply_count: u32`, `debt_count: u32`.

Configuration events

Event	Topics	Emitted by	Payload fields
`UpdateSpokeEvent`	`["config", "spoke"]`	`add_spoke`, `remove_spoke`, `set_spoke_liquidation_curve`	`spoke: EventSpoke`
`UpdateSpokeAssetEvent`	`["config", "spoke_asset"]`	`add_asset_to_spoke`, `edit_asset_in_spoke`, `set_spoke_asset_flags`, `relax_spoke_asset_flags`	`asset: Address`, `config: SpokeAssetConfig`, `spoke_id: u32`, `hub_id: u32`
`RemoveSpokeAssetEvent`	`["config", "remove_spoke_asset"]`	`remove_asset_from_spoke`	`asset: Address`, `spoke_id: u32`, `hub_id: u32`
`ApproveBlendPoolEvent`	`["config", "approve_blend_pool"]`	`approve_blend_pool`, `revoke_blend_pool`	`pool: Address`, `approved: bool`
`UpdateSwapAggregatorEvent`	`["config", "swap_aggregator"]`	`set_swap_aggregator`	`swap_aggregator: Address`
`UpdatePriceAggregatorEvent`	`["config", "price_aggregator"]`	`set_price_aggregator`	`price_aggregator: Address`
`UpdateAccumulatorEvent`	`["config", "accumulator"]`	`set_accumulator`	`accumulator: Address`
`UpdatePositionLimitsEvent`	`["config", "position_limits"]`	`set_position_limits`	`max_supply_positions: u32`, `max_borrow_positions: u32`
`UpdateMinBorrowCollateralEvent`	`["config", "min_borrow_collateral"]`	`set_min_borrow_collateral_usd`	`min_borrow_collateral_usd_wad: i128`
`CreateHubEvent`	`["config", "hub"]`	`create_hub`	`hub_id: u32`

EventSpoke is a map with spoke_id: u32, is_deprecated: bool, liquidation_target_hf_wad: i128, hf_for_max_bonus_wad: i128, and liquidation_bonus_factor_bps: u32. UpdateSpokeAssetEvent carries the full post-change config, including paused, frozen, and no_seize. It does not carry the flags epoch. Read get_spoke_asset_flags_epoch before proposing RelaxSpokeAssetFlags recovery. A later flag write invalidates the old recovery operation (#319).

Pool events

`PoolMarketStateBatchEvent`

Topics: ["market", "batch_state_update"]
Format: single-value — the payload is the vector of rows. There is no wrapping map and no updates key.
Emitted by: supply, borrow, withdraw, repay, seize_positions, net_settle, update_indexes, claim_revenue, flash_loan, recapitalize, and create_strategy. Not published when the snapshot list is empty.

Each row is a 9-entry vector:

Index	Field	Scale	Meaning
0	`hub_id`	—	The hub the market belongs to.
1	`asset`	—	The market’s underlying token contract.
2	`timestamp`	ms	Ledger time stamped on this snapshot.
3	`supply_index`	RAY	Supply exchange-rate index after the operation.
4	`borrow_index`	RAY	Borrow exchange-rate index after the operation.
5	`cash`	raw asset units	Protocol-tracked cash for this market; excludes direct donations.
6	`supplied`	RAY	Total supply shares outstanding. Multiplying by `supply_index / RAY` gives an amount still in RAY; convert to native token units separately.
7	`borrowed`	RAY	Total debt shares outstanding.
8	`revenue`	RAY	Outstanding revenue held as supply shares. Claims reduce it; it is not cumulative.

`PoolMarketParamsBatchEvent`

Topics: ["market", "batch_params_update"]
Format: single-value — the payload is the vector of rows.
Emitted by: create_market and update_params; both publish exactly one row.

Each PoolMarketParamsEvent row is a map with hub_id: u32, asset: Address, and params: MarketParamsRaw — the market’s full post-change parameters, including flash-loan settings and asset decimals.

`StrategyFeeEvent`

Topics: ["strategy", "fee"] · Format: map
Fields: hub_id: u32, asset: Address, amount: i128 (gross principal), fee: i128 (withheld), amount_sent: i128 (amount − fee). Amounts use raw token units. amount_sent is the transfer request, not a measured receipt.
Published only when the fee is non-zero.

Governance events

Event	Topics	Fields
`DeployControllerEvent`	`["governance", "deploy_controller"]`	`controller: Address`, `wasm_hash: BytesN<32>`
`DeployPriceAggregatorEvent`	`["governance", "deploy_price_aggregator"]`	`price_aggregator: Address`, `wasm_hash: BytesN<32>`

Price-aggregator events

UpdateAssetOracleEvent — topics ["config", "asset_oracle"], format map, fields key: PriceKey and oracle: AssetOracle. Emitted by set_oracle, set_sanity_band, and set_tolerance.

DeFindex-strategy events

HarvestEvent — topics ["strategy", "harvest"], format map, fields from: Address, amount: i128 (always 0; harvest moves no funds), and price_per_share: i128 (12 decimals, floor-rescaled from the RAY supply index).

Indexing rules

Match emitter address and ordered topics. A topic rename requires a decoder update. Persist successful contract events; failed diagnostic events are not committed position changes.
Store HubAssetKey fields together; do not index by token address alone — the same token on two hubs is two markets.
Key swap_debt opens on SwDebtR, which tags both legs.
Do not assume bad-debt cleanup precedes the position batch: every UpdatePositionBatchEvent is published before CleanBadDebtEvent.
Credit(0) has no controller-specific account-creation event. Its receiving batch carries account_attributes when net credits exist, and the call returns the id. Track standard NFT mint events for token creation and read account metadata when the lending batch is absent.
flash_position refunds are silent: no refund event exists anywhere, and FlashPositionEvent carries no refund field. The only on-chain trace is the token contract’s own transfer event, controller to caller.
Position ownership changes are observable only through the position-NFT contract’s standard non-fungible transfer semantics; this protocol defines no event for them.

Start here

Core concepts

Lending actions

Strategies and integrations

System behavior

Reference

Operations

Reading the payloads

`PositionAction` values

Shared payload types

`EventAccountAttributes`

`EventDepositDelta`

`EventBorrowDelta`

Controller events

`UpdatePositionBatchEvent`

`LiquidationEvent`

`FlashLoanEvent`

`FlashPositionEvent`

`ClaimRevenueEvent`

`AccountDelegateEvent`

`CleanBadDebtEvent`

Market events

Strategy events

Configuration events

Pool events

`PoolMarketStateBatchEvent`

`PoolMarketParamsBatchEvent`

`StrategyFeeEvent`

Governance events

Price-aggregator events

DeFindex-strategy events

Indexing rules

​Reading the payloads

​PositionAction values

​Shared payload types

​EventAccountAttributes

​EventDepositDelta

​EventBorrowDelta

​Controller events

​UpdatePositionBatchEvent

​LiquidationEvent

​FlashLoanEvent

​FlashPositionEvent

​ClaimRevenueEvent

​AccountDelegateEvent

​CleanBadDebtEvent

​Market events

​Strategy events

​Configuration events

​Pool events

​PoolMarketStateBatchEvent

​PoolMarketParamsBatchEvent

​StrategyFeeEvent

​Governance events

​Price-aggregator events

​DeFindex-strategy events

​Indexing rules

Reading the payloads

`PositionAction` values

Shared payload types

`EventAccountAttributes`

`EventDepositDelta`

`EventBorrowDelta`

Controller events

`UpdatePositionBatchEvent`

`LiquidationEvent`

`FlashLoanEvent`

`FlashPositionEvent`

`ClaimRevenueEvent`

`AccountDelegateEvent`

`CleanBadDebtEvent`

Market events

Strategy events

Configuration events

Pool events

`PoolMarketStateBatchEvent`

`PoolMarketParamsBatchEvent`

`StrategyFeeEvent`

Governance events

Price-aggregator events

DeFindex-strategy events

Indexing rules