Part of the CustodyStress archive of observed Bitcoin custody incidents

Browse archive Archive statistics Scenarios Dependencies About

CS-00737

Armory Wallet Passphrase Loss: 2 BTC, Recovery Script Dependencies Unresolved

Indeterminate

Wallet passphrase was unavailable — whether access was ultimately recovered is not known.

Case description

In January 2025, a BitcoinTalk forum user identified as Ronnie666 disclosed possession of an encrypted Armory .wallet file containing 2 BTC, estimated then at $50,000–$75,000 USD. The user had forgotten the encryption passphrase and sought recovery guidance. Armory moderator and developer goatpig confirmed that passphrase cracking would be extremely difficult without partial recall of the original passphrase, and recommended two paths: engaging professional wallet recovery services (which typically charge fees scaled to the asset value) or self-directed recovery using community-maintained tools.

Goatpig directed the user to PassPhraseFinderPlugin.py, a brute-force script available in the Armory repository. On January 17, 2025, the user reported downloading the script but encountered import errors related to PyQt4 dependencies when attempting to run it on Debian 11. Multiple troubleshooting attempts failed to resolve the dependency chain.

Goatpig then offered findpass.py, a command-line alternative designed to operate without GUI dependencies and thus avoid the PyQt4 requirement. The forum thread does not document whether the user successfully executed either script or ultimately regained wallet access. This case exemplifies a custody failure pattern distinct from permanent loss: the encrypted wallet file remained accessible, the user possessed legitimate ownership claims, and community developers had provided functional recovery tools.

However, the technical skill required to resolve Linux package dependencies and execute brute-force recovery code, combined with the economic barrier of commercial recovery services, created a practical access barrier. The incident reflects infrastructure limitations of desktop wallet ecosystems circa 2025.

Custody context

Stress condition	Passphrase unavailable
Custody system	Software wallet
Outcome	Indeterminate
Documentation	Partial
Year observed	2025
Country	unknown

Structural dependencies observed

What this illustrates

The seed phrase was there, but the passphrase that unlocked it was gone. Both are required. A software wallet stores keys on the device — whether a phone or computer. When the device is lost or the application is uninstalled, access depends entirely on whether a seed phrase was recorded and stored independently. There were some notes, but not enough to actually complete the recovery. Partial documentation creates a false sense of preparedness — enough detail to indicate a path exists, but not enough to follow it through. Only one person knew how the setup worked — and that person wasn't available. An indeterminate outcome reflects the limits of available information. Whether anyone eventually gained access is not documented in the sources reviewed.

Why this matters

Why passphrases fail years after they are set

A passphrase adds a second layer of security to a Bitcoin wallet: the seed phrase opens one wallet; the seed phrase plus the passphrase opens a different one. This structure is effective at protecting against seed phrase theft. It is poorly designed for long-term memory reliability.

The failure mode documented consistently across observed cases is temporal: the passphrase is set with confidence, not used for an extended period, and then cannot be reproduced exactly when needed. A single character difference — different capitalization, an added space, a slightly different special character — produces a different wallet with a zero balance. The holder may be certain they remember the passphrase while being unable to produce the exact string that was originally set.

What makes this particularly difficult is that there is no signal at the moment of failure. A wrong passphrase does not produce an error message. It opens an empty wallet. The holder sees a zero balance and typically concludes the passphrase was wrong — but without knowing which part was wrong, or by how much.

Professional passphrase recovery services can attempt permutations when the holder has partial information: they remember the general structure, typical patterns they use for passwords, the approximate length, or that it included a specific word. Recovery from total non-recollection is not feasible.

How this category of failure is typically preventable

The preventive action is to store a passphrase record — not with the seed phrase, which would defeat its security purpose, but in a separate secure location accessible to the holder and potentially a designated recovery person. A passphrase that exists only in memory has a time horizon: it will eventually be forgotten, and the timing is unpredictable.

Frequently asked questions

Can a forgotten Bitcoin wallet passphrase be recovered?

In most cases, no. A wallet passphrase is not stored on the device, the network, or any recoverable system. It exists only in the holder's memory. If forgotten, there is no reset mechanism and no institution that can retrieve it. Some professional recovery services attempt passphrase variations for holders who remember partial information — but this is only feasible if the original passphrase had a recognizable pattern.

Is a Bitcoin passphrase the same as the seed phrase?

No. A passphrase is an additional secret layered on top of the seed phrase. The seed phrase alone generates one wallet; the seed phrase plus a specific passphrase generates a different wallet. Both are required for access. Losing the passphrase while retaining the seed phrase still blocks access — the seed alone will open an empty wallet, not the funded one.

Why do Bitcoin passphrases get forgotten even when the owner remembers setting one?

Passphrases are often set once during wallet setup and then not used again for months or years. Memory of infrequently used information degrades over time, and even small deviations — different capitalization, added space, slightly different word order — produce a completely different wallet with a zero balance. The holder may recall setting a passphrase clearly while being unable to reproduce the exact characters required.

Source

Publicly Reported

Evidence link

https://bitcointalk.org/index.php?topic=5526424.0

Most structurally similar case

Forgotten wallet.dat Password Blocks Access to Early Bitcoin Holdings

Passphrase unavailable · Software wallet · 2026 Indeterminate

Related cases

Structural patterns in this case

Forgotten passphrase

226 cases involve passphrase unavailable 455 cases involve software wallet View archive statistics →

This archive documents observed custody survivability failures. It does not attempt to document all Bitcoin losses or security incidents. Submit a case

← All cases

Framework references

Where Bitcoin Custody Intersects Legal and Fiduciary Authority

Where custody creates gaps in estate planning, fiduciary duty, and professional responsibility.

Professional Scope Boundary Matrix

What each professional or product covers, what they do not, and where gaps form between them.

The Independent Assessment Layer in Bitcoin Custody

How independent diagnostic layers emerge when multiple parties depend on shared infrastructure.

This archive documents cases where a legitimate owner, heir, or authorized party encountered barriers accessing or recovering Bitcoin due to a failure in the custody arrangement. The central question for inclusion is: did the custody structure fail a legitimate access or recovery attempt?

A case must satisfy all three of the following to be included:

Legitimate access attempt. The person attempting to access or recover the Bitcoin was the owner, a designated heir, an executor, a legal authority, or another party with a legitimate claim — not a thief, attacker, or unauthorized third party.
Custody structure failure. The failure was caused by a property of the custody arrangement — missing credentials, structural dependencies, documentation gaps, knowledge concentration, legal barriers, or institutional constraints — not market conditions, individual-level fraud or theft, or protocol-level issues. Platform-level failures that block legitimate user access are in scope regardless of their cause.
Documentable outcome or access constraint. The case must have a stated or inferable outcome: access blocked, access constrained, access delayed, or access eventually achieved through a recovery path. Cases with entirely unknown outcomes are included only where the structural failure is documented and the constraint is unambiguous.

Owner death or incapacity — Bitcoin held in self-custody that becomes inaccessible to heirs or designated parties because credentials, documentation, or operational knowledge were not transferred
Passphrase loss — BIP39 passphrase forgotten or unavailable, blocking access to a funded wallet even where the seed phrase is present
Seed phrase or wallet backup unavailable — no independent recovery path existed or the backup was destroyed, lost, or never created
Device loss without independent backup — hardware wallet, phone, or computer lost or destroyed with no recovery path outside the device
Documentation absent or ambiguous — heirs or executors cannot determine that Bitcoin exists, which wallet holds it, or how to access it
Knowledge concentration — only one person knew the procedure, passphrase, or access method; that person is dead, incapacitated, or unreachable
Multisig quorum failure — a threshold signature arrangement cannot be completed because signers are unavailable, uncooperative, incapacitated, or have lost their keys
Legal authority / access mismatch — a court order, probate ruling, or power of attorney establishes legal entitlement but provides no technical path to access
Institutional custody barrier — exchange or platform hacks, insolvency, regulatory seizure, or operational failure that caused a access constraint or failure for legitimate users, whether temporary, prolonged, or permanent. The failure of the custodian to remain available or solvent is itself the in-scope event.
Forced relocation or geographic constraint — physical access to a device or location required for recovery is blocked by displacement, border restrictions, or political circumstances
Coercion — the holder was compelled under threat to transfer Bitcoin or disclose credentials during an access event
Hidden asset discovery — heirs or executors locate a wallet or account but cannot access it due to missing credentials or operational knowledge

Market losses, investment losses, yield scheme losses, or Ponzi scheme losses
Hacks or theft targeting an individual's personal security (phishing, SIM swap, social engineering, malware) where the custody architecture itself did not fail
Unauthorized transfers where the holder's custody system was not the cause of the failure
Ordinary transaction mistakes — wrong-address sends, fee errors, mistaken amounts
Protocol-level failures — cryptographic vulnerabilities, consensus bugs, firmware integrity failures
Deliberate burns or tribute burns
Cases where the stated loss is unverifiable and no structural custody failure is described

Cases are drawn from public sources including forum posts, news reporting, court documents, academic research, and direct submissions. Each case is reviewed against the inclusion criteria above before publication. Source material is retained and available on request for documented cases.

The archive is observational and descriptive. It does not attempt to document all Bitcoin custody failures — only those meeting the criteria above with sufficient documentation to describe the structural failure and its outcome.