Streamline paper wallet pubkey verification docs (#7570)
* Book: Move paper wallet keypair docs to usage page * Book: Remove dedicated paper wallet keypair docs * Nudge our reader. Be extra clear * Clarify `--skip-seed-phrase-validation` argument rationale
This commit is contained in:
parent
0383ffa5ab
commit
8b7bbbc6af
|
@ -37,7 +37,6 @@
|
||||||
* [Running an Archiver](running-archiver.md)
|
* [Running an Archiver](running-archiver.md)
|
||||||
* [Paper Wallet](paper-wallet/README.md)
|
* [Paper Wallet](paper-wallet/README.md)
|
||||||
* [Installation](paper-wallet/installation.md)
|
* [Installation](paper-wallet/installation.md)
|
||||||
* [Creating and Using a Seed Phrase](paper-wallet/keypair.md)
|
|
||||||
* [Paper Wallet Usage](paper-wallet/usage.md)
|
* [Paper Wallet Usage](paper-wallet/usage.md)
|
||||||
* [API Reference](api-reference/README.md)
|
* [API Reference](api-reference/README.md)
|
||||||
* [Transaction](api-reference/transaction-api.md)
|
* [Transaction](api-reference/transaction-api.md)
|
||||||
|
|
|
@ -19,6 +19,4 @@ To learn more about the BIP39 standard, visit the Bitcoin BIPs Github repository
|
||||||
|
|
||||||
{% page-ref page="installation.md" %}
|
{% page-ref page="installation.md" %}
|
||||||
|
|
||||||
{% page-ref page="keypair.md" %}
|
|
||||||
|
|
||||||
{% page-ref page="usage.md" %}
|
{% page-ref page="usage.md" %}
|
||||||
|
|
|
@ -1,74 +0,0 @@
|
||||||
# Creating a Paper Wallet
|
|
||||||
|
|
||||||
Using the `solana-keygen` tool, it is possible to generate new seed phrases as
|
|
||||||
well as derive a keypair from an existing seed phrase and (optional) passphrase.
|
|
||||||
The seed phrase and passphrase can be used together as a paper wallet. As long
|
|
||||||
as you keep your seed phrase and passphrase stored safely, you can use them to
|
|
||||||
access your account.
|
|
||||||
|
|
||||||
{% hint style="info" %}
|
|
||||||
For more information about how seed phrases work, review this
|
|
||||||
[Bitcoin Wiki page](https://en.bitcoin.it/wiki/Seed_phrase).
|
|
||||||
{% endhint %}
|
|
||||||
|
|
||||||
## Seed Phrase Generation
|
|
||||||
|
|
||||||
Generating a new keypair can be done using the `solana-keygen new` command. The
|
|
||||||
command will generate a random seed phrase, ask you to enter an optional
|
|
||||||
passphrase, and then will display the derived public key and the generated seed
|
|
||||||
phrase for your paper wallet.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
solana-keygen new --no-outfile
|
|
||||||
```
|
|
||||||
|
|
||||||
{% hint style="warning" %}
|
|
||||||
If the `--no-outfile` flag is **omitted**, the default behavior is to write the
|
|
||||||
keypair to `~/.config/solana/id.json`
|
|
||||||
{% endhint %}
|
|
||||||
|
|
||||||
{% hint style="info" %}
|
|
||||||
For added security, increase the seed phrase word count using the `--word-count`
|
|
||||||
argument
|
|
||||||
{% endhint %}
|
|
||||||
|
|
||||||
For full usage details run:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
solana-keygen new --help
|
|
||||||
```
|
|
||||||
|
|
||||||
## Public Key Derivation
|
|
||||||
|
|
||||||
Public keys can be derived from a seed phrase and a passphrase if you choose to
|
|
||||||
use one. This is useful for using an offline-generated seed phrase to
|
|
||||||
derive a valid public key. The `solana-keygen pubkey` command will walk you
|
|
||||||
through entering your seed phrase and a passphrase if you chose to use one.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
solana-keygen pubkey ASK
|
|
||||||
```
|
|
||||||
|
|
||||||
{% hint style="info" %}
|
|
||||||
Note that you could potentially use different passphrases for the same seed
|
|
||||||
phrase. Each unique passphrase will yield a different keypair.
|
|
||||||
{% endhint %}
|
|
||||||
|
|
||||||
The `solana-keygen` tool assumes the use of the BIP39 standard English word
|
|
||||||
list. If you chose to deviate from the word list or used a different language
|
|
||||||
for your seed phrase, you can still derive a valid public key but will need to
|
|
||||||
explicitly skip seed phrase validation.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
solana-keygen pubkey ASK --skip-seed-phrase-validation
|
|
||||||
```
|
|
||||||
|
|
||||||
{% hint style="info" %}
|
|
||||||
Copy the derived public key to a USB stick for easy usage on networked computers
|
|
||||||
{% endhint %}
|
|
||||||
|
|
||||||
For full usage details run:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
solana-keygen pubkey --help
|
|
||||||
```
|
|
|
@ -10,13 +10,93 @@ written to disk by unencrypted memory swaps. It is the user's responsibility to
|
||||||
protect against this scenario.
|
protect against this scenario.
|
||||||
{% endhint %}
|
{% endhint %}
|
||||||
|
|
||||||
|
## Creating a Paper Wallet
|
||||||
|
|
||||||
|
Using the `solana-keygen` tool, it is possible to generate new seed phrases as
|
||||||
|
well as derive a keypair from an existing seed phrase and (optional) passphrase.
|
||||||
|
The seed phrase and passphrase can be used together as a paper wallet. As long
|
||||||
|
as you keep your seed phrase and passphrase stored safely, you can use them to
|
||||||
|
access your account.
|
||||||
|
|
||||||
|
{% hint style="info" %}
|
||||||
|
For more information about how seed phrases work, review this
|
||||||
|
[Bitcoin Wiki page](https://en.bitcoin.it/wiki/Seed_phrase).
|
||||||
|
{% endhint %}
|
||||||
|
|
||||||
|
### Seed Phrase Generation
|
||||||
|
|
||||||
|
Generating a new keypair can be done using the `solana-keygen new` command. The
|
||||||
|
command will generate a random seed phrase, ask you to enter an optional
|
||||||
|
passphrase, and then will display the derived public key and the generated seed
|
||||||
|
phrase for your paper wallet.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
solana-keygen new --no-outfile
|
||||||
|
```
|
||||||
|
|
||||||
|
{% hint style="warning" %}
|
||||||
|
If the `--no-outfile` flag is **omitted**, the default behavior is to write the
|
||||||
|
keypair to `~/.config/solana/id.json`
|
||||||
|
{% endhint %}
|
||||||
|
|
||||||
|
{% hint style="info" %}
|
||||||
|
For added security, increase the seed phrase word count using the `--word-count`
|
||||||
|
argument
|
||||||
|
{% endhint %}
|
||||||
|
|
||||||
|
For full usage details run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
solana-keygen new --help
|
||||||
|
```
|
||||||
|
|
||||||
|
### Public Key Derivation
|
||||||
|
|
||||||
|
Public keys can be derived from a seed phrase and a passphrase if you choose to
|
||||||
|
use one. This is useful for using an offline-generated seed phrase to
|
||||||
|
derive a valid public key. The `solana-keygen pubkey` command will walk you
|
||||||
|
through entering your seed phrase and a passphrase if you chose to use one.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
solana-keygen pubkey ASK
|
||||||
|
```
|
||||||
|
|
||||||
|
{% hint style="info" %}
|
||||||
|
Note that you could potentially use different passphrases for the same seed
|
||||||
|
phrase. Each unique passphrase will yield a different keypair.
|
||||||
|
{% endhint %}
|
||||||
|
|
||||||
|
The `solana-keygen` tool uses the same BIP39 standard English word list as it
|
||||||
|
does to generate seed phrases. If your seed phrase was generated with another
|
||||||
|
tool that uses a different word list, you can still use `solana-keygen`, but
|
||||||
|
will need to pass the `--skip-seed-phrase-validation` argument and forego this
|
||||||
|
validation.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
solana-keygen pubkey ASK --skip-seed-phrase-validation
|
||||||
|
```
|
||||||
|
|
||||||
|
{% hint style="info" %}
|
||||||
|
Copy the derived public key to a USB stick for easy usage on networked computers
|
||||||
|
{% endhint %}
|
||||||
|
|
||||||
|
{% hint style="info" %}
|
||||||
|
A common next step is to [check the balance](#checking-account-balance) of the
|
||||||
|
account associated with a public key
|
||||||
|
{% endhint %}
|
||||||
|
|
||||||
|
For full usage details run:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
solana-keygen pubkey --help
|
||||||
|
```
|
||||||
## Checking Account Balance
|
## Checking Account Balance
|
||||||
|
|
||||||
All that is needed to check an account balance is the public key of an account.
|
All that is needed to check an account balance is the public key of an account.
|
||||||
To retrieve public keys securely from a paper wallet, follow the
|
To retrieve public keys securely from a paper wallet, follow the
|
||||||
[Public Key Derivation](keypair.md#public-key-derivation) instructions on an
|
[Public Key Derivation](#public-key-derivation) instructions on an
|
||||||
[air gapped computer](https://en.wikipedia.org/wiki/Air_gap_\(networking\)).
|
[air gapped computer](https://en.wikipedia.org/wiki/Air_gap_\(networking\)).
|
||||||
Public keys can then be typed manually or transferred via a USB stick into a
|
Public keys can then be typed manually or transferred via a USB stick to a
|
||||||
networked machine.
|
networked machine.
|
||||||
|
|
||||||
Next, configure the `solana` CLI tool to connect to a particular cluster:
|
Next, configure the `solana` CLI tool to connect to a particular cluster:
|
||||||
|
@ -31,8 +111,8 @@ Finally, to check the balance, run the following command:
|
||||||
solana balance <PUBKEY>
|
solana balance <PUBKEY>
|
||||||
```
|
```
|
||||||
|
|
||||||
In order to check a list of public keys quickly, append public keys to a file
|
In order to check a list of public keys quickly, append public keys to a file,
|
||||||
like so:
|
one per line, like so:
|
||||||
|
|
||||||
`public_keys.txt`
|
`public_keys.txt`
|
||||||
```bash
|
```bash
|
||||||
|
|
Loading…
Reference in New Issue