Shipping & freight jobs

How a Pelusium freight job works from post to delivery—and how it ties to EVE Frontier.

Shipping & freight jobs

A freight job is an on-chain agreement: SUI is held in escrow, a courier (or designated pilot) commits to moving cargo between two SSUs, and Pelusium moves money according to rules everyone can see.

In preview deployments, Pelusium may let you inspect the full shipping UI and complete the form, then stop at final submit/sign time. That pause means the deployment is waiting on EVE Frontier world-contract support for reliable cross-SSU delivery. Until then, use the 3D route planner and the community link shown in the app to coordinate and follow status.

The journey of one job

Typical flow:

1. Create — The shipper (often the buyer or their agent) fills the job: courier payment locked up front, optional seller payment for the goods, pickup SSU, drop-off SSU, cargo type and amount, and a delivery time window. A small protocol fee may apply when funds are released—see what the app displays for your deployment. If the app is in preview mode, this is where the pause appears before funds are locked.
2. Accept — A courier accepts the open job.
3. Pick up — In-game, cargo is collected from the pickup location; on-chain, the courier records pickup against that SSU. The SSU must allow Pelusium to do this—see SSU & Pelusium setup.
4. Deliver — Cargo arrives at the drop-off SSU; the courier completes delivery on-chain on that SSU (again, Pelusium must be authorized there).

After Deliver, escrow pays out per the contract: courier gets their leg (after any fee), seller gets goods payment if you set one, and the protocol treasury takes its configured share.

5. Consolidate (recipient / SSU owner, optional but often the real “last mile”) — If the game or explorer shows cargo in character storage instead of the SSU primary panel, use the Pelusium SSU consolidate flow (/contracts/ssu-consolidate) to move stacks into primary on the same SSU so the in-game SSU UI can see them. This is not another freight job step: it is a follow-up wallet action after delivery. Details: After delivery — SSU consolidate.

Planning the route

Before creating or accepting a job, you can use More → 3D map showcase to estimate the path between systems. The planner can use a selected ship, fuel, cargo mass, and optimization mode to draw a route and show the ordered system list.

The route planner is separate from escrow. It helps you decide whether a haul looks reasonable; the freight job still controls payment, pickup, delivery, cancellation, and refunds. See 3D route planner.

Cancellations and edge cases

Depending on job state and rules deployed for your network, you may see options such as:

• Shipper cancel while the job is still open (no courier locked in yet).
• Refund paths if a courier never delivers within the agreed time after pickup.
• Mutual cancel if both sides agree to unwind while the job is in progress.

The app only offers actions your wallet is allowed to take on that job. If something looks wrong, check Troubleshooting and your wallet network.

How this relates to the Shop

Shop listings and Cargo Well help you find a price and a counterparty. They do not replace a freight job. When you want Pelusium to hold payment until delivery, you create a job with the real SSUs and amounts.