Merge branch 'master' into master

SUMMARY.md

@@ -4,23 +4,29 @@
 
 ## 🟧 Nakamoto Upgrade
 
-* [What is the Nakamoto Release?](nakamoto-upgrade/what-is-the-nakamoto-release.md)
-* [Nakamoto in 10 Minutes](nakamoto-upgrade/nakamoto-in-10-minutes.md)
-* [Nakamoto In-Depth](nakamoto-upgrade/nakamoto-in-depth/README.md)
-  * [Stackers and Signing](nakamoto-upgrade/nakamoto-in-depth/stackers-and-signing.md)
-  * [Chain Structure and Synchronization](nakamoto-upgrade/nakamoto-in-depth/chain-structure-and-synchronization.md)
-  * [Block Structure and Validation](nakamoto-upgrade/nakamoto-in-depth/block-structure-and-validation.md)
-  * [Transactions](nakamoto-upgrade/nakamoto-in-depth/transactions.md)
-  * [Changes to PoX and Clarity](nakamoto-upgrade/nakamoto-in-depth/changes-to-pox-and-clarity.md)
-  * [Financial Incentives and Security Budget](nakamoto-upgrade/nakamoto-in-depth/financial-incentives-and-security-budget.md)
-  * [What About Microblocks?](nakamoto-upgrade/nakamoto-in-depth/what-about-microblocks.md)
-  * [Bitcoin Reorgs](nakamoto-upgrade/nakamoto-in-depth/bitcoin-reorgs.md)
-* [Nakamoto Rollout Plan](nakamoto-upgrade/nakamoto-rollout-plan.md)
-* [Testnets](nakamoto-upgrade/testnets/README.md)
-  * [Pre-Launch Testnet](nakamoto-upgrade/testnets/neon.md)
-  * [Nakamoto Testnet](nakamoto-upgrade/testnets/argon.md)
-* [Running a Signer](nakamoto-upgrade/running-a-signer.md)
-* [Stacking Flow](nakamoto-upgrade/stacking-flow.md)
+* [Nakamoto Upgrade - Start Here](nakamoto-upgrade/nakamoto-upgrade-start-here.md)
+* [What is the Nakamoto Upgrade?](nakamoto-upgrade/what-is-the-nakamoto-release/README.md)
+  * [Nakamoto in 10 Minutes](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-10-minutes.md)
+  * [Nakamoto In-Depth](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/README.md)
+    * [Stackers and Signing](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/stackers-and-signing.md)
+    * [Chain Structure and Synchronization](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/chain-structure-and-synchronization.md)
+    * [Block Structure and Validation](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/block-structure-and-validation.md)
+    * [Transactions](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/transactions.md)
+    * [Changes to PoX and Clarity](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/changes-to-pox-and-clarity.md)
+    * [Financial Incentives and Security Budget](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/financial-incentives-and-security-budget.md)
+    * [What About Microblocks?](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/what-about-microblocks.md)
+    * [Bitcoin Reorgs](nakamoto-upgrade/what-is-the-nakamoto-release/nakamoto-in-depth/bitcoin-reorgs.md)
+* [Nakamoto Rollout Plan](nakamoto-upgrade/nakamoto-rollout-plan/README.md)
+  * [Nakamoto for Exchanges](nakamoto-upgrade/nakamoto-rollout-plan/nakamoto-for-exchanges.md)
+  * [Nakamoto for Stackers](nakamoto-upgrade/nakamoto-rollout-plan/nakamoto-for-stackers.md)
+  * [Nakamoto for Stacking Providers](nakamoto-upgrade/nakamoto-rollout-plan/nakamoto-for-stacking-providers.md)
+  * [Nakamoto for App Developers](nakamoto-upgrade/nakamoto-rollout-plan/nakamoto.md)
+* [Signing and Stacking](nakamoto-upgrade/signing-and-stacking/README.md)
+  * [How to Run a Signer](nakamoto-upgrade/signing-and-stacking/running-a-signer.md)
+  * [How to Stack (as a signer)](nakamoto-upgrade/signing-and-stacking/stacking-flow.md)
+  * [FAQ](nakamoto-upgrade/signing-and-stacking/faq.md)
+  * [Sample Configuration Files](nakamoto-upgrade/signing-and-stacking/sample-configuration-files.md)
+* [Nakamoto & Primary Testnet](nakamoto-upgrade/nakamoto-and-primary-testnet.md)
 
 ## 🎓 Stacks 101 (Pre-Nakamoto) <a href="#stacks-101" id="stacks-101"></a>
 
@@ -43,6 +49,7 @@
 
 ## 🛠️ Tutorials
 
+* [The Stack](tutorials/the-stack.md)
 * [Hello Stacks (Quickstart Tutorial)](tutorials/hello-stacks-quickstart-tutorial.md)
 * [Bitcoin Integration](tutorials/bitcoin-integration/README.md)
   * [Sending Bitcoin with Leather Wallet](tutorials/bitcoin-integration/sending-bitcoin-with-leather-wallet.md)
@@ -69,6 +76,7 @@
   * [Audited Starter Contracts](clarity/example-contracts/audited-starter-contracts.md)
   * [Stacking](clarity/example-contracts/stacking.md)
   * [BNS](clarity/example-contracts/bns.md)
+  * [Multi Send](clarity/example-contracts/multi-send.md)
 
 ## ⛓️ sBTC
 
@@ -118,6 +126,9 @@
 * [🔶 2024](press-and-top-links/2024/README.md)
   * [🔸 January 2024](press-and-top-links/2024/january-2024.md)
   * [🔸 February 2024](press-and-top-links/2024/february-2024.md)
+  * [🔸 March 2024](press-and-top-links/2024/march-2024.md)
+  * [🔸 April 2024](press-and-top-links/2024/april-2024.md)
+  * [🔸 May 2024](press-and-top-links/2024/may-2024.md)
 
 ## 🧡 Bitcoin Theses and Reports
 

clarity/example-contracts/multi-send.md

@@ -0,0 +1,21 @@
+# Multi Send
+
+Multi send is a very simple but highly useful utility contract for executing multiple STX transfers in a single transaction.
+
+It takes in a list of addresses and amounts and folds through them to execute a STX transfer for each one.
+
+Mainnet contract: [https://explorer.hiro.so/txid/0x59665b756dc0fa9efb3fca9e05a28f572c9b14ca894c115fd3e7d81a563e14f8?chain=mainnet](https://explorer.hiro.so/txid/0x59665b756dc0fa9efb3fca9e05a28f572c9b14ca894c115fd3e7d81a563e14f8?chain=mainnet)
+
+```clojure
+;; send-many
+(define-private (send-stx (recipient { to: principal, ustx: uint }))
+  (stx-transfer? (get ustx recipient) tx-sender (get to recipient)))
+(define-private (check-err (result (response bool uint))
+                           (prior (response bool uint)))
+  (match prior ok-value result
+               err-value (err err-value)))
+(define-public (send-many (recipients (list 200 { to: principal, ustx: uint })))
+  (fold check-err
+    (map send-stx recipients)
+    (ok true)))
+```