From f7a0e051f8b778d63d753785e2031ca86b41cd6a Mon Sep 17 00:00:00 2001 From: Hein Dauven Date: Tue, 14 Jul 2026 17:44:24 +0200 Subject: [PATCH 1/3] docs: reorganize navigation by user intent --- public/llms-full.txt | 10 +- public/llms.txt | 19 +++- src/components/ResourceLinksGrid.astro | 24 ++--- src/content/docs/developer/overview.mdx | 4 +- src/content/docs/index.mdx | 4 +- src/content/docs/operator/overview.mdx | 36 +++++-- src/content/docs/use/overview.mdx | 50 +++++++++ src/sidebars/siteSidebar.js | 131 ++++++++++++++++-------- 8 files changed, 205 insertions(+), 73 deletions(-) create mode 100644 src/content/docs/use/overview.mdx diff --git a/public/llms-full.txt b/public/llms-full.txt index 7f1b2587..f082d987 100644 --- a/public/llms-full.txt +++ b/public/llms-full.txt @@ -90,7 +90,7 @@ Relevant docs: - 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/ @@ -101,13 +101,14 @@ Relevant docs: - Dusk Wallet Extension: 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,16 @@ Relevant docs: - Maintenance & Monitoring: https://docs.dusk.network/operator/maintenance-monitoring/ - Troubleshooting: https://docs.dusk.network/operator/troubleshooting/ -### User Tools +### Use Dusk +- Use Dusk Overview: https://docs.dusk.network/use/overview/ - 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/ - 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..6b00d595 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. @@ -22,6 +25,7 @@ - [Dusk Wallet Extension](https://docs.dusk.network/developer/integrations/wallet-extension/): integrate 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 -- [Operator Overview](https://docs.dusk.network/operator/overview/): run and maintain Dusk infrastructure. -- [Provisioner Node](https://docs.dusk.network/operator/provisioner/): run a provisioner node. +- [Use Dusk Overview](https://docs.dusk.network/use/overview/): find wallets, staking, bridge, migration, and explorer guides. - [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. +- [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. ## 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/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." /> + + + + + + +## 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..681d9b4c --- /dev/null +++ b/src/content/docs/use/overview.mdx @@ -0,0 +1,50 @@ +--- +title: Use Dusk +description: Choose a wallet, manage DUSK, stake, bridge between networks, and inspect transactions. +--- + +import { LinkCard, CardGrid } from '@astrojs/starlight/components'; + +Use Dusk through the Web Wallet for everyday account activity or the Rusk Wallet for command-line and operator workflows. + +## Start here + + + + + + + + +## Choose a wallet + +- Use the [Web Wallet](/learn/web-wallet/) for browser-based public and shielded transfers, migration, and bridge workflows. +- Use the [Rusk Wallet](/learn/rusk-wallet/) for command-line transactions and node-operator workflows. + +Never enter a recovery phrase after following a link from an untrusted message. Verify official links and [check Dusk team accounts](/learn/verify-team-account/) before acting on instructions. + +## 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/sidebars/siteSidebar.js b/src/sidebars/siteSidebar.js index d09f43d0..4c5d23cb 100644 --- a/src/sidebars/siteSidebar.js +++ b/src/sidebars/siteSidebar.js @@ -3,85 +3,128 @@ 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 and Partners", 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 Explorer", + 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: "Block Explorer", 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: "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: "Protocol Capabilities", + collapsed: true, + items: [ + { label: "Stake Abstraction", link: "/learn/hyperstaking" }, + { label: "Digital Identity", link: "/developer/digital-identity/protocol" }, ], }, { - label: "Contribute to Dusk", + label: "Contribute", + collapsed: true, items: [ { label: "Dusk Improvement Proposals", link: "/developer/contribute/dips" }, { label: "Grants Program", link: "/developer/contribute/grants" }, @@ -90,31 +133,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" }, ], }, ], From 037e563316747a3ff788e74b16407838cc973bd0 Mon Sep 17 00:00:00 2001 From: Hein Dauven Date: Tue, 14 Jul 2026 17:54:47 +0200 Subject: [PATCH 2/3] docs: document wallet and explorer options --- public/llms-full.txt | 5 +-- public/llms.txt | 5 +-- .../integrations/wallet-extension.md | 8 +++-- src/content/docs/learn/block-explorer.md | 21 +++++++++-- src/content/docs/learn/dusk-trade.md | 2 +- src/content/docs/learn/ecosystem.mdx | 7 +++- src/content/docs/use/dusk-wallet.md | 35 +++++++++++++++++++ src/content/docs/use/overview.mdx | 16 +++++---- src/sidebars/siteSidebar.js | 7 ++-- 9 files changed, 84 insertions(+), 22 deletions(-) create mode 100644 src/content/docs/use/dusk-wallet.md diff --git a/public/llms-full.txt b/public/llms-full.txt index f082d987..64202177 100644 --- a/public/llms-full.txt +++ b/public/llms-full.txt @@ -98,7 +98,7 @@ 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/ @@ -121,9 +121,10 @@ Relevant docs: ### Use Dusk - Use Dusk Overview: https://docs.dusk.network/use/overview/ +- Dusk Wallet: https://docs.dusk.network/use/dusk-wallet/ - 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/ +- 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/ diff --git a/public/llms.txt b/public/llms.txt index 6b00d595..19942c19 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -22,7 +22,7 @@ - [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. @@ -39,8 +39,9 @@ ## Use Dusk - [Use Dusk Overview](https://docs.dusk.network/use/overview/): find wallets, staking, bridge, migration, and explorer guides. +- [Dusk Wallet](https://docs.dusk.network/use/dusk-wallet/): install and use the official Chrome or Firefox wallet extension. - [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. +- [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. diff --git a/src/content/docs/developer/integrations/wallet-extension.md b/src/content/docs/developer/integrations/wallet-extension.md index 42c427ef..20e65aa9 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 [Dusk Wallet](/use/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: diff --git a/src/content/docs/learn/block-explorer.md b/src/content/docs/learn/block-explorer.md index cc6f7523..fb5f834e 100644 --- a/src/content/docs/learn/block-explorer.md +++ b/src/content/docs/learn/block-explorer.md @@ -1,9 +1,24 @@ --- -title: Block Explorer -description: Use the Dusk block explorer to look up transactions, blocks, and fees. +title: Explorers +description: Find official and community explorers for Dusk mainnet and testnet. --- -You can view transactions and blocks on the 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..fd213442 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) +- [Dusk Wallet](/use/dusk-wallet) diff --git a/src/content/docs/learn/ecosystem.mdx b/src/content/docs/learn/ecosystem.mdx index b55a7d03..05810d7a 100644 --- a/src/content/docs/learn/ecosystem.mdx +++ b/src/content/docs/learn/ecosystem.mdx @@ -26,7 +26,7 @@ Always do your own due diligence before using them. /> -## Tools & explorers +## Community tools and explorers + ## Infrastructure & partners diff --git a/src/content/docs/use/dusk-wallet.md b/src/content/docs/use/dusk-wallet.md new file mode 100644 index 00000000..fbbbebe3 --- /dev/null +++ b/src/content/docs/use/dusk-wallet.md @@ -0,0 +1,35 @@ +--- +title: Dusk Wallet +description: Install and use the official Dusk Wallet extension for Chrome or Firefox. +--- + +Dusk Wallet is the official self-custodial browser extension for the Dusk network. It stores encrypted wallet data locally and lets you manage DUSK or connect to compatible applications without handing custody to a hosted service. + +## Install Dusk Wallet + +Install the extension from the official listing for your browser: + +- [Dusk Wallet for Chrome](https://chromewebstore.google.com/detail/dusk-wallet/gcbboponngpmioapekmkajmffefaacld) +- [Dusk Wallet for Firefox](https://addons.mozilla.org/en-US/firefox/addon/dusk-wallet/) + +Before installing, check the extension name and URL against this page. A wallet extension can access sensitive account information, so do not install copies distributed through advertisements, direct messages, or unofficial download pages. + +## What you can do + +With Dusk Wallet, you can: + +- create or import a Dusk wallet; +- manage public and shielded DUSK; +- send and receive DUSK; +- connect to Dusk-compatible applications; and +- review and approve connection, transaction, and signature requests. + +Applications do not receive wallet access automatically. Review each connection or transaction prompt before approving it. + +## Other wallet options + +- The [Web Wallet](/learn/web-wallet/) is Dusk's official hosted browser interface for transfers, migration, and bridge workflows. +- The [Rusk Wallet](/learn/rusk-wallet/) is the official command-line wallet used for terminal and node-operator workflows. +- [Piewallet](https://chromewebstore.google.com/detail/piewallet/fpaajdmdhkhfedemboncmcmckkhnnike) is a community wallet offered by Piecrust for Pieswap and Dusk-compatible networks. It is not operated by Dusk; review its publisher, permissions, and support information independently before using it. + +Developers integrating wallet connections should start with [Dusk Connect](/developer/integrations/dusk-connect/). For extension-specific development details, see [Dusk Wallet integration](/developer/integrations/wallet-extension/). diff --git a/src/content/docs/use/overview.mdx b/src/content/docs/use/overview.mdx index 681d9b4c..b9986f06 100644 --- a/src/content/docs/use/overview.mdx +++ b/src/content/docs/use/overview.mdx @@ -5,15 +5,15 @@ description: Choose a wallet, manage DUSK, stake, bridge between networks, and i import { LinkCard, CardGrid } from '@astrojs/starlight/components'; -Use Dusk through the Web Wallet for everyday account activity or the Rusk Wallet for command-line and operator workflows. +Use Dusk through the Dusk Wallet browser extension or Web Wallet for everyday account activity. The Rusk Wallet supports command-line and operator workflows. ## Start here ## Choose a wallet +- Use [Dusk Wallet](/use/dusk-wallet/) for an official self-custodial browser extension that can connect to compatible Dusk applications. - Use the [Web Wallet](/learn/web-wallet/) for browser-based public and shielded transfers, migration, and bridge workflows. - Use the [Rusk Wallet](/learn/rusk-wallet/) for command-line transactions and node-operator workflows. +- [Piewallet](https://chromewebstore.google.com/detail/piewallet/fpaajdmdhkhfedemboncmcmckkhnnike) is a community wallet offered by Piecrust for Pieswap and Dusk-compatible networks. It is not operated by Dusk. -Never enter a recovery phrase after following a link from an untrusted message. Verify official links and [check Dusk team accounts](/learn/verify-team-account/) before acting on instructions. +Never enter a recovery phrase after following a link from an untrusted message. Install extensions only from a verified listing, review community software independently, and [check Dusk team accounts](/learn/verify-team-account/) before acting on instructions. ## Move DUSK diff --git a/src/sidebars/siteSidebar.js b/src/sidebars/siteSidebar.js index 4c5d23cb..258c667f 100644 --- a/src/sidebars/siteSidebar.js +++ b/src/sidebars/siteSidebar.js @@ -50,12 +50,13 @@ const siteSidebar = [ items: [ { label: "Overview", link: "/use/overview" }, { - label: "Wallets and Explorer", + label: "Wallets and Explorers", collapsed: true, items: [ + { label: "Dusk Wallet", link: "/use/dusk-wallet" }, { label: "Web Wallet", link: "/learn/web-wallet" }, { label: "Rusk Wallet", link: "/learn/rusk-wallet" }, - { label: "Block Explorer", link: "/learn/block-explorer" }, + { label: "Explorers", link: "/learn/block-explorer" }, ], }, { @@ -99,7 +100,7 @@ const siteSidebar = [ 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" }, ], }, From 11aa222120b916a9851b84e738063d1957d6df0d Mon Sep 17 00:00:00 2001 From: Hein Dauven Date: Tue, 14 Jul 2026 22:11:01 +0200 Subject: [PATCH 3/3] docs: consolidate wallet and ecosystem guidance --- astro.config.js | 3 + public/llms-full.txt | 8 +-- public/llms.txt | 3 +- src/content/docs/developer/duskvm/overview.md | 2 +- .../docs/developer/duskvm/quickstart.md | 2 +- .../docs/developer/duskvm/reference.md | 2 +- .../integrations/wallet-extension.md | 6 +- src/content/docs/learn/dusk-trade.md | 2 +- src/content/docs/learn/ecosystem.mdx | 51 ++++++++------ src/content/docs/learn/glossary.md | 4 +- src/content/docs/learn/overview.mdx | 4 +- src/content/docs/learn/rusk-wallet.md | 68 ------------------- src/content/docs/learn/web-wallet.md | 52 -------------- .../docs/operator/guides/node-wallet-setup.md | 4 +- src/content/docs/use/dusk-wallet.md | 35 ---------- src/content/docs/use/overview.mdx | 17 ++--- src/content/docs/use/wallets.md | 57 ++++++++++++++++ src/sidebars/siteSidebar.js | 6 +- 18 files changed, 115 insertions(+), 211 deletions(-) delete mode 100644 src/content/docs/learn/rusk-wallet.md delete mode 100644 src/content/docs/learn/web-wallet.md delete mode 100644 src/content/docs/use/dusk-wallet.md create mode 100644 src/content/docs/use/wallets.md 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 64202177..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,7 +86,7 @@ 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/ @@ -121,9 +121,7 @@ Relevant docs: ### Use Dusk - Use Dusk Overview: https://docs.dusk.network/use/overview/ -- Dusk Wallet: https://docs.dusk.network/use/dusk-wallet/ -- Web Wallet: https://docs.dusk.network/learn/web-wallet/ -- Rusk Wallet: https://docs.dusk.network/learn/rusk-wallet/ +- 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/ diff --git a/public/llms.txt b/public/llms.txt index 19942c19..864712d9 100644 --- a/public/llms.txt +++ b/public/llms.txt @@ -39,8 +39,7 @@ ## Use Dusk - [Use Dusk Overview](https://docs.dusk.network/use/overview/): find wallets, staking, bridge, migration, and explorer guides. -- [Dusk Wallet](https://docs.dusk.network/use/dusk-wallet/): install and use the official Chrome or Firefox wallet extension. -- [Web Wallet](https://docs.dusk.network/learn/web-wallet/): use Dusk in the browser. +- [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. 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 20e65aa9..beca0ca7 100644 --- a/src/content/docs/developer/integrations/wallet-extension.md +++ b/src/content/docs/developer/integrations/wallet-extension.md @@ -3,7 +3,7 @@ title: Dusk Wallet Integration description: Connect applications to the official Dusk Wallet extension and its provider API. --- -This page is for developers integrating with or building the Dusk Wallet extension. For installation and user guidance, see [Dusk Wallet](/use/dusk-wallet/). +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. @@ -15,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 @@ -82,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/learn/dusk-trade.md b/src/content/docs/learn/dusk-trade.md index fd213442..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](/use/dusk-wallet) +- [Wallets](/use/wallets) diff --git a/src/content/docs/learn/ecosystem.mdx b/src/content/docs/learn/ecosystem.mdx index 05810d7a..aab2eab9 100644 --- a/src/content/docs/learn/ecosystem.mdx +++ b/src/content/docs/learn/ecosystem.mdx @@ -1,52 +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 + -## Community tools and 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/use/dusk-wallet.md b/src/content/docs/use/dusk-wallet.md deleted file mode 100644 index fbbbebe3..00000000 --- a/src/content/docs/use/dusk-wallet.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Dusk Wallet -description: Install and use the official Dusk Wallet extension for Chrome or Firefox. ---- - -Dusk Wallet is the official self-custodial browser extension for the Dusk network. It stores encrypted wallet data locally and lets you manage DUSK or connect to compatible applications without handing custody to a hosted service. - -## Install Dusk Wallet - -Install the extension from the official listing for your browser: - -- [Dusk Wallet for Chrome](https://chromewebstore.google.com/detail/dusk-wallet/gcbboponngpmioapekmkajmffefaacld) -- [Dusk Wallet for Firefox](https://addons.mozilla.org/en-US/firefox/addon/dusk-wallet/) - -Before installing, check the extension name and URL against this page. A wallet extension can access sensitive account information, so do not install copies distributed through advertisements, direct messages, or unofficial download pages. - -## What you can do - -With Dusk Wallet, you can: - -- create or import a Dusk wallet; -- manage public and shielded DUSK; -- send and receive DUSK; -- connect to Dusk-compatible applications; and -- review and approve connection, transaction, and signature requests. - -Applications do not receive wallet access automatically. Review each connection or transaction prompt before approving it. - -## Other wallet options - -- The [Web Wallet](/learn/web-wallet/) is Dusk's official hosted browser interface for transfers, migration, and bridge workflows. -- The [Rusk Wallet](/learn/rusk-wallet/) is the official command-line wallet used for terminal and node-operator workflows. -- [Piewallet](https://chromewebstore.google.com/detail/piewallet/fpaajdmdhkhfedemboncmcmckkhnnike) is a community wallet offered by Piecrust for Pieswap and Dusk-compatible networks. It is not operated by Dusk; review its publisher, permissions, and support information independently before using it. - -Developers integrating wallet connections should start with [Dusk Connect](/developer/integrations/dusk-connect/). For extension-specific development details, see [Dusk Wallet integration](/developer/integrations/wallet-extension/). diff --git a/src/content/docs/use/overview.mdx b/src/content/docs/use/overview.mdx index b9986f06..64e26708 100644 --- a/src/content/docs/use/overview.mdx +++ b/src/content/docs/use/overview.mdx @@ -5,15 +5,15 @@ description: Choose a wallet, manage DUSK, stake, bridge between networks, and i import { LinkCard, CardGrid } from '@astrojs/starlight/components'; -Use Dusk through the Dusk Wallet browser extension or Web Wallet for everyday account activity. The Rusk Wallet supports command-line and operator workflows. +Start with [Wallets](/use/wallets/) to choose between the official browser extension, Web Wallet, command-line wallet, and community alternatives. ## Start here -## Choose a wallet - -- Use [Dusk Wallet](/use/dusk-wallet/) for an official self-custodial browser extension that can connect to compatible Dusk applications. -- Use the [Web Wallet](/learn/web-wallet/) for browser-based public and shielded transfers, migration, and bridge workflows. -- Use the [Rusk Wallet](/learn/rusk-wallet/) for command-line transactions and node-operator workflows. -- [Piewallet](https://chromewebstore.google.com/detail/piewallet/fpaajdmdhkhfedemboncmcmckkhnnike) is a community wallet offered by Piecrust for Pieswap and Dusk-compatible networks. It is not operated by Dusk. - -Never enter a recovery phrase after following a link from an untrusted message. Install extensions only from a verified listing, review community software independently, and [check Dusk team accounts](/learn/verify-team-account/) before acting on instructions. - ## Move DUSK | Goal | Guide | 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 258c667f..8f64e8b8 100644 --- a/src/sidebars/siteSidebar.js +++ b/src/sidebars/siteSidebar.js @@ -31,7 +31,7 @@ const siteSidebar = [ collapsed: true, items: [ { label: "Tokenomics", link: "/learn/tokenomics" }, - { label: "Ecosystem and Partners", link: "/learn/ecosystem" }, + { label: "Ecosystem", link: "/learn/ecosystem" }, ], }, { @@ -53,9 +53,7 @@ const siteSidebar = [ label: "Wallets and Explorers", collapsed: true, items: [ - { label: "Dusk Wallet", link: "/use/dusk-wallet" }, - { 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" }, ], },