Skip to content

Commit 2a11238

Browse files
authored
Merge pull request #120 from dusk-network/docs/further-simplification
docs: simplify About Dusk + staking/tokenomics
2 parents 46bec77 + f61f739 commit 2a11238

28 files changed

Lines changed: 471 additions & 925 deletions

astro.config.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ export default defineConfig({
2727
'/learn/deep-dive/assets-and-regulations/mica': '/learn/deep-dive/assets-and-regulations',
2828
'/learn/deep-dive/assets-and-regulations/lifecycle': '/learn/deep-dive/assets-and-regulations',
2929
'/learn/deep-dive/assets-and-regulations/dematerialization': '/learn/deep-dive/assets-and-regulations',
30+
'/learn/deep-dive/economic-protocol': '/learn/tokenomics',
3031
'/learn/wallet-terminology': '/learn/glossary',
3132
'/developer/integrations/hashing-algorithms': '/developer/integrations/reference',
3233
'/developer/integrations/addresses': '/developer/integrations/reference',

src/components/ResourceLinksGrid.astro

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,9 @@ import { LinkCard, CardGrid } from "@astrojs/starlight/components";
1414
description="Check out Dusk's privacy-preserving self-sovereign identity protocol."
1515
/>
1616
<LinkCard
17-
title="Economic Protocol"
18-
href="/learn/deep-dive/economic-protocol"
19-
description="The economic protocol of Dusk encompasses the mechanisms enabling smart contract owners to create economic value through the services they offer."
17+
title="Tokenomics"
18+
href="/learn/tokenomics"
19+
description="Learn how DUSK is used for fees and staking, and how emissions and rewards work."
2020
/>
2121
<LinkCard
2222
title="Smart Contract Example"

src/content/docs/developer/integrations/exchanges.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,12 +72,12 @@ The [multisig contract](https://github.com/dusk-network/multisig-contract) conta
7272
## Token Details
7373

7474
- Token: `dusk`
75-
- Token decimals: `9` (18 decimals for ERC20 / BEP20 versions)
75+
- Token decimals: `9` (ERC20/BEP20 versions use 18 decimals)
7676
- Consensus mechanism: Succinct Attestation
7777

7878
## Token Migration (If Applicable)
7979

80-
Users can migrate ERC20/BEP20 DUSK to native DUSK using the [migration contract](https://github.com/dusk-network/dusk-migration) and the [Web Wallet](https://wallet.dusk.network/).
80+
Users can migrate ERC20/BEP20 DUSK to native DUSK using the [migration contract](https://github.com/dusk-network/dusk-migration) and the [Web Wallet](https://apps.dusk.network/wallet/).
8181

8282
More information: [/learn/guides/mainnet-migration](/learn/guides/mainnet-migration).
8383

src/content/docs/developer/smart-contracts-duskds.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ For JavaScript integration, use [w3sper](https://github.com/dusk-network/rusk/tr
173173

174174
## Deploying
175175

176-
To deploy a contract, use the [Rusk Wallet](https://github.com/dusk-network/rusk/tree/master/rusk-wallet/src/bin):
176+
To deploy a contract, use the [Rusk Wallet](/learn/rusk-wallet):
177177

178178
```bash
179179
rusk-wallet contract-deploy \
Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: Block Explorer
3-
description: Use the Dusk’s block explorer for looking at transaction details.
3+
description: Use the Dusk block explorer to look up transactions, blocks, and fees.
44
---
55

6-
Transactions can be viewed on the <a href="https://explorer.dusk.network/" target="_blank">Dusk Block Explorer</a>, along with statistics and information about the network.
6+
You can view transactions and blocks on the <a href="https://explorer.dusk.network/" target="_blank" rel="noreferrer">Dusk Block Explorer</a>.
77

88
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).
99

1010
For public [Moonlight](/learn/deep-dive/duskds-tx-models) transactions or other types of chain interactions, the visibility of transaction details depends on the contract implementation and whether developers use privacy technology like zero-knowledge proofs.
1111

12-
The block explorer can be used to view the type of transactions submitted, as well as the payload, transaction fee and gas used.
12+
The explorer can show the transaction type and metadata such as payload, fee, and gas used (depending on the transaction model and contract).
Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,51 @@
11
---
22
title: Get involved & Community
3-
description: An overview of Dusk socials and official channels. Here you can find information to join and get involved in Dusk.
3+
description: Official channels for updates and support, plus ways to contribute to the ecosystem and docs.
44
---
55

66
import { LinkCard, CardGrid } from '@astrojs/starlight/components';
77

8-
Welcome to the Dusk community section! Here, you can connect with us and join vibrant discussions about our technology and its applications. Your engagement and feedback are vital to our growth and success.
8+
Use the channels below to get updates, ask questions, and contribute.
99

10-
## Connect with Us
11-
12-
Get in touch with us. We are very happy to engage directly with our community and users. Don't shy away from shooting us a message in case you have questions, or simply to say hi!
10+
## Official channels
1311

1412
<CardGrid>
15-
<LinkCard title="Official Dusk Website" href="https://dusk.network" description="Home of Dusk, the protocol for Regulated And Decentralized Finance. News, use cases and team information can be found here."/>
16-
<LinkCard title="Discord (Duskcord)" href="https://discord.com/invite/dusk-official" description="Duskcord is where the more technical crowd hangs out. It is the best place to provide feedback, ask for help, and share your dApp ideas."/>
17-
<LinkCard title="Telegram" href="https://t.me/DuskNetwork" description="The community on Telegram never sleeps. This channel is moderated by the core team."/>
18-
<LinkCard title="Announcement" href="https://t.me/DuskAnnouncements" description="Annoucements and updates are posted in this read-only Telegram channel"/>
13+
<LinkCard
14+
title="Dusk website"
15+
href="https://dusk.network"
16+
description="News, use cases, and protocol information."
17+
/>
18+
<LinkCard
19+
title="Discord"
20+
href="https://discord.com/invite/dusk-official"
21+
description="Best place for technical support, integration questions, and feedback."
22+
/>
23+
<LinkCard
24+
title="Telegram"
25+
href="https://t.me/DuskNetwork"
26+
description="Read-only Telegram channel for official announcements."
27+
/>
28+
<LinkCard
29+
title="GitHub"
30+
href="https://github.com/dusk-network"
31+
description="Source code and issue trackers across the Dusk org."
32+
/>
1933
</CardGrid>
2034

21-
## Socials
35+
## Getting help
36+
37+
- For documentation fixes and requests, contribute in the docs repo: <a href="https://github.com/dusk-network/docs" target="_blank" rel="noreferrer">dusk-network/docs</a>.
38+
- For protocol/app questions, use Discord.
39+
- Be careful with DMs and links. Official channels will never ask for your seed phrase or private keys.
2240

23-
Want to stay up-to-date and learn more about Dusk? Keep an eye out on the following platforms:
41+
## Socials
2442

25-
- [Dusk Twitter](https://twitter.com/DuskFoundation)
43+
- [Dusk X(Twitter)](https://twitter.com/DuskFoundation)
2644
- [Dusk LinkedIn](https://www.linkedin.com/company/dusknetwork/)
2745
- [Dusk Youtube](https://www.youtube.com/c/DuskNetwork)
2846
- [Dusk Reddit](https://www.reddit.com/r/DuskNetwork/)
2947
- [Dusk Github](https://github.com/dusk-network)
3048

31-
## We'd Love to Hear from You!
32-
33-
Your feedback helps us improve. Feel free to suggest new ideas or report any issues through our website form [here](https://dusk.network/contact/).
34-
35-
## Join Dusk as a Node operator
49+
## Run a node
3650

37-
To ease you into the intricacies of Dusk, you might consider participating in node running: [run a Provisioner node](/operator/provisioner).
51+
Interested in helping secure the network? Start here: [Run a provisioner node](/operator/provisioner).
Lines changed: 34 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,61 +1,57 @@
11
---
22
title: Core Values
3-
description: Learn about Dusk’s decentralized Financial Market Infrastructure and how it provides privacy and regulatory compliance.
3+
description: "What Dusk optimizes for: regulated markets, privacy with selective disclosure, and deterministic settlement."
44
---
55

6-
## Vision
6+
This page summarizes the principles behind Dusk and the tradeoffs they imply.
7+
If you’re new, start with [Overview](/learn/overview) and then read [Core Components](/learn/core-components).
78

8-
Dusk's **vision** describes the desired state of our organization within a foreseeable timeframe and guides the direction of the business's efforts in a practical way. You can regard it as the objective of the organization and the lighthouse in planning and constantly reassessing the step in building a highly-effective strategic plan.
9+
## Principles
910

10-
:::tip[Dusk's vision]
11-
We envision a future where digital assets are seamlessly integrated into the decentralized global economy.
12-
:::
11+
### Regulated workflows, on-chain
1312

14-
It is worth expanding on some of the terminology of our *vision statement* and their significance for Dusk's overall strategy in advancing our [mission](#mission).
13+
Dusk is built for markets where rules are part of the product:
1514

16-
<details class="info">
17-
<summary>**More on Dusk's vision**</summary>
18-
💡 Dusk's vision significantly extends the *decentralized finance (DeFi)* focus horizon. The latter relates almost exclusively to a class of digital assets (i.e. utility tokens) alternative to, and non-overlapping with traditional asset-backed instruments. Instead, our vision extends the *DeFi principles* to the whole panoply of assets and, as such, it encompasses the entire ensemble of digital tokens, including those being **asset-backed**, i.e. **tokens representing ownership of real world goods or financial instruments, and as such regulated by the law**. The most emblematic of these assets are [securities](https://www.investopedia.com/terms/s/security.asp), and with *security tokens* we indicate their digital representation on the digital ledger technology (DLT) such as *blockchain*.
19-
</details>
15+
- eligibility and access controls
16+
- disclosure and reporting requirements
17+
- constraints like limits, holds, and transfer restrictions
2018

21-
:::note
22-
🔮 The term Decentralized Market Infrastructure (DeMI) refers to leveraging Distributed Ledger Technologies (DLTs) to create a protocol-based Financial Market Infrastructure, as opposed to traditional platform-based systems like Central Securities Depositories (CSDs). DeMI enhances the efficiency and reduces the costs of regulated financial markets.
23-
:::
19+
### Privacy with selective disclosure
2420

25-
## Ambition
21+
Dusk treats privacy as a protocol feature, not an application add-on:
2622

27-
:::tip[Dusk's ambition]
28-
A decentralized, privacy-preserving, and programmable financial market infrastructure.
29-
:::
23+
- confidential balances and transfers where needed
24+
- the ability to reveal information to authorized parties when required
3025

31-
The [DLT-R regime](https://www.ey.com/en_gr/tax/tax-alerts/regulation-eu-2022-858-on-distributed-ledger-technology-market-infrastructures) came into effect in June 2023. It is Dusk ambition to comply with the DLT-R regulation and enhance a licensed security exchange to operate under such exemption.
26+
For details, see [Cryptography](/learn/cryptography) and [Transaction Models](/learn/deep-dive/duskds-tx-models).
3227

33-
## Mission
28+
### Deterministic settlement
3429

35-
With **mission** we define Dusk organization’s *core purpose, focus, and aims*.
30+
Market infrastructure needs predictable finality. DuskDS is designed for fast, deterministic settlement suitable for regulated venues.
3631

37-
:::tip[Dusk's mission]
38-
We empower users to fully control their assets.
39-
:::
32+
### Modular architecture
4033

41-
This mission statement is short but dense in its significance. In its essence, Dusk enroots within the DeFi movement, insofar as aiming to return to the users the prerogative to be custodians of their own assets, and dispose of them as they see fit (within the confines of what the law allows).
34+
Dusk separates settlement from execution so you can match the right environment to each use case:
4235

43-
In fact, the ambition goes far beyond custodianship, as DeFi protocols provide the opportunity to augment digital assets with behaviours and characteristics that can be directly programmed within the assets themselves, and composed as the users sees fit. These behaviours are codified within the so called _smart contracts_.
36+
- DuskDS for consensus, settlement, and privacy-capable transaction models
37+
- DuskEVM for EVM-compatible application development
4438

45-
<details class="info">
46-
<summary>**More on DeFi advantages**</summary>
47-
💡 `DeFi` protocols uniquely allow for **user-centric composability of applications**, as well as **global liquidity aggregation** across the entirety of their ecosystem. This departs radically from the incumbent **platform-brokered** landscape, where financial services are siloed, interoperability is almost non-existent, and liquidity is fragmented.
48-
</details>
39+
## Vision
4940

50-
## Culture
41+
:::tip[Dusk's vision]
42+
Digital assets integrated into the decentralized global economy.
43+
:::
44+
45+
## Mission
5146

52-
At Dusk, we prioritize our core values of **integrity, communication, innovation, responsibility, and collaboration** in all of our endeavors.
47+
:::tip[Dusk's mission]
48+
Enable people and institutions to control and use their assets on-chain, within real-world constraints.
49+
:::
5350

54-
<details class="info">
55-
<summary>**More on Dusk's culture**</summary>
56-
💡 Dusk is a flat, community-oriented organization that is focused on advancing a novel networking protocol through a combination of pervasive knowledge sharing, an evolutionary development process, frequent communication, and joint ownership of all deliverables. We strive to tame complexity through these practices and to be a trusted and respected leader in the decentralized software industry.
51+
## Culture
5752

58-
We are committed to honesty, effective communication, and continuous innovation, and we take ownership of our tasks and responsibilities with a focus on excellence and the best interests of our users. We also value collaboration and teamwork, fostering a culture of mutual support and shared knowledge.
53+
We aim to be clear and rigorous in the way we build:
5954

60-
These values are integral to our identity as a company and our commitment to delivering high-quality decentralized software.
61-
</details>
55+
- write things down (docs, specs, and concrete examples)
56+
- prefer secure-by-design primitives over “bolt-on” complexity
57+
- keep developer UX practical (EVM where it helps, native where it matters)
Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,41 @@
11
---
22
title: Cryptography
3-
description: An overview of the cryptographic primitives used in Dusk.
3+
description: The main cryptographic building blocks behind Dusk’s privacy and verification.
44
---
55

6-
At the core of Dusk’s security model is a carefully curated suite of cryptographic primitives, many of which Dusk has helped pioneer. From the first Rust implementation of PLONK to research on PlonKup, FORT, and both the Reinforced Concrete hash and Poseidon Hash, Dusk has been pushing the state of the art to combine institutional-grade privacy with verifiable performance. Other building blocks such as BLS12-381, JubJub, Schnorr, sparse Merkle tree, and the PLONK proving system, form the low-level toolkit that powers Dusk.
6+
Dusk uses zero-knowledge proofs and elliptic curve cryptography to enable confidential transactions and selective disclosure.
7+
This page is a high-level map of the primitives you’ll see referenced across the docs.
78

8-
## Dusk primitives
9+
For protocol-level details and formal security arguments, refer to the [Dusk whitepaper](https://dusk-cms.ams3.digitaloceanspaces.com/Dusk_Whitepaper_2024_4db72f92a1.pdf) and the papers listed in [Additional Resources](/learn/deep-dive/additional-resources).
10+
11+
## Primitives used in Dusk
912

1013
![Elliptic Curves image](../../../assets/elliptic_curves.png)
1114

12-
At the foundation of Dusk’s architecture are the cryptographic primitives - BLS12_381, JubJub, Schnorr and Poseidon. These cryptography tools provide the robust security and privacy features of the network. Besides these, we also make use of our own Merkle tree implementation called dusk-merkle, and our own PLONK proving system.
15+
At the foundation of Dusk’s architecture are primitives like **BLS12-381**, **JubJub**, **Schnorr**, and **Poseidon**. Dusk also uses Merkle tree constructions and a PLONK-based proving stack.
1316

14-
### BLS12_381
17+
### BLS12-381
1518

16-
BLS12_381 is a pairing-friendly elliptic curve used within Dusk to enable aggregation of signatures, which significantly reduces the amount of data to be stored and transmitted over the network, improving overall efficiency of the blockchain. This curve is especially crucial in the context of zero-knowledge proofs, where it provides the backbone for secure and private transactions.
19+
BLS12-381 is a pairing-friendly elliptic curve used in many modern proof systems. In Dusk it appears as part of the zero-knowledge and signature stack.
1720

1821
### JubJub
1922

20-
JubJub is an elliptic curve specifically designed to enable fast, secure zero-knowledge proofs. This curve is utilized within Dusk for the construction of efficient zk-SNARKs, allowing transactions and contracts to maintain privacy and integrity without the need to reveal underlying data.
23+
JubJub is an elliptic curve that’s efficient in SNARK-friendly settings and is commonly used in privacy-preserving designs.
2124

2225
### Schnorr Signatures
2326

24-
Schnorr signatures are a type of digital signature scheme. They offer resistance against forgery. In Dusk, Schnorr signatures contribute significantly to securing user transactions and smart contract interactions. They ensure that only valid transactions are processed and added to the blockchain.
27+
Schnorr signatures are a signature scheme used for authentication and integrity. In Dusk they are part of the foundation for signing and verifying protocol actions.
2528

2629
### Poseidon
2730

28-
Poseidon is a cryptographic hash function specifically designed for use in zero-knowledge circuits. It is optimized for performance, security and data integrity within Dusk. By producing a unique hash value for every distinct input, it forms the heart of Dusk’s data structures, making it virtually impossible to alter transaction data once it’s included in the blockchain.
31+
Poseidon is a hash function designed to be efficient inside zero-knowledge circuits. It is commonly used for commitments and Merkle tree hashing in ZK applications.
2932

30-
### Dusk-Merkle
33+
### dusk-merkle
3134

32-
Dusk also includes a custom, sparse Merkle tree implementation that is agnostic to the choice of hash function. Merkle trees are a fundamental part of many blockchains, enabling efficient and secure verification of large data structures. The Dusk Merkle tree is designed for flexibility and performance, given it’s used in multiple locations like the stake and transfer contract, and Citadel.
33-
34-
### PLONK
35+
Dusk includes a sparse Merkle tree implementation (`dusk-merkle`). Merkle trees enable efficient membership proofs over large datasets and show up throughout blockchain systems.
3536

36-
PLONK is a versatile proof system developed to facilitate the implementation of zero-knowledge proofs. It forms the core of Dusk’s proof system, allowing efficient and private transactions on the network that are both small in proof size and fast to verify.
37+
### PLONK
3738

38-
With PLONK, developers can define custom and reusable circuits that can be integrated into Dusk based smart contracts.
39+
PLONK is a proving system used to build zero-knowledge proofs. In Dusk it underpins privacy-preserving transactions and protocols that require succinct, verifiable computation.
3940

40-
If you want the full cryptographic details and formal security arguments,
41-
refer to the [Dusk whitepaper](https://dusk-cms.ams3.digitaloceanspaces.com/Dusk_Whitepaper_2024_4db72f92a1.pdf) and the papers listed in
42-
[Additional Resources](/learn/deep-dive/additional-resources).
41+
With PLONK, developers can define reusable circuits and generate proofs that can be verified on-chain.

0 commit comments

Comments
 (0)