1. Executive Summary & Upgrade Instructions
On November 9, 2026, ECAD Labs published @ecadlabs/beacon-*@4.8.5-ecad and Taquito v25.1.1 (followed by @ecadlabs/beacon-*@4.9.0-ecad-beta.2 and Taquito v25.2.0-beta1 on our prerelease tracks) to remediate a set of protocol and session-validation vulnerabilities affecting the Beacon SDK lineage, including:
@ecadlabs/beacon-*:< 4.8.5-ecad(Fixed in4.8.5-ecad,GHSA-mv5x-v682-497f)@taquito/beacon-wallet:<= 25.1.0and25.2.0-beta0(Fixed in25.1.1and25.2.0-beta1,GHSA-vh7x-6qwm-p785)@tezos-x/octez.connect-*(trilitech/octez.connect):<= 5.0.4and all4.8.xreleases (<= 4.8.6) (5.0.5published on November 13, 2026 via port of ECAD Labs#116;4.8.xremains unpatched)@tezos-x/octez.js-dapp-wallet(trilitech/octez.js):25.0.0and25.1.0-rc.0, which pin@tezos-x/octez.connect-dapp@5.0.4(25.0.1merged intrilitech/octez.js#171on November 13, 2026 to bump to5.0.5;25.1.0-rc.0remains on5.0.4as of embargo expiration)@airgap/beacon-*(airgap-it/beacon-sdk):<= 4.8.1(Unpatched; migrate to@ecadlabs/beacon-*@4.8.5-ecad)
To give major Tezos wallets and dApps time to upgrade before opportunistic attackers noticed the fixes, we shipped v4.8.5-ecad and v25.1.1 on November 9 with understated commit messages and release notes, privately notified major ecosystem teams (including Kukai, MadFish/Temple, Objkt, Baking Bad, Tezos Domains, and Teia), and sent a formal coordinated security disclosure to Tezos Foundation Security (security@tezos.com), Nomadic Labs, and Trilitech under a 3-working-day embargo (extended by 24 hours to Friday, November 13, 2026 at 17:00 UTC).
Immediate Action for dApp and Wallet Maintainers
-
Taquito v25 users: Upgrade
@taquito/beacon-walletand companion@taquito/*packages to25.1.1:npm install @taquito/taquito@25.1.1 @taquito/beacon-wallet@25.1.1 -
Direct Beacon SDK users or older Taquito versions (
<= 24.x): Pin or override@ecadlabs/beacon-*(and any transitive@airgap/beacon-*packages) to4.8.5-ecad. -
Post-upgrade storage hygiene: Because peers injected prior to upgrading persist in browser storage, dApps or users that suspect prior compromise should clear stored Beacon state (
localStoragekeys prefixed withbeacon:) and re-pair.
2. Why This Vulnerability Came to ECAD Labs Instead of trilitech/octez.connect
These vulnerabilities were discovered, reproduced against a local Matrix Synapse and Playwright harness, and initially patched by independent open-source contributor David Kaminski (@dvkam), who has no known affiliation with ECAD Labs, Nomadic Labs, Trilitech, or Functori.
In a healthy ecosystem, an independent security researcher discovering a flaw in @tezos-x/octez.connect would report it to the funded maintainers of trilitech/octez.connect. Instead, David brought his report, reproduction harness, and patches to ECAD Labs.
The reason is straightforward, and it reflects a troubling pattern in how core Tezos developer infrastructure has been handled this year: defund the independent maintainer, fork and rebrand the repositories, fail to actively maintain the forks, and rely on unaffiliated contributors and the unfunded upstream maintainers to handle critical security engineering, QA, and ecosystem response.
- The February
octez.connectCutover: On February 20, 2026, after ECAD Labs’ Tezos Foundation grant ended, Nomadic Labs announcedoctez.connecton Tezos Agora (#6997) as the official successor to the Beacon SDK, declared to be “Maintained by Nomadic Labs, Trilitech and Functori.” That rollout was accompanied by an uncoordinated relay cutover that locked up roughly a third of active wallet sessions across the ecosystem and forced ECAD Labs to stand up@ecadlabs/beacon-*on an emergency basis just to keep Taquito dApps working. Five days later (February 25, 2026), we also had to privately disclose to Trilitech that all eightbeacon-node-{1-8}.octez.ioproduction Matrix relays were running an unpatched December 2023 build of Synapse (v1.98.0) affected by five published CVEs, includingCVE-2025-30355(exploited in the wild) and criticalCVE-2024-53863(CVSS 9.1). - Eight Months of Neglected Maintenance on
trilitech/octez.connect: My intention in standing up@ecadlabs/beacon-*was always temporary: keep Taquito users safe until the funded teams who claimed ownership ofoctez.connectstabilized their fork. Instead, as I documented on Tezos Agora on October 24 (#7217):- From April 24 through at least September 4, the private vulnerability reporting link advertised in
trilitech/octez.connect’sSECURITY.mdreturned a404because private vulnerability reporting was never enabled on the repository (Issue #57). @tezos-x/octez.connect5.0.4(published September 2) could not even cleanly disconnect and reconnect a wallet in a single browser session.- Independent contributor
@dvkamhad to diagnose the brokenPostMessageClientESM listener lifecycle himself (Issue #62), submit the fix (PR #63, which still sits unreviewed and unmerged today), and mark the Taquito migration PR (ecadlabs/taquito#3481)[BLOCKED]. - When I asked the developer who authored every
5.0.xrelease for an update on October 20, he replied: “Please get in touch with Vincent poulian [sic]. I have moved on.”
- From April 24 through at least September 4, the private vulnerability reporting link advertised in
- The Same Pattern on
trilitech/octez.js: As documented on Agora #7211, after assuring us in February thattrilitech/octez.jswas merely a contingency plan and cutting us off from ecosystem Slack-Connect channels and theproto-ecosystemcalls over the summer, Nomadic Labs and Trilitech stood up an automated commit-harvesting pipeline (Taquito Sync Tracker #53) and acheck:rebrandlinter to striptaquitoandecadlabsstrings while harvesting the commits I write for Taquito in my spare time. Bugs discovered while testing@tezos-x/octez.json Tezos X Previewnet were cross-filed ontoecadlabs/taquitowith@tezos-x/octez.jsimports swapped to@taquito/*so we would fix them upstream for free, and then backported intooctez.jshours after we released. - How This Security Response Played Out:
- Because
trilitech/octez.connecthad left issues#57,#58,#59,#62, andPR #63unanswered for weeks and had no working track record of responsive maintenance,@dvkambrought his security findings and patches to ECAD Labs on November 2. - Over the following week, working unfunded and in our own time alongside
@dvkam, we ran multiple rounds of adversarial code review, fixed subtle reload and multi-wallet session-restoration edge cases, validated the fixes against our cross-version Matrix, WalletConnect, and Temple extension conformance suite, shipped@ecadlabs/beacon-*@4.8.5-ecadand Taquitov25.1.1on November 9, and coordinated directly with ecosystem wallet and dApp teams so they could upgrade before public disclosure. - We sent the full technical disclosure to
security@tezos.com, Nomadic Labs, and Trilitech on November 9 (and extended the embargo by 24 hours to November 13 at 17:00 UTC after re-sending a corrected PDF attachment on November 10). - Throughout the entire embargo window, we received zero direct communication from any of the named
octez.connector Nomadic Labs engineering contacts. The only replies came fromsecurity@tezos.com, which initially sent bug-bounty boilerplate and then, on November 12, asked us not to publish our advisory when the embargo expired, calling our insistence on a standard disclosure timeline “a little hostile.” - Today (November 13, ahead of the 17:00 UTC embargo),
trilitech/octez.connectmerged a port of ourecadlabs/beacon-sdk-taquito-patches#116commits (d1a927bf, referencingGHSA-58pq-q667-h23x), published@tezos-x/octez.connect-*@5.0.5to npm, and merged a25.0.1dependency bump intrilitech/octez.js#171(while25.1.0-rc.0and the@tezos-x/octez.connect-*4.8.xline remain on unpatched versions as of publication time).
- Because
Forking open-source software is a right guaranteed by open-source licenses. However, forking critical ecosystem security infrastructure, rebranding it as the official path forward, neglecting its maintenance, and relying on an unaffiliated contributor and the defunded upstream maintainer to handle vulnerability research, hardening, QA, and ecosystem response is not sustainable stewardship. The Tezos ecosystem deserves better engineering accountability than that.
3. Technical Summary of the Vulnerabilities
Confirmed Root Causes
-
Unsolicited Pairing Response Acceptance / Rogue Peer Injection (
P2PCommunicationClient&PostMessageClient)- In both
P2PCommunicationClient.listenForChannelOpening(Matrix@channel-openmessages) andPostMessageClient.listenForChannelOpening(sealed extension pairing payloads), the SDK decrypted incoming sealed boxes and immediately registered and persisted the sender as a trusted peer viaaddPeerwithout verifying whether the pairing responseidcorresponded to a live pairing request issued by the dApp. - Because a sealed box only requires the recipient’s public key, successful decryption does not authenticate the sender.
- With default browser storage, a dApp instance’s 32-byte communication public key is derived from a seed stored under
beacon:sdk-secret-seedinlocalStorageand persists across reloads. Any party that learns a dApp instance’s public key (from a previously paired wallet, an older or glimpsed QR code, or a Matrix relay server) could send a crafted@channel-openpayload at any time while the Matrix transport was running, even when no pairing modal was open, and inject an unauthorized wallet peer.
- In both
-
Unvalidated Matrix Room Invites & Pre-Authentication Routing Poisoning (
P2PCommunicationClient)P2PCommunicationClientautomatically joined any Matrix room it was invited to without verifying whether a pairing request was currently pending or whether the inviter matched an already-authenticated peer (@<hex(blake2b(peer.publicKey))>:<relay-domain>).- Furthermore,
listenForChannelOpeningandlistenForEncryptedMessagewrote room routing associations (MATRIX_PEER_ROOM_IDSinlocalStorage) and updated the peer’s relay server before authenticating the sender or payload, allowing an unauthenticated Matrix user to overwrite outbound room routing for a legitimate paired wallet.
-
Missing
senderIdBinding & Unauthenticated Session-Control Messages (DAppClient,P2PCommunicationClient,PostMessageClient)P2PCommunicationClient.isSendercheckedevent.sender.startsWith('@' + hexHash)without requiring the trailing:delimiter before the Matrix homeserver domain.- Decrypted messages in both Matrix and PostMessage clients trusted the inner JSON
message.senderIdfield without verifying thatmessage.senderId === await getSenderId(senderPublicKey), allowing a sender authenticated under one key to claim thesenderIdof another stored peer. - In
DAppClient.handleResponse,BeaconMessageType.ChangeAccountRequestlacked authorization against the currently active peer (activePeer.publicKey,activePeer.senderId, and transportOrigin),BeaconMessageType.Disconnectlacked binding to the authenticated peer whose saved records it removes, andChangeAccountRequestaccepted non-abstracted account payloads without verifying thatgetAddressFromPublicKey(account.publicKey) === account.address.
Scope & Plausible Downstream Scenarios
This issue is primarily dApp-side (the Matrix invite and routing issues also apply to wallets built on the Beacon wallet SDK, where they can misroute outbound messages). It does not expose wallet private keys or allow an attacker to forge cryptographic signatures from a user’s wallet (such as Kukai, Temple, or Umami).
If an attacker learns a target dApp instance’s persistent communication public key, the ability to remotely inject a peer and trigger unauthenticated ChangeAccountRequest or Disconnect events enables:
- Cross-Chain Bridge or Multi-Wallet Destination Swap: In a UI that connects a source-chain wallet (such as MetaMask on Etherlink) alongside a destination Tezos L1 wallet via Beacon and populates the Tezos recipient address from the active Beacon account, an unauthenticated
ChangeAccountRequestover Matrix can swap the active Tezos address (tz1...) to an attacker-controlled address before the user signs the source-chain transaction. - Session Hijacking During or After Pairing: Pre-empting or racing a pairing flow so the dApp binds to an unauthorized wallet peer and routes subsequent
requestSignPayloadorrequestOperationrequests to that peer. - Remote Session Disruption: Remotely disconnecting a user’s active dApp session (
Disconnect) or poisoningMATRIX_PEER_ROOM_IDSon demand.
4. What Was Fixed in @ecadlabs/beacon-*@4.8.5-ecad and Taquito v25.1.1
- In-Memory Pending Pairing Registry (
PendingPairingRequests): Tracks locally issued pairing request IDs (up to 32 entries, 30-minute TTL, single-useaccept/consume) and rejects unsolicited Matrix@channel-openand PostMessage pairing responses. Because browser storage cannot guarantee atomic single-use consumption across tabs, pending pairing IDs are kept in memory; reloading a page mid-handshake requires scanning a fresh QR code, while already-paired sessions restore normally. - Matrix Invite & Routing Hardening: Restricts Matrix room auto-join to active pairing windows or already-stored peers, enforces the
@<hash>:delimiter inisSender, and delaysMATRIX_PEER_ROOM_IDSand relay-server cache writes until after cryptographic and peer/pairing validation succeeds. - Authenticated Session Control (
ChangeAccountRequest&Disconnect): Verifiesmessage.senderId === await getSenderId(senderPublicKey)on decrypted messages, binds PostMessage messages to the pairedextensionId, restrictsChangeAccountRequestto the active peer (publicKey,senderId, andOrigin) while verifyinggetAddressFromPublicKey(account.publicKey) === account.address, and scopesDisconnectso a paired inactive peer can only remove its own records while only the active peer can terminate the active session. - Reload Restoration Ordering: Restores
_activePeerbefore connecting transport listeners duringDAppClientinitialization so legitimate bufferedDisconnectorChangeAccountRequestevents arriving on page reload are not dropped.
5. What’s Next: Call for Ecosystem Testers (@ecadlabs/beacon-*@4.9.0-ecad-beta.3 & Taquito v25.2.0-beta2)
While v4.8.5-ecad and Taquito v25.1.1 were kept strictly surgical so every production dApp and wallet could deploy the security fix with zero regression risk, David Kaminski (@dvkam) and ECAD Labs have also been doing deep architectural and reliability work on the next feature releases: @ecadlabs/beacon-* 4.9.0-ecad and Taquito v25.2.0.
We are currently wrapping up feedback from integrating 4.9.0-ecad-beta.2 and 25.2.0-beta1 into Kukai and our test dApp, and will soon publish @ecadlabs/beacon-*@4.9.0-ecad-beta.3 and Taquito v25.2.0-beta2.
Highlights in @ecadlabs/beacon-* 4.9.0-ecad:
- Matrix Session Lifecycle & Transport Reliability: Incorporates
@dvkam’s session-epoch lifecycle work (retiring stale callbacks and storage writes cleanly across disconnects/reconnects) alongside MatrixM_UNKNOWN_TOKENre-authentication recovery,AbortControllerrequest-cancellation fixes, Matrix room v11/v12 create-event support, per-room retained message caps (100messages), and automatic eviction of retired.papers.techrelay nodes fromlocalStorage. - dApp Observability & Typed Errors: Exposes connection and transport status,
getPendingRequests(),subscribeToMessages(),getWalletInfo(), and typedBeaconErrorsubclasses onDAppClient(and re-exported through@taquito/beacon-wallet), giving dApps full visibility into pending handshakes, late responses, and message disposition instead of silent hangs. - First-Class Wallet SDK (
@ecadlabs/beacon-wallet): Adds built-inWalletWalletConnectTransport(multi-transport Matrix + WalletConnect orchestration onWalletClient), typed request-correlated response builders (respondPermission,respondOperation,respondSignPayload,respondError), cross-tab storage synchronization (subscribeToPeers,subscribeToPermissions,subscribeToDisconnect), and V3 envelope validation. - UI & Security Hygiene: Deprecates the shared built-in default WalletConnect
projectIdin favor of dApp-ownedprojectIdregistration, allows disabling built-in toasts while keeping the pairing modal, fixes mobile viewport overflow and toast timer races, and tolerates retired testnet network types in persisted storage.
Highlights in Taquito v25.2.0:
- First-Class
@ecadlabs/beacon-*4.9.0-ecadIntegration: Exposes the new Beacon observability APIs and expanded SDK types directly on@taquito/beacon-wallet. - TZIP-16 Metadata & View Hardening: Verified IPFS gateway fallback (
#3506,#3510), always-populatedMetadataEnvelopesha256HashandintegrityCheckResult, and immutable cached Michelson view code (#3522). - Browser ESM & Michelson Fixes: Removes unguarded global
Bufferusage and legacy polyfills in browser code paths (#3512), fixesPairTokenandParameterSchema.hasAnnotationschema unwrapping (#3518), improves RPC ACL error messages on big-map value endpoints (#3523), and updates core cryptographic dependencies (@noble/curves,@noble/hashes,@scure/bip39,@stablelib/nacl,bs58check).
How You Can Help Test
Real-world wallet and dApp interoperability only stays solid when tested across diverse application stacks. Once @ecadlabs/beacon-*@4.9.0-ecad-beta.3 and Taquito v25.2.0-beta2 are tagged (or starting today with 4.9.0-ecad-beta.2 and 25.2.0-beta1 on the beta / next dist-tags), we invite dApp and wallet teams across the ecosystem to pull them into staging environments and test:
- Pairing, reload restoration, account switching, and disconnect flows across Kukai (web and iOS), Temple (extension and mobile), and Umami.
- Multi-tab session behavior and the new
DAppClient/BeaconWalletobservability hooks. - Any issues or edge cases on
ecadlabs/taquitoorecadlabs/beacon-sdk-taquito-patches.
6. Disclosure Timeline
| Date (UTC) | Event |
|---|---|
| Nov 2, 2026 | Independent contributor David Kaminski (@dvkam) privately reports the pairing and session-control vulnerabilities to ECAD Labs, including a local Synapse + Playwright reproduction harness and initial patches (0001-security.patch and 0002-reliability.patch). |
| Nov 2 - Nov 9, 2026 | ECAD Labs and @dvkam conduct multi-round adversarial review, harden reload and multi-wallet edge cases, and validate the fixes against the cross-version Matrix, WalletConnect, and Temple extension conformance suite (tests/beacon-matrix). |
| Nov 9, 2026 | ECAD Labs publishes @ecadlabs/beacon-*@4.8.5-ecad (#116) and @taquito/*@25.1.1 (#3513) with neutral commit messages and release notes, begins private outreach to major Tezos wallets and dApps (Kukai, Temple/MadFish, Objkt, Baking Bad, Tezos Domains, Teia), and sends formal disclosure to security@tezos.com, Nomadic Labs, and Trilitech. |
Nov 10, 2026 (13:05 UTC) |
Following an attachment check from security@tezos.com, ECAD Labs sends the corrected disclosure PDF (beacon-cve-disclosure-Nov9-2026.pdf). |
Nov 12, 2026 (15:14 UTC) |
With no response from the named octez.connect contacts, ECAD Labs proactively extends the embargo by 24 hours to Friday, November 13, 2026 at 17:00 UTC to provide three full working days from receipt of the corrected PDF. security@tezos.com replies asking ECAD Labs not to disclose when the embargo expires; ECAD Labs confirms the Friday 17:00 UTC deadline stands. |
Nov 13, 2026 (15:34 UTC) |
trilitech/octez.connect merges a port of ecadlabs/beacon-sdk-taquito-patches#116 (d1a927bf, referencing GHSA-58pq-q667-h23x) onto master and publishes @tezos-x/octez.connect-*@5.0.5 to npm. |
Nov 13, 2026 (17:00 UTC) |
Embargo expires. Publication of GitHub Security Advisories on ecadlabs/beacon-sdk-taquito-patches (GHSA-mv5x-v682-497f) and ecadlabs/taquito (GHSA-vh7x-6qwm-p785) and release of this public disclosure. |