DogepartyXDP · ShibeFaceSkrill · Jun 28, 2022 · Jun 28, 2022 · Jun 28, 2022 · Jun 28, 2022
diff --git a/Basics/FAQ-XDP.md b/Basics/FAQ-XDP.md
@@ -1,11 +1,16 @@
-What is XDP?
-=====================
+# What is XDP?
+
+- [How was XDP launched in 2014?](#how-was-xdp-launched-in-2014)
+- [How was XDP re-launched in 2021?](#how-was-xdp-re-launched-in-2021)
+- [Is XDP an alt-coin or competitor to Dogecoin?](#is-xdp-an-alt-coin-or-competitor-to-dogecoin)
+- [Can more XDP be created?](#can-more-xdp-be-created)
+- [What is XDP used for?](#what-is-xdp-used-for)
 
 XDP is the native token of Dogeparty. It is a technical necessity for adding advanced features to Dogeparty, which by nature require a protocol aware currency. Dogecoin can only be aware of DOGE, while Dogeparty can be aware of both DOGE and XDP itself. This makes it possible to escrow funds, trade in a decentralized manner, and harness the full potential of programmable money.
 
 _Note: It is a common misconception that XDP is a competitor to Dogecoin, when in fact it cannot exist without it. And even though XDP is not a traditional currency, it serves a steady and critical purpose within the Dogeparty ecosystem._
 
-### How was XDP launched in 2014?
+#### How was XDP launched in 2014?
 
 The supply of XDP was created in a process called 'proof-of-burn' that lasted from August 13th to September 17th 2014 (43,200 Dogecoin blocks). During this period, anyone was able to exchange Dogecoins for XDP automatically on a protocol level under the following conditions:
 
@@ -27,27 +32,24 @@ Since the DOGE on the burn address will never be spendable again, they are consi
 * Full transparency
 * Zero pre-mine
 
-### How was XDP re-launched in 2021?
+#### How was XDP re-launched in 2021?
 
 The supply of XDP was re-launched in a process called 'proof-of-bern' that lasted from September 1st to November 1st 2021 (86,400 Dogecoin blocks). During this period, anyone was able to exchange Dogecoins for XDP automatically on a protocol level under the following conditions:
 
 * Users sent their DOGE to the community fund Dogecoin address via the "bern" process in a dogeparty compatible wallet. ([DParty4kWgih7MpTUivMn1icgC5x7fxALP](https://dogeparty.xchain.io/burns))
-
 * Each 10 DOGE was automatically exchanged for a number of XDP between 1 and 1.5, with more being rewarded the earlier the burn took place.
-
 * The reward bonus decreased linearily with the block index.
-
 * Each address was limited to 1 Million DOGE.
 
-### Is XDP an alt-coin or competitor to Dogecoin?
+#### Is XDP an alt-coin or competitor to Dogecoin?
 
 No. XDP cannot exist without Dogecoin, as Dogeparty extends the basic features of Dogecoin with proof-of-publication, oracle betting, decentralized exchange, automatic escrow, and order matching. 
 
-### Can more XDP be created?
+#### Can more XDP be created?
 
 No. The supply of XDP is fixed after the re-launch in 2021, and decreasing because of fees being burned.
 
-### What is XDP used for?
+#### What is XDP used for?
 
 XDP is the fuel for certain functions within the Dogeparty protocol such as issuing assets and subassets, sweeps, dividends, etc. Appropriately enough, this fuel is **burned** (destroyed). This means that the supply of XDP is continously decreasing. However, the cost of fuel adjusts proportionally as the supply of XDP goes down, so that it cannot reach 0.
 

diff --git a/Basics/FAQ.md b/Basics/FAQ.md
@@ -1,88 +1,103 @@
-Frequently Asked Questions
-========
-
-[TOC]
-
-### How does Dogeparty work?
+# Frequently Asked Questions
+
+- [How does Dogeparty work?](#how-does-dogeparty-work)
+- [So Dogeparty is not its own Blockchain, but "rides on top of" Dogecoin?](#so-dogeparty-is-not-its-own-blockchain-but-rides-on-top-of-dogecoin)
+- [Is Dogeparty "polluting" the Dogecoin blockchain, then?](#is-dogeparty-polluting-the-dogecoin-blockchain-then)
+- [Are Dogeparty transactions less secure than Dogecoin transactions?](#are-dogeparty-transactions-less-secure-than-dogecoin-transactions)
+- [How do the Dogeparty nodes stay in sync? What's to stop one node from disagreeing with another?](#how-do-the-dogeparty-nodes-stay-in-sync-whats-to-stop-one-node-from-disagreeing-with-another)
+- [What about Sidechains?](#what-about-sidechains)
+- [What kind of addresses does Dogeparty use?](#what-kind-of-addresses-does-dogeparty-use)
+- [What is XDP?](#what-is-xdp)
+- [Can I secure my XDP and tokens in cold storage?](#can-i-secure-my-xdp-and-tokens-in-cold-storage)
+- [Is a 51% attack against Dogeparty possible?](#is-a-51-attack-against-dogeparty-possible)
+- [Besides a 51% attack, what are the other risks to consensus?](#besides-a-51-attack-what-are-the-other-risks-to-consensus)
+- [So can the Dogeparty Team rewrite the Dogeparty ledger’s history, in an emergency or by decree? How does that compare to the same risks with Dogecoin Core devs?](#so-can-the-dogeparty-team-rewrite-the-dogeparty-ledgers-history-in-an-emergency-or-by-decree-how-does-that-compare-to-the-same-risks-with-dogecoin-core-devs)
+- [What about support for other blockchains instead of Dogecoin?](#what-about-support-for-other-blockchains-instead-of-dogecoin)
+- [What is Dogecoin fails or becomes co-opted?](#what-is-dogecoin-fails-or-becomes-co-opted)
+- [What happens if and when OP_RETURN data is auto-pruned?](#what-happens-if-and-when-op_return-data-is-auto-pruned)
+- [How are blockchain reorganizations ("reorgs") handled by Dogeparty?](#how-are-blockchain-reorganizations-reorgs-handled-by-dogeparty)
+- [How can a thin client trustlessly lookup the Dogecoin public address associated with the OSTOCK asset name?](#how-can-a-thin-client-trustlessly-lookup-the-dogecoin-public-address-associated-with-the-ostock-asset-name)
+
+#### How does Dogeparty work?
 
 Dogeparty embeds data into regular Dogecoin transactions. To a regular Dogecoin client, these transactions look like normal Dogecoin transactions. A Dogeparty node (which runs the Dogecoin client along with [the Dogeparty client software](https://github.com/DogepartyXDP/dogeparty-lib)) will recognize and interpret the data in these Dogecoin transactions based on specific rules. From this, it constructs its own ledger of Dogeparty transactions that it has seen on the Dogecoin network.
 
 To better help understand this, [here](https://dogeparty.xchain.io/tx/3515b1da00d86731c5e38a30176ca464bbcba785bc11155afa6c748a155bd218) is a record of a Dogeparty transaction where one address is sending 1 JDOG token to another address. [Here](https://chain.so/tx/DOGE/3515b1da00d86731c5e38a30176ca464bbcba785bc11155afa6c748a155bd218) is what this transaction looks like to chain.so, a popular Dogecoin block explorer. You can see that while it is indeed a Dogecoin transaction, the amount of Dogecoin moved is small. In reality, the DOGE spent is just enough to compensate the Dogecoin miners to include the transaction in a block. Essentially, the user that sent the transaction is paying the Dogecoin network to record and secure this embedded Dogeparty data.
 
-### So Dogeparty is not its own Blockchain, but "rides on top of" Dogecoin?
+#### So Dogeparty is not its own Blockchain, but "rides on top of" Dogecoin?
 
 Yes. Another way to think of it is similar to a [Russian nesting doll](https://en.wikipedia.org/wiki/Matryoshka_doll), where the bigger doll would be the Dogecoin transaction, and the next doll (inside of it) would be a Dogeparty transaction.
 
 This embedding method is technically known as **embedded consensus**.
 
-### Is Dogeparty "polluting" the Dogecoin blockchain, then?
+#### Is Dogeparty "polluting" the Dogecoin blockchain, then?
 
 No. 99%+ of Dogeparty transactions utilize a data encoding method called `OP_RETURN`, which is fully "prunable", meaning that the data may be safely discarded by Dogecoin nodes which wish to do so. For the remaining 1% of transactions, an different encoding method is utilized that produces fully "spendable" outputs. These outputs do not stick around in the critical list of unspent outputs (the "UTXO set").
 
 On top of this, every Dogeparty transaction pays a fair fee to the network for inclusion.
 
-### Are Dogeparty transactions less secure than Dogecoin transactions?
+#### Are Dogeparty transactions less secure than Dogecoin transactions?
 
 As Dogeparty transactions _are_ Dogecoin transactions, their data is proably just as secure as any other Dogecoin transaction.
 
-### How do the Dogeparty nodes stay in sync? What's to stop one node from disagreeing with another?
+#### How do the Dogeparty nodes stay in sync? What's to stop one node from disagreeing with another?
 
 As all Dogeparty nodes run the same code, and all receive the same Dogecoin transaction data, the ledgers across each node match exactly. Dogeparty nodes are not like Dogecoin nodes in that they don't communicate with each other: they simply connect to the Dogecoin software and download transactions from it, decoding each one as they go along. In this way, the immense security and computing power behind Dogecoin is leveraged as the "transport network" for Dogeparty data.
 
 Given the above, there is no "Dogeparty peer to peer network" like there is a "Dogecoin peer-to-peer network": Dogeparty-aware nodes comprise a subset of the Dogecoin full nodes in existance.
 
-### What about Sidechains?
+#### What about Sidechains?
 
 Dogeparty is optimal for mainly lower value transactions and greatly benefits from the speed and cost of the main chain. However, if sidechains are ever released for dogecoin, there is no reason that they couldn't be made to work with Dogeparty. This is the beauty of Dogeparty's embedded consensus technology -- it can work with just about any blockchain out there, including sidechain designs.
 
-### What kind of addresses does Dogeparty use?
+#### What kind of addresses does Dogeparty use?
 
 _Exactly_ the same Dogecoin addresses we all know and love. As such, Dogeparty tokens (such as XDP, JDOG, BACON, and more) may be sent to _any_ Dogecoin address.
 
-### What is XDP?
+#### What is XDP?
 
 XDP is the native token of Dogeparty. It is a technical necessity for adding advanced features to Dogeparty, which by nature require a protocol aware currency. Dogecoin can only be aware of DOGE, while Dogeparty can be aware of both DOGE and XDP itself. This makes it possible to escrow funds, trade in a decentralized manner, and harness the full potential of programmable money.
 
 *To learn more about XDP, see [about XDP](FAQ-XDP.md).*
 
-### Can I secure my XDP and tokens in cold storage?
+#### Can I secure my XDP and tokens in cold storage?
 
 Yes. You can make a regular Dogecoin paper wallet and store them there. Later, you can sweep the funds into a [Dogeparty wallet](https://dogeparty.net/wallets/), like Dogewallet.
 
-### Is a 51% attack against Dogeparty possible?
+#### Is a 51% attack against Dogeparty possible?
 
 As every Dogeparty transaction is a Dogecoin transaction, to do a "51% attack" on Dogeparty you would have to do a 51% attack on Dogecoin.
 
-### Besides a 51% attack, what are the other risks to consensus?
+#### Besides a 51% attack, what are the other risks to consensus?
 
 The Dogeparty network could be effectively "forked" by a sizable number of people running different versions of the Dogeparty client that had different "consensus sensitive code" (i.e. protocol code). In this case, if a transaction was read in from the Dogecoin client software, the differing code may cause two different interpretations of the data, and thus, two different ledger states.
 
 As long as all participants run software that has the same protocol rules (even if it is different Dogeparty client implementations), this situation will not happen. The reference client includes extensive safeguards that help detect and prevent this from happening.
 
 That being said, [the Dogeparty client](https://github.com/DogepartyXDP/dogeparty-lib) is completely open-source. Anyone is able to copy the code and make their own modifications. They can then run their modified version of the software, which technically may generate a different ledger than everyone else. This is similar to Dogecoin itself. However, to have any impact, that person would have to get others to run it, who would have to trust this individual more than they trust the Dogeparty development team. This new ledger would not be "Dogeparty". It would be a separate ledger with its own protocol rules. Services built on this ledger (such as a block explorer) would not agree with similar services built on the Dogeparty ledger.
 
-### So can the Dogeparty Team rewrite the Dogeparty ledger’s history, in an emergency or by decree? How does that compare to the same risks with Dogecoin Core devs?
+#### So can the Dogeparty Team rewrite the Dogeparty ledger’s history, in an emergency or by decree? How does that compare to the same risks with Dogecoin Core devs?
 
 It’s identical to the case with Dogecoin. The Dogecoin core devs could publish a copy of Dogecoin Core that does anything, but no one would download it.
 
 Dogeparty is 100% open source, with [a list of code changes](https://github.com/DogepartyXDP/dogeparty-lib/releases) from one release to the next visible for all to see and inspect.
 
-### What about support for other blockchains instead of Dogecoin?
+#### What about support for other blockchains instead of Dogecoin?
 
 Dogeparty is built on Dogecoin. That has always been the case and we do not see it changing, ever. For other blockchains, there are "forks" of the Dogeparty software. Examples would be Counterparty for Bitcoin, Monaparty for Monacoin, and Dogeparty for Dogecoin. We generally encourage forks on other blockchains, especially if they help contribute back bug fixes and enhancements to the main Dogeparty codebase.
 
-### What is Dogecoin fails or becomes co-opted?
+#### What is Dogecoin fails or becomes co-opted?
 
 In the event of a catastrophic failure of the Dogecoin network, Dogeparty _does_ have the technical capability of "freezing" balances and migrating to another blockchain, like Litecoin for instance, with relative ease.
 
-### What happens if and when OP_RETURN data is auto-pruned?
+#### What happens if and when OP_RETURN data is auto-pruned?
 
 Dogeparty only needs some Dogecoin full nodes somewhere to have an unpruned copy of the blockchain. As every Dogeparty full node is also a Dogecoin full node, this is easily done.
 
-### How are blockchain reorganizations ("reorgs") handled by Dogeparty?
+#### How are blockchain reorganizations ("reorgs") handled by Dogeparty?
 
 Blockchain reorganizations are essentially handled by Dogeparty the same way they are handled by Dogecoin. If the Dogeparty software detects that a reorganization has occurred, it will utilize an internal "undolog" to quickly undo (roll back) transactions up to the point of the chain branching, and then process new transactions on the now-longest chain.
 
-### How can a thin client trustlessly lookup the Dogecoin public address associated with the OSTOCK asset name?
+#### How can a thin client trustlessly lookup the Dogecoin public address associated with the OSTOCK asset name?
 
 You can use a local copy of the blockchain just fine. The only difference between Dogeparty and Dogecoin here is that Dogeparty doesn’t support SPV. 
diff --git a/Basics/README.md b/Basics/README.md
@@ -0,0 +1,53 @@
+# Dogeparty Documentation: Basics
+
+## Frequently Asked Questions
+
+- [How does Dogeparty work?](FAQ.md#how-does-dogeparty-work)
+- [So Dogeparty is not its own Blockchain, but "rides on top of" Dogecoin?](FAQ.md#so-dogeparty-is-not-its-own-blockchain-but-rides-on-top-of-dogecoin)
+- [Is Dogeparty "polluting" the Dogecoin blockchain, then?](FAQ.md#is-dogeparty-polluting-the-dogecoin-blockchain-then)
+- [Are Dogeparty transactions less secure than Dogecoin transactions?](FAQ.md#are-dogeparty-transactions-less-secure-than-dogecoin-transactions)
+- [How do the Dogeparty nodes stay in sync? What's to stop one node from disagreeing with another?](FAQ.md#how-do-the-dogeparty-nodes-stay-in-sync-whats-to-stop-one-node-from-disagreeing-with-another)
+- [What about Sidechains?](FAQ.md#what-about-sidechains)
+- [What kind of addresses does Dogeparty use?](FAQ.md#what-kind-of-addresses-does-dogeparty-use)
+- [What is XDP?](FAQ.md#what-is-xdp)
+- [Can I secure my XDP and tokens in cold storage?](FAQ.md#can-i-secure-my-xdp-and-tokens-in-cold-storage)
+- [Is a 51% attack against Dogeparty possible?](FAQ.md#is-a-51-attack-against-dogeparty-possible)
+- [Besides a 51% attack, what are the other risks to consensus?](FAQ.md#besides-a-51-attack-what-are-the-other-risks-to-consensus)
+- [So can the Dogeparty Team rewrite the Dogeparty ledger’s history, in an emergency or by decree? How does that compare to the same risks with Dogecoin Core devs?](FAQ.md#so-can-the-dogeparty-team-rewrite-the-dogeparty-ledgers-history-in-an-emergency-or-by-decree-how-does-that-compare-to-the-same-risks-with-dogecoin-core-devs)
+- [What about support for other blockchains instead of Dogecoin?](FAQ.md#what-about-support-for-other-blockchains-instead-of-dogecoin)
+- [What is Dogecoin fails or becomes co-opted?](FAQ.md#what-is-dogecoin-fails-or-becomes-co-opted)
+- [What happens if and when OP_RETURN data is auto-pruned?](FAQ.md#what-happens-if-and-when-op_return-data-is-auto-pruned)
+- [How are blockchain reorganizations ("reorgs") handled by Dogeparty?](FAQ.md#how-are-blockchain-reorganizations-reorgs-handled-by-dogeparty)
+- [How can a thin client trustlessly lookup the Dogecoin public address associated with the OSTOCK asset name?](FAQ.md#how-can-a-thin-client-trustlessly-lookup-the-dogecoin-public-address-associated-with-the-ostock-asset-name)
+
+## What is XDP?
+
+- [How was XDP launched in 2014?](FAQ-XDP.md#how-was-xdp-launched-in-2014)
+- [How was XDP re-launched in 2021?](FAQ-XDP.md#how-was-xdp-re-launched-in-2021)
+- [Is XDP an alt-coin or competitor to Dogecoin?](FAQ-XDP.md#is-xdp-an-alt-coin-or-competitor-to-dogecoin)
+- [Can more XDP be created?](FAQ-XDP.md#can-more-xdp-be-created)
+- [What is XDP used for?](FAQ-XDP.md#what-is-xdp-used-for)
+
+## Assets
+
+- [Creating assets](assets.md#creating-assets)
+  - [The different kinds of assets](assets.md#the-different-kinds-of-assets)
+  - [Sending assets (`send`)](assets.md#sending-assets-send)
+  - [Paying dividends on assets](assets.md#paying-dividends-on-assets)
+- [Trading on the decentralized exchange](assets.md#trading-on-the-decentralized-exchange)
+  - [Creating an order](assets.md#creating-an-order)
+  - [Protocol-based trustless escrow](assets.md#protocol-based-trustless-escrow)
+  - [Automatic order matching on the Dogecoin blockchain](assets.md#automatic-order-matching-on-the-dogecoin-blockchain)
+- [A straightforward case](assets.md#a-straightforward-case)
+  - [Matching an order: partially fulfilling an order](assets.md#matching-an-order-partially-fulfilling-an-order)
+  - [Trading DOGE on the decentralized exchange](assets.md#trading-doge-on-the-decentralized-exchange)
+- [Use-cases](assets.md#use-cases)
+    - [Betting](assets.md#betting)
+    - [Tickets & Coupons](assets.md#tickets--coupons)
+    - [Token Controlled Access (TCA)](assets.md#token-controlled-access-tca)
+    - [Proof of Publication](assets.md#proof-of-publication)
+    - [Crowdfunding](assets.md#crowdfunding)
+    - [Derivatives](assets.md#derivatives)
+    - [In-game Currency](assets.md#in-game-currency)
+    - [Altcoin Migration](assets.md#altcoin-migration)
+    - [Verifiable Voting](assets.md#verifiable-voting)