📝 Refresh six classic guides

docs/build/guides/tokens/stellar-asset-contract.mdx

@@ -57,7 +57,7 @@ client.mint(...);
 
 ## Testing
 
-Soroban Rust SDK provides an easy way to instantiate a Stellar Asset Contract tokens using `register_stellar_asset_contract_v2`. This function can be seen as the deployment of a generic token. It also allows you to manipulate flags on the issuer account like `AUTH_REVOCABLE` and `AUTH_REQUIRED`. In the following example, we are following the best practices outlined in the [Issuing and Distribution Accounts section](../../../tokens/control-asset-access.mdx#issuing-and-distribution-accounts):
+Soroban Rust SDK provides an easy way to instantiate a Stellar Asset Contract tokens using `register_stellar_asset_contract_v2`. This function can be seen as the deployment of a generic token. It also allows you to manipulate flags on the issuer account like `AUTH_REVOCABLE` and `AUTH_REQUIRED`. In the following example, we are following the best practices outlined in the [Issuing and Distribution Accounts section](../../../tokens/control-asset-access.mdx#issuer-and-distributor-accounts):
 
 ```rust
 #![cfg(test)]

docs/data/horizon/api-reference/retrieve-an-order-book.api.mdx

@@ -1,7 +1,7 @@
 ---
 id: retrieve-an-order-book
 title: "Retrieve an Order Book"
-description: "The order book endpoint provides an order book's bids and asks and can be used in [streaming](https://developers.stellar.org/docs/data/horizon/api-reference/structure/streaming) mode."
+description: "The order book endpoint provides an order book's bids and asks and can be used in streaming mode."
 sidebar_label: "Retrieve an Order Book"
 hide_title: true
 hide_table_of_contents: true

docs/data/horizon/api-reference/structure/README.mdx

@@ -5,4 +5,20 @@ sidebar_label: Structure
 description: Horizon is an API for interacting with the Stellar network.
 ---
 
+import { MethodTable } from "@site/src/components/MethodTable";
+
 How Horizon is structured.
+
+<MethodTable title="Structure Types">
+
+|                                                   |     |
+| ------------------------------------------------- | --- |
+| [Response Format](./response-format.mdx)          |     |
+| [Page Arguments](./pagination/page-arguments.mdx) |     |
+| [Streaming](./streaming.mdx)                      |     |
+| [Rate Limiting](./rate-limiting.mdx)              |     |
+| [XDR](./xdr.mdx)                                  |     |
+| [Consistency](./consistency.mdx)                  |     |
+| [Pagination](./pagination/README.mdx)             |     |
+
+</MethodTable>

docs/learn/encyclopedia/sdex/README.mdx

@@ -1,8 +1,10 @@
 ---
-title: SDEX
+title: The SDEX
 sidebar_position: 90
 ---
 
 import DocCardList from "@theme/DocCardList";
 
+Native network markets, liquidity, and conversions for all assets.
+
 <DocCardList />

docs/learn/encyclopedia/security/signatures-multisig.mdx

@@ -5,6 +5,12 @@ sidebar_position: 20
 
 import { CodeExample } from "@site/src/components/CodeExample";
 
+:::danger TODO
+
+let's walk though creating a custodied solution akin to FT [`href`] and then break down the implications re CAP23 pending merges
+
+:::
+
 :::note
 
 This section details signing non-smart contract transactions. For auth related to smart contract transactions, see [authorization](./authorization.mdx)
@@ -40,6 +46,234 @@ In some cases, a transaction may need more than one signature:
 
 Each additional signer beyond the master key increases the account’s minimum balance by one base reserve. Up to 20 signatures can be attached to one transaction. Once a signature threshold is met, if there are leftover signatures, the transaction will fail. For example, if your transaction requires three signatures, providing more than three signatures, even if they are all valid, will result in a failed transaction error: `TX_BAD_AUTH_EXTRA`. This design is because unnecessary signature verification has a large effect on performance before accepting transactions in consensus.
 
+`example five signers each own auth, collectively cannot change signers`
+
+REQUIRES: server, primaryAccountSecret, &primaryAccount primatives
+
+```python
+channelAccPubKeys = [
+  "GA7WHVWBBUCVKVZ35GM5FVGZXZYJ63EFDB5VTFV2TRF4KLUXWN6CSIJL",
+  "GD4EITS74V4RN5XOKO42DX2SRR3NI5JVC3LFUWIAVQH2PXBUEKLZU6V3",
+  "GCEO3FNAOF7VKBRD22JHMT3Q5IVVUPDEICBKZNTKL7KUBOX6EDYYYTG4",
+  "GAUTAZU2E6VUFOPRDOYAMYQBD7JU3XRLODSKLQL4EXIYUDB22FFPYDJC",
+  "GBACJWSCHTRILBAPVOYXCVIFGUF7FSHTEKMITBI5ESCEQVEIJ6QFV4P5"
+]
+
+primaryPubKey = "GC5AT5GU7WI5NHHRM4XH2ALBOQS5I2MTLNYH5RTEJZC5LWCKVN52SVBV"
+primaryAccount = server.load_account(primaryPubKey)
+
+def generateChannelAccounts(primaryPubKey, channelAccPubKeys, primaryAccountSecret):
+  transactionBuilder = TransactionBuilder(
+    source_account = primaryAccount,
+    network_passphrase = Network.TESTNET_NETWORK_PASSPHRASE,
+    base_fee = 100
+  )
+
+  for channelPubKeys in channelAccPubKeys:
+    transactionBuilder.append_create_account_op(
+      destination = channelPubKey,
+      starting_balance = "4.4"
+    )
+
+  transaction = transactionBuilder.build()
+  transaction.sign(primarySecretKey)
+  return server.submit_transaction(transaction)
+
+def authorizeChannelAccounts(primaryPubKey, channelAccPubKeys, primaryAccountSecret):
+  transactionBuilder = TransactionBuilder(
+    source_account = primaryAccount,
+    network_passphrase = Network.TESTNET_NETWORK_PASSPHRASE,
+    base_fee = 100
+  )
+
+  transactionBuilder.append_set_options_op(
+    high_threshold = 44,
+    master_weight = 44,
+    medium_threshold = 3
+  )
+
+  for channelPubKeys in channelAccPubKeys:
+    transactionBuilder.append_set_options_op(
+      signer={
+        "ed25519PublicKey": channelPubKey,
+        "weight": 3
+      }
+    )
+```
+
+```js
+const channelAccPubKeys = [
+  "GA7WHVWBBUCVKVZ35GM5FVGZXZYJ63EFDB5VTFV2TRF4KLUXWN6CSIJL",
+  "GD4EITS74V4RN5XOKO42DX2SRR3NI5JVC3LFUWIAVQH2PXBUEKLZU6V3",
+  "GCEO3FNAOF7VKBRD22JHMT3Q5IVVUPDEICBKZNTKL7KUBOX6EDYYYTG4",
+  "GAUTAZU2E6VUFOPRDOYAMYQBD7JU3XRLODSKLQL4EXIYUDB22FFPYDJC",
+  "GBACJWSCHTRILBAPVOYXCVIFGUF7FSHTEKMITBI5ESCEQVEIJ6QFV4P5",
+];
+
+const primaryPubKey =
+  "GC5AT5GU7WI5NHHRM4XH2ALBOQS5I2MTLNYH5RTEJZC5LWCKVN52SVBV";
+const primaryAccount = server.loadAccount(primaryPubKey);
+
+async function generateChannelAccounts(primaryAccountSecret) {
+  const transactionBuilder = new StellarSdk.TransactionBuilder(primaryAccount, {
+    fee: StellarSdk.BASE_FEE,
+    networkPassphrase: StellarSdk.Networks.TESTNET,
+  });
+
+  channelAccPubKeys.forEach((channelPubKey) => {
+    transactionBuilder.addOperation(
+      StellarSdk.Operation.createAccount({
+        destination: channelPubKey,
+        startingBalance: "4.4",
+      }),
+    );
+  });
+
+  const transaction = transactionBuilder.build();
+  transaction.sign(primaryKeypair);
+  const result = await server.submitTransaction(transaction);
+}
+
+async function authorizeChannelAccounts(primaryAccountSecret) {
+  const transactionBuilder = new StellarSdk.TransactionBuilder(primaryAccount, {
+    fee: StellarSdk.BASE_FEE,
+    networkPassphrase: StellarSdk.Networks.TESTNET,
+  });
+
+  transactionBuilder.addOperation(
+    StellarSdk.Operation.setOptions({
+      highThreshold: 44,
+      masterWeight: 44,
+      mediumThreshold: 3,
+    }),
+  );
+
+  channelAccPubKeys.forEach((channelPubKey) => {
+    transactionBuilder.addOperation(
+      StellarSdk.Operation.setOptions({
+        signer: {
+          ed25519PublicKey: channelPubKey,
+          weight: 3,
+        },
+      }),
+    );
+  });
+}
+```
+
+```java
+private static final List<String> channelAccPubKeys = Arrays.asList(
+  "GA7WHVWBBUCVKVZ35GM5FVGZXZYJ63EFDB5VTFV2TRF4KLUXWN6CSIJL",
+  "GD4EITS74V4RN5XOKO42DX2SRR3NI5JVC3LFUWIAVQH2PXBUEKLZU6V3",
+  "GCEO3FNAOF7VKBRD22JHMT3Q5IVVUPDEICBKZNTKL7KUBOX6EDYYYTG4",
+  "GAUTAZU2E6VUFOPRDOYAMYQBD7JU3XRLODSKLQL4EXIYUDB22FFPYDJC",
+  "GBACJWSCHTRILBAPVOYXCVIFGUF7FSHTEKMITBI5ESCEQVEIJ6QFV4P5"
+);
+private static final String primaryPubKey = "GC5AT5GU7WI5NHHRM4XH2ALBOQS5I2MTLNYH5RTEJZC5LWCKVN52SVBV";
+private static final AccountResponse primaryAccount = server.accounts().account(primaryPubKey);
+
+public static void generateChannelAccounts(String primaryAccountSecret) throws Exception {
+  Transaction.Builder transactionBuilder = new Transaction.Builder(primaryAccount, Network.TESTNET)
+    .setBaseFee(Transaction.MIN_BASE_FEE)
+
+  for (String channelPubKeys : channelAccPubKeys) {
+    transactionBuilder.addOperation(
+      new CreateAccountOperation.Builder(channelPubKeys, startingBalance).build()
+    );
+  }
+
+  Transaction transaction = transactionBuilder.build();
+  transaction.sign(primaryKeypair);
+
+  SubmitTransactionResponse response = server.submitTransaction(transaction);
+  System.out.println("Transaction successful: " + response);
+}
+
+public static void authorizeChannelAccounts(String primaryAccountSecret) throws Exception {
+
+  Transaction.Builder transactionBuilder = new Transaction.Builder(primaryAccount, Network.TESTNET)
+    .setBaseFee(Transaction.MIN_BASE_FEE)
+
+  transactionBuilder.addOperation(
+    new SetOptionsOperation.Builder()
+      .setHighThreshold(44)
+      .setMasterKeyWeight(44)
+      .setMediumThreshold(3)
+      .build()
+  );
+
+  for (String channelPubKeys : channelAccPubKeys) {
+    transactionBuilder.addOperation(
+      new SetOptionsOperation.Builder()
+        .setSigner(new Signer.SignerKeyEd25519(channelPubKeys), 3)
+        .build()
+    );
+  }
+}
+```
+
+```go
+var (
+  channelAccPubKeys = []string{
+    "GA7WHVWBBUCVKVZ35GM5FVGZXZYJ63EFDB5VTFV2TRF4KLUXWN6CSIJL",
+    "GD4EITS74V4RN5XOKO42DX2SRR3NI5JVC3LFUWIAVQH2PXBUEKLZU6V3",
+    "GCEO3FNAOF7VKBRD22JHMT3Q5IVVUPDEICBKZNTKL7KUBOX6EDYYYTG4",
+    "GAUTAZU2E6VUFOPRDOYAMYQBD7JU3XRLODSKLQL4EXIYUDB22FFPYDJC",
+    "GBACJWSCHTRILBAPVOYXCVIFGUF7FSHTEKMITBI5ESCEQVEIJ6QFV4P5",
+  }
+  primaryPubKey    = "GC5AT5GU7WI5NHHRM4XH2ALBOQS5I2MTLNYH5RTEJZC5LWCKVN52SVBV"
+)
+
+func generateChannelAccounts(primaryAccountSecret string) {
+  tx, err := txnbuild.NewTransaction(
+    txnbuild.TransactionParams{
+      SourceAccount:        &primaryAccount,
+      IncrementSequenceNum: true,
+      BaseFee:              txnbuild.MinBaseFee,
+      Operations:           []txnbuild.Operation{},
+    },
+  )
+  check(err)
+
+  for _, channelPubKey := range channelAccPubKeys {
+    createOp := txnbuild.CreateAccount{
+      Destination:   channelPubKey,
+      Amount:        "4.4",
+    }
+    tx.Operations = append(tx.Operations, &createOp)
+  }
+}
+
+func authorizeChannelAccounts(primaryAccountSecret string) {
+  tx, err := txnbuild.NewTransaction(
+    txnbuild.TransactionParams{
+      SourceAccount:        &primaryAccount,
+      IncrementSequenceNum: true,
+      BaseFee:              txnbuild.MinBaseFee,
+      Operations:           []txnbuild.Operation{},
+    },
+  )
+  check(err)
+
+  setThreshOp := txnbuild.SetOptions{
+    HighThreshold:   txnbuild.NewThreshold(44),
+    MasterWeight:    txnbuild.NewThreshold(44),
+    MediumThreshold: txnbuild.NewThreshold(3),
+  }
+  tx.Operations = append(tx.Operations, &setThreshOp)
+
+  for _, channelPubKey := range channelAccPubKeys {
+    addSignerOp := txnbuild.SetOptions{
+      Signer: &txnbuild.Signer{
+        Address: channelPubKey,
+        Weight: txnbuild.NewThreshold(3)
+      },
+    }
+    tx.Operations = append(tx.Operations, &addSignerOp)
+  }
+}
+```
+
 ### Alternate signature types
 
 To enable some advanced smart contract features there are a couple of additional signature types. These signature types also have weights and can be added and removed similarly to normal signature types. But rather than check a cryptographic signature for authorization they have a different method of proving validity to the network.