ch13-05 Handler 与 `map_event` 模式

先看数据问题

这一节从读模型而不是数据库表开始。围绕“Handler 与 map_event 模式”，先问交易终端、机器人或风控系统要查什么，再看 handler 和 schema 如何支撑。

源码入口

crates/indexer/src/handlers/mod.rs：事件解析、字段映射或业务流水落库入口。
crates/indexer/src/handlers/order_fill_handler.rs：事件解析、字段映射或业务流水落库入口。
crates/indexer/src/handlers/flash_loan_handler.rs：事件解析、字段映射或业务流水落库入口。
crates/schema/src/models.rs：表结构、索引、Diesel schema 或迁移约束。

关键定义

以成交事件 handler 为例：

#![allow(unused)]
fn main() {
define_handler! {
    name: OrderFillHandler,
    processor_name: "order_fill",
    event_type: OrderFilled,
    db_model: OrderFill,
    table: order_fills,
    map_event: |event, meta| OrderFill {
        event_digest: meta.event_digest(),
        digest: meta.digest(),
        sender: meta.sender(),
        checkpoint: meta.checkpoint(),
        checkpoint_timestamp_ms: meta.checkpoint_timestamp_ms(),
        pool_id: event.pool_id.to_string(),
        maker_order_id: event.maker_order_id.to_string(),
        taker_order_id: event.taker_order_id.to_string(),
        price: event.price as i64,
        base_quantity: event.base_quantity as i64,
        quote_quantity: event.quote_quantity as i64,
        onchain_timestamp: event.timestamp as i64,
    }
}
}

这段定义把 Indexer 的职责说清楚了：event_type 指链上事件，db_model 指 Rust/Diesel model，table 指 PostgreSQL 表，map_event 只做字段映射。不要在 handler 里做复杂业务聚合；K 线、用户历史、订单状态聚合应该在 Server 查询层或物化任务中完成。