Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
136 changes: 136 additions & 0 deletions public/llms-full.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
# Dusk Docs Full Context

This file summarizes the public Dusk documentation for AI assistants, search systems, and readers that need a compact map of the docs.

## Positioning

Dusk is infrastructure for regulated digital assets and general finance. It is designed for workflows where issuers, venues, institutions, developers, and users need privacy, access controls, deterministic settlement, and selective disclosure.

Dusk should be understood as a stack:

- DuskDS: the Dusk L1 for consensus, settlement, data availability, native transaction models, and native execution.
- DuskEVM: an OP Stack-based EVM execution environment using DUSK as gas and DuskDS for settlement/data availability.
- DuskVM: the WASM execution environment for native Dusk smart contracts.
- Rusk: the Rust node implementation that runs DuskDS.
- Citadel: identity and access primitives for selective disclosure and regulated workflows.
- Dusk Connect: wallet discovery and account connection for Dusk applications.
- Dusk Trade: application-layer market infrastructure for tokenized financial assets.

## Key Concepts

### Regulated Market Workflows

Dusk is designed for workflows such as:

- regulated securities issuance
- investor onboarding and eligibility checks
- wallet binding and access controls
- secondary market transfers
- payment and settlement coordination
- servicing, reporting, corporate actions, and selective disclosure

Relevant docs:

- https://docs.dusk.network/learn/market-infrastructure/
- https://docs.dusk.network/learn/dusk-trade/
- https://docs.dusk.network/learn/tokenization-comparison/
- https://docs.dusk.network/learn/deep-dive/assets-and-regulations/

### Privacy with Selective Disclosure

Dusk supports confidential shielded transfers, public account flows, and selective disclosure patterns. The point is not to make every workflow hidden or every workflow public. Builders can decide which data should be public, which data should remain confidential, and which data should be disclosed to authorized parties.

Relevant docs:

- https://docs.dusk.network/learn/cryptography/
- https://docs.dusk.network/learn/deep-dive/duskds-tx-models/
- https://docs.dusk.network/developer/digital-identity/protocol/

### Transaction Models

DuskDS supports:

- Moonlight: transparent public account flows.
- Phoenix: confidential shielded transfers.

Relevant docs:

- https://docs.dusk.network/learn/deep-dive/duskds-tx-models/
- https://docs.dusk.network/learn/web-wallet/

### Execution Paths

Dusk has two main developer paths:

- DuskEVM: Solidity, EVM tooling, EVM wallets, Ethereum-compatible infrastructure.
- Native Dusk: general-purpose Rust/WASM contracts through DuskVM for protocol-level assets, native transaction models, custom execution, market logic, privacy, or zero-knowledge capabilities close to the settlement layer.

Relevant docs:

- https://docs.dusk.network/developer/overview/
- https://docs.dusk.network/learn/deep-dive/dusk-evm/
- https://docs.dusk.network/learn/deep-dive/dusk-vm/
- https://docs.dusk.network/developer/smart-contracts-dusk-evm/deploy-on-evm/
- https://docs.dusk.network/developer/smart-contracts-duskds/

## Important Pages

### Learn

- Overview: https://docs.dusk.network/learn/overview/
- Market Infrastructure: https://docs.dusk.network/learn/market-infrastructure/
- Dusk Trade: https://docs.dusk.network/learn/dusk-trade/
- 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/
- Tokenomics: https://docs.dusk.network/learn/tokenomics/
- Glossary: https://docs.dusk.network/learn/glossary/

### Developer

- Developer Overview: https://docs.dusk.network/developer/overview/
- Deploy on DuskEVM: https://docs.dusk.network/developer/smart-contracts-dusk-evm/deploy-on-evm/
- Smart Contracts on DuskDS: https://docs.dusk.network/developer/smart-contracts-duskds/
- Dusk Connect: https://docs.dusk.network/developer/integrations/dusk-connect/
- 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/
- 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

- Operator Overview: https://docs.dusk.network/operator/overview/
- Provisioner Node: https://docs.dusk.network/operator/provisioner/
- Archive Node: https://docs.dusk.network/operator/archive-node/
- Prover Node: https://docs.dusk.network/operator/prover/
- Networks: https://docs.dusk.network/operator/networks/
- Maintenance & Monitoring: https://docs.dusk.network/operator/maintenance-monitoring/
- Troubleshooting: https://docs.dusk.network/operator/troubleshooting/

### User Tools

- 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/

## Naming Guidance

Use:

- Dusk for the network/protocol/stack in general contexts.
- DuskDS for the Dusk L1, settlement, consensus, data availability, and native transaction models.
- DuskEVM for the EVM execution layer.
- DuskVM for native WASM smart contract execution.
- Moonlight for public account flows.
- Phoenix for shielded transfer flows.
- Privacy with selective disclosure for regulated privacy patterns.
- Access controls for eligibility, wallet binding, and transfer-rule patterns.

Avoid using “permissioned” to describe Dusk itself. If discussing restricted asset workflows, prefer “access-controlled”, “regulated”, or “eligible participant” unless specifically contrasting with closed permissioned systems.
42 changes: 42 additions & 0 deletions public/llms.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Dusk Docs

> Dusk is infrastructure for regulated digital assets and general finance. The docs explain how to build, integrate, and operate on Dusk across DuskDS, DuskEVM, DuskVM, Dusk Connect, Citadel, wallets, APIs, and node operations.

## Start Here

- [Overview](https://docs.dusk.network/learn/overview/): high-level introduction to Dusk.
- [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 on Dusk](https://docs.dusk.network/developer/overview/): choose between DuskEVM and native Dusk development.
- [Deploy on DuskEVM](https://docs.dusk.network/developer/smart-contracts-dusk-evm/deploy-on-evm/): deploy Solidity contracts on DuskEVM.
- [Smart Contracts on DuskDS](https://docs.dusk.network/developer/smart-contracts-duskds/): write Rust/WASM contracts for native Dusk execution.
- [Dusk Connect](https://docs.dusk.network/developer/integrations/dusk-connect/): integrate wallet discovery and account connection.
- [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.
- [W3sper SDK](https://docs.dusk.network/developer/integrations/w3sper/): SDK integration.

## Learn

- [Transaction Models](https://docs.dusk.network/learn/deep-dive/duskds-tx-models/): Moonlight public accounts and Phoenix shielded transfers.
- [DuskEVM](https://docs.dusk.network/learn/deep-dive/dusk-evm/): OP Stack-based EVM execution on Dusk.
- [DuskVM](https://docs.dusk.network/learn/deep-dive/dusk-vm/): WASM execution for native Dusk contracts.
- [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

- [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.
- [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

- [llms-full.txt](https://docs.dusk.network/llms-full.txt): expanded index and terminology for LLM retrieval.
50 changes: 50 additions & 0 deletions src/content/docs/developer/integrations/dusk-connect.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: Dusk Connect
description: Integrate Dusk wallet discovery and account connection into applications.
---

Dusk Connect is the wallet integration layer for Dusk applications. It gives dApps a consistent way to discover compatible wallets, request accounts, and build connection flows around Dusk accounts.

Use Dusk Connect when your application needs to:

- detect compatible Dusk wallet providers
- let users select a wallet
- request account access
- handle public and shielded account flows in a consistent UI
- integrate with Dusk wallet software without hardcoding one provider

## Where it fits

Dusk applications often need two kinds of integration:

- **Network integration**: read chain data, submit transactions, and observe events.
- **Wallet integration**: ask a user to connect an account and approve actions.

Dusk Connect is for the wallet side. For network APIs and transaction flow, see [Transaction Lifecycle](/developer/integrations/tx-lifecycle), [HTTP API](/developer/integrations/http-api), and [W3sper SDK](/developer/integrations/w3sper).

If you are testing against the first-party browser wallet, use the [Dusk Wallet Extension](/developer/integrations/wallet-extension) as one compatible provider.

## Typical flow

A dApp integration usually follows this shape:

1. Discover available Dusk wallet providers.
2. Show the user the compatible wallets.
3. Request account access from the selected wallet.
4. Store the active account and provider for the session.
5. Ask the wallet to approve transactions or account actions when needed.

The exact API depends on the version of Dusk Connect you integrate.

## Repository

The Dusk Connect SDK is developed in the Dusk Network GitHub organization:

- <a href="https://github.com/dusk-network/connect" target="_blank" rel="noreferrer">dusk-network/connect</a>

## Read next

- [Dusk Wallet Extension](/developer/integrations/wallet-extension)
- [Web Wallet](/learn/web-wallet)
- [Transaction Lifecycle](/developer/integrations/tx-lifecycle)
- [W3sper SDK](/developer/integrations/w3sper)
91 changes: 91 additions & 0 deletions src/content/docs/developer/integrations/wallet-extension.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
title: Dusk Wallet Extension
description: Use the Dusk Wallet browser extension as a first-party wallet for Dusk applications.
---

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.

Use the extension when you need:

- a browser wallet for Dusk accounts
- public and shielded account flows
- mainnet, testnet, devnet, or custom node support
- 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).

## How it fits with Dusk Connect

Dusk Connect is the SDK layer for wallet discovery and account connection. The Dusk Wallet extension is one wallet provider that can be discovered through that flow.

A typical dApp flow is:

1. Use Dusk Connect or provider discovery to find available Dusk wallets.
2. Let the user choose the Dusk Wallet extension.
3. Request account access.
4. Ask the wallet to approve account actions or transactions when needed.

See [Dusk Connect](/developer/integrations/dusk-connect) for the SDK-level integration path.

If you are building the application side, start with Dusk Connect. If you are testing or documenting the wallet-provider side, use this page together with the wallet provider API.

## Provider discovery

The extension announces an EIP-1193-style provider through Dusk discovery events. Dusk is not an EVM chain, so wallet methods use Dusk-specific names.

```js
const providers = [];

window.addEventListener("dusk:announceProvider", (event) => {
providers.push(event.detail);
});

window.dispatchEvent(new Event("dusk:requestProvider"));

const dusk = providers[0]?.provider;
const [account] = await dusk.request({ method: "dusk_requestAccounts" });

dusk.on("accountsChanged", console.log);
dusk.on("chainChanged", console.log);
```

For the canonical provider API, see the wallet repository:

- <a href="https://github.com/dusk-network/wallet/blob/main/docs/provider-api.md" target="_blank" rel="noreferrer">Dusk Wallet provider API</a>

## Install for development

The extension builds Chrome and Firefox targets from the same repository.

```bash
git clone https://github.com/dusk-network/wallet
cd wallet
npm install
```

For Chrome:

```bash
npm run build:chrome
```

Then load `dist/` as an unpacked extension in `chrome://extensions` with Developer mode enabled.

For Firefox:

```bash
npm run build:firefox
```

Then load `dist-firefox/` as a temporary add-on in `about:debugging`.

## Repository

- <a href="https://github.com/dusk-network/wallet" target="_blank" rel="noreferrer">dusk-network/wallet</a>

## Read next

- [Dusk Connect](/developer/integrations/dusk-connect)
- [Transaction Lifecycle](/developer/integrations/tx-lifecycle)
- [Web Wallet](/learn/web-wallet)
Loading
Loading