[DO NOT MERGE] Spencer/sdk/3.9.6

[spencerstock]

Summary

Connection Management:

• Added WebSocket instance tracking to prevent event handling from stale connections
• Fresh WebSocket creation on reconnection instead of reusing failed instances
• Instance management to enable quicker + more reliable reconnections
• Reconnection
  • backoff (0s first attempt, then 3s delay)
  • Prevent concurrent reconnection attempts

Heartbeat Improvements:

• Fixed heartbeat timer management by properly clearing intervals on disconnect
• Added connection state check before sending heartbeats to prevent errors
• Reset lastHeartbeatResponse on disconnect to prevent false timeout detection on reconnection
• Send immediate heartbeat after connection establishment for faster connection validation

Browser Event Handling:

• Added visibility change and focus event handlers to detect when users returns to the app
• Tighten up reconnect when tab/window regains focus

How did you test your changes?

Failure 1 (before fixes)

commercefail1.mp4

Failure 2 (before fixes)

commercefail2.mp4

Success with fixes

commercesuccess1.mp4

[cb-heimdall]

🟡 Heimdall Review Status

Requirement	Status	More Info
Reviews	🟡 0/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[fan-zhang-sv]

maybe i dont fully understand the life cycle of this class, but if we are constructing new WLWS for new connection, think we are losing this object level pendingData?

[spencerstock]

The WalletLinkWebsocket is kind of a wrapper around the actual websocket

so
WalletLinkWebsocket
has a:

• websocket
• pendingData array

and only the internal websocket is reconstructed

[spencerstock]

Ty for correcting me here - there are places we re-instantiate the whole class. Discussed a path forward.

[fan-zhang-sv]

LGTM! thx Spencer for tackling this issue!