Skip to content
Dark MatterDark Matter
EnergyConcepts

AllocationPlan

L1 aggregation primitive: non-binding multi-slot match proposal for a demand spec.

AllocationPlan is the planner output for multi-slot procurement. It does not commit ownership or issue encumbrances; it packages candidate components and a compatibility posture so an operator can decide whether to move to a signed pool.

Core fields

  • solver_strategy: greedy_score, homogeneous_jurisdiction, or homogeneous_carbon_class.
  • components[]: each component includes slot_id, owner_participant_id, allocated_mw, slot_stage_gate, and a full per-component Verdict.
  • aggregate_mw: total planned MW across components.
  • regulatory_compatibility: homogeneity flags for jurisdiction, carbon class, and RIGI posture, plus conflict details.
  • binding: always false.

API

  • POST /v1/energy/demand/{demand_id}/allocation-plan

Optional body:

{
  "solver_strategy": "greedy_score",
  "max_components": 4,
  "tenantOfacScreenedAt": "2026-04-30",
  "estimatedProjectValueUsd": 800000000
}

Next step

Promote a plan to a CapacityPool once owners and terms are agreed.

Edit this page on GitHub

Last reviewed: May 6, 2026

Was this page helpful?