fix(positions): floor live withdrawable at 10% of open notional

[claude]

Summary

The live position recompute (ts-sdk/src/sync/positions-live.ts) computes withdrawable cash by deducting a margin requirement from perp equity. The protocol floors that margin deduction at 10% of total open notional, but the recompute deducted only the summed initial margin — so the reported withdrawable amount was too high whenever the 10% floor is the binding constraint.

Before

withdrawable = max(0, equity - Σ initial_margin)   // forced to 0 below maintenance margin

The deduction was always the summed initial margin. For higher-leverage positions, where Σ initial_margin falls below 10% of open notional, this understates the deduction and overstates withdrawable cash relative to the protocol.

After

margin_floor = max(Σ initial_margin, open_notional / 10)
withdrawable = max(0, equity - margin_floor)        // still forced to 0 below maintenance margin

Total open notional (Σ |size|·mark) is accumulated in the existing perp loop, and the deduction is floored at 10% of it, matching the protocol. Division by 10 gives 10% on the WAD-scaled integers, keeping the integer-faithful semantics of the surrounding math. When summed initial margin already exceeds 10% of notional, behavior is unchanged.

Tests

Added ts-sdk/src/sync/positions-live.test.ts with two cases:

• high leverage (IM rate below 10% of notional) → the 10% floor binds and withdrawable is reduced accordingly;
• low leverage (IM above 10% of notional) → summed IM binds and behavior is unchanged.

Typecheck, full test suite (171 tests), and build all pass.

[poszu]

The 10 is POD_CLOB__TRANSFER_MARGIN_RATIO, a per-network config knob (node/src/config.rs:1045, default 0.1) — not a protocol constant. It isn't exposed on any RPC today, so hardcoding it means the SDK silently lies on any network that tunes it. Worth exposing on the markets/config response and reading it here.

Also: node rounds this term up (withdrawal_floor uses mul_div_ceil, trading/src/perps/mod.rs:2520 — "a fractional wei of it is met rather than forgiven"), while openNotional / 10n truncates. Over-reports withdrawable by up to 1 wei, so a max withdraw at the boundary gets rejected.

[claude]

Fixed the rounding in ddf6ebd — the 10% term now rounds up (ceil(open_notional / 10)) to match the venue, so it no longer over-reports withdrawable by up to 1 wei at the boundary. Added a test where open notional isn't divisible by 10 to lock it in.

On the ratio being a per-network config value rather than a constant — agreed, and the SDK can't read the tuned value until it's exposed. Two ways to close that, and it's the team's call:

1. Expose the transfer-margin ratio on the config/markets response and read it here (needs a node/RPC change). Until then the SDK uses the 0.1 default, which only matches networks that haven't tuned it.
2. Drop the client-side recompute and read withdrawableBalance from the contract instead — always correct, at the cost of a call per update.

Left it hardcoded at the 0.1 default for now so this PR still lands as a strict improvement. Happy to do either follow-up once the team decides.

---

Generated by Claude Code