Move SDEX to Fundamentals

briwylde08 · briwylde08 · commit 6b42a29882f3 · 2025-07-29T10:06:07.000-06:00
diff --git a/docs/build/smart-contracts/example-contracts/liquidity-pool.mdx b/docs/build/smart-contracts/example-contracts/liquidity-pool.mdx
@@ -29,7 +29,7 @@ Soroban liquidity pools are exclusive to Soroban and cannot interact with built-
 
 Implementing a liquidity pool contract should be done cautiously. User funds are involved, so great care should be taken to ensure safety and transparency. The example here should _not_ be considered a ready-to-go contract. Please use it as a reference only.
 
-The Stellar network already has liquidity pool functionality built right in to the core protocol. [Learn more here](../../../learn/encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx).
+The Stellar network already has liquidity pool functionality built right in to the core protocol. [Learn more here](../../../learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx).
 
 :::
 
@@ -514,7 +514,7 @@ pub fn __constructor(e: Env, token_wasm_hash: BytesN<32>, token_a: Address, toke
 [creating its own `pool` token]: #creating-a-custom-pool-token-for-lp-shares
 [interacting with contracts for `token_a` and `token_b`]: #token-transfers-tofrom-the-lp-contract
 [`token` example contract]: ./tokens.mdx
-[lexicographical order]: ../../../learn/encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx#liquidity-pool-participation
+[lexicographical order]: ../../../learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx#liquidity-pool-participation
 
 ### A "Constant Product" Liquidity Pool
 
diff --git a/docs/data/indexers/build-your-own/ingest-sdk/README.mdx b/docs/data/indexers/build-your-own/ingest-sdk/README.mdx
@@ -20,7 +20,7 @@ Obtain the final state of [ledger entries](../../../../learn/fundamentals/stella
 Ledger entries are cryptographically signed as part of each ledger and therefore represent the trusted, cumulative state at a point in time for [assets](../../../../learn/fundamentals/stellar-data-structures/assets.mdx) related to an [account](../../../../learn/fundamentals/stellar-data-structures/accounts.mdx) or [contract](../../../../learn/fundamentals/contract-development/storage/persisting-data.mdx). Examples of asset types:
 
 - trustlines which hold token balances
-- offers which hold bid and asks on the [stellar network DEX](../../../../learn/encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx#sdex)
+- offers which hold bid and asks on the [stellar network DEX](../../../../learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx#sdex)
 - contract data which holds key/value stores for contracts
 
 ### Ledger Metadata
diff --git a/docs/learn/encyclopedia/sdex/README.mdx b/docs/learn/encyclopedia/sdex/README.mdx
diff --git a/docs/learn/encyclopedia/transactions-specialized/path-payments.mdx b/docs/learn/encyclopedia/transactions-specialized/path-payments.mdx
@@ -11,7 +11,7 @@ Account A sells XLM → [buy XLM / sell ETH → buy ETH / sell BTC → buy BTC /
 
 It is possible for path payments to fail if there are no viable exchange paths.
 
-For more information on the Stellar Decentralized Exchange and Liquidity Pools, see our [Liquidity on Stellar: SDEX and Liquidity Pools Encyclopedia Entry](../sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx)
+For more information on the Stellar Decentralized Exchange and Liquidity Pools, see our [Liquidity on Stellar: SDEX and Liquidity Pools Encyclopedia Entry](../../fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx).
 
 ## Operations
 
diff --git a/docs/learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx b/docs/learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx
@@ -1,7 +1,8 @@
 ---
 title: "Liquidity Pools on the Stellar DEX: Provide Liquidity and Enable Asset Swaps"
-sidebar_label: "Liquidity on Stellar: SDEX and Liquidity Pools"
+sidebar_label: "SDEX"
 description: "Learn how liquidity pools enable trading on the Stellar DEX. Understand how they work, provide liquidity, and enable decentralized asset swaps on the network."
+sidebar_position: 100
 ---
 
 # Liquidity on Stellar: SDEX & Liquidity Pools
@@ -16,11 +17,11 @@ This section is scoped specifically to liquidity regarding the AMM and SDEX buil
 
 Users can trade and convert assets on the Stellar network with the use of path payments through Stellar’s decentralized exchange and liquidity pools.
 
-In this section, we will talk about the SDEX and liquidity pools. To learn about how these work together to execute transactions, see our [Path Payments Encyclopedia Entry](../transactions-specialized/path-payments.mdx).
+In this section, we will talk about the SDEX and liquidity pools. To learn about how these work together to execute transactions, see our [Path Payments Encyclopedia Entry](../encyclopedia/transactions-specialized/path-payments.mdx).
 
 ## SDEX
 
-The Stellar network acts as a decentralized distributed exchange that allows users to trade and convert assets with the [Manage Buy Offer](../../../data/apis/horizon/api-reference/resources/operations/object/buy-offer.mdx) and [Manage Sell Offer](../../../data/apis/horizon/api-reference/resources/operations/object/sell-offer.mdx) operations. The Stellar ledger stores both the balances held by user accounts and orders that user accounts make to buy or sell assets.
+The Stellar network acts as a decentralized distributed exchange that allows users to trade and convert assets with the [Manage Buy Offer](../../data/apis/horizon/api-reference/resources/operations/object/buy-offer.mdx) and [Manage Sell Offer](../../data/apis/horizon/api-reference/resources/operations/object/sell-offer.mdx) operations. The Stellar ledger stores both the balances held by user accounts and orders that user accounts make to buy or sell assets.
 
 ### Order books
 
@@ -72,7 +73,7 @@ An account can place a passive sell order via the Create Passive Sell Offer oper
 
 The order price you set is independent of the fee you pay for submitting that order in a transaction. Fees are always paid in XLM, and you specify them as a separate parameter when submitting the order to the network.
 
-To learn more about transaction fees, see our section on [Fees section](../../fundamentals/fees-resource-limits-metering.mdx).
+To learn more about transaction fees, see our section on [Fees section](./fees-resource-limits-metering.mdx).
 
 ## Liquidity pools
 
diff --git a/docs/learn/fundamentals/stellar-data-structures/assets.mdx b/docs/learn/fundamentals/stellar-data-structures/assets.mdx
@@ -35,7 +35,7 @@ Classic assets on Stellar have two identifying characteristics: the asset code a
 
 An asset’s identifying code. There are three different formats: Alphanumeric 4, Alphanumeric 12, and liquidity pool shares.
 
-Learn about liquidity pool shares in the [Liquidity Pool Encyclopedia Entry](../../encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx).
+Learn about liquidity pool shares in the [Liquidity Pool section](../liquidity-on-stellar-sdex-liquidity-pools.mdx).
 
 Learn more about asset codes in the [Naming an Asset section](../../../tokens/control-asset-access.mdx#naming-an-asset)
 
diff --git a/docs/learn/fundamentals/stellar-data-structures/ledgers.mdx b/docs/learn/fundamentals/stellar-data-structures/ledgers.mdx
@@ -21,7 +21,7 @@ Data is stored on the ledger as ledger entries. Possible ledger entries include:
 
 - [Accounts](./accounts.mdx)
 - [Claimable balances](../../encyclopedia/transactions-specialized/claimable-balances.mdx)
-- [Liquidity pools](../../encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx)
+- [Liquidity pools](../liquidity-on-stellar-sdex-liquidity-pools.mdx)
 - [Contract data](../../fundamentals/contract-development/storage/persisting-data.mdx#ledger-entries)
 
 ## Ledger headers
diff --git a/docs/learn/fundamentals/transactions/list-of-operations.mdx b/docs/learn/fundamentals/transactions/list-of-operations.mdx
@@ -146,7 +146,7 @@ Learn more about path payments: [Path Payments Encyclopedia Entry](../../encyclo
 
 Creates, updates, or deletes an offer to buy a specific amount of an asset for another
 
-Learn more about passive sell offers: [Liquidity on Stellar: SDEX and Liquidity Pools](../../encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx)
+Learn more about passive sell offers: [Liquidity on Stellar: SDEX and Liquidity Pools](../liquidity-on-stellar-sdex-liquidity-pools.mdx)
 
 **SDKs**: [JavaScript](http://stellar.github.io/js-stellar-sdk/Operation.html#.manageBuyOffer) | [Java](https://github.com/lightsail-network/java-stellar-sdk/blob/master/src/main/java/org/stellar/sdk/operations/ManageBuyOfferOperation.java) | [Go](https://godoc.org/github.com/stellar/go/txnbuild#ManageBuyOffer)  
 **Threshold**: Medium  
@@ -180,7 +180,7 @@ Learn more about passive sell offers: [Liquidity on Stellar: SDEX and Liquidity
 
 Creates, updates, or deletes an offer to sell a specific amount of an asset for another
 
-Learn more about passive sell offers: [Liquidity on Stellar: SDEX and Liquidity Pools](../../encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx)
+Learn more about passive sell offers: [Liquidity on Stellar: SDEX and Liquidity Pools](../liquidity-on-stellar-sdex-liquidity-pools.mdx)
 
 **SDKs**: [JavaScript](http://stellar.github.io/js-stellar-sdk/Operation.html#.manageSellOffer) | [Java](https://github.com/lightsail-network/java-stellar-sdk/blob/master/src/main/java/org/stellar/sdk/operations/ManageSellOfferOperation.java) | [Go](https://godoc.org/github.com/stellar/go/txnbuild#ManageSellOffer)  
 **Threshold**: Medium  
@@ -214,7 +214,7 @@ Learn more about passive sell offers: [Liquidity on Stellar: SDEX and Liquidity
 
 Creates an offer to sell one asset for another without taking a reverse offer of equal price
 
-Learn more about passive sell offers: [Liquidity on Stellar: SDEX and Liquidity Pools](../../encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx)
+Learn more about passive sell offers: [Liquidity on Stellar: SDEX and Liquidity Pools](../liquidity-on-stellar-sdex-liquidity-pools.mdx)
 
 **SDKs**: [JavaScript](https://stellar.github.io/js-stellar-sdk/Operation.html#.createPassiveSellOffer) | [Java](https://github.com/lightsail-network/java-stellar-sdk/blob/master/src/main/java/org/stellar/sdk/operations/CreatePassiveSellOfferOperation.java) | [Go](https://godoc.org/github.com/stellar/go/txnbuild#CreatePassiveSellOffer)  
 **Threshold**: Medium  
@@ -630,7 +630,7 @@ Parameters to this operation depend on the ordering of assets in the liquidity p
 
 If the pool is empty, then this operation deposits maxAmountA of A and maxAmountB of B into the pool. If the pool is not empty, then this operation deposits at most maxAmountA of A and maxAmountB of B into the pool. The actual amounts deposited are determined using the current reserves of the pool. You can use these parameters to control a percentage of slippage.
 
-Learn more about liquidity pools: [Liquidity Pools Encyclopedia Entry](../../encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx)
+Learn more about liquidity pools: [Liquidity Pools section](../liquidity-on-stellar-sdex-liquidity-pools.mdx)
 
 **SDKs**: [Java](https://github.com/lightsail-network/java-stellar-sdk/blob/master/src/main/java/org/stellar/sdk/operations/LiquidityPoolDepositOperation.java)  
 **Threshold**: Medium  
@@ -663,7 +663,7 @@ Withdraw assets from a liquidity pool, reducing the number of pool shares in exc
 
 The minAmountA and minAmountB parameters can be used to control a percentage of slippage from the "spot price" on the pool.
 
-Learn more about liquidity pools: [Liquidity Pools Encyclopedia Entry](../../encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx)
+Learn more about liquidity pools: [Liquidity Pools section](../liquidity-on-stellar-sdex-liquidity-pools.mdx)
 
 **SDKs**: [Java](https://github.com/lightsail-network/java-stellar-sdk/blob/master/src/main/java/org/stellar/sdk/operations/LiquidityPoolWithdrawOperation.java)  
 **Threshold**: Medium  
diff --git a/docs/learn/glossary.mdx b/docs/learn/glossary.mdx
@@ -109,7 +109,7 @@ This term has been deprecated in favor of [contract tokens](#contract-token).
 
 A distributed exchange that allows the trading and conversion of assets on the network.
 
-Learn more in our [Liquidity on Stellar](./encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx#sdex) Encyclopedia Entry.
+Learn more in our [Liquidity on Stellar](./fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx#sdex) section.
 
 ### External Data Representation (XDR)
 
@@ -215,13 +215,13 @@ Contains the transaction source account, sequence number, and the operation inde
 
 An offer to buy or sell an asset.
 
-Learn more in our [Liquidity on Stellar: SDEX and Liquidity Pools Encyclopedia Entry](./encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx#orders).
+Learn more in our [Liquidity on Stellar: SDEX and Liquidity Pools section](./fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx#orders).
 
 ### Orderbook
 
 A record of outstanding orders on the Stellar network.
 
-Learn more in our [Liquidity on Stellar: SDEX and Liquidity Pools Encyclopedia Entry](./encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx#order-books).
+Learn more in our [Liquidity on Stellar: SDEX and Liquidity Pools section](./fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx#order-books).
 
 ### Passive order
 
diff --git a/docs/tokens/control-asset-access.mdx b/docs/tokens/control-asset-access.mdx
@@ -32,7 +32,7 @@ Using a distribution account is better for auditing because an issuing account c
 
 One thing you must decide when issuing an asset is what to call it. An asset code is the asset’s identifying code. There are three possible formats: Alphanumeric 4, Alphanumeric 12, and liquidity pool shares.
 
-Learn about liquidity pool shares in the [Liquidity Pool Encyclopedia Entry](../learn/encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools.mdx).
+Learn about liquidity pool shares in the [Liquidity Pool Encyclopedia Entry](../learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools.mdx).
 
 - Alphanumeric 4-character maximum: Any characters from the set a-z, A-Z, 0-9 are allowed. The code can be shorter than 4 characters, but the trailing characters must all be empty.
 - Alphanumeric 12-character maximum: Any characters from the set a-z, A-Z, 0-9 are allowed. The code can be any number of characters from 5 to 12, but the trailing characters must all be empty.
diff --git a/docusaurus.config.ts b/docusaurus.config.ts
@@ -365,6 +365,11 @@ const config: Config = {
               label: 'Ramps (anchors)',
               activeBasePath: 'docs/learn/fundamentals/anchors',
             },
+            {
+              to: '/docs/learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools',
+              label: 'SDEX',
+              activeBasePath: 'docs/learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools',
+            },
             {
               type: 'html',
               value: '<hr><a href="/docs/learn/encyclopedia" class="dropdown__link">Encyclopedia</a>',
diff --git a/routes.txt b/routes.txt
@@ -440,8 +440,6 @@
 /docs/data/oracles
 /docs/data/oracles/oracle-providers
 /docs/learn/encyclopedia
-/docs/learn/encyclopedia/sdex
-/docs/learn/encyclopedia/sdex/liquidity-on-stellar-sdex-liquidity-pools
 /docs/learn/encyclopedia/transactions-specialized
 /docs/learn/encyclopedia/transactions-specialized/channel-accounts
 /docs/learn/encyclopedia/transactions-specialized/claimable-balances
@@ -481,6 +479,7 @@
 /docs/learn/fundamentals/data-format/xdr
 /docs/learn/fundamentals/data-format/xdr-json
 /docs/learn/fundamentals/fees-resource-limits-metering
+/docs/learn/fundamentals/liquidity-on-stellar-sdex-liquidity-pools
 /docs/learn/fundamentals/lumens
 /docs/learn/fundamentals/networks
 /docs/learn/fundamentals/stellar-consensus-protocol
