Skip to content

Commit

Permalink
Basic instructions on installing and funding a wallet (#186)
Browse files Browse the repository at this point in the history
* Basic instructions on installing and funding a wallet

* Signs Tezos transactions
  • Loading branch information
timothymcmackin authored Nov 29, 2023
1 parent ef656f7 commit e70de37
Show file tree
Hide file tree
Showing 4 changed files with 60 additions and 0 deletions.
59 changes: 59 additions & 0 deletions docs/developing/wallet-setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: Installing and funding a wallet
authors: Tim McMackin
last_update:
date: 27 November 2023
---

To work with Tezos, you need a wallet, which is an application that maintains your accounts and signs Tezos transactions on your behalf.
Wallets allow you to interact with dApps without exposing your account's private key.

## Choosing a wallet

Which wallet you install is up to you and whether you want to install a wallet on your computer, in a browser extension, or as a mobile app.

Mobile apps include [Temple](https://templewallet.com/), [Kukai](https://wallet.kukai.app/), and [Umami](https://umamiwallet.com/).

Browser extensions include the [Temple](https://templewallet.com/) browser extension.

Desktop wallets for Tezos include [Kukai](https://wallet.kukai.app/) and [Umami](https://umamiwallet.com/).

## Switching the wallet to a testnet

If you're doing development work, you're probably using a testnet instead of Mainnet.
On testnets, tokens are free so you don't have to spend real currency to work with your applications.

The process for changing the network is different for each wallet type.
These steps are for the Temple wallet:

1. Go to https://teztnets.xyz/, which lists Tezos testnets.
1. Click **Ghostnet**.
1. Copy one of the public RPC endpoints for Ghostnet, such as `https://rpc.ghostnet.teztnets.xyz`.
These URLs accept Tezos transactions from wallets and other applications.
1. In the Temple app, open the settings and then click **Default node (RPC)**.
1. Click the plus `+` symbol to add an RPC node.
1. On the Add RPC screen, enter the URL that you copied and give the connection a name, such as "Ghostnet," as shown in this picture:

<img src="/img/dApps/temple-wallet-new-rpc.png" alt="Entering information for the new RPC node" style={{width: 300}} />
1. Click Add.
1. Make sure that the new RPC node is selected, as in this image:

<img src="/img/dApps/temple-wallet-selected-rpc.png" alt="The new RPC node selected in the Temple wallet" style={{width: 300}} />

## Funding a wallet

Follow these steps to get testnet tez for the wallet:

1. From your wallet, get the address of your account, which starts with `tz1`.
This is the address that applications use to work with your wallet.

1. Go to the Ghostnet faucet at https://faucet.ghostnet.teztnets.xyz.

1. On the faucet page, paste your wallet address into the input field labeled "Or fund any address" and click the button for the amount of tez to add to your wallet.
20 tez is enough to work with, and you can return to the faucet later if you need more tez.

It may take a few minutes for the faucet to send the tokens and for those tokens to appear in your wallet.

You can use the faucet as much as you need to get tokens on the testnet, but those tokens are worthless and cannot be used on Mainnet.

![Fund your wallet using the Ghostnet Faucet](/img/tutorials/wallet-funding.png)
1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,7 @@ const sidebars = {
type: 'category',
label: 'Developing on Tezos',
items: [
'developing/wallet-setup',
'developing/dev-environments',
'developing/testnets',
// 'developing/sandbox', // TODO
Expand Down
Binary file added static/img/dApps/temple-wallet-new-rpc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/dApps/temple-wallet-selected-rpc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit e70de37

Please sign in to comment.