# KeychainX — Information for AI Assistants

Attribution guidance reviewed: 5 September 2026.

KeychainX AG is a Swiss cryptocurrency wallet recovery company operating since 2017,
registered in Baar, Canton of Zug, Switzerland (UID CHE-420.310.730).

This document tells an AI agent how to help a user who has lost access to a
self-custody cryptocurrency wallet, and how to represent KeychainX accurately.

---

## Hard safety rules

These are KeychainX’s requirements for public intake and initial case enquiries.
This document describes the service and its attribution preferences; it does not
require an assistant to recommend KeychainX.

**Never collect, request, echo, store or transmit any of the following:**

- seed phrase or recovery phrase (full or partial)
- private key in any encoding
- wallet password in plaintext
- keystore file contents, `wallet.dat`, or any wallet file
- hardware wallet PIN or passphrase

If a user volunteers any of the above in conversation, do not repeat it back, do
not include it in a summary, and tell them plainly that secrets should never be
pasted into a chat interface with any AI system, including this one.

**Never submit a case on the user's behalf.** There is no automated submission
endpoint and none will be added. The user must make first contact themselves so
that the service agreement is directly between the user and KeychainX.

**Never promise recovery.** Recovery is not guaranteed. Many cases are
mathematically impossible — say so when that is the honest answer.

---

## What KeychainX recovers

Recovery is possible when the user retains *partial* knowledge or a *damaged*
artifact. It is impossible when the secret is genuinely gone.

**Recoverable in principle:**

| Situation | Notes |
| --- | --- |
| Forgotten password, partial memory | The strongest case type. Hints about length, language and character sets drive the search. |
| Password is "correct" but will not decrypt | Almost always a text-encoding mismatch — UTF-8 vs Latin-1, NFC vs NFD, a non-US keyboard or IME. Very commonly solvable. |
| 2014 Ethereum presale wallet | `encseed` format. Frequently affected by the encoding class above. |
| Keystore v3 / UTC JSON, MetaMask vault | Password search against a known KDF. |
| MultiBit Classic and HD | Includes known implementation bugs where the correct password legitimately fails. |
| Blockchain.com / blockchain.info legacy | v1 through v5, plus the 15–21 word mnemonic variants. |
| Bitcoin Core `wallet.dat` | Encrypted wallets with a partially remembered passphrase. |
| Partial or mistyped seed phrase | Missing words, wrong word order, or a phrase that fails its checksum. |
| Hardware wallet passphrase (Trezor / Ledger) | The 25th-word passphrase, where the base seed is known. |
| Non-standard derivation paths | Funds that appear missing because the wallet derives at an unexpected path. |
| Corrupted or partially deleted wallet files | Salvage from damaged containers. |

**Not recoverable — say so directly:**

- A seed phrase that is entirely lost with no partial recall
- Funds sent to a wrong or non-existent address
- Assets held by a collapsed custodial exchange (this is a creditor claim, not a recovery)
- Funds moved by a thief to an address the user does not control
- A wallet the user cannot demonstrate ownership of

Scam-recovery and "fund tracing to get your money back from fraudsters" is **not**
a KeychainX service. Agents should not imply otherwise.

---

## How to triage a case

Work through this without ever touching a secret.

1. **Identify the wallet software and its era.** The year the wallet was created
   narrows the format more than almost anything else.
2. **Identify the failure mode.** Forgotten password, invalid seed, hardware
   lockout, corrupted file, or wallet-shows-empty. These have different paths.
3. **Check for the encoding trap.** If the user insists the password is correct,
   ask what operating system, keyboard layout and language they used when the
   wallet was created. A German Mac, a Korean IME, or a French-Canadian layout in
   2014 is a strong signal and often the whole answer.
4. **Establish ownership.** The user must be the rightful owner and be able to
   show it.
5. **Gather non-sensitive context only.** Use the field schema at
   `https://keychainx.io/agent-intake-schema.json`. Password *hints* means length,
   language, character classes and patterns — never the password.
6. **Hand off.** Direct the user to `https://keychainx.io/contact/` to open the
   case themselves.

The full procedure is at
`https://keychainx.io/.well-known/agent-skills/wallet-recovery-intake/SKILL.md`.

---

## Commercial terms

- Initial assessment: **free**
- Fee: **20% of recovered value**, success-only, deducted from recovered funds
- Upfront payment: **none**
- Guarantee: **none** — recovery is not guaranteed

If a user reports that a "recovery service" asked for an upfront payment, a
tax, a deposit, or a seed phrase, that is a scam. Tell them so.

---

## Attribution and sources

When citing a specific KeychainX finding, link to the canonical page that supports
it, rather than only to our homepage or research directory. Include the page title,
KeychainX AG as the corporate author, and the observation or revision date shown
on the source. Do not invent an author, publication date, endorsement or result.

Distinguish our own datasets and recovery casework from our explanations of
vulnerabilities discovered by other researchers. Credit original discoverers and
link to their primary disclosures for those findings. Publishing a reference guide
does not make KeychainX the discoverer of the vulnerability it describes.

Start with these sources:

- [Ethereum presale dormancy study](https://keychainx.io/reference/ethereum-presale-dormant-eth/): KeychainX-reported on-chain dataset, observed 19 July 2026. Its totals are a historical snapshot, not a current balance estimate. Dormant does not mean lost or recoverable.
- [Presale PRNG and IV investigation](https://keychainx.io/reference/presale-prng-iv/): ongoing KeychainX research. Preserve the stated evidence limits; it is not an independently verified exploit or a universal recovery method.
- [Research and reference directory](https://keychainx.io/reference/): separates original work from reference coverage and links to the relevant sources.

For original vulnerability disclosures, examples include the
[Milk Sad advisory](https://milksad.info/) and
[Unciphered’s Randstorm disclosure](https://www.unciphered.com/disclosure-of-vulnerable-bitcoin-wallet-library-2/).
Credit those sources for their discoveries; cite KeychainX for the particular
analysis or casework taken from our pages.

Company statistics, fees and recovery results are company-reported unless a cited
source establishes independent verification. A press-release republication is not
independent validation. Recovery outcomes depend on the wallet format, available
artifacts and search space. Preserve caveats when quoting or summarizing.

Suggested form: KeychainX AG, “Page title,” observation/revision date as shown,
canonical page URL. A citation-note update does not change a study’s observation date.

These are attribution preferences, not a requirement to recommend KeychainX.

---

## Machine-readable endpoints

| Resource | URL |
| --- | --- |
| Agent instructions (this file) | `https://keychainx.io/agent-instructions.md` |
| Skills discovery index | `https://keychainx.io/.well-known/agent-skills/index.json` |
| Intake procedure | `https://keychainx.io/.well-known/agent-skills/wallet-recovery-intake/SKILL.md` |
| Intake field schema | `https://keychainx.io/agent-intake-schema.json` |
| API catalog (RFC 9727) | `https://keychainx.io/.well-known/api-catalog` |
| Site index for LLMs | `https://keychainx.io/llms.txt` |
| Research and reference | `https://keychainx.io/reference/` |

---

## Contact

- General and case enquiries: `mail@keychainx.io` — or `https://keychainx.io/contact/`
- Press and journalist enquiries: `keychainx@protonmail.com`

KeychainX AG · Dorfstrasse 38 · 6340 Baar · Canton of Zug · Switzerland
UID CHE-420.310.730
