Skip to content
Dark MatterDark Matter
EnergyConcepts

Pool tranches

L3 aggregation primitive: seniority layers and deterministic waterfall execution for a capacity pool.

PoolTranche overlays payment priority on top of a CapacityPool. This enables one physical pool to carry different economic seniority slices.

Tranche fields

  • seniority and payment_priority_rank define ordering.
  • notional_mw_share and mw_share_pct define target share.
  • default_treatment defines shortfall behavior (absorb_shortfall_first, pari_passu, subordinated_pik).
  • optional cap_usd_per_period limits period allocation.

Waterfall execution

distributePoolWaterfall is deterministic:

  1. sort by payment_priority_rank, then seniority
  2. compute target allocation from mw_share_pct and caps
  3. allocate from available_usd
  4. record tranche shortfall and residual

The API endpoint POST /v1/energy/pools/{pool_id}/waterfall records PoolWaterfallExecution.

API

  • POST /v1/energy/pools/{pool_id}/tranches
  • POST /v1/energy/pools/{pool_id}/waterfall
Edit this page on GitHub

Last reviewed: May 6, 2026

Was this page helpful?

CapacityPool

L2 aggregation primitive: persistent multi-owner pool with signed governance, exit terms, and operating posture.

DemandSpec

Structured capacity request. A buyer specifies requirements — capacity, jurisdiction, latency, chip class, compliance — and the rights engine matches against ComputeSlot inventory.

On this page

Tranche fieldsWaterfall executionAPI