Frequently asked questions
Answers here describe how Pelusium freight jobs are designed on-chain (escrow, pickup, delivery, refunds). Always check what your wallet is signing on the deployment you use.If the courier already picked up, can the buyer and seller “cancel” and does the courier still get paid?
Short answer: After pickup, there is no on-chain mutual cancel like there is before pickup. The courier is only paid from the freight escrow when delivery completes on time. If things don’t finish that way, the freight side generally goes back to the shipper (who locked the escrow), after any protocol fee—not to the courier. A bit more detail:- Mutual cancel (shipper and courier agreeing to unwind) only works while the job is still accepted but not picked up yet. Once the courier runs pickup, the job is in transit on-chain and that cancel path is not available.
- After pickup, the main outcomes are: deliver (on time → courier gets the freight payout; late → courier gets no freight payout, remainder after fee goes to the shipper), or overdue refund after the delivery deadline passes with no delivery (freight escrow refunded to the shipper after the fee—not to the courier).
- Saying “buyer and seller agree to cancel” doesn’t by itself change escrow: the shipper is who created the job and locked the freight leg; unwinding is governed by delivery, late delivery, and overdue refund rules, not a separate “everyone shook hands” button after pickup.
- Cargo is already out of the pickup storage unit on-chain after pickup—anything beyond the contract is coordination in-game or between players.
How does cargo insurance work?
You pay a premium in SUI for a policy on a freight job. If the haul fails under the policy rules, you can claim up to the insured cargo value from a shared pool funded by LPs. If the haul delivers, the premium is earned by that pool instead. Destruction claims need an oracle-signed witness; undelivered claims lean on on-chain job state. Full walkthrough with pie-chart examples: Cargo insurance.How does speculation work—and do I need reputation to bet?
Speculation is an optional side bet on a freight job: you stake SUI For (on-time delivery) or Against (late / overdue fail). When the job settles on-chain, the winning side shares the pool after a small rake. You do not need a social reputation score to participate—settlement follows the job outcome and the stakes already locked. It is separate from trusting a courier with cargo. For the full walkthrough (lifecycle, pie-chart examples, rake, claims), see Speculation pools.Where does the speculation rake go if the job fails?
Default rake is 17.5% of the gross pool (typical US straight pari-mutuel takeout). Rake is still taken when Against wins (late delivery or overdue fail), but that rake goes entirely to the protocol treasury. Courier and shipper do not receive a share of fail-side rake. On For (on-time) wins, rake is split per deployment (often treasury / courier / shipper). Details and charts: Speculation pools — How the rake is split.Does the route planner create or change a freight job?
No. The route planner is a planning tool. It can help you pick systems, compare route assumptions, and copy an ordered path, but it does not lock escrow or change job state. Use it before you create or accept a job, then confirm the real pickup SSU, drop-off SSU, cargo, payment, and timing in Shipping. More detail: Route planner.What are cargo mass and manual jump radius for?
Cargo mass (kg) is used by the route planner when calculating ship jump performance. A heavier load can change what route is realistic. Manual jump radius (LY) is an override for experiments or cases where you know the max range you want to test. It only applies when Use manual jump radius is checked; otherwise the planner uses the selected ship and fuel.This page grows over time as common questions come up. Answers stay player-first and match what your Pelusium deployment actually enforces on-chain.