Troubleshooting
The app says exact sealed-bag freight is paused
Symptoms: A banner mentions world-contracts or exact sealed-bag freight is paused, but you can still browse Shop, Cargo Well, and haul forms.
What to know:
- Collateralized haul (bond + matching type/qty from stock) is usually still available—use Create shipping job / Create a collateralized haul from the banner.
- Exact sealed-bag freight (one specific item object) and some legacy shop flows may stay paused until EVE Frontier ships cross-SSU re-parenting support.
- Nothing is on-chain until your wallet signs and confirms a transaction.
Pickup is disabled or “Approve haul pickup” blocks the courier
Symptoms: Execute pickup is greyed out, or pickup transactions revert with pickup-not-approved errors.
What to try:
- The pickup SSU owner (often the seller) must run Approve haul pickup on the job card first, with the correct OwnerCap object id.
- Partner listings and shop asks do not auto-approve— the seller still signs approve for their SSU.
- Confirm Pelusium is authorized on the pickup SSU — SSU & Pelusium setup.
- The courier must have accepted the job before execute pickup (approve alone is not enough).
Pickup or delivery fails (other causes)
Symptoms: Pickup or deliver reverts or errors even though the job looks right in the UI.
What to try:
- Complete SSU & Pelusium setup on both pickup and drop-off SSUs.
- Double-check SSU IDs in the job match the units you authorized.
- Confirm the courier wallet matches the job and you use the correct freighter character id.
- For haul jobs, confirm pickup approved is true on-chain before pickup.
Wallet and network
Symptoms: Transactions fail right away, your wallet shows the wrong chain, or explorers do not match what you expect.
What to try:
- In your Sui wallet, switch to the same network the Pelusium site is using.
- Disconnect and reconnect the wallet, then repeat the action.
- If you use several wallets, confirm you are in the account that owns the SSU, accepted the job, or is the designated seller.
Shop or Cargo Well looks empty or stuck
What to try:
- Refresh the page and wait a few seconds—lists load from live data.
- Try another browser or turn off aggressive ad / privacy extensions that block scripts.
- Confirm you are on the correct network (same as above).
- Partner rows only appear after a partner app publishes listings—you may see an empty book on a quiet testnet.
Route planner is not routing
Symptoms: The map loads but Build route is unavailable, a system name is not found, or the route card says routing is unavailable.
What to try:
- Wait a few seconds and refresh; the planner loads a large system catalog before routing.
- Choose systems from suggestions when possible so spelling matches the catalog.
- If the page shows a showcase fallback, route building may be unavailable until the live catalog connects.
- If you use Manual jump radius, ensure Use manual jump radius is checked.
Transactions: how to dig a little deeper
- Open the transaction digest in a Sui explorer (e.g. Suiscan) on the right network to see the exact error.
- If the app offers preview or simulate before signing, use it to catch issues early.
Still stuck
- Re-read Shipping, Shop & Cargo Well, and SSU & Pelusium setup.
- Check FAQ for payout and partner-listing questions.
- If something still fails after the steps above, use the official support or community channel for your Pelusium deployment.