📝 Refresh six classic guides

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/learn/encyclopedia/security/signatures-multisig.mdx

@@ -40,6 +40,227 @@ 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.