diff --git a/astro.config.js b/astro.config.js index 499af8a3..cac4c629 100644 --- a/astro.config.js +++ b/astro.config.js @@ -39,6 +39,9 @@ export default defineConfig({ '/developer/duskds/overview': '/developer/duskvm/overview', '/developer/duskds/quickstart': '/developer/duskvm/quickstart', '/developer/duskds/reference': '/developer/duskvm/reference', + '/learn/web-wallet': '/use/wallets#web-wallet', + '/learn/rusk-wallet': '/use/wallets#rusk-wallet', + '/use/dusk-wallet': '/use/wallets#dusk-wallet', }, integrations: [ starlight({ diff --git a/public/llms-full.txt b/public/llms-full.txt index 7f1b2587..d4df241d 100644 --- a/public/llms-full.txt +++ b/public/llms-full.txt @@ -57,7 +57,7 @@ DuskDS supports: Relevant docs: - https://docs.dusk.network/learn/deep-dive/duskds-tx-models/ -- https://docs.dusk.network/learn/web-wallet/ +- https://docs.dusk.network/use/wallets/ ### Execution Paths @@ -86,11 +86,11 @@ Relevant docs: - Core Components: https://docs.dusk.network/learn/core-components/ - Core Values: https://docs.dusk.network/learn/core-values/ - Native Issuance: https://docs.dusk.network/learn/tokenization-comparison/ -- Ecosystem & Partners: https://docs.dusk.network/learn/ecosystem/ +- Ecosystem: https://docs.dusk.network/learn/ecosystem/ - Tokenomics: https://docs.dusk.network/learn/tokenomics/ - Glossary: https://docs.dusk.network/learn/glossary/ -### Developer +### Build - Developer Overview: https://docs.dusk.network/developer/overview/ - DuskEVM Quickstart: https://docs.dusk.network/developer/duskevm/quickstart/ @@ -98,16 +98,17 @@ Relevant docs: - DuskVM Quickstart: https://docs.dusk.network/developer/duskvm/quickstart/ - DuskVM Contract Reference: https://docs.dusk.network/developer/duskvm/reference/ - Dusk Connect: https://docs.dusk.network/developer/integrations/dusk-connect/ -- Dusk Wallet Extension: https://docs.dusk.network/developer/integrations/wallet-extension/ +- Dusk Wallet Integration: https://docs.dusk.network/developer/integrations/wallet-extension/ - Transaction Lifecycle: https://docs.dusk.network/developer/integrations/tx-lifecycle/ - HTTP API: https://docs.dusk.network/developer/integrations/http-api/ +- Historical Events: https://docs.dusk.network/developer/integrations/historical_events/ - W3sper SDK: https://docs.dusk.network/developer/integrations/w3sper/ - Exchange Integration: https://docs.dusk.network/developer/integrations/exchanges/ - Encoding & Hashing: https://docs.dusk.network/developer/integrations/reference/ - Dusk Improvement Proposals: https://docs.dusk.network/developer/contribute/dips/ - Grants: https://docs.dusk.network/developer/contribute/grants/ -### Operators +### Operate - Operator Overview: https://docs.dusk.network/operator/overview/ - Provisioner Node: https://docs.dusk.network/operator/provisioner/ @@ -117,13 +118,15 @@ Relevant docs: - Maintenance & Monitoring: https://docs.dusk.network/operator/maintenance-monitoring/ - Troubleshooting: https://docs.dusk.network/operator/troubleshooting/ -### User Tools +### Use Dusk -- Web Wallet: https://docs.dusk.network/learn/web-wallet/ -- Rusk Wallet: https://docs.dusk.network/learn/rusk-wallet/ -- Block Explorer: https://docs.dusk.network/learn/block-explorer/ +- Use Dusk Overview: https://docs.dusk.network/use/overview/ +- Wallets: https://docs.dusk.network/use/wallets/ +- Explorers: https://docs.dusk.network/learn/block-explorer/ - Staking: https://docs.dusk.network/learn/guides/staking-basics/ - DuskEVM Bridge: https://docs.dusk.network/learn/guides/duskevm-bridge/ +- Mainnet Migration: https://docs.dusk.network/learn/guides/mainnet-migration/ +- BEP20 Bridge: https://docs.dusk.network/learn/guides/bep20-bridge/ ## Naming Guidance diff --git a/public/llms.txt b/public/llms.txt index 665a8e04..864712d9 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -5,13 +5,16 @@ ## Start Here - [Overview](https://docs.dusk.network/learn/overview/): high-level introduction to Dusk. +- [Use Dusk](https://docs.dusk.network/use/overview/): choose a wallet, manage DUSK, stake, bridge, and inspect transactions. +- [Build on Dusk](https://docs.dusk.network/developer/overview/): choose a smart-contract or integration path. +- [Operate Dusk](https://docs.dusk.network/operator/overview/): choose, set up, and maintain Dusk infrastructure. - [Market Infrastructure](https://docs.dusk.network/learn/market-infrastructure/): how Dusk supports regulated asset workflows. - [Dusk Trade](https://docs.dusk.network/learn/dusk-trade/): product layer for tokenized financial asset workflows on Dusk. - [Core Components](https://docs.dusk.network/learn/core-components/): DuskDS, Rusk, DuskVM, DuskEVM, Citadel, and application-layer tooling. - [Core Values](https://docs.dusk.network/learn/core-values/): regulated workflows, access controls, selective disclosure, and deterministic settlement. - [Native Issuance](https://docs.dusk.network/learn/tokenization-comparison/): digitization, tokenization, and native issuance. -## Developer Docs +## Build - [Build on Dusk](https://docs.dusk.network/developer/overview/): choose between DuskVM and DuskEVM development. - [DuskEVM Quickstart](https://docs.dusk.network/developer/duskevm/quickstart/): deploy Solidity contracts on DuskEVM. @@ -19,9 +22,10 @@ - [DuskVM Quickstart](https://docs.dusk.network/developer/duskvm/quickstart/): create, test, build, and deploy a DuskVM contract. - [DuskVM Contract Reference](https://docs.dusk.network/developer/duskvm/reference/): understand the DuskVM contract, ABI, state, event, and deployment model. - [Dusk Connect](https://docs.dusk.network/developer/integrations/dusk-connect/): discover wallet extensions, request profile access, and submit user-approved transactions from browser dApps. -- [Dusk Wallet Extension](https://docs.dusk.network/developer/integrations/wallet-extension/): integrate with the first-party browser wallet provider. +- [Dusk Wallet Integration](https://docs.dusk.network/developer/integrations/wallet-extension/): integrate applications with the first-party browser wallet provider. - [Transaction Lifecycle](https://docs.dusk.network/developer/integrations/tx-lifecycle/): understand transaction flow. - [HTTP API](https://docs.dusk.network/developer/integrations/http-api/): integrate with Dusk APIs. +- [Historical Events](https://docs.dusk.network/developer/integrations/historical_events/): query finalized public transfer history from archive infrastructure. - [W3sper SDK](https://docs.dusk.network/developer/integrations/w3sper/): SDK integration. ## Learn @@ -32,12 +36,19 @@ - [Assets & Regulations](https://docs.dusk.network/learn/deep-dive/assets-and-regulations/): regulated asset workflow concepts. - [Cryptography](https://docs.dusk.network/learn/cryptography/): zero-knowledge proofs and cryptographic building blocks. -## Operators and Tools +## Use Dusk + +- [Use Dusk Overview](https://docs.dusk.network/use/overview/): find wallets, staking, bridge, migration, and explorer guides. +- [Wallets](https://docs.dusk.network/use/wallets/): compare Dusk Wallet, Web Wallet, Rusk Wallet, and community alternatives. +- [Explorers](https://docs.dusk.network/learn/block-explorer/): find official mainnet and testnet explorers and community alternatives. +- [Staking](https://docs.dusk.network/learn/guides/staking-basics/): stake DUSK and participate in consensus. +- [DuskEVM Bridge](https://docs.dusk.network/learn/guides/duskevm-bridge/): move testnet DUSK between the Dusk L1 and DuskEVM. + +## Operate - [Operator Overview](https://docs.dusk.network/operator/overview/): run and maintain Dusk infrastructure. +- [Networks](https://docs.dusk.network/operator/networks/): choose a Dusk network environment. - [Provisioner Node](https://docs.dusk.network/operator/provisioner/): run a provisioner node. -- [Web Wallet](https://docs.dusk.network/learn/web-wallet/): use Dusk in the browser. -- [Block Explorer](https://docs.dusk.network/learn/block-explorer/): inspect public network data. ## Full Context diff --git a/src/components/ResourceLinksGrid.astro b/src/components/ResourceLinksGrid.astro index 93b1fc11..2605f2a7 100644 --- a/src/components/ResourceLinksGrid.astro +++ b/src/components/ResourceLinksGrid.astro @@ -4,23 +4,23 @@ import { LinkCard, CardGrid } from "@astrojs/starlight/components"; diff --git a/src/content/docs/developer/duskvm/overview.md b/src/content/docs/developer/duskvm/overview.md index ad417526..84c363bb 100644 --- a/src/content/docs/developer/duskvm/overview.md +++ b/src/content/docs/developer/duskvm/overview.md @@ -22,7 +22,7 @@ Both environments are general-purpose. DuskVM executes contracts directly on the |---|---| | [Forge](https://github.com/dusk-network/forge) | Scaffolds contracts and generates ABI exports, schemas, and data drivers from annotated Rust | | [DuskVM](/learn/deep-dive/dusk-vm/) | Executes contract WASM and persists contract state | -| [Rusk Wallet](/learn/rusk-wallet/) | Signs and submits deployment and contract-call transactions | +| [Rusk Wallet](/use/wallets/#rusk-wallet) | Signs and submits deployment and contract-call transactions | | [Dusk Connect](/developer/integrations/dusk-connect/) | Connects browser dApps to compatible Dusk wallet extensions for account access and transaction approval | | [W3sper](/developer/integrations/w3sper/) | Connects JavaScript applications to Dusk nodes and contract data drivers | diff --git a/src/content/docs/developer/duskvm/quickstart.md b/src/content/docs/developer/duskvm/quickstart.md index ffa6fcd0..3b2254d5 100644 --- a/src/content/docs/developer/duskvm/quickstart.md +++ b/src/content/docs/developer/duskvm/quickstart.md @@ -80,7 +80,7 @@ Keep the `0x` prefix when an SDK expects prefixed hex. Remove it for `rusk-walle ## 5. Deploy on testnet -Install and configure [Rusk Wallet](/learn/rusk-wallet/) and make sure a public account has enough testnet DUSK for deployment. [Request funds from the testnet faucet](/operator/networks/#how-to-get-testnet-tokens) if needed. The commands below target testnet explicitly and use the wallet's first address by default; add `--address
` to use another funded address. Testnet DUSK has no monetary value. +Install and configure [Rusk Wallet](/use/wallets/#rusk-wallet) and make sure a public account has enough testnet DUSK for deployment. [Request funds from the testnet faucet](/operator/networks/#how-to-get-testnet-tokens) if needed. The commands below target testnet explicitly and use the wallet's first address by default; add `--address
` to use another funded address. Testnet DUSK has no monetary value. Deploy the on-chain artifact with a nonce you have not used for the same contract and account: diff --git a/src/content/docs/developer/duskvm/reference.md b/src/content/docs/developer/duskvm/reference.md index cb3173d4..6c7b4f2c 100644 --- a/src/content/docs/developer/duskvm/reference.md +++ b/src/content/docs/developer/duskvm/reference.md @@ -118,6 +118,6 @@ Both deployment and contract calls submitted as transactions consume gas, whethe - [Forge source and releases](https://github.com/dusk-network/forge) - [DuskVM source](https://github.com/dusk-network/rusk/tree/master/vm) - [Dusk contract ABI](https://docs.rs/dusk-core/latest/dusk_core/abi/) -- [Rusk Wallet](/learn/rusk-wallet/) +- [Rusk Wallet](/use/wallets/#rusk-wallet) - [Dusk Connect](/developer/integrations/dusk-connect/) - [W3sper SDK](/developer/integrations/w3sper/) diff --git a/src/content/docs/developer/integrations/wallet-extension.md b/src/content/docs/developer/integrations/wallet-extension.md index 42c427ef..beca0ca7 100644 --- a/src/content/docs/developer/integrations/wallet-extension.md +++ b/src/content/docs/developer/integrations/wallet-extension.md @@ -1,9 +1,11 @@ --- -title: Dusk Wallet Extension -description: Use the Dusk Wallet browser extension as a first-party wallet for Dusk applications. +title: Dusk Wallet Integration +description: Connect applications to the official Dusk Wallet extension and its provider API. --- -The Dusk Wallet extension is the first-party browser wallet for Dusk. It gives users a self-custodial wallet in Chrome and Firefox, and gives applications a provider surface for connecting Dusk accounts. +This page is for developers integrating with or building the Dusk Wallet extension. For installation and user guidance, see [Wallets](/use/wallets/#dusk-wallet). + +The Dusk Wallet extension is the first-party browser wallet for Dusk. It gives applications a provider surface for connecting Dusk accounts. Use the extension when you need: @@ -13,7 +15,7 @@ Use the extension when you need: - dApp connection through Dusk provider discovery - a first-party wallet to test Dusk Connect integrations -For users who only need a hosted browser wallet, see [Web Wallet](/learn/web-wallet). For terminal and operator workflows, see [Rusk Wallet](/learn/rusk-wallet). +For a hosted browser wallet or terminal and operator workflows, see [Wallets](/use/wallets/). ## How it fits with Dusk Connect @@ -80,4 +82,4 @@ Then load `dist-firefox/` as a temporary add-on in `about:debugging`. - [Dusk Connect](/developer/integrations/dusk-connect) - [Transaction Lifecycle](/developer/integrations/tx-lifecycle) -- [Web Wallet](/learn/web-wallet) +- [Wallets](/use/wallets/) diff --git a/src/content/docs/developer/overview.mdx b/src/content/docs/developer/overview.mdx index 1812b7a0..a1e3eee4 100644 --- a/src/content/docs/developer/overview.mdx +++ b/src/content/docs/developer/overview.mdx @@ -29,9 +29,9 @@ As a builder, choose the path based on what your product needs and which tooling description="Write general-purpose Rust/WASM contracts that execute directly on the Dusk L1." /> Dusk Block Explorer. +Explorers let you inspect public network data such as blocks, transactions, contracts, provisioners, fees, and gas usage. + +## Official explorers + +| Network | Explorer | +|---|---| +| Dusk mainnet | [explorer.dusk.network](https://explorer.dusk.network/) | +| Dusk testnet | [apps.testnet.dusk.network/explorer](https://apps.testnet.dusk.network/explorer/) | + +`explorer.dusk.network` is the canonical mainnet address and redirects to the explorer hosted under `apps.dusk.network`. + +## Community explorers + +[DuskExplorer.com](https://duskexplorer.com/), also known as **The DUDE**, is a community-operated mainnet explorer. It is not operated by Dusk. Community explorers may expose different indexes, labels, statistics, or wallet integrations, so verify important information against an official endpoint when needed. + +## What explorers can show Dusk is a privacy-preserving blockchain. Privacy-preserving [Phoenix](/learn/deep-dive/duskds-tx-models) transactions do not expose the sender, receiver and amount transferred to anyone other than the involved parties (sender, receiver, and users with the view key). diff --git a/src/content/docs/learn/dusk-trade.md b/src/content/docs/learn/dusk-trade.md index 59e0e620..f86b3b4b 100644 --- a/src/content/docs/learn/dusk-trade.md +++ b/src/content/docs/learn/dusk-trade.md @@ -55,4 +55,4 @@ Dusk Trade is where those requirements become a usable product surface. - [Native Issuance](/learn/tokenization-comparison) - [Assets & Regulations](/learn/deep-dive/assets-and-regulations) - [Dusk Connect](/developer/integrations/dusk-connect) -- [Dusk Wallet Extension](/developer/integrations/wallet-extension) +- [Wallets](/use/wallets) diff --git a/src/content/docs/learn/ecosystem.mdx b/src/content/docs/learn/ecosystem.mdx index b55a7d03..aab2eab9 100644 --- a/src/content/docs/learn/ecosystem.mdx +++ b/src/content/docs/learn/ecosystem.mdx @@ -1,47 +1,65 @@ --- -title: Ecosystem & Partners -description: Explore applications, tools, and partners in the Dusk ecosystem. +title: Ecosystem +description: Explore community applications, tools, initiatives, and integrations in the Dusk ecosystem. --- import { LinkCard, CardGrid } from '@astrojs/starlight/components'; -Dusk’s ecosystem spans on‑chain applications, user tools, and institutional partners. -This page highlights a selection of projects building on or integrating with Dusk. +Dusk's ecosystem includes applications, wallets, network tools, community initiatives, and institutional integrations. -Some of the services listed here are community‑operated or third‑party products. -Always do your own due diligence before using them. +Listings are informational, not endorsements. Community and third-party projects are operated independently from Dusk; verify their ownership, security, and current status before using them. -## On‑chain apps & DeFi +## Applications and protocols + -## Tools & explorers +## Wallets and network tools + + + + +## Community + + -## Infrastructure & partners +## Integrations and partners rusk-wallet/src/bin/README.md -- The current releases: - Rusk releases -- Your local help output: - `rusk-wallet --help` and `rusk-wallet --help` - -## Install - -- Download a prebuilt binary from the releases page. -- Or build from source from the rusk repo. - -## Usage - -Run without arguments to start interactive mode: - -```bash -rusk-wallet -``` - -Run a command directly (headless mode): - -```bash -rusk-wallet [flags] -``` - -Discover available commands and flags with: - -```bash -rusk-wallet --help -rusk-wallet --help -``` - -## Non-interactive use (automation) - -Most commands prompt for a wallet password when they need to decrypt secrets. For automation, you can provide it via `RUSK_WALLET_PWD`: - -```bash -export RUSK_WALLET_PWD= -rusk-wallet balance -``` - -For exporting provisioner keys in headless environments: - -```bash -export RUSK_WALLET_EXPORT_PWD= -``` - -Only do this in controlled environments, and be careful not to leak passwords via shell history, logs, or CI output. - -## Operator workflows - -If you are using the wallet for provisioner or archive-node operations, see: - -- [Node wallet setup](/operator/guides/node-wallet-setup) -- [Provisioner node](/operator/provisioner) -- [Archive node](/operator/archive-node) diff --git a/src/content/docs/learn/web-wallet.md b/src/content/docs/learn/web-wallet.md deleted file mode 100644 index 274a6d2f..00000000 --- a/src/content/docs/learn/web-wallet.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Web Wallet -description: Use the Dusk Web Wallet to manage DUSK in your browser. ---- - -The Dusk Web Wallet is the simplest way to manage DUSK and interact with the network. -It runs in your browser and supports both **public** (Moonlight) and **shielded** (Phoenix) transfers. - -## What you can do with it - -- Create or restore a Dusk wallet from a mnemonic. -- Send and receive DUSK using public or shielded transfers. -- Migrate ERC20/BEP20 DUSK to native DUSK: [ERC20/BEP20 Migration](/learn/guides/mainnet-migration). -- Bridge native DUSK to BSC: [Native DUSK to BEP20 Bridge](/learn/guides/bep20-bridge). -- Bridge Dusk L1 testnet to DuskEVM testnet: [Dusk L1 to DuskEVM bridge](/learn/guides/duskevm-bridge). - -For node/operator staking workflows, use the CLI wallet and operator guides instead: -[Staking on Dusk](/learn/guides/staking-basics), [Rusk Wallet](/learn/rusk-wallet), and [Run a provisioner node](/operator/provisioner). - -## How to use the Web Wallet - -### 1) Open the Web Wallet - -Visit the official Web Wallet at apps.dusk.network/wallet. - -:::note[Important] -Always verify the URL before entering your recovery phrase. Never share your mnemonic or private keys. -::: - -### 2) Create or restore a wallet - -You can either create a new wallet or restore an existing one using your recovery phrase. - -#### Option A) Create a new wallet - -1. Click **Create New Wallet**. -2. Write down and securely store your **12-word recovery phrase**. -3. Set a **strong password** to encrypt your wallet. - -#### Option B) Restore an existing wallet - -1. Click **Restore Wallet**. -2. Enter your **12-word recovery phrase** and follow the prompts. - -### 3) Receive or send DUSK - -- **Receive**: open the **Receive** tab and copy your address. -- **Send**: open the **Send** tab, enter the recipient and amount, then choose **public** or **shielded**. - -:::tip -Public transfers use Moonlight. Shielded transfers use Phoenix. Learn more about both models in [Transaction Models on Dusk](/learn/deep-dive/duskds-tx-models). -::: diff --git a/src/content/docs/operator/guides/node-wallet-setup.md b/src/content/docs/operator/guides/node-wallet-setup.md index e99e6a08..8563521d 100644 --- a/src/content/docs/operator/guides/node-wallet-setup.md +++ b/src/content/docs/operator/guides/node-wallet-setup.md @@ -19,8 +19,8 @@ For the staking model, maturity period, reward timing, and unstaking behavior, r Before setting up your node wallet, you’ll need a mnemonic. You can obtain one using any of the following methods: -- **Using the CLI wallet ([Rusk Wallet](/learn/rusk-wallet))**, either directly on your node or locally on your machine. You can download it from the [Rusk releases page](https://github.com/dusk-network/rusk/releases?q=rusk+wallet&expanded=true). -- **Using the [Web Wallet](/learn/web-wallet)** if you would rather use a web app to access your wallet on your main device. +- **Using the CLI wallet ([Rusk Wallet](/use/wallets#rusk-wallet))**, either directly on your node or locally on your machine. You can download it from the [Rusk releases page](https://github.com/dusk-network/rusk/releases?q=rusk+wallet&expanded=true). +- **Using the [Web Wallet](/use/wallets#web-wallet)** if you would rather use a web app to access your wallet on your main device. **Important:** Back up your mnemonic phrase securely and never share it. Anyone with access to this phrase can control your wallet and funds. diff --git a/src/content/docs/operator/overview.mdx b/src/content/docs/operator/overview.mdx index 076ade2c..8e388cfb 100644 --- a/src/content/docs/operator/overview.mdx +++ b/src/content/docs/operator/overview.mdx @@ -1,21 +1,37 @@ --- -title: Dusk Node Documentation -description: A complete guide to setting up, configuring, and operating a node on Dusk. +title: Operate Dusk +description: Choose, set up, maintain, and troubleshoot a Dusk node. --- -import { LinkCard, Card, CardGrid } from '@astrojs/starlight/components'; +import { LinkCard, CardGrid } from '@astrojs/starlight/components'; -This Dusk Node documentation documentation is for anyone interested in running a Dusk node. Here you can find information about the different types of nodes, the requirements for running a node, and the different ways to set up a node. +Run Dusk infrastructure by first choosing the network and node role that match your objective. The operator guides then cover setup, upgrades, monitoring, recovery, and troubleshooting. -## Setting Up & Running a Node +## Start here -There are multiple ways to set up a Dusk node. The pages below provide guides on how to run a node. + + + + + + + +## Operator workflow + +1. [Choose a network](/operator/networks/) and confirm its endpoints and chain ID. +2. Choose the appropriate [provisioner](/operator/provisioner/), [archive](/operator/archive-node/), or [prover](/operator/prover/) role. +3. Follow the role-specific installation and configuration instructions. +4. Configure the [node wallet](/operator/guides/node-wallet-setup/) when the role requires one. +5. Establish [maintenance and monitoring](/operator/maintenance-monitoring/) before treating the node as production infrastructure. + +## Common tasks - - - + + + + :::tip -For developing actively on the Node software or running nodes locally for testing you should look into the README of the Rusk repository. +For Rusk development or local test environments, use the Rusk repository. The operator guides are for deployed network infrastructure. ::: diff --git a/src/content/docs/use/overview.mdx b/src/content/docs/use/overview.mdx new file mode 100644 index 00000000..64e26708 --- /dev/null +++ b/src/content/docs/use/overview.mdx @@ -0,0 +1,43 @@ +--- +title: Use Dusk +description: Choose a wallet, manage DUSK, stake, bridge between networks, and inspect transactions. +--- + +import { LinkCard, CardGrid } from '@astrojs/starlight/components'; + +Start with [Wallets](/use/wallets/) to choose between the official browser extension, Web Wallet, command-line wallet, and community alternatives. + +## Start here + + + + + + + + +## Move DUSK + +| Goal | Guide | +|---|---| +| Move testnet DUSK between the Dusk L1 and DuskEVM | [DuskEVM bridge](/learn/guides/duskevm-bridge/) | +| Migrate ERC20 or BEP20 DUSK to Dusk mainnet | [Mainnet migration](/learn/guides/mainnet-migration/) | +| Bridge DUSK from Dusk mainnet to BSC | [BEP20 bridge](/learn/guides/bep20-bridge/) | + +For questions and announcements, use the [official Dusk community channels](/learn/community/). diff --git a/src/content/docs/use/wallets.md b/src/content/docs/use/wallets.md new file mode 100644 index 00000000..124ef871 --- /dev/null +++ b/src/content/docs/use/wallets.md @@ -0,0 +1,57 @@ +--- +title: Wallets +description: Compare official and community wallets for Dusk browser, dApp, command-line, and operator workflows. +--- + +Choose a wallet based on how you plan to use Dusk. + +| Wallet | Status | Best for | +|---|---|---| +| [Dusk Wallet](#dusk-wallet) | Official | Browser extension, self-custody, and dApp connections | +| [Web Wallet](#web-wallet) | Official | Browser transfers, migration, and bridge workflows | +| [Rusk Wallet](#rusk-wallet) | Official | CLI, automation, staking, operators, and DuskVM contracts | +| [Piewallet](#community-wallets) | Community | Pieswap and combined Dusk/DuskEVM wallet workflows | + +## Dusk Wallet + +Dusk Wallet is the official self-custodial browser extension. It manages public and shielded DUSK, connects to compatible applications, and presents connection, transaction, and signature requests for approval. + +Install it from the official listing for your browser: + +- [Chrome Web Store](https://chromewebstore.google.com/detail/dusk-wallet/gcbboponngpmioapekmkajmffefaacld) +- [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/dusk-wallet/) + +Developers integrating wallet connections should use [Dusk Connect](/developer/integrations/dusk-connect/). Extension-specific development details are in [Dusk Wallet Integration](/developer/integrations/wallet-extension/). + +## Web Wallet + +The official Web Wallet runs in the browser and supports public and shielded transfers. It also provides the interfaces used by the migration and bridge guides. + +- [Mainnet Web Wallet](https://apps.dusk.network/wallet/) +- [Testnet Web Wallet](https://apps.testnet.dusk.network/wallet/) +- [Migrate ERC20 or BEP20 DUSK to Dusk mainnet](/learn/guides/mainnet-migration/) +- [Bridge DUSK from Dusk mainnet to BSC](/learn/guides/bep20-bridge/) +- [Bridge testnet DUSK between the Dusk L1 and DuskEVM](/learn/guides/duskevm-bridge/) + +## Rusk Wallet + +`rusk-wallet` is the official command-line wallet for automation, terminal-first workflows, staking, node operations, and DuskVM contract transactions. + +Use the versioned upstream documentation and local help as the command reference: + +- [Rusk Wallet README](https://github.com/dusk-network/rusk/blob/master/rusk-wallet/src/bin/README.md) +- [Rusk releases](https://github.com/dusk-network/rusk/releases?q=rusk+wallet&expanded=true) +- `rusk-wallet --help` and `rusk-wallet --help` + +For specific workflows, see [node wallet setup](/operator/guides/node-wallet-setup/), [run a provisioner](/operator/provisioner/), or the [DuskVM quickstart](/developer/duskvm/quickstart/). + +## Community wallets + +[Piewallet](https://chromewebstore.google.com/detail/piewallet/fpaajdmdhkhfedemboncmcmckkhnnike) is offered by Piecrust for Pieswap and Dusk-compatible networks. It is not operated by Dusk. See [Ecosystem](/learn/ecosystem/) for more community projects. + +## Wallet safety + +- Install wallet extensions only from verified listings and check the publisher. +- Never share a recovery phrase or private key. +- Review every connection, signature, and transaction request before approving it. +- Evaluate community software independently before storing funds or granting account access. diff --git a/src/sidebars/siteSidebar.js b/src/sidebars/siteSidebar.js index d09f43d0..8f64e8b8 100644 --- a/src/sidebars/siteSidebar.js +++ b/src/sidebars/siteSidebar.js @@ -3,85 +3,127 @@ const siteSidebar = [ label: "Learn", collapsed: false, items: [ + { label: "Overview", link: "/learn/overview" }, { - label: "About Dusk", + label: "Purpose and Products", collapsed: false, items: [ - { label: "Overview", link: "/learn/overview" }, { label: "Market Infrastructure", link: "/learn/market-infrastructure" }, { label: "Dusk Trade", link: "/learn/dusk-trade" }, + { label: "Native Issuance", link: "/learn/tokenization-comparison" }, + { label: "Assets and Regulations", link: "/learn/deep-dive/assets-and-regulations" }, + { label: "Core Values", link: "/learn/core-values" }, + ], + }, + { + label: "Architecture", + collapsed: true, + items: [ { label: "Core Components", link: "/learn/core-components" }, + { label: "Transaction Models", link: "/learn/deep-dive/duskds-tx-models" }, + { label: "DuskVM", link: "/learn/deep-dive/dusk-vm" }, { label: "DuskEVM", link: "/learn/dusk-evm" }, - { label: "Core Values", link: "/learn/core-values" }, - { label: "Native Issuance", link: "/learn/tokenization-comparison" }, - { label: "Ecosystem & Partners", link: "/learn/ecosystem" }, + { label: "Cryptography", link: "/learn/cryptography" }, + ], + }, + { + label: "Network and Ecosystem", + collapsed: true, + items: [ { label: "Tokenomics", link: "/learn/tokenomics" }, - { label: "Get involved & Community", link: "/learn/community" }, + { label: "Ecosystem", link: "/learn/ecosystem" }, + ], + }, + { + label: "Reference", + collapsed: true, + items: [ { label: "Glossary", link: "/learn/glossary" }, + { label: "Additional Resources", link: "/learn/deep-dive/additional-resources" }, ], }, + ], + }, + { + label: "Use Dusk", + collapsed: true, + items: [ + { label: "Overview", link: "/use/overview" }, { - label: "Tools", + label: "Wallets and Explorers", + collapsed: true, items: [ - { label: "Block Explorer", link: "/learn/block-explorer" }, - { label: "Web Wallet", link: "/learn/web-wallet" }, - { label: "Rusk Wallet", link: "/learn/rusk-wallet" }, + { label: "Wallets", link: "/use/wallets" }, + { label: "Explorers", link: "/learn/block-explorer" }, ], }, { - label: "Guides", + label: "Manage DUSK", + collapsed: true, items: [ - { label: "How to Stake", link: "/learn/guides/staking-basics" }, - { label: "Bridge DUSK", link: "/learn/guides/duskevm-bridge" }, - { label: "Mainnet DUSK Migration", link: "/learn/guides/mainnet-migration" }, - { label: "BEP20 Bridge", link: "/learn/guides/bep20-bridge" }, - { label: "Verify Team Account", link: "/learn/verify-team-account" }, + { label: "Stake DUSK", link: "/learn/guides/staking-basics" }, + { label: "Bridge to DuskEVM", link: "/learn/guides/duskevm-bridge" }, + { label: "Migrate to Dusk Mainnet", link: "/learn/guides/mainnet-migration" }, + { label: "Bridge to BSC", link: "/learn/guides/bep20-bridge" }, ], }, { - label: "Deep dive into Dusk", + label: "Trust and Community", collapsed: true, items: [ - { label: "Cryptography", link: "/learn/cryptography" }, - { label: "Transaction Models", link: "/learn/deep-dive/duskds-tx-models" }, - { label: "Assets & Regulations", link: "/learn/deep-dive/assets-and-regulations" }, - { label: "DuskVM", link: "/learn/deep-dive/dusk-vm" }, - { label: "Additional Resources", link: "/learn/deep-dive/additional-resources" }, + { label: "Verify Team Accounts", link: "/learn/verify-team-account" }, + { label: "Community", link: "/learn/community" }, ], }, ], }, { - label: "Developer", + label: "Build", collapsed: true, items: [ { label: "Overview", link: "/developer/overview" }, { - label: "Build on Dusk", + label: "Smart Contracts", + collapsed: true, items: [ { label: "DuskVM Overview", link: "/developer/duskvm/overview" }, { label: "DuskVM Quickstart", link: "/developer/duskvm/quickstart" }, { label: "DuskVM Reference", link: "/developer/duskvm/reference" }, { label: "DuskEVM Quickstart", link: "/developer/duskevm/quickstart" }, { label: "DuskEVM Reference", link: "/developer/duskevm/reference" }, - { label: "Stake Abstraction", link: "/learn/hyperstaking" }, - { label: "Digital Identity Protocol", link: "/developer/digital-identity/protocol" }, + ], + }, + { + label: "Wallet Integration", + collapsed: true, + items: [ { label: "Dusk Connect", link: "/developer/integrations/dusk-connect" }, - { label: "Dusk Wallet Extension", link: "/developer/integrations/wallet-extension" }, + { label: "Dusk Wallet Integration", link: "/developer/integrations/wallet-extension" }, + { label: "W3sper SDK", link: "/developer/integrations/w3sper" }, ], }, { - label: "Integrate with Dusk", + label: "Network Integration", + collapsed: true, items: [ { label: "Transaction Lifecycle", link: "/developer/integrations/tx-lifecycle" }, - { label: "W3sper SDK", link: "/developer/integrations/w3sper" }, { label: "HTTP API", link: "/developer/integrations/http-api" }, - { label: "Integrate with Exchanges", link: "/developer/integrations/exchanges" }, - { label: "Encoding & Hashing", link: "/developer/integrations/reference" }, + { label: "Historical Events", link: "/developer/integrations/historical_events" }, + { label: "Encoding and Hashing", link: "/developer/integrations/reference" }, + { label: "Exchange Integration", link: "/developer/integrations/exchanges" }, ], }, { - label: "Contribute to Dusk", + label: "Protocol Capabilities", + collapsed: true, + items: [ + { label: "Stake Abstraction", link: "/learn/hyperstaking" }, + { label: "Digital Identity", link: "/developer/digital-identity/protocol" }, + ], + }, + { + label: "Contribute", + collapsed: true, items: [ { label: "Dusk Improvement Proposals", link: "/developer/contribute/dips" }, { label: "Grants Program", link: "/developer/contribute/grants" }, @@ -90,31 +132,39 @@ const siteSidebar = [ ], }, { - label: "Node Operator", + label: "Operate", collapsed: true, items: [ { label: "Overview", link: "/operator/overview" }, + { label: "Choose a Network", link: "/operator/networks" }, { - label: "Node types", + label: "Node Types", + collapsed: true, items: [ - { label: "Provisioner node", link: "/operator/provisioner" }, - { label: "Archive node", link: "/operator/archive-node" }, - { label: "Prover node", link: "/operator/prover" }, + { label: "Provisioner Node", link: "/operator/provisioner" }, + { label: "Archive Node", link: "/operator/archive-node" }, + { label: "Prover Node", link: "/operator/prover" }, ], }, { - label: "Guides", + label: "Set Up and Maintain", + collapsed: true, items: [ - { label: "Setup wallet on Node", link: "/operator/guides/node-wallet-setup" }, + { label: "Set Up the Node Wallet", link: "/operator/guides/node-wallet-setup" }, + { label: "Maintenance and Monitoring", link: "/operator/maintenance-monitoring" }, + { label: "Upgrade a Node", link: "/operator/guides/upgrade-node" }, { label: "Fast-Sync a Node", link: "/operator/guides/fast-sync" }, { label: "Manually Re-Sync a Node", link: "/operator/guides/manual-resync" }, - { label: "Upgrade a Node", link: "/operator/guides/upgrade-node" }, { label: "Roll Back a Node Update", link: "/operator/guides/rollback-node-update" }, + ], + }, + { + label: "Recovery and Help", + collapsed: true, + items: [ { label: "Slashing Recovery", link: "/operator/guides/slashing-recovery" }, - { label: "Choose a Network", link: "/operator/networks" }, - { label: "Maintenance & Monitoring", link: "/operator/maintenance-monitoring" }, - { label: "FAQ", link: "/operator/faq" }, { label: "Troubleshooting", link: "/operator/troubleshooting" }, + { label: "FAQ", link: "/operator/faq" }, ], }, ],