---
id: "bip39_mnemonic"
kind: "datatype"
status: "draft"
is_pii: false
categories: ["cryptocurrency", "secrets"]
langs: ["en"]
quality: 80
url: "http://registry.apicrafter.io/datatype/bip39_mnemonic"
---

# BIP-39 mnemonic phrase (seed phrase) (`bip39_mnemonic`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Recovery phrase of a cryptocurrency wallet as defined by BIP 39: 12, 15, 18, 21 or 24 words from a fixed list of 2048 words, where the last word also carries a checksum of the entropy. The phrase, with an optional passphrase, gives the wallet seed from which BIP-32 keys are derived, so whoever knows it controls the wallet. The regexp covers the English word list (lower-case words of 3 to 8 letters separated by single spaces); BIP 39 also has word lists for other languages.

- Parent datatype: `private_key`
- Personal data (PII): no
- Categories: Cryptocurrency (cryptocurrency), Secrets and credentials (passwords, keys, tokens) (secrets)
- Countries: global
- Languages: English (en)
- Classification: identifier

## Detection

Regular expression (Python `re`):

```
^[a-z]{3,8}(?: [a-z]{3,8}){11}(?:(?: [a-z]{3,8}){3}){0,4}$
```

## Examples

- `abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about` — BIP 39 test vector, 12 words (entropy of zeros); never use it for a wallet
- `legal winner thank year wave sausage worth useful legal winner thank yellow` — BIP 39 test vector, 12 words; never use it for a wallet
- `abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about` (invalid example) — 11 words

## Translations

- ru: Мнемоническая фраза BIP-39 (seed-фраза)

## Sources

- doc: <https://github.com/bitcoin/bips/blob/master/bip-0039.mediawiki>
- doc: <https://github.com/bitcoin/bips/blob/master/bip-0039/english.txt>
- other: <https://github.com/trezor/python-mnemonic/blob/master/vectors.json>

## Quality

Score 80/100. Missing: mapping (Wikidata, Schema.org, ...), detector coverage.

JSON: <http://registry.apicrafter.io/api/v1/datatypes/bip39_mnemonic.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/cryptocurrency/bip39_mnemonic.yaml>