refactor(filler): read SHIP through @atomichub/antelope-ship-utils

[robrigo]

Why

The filler carried its own SHIP reader, a copy of the client the AtomicHub fillers run from a shared package, and the two drifted: this side gained ack backpressure and get_blocks_result_v2 handling, the other side gained a heartbeat, reconnect backoff and recovery from empty payloads, and each fix had to be ported by hand. The shared client is now published as @atomichub/antelope-ship-utils (repository atomicassets/antelope-ship-utils) with both fix sets, and the filler adopts it through the receiver: StateReceiver implements the package's consumer interface, the prefetch-versus-confirmation guard runs before the connection is built, and the package's events feed winston. The in-tree reader, its deserializer worker and the direct ws and node-worker-threads-pool dependencies go; the handler files keep their block-shape types through a re-export.

Runtime changes an operator sees are listed under ## [2.2.0] ### Upgrading in CHANGELOG.md: heartbeat and idle timeout active, reconnect backoff 5 s to 60 s, empty-payload escalation, and a prepare-path failure now exits the process instead of pausing until the stall watchdog fires.

Validation

pnpm run check-types and pnpm run lint green; the handler files are untouched, which is the proof that the type re-export keeps their surface. pnpm test: 349 passing and 37 pending on this branch against 341 passing and 37 pending on main (measured in a scratch worktree of main); the delta is ten new adapter tests minus two relocated deadlock-guard tests, none weakened. The integration suite needs Postgres and was not run locally; CI runs it. pnpm knip carries the pre-existing red baseline (two re-exported types now count as unused exports). This change goes out as 2.2.0-rc1 first and soaks on the testnet fillers before a stable tag, per RELEASING.md.

[Copilot]

Pull request overview

This PR refactors the filler’s SHIP integration by removing the in-repo State History websocket reader and adopting the shared @atomichub/antelope-ship-utils client, aligning behavior with the upstream fillers (heartbeat, reconnect backoff, empty-payload recovery) while keeping the existing handler-facing block/trace/delta type surface via re-exports.

Changes:

• Replace the in-tree SHIP reader with @atomichub/antelope-ship-utils and adapt StateReceiver to the package’s consumer interface.
• Remove the deserializer worker and the legacy SHIP reader implementation (and corresponding direct dependencies).
• Update queue reporting, tests, and changelog/docs to reflect the new connection behavior and upgrade notes.

Reviewed changes

Copilot reviewed 12 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/workers/deserializer.ts	Deletes the dedicated deserialization worker now handled by the shared package.
src/types/ship.ts	Re-exports SHIP block-shape types from the shared package while preserving wider generics used by handlers.
src/filler/receiver.ts	Adapts StateReceiver to IShipConsumer, wires package events to winston, moves deadlock guard pre-connection, and delegates connection lifecycle to the package.
src/filler/receiver.test.ts	Updates unit tests to call consume() directly and removes legacy startProcessing ack-guard tests that no longer match the new integration point.
src/filler/receiver-adapter.test.ts	Adds focused tests validating the consumer/connection handover, guard behavior, event forwarding, and stop behavior.
src/filler/filler.ts	Updates queue state logging to use the new connection queue size accessor.
src/connections/ship.ts	Removes the legacy in-tree SHIP websocket reader implementation.
src/connections/manager.ts	Replaces createShipBlockReader with createShipConnection constructing the package connection.
src/bin/ship.ts	Removes the legacy standalone SHIP test/debug entrypoint.
pnpm-workspace.yaml	Excludes the new first-party package from minimum-release-age gating.
pnpm-lock.yaml	Locks @atomichub/antelope-ship-utils@1.0.0 and its transitive dependencies.
package.json	Adds @atomichub/antelope-ship-utils and drops direct ws / node-worker-threads-pool deps.
knip.json	Removes workers from knip entrypoints (worker file deleted).
CHANGELOG.md	Documents operational changes and upgrade guidance for 2.2.0.

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.