Merge pull request #125 from dusk-network/docs/market-infrastructure-content

Add market infrastructure, Connect and llm content

Author: HDauven

public/llms-full.txt

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

public/llms.txt

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

src/content/docs/developer/integrations/dusk-connect.md

@@ -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)

src/content/docs/developer/integrations/wallet-extension.md

@@ -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)