-
Notifications
You must be signed in to change notification settings - Fork 78
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
update keychain and namadillo names #391
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,34 +1,32 @@ | ||
# Namada Interface | ||
|
||
## Front end development with Namada | ||
The [namada-interface repository](https://github.com/anoma/namada-interface) is a monorepo which contains the Namada browser extension | ||
and associated Namada-Interface web app. It's a great resource for developers wishing to understand how to incorporate the Namada SDK | ||
The [namada-interface repository](https://github.com/anoma/namada-interface) is a monorepo that contains the Namada Keychain browser extension | ||
and associated Namadillo web app. It's a great resource for developers wishing to understand how to incorporate the Namada SDK | ||
into their front-end applications. | ||
|
||
### Installing from source (for development and experiment purposes) | ||
|
||
#### Connect to a testnet or run a local node | ||
1. Follow the instructions for the [testnets](../networks/testnets.mdx) to connect to a testnet or [set up a local node](../operators/networks/local-network.mdx). | ||
2. Figure out where the base directory is stored and save its location as a variable such as `export BASE_DIR=<path/to/base/dir>`. | ||
You can follow [these docs](../networks/testnets/migrating-testnets.mdx) to save this variable. Go ahead and save the chain id as a variable as well. You can find the chain id by running `cat $BASE_DIR/global-config.toml`. Save this chain-id to the variable `export CHAIN_ID=<CHAIN_ID>`. | ||
3. You will need to edit the CometBFT config in order to allow the web wallet to connect to your node. | ||
The CometBFT config will be located in `$BASE_DIR/$CHAIN_ID/cometbft/config/config.toml`. You will need to change the `cors_allowed_origins` field to `["*"]`. You can do this by running | ||
1. Follow the instructions for the [testnets](../networks/testnets.mdx) to connect to a testnet or [set up a local node](../networks/starting-network/local-network.mdx). | ||
2. Figure out where the base directory is stored and save its location in an environment variable with something like `export BASE_DIR=<path/to/base/dir>`. | ||
You can follow [these docs](../networks/testnets/migrating-testnets.mdx) to save this variable. Consider saving the chain ID as an environment variable as well. | ||
You can find the chain ID by running `cat $BASE_DIR/global-config.toml`. Save this chain-id to the environment variable `export CHAIN_ID=<CHAIN_ID>`. | ||
3. You will need to edit the CometBFT config in order to allow Namadillo to connect to your node. | ||
The CometBFT config will be located in `$BASE_DIR/$CHAIN_ID//config.toml`. You will need to change the `cors_allowed_origins` field to `["*"]`. You can do this by running | ||
```shell copy | ||
sed -i 's/cors_allowed_origins = \[\]/cors_allowed_origins = ["*"]/' \ | ||
$BASE_DIR/$CHAIN_ID/cometbft/config/config.toml | ||
$BASE_DIR/$CHAIN_ID/config.toml | ||
``` | ||
|
||
#### Setting up the extension | ||
#### Setting up the Namada Keychain extension | ||
1. Clone the [namada-interface repository](https://github.com/anoma/namada-interface). | ||
2. Follow the installation instructions in `README.md`. | ||
3. `cd` into the `namada-interface/apps/extension` directory and run `yarn start:chrome`. This will build the extension and place it in the `namada-interface/apps/extension/build` directory. It also starts the dev server which will watch for changes. | ||
4. `cd` into the `namada-interface/apps/namada-interface` directory and run `yarn dev:local` in order to launch a local instance of the web wallet. | ||
3. `cd` into the `namada-interface/apps/extension` directory and run `yarn start:chrome`. This will build the Namada Keychain extension and place it in `namada-interface/apps/extension/build/chrome`. It also starts the dev server which will watch for changes. | ||
4. `cd` into the `namada-interface/apps/namadillo` directory and run `yarn dev` in order to launch a local instance of Namadillo. | ||
4. Add the extension to the browser. For example, in Chrome, you can go to `chrome://extensions/` and click `Load unpacked` and select the `namada-interface/apps/extension/build/chrome/` folder. | ||
|
||
## Receiving tokens | ||
You can show the address of any account by pressing the `Receive` button in the initial view under the "Total Balances" tab. You can copy the address by clicking the copy icon next to the address. | ||
This will also display a QR code that can be scanned by a mobile wallet. | ||
|
||
## Sending Transactions | ||
|
||
In order to send transactions, you can press the `Send` button in the initial view under the "Total Balances" tab. This will open a modal that will allow you to send tokens to any account, from any account in your wallet that has a positive balance. | ||
You can show the address of the current account by hovering over the account name in the top right corner. Clicking it will copy it to the clipboard. | ||
You can copy the address by clicking the copy icon next to the address. | ||
This will also display a QR code that can be scanned by a mobile wallet. |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,5 @@ | ||
{ | ||
"file-system-wallet": "File system wallet", | ||
"web-wallet": "Web wallet", | ||
"web-wallet": "Keychain (browser extension)", | ||
"hardware-wallet": "Hardware wallet" | ||
} |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,30 +1,37 @@ | ||
import { Callout } from 'nextra-theme-docs' | ||
import { Steps } from 'nextra-theme-docs' | ||
|
||
# Web Wallet | ||
# Namada Keychain (browser extension) | ||
|
||
## Namada Extension | ||
You can use the [Namada Extension](https://namada.net/extension) to manage your keys within your browser. By connecting the extension with | ||
{/* Uncomment below when onboarding site is ready */} | ||
|
||
{/* | ||
<Callout emoji="😎"> | ||
Video guides for installing and using the Namada Keychain are available [here](https://namada-keychain.net). | ||
</Callout> | ||
*/} | ||
|
||
You can use the [Namada Keychain](https://namada.net/extension) browser extension to manage your keys within your browser. By connecting Namada Keychain with | ||
web apps built for Namada, you can send or recieve tokens, make IBC transfers, or perform other actions such as voting on governance proposals. | ||
|
||
## Installation | ||
The extension is currently available on the [Chrome web store](https://chromewebstore.google.com/detail/namada-extension/hnebcbhjpeejiclgbohcijljcnjdofek), with Firefox support coming soon. | ||
The Namada Keychain extension is currently available on the [Chrome web store](https://chromewebstore.google.com/detail/namada-extension/hnebcbhjpeejiclgbohcijljcnjdofek), with Firefox support coming soon. | ||
|
||
## Set-up | ||
After adding the extension to Chrome, follow these steps to create a new wallet: | ||
After adding Namada Keychain to your browser, follow these steps to create a new wallet: | ||
|
||
<Steps> | ||
|
||
### Click 'Launch Initial Set-up' | ||
|
||
### Add or create keys | ||
You can choose 'Import existing keys' to import an existing wallet from your twelve word mnemonic. You can also use a Ledger hardware wallet -- see [here](./hardware-wallet.mdx) | ||
You can choose 'Import existing keys' to import an existing wallet from your 12 or 24 word mnemonic, or raw private key. You can also use a Ledger hardware wallet; see [here](./hardware-wallet.mdx) | ||
for further instructions. | ||
|
||
Click 'Create new keys' and verify that you have read and understood the message to proceed. | ||
|
||
### Safely store your mnemonic | ||
You will be shown your recovery mnemonic and asked to confirm that you have written it down. | ||
You will be shown your recovery mnemonic and asked to confirm that you have written it down. You can choose between a 12 or 24 word mnemonic using the toggle at the top. | ||
|
||
<Callout type="warning" emoji="❗"> | ||
Write your mnemonic down and store it safely offline. | ||
|
@@ -33,10 +40,10 @@ It will allow you to recover your account. Without it, you risk losing access to | |
</Callout> | ||
|
||
### Create and safely store your password | ||
You will also be asked to create a password for the extension. Write down this password -- you will need to enter it regularly when using the extension. | ||
You will also be asked to create a password for your Namada Keychain. Write down this password; you will need to enter it regularly when using Namada Keychain. | ||
|
||
<Callout type="warning" emoji="❗"> | ||
If you lose your password, you will lose access to the extension. | ||
If you lose your password, you will lose access to your keys stored in Namada Keychain. | ||
|
||
Remember: there's no 'recover password with email' option! | ||
</Callout> | ||
|
@@ -45,34 +52,34 @@ Remember: there's no 'recover password with email' option! | |
Your wallet is ready to use. | ||
</Steps> | ||
|
||
## Using the Extension | ||
The extension itself only provides key management functionality. To send or receive tokens, you will need to navigate to a compatible | ||
web app (such as [namada-interface](https://github.com/anoma/namada-interface)) and connect the extension to the site. | ||
## Using Namada Keychain | ||
The Namada Keychain extension itself only provides key management functionality. To send or receive tokens, you will need to navigate to a compatible | ||
web app (such as [Namadillo](https://github.com/anoma/namada-interface)) and approve a connection to Namada Keychain from the site. | ||
|
||
Here's how to use the extension with Namada-Interface: | ||
Here's how to use Namada Keychain with Namadillo: | ||
|
||
<Steps> | ||
### Set the network in the extension | ||
Open the extension and click the 'gear' icon in the top right, then select 'Network'. | ||
### Set the network in Namada Keychain | ||
Open Namada Keychain and click the 'gear' icon in the top right, then select 'Network'. | ||
|
||
Enter a valid chain-id and rpc url for the chain you wish to transact on, and click 'Submit'. | ||
|
||
### Navigate to the Namada-interface site | ||
The Namada-interface for the [Campfire testnet](../../networks/testnets/campfire.mdx) is hosted at [https://interface.luminara.icu](https://interface.luminara.icu). After mainnet | ||
has launched, a list of hosted Interfaces will be found [here](../../networks/mainnets.mdx). | ||
### Navigate to a hosted instance of Namadillo | ||
The Namadillo instance for the [Campfire testnet](../../networks/testnets/campfire.mdx) is hosted at [https://interface.luminara.icu](https://interface.luminara.icu). After mainnet | ||
has launched, a list of hosted Namadillo instances will be found [here](../../networks/mainnets.mdx). | ||
|
||
### Connect the extension | ||
Click 'Connect to Namada Extension' and approve when prompted. You should see your wallet balance displayed on the page. | ||
### Connect Namada Keychain | ||
Click the 'Connect Extension' button and approve when prompted. If everything is configured correctly, you should now see your wallet balance displayed on the page. | ||
|
||
### Interact | ||
Once connected, you can use the Interface to make transfers or stake with a validator (Note: some functionality may be missing on testnet). | ||
Whenever you submit a transaction to the chain, you will be prompted to enter your password to allow the extension to sign using your private key. | ||
Once connected, you can use Namadillo to make transfers or stake with a validator (Note: some functionality may be missing on testnet). | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This is mostly correct, but transfers aren't enabled currently. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Does the transfer functionality generally exist though? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. We don't have the UI for this currently. Phase 3 will introduce the IBC & Shielded Transfer views, which are being developed right now! |
||
Whenever you submit a transaction to the chain, you will be prompted to enter your password to allow Namada Keychain to sign using your private key. | ||
|
||
### Disconnect | ||
If you wish to disconnect (remove permissions) from a site, you can do so in the Settings menu of the extension, under 'Connected Sites'. | ||
If you wish to disconnect (remove permissions) from a site, you can do so in the Settings menu of Namada Keychain, under 'Connected Sites'. | ||
|
||
</Steps> | ||
|
||
## Using a hardware wallet (Ledger) | ||
See the [hardware wallet](./hardware-wallet.mdx) page for instructions on installing the Namada Ledger app and using it | ||
with the extension. | ||
with Namada Keychain. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we need a disclaimer here that this will only work on Chrome-enabled browsers. Firefox removed the USB transport. We only show
Connect to Hardware Wallet
when it is available in the browser.