[DO NOT MERGE] Create cli command inscribe-chain

.gitignore

@@ -10,3 +10,4 @@
 /target
 /test-times.txt
 /tmp
+/300-inscriptions

addresses.example.txt

@@ -0,0 +1,12 @@
+tb1p7t5xhyxj2g98eua7xfgrp5ufgwjypqje8q2z2cns79yaly4vv9lq5k4fmh
+tb1p2khdgxygwmt4hs2ls9p39w6m9pf3lxfvtmg855h65jqazj0e2hrse387vm
+tb1p833fd7mv8kngqf6acue3f8c9k63xwxu23ph3jmt8fjqn2p0d4amqawndj6
+tb1pajkhapfr7qzsv84x4esmp8tt87rgfy2764a2we9zahawp02sn2ask4wwvp
+tb1pak3d2nf3n2ezpm3tx52sswz2zzlr75ch9fq2qp8dt8re4a3r2p5shja0ku
+tb1pw5fkhj4u9fhs4hednnd2x2tped4ssuwnxax39ndcakce7ayc6erq9679tm
+tb1pkeetmfw2khdvlessj7wgk5gvmc4lg46cq4z5m590pkk8r80edrcqjxa82t
+tb1pldqf2fmtj6f38z5qmtemlfx3rxmvt7sg3xq00px4yc90fe9adx4qfn6xpf
+tb1pyc3ng7l4ry9e9tvhudeq8tlt3zu77uynjm4vx2wppvywvke2pd2scrtgrf
+tb1pcxtr98jtam7zpk6lfvth675c43r8eteslgw9809ykucvdusquv3qzygc3s
+tb1p44qzt7sxmjhr2rlhxw7y6zl5n4hhwlq35wuthfrkpx2rtqj4uxcqk02x2q
+tb1pqswqkj4rp86lats7plu0ypc2u9vphnmackm0cccax8f8dchkq8jsc3u99u

create-30-testnet.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+
+dir="30-inscriptions-testnet"
+mkdir -p $dir
+
+parentInscriptionId="3995befab6b08427416bf9442d6877f6057780f31cdca37eb600a12bcf5e9345i0"
+offsetInscriptionId="f4429c67523c9437f3db69fe0521f10dec4ae2b3bb64e98a1fd97c53c59803cai0"
+
+for ((i=1; i<=30; i++)); do
+    filename="${i}.html"
+    filepath="${dir}/${filename}"
+    tokenID=$i
+
+    echo '<body/><script>j='$tokenID';d=document;b=d.body
+class URLSearchParams{get=k=>k=="tokenID"?j:0}(async()=>{q="\n"
+j=9520+(+await(await fetch("/content/'$offsetInscriptionId'")).text()+j)%300
+if(isNaN(j))return;
+h=(await(await fetch("/content/'$parentInscriptionId'")).text()).split(q)
+b.innerHTML=h[2];
+z=document.createElement("script")
+z.innerHTML=h.slice(4,18).join(q)
+b.appendChild(z)})()</script>' > "$filepath"
+
+done
+
+echo "Test files created!"

create-30-with-addresses-testnet.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+
+file="$1"  # Path to the addresses file
+
+# Check if the file exists
+if [ ! -f "$file" ]; then
+  echo "Addresses file not found: $file"
+  exit 1
+fi
+
+dir="30-inscriptions-testnet"
+mkdir -p $dir
+
+inscriptions_dir="$dir/inscriptions"
+mkdir -p $inscriptions_dir
+
+addresses_dir="$dir/addresses"
+mkdir -p $addresses_dir
+
+# Read the file line by line
+while IFS= read -r line; do
+  ((count++))
+
+  filename="${count}.address"
+  filepath="${addresses_dir}/${filename}"
+  echo "$line" > "$filepath"
+done < "$file"
+
+parentInscriptionId="3995befab6b08427416bf9442d6877f6057780f31cdca37eb600a12bcf5e9345i0"
+offsetInscriptionId="f4429c67523c9437f3db69fe0521f10dec4ae2b3bb64e98a1fd97c53c59803cai0"
+
+for ((i=1; i<=30; i++)); do
+    filename="${i}.html"
+    filepath="${inscriptions_dir}/${filename}"
+    tokenID=$i
+
+    echo '<body/><script>j='$tokenID';d=document;b=d.body
+class URLSearchParams{get=k=>k=="tokenID"?j:0}(async()=>{q="\n"
+j=9520+(+await(await fetch("/content/'$offsetInscriptionId'")).text()+j)%300
+if(isNaN(j))return;
+h=(await(await fetch("/content/'$parentInscriptionId'")).text()).split(q)
+b.innerHTML=h[2];
+z=document.createElement("script")
+z.innerHTML=h.slice(4,18).join(q)
+b.appendChild(z)})()</script>' > "$filepath"
+
+done
+
+echo "Test files created!"

create-300.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+
+mkdir -p 300-inscriptions
+
+parentInscriptionId="2dbdf9ebbec6be793fd16ae9b797c7cf968ab2427166aaf390b90b71778266abi0"
+offsetInscriptionId="<offset inscription id>"
+
+for ((i=1; i<=300; i++)); do
+    filename="${i}.html"
+    filepath="300-inscriptions/${filename}"
+    tokenID=$i
+
+    echo '<body/><script>j='$tokenID';d=document;b=d.body
+class URLSearchParams{get=k=>k=="tokenID"?j:0}(async()=>{q="\n"
+j=9520+(+await(await fetch("/content/'$offsetInscriptionId'")).text()+j)%300
+h=(await(await fetch("/content/'$parentInscriptionId'")).text()).split(q)
+b.innerHTML=h.slice(0,27).join(q)
+z=d.createElement("script")
+z.innerHTML=`${h[28]};${h.slice(32,36).join(q)}`
+b.appendChild(z)
+init()})()</script>' > "$filepath"
+
+done
+
+echo "Files created!"

inscribe-chain.md

@@ -0,0 +1,68 @@
+# ord wallet inscribe-chain
+> Broadcast a transaction chain to the mempool inscribing 10 ordinals, each containing one special sat extracted from a designated output.
+
+![](chain.png)
+
+## Requirements
+1. utxo containing special sats must be padded with at least 1,000 normal sats at the beginning
+2. if the utxo has more than one range of special sats, start with the last sat of the last range, because everything below that will be trimmed.
+3. for each iteration, 10 inscriptions being created in one block, wallet must have 10 additional available utxos with enough sats for each inscription because 1 sat will come from the special utxo and the other 9,999 will come from any other normal utxo available in the wallet. **Important**: each of these prepared utxo's also needs to be large enough to pay the chosen fee rate for the inscription.
+4. files to be inscribed must be named as `<number>.<extension>`, the inscribing will take place in that order.
+
+## Example
+1. Create the files to be inscribed:
+    ```bash
+    mkdir files/
+    echo "1" > files/1.txt
+    echo "2" > files/2.txt
+    echo "3" > files/3.txt
+    echo "4" > files/4.txt
+    echo "5" > files/5.txt
+    echo "6" > files/6.txt
+    echo "7" > files/7.txt
+    echo "8" > files/8.txt
+    echo "9" > files/9.txt
+    echo "10" > files/10.txt
+    echo "11" > files/11.txt
+    echo "12" > files/12.txt
+    echo "13" > files/13.txt
+    echo "14" > files/14.txt
+    echo "15" > files/15.txt
+    ```
+2. Get the special utxo
+    ```bash
+    ord wallet outputs
+    ```
+    ```json
+    [
+        {
+          "output": "7f320d87dd2d011ba9a3dbc66c46aed4b0b3a9a0a4d1c93fe3ed97ab280463f5:8",
+          "amount": 15000
+        }
+    ]
+    ```
+    Lets pick sats from `10_001` to `10_015` as the special ones, so my `satpoint` is:
+    ```
+    7f320d87dd2d011ba9a3dbc66c46aed4b0b3a9a0a4d1c93fe3ed97ab280463f5:8:10014
+    ```
+3. Run the `inscribe-chain` command
+    > **Note**
+    > You must have at least 10 additional available utxos, each containing a minimum of 12,000 sats, when running this command. If you don't have enough, use the `ord wallet split` command to break one of your larger utxos into several smaller ones..
+
+    ```bash
+    ord wallet inscribe-chain --fee-rate=1.0 --satpoint=7f320d87dd2d011ba9a3dbc66c46aed4b0b3a9a0a4d1c93fe3ed97ab280463f5:8:10014 files/
+    ```
+    The sats `10015`, `10014`, `10013`, `10012`, `10011`, `10010`, `10009`, `10008`, `10007` and `10006` were extracted from the special utxo and given to the inscribed files `1.json`, `2.json`, ... `10.json` in this order.
+
+4. Now we have to **wait for the block to be mined** and then run the next command (that was given when the previous completed):
+    > **Warning**
+    > If you run the following command while the previous transaction chain is still pending in the mempool, you will be able to inscribe only 2 more inscriptions and will have a commit transaction without the reveal. In other words, it will waste valuable special sats and will require a manual task to fix the transaction chain.
+    ```bash
+    ord wallet inscribe-chain --fee-rate 1 --satpoint d3ecd1d753e09d2ca3a69fe1a36a7b829e3c096d44f101d11c5a3f6aef1e757b:0:10004 files/
+    ```
+
+And this is the full chain:  
+https://mempool.space/pt/signet/tx/58a7f430fbd5933d7f2dbcb9b2e1b4aaeea3af47a965c1a8917fa05bbf854a45#flow=&vin=0  
+
+![](mempool.png)
+If we navigate through the first outputs we can see all the 10015 to 10001 sats being added to the commit outputs and then to the reveal output.

src/index.rs

@@ -525,6 +525,21 @@ impl Index {
     )
   }
 
+  pub(crate) fn insert_inscription_satpoint(
+    &self,
+    inscription_id: InscriptionId,
+    satpoint: SatPoint,
+  ) -> Result {
+    let tx = self.database.begin_write()?;
+
+    tx.open_table(INSCRIPTION_ID_TO_SATPOINT)?
+      .insert(&inscription_id.store(), &satpoint.store())?;
+
+    tx.commit()?;
+
+    Ok(())
+  }
+
   pub(crate) fn get_inscription_satpoint_by_id(
     &self,
     inscription_id: InscriptionId,

src/index/updater.rs

@@ -116,10 +116,21 @@ impl<'a> Updater<'a> {
         &mut outpoint_sender,
         &mut value_receiver,
         &mut wtx,
-        block,
+        &block,
         &mut value_cache,
       )?;
 
+      if self.height.checked_sub(1).is_some() {
+        log::info!(
+          target: "new_inscription_satpoint",
+          "{{\"height\":{},\"block_hash\":\"{}\",\"prev_block_hash\":\"{}\",\"tx_count\":{}}}",
+          &self.height - 1,
+          &block.header.block_hash(),
+          &block.header.prev_blockhash,
+          &block.txdata.len(),
+        );
+      }
+
       if let Some(progress_bar) = &mut progress_bar {
         progress_bar.inc(1);
 
@@ -336,7 +347,7 @@ impl<'a> Updater<'a> {
     outpoint_sender: &mut Sender<OutPoint>,
     value_receiver: &mut Receiver<u64>,
     wtx: &mut WriteTransaction,
-    block: BlockData,
+    block: &BlockData,
     value_cache: &mut HashMap<OutPoint, u64>,
   ) -> Result<()> {
     // If value_receiver still has values something went wrong with the last block
@@ -434,6 +445,7 @@ impl<'a> Updater<'a> {
       block.header.time,
       value_cache,
       self.cached_children_by_id,
+      // &index.client,
     )?;
 
     if self.index_sats {