Skip to content

Commit 50d3a23

Browse files
committed
Add guide for primary address and view-only wallet setup
1 parent 4807195 commit 50d3a23

1 file changed

Lines changed: 105 additions & 0 deletions

File tree

Lines changed: 105 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
# Generate a Monero primary address and obtain its private view key using monero-wallet-cli
2+
3+
## Overview
4+
5+
Note: This tutorial includes instructions for Windows, macOS, and Linux. Skip any steps that do not apply to your operating system.
6+
7+
In this tutorial, you will generate a Monero primary address and retrieve its associated private view key. These are commonly used when setting up a store or service that needs to receive Monero payments and monitor incoming transactions.
8+
9+
To accomplish this, we will use the Monero command-line wallet `monero-wallet-cli`. This tool is required to create the address and keys, and all wallet creation steps can be completed offline.
10+
11+
To begin, open a terminal window (Mac/Linux) or command prompt (Windows) and type the following commands:
12+
13+
```bash
14+
# LINUX: Download the Linux 64-bit command line client and extract it
15+
wget https://downloads.getmonero.org/linux64
16+
tar -xvf linux64
17+
cd monero-x86_64-linux-gnu-*
18+
19+
# MAC: Download the Mac command line client and extract it
20+
wget https://downloads.getmonero.org/mac64
21+
tar -xvf mac64
22+
cd monero-x86_64-apple-*
23+
24+
# WINDOWS: Create a new folder with Windows File Explorer, and use your web browser to download the following file to the new folder
25+
https://downloads.getmonero.org/win64
26+
27+
# You are strongly advised to verify the hashes of the archive you downloaded:
28+
# https://www.getmonero.org/downloads/#cli
29+
30+
# WINDOWS: Double click the Monero zip file that has been downloaded to extract it. Then open Command Prompt. Use the 'cd' command to navigate to your new folder
31+
cd monero-x86_64-w64-*
32+
33+
# Run the Monero command line wallet.
34+
# LINUX/MAC:
35+
./monero-wallet-cli --offline
36+
# WINDOWS:
37+
monero-wallet-cli.exe --offline
38+
39+
# Follow the instructions displayed to create a new wallet. When told the 25 word SEED, write this down on paper and keep it in a very safe place. Even if you forget your passwords, the 25 word SEED can be used to recreate your wallet from any machine and have complete control over your Monero funds. Sample output from the Monero wallet is below:
40+
41+
# Important: The wallet address, seed phrase, and keys shown below were generated solely for this tutorial and contain no funds. Do not reuse these values.
42+
43+
Specify wallet file name (e.g., MyWallet). If the wallet doesn't exist, it will be created.
44+
Wallet file name (or Ctrl-C to quit): wallet
45+
No wallet found with that name. Confirm creation of new wallet named: wallet
46+
(Y/Yes/N/No): Y
47+
Generating new wallet...
48+
Enter a password for your new wallet: ********
49+
Confirm Password: ********
50+
List of available languages for your wallet's seed:
51+
0 : Deutsch
52+
1 : English
53+
2 : Español
54+
3 : Français
55+
4 : Italiano
56+
5 : Nederlands
57+
6 : Português
58+
7 : русский язык
59+
8 : 日本語
60+
9 : 简体中文 (中国)
61+
10 : Esperanto
62+
11 : Lojban
63+
Enter the number corresponding to the language of your choice: 1
64+
Generated new wallet: 45zK2WxTctfc7h6qFVwoN4eJH1Wcu9spwDk2cCuivssre9sCu7uVEEmCziCkYvGyDwHHM1KNyrbid7zvWZ5XKzmJ5yMPTcE
65+
View key: 8df34dd4b56bd13a69544d849bd0bce2a675bfc600d9e776ad801a6e9867580d
66+
**********************************************************************
67+
Your wallet has been generated!
68+
To start synchronizing with the daemon, use the "refresh" command.
69+
Use the "help" command to see a simplified list of available commands.
70+
Use "help all" command to see the list of all available commands.
71+
Use "help <command>" to see a command's documentation.
72+
Always use the "exit" command when closing monero-wallet-cli to save
73+
your current session's state. Otherwise, you might need to synchronize
74+
your wallet again (your wallet keys are NOT at risk in any case).
75+
76+
77+
NOTE: the following 25 words can be used to recover access to your wallet. Write them down and store them somewhere safe and secure. Please do not store them in your email or on file storage services outside of your immediate control.
78+
79+
arsenic ammo eating moisture fountain giant stunning eternal
80+
neon ritual hookup wipeout zones launching voted sovereign
81+
kiwi locker audio react inquest benches oyster present fountain
82+
**********************************************************************
83+
The daemon is not set up to background mine.
84+
With background mining enabled, the daemon will mine when idle and not on battery.
85+
Enabling this supports the network you are using, and makes you eligible for receiving new monero
86+
Do you want to do it now? (Y/Yes/N/No): : n
87+
Background mining not enabled. Set setup-background-mining to 1 to change.
88+
If you are new to Monero, type "welcome" for a brief overview.
89+
Error: wallet failed to connect to daemon, because it is set to offline mode
90+
Background refresh thread started
91+
92+
# Type "address" to see your public wallet address. You can give this address to anyone, and they will be able to send you Monero. However, NEVER give anyone your 25 word SEED.
93+
94+
[wallet 45zK2W]: address
95+
0 45zK2WxTctfc7h6qFVwoN4eJH1Wcu9spwDk2cCuivssre9sCu7uVEEmCziCkYvGyDwHHM1KNyrbid7zvWZ5XKzmJ5yMPTcE Primary address
96+
97+
# Type "viewkey" to see your public and private view key
98+
99+
[wallet 45zK2W]: viewkey
100+
Wallet password: ********
101+
secret: 8df34dd4b56bd13a69544d849bd0bce2a675bfc600d9e776ad801a6e9867580d
102+
public: 1f562cd2ab81d247b6a5492b619d166157b30ca3d60ffe29d79ffd3fde1bbd2c
103+
```
104+
105+
Congratulations! You have generated a Monero primary address along with its private view key, which can be used to create a view wallet and track incoming payments for your store.

0 commit comments

Comments
 (0)