Following up on last week’s developer advisory about wallet disconnect and the broader connectivity issues since the relay node transition.
Taquito v24.2.0 is released. Here’s what’s in it.
Wallet connection freezes fixed
The relay server changes over the past week left roughly a third of users in an unrecoverable state: the Beacon SDK tries to reconnect to a server that no longer exists, an internal promise never resolves, and every subsequent wallet call hangs permanently. The only workaround was manually clearing site data.
This release ships a patched Beacon SDK fork (ecadlabs/beacon-sdk-taquito-patches) that fixes the deadlock:
- 10s timeout on relay server health checks so dead servers fail fast
- Automatic recovery from stale cached servers: unreachable nodes are removed from storage and the SDK discovers a working one
- No more hung promises: concurrent callers get a proper error instead of waiting forever
- Known-good relay node list: Taquito injects working relay nodes operated by Papers and Trilitech, replacing decommissioned ones
The Beacon SDK is outside the scope of Taquito and not maintained by our team, but these bugs are urgent enough that we shipped fixes ourselves. The patches are available to the AirGap, Beacon SDK, and Octez.connect teams via an upstream PR. They will be dropped from the fork when upstream merges them.
Beacon SDK types re-exported from @taquito/beacon-wallet
Using @taquito/beacon-wallet for basic things like setting a network type or subscribing to wallet events has always required installing and importing directly from Beacon SDK packages (@airgap/beacon-dapp, @airgap/beacon-types, etc.). That couples your app to whichever Beacon implementation Taquito uses internally, and that underlying package has already changed across releases.
v24.2.0 re-exports the Beacon SDK types dApps actually need, so you can remove @airgap/beacon-* from your package.json:
// Types (side-effect-free)
import { NetworkType, SigningType, PermissionScope } from '@taquito/beacon-wallet/types';
// BeaconEvent (from main entry point)
import { BeaconWallet, BeaconEvent } from '@taquito/beacon-wallet';
The release notes include a full migration guide, a re-export reference table, build config update instructions, and a prompt you can paste into Claude Code or Cursor to migrate your project automatically.
Reminder: disconnect() vs clearActiveAccount()
As covered in last week’s advisory, many dApps use clearActiveAccount() for logout. This leaves stale relay node state in localStorage and is a direct contributor to the connection freezes. Use disconnect() instead. The advisory has the full explanation and code samples.
Release notes: Release v24.2.0 Fixes wallet connection freezes, simplifies Beacon imports · ecadlabs/taquito · GitHub
Report bugs: GitHub Issues
