feat(solana-orderbook) PR02: GET order endpoint with fill state

[squadgazzz]

Description

GET /api/v1/orders/{uid} serves one order with its fill state, mostly for the explorer. Unknown uid answers 404, a malformed one 400.

The path sits under /api/v1 so the route shapes match the EVM orderbook.

Changes

• GET /api/v1/orders/{uid}: a read joining solana.orders with solana.order_pda, plus the wire DTO with the status derivation

How to test

New unit tests and a Postgres test for the query.

[linear-code]

BE-223

[claude]

Claude finished @squadgazzz's task in 3m 37s —— View job

---

PR Review: GET order endpoint with fill state

Reviewed the endpoint, DB read, and status derivation. This is a clean, tightly-scoped PR — the status precedence (fulfilled → cancelled → expired → open) matches the EVM orderbook's derivation in orderbook/src/database/orders.rs, the >= fill check correctly handles the reclaim-after-fill case called out in the comment, and error mapping (400 / 404 / 500) is right. Wire shape (camelCase, base58 pubkeys, 0x-hex uid/appData) mirrors the EVM route.

One minor inline comment posted:

• status() fill match — the _ arm silently classifies unknown kinds as buy, and the buy-side branch is untested. See inline →

Nothing blocking. Nice work.

• Read the changed files
• Analyze DB query and status derivation
• Post inline findings
• Post summary

[github-actions]

Reminder: Please consider backward compatibility when modifying the API specification.
If breaking changes are unavoidable, ensure:

• You explicitly pointed out breaking changes.
• You communicate the changes to affected teams (at least Frontend team and SAFE team).
• You provide proper versioning and migration mechanisms.

---

Caused by:

• crates/solana-orderbook/openapi.yml

[jmg-duarte]

did you run this through one of those openapi spec validators?
the existing one would be quite a PITA to fix but we could start with this one from the get go to get higher quality specs

[squadgazzz]

Yes, swagger-cli validate plus spectral lint. Also, added to CI. Later, I'll probably add utopia to finally generate the file.