ZeqCargoOptimize

Hydrodynamics, navigation, port logistics.

• Protocol ID — zeq-cargo-optimize
• Category — Maritime
• Endpoint — POST /api/maritime/cargo
• Auth — api-key
• Rate limit — 10/min
• Version — 1.287.0
• Precision — ≤0.1% (KO42-enforced)

What it does

Container/cargo stowage optimization. Weight distribution, stability (GM), dangerous goods segregation, port rotation planning.

Signature

Request

POST /api/maritime/cargo

Param	Type	Required	Default	Description
containers	array	✓	—	[{ id, weight_kg, type, dangerous, destination }]
vesselCapacity	object	✓	—	Bay/row/tier layout.
portRotation	array	✓	—	Port call sequence.

Response

{ stowagePlan, gm_m, trim_m, dangerousSegregation, craneSequence, zeqond }

Runnable example

curl -sS -X POST \
  -H "Authorization: Bearer $ZEQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "containers": [],
  "vesselCapacity": {},
  "portRotation": []
}' \
  "https://api.zeq.dev/api/maritime/cargo"

Integrate

1. Domain solver — compose with KO42 + two additional operators from the matching family for pulse-coherent results.
2. Digital twin — pipe sensor data into this protocol every Zeqond to keep the model phase-locked with the system.
3. Alert threshold — flag results whose error_pct exceeds 0.1% as out-of-spec events for the operations layer.

Seeds

• Near — wrap /api/maritime/cargo in a language SDK so builders can call it in three lines.
• Medium — publish a reference integration demonstrating ZeqCargoOptimize alongside a real workload, with pulse-aligned metrics.
• Far — propose ZeqCargoOptimize as an open reference standard so other runtimes can implement it verbatim against the Zeq paper.

Papers

• Zeq paper — https://doi.org/10.5281/zenodo.18158152
• Framework paper — https://doi.org/10.5281/zenodo.15825138

Middleware active. Kernel on the 1.287 Hz HulyaPulse. Awaiting next Zeqond.