From 068c3f24e96f2571630dbe44db445084d60a6cb2 Mon Sep 17 00:00:00 2001
From: Liu-Cheng Xu <xuliuchengxlc@gmail.com>
Date: Tue, 25 Feb 2025 07:40:46 +0800
Subject: [PATCH 01/53] Fix `is_invalid_use_of_sighash_single()`
 incompatibility with Bitcoin Core

---
 bitcoin/src/crypto/sighash.rs | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/bitcoin/src/crypto/sighash.rs b/bitcoin/src/crypto/sighash.rs
index f27dbb27b..17cc0a37c 100644
--- a/bitcoin/src/crypto/sighash.rs
+++ b/bitcoin/src/crypto/sighash.rs
@@ -400,6 +400,16 @@ impl EcdsaSighashType {
         }
     }
 
+    /// Checks if the sighash type is [`Self::Single`] or [`Self::SinglePlusAnyoneCanPay`].
+    ///
+    /// This matches Bitcoin Core's behavior where SIGHASH_SINGLE bug check is based on the base
+    /// type (after masking with 0x1f), regardless of the ANYONECANPAY flag.
+    ///
+    /// See: <https://github.com/bitcoin/bitcoin/blob/e486597/src/script/interpreter.cpp#L1618-L1619>
+    pub fn is_single(&self) -> bool {
+        matches!(self, Self::Single | Self::SinglePlusAnyoneCanPay)
+    }
+
     /// Creates a [`EcdsaSighashType`] from a raw `u32`.
     ///
     /// **Note**: this replicates consensus behaviour, for current standardness rules correctness
@@ -1316,7 +1326,7 @@ impl std::error::Error for AnnexError {
 
 fn is_invalid_use_of_sighash_single(sighash: u32, input_index: usize, outputs_len: usize) -> bool {
     let ty = EcdsaSighashType::from_consensus(sighash);
-    ty == EcdsaSighashType::Single && input_index >= outputs_len
+    ty.is_single() && input_index >= outputs_len
 }
 
 /// Result of [`SighashCache::legacy_encode_signing_data_to`].

From 18c2cad578fd4383411f1b958caa90217d78d590 Mon Sep 17 00:00:00 2001
From: Liu-Cheng Xu <xuliuchengxlc@gmail.com>
Date: Tue, 25 Feb 2025 07:38:36 +0800
Subject: [PATCH 02/53] Add test for sighash_single_bug incompatility fix

---
 bitcoin/src/crypto/sighash.rs | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/bitcoin/src/crypto/sighash.rs b/bitcoin/src/crypto/sighash.rs
index 17cc0a37c..294dac70e 100644
--- a/bitcoin/src/crypto/sighash.rs
+++ b/bitcoin/src/crypto/sighash.rs
@@ -1463,8 +1463,6 @@ mod tests {
 
     #[test]
     fn sighash_single_bug() {
-        const SIGHASH_SINGLE: u32 = 3;
-
         // We need a tx with more inputs than outputs.
         let tx = Transaction {
             version: transaction::Version::ONE,
@@ -1475,10 +1473,16 @@ mod tests {
         let script = ScriptBuf::new();
         let cache = SighashCache::new(&tx);
 
-        let got = cache.legacy_signature_hash(1, &script, SIGHASH_SINGLE).expect("sighash");
-        let want = LegacySighash::from_slice(&UINT256_ONE).unwrap();
+        let sighash_single = 3;
+        let got = cache.legacy_signature_hash(1, &script, sighash_single).expect("sighash");
+        let want = LegacySighash::from_byte_array(UINT256_ONE);
+        assert_eq!(got, want);
 
-        assert_eq!(got, want)
+        // https://github.com/rust-bitcoin/rust-bitcoin/issues/4112
+        let sighash_single = 131;
+        let got = cache.legacy_signature_hash(1, &script, sighash_single).expect("sighash");
+        let want = LegacySighash::from_byte_array(UINT256_ONE);
+        assert_eq!(got, want);
     }
 
     #[test]

From 39e280a2b61fb10900c483485dbceb5296b87020 Mon Sep 17 00:00:00 2001
From: Martin Habovstiak <martin.habovstiak@gmail.com>
Date: Fri, 21 Feb 2025 14:59:55 +0100
Subject: [PATCH 03/53] Fix key/script spend detection in `Witness`

The `taproot_control_block` did not properly detect whether it deals
with script spend or key spend. As a result, if key spend with annex was
used it'd return the first element (the signature) as if it was a
control block.

Further, the conditions identifying which kind of spend it was were
repeated multiple times but behaved subtly differently making only
`taproot_control_block` buggy but the other places confusing.

To resolve these issues this change adds a `P2TrSpend` enum that
represents a parsed witness and has a single method doing all the
parsing. The other methods can then be trivially implemented by matching
on that type. This way only one place needs to be verified and the
parsing code is more readable since it uses one big `match` to handle
all possibilities.

The downside of this is a potential perf impact if the parsing code
doesn't get inlined since the common parsing code has to shuffle around
data that the caller is not intersted in. I don't think this will be a
problem but if it will I suppose it will be solvable (e.g. by using
`#[inline(always)]`).

The enum also looks somewhat nice and perhaps downstream consumers could
make use of it. This change does not expose it yet but is written such
that after exposing it the API would be (mostly) idiomatic.

Closes #4097
---
 bitcoin/src/blockdata/witness.rs | 141 ++++++++++++++++++++++---------
 1 file changed, 103 insertions(+), 38 deletions(-)

diff --git a/bitcoin/src/blockdata/witness.rs b/bitcoin/src/blockdata/witness.rs
index 0737a678a..024418a0e 100644
--- a/bitcoin/src/blockdata/witness.rs
+++ b/bitcoin/src/blockdata/witness.rs
@@ -399,57 +399,40 @@ impl Witness {
     ///
     /// This does not guarantee that this represents a P2TR [`Witness`]. It
     /// merely gets the second to last or third to last element depending on
-    /// the first byte of the last element being equal to 0x50. See
-    /// [Script::is_p2tr](crate::blockdata::script::Script::is_p2tr) to
-    /// check whether this is actually a Taproot witness.
+    /// the first byte of the last element being equal to 0x50.
+    ///
+    /// See [`Script::is_p2tr`] to check whether this is actually a Taproot witness.
     pub fn tapscript(&self) -> Option<&Script> {
-            if self.is_empty() {
-                return None;
-            }
-
-            if self.taproot_annex().is_some() {
-                self.third_to_last().map(Script::from_bytes)
-            } else {
-                self.second_to_last().map(Script::from_bytes)
-            }
+        match P2TrSpend::from_witness(self) {
+            // Note: the method is named "tapscript" but historically it was actually returning
+            // leaf script. This is broken but we now keep the behavior the same to not subtly
+            // break someone.
+            Some(P2TrSpend::Script { leaf_script, .. }) => Some(leaf_script),
+            _ => None,
+        }
     }
 
     /// Get the taproot control block following BIP341 rules.
     ///
     /// This does not guarantee that this represents a P2TR [`Witness`]. It
     /// merely gets the last or second to last element depending on the first
-    /// byte of the last element being equal to 0x50. See
-    /// [Script::is_p2tr](crate::blockdata::script::Script::is_p2tr) to
-    /// check whether this is actually a Taproot witness.
+    /// byte of the last element being equal to 0x50.
+    ///
+    /// See [`Script::is_p2tr`] to check whether this is actually a Taproot witness.
     pub fn taproot_control_block(&self) -> Option<&[u8]> {
-            if self.is_empty() {
-                return None;
-            }
-
-            if self.taproot_annex().is_some() {
-                self.second_to_last()
-            } else {
-                self.last()
-            }
+        match P2TrSpend::from_witness(self) {
+            Some(P2TrSpend::Script { control_block, .. }) => Some(control_block),
+            _ => None,
+        }
     }
 
     /// Get the taproot annex following BIP341 rules.
     ///
-    /// This does not guarantee that this represents a P2TR [`Witness`]. See
-    /// [Script::is_p2tr](crate::blockdata::script::Script::is_p2tr) to
-    /// check whether this is actually a Taproot witness.
+    /// This does not guarantee that this represents a P2TR [`Witness`].
+    ///
+    /// See [`Script::is_p2tr`] to check whether this is actually a Taproot witness.
     pub fn taproot_annex(&self) -> Option<&[u8]> {
-        self.last().and_then(|last| {
-            // From BIP341:
-            // If there are at least two witness elements, and the first byte of
-            // the last element is 0x50, this last element is called annex a
-            // and is removed from the witness stack.
-            if self.len() >= 2 && last.first() == Some(&TAPROOT_ANNEX_PREFIX) {
-                Some(last)
-            } else {
-                None
-            }
-        })
+        P2TrSpend::from_witness(self)?.annex()
     }
 
     /// Get the p2wsh witness script following BIP141 rules.
@@ -468,6 +451,88 @@ impl Index<usize> for Witness {
     fn index(&self, index: usize) -> &Self::Output { self.nth(index).expect("Out of Bounds") }
 }
 
+/// Represents a possible Taproot spend.
+///
+/// Taproot can be spent as key spend or script spend and, depending on which it is, different data
+/// is in the witness. This type helps representing that data more cleanly when parsing the witness
+/// because there are a lot of conditions that make reasoning hard. It's better to parse it at one
+/// place and pass it along.
+///
+/// This type is so far private but it could be published eventually. The design is geared towards
+/// it but it's not fully finished.
+enum P2TrSpend<'a> {
+    Key {
+        // This field is technically present in witness in case of key spend but none of our code
+        // uses it yet. Rather than deleting it, it's kept here commented as documentation and as
+        // an easy way to add it if anything needs it - by just uncommenting.
+        // signature: &'a [u8],
+        annex: Option<&'a [u8]>,
+    },
+    Script {
+        leaf_script: &'a Script,
+        control_block: &'a [u8],
+        annex: Option<&'a [u8]>,
+    },
+}
+
+impl<'a> P2TrSpend<'a> {
+    /// Parses `Witness` to determine what kind of taproot spend this is.
+    ///
+    /// Note: this assumes `witness` is a taproot spend. The function cannot figure it out for sure
+    /// (without knowing the output), so it doesn't attempt to check anything other than what is
+    /// required for the program to not crash.
+    ///
+    /// In other words, if the caller is certain that the witness is a valid p2tr spend (e.g.
+    /// obtained from Bitcoin Core) then it's OK to unwrap this but not vice versa - `Some` does
+    /// not imply correctness.
+    fn from_witness(witness: &'a Witness) -> Option<Self> {
+        // BIP341 says:
+        //   If there are at least two witness elements, and the first byte of
+        //   the last element is 0x50, this last element is called annex a
+        //   and is removed from the witness stack.
+        //
+        // However here we're not removing anything, so we have to adjust the numbers to account
+        // for the fact that annex is still there.
+        match witness.len() {
+            0 => None,
+            1 => Some(P2TrSpend::Key { /* signature: witness.last().expect("len > 0") ,*/ annex: None }),
+            2 if witness.last().expect("len > 0").starts_with(&[TAPROOT_ANNEX_PREFIX]) => {
+                let spend = P2TrSpend::Key {
+                    // signature: witness.second_to_last().expect("len > 1"),
+                    annex: witness.last(),
+                };
+                Some(spend)
+            },
+            // 2 => this is script spend without annex - same as when there are 3+ elements and the
+            //   last one does NOT start with TAPROOT_ANNEX_PREFIX. This is handled in the catchall
+            //   arm.
+            3.. if witness.last().expect("len > 0").starts_with(&[TAPROOT_ANNEX_PREFIX]) => {
+                let spend = P2TrSpend::Script {
+                    leaf_script: Script::from_bytes(witness.third_to_last().expect("len > 2")),
+                    control_block: witness.second_to_last().expect("len > 1"),
+                    annex: witness.last(),
+                };
+                Some(spend)
+            },
+            _ => {
+                let spend = P2TrSpend::Script {
+                    leaf_script: Script::from_bytes(witness.second_to_last().expect("len > 1")),
+                    control_block: witness.last().expect("len > 0"),
+                    annex: None,
+                };
+                Some(spend)
+            },
+        }
+    }
+
+    fn annex(&self) -> Option<&'a [u8]> {
+        match self {
+            P2TrSpend::Key { annex, .. } => *annex,
+            P2TrSpend::Script { annex, .. } => *annex,
+        }
+    }
+}
+
 impl<'a> Iterator for Iter<'a> {
     type Item = &'a [u8];
 

From 74138d56b1a8bdeb0c9ce0084c630f4193a03dd3 Mon Sep 17 00:00:00 2001
From: Martin Habovstiak <martin.habovstiak@gmail.com>
Date: Fri, 21 Feb 2025 15:34:39 +0100
Subject: [PATCH 04/53] Add a test case checking `taproot_control_block`

The previous commit fixed a bug when `taproot_control_block` returned
`Some` on key-spends. This adds a test case for it which succeeds when
applied after the previous commit and fails if applied before it.
---
 bitcoin/src/blockdata/witness.rs | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/bitcoin/src/blockdata/witness.rs b/bitcoin/src/blockdata/witness.rs
index 024418a0e..de36c15eb 100644
--- a/bitcoin/src/blockdata/witness.rs
+++ b/bitcoin/src/blockdata/witness.rs
@@ -848,19 +848,24 @@ mod test {
         let control_block = hex!("02");
         // annex starting with 0x50 causes the branching logic.
         let annex = hex!("50");
+        let signature = vec![0xff; 64];
 
         let witness_vec = vec![tapscript.clone(), control_block.clone()];
-        let witness_vec_annex = vec![tapscript.clone(), control_block.clone(), annex];
+        let witness_vec_annex = vec![tapscript.clone(), control_block.clone(), annex.clone()];
+        let witness_vec_key_spend_annex = vec![signature, annex];
 
         let witness_serialized: Vec<u8> = serialize(&witness_vec);
         let witness_serialized_annex: Vec<u8> = serialize(&witness_vec_annex);
+        let witness_serialized_key_spend_annex: Vec<u8> = serialize(&witness_vec_key_spend_annex);
 
         let witness = deserialize::<Witness>(&witness_serialized[..]).unwrap();
         let witness_annex = deserialize::<Witness>(&witness_serialized_annex[..]).unwrap();
+        let witness_key_spend_annex = deserialize::<Witness>(&witness_serialized_key_spend_annex[..]).unwrap();
 
         // With or without annex, the tapscript should be returned.
         assert_eq!(witness.taproot_control_block(), Some(&control_block[..]));
         assert_eq!(witness_annex.taproot_control_block(), Some(&control_block[..]));
+        assert!(witness_key_spend_annex.taproot_control_block().is_none())
     }
 
     #[test]

From 730baeb4e82a75b3e542124b0b34bfc325734f8b Mon Sep 17 00:00:00 2001
From: Martin Habovstiak <martin.habovstiak@gmail.com>
Date: Fri, 21 Feb 2025 16:33:00 +0100
Subject: [PATCH 05/53] Add `taproot_leaf_script` methood to `Witness`

We already have `tapscript` method on `Witness` which is broken because
it doesn't check that the leaf script is a tapscript, however that
behavior might have been intended by some consumers who want to inspect
the script independent of the version. To resolve the confusion, we're
going to add a new method that returns both the leaf script and, to
avoid forgetting version check, also the leaf version.

This doesn't touch the `tapscript` method yet to make backporting of
this commit easier. It's also worth noting that leaf script is often
used together with version. To make passing them around easier it'd be
helpful to use a separate type. Thus this also adds a public POD type
containing the script and the version. In anticipation of if being
usable in different APIs it's also generic over the script type.
Similarly to the `tapscript` method, this also only adds the type and
doesn't change other functions to use it yet. Only the newly added
`taproot_leaf_script` method uses it now.

This is a part of #4073
---
 bitcoin/src/blockdata/witness.rs | 44 +++++++++++++++++++++++++++++++-
 bitcoin/src/taproot/mod.rs       | 11 +++++++-
 2 files changed, 53 insertions(+), 2 deletions(-)

diff --git a/bitcoin/src/blockdata/witness.rs b/bitcoin/src/blockdata/witness.rs
index de36c15eb..6d159e0ae 100644
--- a/bitcoin/src/blockdata/witness.rs
+++ b/bitcoin/src/blockdata/witness.rs
@@ -14,7 +14,7 @@ use crate::consensus::encode::{Error, MAX_VEC_SIZE};
 use crate::consensus::{Decodable, Encodable, WriteExt};
 use crate::crypto::ecdsa;
 use crate::prelude::*;
-use crate::taproot::{self, TAPROOT_ANNEX_PREFIX};
+use crate::taproot::{self, LeafScript, LeafVersion, TAPROOT_ANNEX_PREFIX, TAPROOT_CONTROL_BASE_SIZE, TAPROOT_LEAF_MASK};
 use crate::{Script, VarInt};
 
 /// The Witness is the data used to unlock bitcoin since the [segwit upgrade].
@@ -412,6 +412,22 @@ impl Witness {
         }
     }
 
+    /// Returns the leaf script with its version but without the merkle proof.
+    ///
+    /// This does not guarantee that this represents a P2TR [`Witness`]. It
+    /// merely gets the second to last or third to last element depending on
+    /// the first byte of the last element being equal to 0x50 and the associated
+    /// version.
+    pub fn taproot_leaf_script(&self) -> Option<LeafScript<&Script>> {
+        match P2TrSpend::from_witness(self) {
+            Some(P2TrSpend::Script { leaf_script, control_block, .. }) if control_block.len() >= TAPROOT_CONTROL_BASE_SIZE => {
+                let version = LeafVersion::from_consensus(control_block[0] & TAPROOT_LEAF_MASK).ok()?;
+                Some(LeafScript { version, script: leaf_script, })
+            },
+            _ => None,
+        }
+    }
+
     /// Get the taproot control block following BIP341 rules.
     ///
     /// This does not guarantee that this represents a P2TR [`Witness`]. It
@@ -842,6 +858,32 @@ mod test {
         assert_eq!(witness_annex.tapscript(), None);
     }
 
+    #[test]
+    fn get_taproot_leaf_script() {
+        let tapscript = hex!("deadbeef");
+        let control_block = hex!("c0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+        // annex starting with 0x50 causes the branching logic.
+        let annex = hex!("50");
+
+        let witness_vec = vec![tapscript.clone(), control_block.clone()];
+        let witness_vec_annex = vec![tapscript.clone(), control_block, annex];
+
+        let witness_serialized: Vec<u8> = serialize(&witness_vec);
+        let witness_serialized_annex: Vec<u8> = serialize(&witness_vec_annex);
+
+        let witness = deserialize::<Witness>(&witness_serialized[..]).unwrap();
+        let witness_annex = deserialize::<Witness>(&witness_serialized_annex[..]).unwrap();
+
+        let expected_leaf_script = LeafScript {
+            version: LeafVersion::TapScript,
+            script: Script::from_bytes(&tapscript),
+        };
+
+        // With or without annex, the tapscript should be returned.
+        assert_eq!(witness.taproot_leaf_script().unwrap(), expected_leaf_script);
+        assert_eq!(witness_annex.taproot_leaf_script().unwrap(), expected_leaf_script);
+    }
+
     #[test]
     fn test_get_control_block() {
         let tapscript = hex!("deadbeef");
diff --git a/bitcoin/src/taproot/mod.rs b/bitcoin/src/taproot/mod.rs
index 60ce28ee0..656a3ccbf 100644
--- a/bitcoin/src/taproot/mod.rs
+++ b/bitcoin/src/taproot/mod.rs
@@ -158,7 +158,16 @@ pub const TAPROOT_CONTROL_BASE_SIZE: usize = 33;
 pub const TAPROOT_CONTROL_MAX_SIZE: usize =
     TAPROOT_CONTROL_BASE_SIZE + TAPROOT_CONTROL_NODE_SIZE * TAPROOT_CONTROL_MAX_NODE_COUNT;
 
-// type alias for versioned tap script corresponding merkle proof
+/// The leaf script with its version.
+#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)]
+pub struct LeafScript<S> {
+    /// The version of the script.
+    pub version: LeafVersion,
+    /// The script, usually `ScriptBuf` or `&Script`.
+    pub script: S,
+}
+
+// type alias for versioned tap script corresponding Merkle proof
 type ScriptMerkleProofMap = BTreeMap<(ScriptBuf, LeafVersion), BTreeSet<TaprootMerkleBranch>>;
 
 /// Represents taproot spending information.

From 9e87bc5b2cb39b6b7079507abfc0c1603a13d381 Mon Sep 17 00:00:00 2001
From: Martin Habovstiak <martin.habovstiak@gmail.com>
Date: Fri, 21 Feb 2025 18:09:29 +0100
Subject: [PATCH 06/53] Deprecate the `Witness::tapscript` method

Now that an alternative exists we can deprecate the method with an
expalantion of what's going on.
---
 bitcoin/src/blockdata/witness.rs | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/bitcoin/src/blockdata/witness.rs b/bitcoin/src/blockdata/witness.rs
index 6d159e0ae..77f426d65 100644
--- a/bitcoin/src/blockdata/witness.rs
+++ b/bitcoin/src/blockdata/witness.rs
@@ -395,13 +395,22 @@ impl Witness {
         self.element_at(pos)
     }
 
-    /// Get Tapscript following BIP341 rules regarding accounting for an annex.
+    /// Get leaf script following BIP341 rules regarding accounting for an annex.
+    ///
+    /// This method is broken: it's called `tapscript` but it's actually returning a leaf script.
+    /// We're not going to fix it because someone might be relying on it thinking leaf script and
+    /// tapscript are the same thing (they are not). Instead, this is deprecated and will be
+    /// removed in the next breaking release. You need to use `taproot_leaf_script` and if you
+    /// intended to use it as leaf script, just access the `script` field of the returned type. If
+    /// you intended tapscript specifically you have to check the version first and bail if it's not
+    /// `LeafVersion::TapScript`.
     ///
     /// This does not guarantee that this represents a P2TR [`Witness`]. It
     /// merely gets the second to last or third to last element depending on
     /// the first byte of the last element being equal to 0x50.
     ///
     /// See [`Script::is_p2tr`] to check whether this is actually a Taproot witness.
+    #[deprecated = "use `taproot_leaf_script` and check leaf version, if applicable"]
     pub fn tapscript(&self) -> Option<&Script> {
         match P2TrSpend::from_witness(self) {
             // Note: the method is named "tapscript" but historically it was actually returning

From 315750deb3a74f82f28c9b388f0f57a38ebd3e62 Mon Sep 17 00:00:00 2001
From: Andrew Poelstra <apoelstra@wpsoftware.net>
Date: Sat, 3 May 2025 13:08:15 +0000
Subject: [PATCH 07/53] bip32: return error when attempting to derive past
 maximum depth

The corresponding PR on master is #4387, but this doesn't really
resemble that PR. Rather than changing all the error enums, this just
adds a new variant to the #[non_exhaustive] bip32::Error enum and
returns that when adding 1 to 255 when deriving child keys.

This is therefore not an API break and can be released in a minor
version. Although it does change the error return on private derivation
from a "succeeds except with negligible probability" to "there is an
error path you may need to check for".

Fixes #4308
---
 bitcoin/src/bip32.rs | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/bitcoin/src/bip32.rs b/bitcoin/src/bip32.rs
index f15d121bf..ebc0dde2c 100644
--- a/bitcoin/src/bip32.rs
+++ b/bitcoin/src/bip32.rs
@@ -178,6 +178,9 @@ impl ChildNumber {
 
     /// Returns the child number that is a single increment from this one.
     pub fn increment(self) -> Result<ChildNumber, Error> {
+        // Bare addition in this function is okay, because we have an invariant that
+        // `index` is always within [0, 2^31 - 1]. FIXME this is not actually an
+        // invariant because the fields are public.
         match self {
             ChildNumber::Normal { index: idx } => ChildNumber::from_normal_idx(idx + 1),
             ChildNumber::Hardened { index: idx } => ChildNumber::from_hardened_idx(idx + 1),
@@ -481,6 +484,10 @@ pub type KeySource = (Fingerprint, DerivationPath);
 pub enum Error {
     /// A pk->pk derivation was attempted on a hardened key
     CannotDeriveFromHardenedKey,
+    /// Attempted to derive a child of depth 256 or higher.
+    ///
+    /// There is no way to encode such xkeys.
+    MaximumDepthExceeded,
     /// A secp256k1 error occurred
     Secp256k1(secp256k1::Error),
     /// A child number was provided that was out of range
@@ -512,6 +519,7 @@ impl fmt::Display for Error {
         match *self {
             CannotDeriveFromHardenedKey =>
                 f.write_str("cannot derive hardened key from public key"),
+            MaximumDepthExceeded => f.write_str("cannot derive child of depth 256 or higher"),
             Secp256k1(ref e) => write_err!(f, "secp256k1 error"; e),
             InvalidChildNumber(ref n) =>
                 write!(f, "child number {} is invalid (not within [0, 2^31 - 1])", n),
@@ -540,6 +548,7 @@ impl std::error::Error for Error {
             Hex(ref e) => Some(e),
             InvalidBase58PayloadLength(ref e) => Some(e),
             CannotDeriveFromHardenedKey
+            | MaximumDepthExceeded
             | InvalidChildNumber(_)
             | InvalidChildNumberFormat
             | InvalidDerivationPathFormat
@@ -636,7 +645,7 @@ impl Xpriv {
 
         Ok(Xpriv {
             network: self.network,
-            depth: self.depth + 1,
+            depth: self.depth.checked_add(1).ok_or(Error::MaximumDepthExceeded)?,
             parent_fingerprint: self.fingerprint(secp),
             child_number: i,
             private_key: tweaked,
@@ -768,7 +777,7 @@ impl Xpub {
 
         Ok(Xpub {
             network: self.network,
-            depth: self.depth + 1,
+            depth: self.depth.checked_add(1).ok_or(Error::MaximumDepthExceeded)?,
             parent_fingerprint: self.fingerprint(),
             child_number: i,
             public_key: tweaked,

From b75b2e36496674d2dd9964c726dbdd50b3d1ed01 Mon Sep 17 00:00:00 2001
From: Nadav Ivgi <nadav@shesek.info>
Date: Fri, 13 Sep 2024 11:28:17 +0300
Subject: [PATCH 08/53] Fix GetKey for sets to properly compare the fingerprint

---
 bitcoin/src/psbt/mod.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bitcoin/src/psbt/mod.rs b/bitcoin/src/psbt/mod.rs
index 3d428fdac..7c42d6dd3 100644
--- a/bitcoin/src/psbt/mod.rs
+++ b/bitcoin/src/psbt/mod.rs
@@ -807,7 +807,7 @@ impl GetKey for $set<Xpriv> {
             KeyRequest::Pubkey(_) => Err(GetKeyError::NotSupported),
             KeyRequest::Bip32((fingerprint, path)) => {
                 for xpriv in self.iter() {
-                    if xpriv.parent_fingerprint == fingerprint {
+                    if xpriv.fingerprint(secp) == fingerprint {
                         let k = xpriv.derive_priv(secp, &path)?;
                         return Ok(Some(k.to_priv()));
                     }

From d005ddd5249909bd8919a169abb5c7d6d2386ec1 Mon Sep 17 00:00:00 2001
From: Nadav Ivgi <nadav@shesek.info>
Date: Fri, 13 Sep 2024 11:35:32 +0300
Subject: [PATCH 09/53] Refactor GetKey for sets to internally use
 Xpriv::get_key()

---
 bitcoin/src/psbt/mod.rs | 17 +++++------------
 1 file changed, 5 insertions(+), 12 deletions(-)

diff --git a/bitcoin/src/psbt/mod.rs b/bitcoin/src/psbt/mod.rs
index 7c42d6dd3..7fd497b9d 100644
--- a/bitcoin/src/psbt/mod.rs
+++ b/bitcoin/src/psbt/mod.rs
@@ -803,18 +803,11 @@ impl GetKey for $set<Xpriv> {
         key_request: KeyRequest,
         secp: &Secp256k1<C>
     ) -> Result<Option<PrivateKey>, Self::Error> {
-        match key_request {
-            KeyRequest::Pubkey(_) => Err(GetKeyError::NotSupported),
-            KeyRequest::Bip32((fingerprint, path)) => {
-                for xpriv in self.iter() {
-                    if xpriv.fingerprint(secp) == fingerprint {
-                        let k = xpriv.derive_priv(secp, &path)?;
-                        return Ok(Some(k.to_priv()));
-                    }
-                }
-                Ok(None)
-            }
-        }
+        // OK to stop at the first error because Xpriv::get_key() can only fail
+        // if this isn't a KeyRequest::Bip32, which would fail for all Xprivs.
+        self.iter()
+            .find_map(|xpriv| xpriv.get_key(key_request.clone(), secp).transpose())
+            .transpose()
     }
 }}}
 impl_get_key_for_set!(BTreeSet);

From 2858b6cf801def1800a2cfd3287a38633d194a49 Mon Sep 17 00:00:00 2001
From: Nadav Ivgi <nadav@shesek.info>
Date: Fri, 13 Sep 2024 11:46:07 +0300
Subject: [PATCH 10/53] Support GetKey where the Xpriv is a direct child of the
 looked up KeySource

---
 bitcoin/src/psbt/mod.rs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/bitcoin/src/psbt/mod.rs b/bitcoin/src/psbt/mod.rs
index 7fd497b9d..69a0cf1cb 100644
--- a/bitcoin/src/psbt/mod.rs
+++ b/bitcoin/src/psbt/mod.rs
@@ -21,7 +21,7 @@ use std::collections::{HashMap, HashSet};
 use internals::write_err;
 use secp256k1::{Keypair, Message, Secp256k1, Signing, Verification};
 
-use crate::bip32::{self, KeySource, Xpriv, Xpub};
+use crate::bip32::{self, DerivationPath, KeySource, Xpriv, Xpub};
 use crate::blockdata::transaction::{self, Transaction, TxOut};
 use crate::crypto::key::{PrivateKey, PublicKey};
 use crate::crypto::{ecdsa, taproot};
@@ -764,6 +764,13 @@ impl GetKey for Xpriv {
                 let key = if self.fingerprint(secp) == fingerprint {
                     let k = self.derive_priv(secp, &path)?;
                     Some(k.to_priv())
+                } else if self.parent_fingerprint == fingerprint
+                    && !path.is_empty()
+                    && path[0] == self.child_number
+                {
+                    let path = DerivationPath::from_iter(path.into_iter().skip(1).copied());
+                    let k = self.derive_priv(secp, &path)?;
+                    Some(k.to_priv())
                 } else {
                     None
                 };

From 95eb2556b93da25a402e82eab1e032a0ececb67e Mon Sep 17 00:00:00 2001
From: Erick Cestari <erickcestari03@gmail.com>
Date: Fri, 14 Mar 2025 10:25:28 -0300
Subject: [PATCH 11/53] Add XOnlyPublicKey support for PSBT key retrieval and
 improve Taproot signing

This commit enhances PSBT signing functionality by:

1. Added new KeyRequest::XOnlyPubkey variant to support direct retrieval using XOnly public keys
2. Implemented GetKey for HashMap<XOnlyPublicKey, PrivateKey> for more efficient Taproot key management
3. Modified HashMap<PublicKey, PrivateKey> implementation to handle XOnlyPublicKey requests by checking both even and odd parity variants

These changes allow for more flexible key management in Taproot transactions.
Specifically, wallet implementations can now store keys indexed by either
PublicKey or XOnlyPublicKey and successfully sign PSBTs with Taproot inputs.

Added tests for both implementations to verify correct behavior.

Added test for odd parity key retrieval.

Closes #4150
---
 bitcoin/src/crypto/key.rs |  14 +++
 bitcoin/src/psbt/mod.rs   | 182 ++++++++++++++++++++++++++++++++++++--
 2 files changed, 187 insertions(+), 9 deletions(-)

diff --git a/bitcoin/src/crypto/key.rs b/bitcoin/src/crypto/key.rs
index f6a5a4735..c65b432bf 100644
--- a/bitcoin/src/crypto/key.rs
+++ b/bitcoin/src/crypto/key.rs
@@ -496,6 +496,20 @@ impl PrivateKey {
             inner: secp256k1::SecretKey::from_slice(&data[1..33])?,
         })
     }
+
+    /// Returns a new private key with the negated secret value.
+    ///
+    /// The resulting key corresponds to the same x-only public key (identical x-coordinate)
+    /// but with the opposite y-coordinate parity. This is useful for ensuring compatibility
+    /// with specific public key formats and BIP-340 requirements.
+    #[inline]
+    pub fn negate(&self) -> Self {
+        PrivateKey {
+            compressed: self.compressed,
+            network: self.network,
+            inner: self.inner.negate(),
+        }
+    }
 }
 
 impl fmt::Display for PrivateKey {
diff --git a/bitcoin/src/psbt/mod.rs b/bitcoin/src/psbt/mod.rs
index 69a0cf1cb..278d11ddf 100644
--- a/bitcoin/src/psbt/mod.rs
+++ b/bitcoin/src/psbt/mod.rs
@@ -423,6 +423,8 @@ impl Psbt {
                 k.get_key(KeyRequest::Bip32(key_source.clone()), secp)
             {
                 secret_key
+            } else if let Ok(Some(sk)) = k.get_key(KeyRequest::XOnlyPubkey(xonly), secp) {
+                sk
             } else {
                 continue;
             };
@@ -730,6 +732,8 @@ pub enum KeyRequest {
     Pubkey(PublicKey),
     /// Request a private key using BIP-32 fingerprint and derivation path.
     Bip32(KeySource),
+    /// Request a private key using the associated x-only public key.
+    XOnlyPubkey(XOnlyPublicKey),
 }
 
 /// Trait to get a private key from a key request, key is then used to sign an input.
@@ -760,6 +764,7 @@ impl GetKey for Xpriv {
     ) -> Result<Option<PrivateKey>, Self::Error> {
         match key_request {
             KeyRequest::Pubkey(_) => Err(GetKeyError::NotSupported),
+            KeyRequest::XOnlyPubkey(_) => Err(GetKeyError::NotSupported),
             KeyRequest::Bip32((fingerprint, path)) => {
                 let key = if self.fingerprint(secp) == fingerprint {
                     let k = self.derive_priv(secp, &path)?;
@@ -822,7 +827,7 @@ impl_get_key_for_set!(BTreeSet);
 impl_get_key_for_set!(HashSet);
 
 #[rustfmt::skip]
-macro_rules! impl_get_key_for_map {
+macro_rules! impl_get_key_for_pubkey_map {
     ($map:ident) => {
 
 impl GetKey for $map<PublicKey, PrivateKey> {
@@ -835,13 +840,67 @@ impl GetKey for $map<PublicKey, PrivateKey> {
     ) -> Result<Option<PrivateKey>, Self::Error> {
         match key_request {
             KeyRequest::Pubkey(pk) => Ok(self.get(&pk).cloned()),
+            KeyRequest::XOnlyPubkey(xonly) => {
+                let pubkey_even = PublicKey::new(xonly.public_key(secp256k1::Parity::Even));
+                let key = self.get(&pubkey_even).cloned();
+
+                if key.is_some() {
+                    return Ok(key);
+                }
+
+                let pubkey_odd = PublicKey::new(xonly.public_key(secp256k1::Parity::Odd));
+                if let Some(priv_key) = self.get(&pubkey_odd).copied() {
+                    let negated_priv_key  = priv_key.negate();
+                    return Ok(Some(negated_priv_key));
+                }
+
+                Ok(None)
+            },
+            KeyRequest::Bip32(_) => Err(GetKeyError::NotSupported),
+        }
+    }
+}}}
+impl_get_key_for_pubkey_map!(BTreeMap);
+#[cfg(feature = "std")]
+impl_get_key_for_pubkey_map!(HashMap);
+
+#[rustfmt::skip]
+macro_rules! impl_get_key_for_xonly_map {
+    ($map:ident) => {
+
+impl GetKey for $map<XOnlyPublicKey, PrivateKey> {
+    type Error = GetKeyError;
+
+    fn get_key<C: Signing>(
+        &self,
+        key_request: KeyRequest,
+        secp: &Secp256k1<C>,
+    ) -> Result<Option<PrivateKey>, Self::Error> {
+        match key_request {
+            KeyRequest::XOnlyPubkey(xonly) => Ok(self.get(&xonly).cloned()),
+            KeyRequest::Pubkey(pk) => {
+                let (xonly, parity) = pk.inner.x_only_public_key();
+
+                if let Some(mut priv_key) = self.get(&XOnlyPublicKey::from(xonly)).cloned() {
+                    let computed_pk = priv_key.public_key(&secp);
+                    let (_, computed_parity) = computed_pk.inner.x_only_public_key();
+
+                    if computed_parity != parity {
+                        priv_key = priv_key.negate();
+                    }
+
+                    return Ok(Some(priv_key));
+                }
+
+                Ok(None)
+            },
             KeyRequest::Bip32(_) => Err(GetKeyError::NotSupported),
         }
     }
 }}}
-impl_get_key_for_map!(BTreeMap);
+impl_get_key_for_xonly_map!(BTreeMap);
 #[cfg(feature = "std")]
-impl_get_key_for_map!(HashMap);
+impl_get_key_for_xonly_map!(HashMap);
 
 /// Errors when getting a key.
 #[derive(Debug, Clone, PartialEq, Eq)]
@@ -1208,7 +1267,14 @@ mod tests {
     use hashes::{hash160, ripemd160, sha256, Hash};
     use hex::{test_hex_unwrap as hex, FromHex};
     #[cfg(feature = "rand-std")]
-    use secp256k1::{All, SecretKey};
+    use {
+        crate::bip32::{DerivationPath, Fingerprint},
+        crate::key::WPubkeyHash,
+        crate::locktime,
+        crate::witness_version::WitnessVersion,
+        crate::WitnessProgram,
+        secp256k1::{All, SecretKey},
+    };
 
     use super::*;
     use crate::bip32::ChildNumber;
@@ -2138,7 +2204,43 @@ mod tests {
     }
 
     #[test]
-    fn test_fee() {
+    #[cfg(feature = "rand-std")]
+    fn pubkey_map_get_key_negates_odd_parity_keys() {
+        use crate::psbt::{GetKey, KeyRequest};
+
+        let (mut priv_key, mut pk, secp) = gen_keys();
+        let (xonly, parity) = pk.inner.x_only_public_key();
+
+        let mut pubkey_map: HashMap<PublicKey, PrivateKey> = HashMap::new();
+
+        if parity == secp256k1::Parity::Even {
+            priv_key = PrivateKey {
+                compressed: priv_key.compressed,
+                network: priv_key.network,
+                inner: priv_key.inner.negate(),
+            };
+            pk = priv_key.public_key(&secp);
+        }
+
+        pubkey_map.insert(pk, priv_key);
+
+        let req_result = pubkey_map.get_key(KeyRequest::XOnlyPubkey(xonly), &secp).unwrap();
+
+        let retrieved_key = req_result.unwrap();
+
+        let retrieved_pub_key = retrieved_key.public_key(&secp);
+        let (retrieved_xonly, retrieved_parity) = retrieved_pub_key.inner.x_only_public_key();
+
+        assert_eq!(xonly, retrieved_xonly);
+        assert_eq!(
+            retrieved_parity,
+            secp256k1::Parity::Even,
+            "Key should be normalized to have even parity, even when original had odd parity"
+        );
+    }
+
+    #[test]
+    fn fee() {
         let output_0_val = Amount::from_sat(99_999_699);
         let output_1_val = Amount::from_sat(100_000_000);
         let prev_output_val = Amount::from_sat(200_000_000);
@@ -2248,11 +2350,73 @@ mod tests {
 
     #[test]
     #[cfg(feature = "rand-std")]
-    fn sign_psbt() {
-        use crate::bip32::{DerivationPath, Fingerprint};
-        use crate::witness_version::WitnessVersion;
-        use crate::{WPubkeyHash, WitnessProgram};
+    fn hashmap_can_sign_taproot() {
+        let (priv_key, pk, secp) = gen_keys();
+        let internal_key: XOnlyPublicKey = pk.inner.into();
+
+        let tx = Transaction {
+            version: transaction::Version::TWO,
+            lock_time: locktime::absolute::LockTime::ZERO,
+            input: vec![TxIn::default()],
+            output: vec![TxOut { value: Amount::ZERO, script_pubkey: ScriptBuf::new() }],
+        };
+
+        let mut psbt = Psbt::from_unsigned_tx(tx).unwrap();
+        psbt.inputs[0].tap_internal_key = Some(internal_key);
+        psbt.inputs[0].witness_utxo = Some(transaction::TxOut {
+            value: Amount::from_sat(10),
+            script_pubkey: ScriptBuf::new_p2tr(&secp, internal_key, None),
+        });
 
+        let mut key_map: HashMap<PublicKey, PrivateKey> = HashMap::new();
+        key_map.insert(pk, priv_key);
+
+        let key_source = (Fingerprint::default(), DerivationPath::default());
+        let mut tap_key_origins = std::collections::BTreeMap::new();
+        tap_key_origins.insert(internal_key, (vec![], key_source));
+        psbt.inputs[0].tap_key_origins = tap_key_origins;
+
+        let signing_keys = psbt.sign(&key_map, &secp).unwrap();
+        assert_eq!(signing_keys.len(), 1);
+        assert_eq!(signing_keys[&0], SigningKeys::Schnorr(vec![internal_key]));
+    }
+
+    #[test]
+    #[cfg(feature = "rand-std")]
+    fn xonly_hashmap_can_sign_taproot() {
+        let (priv_key, pk, secp) = gen_keys();
+        let internal_key: XOnlyPublicKey = pk.inner.into();
+
+        let tx = Transaction {
+            version: transaction::Version::TWO,
+            lock_time: locktime::absolute::LockTime::ZERO,
+            input: vec![TxIn::default()],
+            output: vec![TxOut { value: Amount::ZERO, script_pubkey: ScriptBuf::new() }],
+        };
+
+        let mut psbt = Psbt::from_unsigned_tx(tx).unwrap();
+        psbt.inputs[0].tap_internal_key = Some(internal_key);
+        psbt.inputs[0].witness_utxo = Some(transaction::TxOut {
+            value: Amount::from_sat(10),
+            script_pubkey: ScriptBuf::new_p2tr(&secp, internal_key, None),
+        });
+
+        let mut xonly_key_map: HashMap<XOnlyPublicKey, PrivateKey> = HashMap::new();
+        xonly_key_map.insert(internal_key, priv_key);
+
+        let key_source = (Fingerprint::default(), DerivationPath::default());
+        let mut tap_key_origins = std::collections::BTreeMap::new();
+        tap_key_origins.insert(internal_key, (vec![], key_source));
+        psbt.inputs[0].tap_key_origins = tap_key_origins;
+
+        let signing_keys = psbt.sign(&xonly_key_map, &secp).unwrap();
+        assert_eq!(signing_keys.len(), 1);
+        assert_eq!(signing_keys[&0], SigningKeys::Schnorr(vec![internal_key]));
+    }
+
+    #[test]
+    #[cfg(feature = "rand-std")]
+    fn sign_psbt() {
         let unsigned_tx = Transaction {
             version: transaction::Version::TWO,
             lock_time: absolute::LockTime::ZERO,

From c67adcd64e9b425f2787629d50ecbcce465e1f5e Mon Sep 17 00:00:00 2001
From: Shing Him Ng <shinghim@protonmail.com>
Date: Sun, 20 Apr 2025 13:19:15 -0500
Subject: [PATCH 12/53] backport: Add methods to retrieve inner types

Backport #4373, authored by Shing Him Ng.

Original gitlog:

For TweakedKeypair, `to_inner` is also renamed to `to_keypair` to maintain
consistency. Similarly, `to_inner` is renamed to `to_x_only_pubkey` for
TweakedPublicKey

Co-authored-by: Shing Him Ng <shinghim@protonmail.com>
---
 bitcoin/examples/sign-tx-taproot.rs           |  2 +-
 bitcoin/examples/taproot-psbt.rs              |  2 +-
 .../src/blockdata/script/witness_program.rs   |  4 ++--
 bitcoin/src/crypto/key.rs                     | 21 +++++++++++++++++--
 bitcoin/src/psbt/mod.rs                       |  2 +-
 bitcoin/src/taproot/mod.rs                    |  8 +++----
 6 files changed, 28 insertions(+), 11 deletions(-)

diff --git a/bitcoin/examples/sign-tx-taproot.rs b/bitcoin/examples/sign-tx-taproot.rs
index 3221c560c..9dae0b2e0 100644
--- a/bitcoin/examples/sign-tx-taproot.rs
+++ b/bitcoin/examples/sign-tx-taproot.rs
@@ -72,7 +72,7 @@ fn main() {
     // Sign the sighash using the secp256k1 library (exported by rust-bitcoin).
     let tweaked: TweakedKeypair = keypair.tap_tweak(&secp, None);
     let msg = Message::from(sighash);
-    let signature = secp.sign_schnorr(&msg, &tweaked.to_inner());
+    let signature = secp.sign_schnorr(&msg, tweaked.as_keypair());
 
     // Update the witness stack.
     let signature = bitcoin::taproot::Signature { signature, sighash_type };
diff --git a/bitcoin/examples/taproot-psbt.rs b/bitcoin/examples/taproot-psbt.rs
index b5db05ab8..62f943196 100644
--- a/bitcoin/examples/taproot-psbt.rs
+++ b/bitcoin/examples/taproot-psbt.rs
@@ -734,7 +734,7 @@ fn sign_psbt_taproot(
 ) {
     let keypair = secp256k1::Keypair::from_seckey_slice(secp, secret_key.as_ref()).unwrap();
     let keypair = match leaf_hash {
-        None => keypair.tap_tweak(secp, psbt_input.tap_merkle_root).to_inner(),
+        None => keypair.tap_tweak(secp, psbt_input.tap_merkle_root).to_keypair(),
         Some(_) => keypair, // no tweak for script spend
     };
 
diff --git a/bitcoin/src/blockdata/script/witness_program.rs b/bitcoin/src/blockdata/script/witness_program.rs
index 9b76becc8..7a661f21c 100644
--- a/bitcoin/src/blockdata/script/witness_program.rs
+++ b/bitcoin/src/blockdata/script/witness_program.rs
@@ -90,13 +90,13 @@ impl WitnessProgram {
         merkle_root: Option<TapNodeHash>,
     ) -> Self {
         let (output_key, _parity) = internal_key.tap_tweak(secp, merkle_root);
-        let pubkey = output_key.to_inner().serialize();
+        let pubkey = output_key.as_x_only_public_key().serialize();
         WitnessProgram::new_p2tr(pubkey)
     }
 
     /// Creates a pay to taproot address from a pre-tweaked output key.
     pub fn p2tr_tweaked(output_key: TweakedPublicKey) -> Self {
-        let pubkey = output_key.to_inner().serialize();
+        let pubkey = output_key.as_x_only_public_key().serialize();
         WitnessProgram::new_p2tr(pubkey)
     }
 
diff --git a/bitcoin/src/crypto/key.rs b/bitcoin/src/crypto/key.rs
index f6a5a4735..a44a21b2e 100644
--- a/bitcoin/src/crypto/key.rs
+++ b/bitcoin/src/crypto/key.rs
@@ -841,9 +841,18 @@ impl TweakedPublicKey {
         TweakedPublicKey(key)
     }
 
-    /// Returns the underlying public key.
+    #[doc(hidden)]
+    #[deprecated(since="0.32.6", note="use to_x_only_public_key() instead")]
     pub fn to_inner(self) -> XOnlyPublicKey { self.0 }
 
+    /// Returns the underlying x-only public key.
+    #[inline]
+    pub fn to_x_only_public_key(self) -> XOnlyPublicKey { self.0 }
+
+    /// Returns a reference to the underlying x-only public key.
+    #[inline]
+    pub fn as_x_only_public_key(&self) -> &XOnlyPublicKey { &self.0 }
+
     /// Serialize the key as a byte-encoded pair of values. In compressed form
     /// the y-coordinate is represented by only a single bit, as x determines
     /// it up to one bit.
@@ -860,9 +869,17 @@ impl TweakedKeypair {
     #[inline]
     pub fn dangerous_assume_tweaked(pair: Keypair) -> TweakedKeypair { TweakedKeypair(pair) }
 
+    #[doc(hidden)]
+    #[deprecated(since="0.32.6", note="use to_keypair() instead")]
+    pub fn to_inner(self) -> Keypair { self.0 }
+
     /// Returns the underlying key pair.
     #[inline]
-    pub fn to_inner(self) -> Keypair { self.0 }
+    pub fn to_keypair(self) -> Keypair { self.0 }
+
+    /// Returns a reference to the underlying key pair.
+    #[inline]
+    pub fn as_keypair(&self) -> &Keypair { &self.0 }
 
     /// Returns the [`TweakedPublicKey`] and its [`Parity`] for this [`TweakedKeypair`].
     #[inline]
diff --git a/bitcoin/src/psbt/mod.rs b/bitcoin/src/psbt/mod.rs
index 3d428fdac..695af0011 100644
--- a/bitcoin/src/psbt/mod.rs
+++ b/bitcoin/src/psbt/mod.rs
@@ -442,7 +442,7 @@ impl Psbt {
                     let (msg, sighash_type) = self.sighash_taproot(input_index, cache, None)?;
                     let key_pair = Keypair::from_secret_key(secp, &sk.inner)
                         .tap_tweak(secp, input.tap_merkle_root)
-                        .to_inner();
+                        .to_keypair();
 
                     #[cfg(feature = "rand-std")]
                     let signature = secp.sign_schnorr(&msg, &key_pair);
diff --git a/bitcoin/src/taproot/mod.rs b/bitcoin/src/taproot/mod.rs
index 656a3ccbf..54576c578 100644
--- a/bitcoin/src/taproot/mod.rs
+++ b/bitcoin/src/taproot/mod.rs
@@ -1556,7 +1556,7 @@ mod test {
         let control_block =
             ControlBlock::decode(&Vec::<u8>::from_hex(control_block_hex).unwrap()).unwrap();
         assert_eq!(control_block_hex, control_block.serialize().to_lower_hex_string());
-        assert!(control_block.verify_taproot_commitment(secp, out_pk.to_inner(), &script));
+        assert!(control_block.verify_taproot_commitment(secp, out_pk.to_x_only_public_key(), &script));
     }
 
     #[test]
@@ -1663,7 +1663,7 @@ mod test {
             let ctrl_block = tree_info.control_block(&ver_script).unwrap();
             assert!(ctrl_block.verify_taproot_commitment(
                 &secp,
-                output_key.to_inner(),
+                output_key.to_x_only_public_key(),
                 &ver_script.0
             ))
         }
@@ -1738,7 +1738,7 @@ mod test {
             let ctrl_block = tree_info.control_block(&ver_script).unwrap();
             assert!(ctrl_block.verify_taproot_commitment(
                 &secp,
-                output_key.to_inner(),
+                output_key.to_x_only_public_key(),
                 &ver_script.0
             ))
         }
@@ -1854,7 +1854,7 @@ mod test {
             let addr = Address::p2tr(secp, internal_key, merkle_root, KnownHrp::Mainnet);
             let spk = addr.script_pubkey();
 
-            assert_eq!(expected_output_key, output_key.to_inner());
+            assert_eq!(expected_output_key, output_key.to_x_only_public_key());
             assert_eq!(expected_tweak, tweak);
             assert_eq!(expected_addr, addr);
             assert_eq!(expected_spk, spk);

From 916982a025d12ab98c9c878d33aae60cfb98102b Mon Sep 17 00:00:00 2001
From: "Tobin C. Harding" <me@tobin.cc>
Date: Tue, 6 May 2025 09:21:12 +1000
Subject: [PATCH 13/53] bitcoin: Bump version to 0.32.6

In preparation for release bump the version, add a changelog entry, and
update the lock files.
---
 Cargo-minimal.lock   | 2 +-
 Cargo-recent.lock    | 2 +-
 bitcoin/CHANGELOG.md | 8 ++++++++
 bitcoin/Cargo.toml   | 2 +-
 4 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/Cargo-minimal.lock b/Cargo-minimal.lock
index f28cbe79f..a335ef716 100644
--- a/Cargo-minimal.lock
+++ b/Cargo-minimal.lock
@@ -47,7 +47,7 @@ dependencies = [
 
 [[package]]
 name = "bitcoin"
-version = "0.32.5"
+version = "0.32.6"
 dependencies = [
  "base58ck",
  "base64",
diff --git a/Cargo-recent.lock b/Cargo-recent.lock
index dde2e6b31..65a7f1f37 100644
--- a/Cargo-recent.lock
+++ b/Cargo-recent.lock
@@ -46,7 +46,7 @@ dependencies = [
 
 [[package]]
 name = "bitcoin"
-version = "0.32.5"
+version = "0.32.6"
 dependencies = [
  "base58ck",
  "base64",
diff --git a/bitcoin/CHANGELOG.md b/bitcoin/CHANGELOG.md
index 1c5b03aae..c02599a3a 100644
--- a/bitcoin/CHANGELOG.md
+++ b/bitcoin/CHANGELOG.md
@@ -1,3 +1,11 @@
+# 0.32.6 - 2025-05-06
+
+- Backport - Fix `is_invalid_use_of_sighash_single()` incompatibility with Bitcoin Core [#4122](https://github.com/rust-bitcoin/rust-bitcoin/pull/4122)
+- Backport - Backport witness fixes [#4101](https://github.com/rust-bitcoin/rust-bitcoin/pull/4101)
+- Backport - bip32: Return error when attempting to derive past maximum depth [#4434](https://github.com/rust-bitcoin/rust-bitcoin/pull/4434)
+- Backport - Add `XOnlyPublicKey` support for PSBT key retrieval and improve Taproot signing [#4443](https://github.com/rust-bitcoin/rust-bitcoin/pull/4443)
+- Backport - Add methods to retrieve inner types [#4450](https://github.com/rust-bitcoin/rust-bitcoin/pull/4450)
+
 # 0.32.5 - 2024-11-27
 
 - Backport - Re-export `bech32` crate [#3662](https://github.com/rust-bitcoin/rust-bitcoin/pull/3662)
diff --git a/bitcoin/Cargo.toml b/bitcoin/Cargo.toml
index 70594e093..7cc56d124 100644
--- a/bitcoin/Cargo.toml
+++ b/bitcoin/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "bitcoin"
-version = "0.32.5"
+version = "0.32.6"
 authors = ["Andrew Poelstra <apoelstra@wpsoftware.net>"]
 license = "CC0-1.0"
 repository = "https://github.com/rust-bitcoin/rust-bitcoin/"

From c7b20f411ad03232a9b68455f7856638fe0bd413 Mon Sep 17 00:00:00 2001
From: "Tobin C. Harding" <me@tobin.cc>
Date: Sat, 24 May 2025 11:54:09 +1000
Subject: [PATCH 14/53] backport: Use _u32 in FeeRate constructor instead of
 _unchecked

Manually backport #4538.

If we use a `u32` then the constructor no longer panics. 32 bits is
plenty for an sane usage.
---
 units/src/fee_rate.rs | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/units/src/fee_rate.rs b/units/src/fee_rate.rs
index 9dcb88ddb..da686fdb2 100644
--- a/units/src/fee_rate.rs
+++ b/units/src/fee_rate.rs
@@ -37,10 +37,10 @@ impl FeeRate {
     /// Minimum fee rate required to broadcast a transaction.
     ///
     /// The value matches the default Bitcoin Core policy at the time of library release.
-    pub const BROADCAST_MIN: FeeRate = FeeRate::from_sat_per_vb_unchecked(1);
+    pub const BROADCAST_MIN: FeeRate = FeeRate::from_sat_per_vb_u32(1);
 
     /// Fee rate used to compute dust amount.
-    pub const DUST: FeeRate = FeeRate::from_sat_per_vb_unchecked(3);
+    pub const DUST: FeeRate = FeeRate::from_sat_per_vb_u32(3);
 
     /// Constructs `FeeRate` from satoshis per 1000 weight units.
     pub const fn from_sat_per_kwu(sat_kwu: u64) -> Self { FeeRate(sat_kwu) }
@@ -57,7 +57,14 @@ impl FeeRate {
         Some(FeeRate(sat_vb.checked_mul(1000 / 4)?))
     }
 
+    /// Constructs a new [`FeeRate`] from satoshis per virtual bytes.
+    pub const fn from_sat_per_vb_u32(sat_vb: u32) -> Self {
+        let sat_vb = sat_vb as u64; // No `Into` in const context.
+        FeeRate(sat_vb * (1000 / 4))
+    }
+
     /// Constructs `FeeRate` from satoshis per virtual bytes without overflow check.
+    #[deprecated(since = "0.32.7", note = "use from_sat_per_vb_u32 instead")]
     pub const fn from_sat_per_vb_unchecked(sat_vb: u64) -> Self { FeeRate(sat_vb * (1000 / 4)) }
 
     /// Returns raw fee rate.
@@ -168,16 +175,17 @@ mod tests {
     fn fee_rate_from_sat_per_vb_overflow_test() {
         let fee_rate = FeeRate::from_sat_per_vb(u64::MAX);
         assert!(fee_rate.is_none());
-    }
+    } 
 
     #[test]
-    fn from_sat_per_vb_unchecked_test() {
-        let fee_rate = FeeRate::from_sat_per_vb_unchecked(10);
+    fn from_sat_per_vb_u32() {
+        let fee_rate = FeeRate::from_sat_per_vb_u32(10);
         assert_eq!(FeeRate(2500), fee_rate);
     }
 
     #[test]
     #[cfg(debug_assertions)]
+    #[allow(deprecated)]        // Keep test until we remove the function.
     #[should_panic]
     fn from_sat_per_vb_unchecked_panic_test() { FeeRate::from_sat_per_vb_unchecked(u64::MAX); }
 

From c2481e4e824fddd86cef50d73f97ad590be2c55f Mon Sep 17 00:00:00 2001
From: "Tobin C. Harding" <me@tobin.cc>
Date: Tue, 8 Jul 2025 15:38:57 +1000
Subject: [PATCH 15/53] backport: Add support for pay to anchor outputs

Manually backport PR #4111. Of note, here we put `new_p2a` on
`ScriptBuf` instead of on the `script::Builder` because that seems to
be where all the other `new_foo` methods are in this release.

Note the `WitnessProgram::p2a` is conditionally const on Rust `v1.61`
because MSRV is only `v1.56.1`.

From the original patch:

    Add support for the newly created Pay2Anchor output-type.

    See https://github.com/bitcoin/bitcoin/pull/30352
---
 bitcoin/Cargo.toml                            |  2 +-
 bitcoin/src/address/mod.rs                    | 24 +++++++++++++++++++
 bitcoin/src/blockdata/script/owned.rs         | 12 +++++++---
 .../src/blockdata/script/witness_program.rs   | 15 ++++++++++++
 4 files changed, 49 insertions(+), 4 deletions(-)

diff --git a/bitcoin/Cargo.toml b/bitcoin/Cargo.toml
index 7cc56d124..dcfd8959e 100644
--- a/bitcoin/Cargo.toml
+++ b/bitcoin/Cargo.toml
@@ -81,4 +81,4 @@ required-features = ["std", "rand-std", "bitcoinconsensus"]
 name = "sighash"
 
 [lints.rust]
-unexpected_cfgs = { level = "deny", check-cfg = ['cfg(bench)', 'cfg(fuzzing)', 'cfg(kani)', 'cfg(mutate)', 'cfg(rust_v_1_60)'] }
+unexpected_cfgs = { level = "deny", check-cfg = ['cfg(bench)', 'cfg(fuzzing)', 'cfg(kani)', 'cfg(mutate)', 'cfg(rust_v_1_60)', 'cfg(rust_v_1_61)'] }
diff --git a/bitcoin/src/address/mod.rs b/bitcoin/src/address/mod.rs
index 7c546ae78..c05f32ac8 100644
--- a/bitcoin/src/address/mod.rs
+++ b/bitcoin/src/address/mod.rs
@@ -74,6 +74,8 @@ pub enum AddressType {
     P2wsh,
     /// Pay to taproot.
     P2tr,
+    /// Pay to anchor.
+    P2a
 }
 
 impl fmt::Display for AddressType {
@@ -84,6 +86,7 @@ impl fmt::Display for AddressType {
             AddressType::P2wpkh => "p2wpkh",
             AddressType::P2wsh => "p2wsh",
             AddressType::P2tr => "p2tr",
+            AddressType::P2a => "p2a",
         })
     }
 }
@@ -97,6 +100,7 @@ impl FromStr for AddressType {
             "p2wpkh" => Ok(AddressType::P2wpkh),
             "p2wsh" => Ok(AddressType::P2wsh),
             "p2tr" => Ok(AddressType::P2tr),
+            "p2a" => Ok(AddressType::P2a),
             _ => Err(UnknownAddressTypeError(s.to_owned())),
         }
     }
@@ -496,6 +500,8 @@ impl Address {
                     Some(AddressType::P2wsh)
                 } else if program.is_p2tr() {
                     Some(AddressType::P2tr)
+                } else if program.is_p2a() {
+                    Some(AddressType::P2a)
                 } else {
                     None
                 },
@@ -1367,4 +1373,22 @@ mod tests {
             }
         }
     }
+
+    #[test]
+    fn pay_to_anchor_address_regtest() {
+        // Verify that p2a uses the expected address for regtest.
+        // This test-vector is borrowed from the bitcoin source code.
+        let address_str = "bcrt1pfeesnyr2tx";
+
+        let script = ScriptBuf::new_p2a();
+        let address_unchecked = address_str.parse().unwrap();
+        let address = Address::from_script(&script, Network::Regtest).unwrap();
+        assert_eq!(address.as_unchecked(), &address_unchecked);
+        assert_eq!(address.to_string(), address_str);
+
+        // Verify that the address is considered standard
+        // and that the output type is P2a
+        assert!(address.is_spend_standard());
+        assert_eq!(address.address_type(), Some(AddressType::P2a));
+    }
 }
diff --git a/bitcoin/src/blockdata/script/owned.rs b/bitcoin/src/blockdata/script/owned.rs
index d7189488c..829ead845 100644
--- a/bitcoin/src/blockdata/script/owned.rs
+++ b/bitcoin/src/blockdata/script/owned.rs
@@ -8,7 +8,7 @@ use secp256k1::{Secp256k1, Verification};
 
 use crate::blockdata::opcodes::all::*;
 use crate::blockdata::opcodes::{self, Opcode};
-use crate::blockdata::script::witness_program::WitnessProgram;
+use crate::blockdata::script::witness_program::{WitnessProgram, P2A_PROGRAM};
 use crate::blockdata::script::witness_version::WitnessVersion;
 use crate::blockdata::script::{
     opcode_to_verify, Builder, Instruction, PushBytes, Script, ScriptHash, WScriptHash,
@@ -130,6 +130,11 @@ impl ScriptBuf {
         ScriptBuf::new_witness_program_unchecked(WitnessVersion::V1, output_key.serialize())
     }
 
+    /// Generates pay to anchor output.
+    pub fn new_p2a() -> Self {
+        ScriptBuf::new_witness_program_unchecked(WitnessVersion::V1, P2A_PROGRAM)
+    }
+
     /// Generates P2WSH-type of scriptPubkey with a given [`WitnessProgram`].
     pub fn new_witness_program(witness_program: &WitnessProgram) -> Self {
         Builder::new()
@@ -141,14 +146,15 @@ impl ScriptBuf {
     /// Generates P2WSH-type of scriptPubkey with a given [`WitnessVersion`] and the program bytes.
     /// Does not do any checks on version or program length.
     ///
-    /// Convenience method used by `new_p2wpkh`, `new_p2wsh`, `new_p2tr`, and `new_p2tr_tweaked`.
+    /// Convenience method used by `new_p2wpkh`, `new_p2wsh`, `new_p2tr`, and `new_p2tr_tweaked`,
+    /// and `new_p2a`.
     pub(crate) fn new_witness_program_unchecked<T: AsRef<PushBytes>>(
         version: WitnessVersion,
         program: T,
     ) -> Self {
         let program = program.as_ref();
         debug_assert!(program.len() >= 2 && program.len() <= 40);
-        // In segwit v0, the program must be 20 or 32 bytes long.
+        // In SegWit v0, the program must be either 20 (P2WPKH) bytes or 32 (P2WSH) bytes long
         debug_assert!(version != WitnessVersion::V0 || program.len() == 20 || program.len() == 32);
         Builder::new().push_opcode(version.into()).push_slice(program).into_script()
     }
diff --git a/bitcoin/src/blockdata/script/witness_program.rs b/bitcoin/src/blockdata/script/witness_program.rs
index 7a661f21c..2cf7101f2 100644
--- a/bitcoin/src/blockdata/script/witness_program.rs
+++ b/bitcoin/src/blockdata/script/witness_program.rs
@@ -24,6 +24,9 @@ pub const MIN_SIZE: usize = 2;
 /// The maximum byte size of a segregated witness program.
 pub const MAX_SIZE: usize = 40;
 
+/// The P2A program which is given by 0x4e73.
+pub(crate) const P2A_PROGRAM: [u8;2] = [78, 115];
+
 /// The segregated witness program.
 ///
 /// The segregated witness program is technically only the program bytes _excluding_ the witness
@@ -100,6 +103,13 @@ impl WitnessProgram {
         WitnessProgram::new_p2tr(pubkey)
     }
 
+    internals::const_tools::cond_const! {
+        /// Constructs a new pay to anchor address
+        pub const(in rust_v_1_61 = "1.61") fn p2a() -> Self {
+            WitnessProgram { version: WitnessVersion::V1, program: ArrayVec::from_slice(&P2A_PROGRAM)}
+        }
+    }
+
     /// Returns the witness program version.
     pub fn version(&self) -> WitnessVersion { self.version }
 
@@ -123,6 +133,11 @@ impl WitnessProgram {
 
     /// Returns true if this witness program is for a P2TR output.
     pub fn is_p2tr(&self) -> bool { self.version == WitnessVersion::V1 && self.program.len() == 32 }
+
+    /// Returns true if this is a pay to anchor output.
+    pub fn is_p2a(&self) -> bool {
+        self.version == WitnessVersion::V1 && self.program == P2A_PROGRAM
+    }
 }
 
 /// Witness program error.

From 3cf4a916e3599f2ede002d9358c7776571dcc70c Mon Sep 17 00:00:00 2001
From: "Tobin C. Harding" <me@tobin.cc>
Date: Wed, 2 Jul 2025 09:36:47 +1000
Subject: [PATCH 16/53] Remove non_exhausive from Network

Issue #2225 is long and has many valid opposing opinions. The main
argument for having non_exhaustive is that it helps future proof the
ecosystem at the cost of pain now. The main argument against having
non_exhaustive is why have pain now when adding a network is so rare
that having pain then is ok.

At the end of the thread Andrew posts:

> I continue to think we should have an exhaustive enum, with a bunch of
> documentation about how to use it properly. I am warming up to the
> "don't have an enum, just have rules for defining your own" but I think
> this would be needless work for people who just want to grab an
> off-the-shelf set of networks or people who want to make their own enum
> but want to see an example of how to do it first.

In order to make some forward progress lets remove the `non_exhaustive`
now and backport this change to 0.32, 0.31, an 0.30.

Later we can add, and release in 0.33, whatever forward protection /
libapocalyse protection we want to add.

This removes the pain now and gives us a path to prevent future pain -
that should keep all parties happy.
---
 bitcoin/src/network.rs | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/bitcoin/src/network.rs b/bitcoin/src/network.rs
index f16f2d5c7..8df48b0be 100644
--- a/bitcoin/src/network.rs
+++ b/bitcoin/src/network.rs
@@ -59,11 +59,19 @@ impl From<Network> for NetworkKind {
 }
 
 /// The cryptocurrency network to act on.
+///
+/// This is an exhaustive enum, meaning that we cannot add any future networks without defining a
+/// new, incompatible version of this type. If you are using this type directly and wish to support the
+/// new network, this will be a breaking change to your APIs and likely require changes in your code.
+///
+/// If you are concerned about forward compatibility, consider using `T: Into<Params>` instead of
+/// this type as a parameter to functions in your public API, or directly using the `Params` type.
+// For extensive discussion on the usage of `non_exhaustive` please see:
+// https://github.com/rust-bitcoin/rust-bitcoin/issues/2225
 #[derive(Copy, PartialEq, Eq, PartialOrd, Ord, Clone, Hash, Debug)]
 #[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
 #[cfg_attr(feature = "serde", serde(crate = "actual_serde"))]
 #[cfg_attr(feature = "serde", serde(rename_all = "lowercase"))]
-#[non_exhaustive]
 pub enum Network {
     /// Mainnet Bitcoin.
     Bitcoin,

From 571cd7f33ec82e7febd708d0e5984b6367f7a361 Mon Sep 17 00:00:00 2001
From: "Tobin C. Harding" <me@tobin.cc>
Date: Wed, 30 Jul 2025 11:10:31 +1000
Subject: [PATCH 17/53] bitcoin: Bump version to 0.32.7

In preparation for release bump the version, add a changelog entry,
and update the lock files.
---
 Cargo-minimal.lock   | 2 +-
 Cargo-recent.lock    | 2 +-
 bitcoin/CHANGELOG.md | 6 ++++++
 bitcoin/Cargo.toml   | 2 +-
 4 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/Cargo-minimal.lock b/Cargo-minimal.lock
index a335ef716..8b47f1e59 100644
--- a/Cargo-minimal.lock
+++ b/Cargo-minimal.lock
@@ -47,7 +47,7 @@ dependencies = [
 
 [[package]]
 name = "bitcoin"
-version = "0.32.6"
+version = "0.32.7"
 dependencies = [
  "base58ck",
  "base64",
diff --git a/Cargo-recent.lock b/Cargo-recent.lock
index 65a7f1f37..9f49d4c0c 100644
--- a/Cargo-recent.lock
+++ b/Cargo-recent.lock
@@ -46,7 +46,7 @@ dependencies = [
 
 [[package]]
 name = "bitcoin"
-version = "0.32.6"
+version = "0.32.7"
 dependencies = [
  "base58ck",
  "base64",
diff --git a/bitcoin/CHANGELOG.md b/bitcoin/CHANGELOG.md
index c02599a3a..caa0de726 100644
--- a/bitcoin/CHANGELOG.md
+++ b/bitcoin/CHANGELOG.md
@@ -1,3 +1,9 @@
+# 0.32.7 - 2025-07-30
+
+- Backport - Use `_u32` in `FeeRate` constructor instead of `_unchecked` [#4552](https://github.com/rust-bitcoin/rust-bitcoin/pull/4552)
+- Backport - Add support for pay to anchor outputs [#4691](https://github.com/rust-bitcoin/rust-bitcoin/pull/4691)
+- Backport - Remove `non_exhaustive` from `Network` [#4658](https://github.com/rust-bitcoin/rust-bitcoin/pull/4658)
+
 # 0.32.6 - 2025-05-06
 
 - Backport - Fix `is_invalid_use_of_sighash_single()` incompatibility with Bitcoin Core [#4122](https://github.com/rust-bitcoin/rust-bitcoin/pull/4122)
diff --git a/bitcoin/Cargo.toml b/bitcoin/Cargo.toml
index dcfd8959e..1dc142e0a 100644
--- a/bitcoin/Cargo.toml
+++ b/bitcoin/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "bitcoin"
-version = "0.32.6"
+version = "0.32.7"
 authors = ["Andrew Poelstra <apoelstra@wpsoftware.net>"]
 license = "CC0-1.0"
 repository = "https://github.com/rust-bitcoin/rust-bitcoin/"

From 17a424173c83200b23dda0b4677ebd50def5ef5a Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 11:53:34 +0200
Subject: [PATCH 18/53] chore(workflow): update labeler workflow to use
 doge-master instead of master branch

---
 .github/workflows/manage-pr.yml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/manage-pr.yml b/.github/workflows/manage-pr.yml
index 1ae250017..3ba1dcc55 100644
--- a/.github/workflows/manage-pr.yml
+++ b/.github/workflows/manage-pr.yml
@@ -9,18 +9,18 @@ jobs:
       pull-requests: write
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout master
+      - name: Checkout doge-master
         uses: actions/checkout@v4
         with:
-          path: master
+          path: doge-master
       - name: Checkout merge commit
         uses: actions/checkout@v4
         with:
           path: merge
           ref: "refs/pull/${{ github.event.number }}/merge"
       - name: Generate label config
-        run: cd master && SCAN_DIR=../merge ./contrib/gen_label_config.sh
+        run: cd doge-master && SCAN_DIR=../merge ./contrib/gen_label_config.sh
       - name: Update labels
         uses: actions/labeler@v5
         with:
-          configuration-path: master/.github/labeler.yml
+          configuration-path: doge-master/.github/labeler.yml

From 2c3f453de903e5c3c00001e0edd07f5ffb730155 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 12:54:49 +0200
Subject: [PATCH 19/53] chore(workflow): update labeler permissions to allow
 writing issues

---
 .github/workflows/manage-pr.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/manage-pr.yml b/.github/workflows/manage-pr.yml
index 3ba1dcc55..885382208 100644
--- a/.github/workflows/manage-pr.yml
+++ b/.github/workflows/manage-pr.yml
@@ -6,6 +6,7 @@ jobs:
   labeler:
     permissions:
       contents: read
+      issues: write
       pull-requests: write
     runs-on: ubuntu-latest
     steps:

From 22dc185b872186a642451696e1ce8da2200d57f2 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Fri, 23 May 2025 16:37:02 +0200
Subject: [PATCH 20/53] chore(dogecoin): set up crate

---
 .gitignore         |  3 +++
 bitcoin/Cargo.toml | 10 ++++------
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/.gitignore b/.gitignore
index 6055dd863..358b1850c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -18,3 +18,6 @@ bitcoin/dep_test
 # Fuzz artifacts
 hfuzz_target
 hfuzz_workspace
+
+# IDEA IDE files
+.idea/
\ No newline at end of file
diff --git a/bitcoin/Cargo.toml b/bitcoin/Cargo.toml
index 1dc142e0a..8c9f6ae8a 100644
--- a/bitcoin/Cargo.toml
+++ b/bitcoin/Cargo.toml
@@ -1,13 +1,11 @@
 [package]
 name = "bitcoin"
-version = "0.32.7"
-authors = ["Andrew Poelstra <apoelstra@wpsoftware.net>"]
+version = "0.32.5-doge.0"
 license = "CC0-1.0"
-repository = "https://github.com/rust-bitcoin/rust-bitcoin/"
-documentation = "https://docs.rs/bitcoin/"
-description = "General purpose library for using and interoperating with Bitcoin."
+repository = "https://github.com/rust-dogecoin/rust-dogecoin/"
+description = "General purpose library for using and interoperating with Bitcoin and Dogecoin."
 categories = ["cryptography::cryptocurrencies"]
-keywords = [ "crypto", "bitcoin" ]
+keywords = [ "crypto", "bitcoin", "dogecoin"]
 readme = "../README.md"
 edition = "2021"
 rust-version = "1.56.1"

From d812d42c333e075ee491ad957c89fde8d2414520 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Fri, 23 May 2025 16:37:17 +0200
Subject: [PATCH 21/53] feat(dogecoin): add dogecoin AuxPow and Block

---
 bitcoin/src/dogecoin/mod.rs | 107 ++++++++++++++++++++++++++++++++++++
 bitcoin/src/lib.rs          |   1 +
 2 files changed, 108 insertions(+)
 create mode 100644 bitcoin/src/dogecoin/mod.rs

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
new file mode 100644
index 000000000..46e9fedbb
--- /dev/null
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -0,0 +1,107 @@
+use crate::block::Header;
+use crate::{io, BlockHash, Transaction};
+use crate::consensus::{encode, Decodable, Encodable};
+use crate::io::{Read, Write};
+use crate::block::TxMerkleNode;
+use crate::internal_macros::impl_consensus_encoding;
+
+/// AuxPow version bit, see https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23
+pub const VERSION_AUXPOW: i32 = 1 << 8;
+
+fn is_auxpow(header: Header) -> bool {
+    (header.version.to_consensus() & VERSION_AUXPOW) != 0
+}
+
+/// Data for merge-mining AuxPoW.
+///
+/// It contains the parent block's coinbase tx that can be verified to be in the parent block.
+/// The transaction's input contains the hash to the actual merge-mined block.
+#[derive(Clone, PartialEq, Eq, PartialOrd, Ord, Debug, Hash)]
+pub struct AuxPow {
+    /// The parent block's coinbase tx.
+    pub coinbase_tx: Transaction,
+    /// The parent block's hash.
+    pub parent_hash: BlockHash,
+    /// The Merkle branch linking the coinbase tx to the parent block's Merkle root.
+    pub coinbase_branch: Vec<TxMerkleNode>,
+    /// The index of the coinbase tx in the Merkle tree.
+    pub coinbase_index: i32,
+    /// The Merkle branch linking the merge-mined block to the coinbase tx.
+    pub blockchain_branch: Vec<TxMerkleNode>,
+    /// The index of the merged-mined block in the Merkle tree.
+    pub blockchain_index: i32,
+    /// Parent block header (on which the PoW is done).
+    pub parent_block: Header,
+}
+
+impl_consensus_encoding!(
+    AuxPow,
+    coinbase_tx,
+    parent_hash,
+    coinbase_branch,
+    coinbase_index,
+    blockchain_branch,
+    blockchain_index,
+    parent_block
+);
+
+/// Dogecoin block.
+///
+/// A collection of transactions with an attached proof of work.
+/// The AuxPoW is present if the block was mined using merge-mining.
+///
+/// See [Bitcoin Wiki: Block][wiki-block] and [Bitcoin Wiki: Merged_mining_specification][merge-mining]
+/// for more information.
+///
+/// [wiki-block]: https://en.bitcoin.it/wiki/Block
+/// [merge-mining]: https://en.bitcoin.it/wiki/Merged_mining_specification
+///
+/// ### Dogecoin Core References
+///
+/// * [CBlock definition](https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/block.h#L65)
+#[derive(PartialEq, Eq, Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
+#[cfg_attr(feature = "serde", serde(crate = "actual_serde"))]
+pub struct Block {
+    /// The block header.
+    pub header: Header,
+    /// AuxPoW structure, present if merged mining was used to mine this block.
+    pub auxpow: Option<AuxPow>,
+    /// List of transactions contained in the block.
+    pub txdata: Vec<Transaction>,
+}
+
+impl Block {
+    /// Returns the block hash computed as SHA256d(header).
+    pub fn block_hash(&self) -> BlockHash { self.header.block_hash() }
+}
+
+impl Decodable for Block {
+    #[inline]
+    fn consensus_decode_from_finite_reader<R: Read + ?Sized>(
+        r: &mut R,
+    ) -> Result<Self, encode::Error> {
+        let header: Header = Decodable::consensus_decode_from_finite_reader(r)?;
+        let auxpow = if is_auxpow(header) {
+            Some(Decodable::consensus_decode_from_finite_reader(r)?)
+        } else {
+            None
+        };
+        let txdata = Decodable::consensus_decode_from_finite_reader(r)?;
+
+        Ok(Self { header, auxpow, txdata })
+    }
+}
+
+impl Encodable for Block {
+    #[inline]
+    fn consensus_encode<W: Write + ?Sized>(&self, w: &mut W) -> Result<usize, io::Error> {
+        let mut len = 0;
+        len += self.header.consensus_encode(w)?;
+        if let Some(ref auxpow) = self.auxpow {
+            len += auxpow.consensus_encode(w)?;
+        }
+        len += self.txdata.consensus_encode(w)?;
+        Ok(len)
+    }
+}
\ No newline at end of file
diff --git a/bitcoin/src/lib.rs b/bitcoin/src/lib.rs
index d6d99c292..c335874e9 100644
--- a/bitcoin/src/lib.rs
+++ b/bitcoin/src/lib.rs
@@ -105,6 +105,7 @@ pub mod blockdata;
 pub mod consensus;
 // Private until we either make this a crate or flatten it - still to be decided.
 pub(crate) mod crypto;
+pub mod dogecoin;
 pub mod error;
 pub mod hash_types;
 pub mod merkle_tree;

From c463c5b636d2d534538ba8bacd32c87f226a5212 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Fri, 23 May 2025 16:55:49 +0200
Subject: [PATCH 22/53] feat(dogecoin): add module documentation and update
 AuxPow struct

---
 bitcoin/src/dogecoin/mod.rs | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index 46e9fedbb..31c031627 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -1,3 +1,8 @@
+//! Dogecoin module.
+//!
+//! This module provides support for de/serialization, parsing and execution on data structures and
+//! network messages related to Dogecoin.
+
 use crate::block::Header;
 use crate::{io, BlockHash, Transaction};
 use crate::consensus::{encode, Decodable, Encodable};
@@ -16,7 +21,9 @@ fn is_auxpow(header: Header) -> bool {
 ///
 /// It contains the parent block's coinbase tx that can be verified to be in the parent block.
 /// The transaction's input contains the hash to the actual merge-mined block.
-#[derive(Clone, PartialEq, Eq, PartialOrd, Ord, Debug, Hash)]
+#[derive(PartialEq, Eq, Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
+#[cfg_attr(feature = "serde", serde(crate = "actual_serde"))]
 pub struct AuxPow {
     /// The parent block's coinbase tx.
     pub coinbase_tx: Transaction,

From 9a1c94fcf816abb6fb489fbef9eaee12da8615ae Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Fri, 23 May 2025 17:13:08 +0200
Subject: [PATCH 23/53] add prelude import

---
 bitcoin/src/dogecoin/mod.rs | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index 31c031627..ba84d1da7 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -4,11 +4,12 @@
 //! network messages related to Dogecoin.
 
 use crate::block::Header;
-use crate::{io, BlockHash, Transaction};
-use crate::consensus::{encode, Decodable, Encodable};
-use crate::io::{Read, Write};
 use crate::block::TxMerkleNode;
+use crate::consensus::{encode, Decodable, Encodable};
 use crate::internal_macros::impl_consensus_encoding;
+use crate::io::{Read, Write};
+use crate::prelude::*;
+use crate::{io, BlockHash, Transaction};
 
 /// AuxPow version bit, see https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23
 pub const VERSION_AUXPOW: i32 = 1 << 8;
@@ -80,7 +81,9 @@ pub struct Block {
 
 impl Block {
     /// Returns the block hash computed as SHA256d(header).
-    pub fn block_hash(&self) -> BlockHash { self.header.block_hash() }
+    pub fn block_hash(&self) -> BlockHash {
+        self.header.block_hash()
+    }
 }
 
 impl Decodable for Block {
@@ -111,4 +114,4 @@ impl Encodable for Block {
         len += self.txdata.consensus_encode(w)?;
         Ok(len)
     }
-}
\ No newline at end of file
+}

From 91b5c2b022ad5694dcc00307169b2a803b7fd6b1 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Fri, 23 May 2025 17:21:37 +0200
Subject: [PATCH 24/53] update lock file

---
 Cargo.lock | 492 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 492 insertions(+)
 create mode 100644 Cargo.lock

diff --git a/Cargo.lock b/Cargo.lock
new file mode 100644
index 000000000..28a4b973c
--- /dev/null
+++ b/Cargo.lock
@@ -0,0 +1,492 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "anyhow"
+version = "1.0.98"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e16d2d3311acee920a9eb8d33b8cbc1787ce4a264e85f964c2404b969bdcd487"
+
+[[package]]
+name = "arrayvec"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50"
+
+[[package]]
+name = "base58ck"
+version = "0.1.0"
+dependencies = [
+ "bitcoin-internals",
+ "bitcoin_hashes",
+ "hex-conservative",
+]
+
+[[package]]
+name = "base64"
+version = "0.21.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
+
+[[package]]
+name = "bech32"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d965446196e3b7decd44aa7ee49e31d630118f90ef12f97900f262eb915c951d"
+
+[[package]]
+name = "bincode"
+version = "1.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b1f45e9417d87227c7a56d22e471c6206462cba514c7590c09aff4cf6d1ddcad"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "bitcoin"
+version = "0.32.5-doge.0"
+dependencies = [
+ "base58ck",
+ "base64",
+ "bech32",
+ "bincode",
+ "bitcoin-internals",
+ "bitcoin-io",
+ "bitcoin-units",
+ "bitcoin_hashes",
+ "bitcoinconsensus",
+ "hex-conservative",
+ "hex_lit",
+ "mutagen",
+ "ordered",
+ "secp256k1",
+ "serde",
+ "serde_json",
+ "serde_test",
+]
+
+[[package]]
+name = "bitcoin-fuzz"
+version = "0.0.1"
+dependencies = [
+ "bitcoin",
+ "honggfuzz",
+ "serde",
+ "serde_cbor",
+ "serde_json",
+]
+
+[[package]]
+name = "bitcoin-internals"
+version = "0.3.0"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "bitcoin-io"
+version = "0.1.2"
+
+[[package]]
+name = "bitcoin-units"
+version = "0.1.1"
+dependencies = [
+ "bitcoin-internals",
+ "serde",
+ "serde_json",
+ "serde_test",
+]
+
+[[package]]
+name = "bitcoin_hashes"
+version = "0.14.0"
+dependencies = [
+ "bitcoin-io",
+ "hex-conservative",
+ "schemars",
+ "serde",
+ "serde_json",
+ "serde_test",
+]
+
+[[package]]
+name = "bitcoinconsensus"
+version = "0.105.0+25.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f260ac8fb2c621329013fc0ed371c940fcc512552dcbcb9095ed0179098c9e18"
+dependencies = [
+ "cc",
+]
+
+[[package]]
+name = "byteorder"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
+
+[[package]]
+name = "cc"
+version = "1.2.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "16595d3be041c03b09d08d0858631facccee9221e579704070e6e9e4915d3bc7"
+dependencies = [
+ "shlex",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+
+[[package]]
+name = "dyn-clone"
+version = "1.0.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1c7a8fb8a9fbf66c1f703fe16184d10ca0ee9d23be5b4436400408ba54a95005"
+
+[[package]]
+name = "getrandom"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi",
+]
+
+[[package]]
+name = "half"
+version = "1.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1b43ede17f21864e81be2fa654110bf1e793774238d86ef8555c37e6519c0403"
+
+[[package]]
+name = "hex-conservative"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5313b072ce3c597065a808dbf612c4c8e8590bdbf8b579508bf7a762c5eae6cd"
+dependencies = [
+ "arrayvec",
+]
+
+[[package]]
+name = "hex_lit"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3011d1213f159867b13cfd6ac92d2cd5f1345762c63be3554e84092d85a50bbd"
+
+[[package]]
+name = "honggfuzz"
+version = "0.5.57"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc563d4f41b17364d5c48ded509f2bcf1c3f6ae9c7f203055b4a5c325072d57e"
+dependencies = [
+ "lazy_static",
+ "memmap2",
+ "rustc_version",
+ "semver",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4a5f13b858c8d314ee3e8f639011f7ccefe71f97f96e50151fb991f267928e2c"
+
+[[package]]
+name = "json"
+version = "0.12.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "078e285eafdfb6c4b434e0d31e8cfcb5115b651496faca5749b88fafd4f23bfd"
+
+[[package]]
+name = "lazy_static"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
+
+[[package]]
+name = "libc"
+version = "0.2.172"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d750af042f7ef4f724306de029d18836c26c1765a54a6a3f094cbd23a7267ffa"
+
+[[package]]
+name = "memchr"
+version = "2.7.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
+
+[[package]]
+name = "memmap2"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fd3f7eed9d3848f8b98834af67102b720745c4ec028fcd0aa0239277e7de374f"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "mutagen"
+version = "0.2.0"
+source = "git+https://github.com/llogiq/mutagen#a6377c4c3f360afeb7a287c1c17e4b69456d5f53"
+dependencies = [
+ "mutagen-core",
+ "mutagen-transform",
+]
+
+[[package]]
+name = "mutagen-core"
+version = "0.2.0"
+source = "git+https://github.com/llogiq/mutagen#a6377c4c3f360afeb7a287c1c17e4b69456d5f53"
+dependencies = [
+ "anyhow",
+ "json",
+ "lazy_static",
+ "proc-macro2",
+ "quote",
+ "serde",
+ "serde_json",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "mutagen-transform"
+version = "0.2.0"
+source = "git+https://github.com/llogiq/mutagen#a6377c4c3f360afeb7a287c1c17e4b69456d5f53"
+dependencies = [
+ "mutagen-core",
+ "proc-macro2",
+]
+
+[[package]]
+name = "ordered"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f0642533dea0bb58bd5cae31bafc1872429f0f12ac8c61fe2b4ba44f80b959b"
+
+[[package]]
+name = "ppv-lite86"
+version = "0.2.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9"
+dependencies = [
+ "zerocopy",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.95"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02b3e5e68a3a1a02aad3ec490a98007cbc13c37cbe84a3cd7b8e406d76e7f778"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.40"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rand"
+version = "0.8.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
+dependencies = [
+ "libc",
+ "rand_chacha",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_chacha"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
+dependencies = [
+ "ppv-lite86",
+ "rand_core",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
+dependencies = [
+ "getrandom",
+]
+
+[[package]]
+name = "rustc_version"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92"
+dependencies = [
+ "semver",
+]
+
+[[package]]
+name = "ryu"
+version = "1.0.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "28d3b2b1366ec20994f1fd18c3c594f05c5dd4bc44d8bb0c1c632c8d6829481f"
+
+[[package]]
+name = "schemars"
+version = "0.8.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3fbf2ae1b8bc8e02df939598064d22402220cd5bbcca1c76f7d6a310974d5615"
+dependencies = [
+ "dyn-clone",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "secp256k1"
+version = "0.29.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9465315bc9d4566e1724f0fffcbcc446268cb522e60f9a27bcded6b19c108113"
+dependencies = [
+ "bitcoin_hashes",
+ "rand",
+ "secp256k1-sys",
+ "serde",
+]
+
+[[package]]
+name = "secp256k1-sys"
+version = "0.10.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d4387882333d3aa8cb20530a17c69a3752e97837832f34f6dccc760e715001d9"
+dependencies = [
+ "cc",
+]
+
+[[package]]
+name = "semver"
+version = "1.0.26"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "56e6fa9c48d24d85fb3de5ad847117517440f6beceb7798af16b4a87d616b8d0"
+
+[[package]]
+name = "serde"
+version = "1.0.219"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5f0e2c6ed6606019b4e29e69dbaba95b11854410e5347d525002456dbbb786b6"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_cbor"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "45cd6d95391b16cd57e88b68be41d504183b7faae22030c0cc3b3f73dd57b2fd"
+dependencies = [
+ "byteorder",
+ "half",
+ "serde",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.219"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5b0276cf7f2c73365f7157c8123c21cd9a50fbbd844757af28ca1f5925fc2a00"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.101",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.140"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "20068b6e96dc6c9bd23e01df8827e6c7e1f2fddd43c21810382803c136b99373"
+dependencies = [
+ "itoa",
+ "memchr",
+ "ryu",
+ "serde",
+]
+
+[[package]]
+name = "serde_test"
+version = "1.0.177"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f901ee573cab6b3060453d2d5f0bae4e6d628c23c0a962ff9b5f1d7c8d4f1ed"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
+[[package]]
+name = "syn"
+version = "1.0.109"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.101"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ce2b7fc941b3a24138a0a7cf8e858bfc6a992e7978a068a5c760deb0ed43caf"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"
+
+[[package]]
+name = "wasi"
+version = "0.11.0+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
+
+[[package]]
+name = "zerocopy"
+version = "0.8.25"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a1702d9583232ddb9174e01bb7c15a2ab8fb1bc6f227aa1233858c351a3ba0cb"
+dependencies = [
+ "zerocopy-derive",
+]
+
+[[package]]
+name = "zerocopy-derive"
+version = "0.8.25"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "28a6e20d751156648aa063f3800b706ee209a32c0b4d9f24be3d980b01be55ef"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.101",
+]

From e44902c8d89160de1a9f0439e969801fd0c2f3a2 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Fri, 23 May 2025 17:24:17 +0200
Subject: [PATCH 25/53] Revert "update lock file"

This reverts commit bcfcca930c6a4af684a0faa6d05f8abbb491f5ae.
---
 Cargo.lock | 492 -----------------------------------------------------
 1 file changed, 492 deletions(-)
 delete mode 100644 Cargo.lock

diff --git a/Cargo.lock b/Cargo.lock
deleted file mode 100644
index 28a4b973c..000000000
--- a/Cargo.lock
+++ /dev/null
@@ -1,492 +0,0 @@
-# This file is automatically @generated by Cargo.
-# It is not intended for manual editing.
-version = 3
-
-[[package]]
-name = "anyhow"
-version = "1.0.98"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e16d2d3311acee920a9eb8d33b8cbc1787ce4a264e85f964c2404b969bdcd487"
-
-[[package]]
-name = "arrayvec"
-version = "0.7.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7c02d123df017efcdfbd739ef81735b36c5ba83ec3c59c80a9d7ecc718f92e50"
-
-[[package]]
-name = "base58ck"
-version = "0.1.0"
-dependencies = [
- "bitcoin-internals",
- "bitcoin_hashes",
- "hex-conservative",
-]
-
-[[package]]
-name = "base64"
-version = "0.21.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
-
-[[package]]
-name = "bech32"
-version = "0.11.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d965446196e3b7decd44aa7ee49e31d630118f90ef12f97900f262eb915c951d"
-
-[[package]]
-name = "bincode"
-version = "1.3.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1f45e9417d87227c7a56d22e471c6206462cba514c7590c09aff4cf6d1ddcad"
-dependencies = [
- "serde",
-]
-
-[[package]]
-name = "bitcoin"
-version = "0.32.5-doge.0"
-dependencies = [
- "base58ck",
- "base64",
- "bech32",
- "bincode",
- "bitcoin-internals",
- "bitcoin-io",
- "bitcoin-units",
- "bitcoin_hashes",
- "bitcoinconsensus",
- "hex-conservative",
- "hex_lit",
- "mutagen",
- "ordered",
- "secp256k1",
- "serde",
- "serde_json",
- "serde_test",
-]
-
-[[package]]
-name = "bitcoin-fuzz"
-version = "0.0.1"
-dependencies = [
- "bitcoin",
- "honggfuzz",
- "serde",
- "serde_cbor",
- "serde_json",
-]
-
-[[package]]
-name = "bitcoin-internals"
-version = "0.3.0"
-dependencies = [
- "serde",
-]
-
-[[package]]
-name = "bitcoin-io"
-version = "0.1.2"
-
-[[package]]
-name = "bitcoin-units"
-version = "0.1.1"
-dependencies = [
- "bitcoin-internals",
- "serde",
- "serde_json",
- "serde_test",
-]
-
-[[package]]
-name = "bitcoin_hashes"
-version = "0.14.0"
-dependencies = [
- "bitcoin-io",
- "hex-conservative",
- "schemars",
- "serde",
- "serde_json",
- "serde_test",
-]
-
-[[package]]
-name = "bitcoinconsensus"
-version = "0.105.0+25.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f260ac8fb2c621329013fc0ed371c940fcc512552dcbcb9095ed0179098c9e18"
-dependencies = [
- "cc",
-]
-
-[[package]]
-name = "byteorder"
-version = "1.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
-
-[[package]]
-name = "cc"
-version = "1.2.24"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "16595d3be041c03b09d08d0858631facccee9221e579704070e6e9e4915d3bc7"
-dependencies = [
- "shlex",
-]
-
-[[package]]
-name = "cfg-if"
-version = "1.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
-
-[[package]]
-name = "dyn-clone"
-version = "1.0.19"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1c7a8fb8a9fbf66c1f703fe16184d10ca0ee9d23be5b4436400408ba54a95005"
-
-[[package]]
-name = "getrandom"
-version = "0.2.16"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "335ff9f135e4384c8150d6f27c6daed433577f86b4750418338c01a1a2528592"
-dependencies = [
- "cfg-if",
- "libc",
- "wasi",
-]
-
-[[package]]
-name = "half"
-version = "1.8.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b43ede17f21864e81be2fa654110bf1e793774238d86ef8555c37e6519c0403"
-
-[[package]]
-name = "hex-conservative"
-version = "0.2.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5313b072ce3c597065a808dbf612c4c8e8590bdbf8b579508bf7a762c5eae6cd"
-dependencies = [
- "arrayvec",
-]
-
-[[package]]
-name = "hex_lit"
-version = "0.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3011d1213f159867b13cfd6ac92d2cd5f1345762c63be3554e84092d85a50bbd"
-
-[[package]]
-name = "honggfuzz"
-version = "0.5.57"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fc563d4f41b17364d5c48ded509f2bcf1c3f6ae9c7f203055b4a5c325072d57e"
-dependencies = [
- "lazy_static",
- "memmap2",
- "rustc_version",
- "semver",
-]
-
-[[package]]
-name = "itoa"
-version = "1.0.15"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4a5f13b858c8d314ee3e8f639011f7ccefe71f97f96e50151fb991f267928e2c"
-
-[[package]]
-name = "json"
-version = "0.12.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "078e285eafdfb6c4b434e0d31e8cfcb5115b651496faca5749b88fafd4f23bfd"
-
-[[package]]
-name = "lazy_static"
-version = "1.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bbd2bcb4c963f2ddae06a2efc7e9f3591312473c50c6685e1f298068316e66fe"
-
-[[package]]
-name = "libc"
-version = "0.2.172"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d750af042f7ef4f724306de029d18836c26c1765a54a6a3f094cbd23a7267ffa"
-
-[[package]]
-name = "memchr"
-version = "2.7.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "78ca9ab1a0babb1e7d5695e3530886289c18cf2f87ec19a575a0abdce112e3a3"
-
-[[package]]
-name = "memmap2"
-version = "0.9.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fd3f7eed9d3848f8b98834af67102b720745c4ec028fcd0aa0239277e7de374f"
-dependencies = [
- "libc",
-]
-
-[[package]]
-name = "mutagen"
-version = "0.2.0"
-source = "git+https://github.com/llogiq/mutagen#a6377c4c3f360afeb7a287c1c17e4b69456d5f53"
-dependencies = [
- "mutagen-core",
- "mutagen-transform",
-]
-
-[[package]]
-name = "mutagen-core"
-version = "0.2.0"
-source = "git+https://github.com/llogiq/mutagen#a6377c4c3f360afeb7a287c1c17e4b69456d5f53"
-dependencies = [
- "anyhow",
- "json",
- "lazy_static",
- "proc-macro2",
- "quote",
- "serde",
- "serde_json",
- "syn 1.0.109",
-]
-
-[[package]]
-name = "mutagen-transform"
-version = "0.2.0"
-source = "git+https://github.com/llogiq/mutagen#a6377c4c3f360afeb7a287c1c17e4b69456d5f53"
-dependencies = [
- "mutagen-core",
- "proc-macro2",
-]
-
-[[package]]
-name = "ordered"
-version = "0.2.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f0642533dea0bb58bd5cae31bafc1872429f0f12ac8c61fe2b4ba44f80b959b"
-
-[[package]]
-name = "ppv-lite86"
-version = "0.2.21"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "85eae3c4ed2f50dcfe72643da4befc30deadb458a9b590d720cde2f2b1e97da9"
-dependencies = [
- "zerocopy",
-]
-
-[[package]]
-name = "proc-macro2"
-version = "1.0.95"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "02b3e5e68a3a1a02aad3ec490a98007cbc13c37cbe84a3cd7b8e406d76e7f778"
-dependencies = [
- "unicode-ident",
-]
-
-[[package]]
-name = "quote"
-version = "1.0.40"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d"
-dependencies = [
- "proc-macro2",
-]
-
-[[package]]
-name = "rand"
-version = "0.8.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
-dependencies = [
- "libc",
- "rand_chacha",
- "rand_core",
-]
-
-[[package]]
-name = "rand_chacha"
-version = "0.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
-dependencies = [
- "ppv-lite86",
- "rand_core",
-]
-
-[[package]]
-name = "rand_core"
-version = "0.6.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
-dependencies = [
- "getrandom",
-]
-
-[[package]]
-name = "rustc_version"
-version = "0.4.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92"
-dependencies = [
- "semver",
-]
-
-[[package]]
-name = "ryu"
-version = "1.0.20"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "28d3b2b1366ec20994f1fd18c3c594f05c5dd4bc44d8bb0c1c632c8d6829481f"
-
-[[package]]
-name = "schemars"
-version = "0.8.22"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3fbf2ae1b8bc8e02df939598064d22402220cd5bbcca1c76f7d6a310974d5615"
-dependencies = [
- "dyn-clone",
- "serde",
- "serde_json",
-]
-
-[[package]]
-name = "secp256k1"
-version = "0.29.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9465315bc9d4566e1724f0fffcbcc446268cb522e60f9a27bcded6b19c108113"
-dependencies = [
- "bitcoin_hashes",
- "rand",
- "secp256k1-sys",
- "serde",
-]
-
-[[package]]
-name = "secp256k1-sys"
-version = "0.10.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d4387882333d3aa8cb20530a17c69a3752e97837832f34f6dccc760e715001d9"
-dependencies = [
- "cc",
-]
-
-[[package]]
-name = "semver"
-version = "1.0.26"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56e6fa9c48d24d85fb3de5ad847117517440f6beceb7798af16b4a87d616b8d0"
-
-[[package]]
-name = "serde"
-version = "1.0.219"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5f0e2c6ed6606019b4e29e69dbaba95b11854410e5347d525002456dbbb786b6"
-dependencies = [
- "serde_derive",
-]
-
-[[package]]
-name = "serde_cbor"
-version = "0.9.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "45cd6d95391b16cd57e88b68be41d504183b7faae22030c0cc3b3f73dd57b2fd"
-dependencies = [
- "byteorder",
- "half",
- "serde",
-]
-
-[[package]]
-name = "serde_derive"
-version = "1.0.219"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b0276cf7f2c73365f7157c8123c21cd9a50fbbd844757af28ca1f5925fc2a00"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.101",
-]
-
-[[package]]
-name = "serde_json"
-version = "1.0.140"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "20068b6e96dc6c9bd23e01df8827e6c7e1f2fddd43c21810382803c136b99373"
-dependencies = [
- "itoa",
- "memchr",
- "ryu",
- "serde",
-]
-
-[[package]]
-name = "serde_test"
-version = "1.0.177"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f901ee573cab6b3060453d2d5f0bae4e6d628c23c0a962ff9b5f1d7c8d4f1ed"
-dependencies = [
- "serde",
-]
-
-[[package]]
-name = "shlex"
-version = "1.3.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
-
-[[package]]
-name = "syn"
-version = "1.0.109"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237"
-dependencies = [
- "proc-macro2",
- "quote",
- "unicode-ident",
-]
-
-[[package]]
-name = "syn"
-version = "2.0.101"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8ce2b7fc941b3a24138a0a7cf8e858bfc6a992e7978a068a5c760deb0ed43caf"
-dependencies = [
- "proc-macro2",
- "quote",
- "unicode-ident",
-]
-
-[[package]]
-name = "unicode-ident"
-version = "1.0.18"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"
-
-[[package]]
-name = "wasi"
-version = "0.11.0+wasi-snapshot-preview1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
-
-[[package]]
-name = "zerocopy"
-version = "0.8.25"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a1702d9583232ddb9174e01bb7c15a2ab8fb1bc6f227aa1233858c351a3ba0cb"
-dependencies = [
- "zerocopy-derive",
-]
-
-[[package]]
-name = "zerocopy-derive"
-version = "0.8.25"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "28a6e20d751156648aa063f3800b706ee209a32c0b4d9f24be3d980b01be55ef"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.101",
-]

From 790dcf0c08b16b87a485cfc706e22238c484fce2 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 08:52:58 +0200
Subject: [PATCH 26/53] run formatter in nightly mode

---
 bitcoin/src/address/mod.rs                 | 11 +++---
 bitcoin/src/blockdata/constants.rs         |  2 +-
 bitcoin/src/blockdata/locktime/absolute.rs | 12 ++-----
 bitcoin/src/blockdata/transaction.rs       | 14 +++-----
 bitcoin/src/consensus/encode.rs            |  8 ++---
 bitcoin/src/consensus/params.rs            |  2 +-
 bitcoin/src/dogecoin/mod.rs                | 11 ++----
 bitcoin/src/network.rs                     | 20 +++--------
 bitcoin/src/p2p/message.rs                 |  4 +--
 bitcoin/src/p2p/mod.rs                     |  6 ++--
 bitcoin/src/pow.rs                         | 41 +++++++++++++---------
 bitcoin/tests/psbt-sign-taproot.rs         |  5 ++-
 io/src/lib.rs                              |  3 +-
 units/src/lib.rs                           |  7 ++--
 14 files changed, 57 insertions(+), 89 deletions(-)

diff --git a/bitcoin/src/address/mod.rs b/bitcoin/src/address/mod.rs
index c05f32ac8..a7e02b78b 100644
--- a/bitcoin/src/address/mod.rs
+++ b/bitcoin/src/address/mod.rs
@@ -249,17 +249,17 @@ pub enum AddressData {
     /// Data encoded by a P2PKH address.
     P2pkh {
         /// The pubkey hash used to encumber outputs to this address.
-        pubkey_hash: PubkeyHash
+        pubkey_hash: PubkeyHash,
     },
     /// Data encoded by a P2SH address.
     P2sh {
         /// The script hash used to encumber outputs to this address.
-        script_hash: ScriptHash
+        script_hash: ScriptHash,
     },
     /// Data encoded by a Segwit address.
     Segwit {
         /// The witness program used to encumber outputs to this address.
-        witness_program: WitnessProgram
+        witness_program: WitnessProgram,
     },
 }
 
@@ -565,7 +565,10 @@ impl Address {
     pub fn is_spend_standard(&self) -> bool { self.address_type().is_some() }
 
     /// Constructs an [`Address`] from an output script (`scriptPubkey`).
-    pub fn from_script(script: &Script, params: impl AsRef<Params>) -> Result<Address, FromScriptError> {
+    pub fn from_script(
+        script: &Script,
+        params: impl AsRef<Params>,
+    ) -> Result<Address, FromScriptError> {
         let network = params.as_ref().network;
         if script.is_p2pkh() {
             let bytes = script.as_bytes()[3..23].try_into().expect("statically 20B long");
diff --git a/bitcoin/src/blockdata/constants.rs b/bitcoin/src/blockdata/constants.rs
index 4d98ba907..34667881f 100644
--- a/bitcoin/src/blockdata/constants.rs
+++ b/bitcoin/src/blockdata/constants.rs
@@ -261,8 +261,8 @@ mod test {
     use hex::test_hex_unwrap as hex;
 
     use super::*;
-    use crate::consensus::params;
     use crate::consensus::encode::serialize;
+    use crate::consensus::params;
 
     #[test]
     fn bitcoin_genesis_first_transaction() {
diff --git a/bitcoin/src/blockdata/locktime/absolute.rs b/bitcoin/src/blockdata/locktime/absolute.rs
index 074ca26a7..77728b16f 100644
--- a/bitcoin/src/blockdata/locktime/absolute.rs
+++ b/bitcoin/src/blockdata/locktime/absolute.rs
@@ -297,25 +297,19 @@ impl FromStr for LockTime {
 impl TryFrom<&str> for LockTime {
     type Error = ParseIntError;
 
-    fn try_from(s: &str) -> Result<Self, Self::Error> {
-        LockTime::from_str(s)
-    }
+    fn try_from(s: &str) -> Result<Self, Self::Error> { LockTime::from_str(s) }
 }
 
 impl TryFrom<String> for LockTime {
     type Error = ParseIntError;
 
-    fn try_from(s: String) -> Result<Self, Self::Error> {
-        LockTime::from_str(&s)
-    }
+    fn try_from(s: String) -> Result<Self, Self::Error> { LockTime::from_str(&s) }
 }
 
 impl TryFrom<Box<str>> for LockTime {
     type Error = ParseIntError;
 
-    fn try_from(s: Box<str>) -> Result<Self, Self::Error> {
-        LockTime::from_str(&s)
-    }
+    fn try_from(s: Box<str>) -> Result<Self, Self::Error> { LockTime::from_str(&s) }
 }
 
 impl From<Height> for LockTime {
diff --git a/bitcoin/src/blockdata/transaction.rs b/bitcoin/src/blockdata/transaction.rs
index 1e11ac66b..446b96898 100644
--- a/bitcoin/src/blockdata/transaction.rs
+++ b/bitcoin/src/blockdata/transaction.rs
@@ -11,8 +11,8 @@
 //! This module provides the structures and functions needed to support transactions.
 //!
 
-use core::{cmp, fmt};
 use core::str::FromStr;
+use core::{cmp, fmt};
 
 use hashes::{sha256d, Hash};
 use internals::write_err;
@@ -539,25 +539,19 @@ impl FromStr for Sequence {
 impl TryFrom<&str> for Sequence {
     type Error = ParseIntError;
 
-    fn try_from(s: &str) -> Result<Self, Self::Error> {
-        Sequence::from_str(s)
-    }
+    fn try_from(s: &str) -> Result<Self, Self::Error> { Sequence::from_str(s) }
 }
 
 impl TryFrom<String> for Sequence {
     type Error = ParseIntError;
 
-    fn try_from(s: String) -> Result<Self, Self::Error> {
-        Sequence::from_str(&s)
-    }
+    fn try_from(s: String) -> Result<Self, Self::Error> { Sequence::from_str(&s) }
 }
 
 impl TryFrom<Box<str>> for Sequence {
     type Error = ParseIntError;
 
-    fn try_from(s: Box<str>) -> Result<Self, Self::Error> {
-        Sequence::from_str(&s)
-    }
+    fn try_from(s: Box<str>) -> Result<Self, Self::Error> { Sequence::from_str(&s) }
 }
 
 /// Bitcoin transaction output.
diff --git a/bitcoin/src/consensus/encode.rs b/bitcoin/src/consensus/encode.rs
index b885e9318..d0bb754a3 100644
--- a/bitcoin/src/consensus/encode.rs
+++ b/bitcoin/src/consensus/encode.rs
@@ -406,9 +406,7 @@ macro_rules! impl_int_encodable {
     ($ty:ident, $meth_dec:ident, $meth_enc:ident) => {
         impl Decodable for $ty {
             #[inline]
-            fn consensus_decode<R: Read + ?Sized>(
-                r: &mut R,
-            ) -> core::result::Result<Self, Error> {
+            fn consensus_decode<R: Read + ?Sized>(r: &mut R) -> core::result::Result<Self, Error> {
                 ReadExt::$meth_dec(r)
             }
         }
@@ -593,9 +591,7 @@ macro_rules! impl_array {
 
         impl Decodable for [u8; $size] {
             #[inline]
-            fn consensus_decode<R: Read + ?Sized>(
-                r: &mut R,
-            ) -> core::result::Result<Self, Error> {
+            fn consensus_decode<R: Read + ?Sized>(r: &mut R) -> core::result::Result<Self, Error> {
                 let mut ret = [0; $size];
                 r.read_slice(&mut ret)?;
                 Ok(ret)
diff --git a/bitcoin/src/consensus/params.rs b/bitcoin/src/consensus/params.rs
index 93a36c220..325a6c7ee 100644
--- a/bitcoin/src/consensus/params.rs
+++ b/bitcoin/src/consensus/params.rs
@@ -76,7 +76,7 @@ pub static SIGNET: Params = Params::SIGNET;
 /// The regtest parameters.
 pub static REGTEST: Params = Params::REGTEST;
 
-#[allow(deprecated)]            // For `pow_limit`.
+#[allow(deprecated)] // For `pow_limit`.
 impl Params {
     /// The mainnet parameters (alias for `Params::MAINNET`).
     pub const BITCOIN: Params = Params::MAINNET;
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index ba84d1da7..f45e10a6b 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -3,8 +3,7 @@
 //! This module provides support for de/serialization, parsing and execution on data structures and
 //! network messages related to Dogecoin.
 
-use crate::block::Header;
-use crate::block::TxMerkleNode;
+use crate::block::{Header, TxMerkleNode};
 use crate::consensus::{encode, Decodable, Encodable};
 use crate::internal_macros::impl_consensus_encoding;
 use crate::io::{Read, Write};
@@ -14,9 +13,7 @@ use crate::{io, BlockHash, Transaction};
 /// AuxPow version bit, see https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23
 pub const VERSION_AUXPOW: i32 = 1 << 8;
 
-fn is_auxpow(header: Header) -> bool {
-    (header.version.to_consensus() & VERSION_AUXPOW) != 0
-}
+fn is_auxpow(header: Header) -> bool { (header.version.to_consensus() & VERSION_AUXPOW) != 0 }
 
 /// Data for merge-mining AuxPoW.
 ///
@@ -81,9 +78,7 @@ pub struct Block {
 
 impl Block {
     /// Returns the block hash computed as SHA256d(header).
-    pub fn block_hash(&self) -> BlockHash {
-        self.header.block_hash()
-    }
+    pub fn block_hash(&self) -> BlockHash { self.header.block_hash() }
 }
 
 impl Decodable for Block {
diff --git a/bitcoin/src/network.rs b/bitcoin/src/network.rs
index 8df48b0be..9bea93b9d 100644
--- a/bitcoin/src/network.rs
+++ b/bitcoin/src/network.rs
@@ -333,26 +333,14 @@ mod tests {
     #[test]
     fn serialize_test() {
         assert_eq!(serialize(&Network::Bitcoin.magic()), &[0xf9, 0xbe, 0xb4, 0xd9]);
-        assert_eq!(
-            serialize(&Network::Testnet.magic()),
-            &[0x0b, 0x11, 0x09, 0x07]
-        );
-        assert_eq!(
-            serialize(&Network::Testnet4.magic()),
-            &[0x1c, 0x16, 0x3f, 0x28]
-        );
+        assert_eq!(serialize(&Network::Testnet.magic()), &[0x0b, 0x11, 0x09, 0x07]);
+        assert_eq!(serialize(&Network::Testnet4.magic()), &[0x1c, 0x16, 0x3f, 0x28]);
         assert_eq!(serialize(&Network::Signet.magic()), &[0x0a, 0x03, 0xcf, 0x40]);
         assert_eq!(serialize(&Network::Regtest.magic()), &[0xfa, 0xbf, 0xb5, 0xda]);
 
         assert_eq!(deserialize(&[0xf9, 0xbe, 0xb4, 0xd9]).ok(), Some(Network::Bitcoin.magic()));
-        assert_eq!(
-            deserialize(&[0x0b, 0x11, 0x09, 0x07]).ok(),
-            Some(Network::Testnet.magic())
-        );
-        assert_eq!(
-            deserialize(&[0x1c, 0x16, 0x3f, 0x28]).ok(),
-            Some(Network::Testnet4.magic())
-        );
+        assert_eq!(deserialize(&[0x0b, 0x11, 0x09, 0x07]).ok(), Some(Network::Testnet.magic()));
+        assert_eq!(deserialize(&[0x1c, 0x16, 0x3f, 0x28]).ok(), Some(Network::Testnet4.magic()));
         assert_eq!(deserialize(&[0x0a, 0x03, 0xcf, 0x40]).ok(), Some(Network::Signet.magic()));
         assert_eq!(deserialize(&[0xfa, 0xbf, 0xb5, 0xda]).ok(), Some(Network::Regtest.magic()));
     }
diff --git a/bitcoin/src/p2p/message.rs b/bitcoin/src/p2p/message.rs
index 11e10cafd..cf1d52f90 100644
--- a/bitcoin/src/p2p/message.rs
+++ b/bitcoin/src/p2p/message.rs
@@ -312,9 +312,7 @@ impl RawNetworkMessage {
     }
 
     /// Consumes the [RawNetworkMessage] instance and returns the inner payload.
-    pub fn into_payload(self) -> NetworkMessage {
-        self.payload
-    }
+    pub fn into_payload(self) -> NetworkMessage { self.payload }
 
     /// The actual message data
     pub fn payload(&self) -> &NetworkMessage { &self.payload }
diff --git a/bitcoin/src/p2p/mod.rs b/bitcoin/src/p2p/mod.rs
index 988dc0d05..372bf1188 100644
--- a/bitcoin/src/p2p/mod.rs
+++ b/bitcoin/src/p2p/mod.rs
@@ -29,8 +29,8 @@ use io::{Read, Write};
 
 use crate::consensus::encode::{self, Decodable, Encodable};
 use crate::consensus::Params;
-use crate::prelude::*;
 use crate::network::Network;
+use crate::prelude::*;
 
 #[rustfmt::skip]
 #[doc(inline)]
@@ -234,9 +234,7 @@ impl Magic {
     pub fn to_bytes(self) -> [u8; 4] { self.0 }
 
     /// Returns the magic bytes for the network defined by `params`.
-    pub fn from_params(params: impl AsRef<Params>) -> Self {
-        params.as_ref().network.into()
-    }
+    pub fn from_params(params: impl AsRef<Params>) -> Self { params.as_ref().network.into() }
 }
 
 impl FromStr for Magic {
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index d4cb696fc..0cc589611 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -19,7 +19,9 @@ use crate::block::Header;
 use crate::blockdata::block::BlockHash;
 use crate::consensus::encode::{self, Decodable, Encodable};
 use crate::consensus::Params;
-use crate::error::{ContainsPrefixError, MissingPrefixError, ParseIntError, PrefixedHexError, UnprefixedHexError};
+use crate::error::{
+    ContainsPrefixError, MissingPrefixError, ParseIntError, PrefixedHexError, UnprefixedHexError,
+};
 
 /// Implement traits and methods shared by `Target` and `Work`.
 macro_rules! do_impl {
@@ -1798,8 +1800,11 @@ mod tests {
 
     #[test]
     fn compact_target_from_upwards_difficulty_adjustment_using_headers() {
-        use crate::{block::Version, constants::genesis_block, TxMerkleNode};
         use hashes::Hash;
+
+        use crate::block::Version;
+        use crate::constants::genesis_block;
+        use crate::TxMerkleNode;
         let params = Params::new(crate::Network::Signet);
         let epoch_start = genesis_block(&params).header;
         // Block 2015, the only information used are `bits` and `time`
@@ -1809,27 +1814,30 @@ mod tests {
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1599332177,
             bits: epoch_start.bits,
-            nonce: epoch_start.nonce
+            nonce: epoch_start.nonce,
         };
-        let adjustment = CompactTarget::from_header_difficulty_adjustment(epoch_start, current, params);
+        let adjustment =
+            CompactTarget::from_header_difficulty_adjustment(epoch_start, current, params);
         let adjustment_bits = CompactTarget::from_consensus(503394215); // Block 2016 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
 
     #[test]
     fn compact_target_from_downwards_difficulty_adjustment_using_headers() {
-        use crate::{block::Version, TxMerkleNode};
         use hashes::Hash;
+
+        use crate::block::Version;
+        use crate::TxMerkleNode;
         let params = Params::new(crate::Network::Signet);
         let starting_bits = CompactTarget::from_consensus(503394215); // Block 2016 compact target
-        // Block 2016, the only information used is `time`
+                                                                      // Block 2016, the only information used is `time`
         let epoch_start = Header {
             version: Version::ONE,
             prev_blockhash: BlockHash::all_zeros(),
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1599332844,
             bits: starting_bits,
-            nonce: 0
+            nonce: 0,
         };
         // Block 4031, the only information used are `bits` and `time`
         let current = Header {
@@ -1838,9 +1846,10 @@ mod tests {
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1600591200,
             bits: starting_bits,
-            nonce: 0
+            nonce: 0,
         };
-        let adjustment = CompactTarget::from_header_difficulty_adjustment(epoch_start, current, params);
+        let adjustment =
+            CompactTarget::from_header_difficulty_adjustment(epoch_start, current, params);
         let adjustment_bits = CompactTarget::from_consensus(503397348); // Block 4032 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -1851,9 +1860,8 @@ mod tests {
         let starting_bits = CompactTarget::from_consensus(503403001);
         let timespan = (0.2 * params.pow_target_timespan as f64) as u64;
         let got = CompactTarget::from_next_work_required(starting_bits, timespan, params);
-        let want = Target::from_compact(starting_bits)
-            .min_transition_threshold()
-            .to_compact_lossy();
+        let want =
+            Target::from_compact(starting_bits).min_transition_threshold().to_compact_lossy();
         assert_eq!(got, want);
     }
 
@@ -1861,11 +1869,10 @@ mod tests {
     fn compact_target_from_minimum_downward_difficulty_adjustment() {
         let params = Params::new(crate::Network::Signet);
         let starting_bits = CompactTarget::from_consensus(403403001); // High difficulty for Signet
-        let timespan =  5 * params.pow_target_timespan; // Really slow.
+        let timespan = 5 * params.pow_target_timespan; // Really slow.
         let got = CompactTarget::from_next_work_required(starting_bits, timespan, &params);
-        let want = Target::from_compact(starting_bits)
-            .max_transition_threshold(params)
-            .to_compact_lossy();
+        let want =
+            Target::from_compact(starting_bits).max_transition_threshold(params).to_compact_lossy();
         assert_eq!(got, want);
     }
 
@@ -1873,7 +1880,7 @@ mod tests {
     fn compact_target_from_adjustment_is_max_target() {
         let params = Params::new(crate::Network::Signet);
         let starting_bits = CompactTarget::from_consensus(503543726); // Genesis compact target on Signet
-        let timespan =  5 * params.pow_target_timespan; // Really slow.
+        let timespan = 5 * params.pow_target_timespan; // Really slow.
         let got = CompactTarget::from_next_work_required(starting_bits, timespan, &params);
         let want = params.max_attainable_target.to_compact_lossy();
         assert_eq!(got, want);
diff --git a/bitcoin/tests/psbt-sign-taproot.rs b/bitcoin/tests/psbt-sign-taproot.rs
index 4cf7616b7..78fbcdd60 100644
--- a/bitcoin/tests/psbt-sign-taproot.rs
+++ b/bitcoin/tests/psbt-sign-taproot.rs
@@ -31,13 +31,12 @@ fn psbt_sign_taproot() {
             _secp: &Secp256k1<C>,
         ) -> Result<Option<PrivateKey>, Self::Error> {
             match key_request {
-                KeyRequest::Bip32((mfp, _)) => {
+                KeyRequest::Bip32((mfp, _)) =>
                     if mfp == self.mfp {
                         Ok(Some(self.sk))
                     } else {
                         Err(SignError::KeyNotFound)
-                    }
-                }
+                    },
                 _ => Err(SignError::KeyNotFound),
             }
         }
diff --git a/io/src/lib.rs b/io/src/lib.rs
index 82d51acc7..e7878625e 100644
--- a/io/src/lib.rs
+++ b/io/src/lib.rs
@@ -211,8 +211,7 @@ impl<T: AsRef<[u8]>> Read for Cursor<T> {
         let start_pos = self.pos.try_into().unwrap_or(inner.len());
         let read = core::cmp::min(inner.len().saturating_sub(start_pos), buf.len());
         buf[..read].copy_from_slice(&inner[start_pos..start_pos + read]);
-        self.pos =
-            self.pos.saturating_add(read.try_into().unwrap_or(u64::MAX /* unreachable */));
+        self.pos = self.pos.saturating_add(read.try_into().unwrap_or(u64::MAX /* unreachable */));
         Ok(read)
     }
 }
diff --git a/units/src/lib.rs b/units/src/lib.rs
index b2c278795..393b5ced1 100644
--- a/units/src/lib.rs
+++ b/units/src/lib.rs
@@ -45,17 +45,14 @@ pub mod parse;
 #[cfg(feature = "alloc")]
 pub mod weight;
 
+pub use self::amount::ParseAmountError;
 #[doc(inline)]
 pub use self::amount::{Amount, SignedAmount};
-pub use self::amount::ParseAmountError;
 #[cfg(feature = "alloc")]
 pub use self::parse::ParseIntError;
 #[cfg(feature = "alloc")]
 #[doc(inline)]
-pub use self::{
-    fee_rate::FeeRate,
-    weight::Weight,
-};
+pub use self::{fee_rate::FeeRate, weight::Weight};
 
 #[rustfmt::skip]
 #[allow(unused_imports)]

From 8f6dcdb8c0c68d6a4b11d3ac17dce2949c0cc36a Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 09:05:57 +0200
Subject: [PATCH 27/53] update lock files

---
 contrib/update-lock-files.sh | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/contrib/update-lock-files.sh b/contrib/update-lock-files.sh
index 02ba1f7c8..483ee10c7 100755
--- a/contrib/update-lock-files.sh
+++ b/contrib/update-lock-files.sh
@@ -1,11 +1,16 @@
 #!/usr/bin/env bash
 #
 # Update the minimal/recent lock file
-
 set -euo pipefail
 
+if [[ "$(uname)" == "Darwin" ]]; then
+    CP="cp -f"
+else
+    CP="cp --force"
+fi
+
 for file in Cargo-minimal.lock Cargo-recent.lock; do
-    cp --force "$file" Cargo.lock
+    $CP "$file" Cargo.lock
     cargo check
-    cp --force Cargo.lock "$file"
+    $CP Cargo.lock "$file"
 done

From 8af5eafdd2ed5b025ec7ccd48c2545f08d9c0374 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 09:21:53 +0200
Subject: [PATCH 28/53] update doc

---
 bitcoin/src/dogecoin/mod.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index f45e10a6b..3c97ce288 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -10,7 +10,7 @@ use crate::io::{Read, Write};
 use crate::prelude::*;
 use crate::{io, BlockHash, Transaction};
 
-/// AuxPow version bit, see https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23
+/// AuxPow version bit, see <https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23>
 pub const VERSION_AUXPOW: i32 = 1 << 8;
 
 fn is_auxpow(header: Header) -> bool { (header.version.to_consensus() & VERSION_AUXPOW) != 0 }

From 0549e83b22019f294bd2a4d842c3fbf376f16452 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 09:55:12 +0200
Subject: [PATCH 29/53] Revert "add write permission to labeller for issues"

This reverts commit 67bbf4c7da85ec8ac7051786c2af99656373ab98.
---
 .github/workflows/manage-pr.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/manage-pr.yml b/.github/workflows/manage-pr.yml
index 885382208..3ba1dcc55 100644
--- a/.github/workflows/manage-pr.yml
+++ b/.github/workflows/manage-pr.yml
@@ -6,7 +6,6 @@ jobs:
   labeler:
     permissions:
       contents: read
-      issues: write
       pull-requests: write
     runs-on: ubuntu-latest
     steps:

From 6d91df4443f6655f52c7eb16ef3324c6e815ebb8 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 10:58:43 +0200
Subject: [PATCH 30/53] Revert "run formatter in nightly mode"

This reverts commit 4ef012980f83797afd3741f945457b0396ceb656.
---
 bitcoin/src/address/mod.rs                 | 11 +++---
 bitcoin/src/blockdata/constants.rs         |  2 +-
 bitcoin/src/blockdata/locktime/absolute.rs | 12 +++++--
 bitcoin/src/blockdata/transaction.rs       | 14 +++++---
 bitcoin/src/consensus/encode.rs            |  8 +++--
 bitcoin/src/consensus/params.rs            |  2 +-
 bitcoin/src/dogecoin/mod.rs                | 11 ++++--
 bitcoin/src/network.rs                     | 20 ++++++++---
 bitcoin/src/p2p/message.rs                 |  4 ++-
 bitcoin/src/p2p/mod.rs                     |  6 ++--
 bitcoin/src/pow.rs                         | 41 +++++++++-------------
 bitcoin/tests/psbt-sign-taproot.rs         |  5 +--
 io/src/lib.rs                              |  3 +-
 units/src/lib.rs                           |  7 ++--
 14 files changed, 89 insertions(+), 57 deletions(-)

diff --git a/bitcoin/src/address/mod.rs b/bitcoin/src/address/mod.rs
index a7e02b78b..c05f32ac8 100644
--- a/bitcoin/src/address/mod.rs
+++ b/bitcoin/src/address/mod.rs
@@ -249,17 +249,17 @@ pub enum AddressData {
     /// Data encoded by a P2PKH address.
     P2pkh {
         /// The pubkey hash used to encumber outputs to this address.
-        pubkey_hash: PubkeyHash,
+        pubkey_hash: PubkeyHash
     },
     /// Data encoded by a P2SH address.
     P2sh {
         /// The script hash used to encumber outputs to this address.
-        script_hash: ScriptHash,
+        script_hash: ScriptHash
     },
     /// Data encoded by a Segwit address.
     Segwit {
         /// The witness program used to encumber outputs to this address.
-        witness_program: WitnessProgram,
+        witness_program: WitnessProgram
     },
 }
 
@@ -565,10 +565,7 @@ impl Address {
     pub fn is_spend_standard(&self) -> bool { self.address_type().is_some() }
 
     /// Constructs an [`Address`] from an output script (`scriptPubkey`).
-    pub fn from_script(
-        script: &Script,
-        params: impl AsRef<Params>,
-    ) -> Result<Address, FromScriptError> {
+    pub fn from_script(script: &Script, params: impl AsRef<Params>) -> Result<Address, FromScriptError> {
         let network = params.as_ref().network;
         if script.is_p2pkh() {
             let bytes = script.as_bytes()[3..23].try_into().expect("statically 20B long");
diff --git a/bitcoin/src/blockdata/constants.rs b/bitcoin/src/blockdata/constants.rs
index 34667881f..4d98ba907 100644
--- a/bitcoin/src/blockdata/constants.rs
+++ b/bitcoin/src/blockdata/constants.rs
@@ -261,8 +261,8 @@ mod test {
     use hex::test_hex_unwrap as hex;
 
     use super::*;
-    use crate::consensus::encode::serialize;
     use crate::consensus::params;
+    use crate::consensus::encode::serialize;
 
     #[test]
     fn bitcoin_genesis_first_transaction() {
diff --git a/bitcoin/src/blockdata/locktime/absolute.rs b/bitcoin/src/blockdata/locktime/absolute.rs
index 77728b16f..074ca26a7 100644
--- a/bitcoin/src/blockdata/locktime/absolute.rs
+++ b/bitcoin/src/blockdata/locktime/absolute.rs
@@ -297,19 +297,25 @@ impl FromStr for LockTime {
 impl TryFrom<&str> for LockTime {
     type Error = ParseIntError;
 
-    fn try_from(s: &str) -> Result<Self, Self::Error> { LockTime::from_str(s) }
+    fn try_from(s: &str) -> Result<Self, Self::Error> {
+        LockTime::from_str(s)
+    }
 }
 
 impl TryFrom<String> for LockTime {
     type Error = ParseIntError;
 
-    fn try_from(s: String) -> Result<Self, Self::Error> { LockTime::from_str(&s) }
+    fn try_from(s: String) -> Result<Self, Self::Error> {
+        LockTime::from_str(&s)
+    }
 }
 
 impl TryFrom<Box<str>> for LockTime {
     type Error = ParseIntError;
 
-    fn try_from(s: Box<str>) -> Result<Self, Self::Error> { LockTime::from_str(&s) }
+    fn try_from(s: Box<str>) -> Result<Self, Self::Error> {
+        LockTime::from_str(&s)
+    }
 }
 
 impl From<Height> for LockTime {
diff --git a/bitcoin/src/blockdata/transaction.rs b/bitcoin/src/blockdata/transaction.rs
index 446b96898..1e11ac66b 100644
--- a/bitcoin/src/blockdata/transaction.rs
+++ b/bitcoin/src/blockdata/transaction.rs
@@ -11,8 +11,8 @@
 //! This module provides the structures and functions needed to support transactions.
 //!
 
-use core::str::FromStr;
 use core::{cmp, fmt};
+use core::str::FromStr;
 
 use hashes::{sha256d, Hash};
 use internals::write_err;
@@ -539,19 +539,25 @@ impl FromStr for Sequence {
 impl TryFrom<&str> for Sequence {
     type Error = ParseIntError;
 
-    fn try_from(s: &str) -> Result<Self, Self::Error> { Sequence::from_str(s) }
+    fn try_from(s: &str) -> Result<Self, Self::Error> {
+        Sequence::from_str(s)
+    }
 }
 
 impl TryFrom<String> for Sequence {
     type Error = ParseIntError;
 
-    fn try_from(s: String) -> Result<Self, Self::Error> { Sequence::from_str(&s) }
+    fn try_from(s: String) -> Result<Self, Self::Error> {
+        Sequence::from_str(&s)
+    }
 }
 
 impl TryFrom<Box<str>> for Sequence {
     type Error = ParseIntError;
 
-    fn try_from(s: Box<str>) -> Result<Self, Self::Error> { Sequence::from_str(&s) }
+    fn try_from(s: Box<str>) -> Result<Self, Self::Error> {
+        Sequence::from_str(&s)
+    }
 }
 
 /// Bitcoin transaction output.
diff --git a/bitcoin/src/consensus/encode.rs b/bitcoin/src/consensus/encode.rs
index d0bb754a3..b885e9318 100644
--- a/bitcoin/src/consensus/encode.rs
+++ b/bitcoin/src/consensus/encode.rs
@@ -406,7 +406,9 @@ macro_rules! impl_int_encodable {
     ($ty:ident, $meth_dec:ident, $meth_enc:ident) => {
         impl Decodable for $ty {
             #[inline]
-            fn consensus_decode<R: Read + ?Sized>(r: &mut R) -> core::result::Result<Self, Error> {
+            fn consensus_decode<R: Read + ?Sized>(
+                r: &mut R,
+            ) -> core::result::Result<Self, Error> {
                 ReadExt::$meth_dec(r)
             }
         }
@@ -591,7 +593,9 @@ macro_rules! impl_array {
 
         impl Decodable for [u8; $size] {
             #[inline]
-            fn consensus_decode<R: Read + ?Sized>(r: &mut R) -> core::result::Result<Self, Error> {
+            fn consensus_decode<R: Read + ?Sized>(
+                r: &mut R,
+            ) -> core::result::Result<Self, Error> {
                 let mut ret = [0; $size];
                 r.read_slice(&mut ret)?;
                 Ok(ret)
diff --git a/bitcoin/src/consensus/params.rs b/bitcoin/src/consensus/params.rs
index 325a6c7ee..93a36c220 100644
--- a/bitcoin/src/consensus/params.rs
+++ b/bitcoin/src/consensus/params.rs
@@ -76,7 +76,7 @@ pub static SIGNET: Params = Params::SIGNET;
 /// The regtest parameters.
 pub static REGTEST: Params = Params::REGTEST;
 
-#[allow(deprecated)] // For `pow_limit`.
+#[allow(deprecated)]            // For `pow_limit`.
 impl Params {
     /// The mainnet parameters (alias for `Params::MAINNET`).
     pub const BITCOIN: Params = Params::MAINNET;
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index 3c97ce288..e26b72068 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -3,7 +3,8 @@
 //! This module provides support for de/serialization, parsing and execution on data structures and
 //! network messages related to Dogecoin.
 
-use crate::block::{Header, TxMerkleNode};
+use crate::block::Header;
+use crate::block::TxMerkleNode;
 use crate::consensus::{encode, Decodable, Encodable};
 use crate::internal_macros::impl_consensus_encoding;
 use crate::io::{Read, Write};
@@ -13,7 +14,9 @@ use crate::{io, BlockHash, Transaction};
 /// AuxPow version bit, see <https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23>
 pub const VERSION_AUXPOW: i32 = 1 << 8;
 
-fn is_auxpow(header: Header) -> bool { (header.version.to_consensus() & VERSION_AUXPOW) != 0 }
+fn is_auxpow(header: Header) -> bool {
+    (header.version.to_consensus() & VERSION_AUXPOW) != 0
+}
 
 /// Data for merge-mining AuxPoW.
 ///
@@ -78,7 +81,9 @@ pub struct Block {
 
 impl Block {
     /// Returns the block hash computed as SHA256d(header).
-    pub fn block_hash(&self) -> BlockHash { self.header.block_hash() }
+    pub fn block_hash(&self) -> BlockHash {
+        self.header.block_hash()
+    }
 }
 
 impl Decodable for Block {
diff --git a/bitcoin/src/network.rs b/bitcoin/src/network.rs
index 9bea93b9d..8df48b0be 100644
--- a/bitcoin/src/network.rs
+++ b/bitcoin/src/network.rs
@@ -333,14 +333,26 @@ mod tests {
     #[test]
     fn serialize_test() {
         assert_eq!(serialize(&Network::Bitcoin.magic()), &[0xf9, 0xbe, 0xb4, 0xd9]);
-        assert_eq!(serialize(&Network::Testnet.magic()), &[0x0b, 0x11, 0x09, 0x07]);
-        assert_eq!(serialize(&Network::Testnet4.magic()), &[0x1c, 0x16, 0x3f, 0x28]);
+        assert_eq!(
+            serialize(&Network::Testnet.magic()),
+            &[0x0b, 0x11, 0x09, 0x07]
+        );
+        assert_eq!(
+            serialize(&Network::Testnet4.magic()),
+            &[0x1c, 0x16, 0x3f, 0x28]
+        );
         assert_eq!(serialize(&Network::Signet.magic()), &[0x0a, 0x03, 0xcf, 0x40]);
         assert_eq!(serialize(&Network::Regtest.magic()), &[0xfa, 0xbf, 0xb5, 0xda]);
 
         assert_eq!(deserialize(&[0xf9, 0xbe, 0xb4, 0xd9]).ok(), Some(Network::Bitcoin.magic()));
-        assert_eq!(deserialize(&[0x0b, 0x11, 0x09, 0x07]).ok(), Some(Network::Testnet.magic()));
-        assert_eq!(deserialize(&[0x1c, 0x16, 0x3f, 0x28]).ok(), Some(Network::Testnet4.magic()));
+        assert_eq!(
+            deserialize(&[0x0b, 0x11, 0x09, 0x07]).ok(),
+            Some(Network::Testnet.magic())
+        );
+        assert_eq!(
+            deserialize(&[0x1c, 0x16, 0x3f, 0x28]).ok(),
+            Some(Network::Testnet4.magic())
+        );
         assert_eq!(deserialize(&[0x0a, 0x03, 0xcf, 0x40]).ok(), Some(Network::Signet.magic()));
         assert_eq!(deserialize(&[0xfa, 0xbf, 0xb5, 0xda]).ok(), Some(Network::Regtest.magic()));
     }
diff --git a/bitcoin/src/p2p/message.rs b/bitcoin/src/p2p/message.rs
index cf1d52f90..11e10cafd 100644
--- a/bitcoin/src/p2p/message.rs
+++ b/bitcoin/src/p2p/message.rs
@@ -312,7 +312,9 @@ impl RawNetworkMessage {
     }
 
     /// Consumes the [RawNetworkMessage] instance and returns the inner payload.
-    pub fn into_payload(self) -> NetworkMessage { self.payload }
+    pub fn into_payload(self) -> NetworkMessage {
+        self.payload
+    }
 
     /// The actual message data
     pub fn payload(&self) -> &NetworkMessage { &self.payload }
diff --git a/bitcoin/src/p2p/mod.rs b/bitcoin/src/p2p/mod.rs
index 372bf1188..988dc0d05 100644
--- a/bitcoin/src/p2p/mod.rs
+++ b/bitcoin/src/p2p/mod.rs
@@ -29,8 +29,8 @@ use io::{Read, Write};
 
 use crate::consensus::encode::{self, Decodable, Encodable};
 use crate::consensus::Params;
-use crate::network::Network;
 use crate::prelude::*;
+use crate::network::Network;
 
 #[rustfmt::skip]
 #[doc(inline)]
@@ -234,7 +234,9 @@ impl Magic {
     pub fn to_bytes(self) -> [u8; 4] { self.0 }
 
     /// Returns the magic bytes for the network defined by `params`.
-    pub fn from_params(params: impl AsRef<Params>) -> Self { params.as_ref().network.into() }
+    pub fn from_params(params: impl AsRef<Params>) -> Self {
+        params.as_ref().network.into()
+    }
 }
 
 impl FromStr for Magic {
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index 0cc589611..d4cb696fc 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -19,9 +19,7 @@ use crate::block::Header;
 use crate::blockdata::block::BlockHash;
 use crate::consensus::encode::{self, Decodable, Encodable};
 use crate::consensus::Params;
-use crate::error::{
-    ContainsPrefixError, MissingPrefixError, ParseIntError, PrefixedHexError, UnprefixedHexError,
-};
+use crate::error::{ContainsPrefixError, MissingPrefixError, ParseIntError, PrefixedHexError, UnprefixedHexError};
 
 /// Implement traits and methods shared by `Target` and `Work`.
 macro_rules! do_impl {
@@ -1800,11 +1798,8 @@ mod tests {
 
     #[test]
     fn compact_target_from_upwards_difficulty_adjustment_using_headers() {
+        use crate::{block::Version, constants::genesis_block, TxMerkleNode};
         use hashes::Hash;
-
-        use crate::block::Version;
-        use crate::constants::genesis_block;
-        use crate::TxMerkleNode;
         let params = Params::new(crate::Network::Signet);
         let epoch_start = genesis_block(&params).header;
         // Block 2015, the only information used are `bits` and `time`
@@ -1814,30 +1809,27 @@ mod tests {
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1599332177,
             bits: epoch_start.bits,
-            nonce: epoch_start.nonce,
+            nonce: epoch_start.nonce
         };
-        let adjustment =
-            CompactTarget::from_header_difficulty_adjustment(epoch_start, current, params);
+        let adjustment = CompactTarget::from_header_difficulty_adjustment(epoch_start, current, params);
         let adjustment_bits = CompactTarget::from_consensus(503394215); // Block 2016 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
 
     #[test]
     fn compact_target_from_downwards_difficulty_adjustment_using_headers() {
+        use crate::{block::Version, TxMerkleNode};
         use hashes::Hash;
-
-        use crate::block::Version;
-        use crate::TxMerkleNode;
         let params = Params::new(crate::Network::Signet);
         let starting_bits = CompactTarget::from_consensus(503394215); // Block 2016 compact target
-                                                                      // Block 2016, the only information used is `time`
+        // Block 2016, the only information used is `time`
         let epoch_start = Header {
             version: Version::ONE,
             prev_blockhash: BlockHash::all_zeros(),
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1599332844,
             bits: starting_bits,
-            nonce: 0,
+            nonce: 0
         };
         // Block 4031, the only information used are `bits` and `time`
         let current = Header {
@@ -1846,10 +1838,9 @@ mod tests {
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1600591200,
             bits: starting_bits,
-            nonce: 0,
+            nonce: 0
         };
-        let adjustment =
-            CompactTarget::from_header_difficulty_adjustment(epoch_start, current, params);
+        let adjustment = CompactTarget::from_header_difficulty_adjustment(epoch_start, current, params);
         let adjustment_bits = CompactTarget::from_consensus(503397348); // Block 4032 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -1860,8 +1851,9 @@ mod tests {
         let starting_bits = CompactTarget::from_consensus(503403001);
         let timespan = (0.2 * params.pow_target_timespan as f64) as u64;
         let got = CompactTarget::from_next_work_required(starting_bits, timespan, params);
-        let want =
-            Target::from_compact(starting_bits).min_transition_threshold().to_compact_lossy();
+        let want = Target::from_compact(starting_bits)
+            .min_transition_threshold()
+            .to_compact_lossy();
         assert_eq!(got, want);
     }
 
@@ -1869,10 +1861,11 @@ mod tests {
     fn compact_target_from_minimum_downward_difficulty_adjustment() {
         let params = Params::new(crate::Network::Signet);
         let starting_bits = CompactTarget::from_consensus(403403001); // High difficulty for Signet
-        let timespan = 5 * params.pow_target_timespan; // Really slow.
+        let timespan =  5 * params.pow_target_timespan; // Really slow.
         let got = CompactTarget::from_next_work_required(starting_bits, timespan, &params);
-        let want =
-            Target::from_compact(starting_bits).max_transition_threshold(params).to_compact_lossy();
+        let want = Target::from_compact(starting_bits)
+            .max_transition_threshold(params)
+            .to_compact_lossy();
         assert_eq!(got, want);
     }
 
@@ -1880,7 +1873,7 @@ mod tests {
     fn compact_target_from_adjustment_is_max_target() {
         let params = Params::new(crate::Network::Signet);
         let starting_bits = CompactTarget::from_consensus(503543726); // Genesis compact target on Signet
-        let timespan = 5 * params.pow_target_timespan; // Really slow.
+        let timespan =  5 * params.pow_target_timespan; // Really slow.
         let got = CompactTarget::from_next_work_required(starting_bits, timespan, &params);
         let want = params.max_attainable_target.to_compact_lossy();
         assert_eq!(got, want);
diff --git a/bitcoin/tests/psbt-sign-taproot.rs b/bitcoin/tests/psbt-sign-taproot.rs
index 78fbcdd60..4cf7616b7 100644
--- a/bitcoin/tests/psbt-sign-taproot.rs
+++ b/bitcoin/tests/psbt-sign-taproot.rs
@@ -31,12 +31,13 @@ fn psbt_sign_taproot() {
             _secp: &Secp256k1<C>,
         ) -> Result<Option<PrivateKey>, Self::Error> {
             match key_request {
-                KeyRequest::Bip32((mfp, _)) =>
+                KeyRequest::Bip32((mfp, _)) => {
                     if mfp == self.mfp {
                         Ok(Some(self.sk))
                     } else {
                         Err(SignError::KeyNotFound)
-                    },
+                    }
+                }
                 _ => Err(SignError::KeyNotFound),
             }
         }
diff --git a/io/src/lib.rs b/io/src/lib.rs
index e7878625e..82d51acc7 100644
--- a/io/src/lib.rs
+++ b/io/src/lib.rs
@@ -211,7 +211,8 @@ impl<T: AsRef<[u8]>> Read for Cursor<T> {
         let start_pos = self.pos.try_into().unwrap_or(inner.len());
         let read = core::cmp::min(inner.len().saturating_sub(start_pos), buf.len());
         buf[..read].copy_from_slice(&inner[start_pos..start_pos + read]);
-        self.pos = self.pos.saturating_add(read.try_into().unwrap_or(u64::MAX /* unreachable */));
+        self.pos =
+            self.pos.saturating_add(read.try_into().unwrap_or(u64::MAX /* unreachable */));
         Ok(read)
     }
 }
diff --git a/units/src/lib.rs b/units/src/lib.rs
index 393b5ced1..b2c278795 100644
--- a/units/src/lib.rs
+++ b/units/src/lib.rs
@@ -45,14 +45,17 @@ pub mod parse;
 #[cfg(feature = "alloc")]
 pub mod weight;
 
-pub use self::amount::ParseAmountError;
 #[doc(inline)]
 pub use self::amount::{Amount, SignedAmount};
+pub use self::amount::ParseAmountError;
 #[cfg(feature = "alloc")]
 pub use self::parse::ParseIntError;
 #[cfg(feature = "alloc")]
 #[doc(inline)]
-pub use self::{fee_rate::FeeRate, weight::Weight};
+pub use self::{
+    fee_rate::FeeRate,
+    weight::Weight,
+};
 
 #[rustfmt::skip]
 #[allow(unused_imports)]

From 081989f258208e4ae809138581adc10bcd23c579 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 11:12:17 +0200
Subject: [PATCH 31/53] update workflows to include doge-master branch

---
 .github/workflows/release.yml |  1 +
 .github/workflows/rust.yml    | 29 +++++++++++++++--------------
 fuzz/generate-files.sh        |  1 +
 3 files changed, 17 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index cd2a87255..7e74972ac 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -2,6 +2,7 @@ on:
   push:
     branches:
       - master
+      - doge-master
       - 0.28.x
       - 0.29.x
       - 'test-ci/**'
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 5907f8491..bbb2a6f00 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -1,8 +1,9 @@
 ---   # rust-bitcoin CI: If you edit this file please update README.md
-on:   # yamllint disable-line rule:truthy
+on: # yamllint disable-line rule:truthy
   push:
     branches:
       - master
+      - doge-master
       - 'test-ci/**'
   pull_request:
 
@@ -20,13 +21,13 @@ jobs:
         id: read_toolchain
         run: echo "nightly_version=$(cat nightly-version)" >> $GITHUB_OUTPUT
 
-  Stable:                       # 2 jobs, one per manifest.
+  Stable: # 2 jobs, one per manifest.
     name: Test - stable toolchain
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        dep: [minimal, recent]
+        dep: [ minimal, recent ]
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
@@ -43,14 +44,14 @@ jobs:
       - name: "Run test script"
         run: ./maintainer-tools/ci/run_task.sh stable
 
-  Nightly:                      # 2 jobs, one per manifest.
+  Nightly: # 2 jobs, one per manifest.
     name: Test - nightly toolchain
     needs: Prepare
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        dep: [minimal, recent]
+        dep: [ minimal, recent ]
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
@@ -69,13 +70,13 @@ jobs:
       - name: "Run test script"
         run: ./maintainer-tools/ci/run_task.sh nightly
 
-  MSRV:                         # 2 jobs, one per manifest.
+  MSRV: # 2 jobs, one per manifest.
     name: Test - MSRV toolchain
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        dep: [minimal, recent]
+        dep: [ minimal, recent ]
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
@@ -101,7 +102,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        dep: [recent]
+        dep: [ recent ]
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
@@ -128,7 +129,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        dep: [recent]
+        dep: [ recent ]
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
@@ -152,7 +153,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        dep: [recent]
+        dep: [ recent ]
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
@@ -178,7 +179,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        dep: [recent]
+        dep: [ recent ]
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
@@ -256,14 +257,14 @@ jobs:
       - name: "Run hashes/embedded with alloc"
         run: cd hashes/embedded && cargo run --target thumbv7m-none-eabi --features=alloc
 
-  ASAN:                         # hashes crate only.
+  ASAN: # hashes crate only.
     name: ASAN - nightly toolchain
     needs: Prepare
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        dep: [recent]
+        dep: [ recent ]
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
@@ -278,7 +279,7 @@ jobs:
       - name: "Run sanitizer script"
         run: cd ./hashes && ./contrib/sanitizer.sh
 
-  WASM:                         # hashes crate only.
+  WASM: # hashes crate only.
     name: WASM - stable toolchain
     runs-on: ubuntu-latest
     strategy:
diff --git a/fuzz/generate-files.sh b/fuzz/generate-files.sh
index bbb36ea46..337d321f5 100755
--- a/fuzz/generate-files.sh
+++ b/fuzz/generate-files.sh
@@ -48,6 +48,7 @@ on:
   push:
     branches:
       - master
+      - doge-master
       - 'test-ci/**'
   pull_request:
 

From a6163fb9d57cdc7516fe52d55a360e1a58c65184 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 11:45:12 +0200
Subject: [PATCH 32/53] update labeler configuration to include base-branch for
 doge-master

---
 .github/labeler.yml | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index 884b5961a..2046e47e4 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -1,15 +1,18 @@
 ci:
   - changed-files:
-    - any-glob-to-any-file: .github/**
+      - any-glob-to-any-file: .github/**
+  - base-branch: [ 'doge-master' ]
 test:
   - changed-files:
-    - any-glob-to-any-file: fuzz/**
-    - any-glob-to-any-file: '*/tests/**'
-    - any-glob-to-any-file: 'dep_test'
-    - any-glob-to-any-file: 'contrib/run_task.sh'
-    - any-glob-to-any-file: 'contrib/test_vars.sh'
-    - any-glob-to-any-file: '*/contrib/extra_tests.sh'
-    - any-glob-to-any-file: '*/contrib/test_vars.sh'
+      - any-glob-to-any-file: fuzz/**
+      - any-glob-to-any-file: '*/tests/**'
+      - any-glob-to-any-file: 'dep_test'
+      - any-glob-to-any-file: 'contrib/run_task.sh'
+      - any-glob-to-any-file: 'contrib/test_vars.sh'
+      - any-glob-to-any-file: '*/contrib/extra_tests.sh'
+      - any-glob-to-any-file: '*/contrib/test_vars.sh'
+  - base-branch: [ 'doge-master' ]
 doc:
   - changed-files:
-    - any-glob-to-any-file: '**/*.md'
+      - any-glob-to-any-file: '**/*.md'
+  - base-branch: [ 'doge-master' ]

From 8b2e5924062c9be9981f6653c7aa55fe6c5cd63f Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 11:57:07 +0200
Subject: [PATCH 33/53] Revert "update labeler configuration to include
 base-branch for doge-master"

This reverts commit aa11fe61d1bf9c76c1f4d16ceac9d06fc6abe4f5.
---
 .github/labeler.yml | 21 +++++++++------------
 1 file changed, 9 insertions(+), 12 deletions(-)

diff --git a/.github/labeler.yml b/.github/labeler.yml
index 2046e47e4..884b5961a 100644
--- a/.github/labeler.yml
+++ b/.github/labeler.yml
@@ -1,18 +1,15 @@
 ci:
   - changed-files:
-      - any-glob-to-any-file: .github/**
-  - base-branch: [ 'doge-master' ]
+    - any-glob-to-any-file: .github/**
 test:
   - changed-files:
-      - any-glob-to-any-file: fuzz/**
-      - any-glob-to-any-file: '*/tests/**'
-      - any-glob-to-any-file: 'dep_test'
-      - any-glob-to-any-file: 'contrib/run_task.sh'
-      - any-glob-to-any-file: 'contrib/test_vars.sh'
-      - any-glob-to-any-file: '*/contrib/extra_tests.sh'
-      - any-glob-to-any-file: '*/contrib/test_vars.sh'
-  - base-branch: [ 'doge-master' ]
+    - any-glob-to-any-file: fuzz/**
+    - any-glob-to-any-file: '*/tests/**'
+    - any-glob-to-any-file: 'dep_test'
+    - any-glob-to-any-file: 'contrib/run_task.sh'
+    - any-glob-to-any-file: 'contrib/test_vars.sh'
+    - any-glob-to-any-file: '*/contrib/extra_tests.sh'
+    - any-glob-to-any-file: '*/contrib/test_vars.sh'
 doc:
   - changed-files:
-      - any-glob-to-any-file: '**/*.md'
-  - base-branch: [ 'doge-master' ]
+    - any-glob-to-any-file: '**/*.md'

From 96dd33ae0c17f01fc28d505884355d6b199640d4 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 26 May 2025 12:57:43 +0200
Subject: [PATCH 34/53] Reapply "add write permission to labeller for issues"

This reverts commit 7adbf2966df2ec463bc998e6bffc327cbd581925.
---
 .github/workflows/manage-pr.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/manage-pr.yml b/.github/workflows/manage-pr.yml
index 3ba1dcc55..885382208 100644
--- a/.github/workflows/manage-pr.yml
+++ b/.github/workflows/manage-pr.yml
@@ -6,6 +6,7 @@ jobs:
   labeler:
     permissions:
       contents: read
+      issues: write
       pull-requests: write
     runs-on: ubuntu-latest
     steps:

From 28571b3ea325a857a86ed54c02a1d1b76d876459 Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Wed, 28 May 2025 10:25:42 +0200
Subject: [PATCH 35/53] feature(dogecoin): add scrypt PoW validation

---
 bitcoin/Cargo.toml             |   1 +
 bitcoin/src/blockdata/block.rs |  32 ++++++++
 bitcoin/src/dogecoin/mod.rs    | 140 +++++++++++++++++++++++++++++++--
 3 files changed, 165 insertions(+), 8 deletions(-)

diff --git a/bitcoin/Cargo.toml b/bitcoin/Cargo.toml
index 8c9f6ae8a..5897ab9ef 100644
--- a/bitcoin/Cargo.toml
+++ b/bitcoin/Cargo.toml
@@ -34,6 +34,7 @@ hex_lit = "0.1.1"
 internals = { package = "bitcoin-internals", version = "0.3.0", features = ["alloc"] }
 io = { package = "bitcoin-io", version = "0.1.1", default-features = false, features = ["alloc"] }
 secp256k1 = { version = "0.29.0", default-features = false, features = ["hashes", "alloc"] }
+scrypt = { version = "0.11.0", default-features = false }
 units = { package = "bitcoin-units", version = "0.1.0", default-features = false, features = ["alloc"] }
 
 base64 = { version = "0.21.3", optional = true }
diff --git a/bitcoin/src/blockdata/block.rs b/bitcoin/src/blockdata/block.rs
index ec24abb42..1bc234e50 100644
--- a/bitcoin/src/blockdata/block.rs
+++ b/bitcoin/src/blockdata/block.rs
@@ -12,6 +12,7 @@ use core::fmt;
 
 use hashes::{sha256d, Hash, HashEngine};
 use io::{Read, Write};
+use scrypt::{scrypt, Params as ScryptParams};
 
 use super::Weight;
 use crate::blockdata::script;
@@ -86,6 +87,20 @@ impl Header {
         BlockHash::from_engine(engine)
     }
 
+    /// Returns the block hash using the scrypt hash function.
+    pub fn block_hash_with_scrypt(&self) -> BlockHash {
+        let params = ScryptParams::new(10, 1, 1, 32).expect("invalid scrypt params");
+
+        let mut output = [0u8; 32];
+
+        let mut buf = Vec::new();
+        self.consensus_encode(&mut buf).expect("write to vec failed");
+
+        scrypt(buf.as_slice(), buf.as_slice(), &params, &mut output).unwrap();
+
+        BlockHash::from_slice(&output).unwrap()
+    }
+
     /// Computes the target (range [0, T] inclusive) that a blockhash must land in to be valid.
     pub fn target(&self) -> Target { self.bits.into() }
 
@@ -114,6 +129,23 @@ impl Header {
         }
     }
 
+    /// Checks that the proof-of-work using scrypt is valid, returning the scrypt block hash.
+    pub fn validate_pow_with_scrypt(
+        &self,
+        required_target: Target,
+    ) -> Result<BlockHash, ValidationError> {
+        let target = self.target();
+        if target != required_target {
+            return Err(ValidationError::BadTarget);
+        }
+        let block_hash = self.block_hash_with_scrypt();
+        if target.is_met_by(block_hash) {
+            Ok(block_hash)
+        } else {
+            Err(ValidationError::BadProofOfWork)
+        }
+    }
+
     /// Returns the total work of the block.
     pub fn work(&self) -> Work { self.target().to_work() }
 }
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index e26b72068..31033cca2 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -3,8 +3,7 @@
 //! This module provides support for de/serialization, parsing and execution on data structures and
 //! network messages related to Dogecoin.
 
-use crate::block::Header;
-use crate::block::TxMerkleNode;
+use crate::block::{Header, TxMerkleNode};
 use crate::consensus::{encode, Decodable, Encodable};
 use crate::internal_macros::impl_consensus_encoding;
 use crate::io::{Read, Write};
@@ -14,9 +13,7 @@ use crate::{io, BlockHash, Transaction};
 /// AuxPow version bit, see <https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23>
 pub const VERSION_AUXPOW: i32 = 1 << 8;
 
-fn is_auxpow(header: Header) -> bool {
-    (header.version.to_consensus() & VERSION_AUXPOW) != 0
-}
+fn is_auxpow(header: Header) -> bool { (header.version.to_consensus() & VERSION_AUXPOW) != 0 }
 
 /// Data for merge-mining AuxPoW.
 ///
@@ -81,9 +78,10 @@ pub struct Block {
 
 impl Block {
     /// Returns the block hash computed as SHA256d(header).
-    pub fn block_hash(&self) -> BlockHash {
-        self.header.block_hash()
-    }
+    pub fn block_hash(&self) -> BlockHash { self.header.block_hash() }
+
+    /// Returns the block hash using the scrypt hash function.
+    pub fn block_hash_with_scrypt(&self) -> BlockHash { self.header.block_hash_with_scrypt() }
 }
 
 impl Decodable for Block {
@@ -115,3 +113,129 @@ impl Encodable for Block {
         Ok(len)
     }
 }
+
+#[cfg(test)]
+mod tests {
+    use hex::test_hex_unwrap as hex;
+
+    use super::*;
+    use crate::block::{ValidationError, Version};
+    use crate::consensus::encode::{deserialize, serialize};
+    use crate::{CompactTarget, Network, Target, Work};
+
+    #[test]
+    fn dogecoin_block_test() {
+        let params = crate::consensus::Params::new(Network::Bitcoin);
+        // Mainnet Dogecoin block 5794c80b80d9c33e0737a5353cd52b1f097f61d8d2b9f471e1702345080e0002
+        let some_block = hex!("01000000c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba3894b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a207d78bb52de8f001c00da8c3c0201000000010000000000000000000000000000000000000000000000000000000000000000ffffffff2602bc6d062f503253482f047178bb5208f8042975030000000d2f7374726174756d506f6f6c2f000000000100629b29c45500001976a91450e9fe87c705dcd4b7523b47e3314c2115f5d5df88ac0000000001000000015f48fabf4425324df2b5e58f4e9c771297f76f5fa37db7556f6fc1d22742da1f010000006a473044022062d29d2d26f7d826e7b72257486e294d284832743c7803a2901eb07e326b25a002207efc391b0f4e724c9d518075c0e056cc425540f845b0fd419ba8a9d49d69288301210297a2568525760a98454d84f5e5adba9fd0a41726a6fb774ddc407279e41e2061ffffffff0240bab598200000001976a91401348a2b83aeb6b1ba2a174a1a40b7c75fbeb12088ac0040be40250000001976a914025407d928ef333979d064ae233353d80e29d58c88ac00000000");
+        let cutoff_block = hex!("01000000c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba3894b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a207d78bb52de8f001c00da8c3c0201000000010000000000000000000000000000000000000000000000000000000000000000ffffffff2602bc6d062f503253482f047178bb5208f8042975030000000d2f7374726174756d506f6f6c2f000000000100629b29c45500001976a91450e9fe87c705dcd4b7523b47e3314c2115f5d5df88ac0000000001000000015f48fabf4425324df2b5e58f4e9c771297f76f5fa37db7556f6fc1d22742da1f010000006a473044022062d29d2d26f7d826e7b72257486e294d284832743c7803a2901eb07e326b25a002207efc391b0f4e724c9d518075c0e056cc425540f845b0fd419ba8a9d49d69288301210297a2568525760a98454d84f5e5adba9fd0a41726a6fb774ddc407279e41e2061ffffffff0240bab598200000001976a91401348a2b83aeb6b1ba2a174a1a40b7c75fbeb12088ac0040be40250000001976a914025407d928ef333979d064ae233353d80e29d58c88ac");
+
+        let currhash = hex!("02000e08452370e171f4b9d2d8617f091f2bd53c35a537073ec3d9800bc89457");
+        let prevhash = hex!("c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba38");
+        let merkle = hex!("94b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a20");
+        let work = Work::from(0x1c788001c78_u128);
+
+        let decode: Result<Block, _> = deserialize(&some_block);
+        let bad_decode: Result<Block, _> = deserialize(&cutoff_block);
+
+        assert!(decode.is_ok());
+        assert!(bad_decode.is_err());
+        let real_decode = decode.unwrap();
+        assert_eq!(serialize(&real_decode.header.block_hash()), currhash);
+        assert_eq!(real_decode.header.version, Version::ONE);
+        assert_eq!(serialize(&real_decode.header.prev_blockhash), prevhash);
+        // assert_eq!(real_decode.header.merkle_root, real_decode.compute_merkle_root().unwrap());
+        assert_eq!(serialize(&real_decode.header.merkle_root), merkle);
+        assert_eq!(real_decode.header.time, 1388017789);
+        assert_eq!(real_decode.header.bits, CompactTarget::from_consensus(469798878));
+        assert_eq!(real_decode.header.nonce, 1015863808);
+        assert_eq!(real_decode.header.work(), work);
+        assert_eq!(
+            real_decode.header.validate_pow_with_scrypt(real_decode.header.target()).unwrap(),
+            real_decode.block_hash_with_scrypt()
+        );
+        assert_eq!(real_decode.header.difficulty(&params), 455);
+        assert_eq!(real_decode.header.difficulty_float(), 455.52430084170516);
+
+        assert_eq!(serialize(&real_decode), some_block);
+    }
+
+    #[test]
+    fn validate_pow_with_scrypt_test() {
+        let some_header = hex!("01000000c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba3894b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a207d78bb52de8f001c00da8c3c");
+        let some_header: Header =
+            deserialize(&some_header).expect("Can't deserialize correct block header");
+        assert_eq!(
+            some_header.validate_pow_with_scrypt(some_header.target()).unwrap(),
+            some_header.block_hash_with_scrypt()
+        );
+
+        // test with zero target
+        match some_header.validate_pow_with_scrypt(Target::ZERO) {
+            Err(ValidationError::BadTarget) => (),
+            _ => panic!("unexpected result from validate_pow_with_scrypt"),
+        }
+
+        // test with modified header
+        let mut invalid_header: Header = some_header;
+        invalid_header.nonce += 1;
+        match invalid_header.validate_pow_with_scrypt(invalid_header.target()) {
+            Err(ValidationError::BadProofOfWork) => (),
+            _ => panic!("unexpected result from validate_pow_with_scrypt"),
+        }
+    }
+
+    #[test]
+    fn block_hash_with_scrypt_test() {
+        struct Test {
+            input: Vec<u8>,
+            output: Vec<u8>,
+            output_str: &'static str,
+        }
+
+        let tests = vec![
+            // Example from <https://litecoin.info/docs/key-concepts/proof-of-work>
+            Test {
+                input: hex!("01000000f615f7ce3b4fc6b8f61e8f89aedb1d0852507650533a9e3b10b9bbcc30639f279fcaa86746e1ef52d3edb3c4ad8259920d509bd073605c9bf1d59983752a6b06b817bb4ea78e011d012d59d4"),
+                output: vec![217, 235, 134, 99, 255, 236, 36, 28, 47, 177, 24, 173, 183, 222, 151, 168, 44, 128, 59, 111, 244, 109, 87, 102, 121, 53, 200, 16, 1, 0, 0, 0],
+                output_str: "0000000110c8357966576df46f3b802ca897deb7ad18b12f1c24ecff6386ebd9"
+            },
+            // Examples from <https://github.com/dogecoin/ltc-scrypt/blob/main/test.py>
+            Test {
+                input: hex!("020000004c1271c211717198227392b029a64a7971931d351b387bb80db027f270411e398a07046f7d4a08dd815412a8712f874a7ebf0507e3878bd24e20a3b73fd750a667d2f451eac7471b00de6659"),
+                output: vec![6, 88, 152, 215, 171, 45, 170, 130, 53, 205, 218, 149, 17, 210, 72, 243, 1, 11, 94, 17, 246, 130, 248, 7, 65, 239, 43, 0, 0, 0, 0, 0],
+                output_str: "00000000002bef4107f882f6115e0b01f348d21195dacd3582aa2dabd7985806",
+            },
+            Test {
+                input: hex!("0200000011503ee6a855e900c00cfdd98f5f55fffeaee9b6bf55bea9b852d9de2ce35828e204eef76acfd36949ae56d1fbe81c1ac9c0209e6331ad56414f9072506a77f8c6faf551eac7471b00389d01"),
+                output: vec![148, 252, 136, 28, 159, 241, 218, 80, 210, 53, 237, 40, 242, 187, 207, 221, 254, 183, 8, 78, 99, 235, 213, 189, 17, 13, 58, 0, 0, 0, 0, 0],
+                output_str: "00000000003a0d11bdd5eb634e08b7feddcfbbf228ed35d250daf19f1c88fc94",
+            },
+            Test {
+                input: hex!("02000000a72c8a177f523946f42f22c3e86b8023221b4105e8007e59e81f6beb013e29aaf635295cb9ac966213fb56e046dc71df5b3f7f67ceaeab24038e743f883aff1aaafaf551eac7471b0166249b"),
+                output: vec![129, 202, 168, 20, 81, 221, 248, 101, 156, 242, 175, 216, 89, 157, 45, 108, 138, 114, 68, 50, 225, 136, 242, 149, 248, 64, 11, 0, 0, 0, 0, 0],
+                output_str: "00000000000b40f895f288e13244728a6c2d9d59d8aff29c65f8dd5114a8ca81",
+            },
+            Test {
+                input: hex!("010000007824bc3a8a1b4628485eee3024abd8626721f7f870f8ad4d2f33a27155167f6a4009d1285049603888fe85a84b6c803a53305a8d497965a5e896e1a00568359589faf551eac7471b0065434e"),
+                output: vec![254, 5, 225, 151, 24, 24, 134, 106, 220, 126, 142, 110, 47, 215, 232, 216, 153, 30, 3, 35, 73, 205, 145, 88, 0, 7, 48, 0, 0, 0, 0, 0],
+                output_str: "00000000003007005891cd4923031e99d8e8d72f6e8e7edc6a86181897e105fe",
+            },
+            Test {
+                input: hex!("0200000050bfd4e4a307a8cb6ef4aef69abc5c0f2d579648bd80d7733e1ccc3fbc90ed664a7f74006cb11bde87785f229ecd366c2d4e44432832580e0608c579e4cb76f383f7f551eac7471b00c36982"),
+                output: vec![140, 236, 0, 56, 77, 114, 199, 231, 79, 91, 52, 13, 115, 175, 2, 250, 71, 203, 12, 19, 199, 175, 164, 38, 180, 240, 24, 0, 0, 0, 0, 0],
+                output_str: "000000000018f0b426a4afc7130ccb47fa02af730d345b4fe7c7724d3800ec8c",
+            },
+        ];
+
+        for test in tests {
+            let header: Header =
+                deserialize(&test.input).expect("Can't deserialize correct block header");
+            assert_eq!(header.block_hash_with_scrypt().to_string(), test.output_str);
+            assert_eq!(serialize(&header.block_hash_with_scrypt()), test.output);
+        }
+    }
+
+    #[test]
+    fn target_exceeds_max_allowed_test() {}
+}

From 8190978f8526c7ec4e3a44e7c78ff3f9a0745f8b Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Wed, 28 May 2025 10:28:41 +0200
Subject: [PATCH 36/53] remove leftover test

---
 bitcoin/src/dogecoin/mod.rs | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index 31033cca2..55f682c9c 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -235,7 +235,4 @@ mod tests {
             assert_eq!(serialize(&header.block_hash_with_scrypt()), test.output);
         }
     }
-
-    #[test]
-    fn target_exceeds_max_allowed_test() {}
 }

From 33cf462550771643162e9aade4f49cdcbdb838dc Mon Sep 17 00:00:00 2001
From: Mathieu Ducroux <mathieu.ducroux@dfinity.org>
Date: Wed, 28 May 2025 10:32:21 +0200
Subject: [PATCH 37/53] update lock files

---
 Cargo-minimal.lock | 149 ++++++++++++++++++++++++++++++++++++++++++++-
 Cargo-recent.lock  | 141 +++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 285 insertions(+), 5 deletions(-)

diff --git a/Cargo-minimal.lock b/Cargo-minimal.lock
index 8b47f1e59..ae1a28845 100644
--- a/Cargo-minimal.lock
+++ b/Cargo-minimal.lock
@@ -62,6 +62,7 @@ dependencies = [
  "hex_lit",
  "mutagen",
  "ordered",
+ "scrypt",
  "secp256k1",
  "serde",
  "serde_json",
@@ -121,6 +122,15 @@ dependencies = [
  "cc",
 ]
 
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
 [[package]]
 name = "byteorder"
 version = "1.3.0"
@@ -139,19 +149,75 @@ version = "0.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d4c819a1287eb618df47cc647173c5c4c66ba19d888a6e50d605672aed3140de"
 
+[[package]]
+name = "cfg-if"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+
+[[package]]
+name = "cipher"
+version = "0.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "773f3b9af64447d2ce9850330c473515014aa235e6a783b02db81ff39e4a3dad"
+dependencies = [
+ "crypto-common",
+ "inout",
+]
+
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer",
+ "crypto-common",
+ "subtle",
+]
+
 [[package]]
 name = "dyn-clone"
 version = "1.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0da518043f6481364cd454be81dfe096cfd3f82daa1466f4946d24ea325b0941"
 
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+
 [[package]]
 name = "getrandom"
 version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ee8025cf36f917e6a52cce185b7c7177689b838b7ec138364e50cc2277a56cf4"
 dependencies = [
- "cfg-if",
+ "cfg-if 0.1.2",
  "libc",
  "wasi",
 ]
@@ -177,6 +243,15 @@ version = "0.1.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3011d1213f159867b13cfd6ac92d2cd5f1345762c63be3554e84092d85a50bbd"
 
+[[package]]
+name = "hmac"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6c49c37c09c17a53d937dfbb742eb3a961d65a994e6bcdcf37e7399d0cc8ab5e"
+dependencies = [
+ "digest",
+]
+
 [[package]]
 name = "honggfuzz"
 version = "0.5.55"
@@ -188,6 +263,15 @@ dependencies = [
  "rustc_version",
 ]
 
+[[package]]
+name = "inout"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "879f10e63c20629ecabbb64a8010319738c66a5cd0c29b02d63d272b03751d01"
+dependencies = [
+ "generic-array",
+]
+
 [[package]]
 name = "itoa"
 version = "0.4.3"
@@ -208,9 +292,9 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
 
 [[package]]
 name = "libc"
-version = "0.2.64"
+version = "0.2.172"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "74dfca3d9957906e8d1e6a0b641dc9a59848e793f1da2165889fd4f62d10d79c"
+checksum = "d750af042f7ef4f724306de029d18836c26c1765a54a6a3f094cbd23a7267ffa"
 
 [[package]]
 name = "memmap2"
@@ -260,6 +344,16 @@ version = "0.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7f0642533dea0bb58bd5cae31bafc1872429f0f12ac8c61fe2b4ba44f80b959b"
 
+[[package]]
+name = "pbkdf2"
+version = "0.12.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8ed6a7761f76e3b9f92dfb0a60a6a6477c61024b775147ff0973a02653abaf2"
+dependencies = [
+ "digest",
+ "hmac",
+]
+
 [[package]]
 name = "ppv-lite86"
 version = "0.2.8"
@@ -339,6 +433,15 @@ version = "1.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c92464b447c0ee8c4fb3824ecc8383b81717b9f1e74ba2e72540aef7b9f82997"
 
+[[package]]
+name = "salsa20"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97a22f5af31f73a954c10289c93e8a50cc23d971e80ee446f1f6f7137a088213"
+dependencies = [
+ "cipher",
+]
+
 [[package]]
 name = "schemars"
 version = "0.8.3"
@@ -350,6 +453,17 @@ dependencies = [
  "serde_json",
 ]
 
+[[package]]
+name = "scrypt"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0516a385866c09368f0b5bcd1caff3366aace790fcd46e2bb032697bb172fd1f"
+dependencies = [
+ "pbkdf2",
+ "salsa20",
+ "sha2",
+]
+
 [[package]]
 name = "secp256k1"
 version = "0.29.0"
@@ -428,6 +542,23 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "sha2"
+version = "0.10.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283"
+dependencies = [
+ "cfg-if 1.0.0",
+ "cpufeatures",
+ "digest",
+]
+
+[[package]]
+name = "subtle"
+version = "2.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
+
 [[package]]
 name = "syn"
 version = "1.0.109"
@@ -439,12 +570,24 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "typenum"
+version = "1.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1dccffe3ce07af9386bfd29e80c0ab1a8205a2fc34e4bcd40364df902cfa8f3f"
+
 [[package]]
 name = "unicode-ident"
 version = "1.0.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e5464a87b239f13a63a501f2701565754bae92d243d4bb7eb12f6d57d2269bf4"
 
+[[package]]
+name = "version_check"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
+
 [[package]]
 name = "wasi"
 version = "0.9.0+wasi-snapshot-preview1"
diff --git a/Cargo-recent.lock b/Cargo-recent.lock
index 9f49d4c0c..a9b178ed5 100644
--- a/Cargo-recent.lock
+++ b/Cargo-recent.lock
@@ -61,6 +61,7 @@ dependencies = [
  "hex_lit",
  "mutagen",
  "ordered",
+ "scrypt",
  "secp256k1",
  "serde",
  "serde_json",
@@ -120,6 +121,15 @@ dependencies = [
  "cc",
 ]
 
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
 [[package]]
 name = "byteorder"
 version = "1.4.3"
@@ -138,12 +148,62 @@ version = "1.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
 
+[[package]]
+name = "cipher"
+version = "0.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "773f3b9af64447d2ce9850330c473515014aa235e6a783b02db81ff39e4a3dad"
+dependencies = [
+ "crypto-common",
+ "inout",
+]
+
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer",
+ "crypto-common",
+ "subtle",
+]
+
 [[package]]
 name = "dyn-clone"
 version = "1.0.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "68b0cf012f1230e43cd00ebb729c6bb58707ecfa8ad08b52ef3a4ccd2697fc30"
 
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+
 [[package]]
 name = "getrandom"
 version = "0.2.9"
@@ -176,6 +236,15 @@ version = "0.1.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3011d1213f159867b13cfd6ac92d2cd5f1345762c63be3554e84092d85a50bbd"
 
+[[package]]
+name = "hmac"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6c49c37c09c17a53d937dfbb742eb3a961d65a994e6bcdcf37e7399d0cc8ab5e"
+dependencies = [
+ "digest",
+]
+
 [[package]]
 name = "honggfuzz"
 version = "0.5.55"
@@ -187,6 +256,15 @@ dependencies = [
  "rustc_version",
 ]
 
+[[package]]
+name = "inout"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "879f10e63c20629ecabbb64a8010319738c66a5cd0c29b02d63d272b03751d01"
+dependencies = [
+ "generic-array",
+]
+
 [[package]]
 name = "itoa"
 version = "1.0.6"
@@ -207,9 +285,9 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
 
 [[package]]
 name = "libc"
-version = "0.2.142"
+version = "0.2.172"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6a987beff54b60ffa6d51982e1aa1146bc42f19bd26be28b0586f252fccf5317"
+checksum = "d750af042f7ef4f724306de029d18836c26c1765a54a6a3f094cbd23a7267ffa"
 
 [[package]]
 name = "memmap2"
@@ -259,6 +337,16 @@ version = "0.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7f0642533dea0bb58bd5cae31bafc1872429f0f12ac8c61fe2b4ba44f80b959b"
 
+[[package]]
+name = "pbkdf2"
+version = "0.12.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8ed6a7761f76e3b9f92dfb0a60a6a6477c61024b775147ff0973a02653abaf2"
+dependencies = [
+ "digest",
+ "hmac",
+]
+
 [[package]]
 name = "ppv-lite86"
 version = "0.2.17"
@@ -328,6 +416,15 @@ version = "1.0.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f91339c0467de62360649f8d3e185ca8de4224ff281f66000de5eb2a77a79041"
 
+[[package]]
+name = "salsa20"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97a22f5af31f73a954c10289c93e8a50cc23d971e80ee446f1f6f7137a088213"
+dependencies = [
+ "cipher",
+]
+
 [[package]]
 name = "schemars"
 version = "0.8.12"
@@ -339,6 +436,17 @@ dependencies = [
  "serde_json",
 ]
 
+[[package]]
+name = "scrypt"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0516a385866c09368f0b5bcd1caff3366aace790fcd46e2bb032697bb172fd1f"
+dependencies = [
+ "pbkdf2",
+ "salsa20",
+ "sha2",
+]
+
 [[package]]
 name = "secp256k1"
 version = "0.29.0"
@@ -417,6 +525,23 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "sha2"
+version = "0.10.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a7507d819769d01a365ab707794a4084392c824f54a7a6a7862f8c3d0892b283"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest",
+]
+
+[[package]]
+name = "subtle"
+version = "2.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "13c2bddecc57b384dee18652358fb23172facb8a2c51ccc10d74c157bdea3292"
+
 [[package]]
 name = "syn"
 version = "1.0.109"
@@ -428,12 +553,24 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "typenum"
+version = "1.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1dccffe3ce07af9386bfd29e80c0ab1a8205a2fc34e4bcd40364df902cfa8f3f"
+
 [[package]]
 name = "unicode-ident"
 version = "1.0.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e5464a87b239f13a63a501f2701565754bae92d243d4bb7eb12f6d57d2269bf4"
 
+[[package]]
+name = "version_check"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"
+
 [[package]]
 name = "wasi"
 version = "0.11.0+wasi-snapshot-preview1"

From 9cf9d935d4b34494ba0b2f4b71de9cc3dfb3be96 Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Tue, 10 Jun 2025 08:21:15 +0200
Subject: [PATCH 38/53] chore(license): add Apache-2.0 license (#4)

[XC-374](https://dfinity.atlassian.net/browse/XC-374?atlOrigin=eyJpIjoiM2VjNTk4OWNmNzY1NDUzZmEwODE1ODI0NWVkMTJkMmMiLCJwIjoiaiJ9):
this PR adds the Apache-2.0 license to the dogecoin module while
preserving the CC0-1.0 license for code inherited from upstream
rust-bitcoin.

[XC-374]:
https://dfinity.atlassian.net/browse/XC-374?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
---
 LICENSE                        | 311 ++++++++++++++++++++-------------
 README.md                      |   5 +-
 bitcoin/src/blockdata/block.rs |   2 +-
 bitcoin/src/dogecoin/mod.rs    |   2 +
 4 files changed, 197 insertions(+), 123 deletions(-)

diff --git a/LICENSE b/LICENSE
index 6ca207ef0..71b381e56 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,122 +1,191 @@
-Creative Commons Legal Code
-
-CC0 1.0 Universal
-
-    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
-    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
-    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
-    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
-    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
-    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
-    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
-    HEREUNDER.
-
-Statement of Purpose
-
-The laws of most jurisdictions throughout the world automatically confer
-exclusive Copyright and Related Rights (defined below) upon the creator
-and subsequent owner(s) (each and all, an "owner") of an original work of
-authorship and/or a database (each, a "Work").
-
-Certain owners wish to permanently relinquish those rights to a Work for
-the purpose of contributing to a commons of creative, cultural and
-scientific works ("Commons") that the public can reliably and without fear
-of later claims of infringement build upon, modify, incorporate in other
-works, reuse and redistribute as freely as possible in any form whatsoever
-and for any purposes, including without limitation commercial purposes.
-These owners may contribute to the Commons to promote the ideal of a free
-culture and the further production of creative, cultural and scientific
-works, or to gain reputation or greater distribution for their Work in
-part through the use and efforts of others.
-
-For these and/or other purposes and motivations, and without any
-expectation of additional consideration or compensation, the person
-associating CC0 with a Work (the "Affirmer"), to the extent that he or she
-is an owner of Copyright and Related Rights in the Work, voluntarily
-elects to apply CC0 to the Work and publicly distribute the Work under its
-terms, with knowledge of his or her Copyright and Related Rights in the
-Work and the meaning and intended legal effect of CC0 on those rights.
-
-1. Copyright and Related Rights. A Work made available under CC0 may be
-protected by copyright and related or neighboring rights ("Copyright and
-Related Rights"). Copyright and Related Rights include, but are not
-limited to, the following:
-
-  i. the right to reproduce, adapt, distribute, perform, display,
-     communicate, and translate a Work;
- ii. moral rights retained by the original author(s) and/or performer(s);
-iii. publicity and privacy rights pertaining to a person's image or
-     likeness depicted in a Work;
- iv. rights protecting against unfair competition in regards to a Work,
-     subject to the limitations in paragraph 4(a), below;
-  v. rights protecting the extraction, dissemination, use and reuse of data
-     in a Work;
- vi. database rights (such as those arising under Directive 96/9/EC of the
-     European Parliament and of the Council of 11 March 1996 on the legal
-     protection of databases, and under any national implementation
-     thereof, including any amended or successor version of such
-     directive); and
-vii. other similar, equivalent or corresponding rights throughout the
-     world based on applicable law or treaty, and any national
-     implementations thereof.
-
-2. Waiver. To the greatest extent permitted by, but not in contravention
-of, applicable law, Affirmer hereby overtly, fully, permanently,
-irrevocably and unconditionally waives, abandons, and surrenders all of
-Affirmer's Copyright and Related Rights and associated claims and causes
-of action, whether now known or unknown (including existing as well as
-future claims and causes of action), in the Work (i) in all territories
-worldwide, (ii) for the maximum duration provided by applicable law or
-treaty (including future time extensions), (iii) in any current or future
-medium and for any number of copies, and (iv) for any purpose whatsoever,
-including without limitation commercial, advertising or promotional
-purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
-member of the public at large and to the detriment of Affirmer's heirs and
-successors, fully intending that such Waiver shall not be subject to
-revocation, rescission, cancellation, termination, or any other legal or
-equitable action to disrupt the quiet enjoyment of the Work by the public
-as contemplated by Affirmer's express Statement of Purpose.
-
-3. Public License Fallback. Should any part of the Waiver for any reason
-be judged legally invalid or ineffective under applicable law, then the
-Waiver shall be preserved to the maximum extent permitted taking into
-account Affirmer's express Statement of Purpose. In addition, to the
-extent the Waiver is so judged Affirmer hereby grants to each affected
-person a royalty-free, non transferable, non sublicensable, non exclusive,
-irrevocable and unconditional license to exercise Affirmer's Copyright and
-Related Rights in the Work (i) in all territories worldwide, (ii) for the
-maximum duration provided by applicable law or treaty (including future
-time extensions), (iii) in any current or future medium and for any number
-of copies, and (iv) for any purpose whatsoever, including without
-limitation commercial, advertising or promotional purposes (the
-"License"). The License shall be deemed effective as of the date CC0 was
-applied by Affirmer to the Work. Should any part of the License for any
-reason be judged legally invalid or ineffective under applicable law, such
-partial invalidity or ineffectiveness shall not invalidate the remainder
-of the License, and in such case Affirmer hereby affirms that he or she
-will not (i) exercise any of his or her remaining Copyright and Related
-Rights in the Work or (ii) assert any associated claims and causes of
-action with respect to the Work, in either case contrary to Affirmer's
-express Statement of Purpose.
-
-4. Limitations and Disclaimers.
-
- a. No trademark or patent rights held by Affirmer are waived, abandoned,
-    surrendered, licensed or otherwise affected by this document.
- b. Affirmer offers the Work as-is and makes no representations or
-    warranties of any kind concerning the Work, express, implied,
-    statutory or otherwise, including without limitation warranties of
-    title, merchantability, fitness for a particular purpose, non
-    infringement, or the absence of latent or other defects, accuracy, or
-    the present or absence of errors, whether or not discoverable, all to
-    the greatest extent permissible under applicable law.
- c. Affirmer disclaims responsibility for clearing rights of other persons
-    that may apply to the Work or any use thereof, including without
-    limitation any person's Copyright and Related Rights in the Work.
-    Further, Affirmer disclaims responsibility for obtaining any necessary
-    consents, permissions or other rights required for any use of the
-    Work.
- d. Affirmer understands and acknowledges that Creative Commons is not a
-    party to this document and has no duty or obligation with respect to
-    this CC0 or use of the Work.
+Copyright © 2025 DFINITY Foundation
 
+This project includes derivative work from the upstream rust-bitcoin
+project, originally licensed under Creative Commons Zero v1.0 Universal
+(SPDX: CC0-1.0).
+
+All original code introduced in this repository is licensed under Apache
+License, Version 2.0 (SPDX: Apache-2.0) (the "License"); you may not use
+these files except in compliance with the License. You may obtain a copy
+of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0.
+
+The Apache-2.0 license is also copied below:
+
+                              Apache License
+                        Version 2.0, January 2004
+                     http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
\ No newline at end of file
diff --git a/README.md b/README.md
index e30924cb8..664950da2 100644
--- a/README.md
+++ b/README.md
@@ -216,5 +216,8 @@ Release notes are done per crate, see:
 
 ## Licensing
 
-The code in this project is licensed under the [Creative Commons CC0 1.0 Universal license](LICENSE).
+This project is a fork of [rust-bitcoin](https://github.com/rust-bitcoin/rust-bitcoin/tree/master), originally licensed under CC0 v1.0 Universal.
+
+This fork is licensed under the Apache License, Version 2.0, except where otherwise noted.
+
 We use the [SPDX license list](https://spdx.org/licenses/) and [SPDX IDs](https://spdx.dev/ids/).
diff --git a/bitcoin/src/blockdata/block.rs b/bitcoin/src/blockdata/block.rs
index 1bc234e50..e90401700 100644
--- a/bitcoin/src/blockdata/block.rs
+++ b/bitcoin/src/blockdata/block.rs
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: CC0-1.0
+// SPDX-License-Identifier: CC0-1.0 OR Apache-2.0
 
 //! Bitcoin blocks.
 //!
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index 55f682c9c..b1aa18e2e 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -1,3 +1,5 @@
+// SPDX-License-Identifier: Apache-2.0
+
 //! Dogecoin module.
 //!
 //! This module provides support for de/serialization, parsing and execution on data structures and

From afd98dca4378dda086108be1243800ef76c080bc Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Wed, 11 Jun 2025 09:27:58 +0200
Subject: [PATCH 39/53] feat(dogecoin): add dogecoin consensus and genesis
 parameters (#3)

[XC-383](https://dfinity.atlassian.net/browse/XC-383?atlOrigin=eyJpIjoiZGIzYzllMDQ4M2U0NDc2MjllMWJmYzFmOTYwYmYwZWMiLCJwIjoiaiJ9):
This PR adds 1) Dogecoin consensus parameters used in block validation
and 2) genesis transaction/block parameters which will be used for
testing purposes.

[XC-383]:
https://dfinity.atlassian.net/browse/XC-383?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
---
 bitcoin/src/blockdata/script/builder.rs |   2 +-
 bitcoin/src/dogecoin/constants.rs       | 204 ++++++++++++++++++++++++
 bitcoin/src/dogecoin/mod.rs             |  46 ++++++
 bitcoin/src/dogecoin/params.rs          | 124 ++++++++++++++
 bitcoin/src/pow.rs                      |  18 ++-
 5 files changed, 392 insertions(+), 2 deletions(-)
 create mode 100644 bitcoin/src/dogecoin/constants.rs
 create mode 100644 bitcoin/src/dogecoin/params.rs

diff --git a/bitcoin/src/blockdata/script/builder.rs b/bitcoin/src/blockdata/script/builder.rs
index 8d0381529..bc166a3a8 100644
--- a/bitcoin/src/blockdata/script/builder.rs
+++ b/bitcoin/src/blockdata/script/builder.rs
@@ -50,7 +50,7 @@ impl Builder {
     /// Adds instructions to push an integer onto the stack without optimization.
     ///
     /// This uses the explicit encoding regardless of the availability of dedicated opcodes.
-    pub(in crate::blockdata) fn push_int_non_minimal(self, data: i64) -> Builder {
+    pub fn push_int_non_minimal(self, data: i64) -> Builder {
         let mut buf = [0u8; 8];
         let len = write_scriptint(&mut buf, data);
         self.push_slice(&<&PushBytes>::from(&buf)[..len])
diff --git a/bitcoin/src/dogecoin/constants.rs b/bitcoin/src/dogecoin/constants.rs
new file mode 100644
index 000000000..a9a1e8c1a
--- /dev/null
+++ b/bitcoin/src/dogecoin/constants.rs
@@ -0,0 +1,204 @@
+// SPDX-License-Identifier: Apache-2.0
+
+//! Blockdata constants.
+//!
+//! This module provides various constants relating to the blockchain and
+//! consensus code. In particular, it defines the genesis block and its
+//! single transaction.
+//!
+
+use hashes::{sha256d, Hash};
+use units::Amount;
+
+use crate::dogecoin::params::Params;
+use crate::dogecoin::{Block, Network};
+use crate::opcodes::all::OP_CHECKSIG;
+use crate::{
+    absolute, block, script, transaction, CompactTarget, OutPoint, Sequence, Transaction, TxIn,
+    TxMerkleNode, TxOut, Witness,
+};
+
+// This is the 65 byte (uncompressed) pubkey used as the one-and-only output of the genesis transaction.
+//
+// ref: https://github.com/dogecoin/dogecoin/blob/7237da74b8c356568644cbe4fba19d994704355b/src/chainparams.cpp#L55
+// Note output script includes a leading 0x41 and trailing 0xac (added below using the `script::Builder`).
+#[rustfmt::skip]
+const GENESIS_OUTPUT_PK: [u8; 65] = [
+    0x04,
+    0x01, 0x84, 0x71, 0x0f, 0xa6, 0x89, 0xad, 0x50,
+    0x23, 0x69, 0x0c, 0x80, 0xf3, 0xa4, 0x9c, 0x8f,
+    0x13, 0xf8, 0xd4, 0x5b, 0x8c, 0x85, 0x7f, 0xbc,
+    0xbc, 0x8b, 0xc4, 0xa8, 0xe4, 0xd3, 0xeb, 0x4b,
+    0x10, 0xf4, 0xd4, 0x60, 0x4f, 0xa0, 0x8d, 0xce,
+    0x60, 0x1a, 0xaf, 0x0f, 0x47, 0x02, 0x16, 0xfe,
+    0x1b, 0x51, 0x85, 0x0b, 0x4a, 0xcf, 0x21, 0xb1,
+    0x79, 0xc4, 0x50, 0x70, 0xac, 0x7b, 0x03, 0xa9
+];
+
+/// Constructs and returns the coinbase (and only) transaction of the Dogecoin genesis block.
+pub fn dogecoin_genesis_tx() -> Transaction {
+    // Base
+    let mut ret = Transaction {
+        version: transaction::Version::ONE,
+        lock_time: absolute::LockTime::ZERO,
+        input: vec![],
+        output: vec![],
+    };
+
+    let (in_script, out_script) = (
+        script::Builder::new()
+            .push_int(486604799)
+            .push_int_non_minimal(4)
+            .push_slice(b"Nintondo")
+            .into_script(),
+        script::Builder::new().push_slice(GENESIS_OUTPUT_PK).push_opcode(OP_CHECKSIG).into_script(),
+    );
+
+    ret.input.push(TxIn {
+        previous_output: OutPoint::null(),
+        script_sig: in_script,
+        sequence: Sequence::MAX,
+        witness: Witness::default(),
+    });
+    ret.output.push(TxOut { value: Amount::from_sat(88 * 100_000_000), script_pubkey: out_script });
+
+    // end
+    ret
+}
+
+/// Constructs and returns the genesis block.
+#[allow(dead_code)]
+pub fn genesis_block(params: impl AsRef<Params>) -> Block {
+    let params = params.as_ref();
+    let txdata = vec![dogecoin_genesis_tx()];
+    let hash: sha256d::Hash = txdata[0].compute_txid().into();
+    let merkle_root: TxMerkleNode = hash.into();
+
+    match params.dogecoin_params.network {
+        Network::Dogecoin => Block {
+            header: block::Header {
+                version: block::Version::ONE,
+                prev_blockhash: Hash::all_zeros(),
+                merkle_root,
+                time: 1386325540,
+                bits: CompactTarget::from_consensus(0x1e0ffff0),
+                nonce: 99943,
+            },
+            auxpow: None,
+            txdata,
+        },
+        Network::Testnet => Block {
+            header: block::Header {
+                version: block::Version::ONE,
+                prev_blockhash: Hash::all_zeros(),
+                merkle_root,
+                time: 1391503289,
+                bits: CompactTarget::from_consensus(0x1e0ffff0),
+                nonce: 997879,
+            },
+            auxpow: None,
+            txdata,
+        },
+        Network::Regtest => Block {
+            header: block::Header {
+                version: block::Version::ONE,
+                prev_blockhash: Hash::all_zeros(),
+                merkle_root,
+                time: 1296688602,
+                bits: CompactTarget::from_consensus(0x207fffff),
+                nonce: 2,
+            },
+            auxpow: None,
+            txdata,
+        },
+    }
+}
+
+#[cfg(test)]
+mod test {
+    use core::str::FromStr;
+
+    use hex::test_hex_unwrap as hex;
+
+    use super::*;
+    use crate::consensus::encode::serialize;
+
+    #[test]
+    fn genesis_first_transaction() {
+        let gen = dogecoin_genesis_tx();
+
+        assert_eq!(gen.version, transaction::Version::ONE);
+        assert_eq!(gen.input.len(), 1);
+        assert_eq!(gen.input[0].previous_output.txid, Hash::all_zeros());
+        assert_eq!(gen.input[0].previous_output.vout, 0xFFFFFFFF);
+        assert_eq!(serialize(&gen.input[0].script_sig), hex!("1004ffff001d0104084e696e746f6e646f"));
+
+        assert_eq!(gen.input[0].sequence, Sequence::MAX);
+        assert_eq!(gen.output.len(), 1);
+        assert_eq!(serialize(&gen.output[0].script_pubkey),
+                   hex!("4341040184710fa689ad5023690c80f3a49c8f13f8d45b8c857fbcbc8bc4a8e4d3eb4b10f4d4604fa08dce601aaf0f470216fe1b51850b4acf21b179c45070ac7b03a9ac"));
+        assert_eq!(gen.output[0].value, Amount::from_str("88 BTC").unwrap());
+        assert_eq!(gen.lock_time, absolute::LockTime::ZERO);
+
+        assert_eq!(
+            gen.compute_wtxid().to_string(),
+            "5b2a3f53f605d62c53e62932dac6925e3d74afa5a4b459745c36d42d0ed26a69"
+        );
+    }
+
+    #[test]
+    fn genesis_full_block() {
+        let gen = genesis_block(&Params::DOGECOIN);
+
+        assert_eq!(gen.header.version, block::Version::ONE);
+        assert_eq!(gen.header.prev_blockhash, Hash::all_zeros());
+        assert_eq!(
+            gen.header.merkle_root.to_string(),
+            "5b2a3f53f605d62c53e62932dac6925e3d74afa5a4b459745c36d42d0ed26a69"
+        );
+
+        assert_eq!(gen.header.time, 1386325540);
+        assert_eq!(gen.header.bits, CompactTarget::from_consensus(0x1e0ffff0));
+        assert_eq!(gen.header.nonce, 99943);
+        assert_eq!(
+            gen.header.block_hash().to_string(),
+            "1a91e3dace36e2be3bf030a65679fe821aa1d6ef92e7c9902eb318182c355691"
+        );
+    }
+
+    #[test]
+    fn testnet_genesis_full_block() {
+        let gen = genesis_block(&Params::TESTNET);
+        assert_eq!(gen.header.version, block::Version::ONE);
+        assert_eq!(gen.header.prev_blockhash, Hash::all_zeros());
+        assert_eq!(
+            gen.header.merkle_root.to_string(),
+            "5b2a3f53f605d62c53e62932dac6925e3d74afa5a4b459745c36d42d0ed26a69"
+        );
+        assert_eq!(gen.header.time, 1391503289);
+        assert_eq!(gen.header.bits, CompactTarget::from_consensus(0x1e0ffff0));
+        assert_eq!(gen.header.nonce, 997879);
+        assert_eq!(
+            gen.header.block_hash().to_string(),
+            "bb0a78264637406b6360aad926284d544d7049f45189db5664f3c4d07350559e"
+        );
+    }
+
+    #[test]
+    fn regtest_genesis_full_block() {
+        let gen = genesis_block(&Params::REGTEST);
+        assert_eq!(gen.header.version, block::Version::ONE);
+        assert_eq!(gen.header.prev_blockhash, Hash::all_zeros());
+        assert_eq!(
+            gen.header.merkle_root.to_string(),
+            "5b2a3f53f605d62c53e62932dac6925e3d74afa5a4b459745c36d42d0ed26a69"
+        );
+        assert_eq!(gen.header.time, 1296688602);
+        assert_eq!(gen.header.bits, CompactTarget::from_consensus(0x207fffff));
+        assert_eq!(gen.header.nonce, 2);
+        assert_eq!(
+            gen.header.block_hash().to_string(),
+            "3d2160a3b5dc4a9d62e7e66a295f70313ac808440ef7400d6c0772171ce973a5"
+        );
+    }
+}
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index b1aa18e2e..b8114c502 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -5,8 +5,13 @@
 //! This module provides support for de/serialization, parsing and execution on data structures and
 //! network messages related to Dogecoin.
 
+pub mod constants;
+pub mod params;
+
 use crate::block::{Header, TxMerkleNode};
 use crate::consensus::{encode, Decodable, Encodable};
+use crate::params::Params as BitcoinParams;
+use crate::dogecoin::params::Params;
 use crate::internal_macros::impl_consensus_encoding;
 use crate::io::{Read, Write};
 use crate::prelude::*;
@@ -116,6 +121,38 @@ impl Encodable for Block {
     }
 }
 
+/// The cryptocurrency network to act on.
+#[derive(Copy, PartialEq, Eq, PartialOrd, Ord, Clone, Hash, Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
+#[cfg_attr(feature = "serde", serde(crate = "actual_serde"))]
+#[cfg_attr(feature = "serde", serde(rename_all = "lowercase"))]
+#[non_exhaustive]
+pub enum Network {
+    /// Mainnet Dogecoin.
+    Dogecoin,
+    /// Dogecoin's testnet network.
+    Testnet,
+    /// Dogecoin's regtest network.
+    Regtest,
+}
+
+impl Network {
+    /// Returns the associated network parameters.
+    pub const fn params(self) -> &'static Params {
+        match self {
+            Network::Dogecoin => &Params::DOGECOIN,
+            Network::Testnet => &Params::TESTNET,
+            Network::Regtest => &Params::REGTEST,
+        }
+    }
+}
+
+impl AsRef<BitcoinParams> for Network {
+    fn as_ref(&self) -> &BitcoinParams {
+        &Self::params(*self).bitcoin_params
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use hex::test_hex_unwrap as hex;
@@ -237,4 +274,13 @@ mod tests {
             assert_eq!(serialize(&header.block_hash_with_scrypt()), test.output);
         }
     }
+    
+    #[test]
+    fn max_target_from_compact() {
+        // The highest possible target in Dogecoin is defined as 0x1e0fffff
+        let bits = 0x1e0fffff_u32;
+        let want = Target::MAX_ATTAINABLE_MAINNET_DOGE;
+        let got = Target::from_compact(CompactTarget::from_consensus(bits));
+        assert_eq!(got, want)
+    }
 }
diff --git a/bitcoin/src/dogecoin/params.rs b/bitcoin/src/dogecoin/params.rs
new file mode 100644
index 000000000..78e9ab044
--- /dev/null
+++ b/bitcoin/src/dogecoin/params.rs
@@ -0,0 +1,124 @@
+// SPDX-License-Identifier: Apache-2.0
+
+//! Dogecoin consensus parameters.
+//!
+//! This module provides a predefined set of parameters for different Dogecoin
+//! chains (such as mainnet, testnet, regtest).
+//!
+
+use crate::dogecoin::Network;
+use crate::network::Network as BitcoinNetwork;
+use crate::params::Params as BitcoinParams;
+use crate::Target;
+
+/// Parameters that influence chain consensus.
+#[derive(Debug, Clone)]
+pub struct Params {
+    /// Parameters inherited from Bitcoin, reused for Dogecoin consensus.
+    pub bitcoin_params: BitcoinParams,
+    /// Parameters that are not inherited from Bitcoin.
+    pub dogecoin_params: DogecoinParams,
+}
+
+/// Dogecoin-specific consensus parameters.
+#[non_exhaustive]
+#[derive(Debug, Clone)]
+pub struct DogecoinParams {
+    /// Network for which parameters are valid.
+    pub network: Network,
+}
+
+/// The mainnet parameters.
+///
+/// Use this for a static reference e.g., `&params::MAINNET`.
+///
+/// For more on static vs const see The Rust Reference [using-statics-or-consts] section.
+///
+/// [using-statics-or-consts]: <https://doc.rust-lang.org/reference/items/static-items.html#using-statics-or-consts>
+pub static MAINNET: Params = Params::MAINNET;
+/// The dogecoin testnet parameters.
+pub static TESTNET: Params = Params::TESTNET;
+/// The dogecoin regtest parameters.
+pub static REGTEST: Params = Params::REGTEST;
+
+impl Params {
+    /// The mainnet parameters (alias for `Params::MAINNET`).
+    pub const DOGECOIN: Params = Params::MAINNET;
+
+    /// The mainnet parameters.
+    pub const MAINNET: Params = Params {
+        bitcoin_params: BitcoinParams {
+            network: BitcoinNetwork::Bitcoin,
+            bip16_time: 1333238400,                 // Apr 1 2012
+            bip34_height: 1034383, // 80d1364201e5df97e696c03bdd24dc885e8617b9de51e453c10a4f629b1e797a
+            bip65_height: 3464751, // 34cd2cbba4ba366f47e5aa0db5f02c19eba2adf679ceb6653ac003bdc9a0ef1f
+            bip66_height: 1034383, // 80d1364201e5df97e696c03bdd24dc885e8617b9de51e453c10a4f629b1e797a
+            rule_change_activation_threshold: 9576, // 95% of 10,080
+            miner_confirmation_window: 10080, // 60 * 24 * 7 = 10,080 blocks, or one week
+            pow_limit: Target::MAX_ATTAINABLE_MAINNET_DOGE,
+            max_attainable_target: Target::MAX_ATTAINABLE_MAINNET_DOGE,
+            pow_target_spacing: 60,           // 1 minute
+            pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
+            allow_min_difficulty_blocks: false,
+            no_pow_retargeting: false,
+        },
+        dogecoin_params: DogecoinParams { network: Network::Dogecoin },
+    };
+
+    /// The Dogecoin testnet parameters.
+    pub const TESTNET: Params = Params {
+        bitcoin_params: BitcoinParams {
+            network: BitcoinNetwork::Testnet,
+            bip16_time: 1333238400,                 // Apr 1 2012
+            bip34_height: 708658, // 21b8b97dcdb94caa67c7f8f6dbf22e61e0cfe0e46e1fff3528b22864659e9b38
+            bip65_height: 1854705, // 955bd496d23790aba1ecfacb722b089a6ae7ddabaedf7d8fb0878f48308a71f9
+            bip66_height: 708658, // 21b8b97dcdb94caa67c7f8f6dbf22e61e0cfe0e46e1fff3528b22864659e9b38
+            rule_change_activation_threshold: 2880, // 2 days (note this is significantly lower than Bitcoin standard)
+            miner_confirmation_window: 10080,       // 60 * 24 * 7 = 10,080 blocks, or one week
+            pow_limit: Target::MAX_ATTAINABLE_TESTNET_DOGE,
+            max_attainable_target: Target::MAX_ATTAINABLE_TESTNET_DOGE,
+            pow_target_spacing: 60,           // 1 minute
+            pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
+            allow_min_difficulty_blocks: true,
+            no_pow_retargeting: false,
+        },
+        dogecoin_params: DogecoinParams { network: Network::Testnet },
+    };
+
+    /// The Dogecoin regtest parameters.
+    pub const REGTEST: Params = Params {
+        bitcoin_params: BitcoinParams {
+            network: BitcoinNetwork::Regtest,
+            bip16_time: 1333238400,  // Apr 1 2012
+            bip34_height: 100000000, // not activated on regtest
+            bip65_height: 1351,
+            bip66_height: 1251,                    // used only in rpc tests
+            rule_change_activation_threshold: 540, // 75%
+            miner_confirmation_window: 720,
+            pow_limit: Target::MAX_ATTAINABLE_REGTEST_DOGE,
+            max_attainable_target: Target::MAX_ATTAINABLE_REGTEST_DOGE,
+            pow_target_spacing: 1,            // regtest: 1 second blocks
+            pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
+            allow_min_difficulty_blocks: true,
+            no_pow_retargeting: true,
+        },
+        dogecoin_params: DogecoinParams { network: Network::Regtest },
+    };
+
+    /// Creates parameters set for the given network.
+    pub const fn new(network: Network) -> Self {
+        match network {
+            Network::Dogecoin => Params::MAINNET,
+            Network::Testnet => Params::TESTNET,
+            Network::Regtest => Params::REGTEST,
+        }
+    }
+}
+
+impl AsRef<BitcoinParams> for Params {
+    fn as_ref(&self) -> &BitcoinParams { &self.bitcoin_params }
+}
+
+impl AsRef<Params> for Params {
+    fn as_ref(&self) -> &Params { self }
+}
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index d4cb696fc..aa2db499c 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: CC0-1.0
+// SPDX-License-Identifier: CC0-1.0 OR Apache-2.0
 
 //! Proof-of-work related integer types.
 //!
@@ -166,6 +166,22 @@ impl Target {
     // https://github.com/bitcoin/bitcoin/blob/8105bce5b384c72cf08b25b7c5343622754e7337/src/kernel/chainparams.cpp#L348
     pub const MAX_ATTAINABLE_SIGNET: Self = Target(U256(0x0377_ae00 << 80, 0));
 
+    /// The maximum **attainable** target value on Dogecoin mainnet.
+    ///
+    /// Not all target values are attainable because consensus code uses the compact format to
+    /// represent targets (see [`CompactTarget`]).
+    pub const MAX_ATTAINABLE_MAINNET_DOGE: Self = Target(U256(0xFFFF_F000u128 << (204 - 128), 0));
+
+    /// The proof of work limit on Dogecoin testnet.
+    // Taken from Dogecoin Core but had lossy conversion to/from compact form.
+    // https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/chainparams.cpp#L248
+    pub const MAX_ATTAINABLE_TESTNET_DOGE: Self = Target(U256(0xFFFF_F000u128 << (204 - 128), 0));
+
+    /// The proof of work limit on Dogecoin regtest.
+    // Taken from Dogecoin Core but had lossy conversion to/from compact form.
+    // https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/chainparams.cpp#L392
+    pub const MAX_ATTAINABLE_REGTEST_DOGE: Self = Target(U256(0x7FFF_FF00u128 << 96, 0));
+
     /// Computes the [`Target`] value from a compact representation.
     ///
     /// ref: <https://developer.bitcoin.org/reference/block_chain.html#target-nbits>

From 0b182fba26dade92aa3d64e19e85d88a54ad66dd Mon Sep 17 00:00:00 2001
From: Paul Liu <paul@dfinity.org>
Date: Wed, 11 Jun 2025 17:22:30 +0800
Subject: [PATCH 40/53] feat: Add more methods to the dogecoin network type
 (#7)

---
 bitcoin/src/dogecoin/constants.rs |  4 ++-
 bitcoin/src/dogecoin/mod.rs       | 57 +++++++++++++++++++++++++++++++
 bitcoin/src/network.rs            |  2 +-
 3 files changed, 61 insertions(+), 2 deletions(-)

diff --git a/bitcoin/src/dogecoin/constants.rs b/bitcoin/src/dogecoin/constants.rs
index a9a1e8c1a..0897189dc 100644
--- a/bitcoin/src/dogecoin/constants.rs
+++ b/bitcoin/src/dogecoin/constants.rs
@@ -149,7 +149,7 @@ mod test {
     #[test]
     fn genesis_full_block() {
         let gen = genesis_block(&Params::DOGECOIN);
-
+        assert!(gen.check_merkle_root());
         assert_eq!(gen.header.version, block::Version::ONE);
         assert_eq!(gen.header.prev_blockhash, Hash::all_zeros());
         assert_eq!(
@@ -169,6 +169,7 @@ mod test {
     #[test]
     fn testnet_genesis_full_block() {
         let gen = genesis_block(&Params::TESTNET);
+        assert!(gen.check_merkle_root());
         assert_eq!(gen.header.version, block::Version::ONE);
         assert_eq!(gen.header.prev_blockhash, Hash::all_zeros());
         assert_eq!(
@@ -187,6 +188,7 @@ mod test {
     #[test]
     fn regtest_genesis_full_block() {
         let gen = genesis_block(&Params::REGTEST);
+        assert!(gen.check_merkle_root());
         assert_eq!(gen.header.version, block::Version::ONE);
         assert_eq!(gen.header.prev_blockhash, Hash::all_zeros());
         assert_eq!(
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index b8114c502..91f9982e5 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -14,8 +14,10 @@ use crate::params::Params as BitcoinParams;
 use crate::dogecoin::params::Params;
 use crate::internal_macros::impl_consensus_encoding;
 use crate::io::{Read, Write};
+use crate::p2p::Magic;
 use crate::prelude::*;
 use crate::{io, BlockHash, Transaction};
+use core::fmt;
 
 /// AuxPow version bit, see <https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23>
 pub const VERSION_AUXPOW: i32 = 1 << 8;
@@ -89,6 +91,23 @@ impl Block {
 
     /// Returns the block hash using the scrypt hash function.
     pub fn block_hash_with_scrypt(&self) -> BlockHash { self.header.block_hash_with_scrypt() }
+
+    /// Checks if merkle root of header matches merkle root of the transaction list.
+    pub fn check_merkle_root(&self) -> bool {
+        match self.compute_merkle_root() {
+            Some(merkle_root) => self.header.merkle_root == merkle_root,
+            None => false,
+        }
+    }
+
+    /// Compute merkle root of the transaction list in this block.
+    pub fn compute_merkle_root(&self) -> Option<TxMerkleNode> {
+        let hashes = self
+            .txdata
+            .iter()
+            .map(|obj| obj.compute_txid().to_raw_hash());
+        crate::merkle_tree::calculate_root(hashes).map(|h| h.into())
+    }
 }
 
 impl Decodable for Block {
@@ -145,6 +164,15 @@ impl Network {
             Network::Regtest => &Params::REGTEST,
         }
     }
+
+    /// Return the magic bytes for the given network.
+    pub fn magic(self) -> Magic {
+        match self {
+            Network::Dogecoin => Magic::from_bytes([0xC0, 0xC0, 0xC0, 0xC0]),
+            Network::Testnet => Magic::from_bytes([0xFC, 0xC1, 0xB7, 0xDC]),
+            Network::Regtest => Magic::from_bytes([0xFA, 0xBF, 0xB5, 0xDA]),
+        }
+    }
 }
 
 impl AsRef<BitcoinParams> for Network {
@@ -153,6 +181,35 @@ impl AsRef<BitcoinParams> for Network {
     }
 }
 
+impl AsRef<Params> for Network {
+    fn as_ref(&self) -> &Params {
+        self.params()
+    }
+}
+
+impl fmt::Display for Network {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        match self {
+            Network::Dogecoin => write!(f, "dogecoin"),
+            Network::Testnet => write!(f, "testnet"),
+            Network::Regtest => write!(f, "regtest"),
+        }
+    }
+}
+
+impl core::str::FromStr for Network {
+    type Err = crate::network::ParseNetworkError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        match s {
+            "dogecoin" => Ok(Network::Dogecoin),
+            "testnet" => Ok(Network::Testnet),
+            "regtest" => Ok(Network::Regtest),
+            _ => Err(crate::network::ParseNetworkError(s.to_owned())),
+        }
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use hex::test_hex_unwrap as hex;
diff --git a/bitcoin/src/network.rs b/bitcoin/src/network.rs
index 8df48b0be..3b60fd98d 100644
--- a/bitcoin/src/network.rs
+++ b/bitcoin/src/network.rs
@@ -256,7 +256,7 @@ pub mod as_core_arg {
 /// An error in parsing network string.
 #[derive(Debug, Clone, PartialEq, Eq)]
 #[non_exhaustive]
-pub struct ParseNetworkError(String);
+pub struct ParseNetworkError(pub(crate) String);
 
 impl fmt::Display for ParseNetworkError {
     fn fmt(&self, f: &mut fmt::Formatter) -> Result<(), fmt::Error> {

From 762f8af1401806a0104eb4d191a203d94d875312 Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Thu, 12 Jun 2025 14:04:20 +0200
Subject: [PATCH 41/53] feat(dogecoin): add difficulty adjustment algorithm for
 blocks 0-5,000 (#8)

This PR adds methods required for implementing Dogecoin's difficulty
adjustment algorithm (DAA). In particular it adds the method
`from_next_work_required_dogecoin()` which computes the target value for
the next difficulty adjustment period, based on the `timespan` between
start and end of period and the `last` target value.

Note: this PR only adds the required logic to compute targets in block
period 0-5,000 (see
https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/dogecoin.cpp#L41
for complete algorithm). A following PR will add the logic for further
periods and in particular for the Digishield algorithm used in later
periods.
---
 bitcoin/src/dogecoin/mod.rs | 129 +++++++++++++++++++++++++++++++++++-
 bitcoin/src/pow.rs          |  93 ++++++++++++++++++++++++++
 2 files changed, 219 insertions(+), 3 deletions(-)

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index 91f9982e5..aab03be93 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -217,11 +217,12 @@ mod tests {
     use super::*;
     use crate::block::{ValidationError, Version};
     use crate::consensus::encode::{deserialize, serialize};
-    use crate::{CompactTarget, Network, Target, Work};
+    use crate::{CompactTarget, Target, Work};
+    use crate::{Network as BitcoinNetwork};
+
 
     #[test]
     fn dogecoin_block_test() {
-        let params = crate::consensus::Params::new(Network::Bitcoin);
         // Mainnet Dogecoin block 5794c80b80d9c33e0737a5353cd52b1f097f61d8d2b9f471e1702345080e0002
         let some_block = hex!("01000000c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba3894b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a207d78bb52de8f001c00da8c3c0201000000010000000000000000000000000000000000000000000000000000000000000000ffffffff2602bc6d062f503253482f047178bb5208f8042975030000000d2f7374726174756d506f6f6c2f000000000100629b29c45500001976a91450e9fe87c705dcd4b7523b47e3314c2115f5d5df88ac0000000001000000015f48fabf4425324df2b5e58f4e9c771297f76f5fa37db7556f6fc1d22742da1f010000006a473044022062d29d2d26f7d826e7b72257486e294d284832743c7803a2901eb07e326b25a002207efc391b0f4e724c9d518075c0e056cc425540f845b0fd419ba8a9d49d69288301210297a2568525760a98454d84f5e5adba9fd0a41726a6fb774ddc407279e41e2061ffffffff0240bab598200000001976a91401348a2b83aeb6b1ba2a174a1a40b7c75fbeb12088ac0040be40250000001976a914025407d928ef333979d064ae233353d80e29d58c88ac00000000");
         let cutoff_block = hex!("01000000c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba3894b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a207d78bb52de8f001c00da8c3c0201000000010000000000000000000000000000000000000000000000000000000000000000ffffffff2602bc6d062f503253482f047178bb5208f8042975030000000d2f7374726174756d506f6f6c2f000000000100629b29c45500001976a91450e9fe87c705dcd4b7523b47e3314c2115f5d5df88ac0000000001000000015f48fabf4425324df2b5e58f4e9c771297f76f5fa37db7556f6fc1d22742da1f010000006a473044022062d29d2d26f7d826e7b72257486e294d284832743c7803a2901eb07e326b25a002207efc391b0f4e724c9d518075c0e056cc425540f845b0fd419ba8a9d49d69288301210297a2568525760a98454d84f5e5adba9fd0a41726a6fb774ddc407279e41e2061ffffffff0240bab598200000001976a91401348a2b83aeb6b1ba2a174a1a40b7c75fbeb12088ac0040be40250000001976a914025407d928ef333979d064ae233353d80e29d58c88ac");
@@ -250,7 +251,9 @@ mod tests {
             real_decode.header.validate_pow_with_scrypt(real_decode.header.target()).unwrap(),
             real_decode.block_hash_with_scrypt()
         );
-        assert_eq!(real_decode.header.difficulty(&params), 455);
+        // Bitcoin network is used because Dogecoin's difficulty calculation is based on Bitcoin's,
+        // which uses Bitcoin's `max_attainable_target` value
+        assert_eq!(real_decode.header.difficulty(BitcoinNetwork::Bitcoin), 455);
         assert_eq!(real_decode.header.difficulty_float(), 455.52430084170516);
 
         assert_eq!(serialize(&real_decode), some_block);
@@ -340,4 +343,124 @@ mod tests {
         let got = Target::from_compact(CompactTarget::from_consensus(bits));
         assert_eq!(got, want)
     }
+
+    #[test]
+    fn compact_target_from_upwards_difficulty_adjustment() {
+        let params = Params::new(Network::Dogecoin);
+        let starting_bits = CompactTarget::from_consensus(0x1e0ffff0); // Genesis compact target on Mainnet
+        let start_time: u64 = 1386325540; // Genesis block unix time
+        let end_time: u64 = 1386475638; // Block 239 unix time
+        let timespan = end_time - start_time; // Slower than expected (150,098 seconds diff)
+        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params);
+        let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
+        assert_eq!(adjustment, adjustment_bits);
+    }
+
+    #[test]
+    fn compact_target_from_downwards_difficulty_adjustment() {
+        let params = Params::new(Network::Dogecoin);
+        let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
+        let start_time: u64 = 1386475638; // Block 239 unix time
+        let end_time: u64 = 1386475840; // Block 479 unix time
+        let timespan = end_time - start_time; // Faster than expected (202 seconds diff)
+        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params);
+        let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
+        assert_eq!(adjustment, adjustment_bits);
+    }
+
+    #[test]
+    fn compact_target_from_downwards_difficulty_adjustment_using_headers() {
+        use crate::{block::Version, dogecoin::constants::genesis_block, TxMerkleNode};
+        use hashes::Hash;
+        let params = Params::new(Network::Dogecoin);
+        let epoch_start = genesis_block(&params).header;
+        // Block 239, the only information used are `bits` and `time`
+        let current = Header {
+            version: Version::ONE,
+            prev_blockhash: BlockHash::all_zeros(),
+            merkle_root: TxMerkleNode::all_zeros(),
+            time: 1386475638,
+            bits: epoch_start.bits,
+            nonce: epoch_start.nonce
+        };
+        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params);
+        let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
+        assert_eq!(adjustment, adjustment_bits);
+    }
+
+    #[test]
+    fn compact_target_from_upwards_difficulty_adjustment_using_headers() {
+        use crate::{block::Version, TxMerkleNode};
+        use hashes::Hash;
+        let params = Params::new(Network::Dogecoin);
+        let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 479 compact target
+        // Block 239, the only information used is `time`
+        let epoch_start = Header {
+            version: Version::ONE,
+            prev_blockhash: BlockHash::all_zeros(),
+            merkle_root: TxMerkleNode::all_zeros(),
+            time: 1386475638,
+            bits: starting_bits,
+            nonce: 0
+        };
+        // Block 479, the only information used are `bits` and `time`
+        let current = Header {
+            version: Version::ONE,
+            prev_blockhash: BlockHash::all_zeros(),
+            merkle_root: TxMerkleNode::all_zeros(),
+            time: 1386475840,
+            bits: starting_bits,
+            nonce: 0
+        };
+        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params);
+        let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
+        assert_eq!(adjustment, adjustment_bits);
+    }
+
+    #[test]
+    fn compact_target_from_maximum_upward_difficulty_adjustment() {
+        let params = Params::new(Network::Dogecoin);
+        let starting_bits = CompactTarget::from_consensus(21403001); // Arbitrary difficulty
+        let timespan = (0.06 * params.bitcoin_params.pow_target_timespan as f64) as u64; // > 16x Faster than expected
+        let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, params);
+        let want = Target::from_compact(starting_bits)
+            .min_transition_threshold_dogecoin(5000)
+            .to_compact_lossy();
+        assert_eq!(got, want);
+    }
+
+    #[test]
+    fn compact_target_from_minimum_downward_difficulty_adjustment() {
+        let params = Params::new(Network::Dogecoin);
+        let starting_bits = CompactTarget::from_consensus(21403001); // Arbitrary difficulty
+        let timespan =  5 * params.bitcoin_params.pow_target_timespan; // > 4x Slower than expected
+        let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params);
+        let want = Target::from_compact(starting_bits)
+            .max_transition_threshold(params)
+            .to_compact_lossy();
+        assert_eq!(got, want);
+    }
+
+    #[test]
+    fn compact_target_from_adjustment_is_max_target() {
+        let params = Params::new(Network::Dogecoin);
+        let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target (max target)
+        let timespan =  5 * params.bitcoin_params.pow_target_timespan; // > 4x Slower than expected
+        let got = CompactTarget::from_next_work_required(starting_bits, timespan, &params);
+        let want = params.bitcoin_params.max_attainable_target.to_compact_lossy();
+        assert_eq!(got, want);
+    }
+
+    #[test]
+    fn roundtrip_compact_target() {
+        let consensus = 0x1e0f_ffff;
+        let compact = CompactTarget::from_consensus(consensus);
+        let t = Target::from_compact(CompactTarget::from_consensus(consensus));
+        assert_eq!(t, Target::from(compact)); // From/Into sanity check.
+
+        let back = t.to_compact_lossy();
+        assert_eq!(back, compact); // From/Into sanity check.
+
+        assert_eq!(back.to_consensus(), consensus);
+    }
 }
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index aa2db499c..7cc1cd4f8 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -316,6 +316,27 @@ impl Target {
     /// In line with Bitcoin Core this function may return a target value of zero.
     pub fn min_transition_threshold(&self) -> Self { Self(self.0 >> 2) }
 
+    /// Computes the minimum valid [`Target`] threshold allowed for a block in which a difficulty
+    /// adjustment occurs.
+    ///
+    /// The difficulty can only decrease by a factor of 4, 8, or 16 max on each difficulty
+    /// adjustment period, depending on the height.
+    /// 
+    /// ref: <https://github.com/dogecoin/dogecoin/blob/2c513d0172e8bc86fe9a337693b26f2fdf68a013/src/dogecoin.cpp#L57-L66>
+    ///
+    /// # Returns
+    ///
+    /// In line with Dogecoin Core this function may return a target value of zero.
+    pub fn min_transition_threshold_dogecoin(&self, height: u32) -> Self {
+        if height > 10000 {
+            Self(self.0 >> 2)
+        } else if height > 5000 {
+            Self(self.0 >> 3)
+        } else {
+            Self(self.0 >> 4)
+        }
+    }
+
     /// Computes the maximum valid [`Target`] threshold allowed for a block in which a difficulty
     /// adjustment occurs.
     ///
@@ -429,6 +450,44 @@ impl CompactTarget {
         retarget.to_compact_lossy()
     }
 
+    /// Computes the [`CompactTarget`] from a difficulty adjustment in Dogecoin.
+    ///
+    /// ref: <https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/dogecoin.cpp>
+    ///
+    /// Given the previous Target, represented as a [`CompactTarget`], the difficulty is adjusted
+    /// by taking the timespan between them, and multipling the current [`CompactTarget`] by a factor
+    /// of the net timespan and expected timespan. The [`CompactTarget`] may not increase by more than
+    /// a factor of 4, adjust beyond the maximum threshold for the network, or decrease... TODO
+    ///
+    /// # Returns
+    ///
+    /// The expected [`CompactTarget`] recalculation.
+    pub fn from_next_work_required_dogecoin(
+        last: CompactTarget,
+        timespan: u64,
+        params: impl AsRef<Params>
+    ) -> CompactTarget {
+        let params = params.as_ref();
+        if params.no_pow_retargeting { 
+            return last;
+        }
+        // Comments relate to the `pow.cpp` file from Core.
+        // ref: <https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/dogecoin.cpp>
+        let min_timespan = params.pow_target_timespan >> 4; // Lines 64
+        let max_timespan = params.pow_target_timespan << 2; // Lines 65
+        let actual_timespan = timespan.clamp(min_timespan, max_timespan); // Lines 69-72 nModulatedTimespan
+        let prev_target: Target = last.into();
+        let maximum_retarget = prev_target.max_transition_threshold(params); // bnPowLimit
+        let retarget = prev_target.0; // bnNew
+        let retarget = retarget.mul(actual_timespan.into());
+        let retarget = retarget.div(params.pow_target_timespan.into());
+        let retarget = Target(retarget);
+        if retarget.ge(&maximum_retarget) {
+            return maximum_retarget.to_compact_lossy();
+        }
+        retarget.to_compact_lossy()
+    }
+
     /// Computes the [`CompactTarget`] from a difficulty adjustment,
     /// assuming these are the relevant block headers.
     ///
@@ -457,6 +516,40 @@ impl CompactTarget {
         CompactTarget::from_next_work_required(bits, timespan.into(), params)
     }
 
+    /// Computes the [`CompactTarget`] from a difficulty adjustment,
+    /// assuming these are the relevant block headers, in the Dogecoin network.
+    ///
+    /// Given two headers, representing the start and end of a difficulty adjustment epoch,
+    /// compute the [`CompactTarget`] based on the net time between them and the current
+    /// [`CompactTarget`].
+    ///
+    /// # Note
+    ///
+    /// See [`CompactTarget::from_next_work_required_dogecoin`].
+    /// 
+    /// Unlike Bitcoin, Dogecoin uses overlapping intervals (see Time Wrap Attack bug fix
+    /// introduced by Litecoin).
+    ///
+    /// For example, to successfully compute the first difficulty adjustments on the Dogecoin network,
+    /// one would pass the following headers:
+    ///     - `current`: Block 239, `last_epoch_boundary`: Block 0
+    ///     - `current`: Block 479, `last_epoch_boundary`: Block 239
+    ///     - `current`: Block 719, `last_epoch_boundary`: Block 479
+    ///     - `current`: Block 959, `last_epoch_boundary`: Block 719
+    ///
+    /// # Returns
+    ///
+    /// The expected [`CompactTarget`] recalculation.
+    pub fn from_header_difficulty_adjustment_dogecoin(
+        last_epoch_boundary: Header,
+        current: Header,
+        params: impl AsRef<Params>,
+    ) -> CompactTarget {
+        let timespan = current.time - last_epoch_boundary.time;
+        let bits = current.bits;
+        CompactTarget::from_next_work_required_dogecoin(bits, timespan.into(), params)
+    }
+
     /// Creates a [`CompactTarget`] from a consensus encoded `u32`.
     pub fn from_consensus(bits: u32) -> Self { Self(bits) }
 

From ee2493a8af081474de21c318de59fdbfc40e362a Mon Sep 17 00:00:00 2001
From: Paul Liu <paul@dfinity.org>
Date: Thu, 12 Jun 2025 23:33:15 +0800
Subject: [PATCH 42/53] feat: Dogecoin specific address type (#5)

Since dogecoin uses different prefixes and only supports P2PKH and P2SH
address types, this PR introduces separate implementations for Address
related types, which are adapted from the bitcoin ones.
---
 bitcoin/src/dogecoin/address/error.rs | 112 ++++
 bitcoin/src/dogecoin/address/mod.rs   | 776 ++++++++++++++++++++++++++
 bitcoin/src/dogecoin/constants.rs     |   7 +
 bitcoin/src/dogecoin/mod.rs           |   5 +-
 4 files changed, 899 insertions(+), 1 deletion(-)
 create mode 100644 bitcoin/src/dogecoin/address/error.rs
 create mode 100644 bitcoin/src/dogecoin/address/mod.rs

diff --git a/bitcoin/src/dogecoin/address/error.rs b/bitcoin/src/dogecoin/address/error.rs
new file mode 100644
index 000000000..521b19e7f
--- /dev/null
+++ b/bitcoin/src/dogecoin/address/error.rs
@@ -0,0 +1,112 @@
+// SPDX-License-Identifier: Apache-2.0
+
+//! Error code for the address module.
+
+use core::fmt;
+
+use internals::write_err;
+
+use crate::dogecoin::address::{Address, NetworkUnchecked};
+use crate::dogecoin::Network;
+
+pub use crate::address::error::{
+    FromScriptError, InvalidBase58PayloadLengthError, InvalidLegacyPrefixError,
+    LegacyAddressTooLongError, P2shError,
+};
+
+/// Address parsing error.
+#[derive(Debug, Clone, PartialEq, Eq)]
+#[non_exhaustive]
+pub enum ParseError {
+    /// Base58 error.
+    Base58(base58::Error),
+    /// Legacy address is too long.
+    LegacyAddressTooLong(LegacyAddressTooLongError),
+    /// Invalid base58 payload data length for legacy address.
+    InvalidBase58PayloadLength(InvalidBase58PayloadLengthError),
+    /// Invalid legacy address prefix in base58 data payload.
+    InvalidLegacyPrefix(InvalidLegacyPrefixError),
+    /// Address's network differs from required one.
+    NetworkValidation(NetworkValidationError),
+}
+
+internals::impl_from_infallible!(ParseError);
+
+impl fmt::Display for ParseError {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        use ParseError::*;
+
+        match *self {
+            Base58(ref e) => write_err!(f, "base58 error"; e),
+            LegacyAddressTooLong(ref e) => write_err!(f, "legacy address base58 string"; e),
+            InvalidBase58PayloadLength(ref e) => write_err!(f, "legacy address base58 data"; e),
+            InvalidLegacyPrefix(ref e) => write_err!(f, "legacy address base58 prefix"; e),
+            NetworkValidation(ref e) => write_err!(f, "validation error"; e),
+        }
+    }
+}
+
+#[cfg(feature = "std")]
+impl std::error::Error for ParseError {
+    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
+        use ParseError::*;
+
+        match *self {
+            Base58(ref e) => Some(e),
+            LegacyAddressTooLong(ref e) => Some(e),
+            InvalidBase58PayloadLength(ref e) => Some(e),
+            InvalidLegacyPrefix(ref e) => Some(e),
+            NetworkValidation(ref e) => Some(e),
+        }
+    }
+}
+
+impl From<base58::Error> for ParseError {
+    fn from(e: base58::Error) -> Self {
+        Self::Base58(e)
+    }
+}
+
+impl From<LegacyAddressTooLongError> for ParseError {
+    fn from(e: LegacyAddressTooLongError) -> Self {
+        Self::LegacyAddressTooLong(e)
+    }
+}
+
+impl From<InvalidBase58PayloadLengthError> for ParseError {
+    fn from(e: InvalidBase58PayloadLengthError) -> Self {
+        Self::InvalidBase58PayloadLength(e)
+    }
+}
+
+impl From<InvalidLegacyPrefixError> for ParseError {
+    fn from(e: InvalidLegacyPrefixError) -> Self {
+        Self::InvalidLegacyPrefix(e)
+    }
+}
+
+impl From<NetworkValidationError> for ParseError {
+    fn from(e: NetworkValidationError) -> Self {
+        Self::NetworkValidation(e)
+    }
+}
+
+/// Address's network differs from required one.
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct NetworkValidationError {
+    /// Network that was required.
+    pub(crate) required: Network,
+    /// The address itself.
+    pub(crate) address: Address<NetworkUnchecked>,
+}
+
+impl fmt::Display for NetworkValidationError {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        write!(f, "address ")?;
+        fmt::Display::fmt(&self.address.0, f)?;
+        write!(f, " is not valid on {}", self.required)
+    }
+}
+
+#[cfg(feature = "std")]
+impl std::error::Error for NetworkValidationError {}
diff --git a/bitcoin/src/dogecoin/address/mod.rs b/bitcoin/src/dogecoin/address/mod.rs
new file mode 100644
index 000000000..f23a9a991
--- /dev/null
+++ b/bitcoin/src/dogecoin/address/mod.rs
@@ -0,0 +1,776 @@
+// SPDX-License-Identifier: Apache-2.0
+
+//! Dogecoin addresses.
+//!
+//! Support for ordinary base58 Dogecoin addresses and private keys.
+//!
+//! # Example: creating a new address from a randomly-generated key pair
+//!
+//! ```rust
+//! # #[cfg(feature = "rand-std")] {
+//! use bitcoin::dogecoin::{Address, Network};
+//! use bitcoin::{PublicKey, secp256k1::{rand, Secp256k1}};
+//!
+//! // Generate random key pair.
+//! let s = Secp256k1::new();
+//! let public_key = PublicKey::new(s.generate_keypair(&mut rand::thread_rng()).1);
+//!
+//! // Generate pay-to-pubkey-hash address.
+//! let address = Address::p2pkh(&public_key, Network::Dogecoin);
+//! # }
+//! ```
+//!
+//! # Note: creating a new address requires the rand-std feature flag
+//!
+//! ```toml
+//! bitcoin = { version = "...", features = ["rand-std"] }
+//! ```
+
+pub mod error;
+
+use core::fmt;
+use core::marker::PhantomData;
+use core::str::FromStr;
+
+use hashes::Hash;
+use secp256k1::XOnlyPublicKey;
+
+use crate::blockdata::constants::MAX_SCRIPT_ELEMENT_SIZE;
+use crate::blockdata::script::{self, Script, ScriptBuf, ScriptHash};
+use crate::crypto::key::{PubkeyHash, PublicKey};
+use crate::dogecoin::constants::{
+    PUBKEY_ADDRESS_PREFIX_MAINNET, PUBKEY_ADDRESS_PREFIX_REGTEST, PUBKEY_ADDRESS_PREFIX_TESTNET,
+    SCRIPT_ADDRESS_PREFIX_MAINNET, SCRIPT_ADDRESS_PREFIX_REGTEST, SCRIPT_ADDRESS_PREFIX_TESTNET,
+};
+use crate::dogecoin::Network;
+
+#[rustfmt::skip]                // Keep public re-exports separate.
+#[doc(inline)]
+pub use self::{
+    error::{
+        FromScriptError, InvalidBase58PayloadLengthError, InvalidLegacyPrefixError, LegacyAddressTooLongError,
+        NetworkValidationError, ParseError, P2shError,
+    },
+};
+
+// Re-export shared types from bitcoin::address.
+pub use crate::address::{AddressType, NetworkChecked, NetworkUnchecked, NetworkValidation};
+
+/// The inner representation of an address, without the network validation tag.
+///
+/// This struct represents the inner representation of an address without the network validation
+/// tag, which is used to ensure that addresses are used only on the appropriate network.
+#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
+enum AddressInner {
+    P2pkh { hash: PubkeyHash, network: Network },
+    P2sh { hash: ScriptHash, network: Network },
+}
+
+/// Formats bech32 as upper case if alternate formatting is chosen (`{:#}`).
+impl fmt::Display for AddressInner {
+    fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
+        use AddressInner::*;
+        match self {
+            P2pkh { hash, network } => {
+                let mut prefixed = [0; 21];
+                prefixed[0] = match network {
+                    Network::Dogecoin => PUBKEY_ADDRESS_PREFIX_MAINNET,
+                    Network::Testnet => PUBKEY_ADDRESS_PREFIX_TESTNET,
+                    Network::Regtest => PUBKEY_ADDRESS_PREFIX_REGTEST,
+                };
+                prefixed[1..].copy_from_slice(&hash[..]);
+                base58::encode_check_to_fmt(fmt, &prefixed[..])
+            }
+            P2sh { hash, network } => {
+                let mut prefixed = [0; 21];
+                prefixed[0] = match network {
+                    Network::Dogecoin => SCRIPT_ADDRESS_PREFIX_MAINNET,
+                    Network::Testnet => SCRIPT_ADDRESS_PREFIX_TESTNET,
+                    Network::Regtest => SCRIPT_ADDRESS_PREFIX_REGTEST,
+                };
+                prefixed[1..].copy_from_slice(&hash[..]);
+                base58::encode_check_to_fmt(fmt, &prefixed[..])
+            }
+        }
+    }
+}
+
+/// The data encoded by an `Address`.
+///
+/// This is the data used to encumber an output that pays to this address i.e., it is the address
+/// excluding the network information.
+#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
+#[non_exhaustive]
+pub enum AddressData {
+    /// Data encoded by a P2PKH address.
+    P2pkh {
+        /// The pubkey hash used to encumber outputs to this address.
+        pubkey_hash: PubkeyHash,
+    },
+    /// Data encoded by a P2SH address.
+    P2sh {
+        /// The script hash used to encumber outputs to this address.
+        script_hash: ScriptHash,
+    },
+}
+
+/// A Dogecoin address.
+///
+/// ### Parsing addresses
+///
+/// When parsing string as an address, one has to pay attention to the network, on which the parsed
+/// address is supposed to be valid. For the purpose of this validation, `Address` has
+/// [`is_valid_for_network`](Address<NetworkUnchecked>::is_valid_for_network) method. In order to provide more safety,
+/// enforced by compiler, `Address` also contains a special marker type, which indicates whether network of the parsed
+/// address has been checked. This marker type will prevent from calling certain functions unless the network
+/// verification has been successfully completed.
+///
+/// The result of parsing an address is `Address<NetworkUnchecked>` suggesting that network of the parsed address
+/// has not yet been verified. To perform this verification, method [`require_network`](Address<NetworkUnchecked>::require_network)
+/// can be called, providing network on which the address is supposed to be valid. If the verification succeeds,
+/// `Address<NetworkChecked>` is returned.
+///
+/// The types `Address` and `Address<NetworkChecked>` are synonymous, i. e. they can be used interchangeably.
+///
+/// ```rust
+/// use std::str::FromStr;
+/// use bitcoin::dogecoin::{Address, Network};
+/// use bitcoin::address::{NetworkUnchecked, NetworkChecked};
+///
+/// // variant 1
+/// let address: Address<NetworkUnchecked> = "DUSamFaUtRQ78DVidoeY3J8keYkQXdinrt".parse().unwrap();
+/// let address: Address<NetworkChecked> = address.require_network(Network::Dogecoin).unwrap();
+///
+/// // variant 2
+/// let address: Address = Address::from_str("DUSamFaUtRQ78DVidoeY3J8keYkQXdinrt").unwrap()
+///                .require_network(Network::Dogecoin).unwrap();
+///
+/// // variant 3
+/// let address: Address<NetworkChecked> = "DUSamFaUtRQ78DVidoeY3J8keYkQXdinrt".parse::<Address<_>>()
+///                .unwrap().require_network(Network::Dogecoin).unwrap();
+/// ```
+///
+/// ### Formatting addresses
+///
+/// To format address into its textual representation, both `Debug` (for usage in programmer-facing,
+/// debugging context) and `Display` (for user-facing output) can be used, with the following caveats:
+///
+/// 1. `Display` is implemented only for `Address<NetworkChecked>`:
+///
+/// ```
+/// # use std::str::FromStr;
+/// # use bitcoin::dogecoin::address::{Address, NetworkChecked};
+/// let address: Address<NetworkChecked> = Address::from_str("n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe")
+///                .unwrap().assume_checked();
+/// assert_eq!(address.to_string(), "n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe");
+/// ```
+///
+/// ```ignore
+/// # use std::str::FromStr;
+/// # use bitcoin::dogecoin::address::{Address, NetworkChecked};
+/// let address: Address<NetworkUnchecked> = Address::from_str("n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe")
+///                .unwrap();
+/// let s = address.to_string(); // does not compile
+/// ```
+///
+/// 2. `Debug` on `Address<NetworkUnchecked>` does not produce clean address but address wrapped by
+///    an indicator that its network has not been checked. This is to encourage programmer to properly
+///    check the network and use `Display` in user-facing context.
+///
+/// ```
+/// # use std::str::FromStr;
+/// # use bitcoin::dogecoin::address::{Address, NetworkUnchecked};
+/// let address: Address<NetworkUnchecked> = Address::from_str("n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe")
+///                .unwrap();
+/// assert_eq!(format!("{:?}", address), "Address<NetworkUnchecked>(n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe)");
+/// ```
+///
+/// ```
+/// # use std::str::FromStr;
+/// # use bitcoin::dogecoin::address::{Address, NetworkChecked};
+/// let address: Address<NetworkChecked> = Address::from_str("n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe")
+///                .unwrap().assume_checked();
+/// assert_eq!(format!("{:?}", address), "n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe");
+/// ```
+#[derive(Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
+// The `#[repr(transparent)]` attribute is used to guarantee the layout of the `Address` struct. It
+// is an implementation detail and users should not rely on it in their code.
+#[repr(transparent)]
+pub struct Address<V = NetworkChecked>(AddressInner, PhantomData<V>)
+where
+    V: NetworkValidation;
+
+#[cfg(feature = "serde")]
+struct DisplayUnchecked<'a, N: NetworkValidation>(&'a Address<N>);
+
+#[cfg(feature = "serde")]
+impl<N: NetworkValidation> fmt::Display for DisplayUnchecked<'_, N> {
+    fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
+        fmt::Display::fmt(&self.0 .0, fmt)
+    }
+}
+
+#[cfg(feature = "serde")]
+crate::serde_utils::serde_string_deserialize_impl!(Address<NetworkUnchecked>, "a Dogecoin address");
+
+#[cfg(feature = "serde")]
+impl<N: NetworkValidation> serde::Serialize for Address<N> {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: serde::Serializer,
+    {
+        serializer.collect_str(&DisplayUnchecked(self))
+    }
+}
+
+/// Methods on [`Address`] that can be called on both `Address<NetworkChecked>` and
+/// `Address<NetworkUnchecked>`.
+impl<V: NetworkValidation> Address<V> {
+    /// Returns a reference to the address as if it was unchecked.
+    pub fn as_unchecked(&self) -> &Address<NetworkUnchecked> {
+        unsafe { &*(self as *const Address<V> as *const Address<NetworkUnchecked>) }
+    }
+
+    /// Marks the network of this address as unchecked.
+    pub fn into_unchecked(self) -> Address<NetworkUnchecked> {
+        Address(self.0, PhantomData)
+    }
+}
+
+/// Methods and functions that can be called only on `Address<NetworkChecked>`.
+impl Address {
+    /// Creates a pay to (compressed) public key hash address from a public key.
+    ///
+    /// This is the preferred non-witness type address.
+    #[inline]
+    pub fn p2pkh(pk: impl Into<PubkeyHash>, network: impl Into<Network>) -> Address {
+        let hash = pk.into();
+        Self(AddressInner::P2pkh { hash, network: network.into() }, PhantomData)
+    }
+
+    /// Creates a pay to script hash P2SH address from a script.
+    ///
+    /// This address type was introduced with BIP16 and is the popular type to implement multi-sig
+    /// these days.
+    #[inline]
+    pub fn p2sh(script: &Script, network: impl Into<Network>) -> Result<Address, P2shError> {
+        if script.len() > MAX_SCRIPT_ELEMENT_SIZE {
+            return Err(P2shError::ExcessiveScriptSize);
+        }
+        let hash = script.script_hash();
+        Ok(Address::p2sh_from_hash(hash, network))
+    }
+
+    /// Creates a pay to script hash P2SH address from a script hash.
+    ///
+    /// # Warning
+    ///
+    /// The `hash` pre-image (redeem script) must not exceed 520 bytes in length
+    /// otherwise outputs created from the returned address will be un-spendable.
+    pub fn p2sh_from_hash(hash: ScriptHash, network: impl Into<Network>) -> Address {
+        Self(AddressInner::P2sh { hash, network: network.into() }, PhantomData)
+    }
+
+    /// Gets the address type of the address.
+    ///
+    /// # Returns
+    ///
+    /// None if unknown, non-standard or related to the future witness version.
+    #[inline]
+    pub fn address_type(&self) -> Option<AddressType> {
+        match self.0 {
+            AddressInner::P2pkh { .. } => Some(AddressType::P2pkh),
+            AddressInner::P2sh { .. } => Some(AddressType::P2sh),
+        }
+    }
+
+    /// Gets the address data from this address.
+    pub fn to_address_data(&self) -> AddressData {
+        use AddressData::*;
+
+        match self.0 {
+            AddressInner::P2pkh { hash, network: _ } => P2pkh { pubkey_hash: hash },
+            AddressInner::P2sh { hash, network: _ } => P2sh { script_hash: hash },
+        }
+    }
+
+    /// Gets the pubkey hash for this address if this is a P2PKH address.
+    pub fn pubkey_hash(&self) -> Option<PubkeyHash> {
+        use AddressInner::*;
+
+        match self.0 {
+            P2pkh { ref hash, network: _ } => Some(*hash),
+            _ => None,
+        }
+    }
+
+    /// Gets the script hash for this address if this is a P2SH address.
+    pub fn script_hash(&self) -> Option<ScriptHash> {
+        use AddressInner::*;
+
+        match self.0 {
+            P2sh { ref hash, network: _ } => Some(*hash),
+            _ => None,
+        }
+    }
+
+    /// Constructs an [`Address`] from an output script (`scriptPubkey`).
+    pub fn from_script(
+        script: &Script,
+        network: impl Into<Network>,
+    ) -> Result<Address, FromScriptError> {
+        let network = network.into();
+        if script.is_p2pkh() {
+            let bytes = script.as_bytes()[3..23].try_into().expect("statically 20B long");
+            let hash = PubkeyHash::from_byte_array(bytes);
+            Ok(Address::p2pkh(hash, network))
+        } else if script.is_p2sh() {
+            let bytes = script.as_bytes()[2..22].try_into().expect("statically 20B long");
+            let hash = ScriptHash::from_byte_array(bytes);
+            Ok(Address::p2sh_from_hash(hash, network))
+        } else {
+            Err(FromScriptError::UnrecognizedScript)
+        }
+    }
+
+    /// Generates a script pubkey spending to this address.
+    pub fn script_pubkey(&self) -> ScriptBuf {
+        use AddressInner::*;
+        match self.0 {
+            P2pkh { ref hash, network: _ } => ScriptBuf::new_p2pkh(hash),
+            P2sh { ref hash, network: _ } => ScriptBuf::new_p2sh(hash),
+        }
+    }
+
+    /// Returns true if the given pubkey is directly related to the address payload.
+    ///
+    /// This is determined by directly comparing the address payload with either the
+    /// hash of the given public key or the segwit redeem hash generated from the
+    /// given key. For taproot addresses, the supplied key is assumed to be tweaked
+    pub fn is_related_to_pubkey(&self, pubkey: &PublicKey) -> bool {
+        let pubkey_hash = pubkey.pubkey_hash();
+        let payload = self.payload_as_bytes();
+        let xonly_pubkey = XOnlyPublicKey::from(pubkey.inner);
+
+        (*pubkey_hash.as_byte_array() == *payload) || (xonly_pubkey.serialize() == *payload)
+    }
+
+    /// Returns true if the address creates a particular script
+    /// This function doesn't make any allocations.
+    pub fn matches_script_pubkey(&self, script: &Script) -> bool {
+        use AddressInner::*;
+        match self.0 {
+            P2pkh { ref hash, network: _ } if script.is_p2pkh() => {
+                &script.as_bytes()[3..23] == <PubkeyHash as AsRef<[u8; 20]>>::as_ref(hash)
+            }
+            P2sh { ref hash, network: _ } if script.is_p2sh() => {
+                &script.as_bytes()[2..22] == <ScriptHash as AsRef<[u8; 20]>>::as_ref(hash)
+            }
+            P2pkh { .. } | P2sh { .. } => false,
+        }
+    }
+
+    /// Returns the "payload" for this address.
+    ///
+    /// The "payload" is the useful stuff excluding serialization prefix, the exact payload is
+    /// dependent on the inner address:
+    ///
+    /// - For p2sh, the payload is the script hash.
+    /// - For p2pkh, the payload is the pubkey hash.
+    fn payload_as_bytes(&self) -> &[u8] {
+        use AddressInner::*;
+        match self.0 {
+            P2sh { ref hash, network: _ } => hash.as_ref(),
+            P2pkh { ref hash, network: _ } => hash.as_ref(),
+        }
+    }
+}
+
+/// Methods that can be called only on `Address<NetworkUnchecked>`.
+impl Address<NetworkUnchecked> {
+    /// Returns a reference to the checked address.
+    ///
+    /// This function is dangerous in case the address is not a valid checked address.
+    pub fn assume_checked_ref(&self) -> &Address {
+        unsafe { &*(self as *const Address<NetworkUnchecked> as *const Address) }
+    }
+
+    /// Parsed addresses do not always have *one* network. The problem is that testnet,
+    /// regtest p2pkh addresses use different prefixes, but testnet and regtest p2sh
+    /// addresses use the same prefix.
+    ///
+    /// So if one wants to check if an address belongs to a certain network a simple
+    /// comparison is not enough anymore. Instead this function can be used.
+    ///
+    /// ```rust
+    /// use bitcoin::dogecoin::{Address, Network};
+    /// use bitcoin::address::NetworkUnchecked;
+    ///
+    /// let address: Address<NetworkUnchecked> = "no2dRNaFqxNjWZLeTRu4XyCuzeGdE3VY2S".parse().unwrap();
+    /// assert!(address.is_valid_for_network(Network::Testnet));
+    /// assert_eq!(address.is_valid_for_network(Network::Regtest), false);
+    ///
+    /// let address: Address<NetworkUnchecked> = "n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe".parse().unwrap();
+    /// assert!(address.is_valid_for_network(Network::Regtest));
+    /// assert_eq!(address.is_valid_for_network(Network::Testnet), false);
+    ///
+    /// let address: Address<NetworkUnchecked> = "DUSamFaUtRQ78DVidoeY3J8keYkQXdinrt".parse().unwrap();
+    /// assert!(address.is_valid_for_network(Network::Dogecoin));
+    /// assert_eq!(address.is_valid_for_network(Network::Testnet), false);
+    ///
+    /// let address: Address<NetworkUnchecked> = "2N3zXjbwdTcPsJiy8sUK9FhWJhqQCxA8Jjr".parse().unwrap();
+    /// assert!(address.is_valid_for_network(Network::Testnet));
+    /// assert!(address.is_valid_for_network(Network::Regtest));
+    /// assert_eq!(address.is_valid_for_network(Network::Dogecoin), false);
+    /// ```
+    pub fn is_valid_for_network(&self, n: Network) -> bool {
+        use AddressInner::*;
+        match self.0 {
+            P2pkh { hash: _, ref network } => *network == n,
+            P2sh { hash: _, network: Network::Dogecoin } => n == Network::Dogecoin,
+            P2sh { hash: _, network: Network::Testnet } => {
+                n == Network::Testnet || n == Network::Regtest
+            }
+            P2sh { hash: _, network: Network::Regtest } => {
+                n == Network::Testnet || n == Network::Regtest
+            }
+        }
+    }
+
+    /// Checks whether network of this address is as required.
+    ///
+    /// For details about this mechanism, see section [*Parsing addresses*](Address#parsing-addresses)
+    /// on [`Address`].
+    ///
+    /// # Errors
+    ///
+    /// This function only ever returns the [`ParseError::NetworkValidation`] variant of
+    /// `ParseError`. This is not how we normally implement errors in this library but
+    /// `require_network` is not a typical function, it is conceptually part of string parsing.
+    ///
+    ///  # Examples
+    ///
+    /// ```
+    /// use bitcoin::address::{NetworkChecked, NetworkUnchecked};
+    /// use bitcoin::dogecoin::{Address, Network, ParseError};
+    ///
+    /// const ADDR: &str = "DUSamFaUtRQ78DVidoeY3J8keYkQXdinrt";
+    ///
+    /// fn parse_and_validate_address(network: Network) -> Result<Address, ParseError> {
+    ///     let address = ADDR.parse::<Address<_>>()?
+    ///                       .require_network(network)?;
+    ///     Ok(address)
+    /// }
+    ///
+    /// fn parse_and_validate_address_combinator(network: Network) -> Result<Address, ParseError> {
+    ///     let address = ADDR.parse::<Address<_>>()
+    ///                       .and_then(|a| a.require_network(network))?;
+    ///     Ok(address)
+    /// }
+    ///
+    /// fn parse_and_validate_address_show_types(network: Network) -> Result<Address, ParseError> {
+    ///     let address: Address<NetworkChecked> = ADDR.parse::<Address<NetworkUnchecked>>()?
+    ///                                                .require_network(network)?;
+    ///     Ok(address)
+    /// }
+    ///
+    /// let network = Network::Dogecoin;  // Don't hard code network in applications.
+    /// let _ = parse_and_validate_address(network).unwrap();
+    /// let _ = parse_and_validate_address_combinator(network).unwrap();
+    /// let _ = parse_and_validate_address_show_types(network).unwrap();
+    /// ```
+    #[inline]
+    pub fn require_network(self, required: Network) -> Result<Address, ParseError> {
+        if self.is_valid_for_network(required) {
+            Ok(self.assume_checked())
+        } else {
+            Err(NetworkValidationError { required, address: self }.into())
+        }
+    }
+
+    /// Marks, without any additional checks, network of this address as checked.
+    ///
+    /// Improper use of this method may lead to loss of funds. Reader will most likely prefer
+    /// [`require_network`](Address<NetworkUnchecked>::require_network) as a safe variant.
+    /// For details about this mechanism, see section [*Parsing addresses*](Address#parsing-addresses)
+    /// on [`Address`].
+    #[inline]
+    pub fn assume_checked(self) -> Address {
+        Address(self.0, PhantomData)
+    }
+}
+
+impl From<Address> for script::ScriptBuf {
+    fn from(a: Address) -> Self {
+        a.script_pubkey()
+    }
+}
+
+// Alternate formatting `{:#}` is used to return uppercase version of bech32 addresses which should
+// be used in QR codes, see [`Address::to_qr_uri`].
+impl fmt::Display for Address {
+    fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
+        fmt::Display::fmt(&self.0, fmt)
+    }
+}
+
+impl<V: NetworkValidation> fmt::Debug for Address<V> {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        if V::IS_CHECKED {
+            fmt::Display::fmt(&self.0, f)
+        } else {
+            write!(f, "Address<NetworkUnchecked>(")?;
+            fmt::Display::fmt(&self.0, f)?;
+            write!(f, ")")
+        }
+    }
+}
+
+/// Address can be parsed only with `NetworkUnchecked`.
+impl FromStr for Address<NetworkUnchecked> {
+    type Err = ParseError;
+
+    fn from_str(s: &str) -> Result<Address<NetworkUnchecked>, ParseError> {
+        if s.len() > 50 {
+            return Err(LegacyAddressTooLongError { length: s.len() }.into());
+        }
+        let data = base58::decode_check(s)?;
+        if data.len() != 21 {
+            return Err(InvalidBase58PayloadLengthError { length: s.len() }.into());
+        }
+
+        let (prefix, data) = data.split_first().expect("length checked above");
+        let data: [u8; 20] = data.try_into().expect("length checked above");
+
+        let inner = match *prefix {
+            PUBKEY_ADDRESS_PREFIX_MAINNET => {
+                let hash = PubkeyHash::from_byte_array(data);
+                AddressInner::P2pkh { hash, network: Network::Dogecoin }
+            }
+            PUBKEY_ADDRESS_PREFIX_TESTNET => {
+                let hash = PubkeyHash::from_byte_array(data);
+                AddressInner::P2pkh { hash, network: Network::Testnet }
+            }
+            PUBKEY_ADDRESS_PREFIX_REGTEST => {
+                let hash = PubkeyHash::from_byte_array(data);
+                AddressInner::P2pkh { hash, network: Network::Regtest }
+            }
+            SCRIPT_ADDRESS_PREFIX_MAINNET => {
+                let hash = ScriptHash::from_byte_array(data);
+                AddressInner::P2sh { hash, network: Network::Dogecoin }
+            }
+            // Because SCRIPT_ADDRESS_PREFIX_TESTNET and SCRIPT_ADDRESS_PREFIX_REGTTEST are
+            // the same, we do not differentiate between Testnet and Regtest only when it is P2sh.
+            // This is handled in function is_valid_for_network (its docstring has more
+            // explanation).
+            SCRIPT_ADDRESS_PREFIX_TESTNET => {
+                let hash = ScriptHash::from_byte_array(data);
+                AddressInner::P2sh { hash, network: Network::Testnet }
+            }
+            invalid => return Err(InvalidLegacyPrefixError { invalid }.into()),
+        };
+
+        Ok(Address(inner, PhantomData))
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::dogecoin::Network::{Dogecoin, Testnet};
+
+    fn roundtrips(addr: &Address, network: Network) {
+        assert_eq!(
+            Address::from_str(&addr.to_string()).unwrap().assume_checked(),
+            *addr,
+            "string round-trip failed for {}",
+            addr,
+        );
+        assert_eq!(
+            Address::from_script(&addr.script_pubkey(), network)
+                .expect("failed to create inner address from script_pubkey"),
+            *addr,
+            "script round-trip failed for {}",
+            addr,
+        );
+
+        #[cfg(feature = "serde")]
+        {
+            let ser = serde_json::to_string(addr).expect("failed to serialize address");
+            let back: Address<NetworkUnchecked> =
+                serde_json::from_str(&ser).expect("failed to deserialize address");
+            assert_eq!(back.assume_checked(), *addr, "serde round-trip failed for {}", addr)
+        }
+    }
+
+    #[test]
+    fn test_p2pkh_address_58() {
+        let hash = "162c5ea71c0b23f5b9022ef047c4a86470a5b070".parse::<PubkeyHash>().unwrap();
+        let addr = Address::p2pkh(hash, Dogecoin);
+
+        assert_eq!(
+            addr.script_pubkey(),
+            ScriptBuf::from_hex("76a914162c5ea71c0b23f5b9022ef047c4a86470a5b07088ac").unwrap()
+        );
+        assert_eq!(&addr.to_string(), "D7ALZLo7BL5vM9Vb4vAqvqwX9fpQ4wKRiy");
+        assert_eq!(addr.address_type(), Some(AddressType::P2pkh));
+        roundtrips(&addr, Dogecoin);
+    }
+
+    #[test]
+    fn test_p2pkh_from_key() {
+        let key = "048d5141948c1702e8c95f438815794b87f706a8d4cd2bffad1dc1570971032c9b6042a0431ded2478b5c9cf2d81c124a5e57347a3c63ef0e7716cf54d613ba183".parse::<PublicKey>().unwrap();
+        let addr = Address::p2pkh(key, Dogecoin);
+        assert_eq!(&addr.to_string(), "DUSamFaUtRQ78DVidoeY3J8keYkQXdinrt");
+
+        let key = "03df154ebfcf29d29cc10d5c2565018bce2d9edbab267c31d2caf44a63056cf99f"
+            .parse::<PublicKey>()
+            .unwrap();
+        let addr = Address::p2pkh(key, Testnet);
+        assert_eq!(&addr.to_string(), "neRuCZsfnZaJN8FmxxVZDSZbcGATnzGByf");
+        assert_eq!(addr.address_type(), Some(AddressType::P2pkh));
+        roundtrips(&addr, Testnet);
+    }
+
+    #[test]
+    fn test_p2sh_address_58() {
+        let hash = "162c5ea71c0b23f5b9022ef047c4a86470a5b070".parse::<ScriptHash>().unwrap();
+        let addr = Address::p2sh_from_hash(hash, Dogecoin);
+
+        assert_eq!(
+            addr.script_pubkey(),
+            ScriptBuf::from_hex("a914162c5ea71c0b23f5b9022ef047c4a86470a5b07087").unwrap(),
+        );
+        assert_eq!(&addr.to_string(), "9tTWgUQoVtNuogNtsZWJ3qmE7dkrPTrVAj");
+        assert_eq!(addr.address_type(), Some(AddressType::P2sh));
+        roundtrips(&addr, Dogecoin);
+    }
+
+    #[test]
+    fn test_p2sh_parse() {
+        let script = ScriptBuf::from_hex("552103a765fc35b3f210b95223846b36ef62a4e53e34e2925270c2c7906b92c9f718eb2103c327511374246759ec8d0b89fa6c6b23b33e11f92c5bc155409d86de0c79180121038cae7406af1f12f4786d820a1466eec7bc5785a1b5e4a387eca6d797753ef6db2103252bfb9dcaab0cd00353f2ac328954d791270203d66c2be8b430f115f451b8a12103e79412d42372c55dd336f2eb6eb639ef9d74a22041ba79382c74da2338fe58ad21035049459a4ebc00e876a9eef02e72a3e70202d3d1f591fc0dd542f93f642021f82102016f682920d9723c61b27f562eb530c926c00106004798b6471e8c52c60ee02057ae").unwrap();
+        let addr = Address::p2sh(&script, Testnet).unwrap();
+        assert_eq!(&addr.to_string(), "2N3zXjbwdTcPsJiy8sUK9FhWJhqQCxA8Jjr");
+        assert_eq!(addr.address_type(), Some(AddressType::P2sh));
+        roundtrips(&addr, Testnet);
+    }
+
+    #[test]
+    fn test_p2sh_parse_for_large_script() {
+        let script = ScriptBuf::from_hex("552103a765fc35b3f210b95223846b36ef62a4e53e34e2925270c2c7906b92c9f718eb2103c327511374246759ec8d0b89fa6c6b23b33e11f92c5bc155409d86de0c79180121038cae7406af1f12f4786d820a1466eec7bc5785a1b5e4a387eca6d797753ef6db2103252bfb9dcaab0cd00353f2ac328954d791270203d66c2be8b430f115f451b8a12103e79412d42372c55dd336f2eb6eb639ef9d74a22041ba79382c74da2338fe58ad21035049459a4ebc00e876a9eef02e72a3e70202d3d1f591fc0dd542f93f642021f82102016f682920d9723c61b27f562eb530c926c00106004798b6471e8c52c60ee02057ae12123122313123123ac1231231231231313123131231231231313212313213123123552103a765fc35b3f210b95223846b36ef62a4e53e34e2925270c2c7906b92c9f718eb2103c327511374246759ec8d0b89fa6c6b23b33e11f92c5bc155409d86de0c79180121038cae7406af1f12f4786d820a1466eec7bc5785a1b5e4a387eca6d797753ef6db2103252bfb9dcaab0cd00353f2ac328954d791270203d66c2be8b430f115f451b8a12103e79412d42372c55dd336f2eb6eb639ef9d74a22041ba79382c74da2338fe58ad21035049459a4ebc00e876a9eef02e72a3e70202d3d1f591fc0dd542f93f642021f82102016f682920d9723c61b27f562eb530c926c00106004798b6471e8c52c60ee02057ae12123122313123123ac1231231231231313123131231231231313212313213123123552103a765fc35b3f210b95223846b36ef62a4e53e34e2925270c2c7906b92c9f718eb2103c327511374246759ec8d0b89fa6c6b23b33e11f92c5bc155409d86de0c79180121038cae7406af1f12f4786d820a1466eec7bc5785a1b5e4a387eca6d797753ef6db2103252bfb9dcaab0cd00353f2ac328954d791270203d66c2be8b430f115f451b8a12103e79412d42372c55dd336f2eb6eb639ef9d74a22041ba79382c74da2338fe58ad21035049459a4ebc00e876a9eef02e72a3e70202d3d1f591fc0dd542f93f642021f82102016f682920d9723c61b27f562eb530c926c00106004798b6471e8c52c60ee02057ae12123122313123123ac1231231231231313123131231231231313212313213123123").unwrap();
+        assert_eq!(Address::p2sh(&script, Testnet), Err(P2shError::ExcessiveScriptSize));
+    }
+
+    #[test]
+    fn test_address_debug() {
+        // This is not really testing output of Debug but the ability and proper functioning
+        // of Debug derivation on structs generic in NetworkValidation.
+        #[derive(Debug)]
+        #[allow(unused)]
+        struct Test<V: NetworkValidation> {
+            address: Address<V>,
+        }
+
+        let addr_str = "n48pquU8ieq7gidgJJ4vWD2jbsErmZvrwe";
+        let unchecked = Address::from_str(addr_str).unwrap();
+
+        assert_eq!(
+            format!("{:?}", Test { address: unchecked.clone() }),
+            format!("Test {{ address: Address<NetworkUnchecked>({}) }}", addr_str)
+        );
+
+        assert_eq!(
+            format!("{:?}", Test { address: unchecked.assume_checked() }),
+            format!("Test {{ address: {} }}", addr_str)
+        );
+    }
+
+    #[test]
+    fn test_address_type() {
+        let addresses = [
+            ("DMKhUaRmnxJXfDxyFguMnMjVdgvnNipFzt", Some(AddressType::P2pkh)),
+            ("A1yb6viUzAcUWftRHT6GpnCwvhXHg4CV1x", Some(AddressType::P2sh)),
+        ];
+        for (address, expected_type) in &addresses {
+            let addr =
+                Address::from_str(address).unwrap().require_network(Dogecoin).expect("mainnet");
+            assert_eq!(&addr.address_type(), expected_type);
+        }
+    }
+
+    #[test]
+    #[cfg(feature = "serde")]
+    fn test_json_serialize() {
+        use serde_json;
+
+        let addr =
+            Address::from_str("D7ALZLo7BL5vM9Vb4vAqvqwX9fpQ4wKRiy").unwrap().assume_checked();
+        let json = serde_json::to_value(&addr).unwrap();
+        assert_eq!(
+            json,
+            serde_json::Value::String("D7ALZLo7BL5vM9Vb4vAqvqwX9fpQ4wKRiy".to_owned())
+        );
+        let into: Address = serde_json::from_value::<Address<_>>(json).unwrap().assume_checked();
+        assert_eq!(addr.to_string(), into.to_string());
+        assert_eq!(
+            into.script_pubkey(),
+            ScriptBuf::from_hex("76a914162c5ea71c0b23f5b9022ef047c4a86470a5b07088ac").unwrap()
+        );
+
+        let addr =
+            Address::from_str("9tTWgUQoVtNuogNtsZWJ3qmE7dkrPTrVAj").unwrap().assume_checked();
+        let json = serde_json::to_value(&addr).unwrap();
+        assert_eq!(
+            json,
+            serde_json::Value::String("9tTWgUQoVtNuogNtsZWJ3qmE7dkrPTrVAj".to_owned())
+        );
+        let into: Address = serde_json::from_value::<Address<_>>(json).unwrap().assume_checked();
+        assert_eq!(addr.to_string(), into.to_string());
+        assert_eq!(
+            into.script_pubkey(),
+            ScriptBuf::from_hex("a914162c5ea71c0b23f5b9022ef047c4a86470a5b07087").unwrap()
+        );
+    }
+
+    #[test]
+    fn test_is_related_to_pubkey_p2pkh() {
+        let address_string = "neRuCZsfnZaJN8FmxxVZDSZbcGATnzGByf";
+        let address = Address::from_str(address_string)
+            .expect("address")
+            .require_network(Testnet)
+            .expect("testnet");
+
+        let pubkey_string = "03df154ebfcf29d29cc10d5c2565018bce2d9edbab267c31d2caf44a63056cf99f";
+        let pubkey = PublicKey::from_str(pubkey_string).expect("pubkey");
+
+        let result = address.is_related_to_pubkey(&pubkey);
+        assert!(result);
+
+        let unused_pubkey = PublicKey::from_str(
+            "02ba604e6ad9d3864eda8dc41c62668514ef7d5417d3b6db46e45cc4533bff001c",
+        )
+        .expect("pubkey");
+        assert!(!address.is_related_to_pubkey(&unused_pubkey))
+    }
+
+    #[test]
+    fn test_is_related_to_pubkey_p2pkh_uncompressed_key() {
+        let address_string = "DUSamFaUtRQ78DVidoeY3J8keYkQXdinrt";
+        let address = Address::from_str(address_string)
+            .expect("address")
+            .require_network(Dogecoin)
+            .expect("mainnet");
+
+        let pubkey_string = "048d5141948c1702e8c95f438815794b87f706a8d4cd2bffad1dc1570971032c9b6042a0431ded2478b5c9cf2d81c124a5e57347a3c63ef0e7716cf54d613ba183";
+        let pubkey = PublicKey::from_str(pubkey_string).expect("pubkey");
+
+        let result = address.is_related_to_pubkey(&pubkey);
+        assert!(result);
+
+        let unused_pubkey = PublicKey::from_str(
+            "02ba604e6ad9d3864eda8dc41c62668514ef7d5417d3b6db46e45cc4533bff001c",
+        )
+        .expect("pubkey");
+        assert!(!address.is_related_to_pubkey(&unused_pubkey))
+    }
+}
diff --git a/bitcoin/src/dogecoin/constants.rs b/bitcoin/src/dogecoin/constants.rs
index 0897189dc..17649be4e 100644
--- a/bitcoin/src/dogecoin/constants.rs
+++ b/bitcoin/src/dogecoin/constants.rs
@@ -18,6 +18,13 @@ use crate::{
     TxMerkleNode, TxOut, Witness,
 };
 
+pub(crate) const PUBKEY_ADDRESS_PREFIX_MAINNET : u8 = 0x1e;
+pub(crate) const PUBKEY_ADDRESS_PREFIX_TESTNET : u8 = 0x71;
+pub(crate) const PUBKEY_ADDRESS_PREFIX_REGTEST : u8 = 0x6f;
+pub(crate) const SCRIPT_ADDRESS_PREFIX_MAINNET : u8 = 0x16;
+pub(crate) const SCRIPT_ADDRESS_PREFIX_TESTNET : u8 = 0xc4;
+pub(crate) const SCRIPT_ADDRESS_PREFIX_REGTEST : u8 = 0xc4;
+
 // This is the 65 byte (uncompressed) pubkey used as the one-and-only output of the genesis transaction.
 //
 // ref: https://github.com/dogecoin/dogecoin/blob/7237da74b8c356568644cbe4fba19d994704355b/src/chainparams.cpp#L55
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index aab03be93..03f46eede 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -5,16 +5,19 @@
 //! This module provides support for de/serialization, parsing and execution on data structures and
 //! network messages related to Dogecoin.
 
+pub mod address;
 pub mod constants;
 pub mod params;
 
+pub use address::*;
+
 use crate::block::{Header, TxMerkleNode};
 use crate::consensus::{encode, Decodable, Encodable};
-use crate::params::Params as BitcoinParams;
 use crate::dogecoin::params::Params;
 use crate::internal_macros::impl_consensus_encoding;
 use crate::io::{Read, Write};
 use crate::p2p::Magic;
+use crate::params::Params as BitcoinParams;
 use crate::prelude::*;
 use crate::{io, BlockHash, Transaction};
 use core::fmt;

From 8cd380f8a3806fc7f0fa3c30883d77f0546a60a5 Mon Sep 17 00:00:00 2001
From: Paul Liu <paul@dfinity.org>
Date: Fri, 13 Jun 2025 15:39:01 +0800
Subject: [PATCH 43/53] feat: Support dogecoin in p2p messages (#6)

Support dogecoin in p2p messages by making NetworkMessage type
parameterized by Block type.

Also add `with_version()` methods to a few types to allow changing
protocol version number.
---
 bitcoin/examples/handshake.rs              | 19 +++++++-----
 bitcoin/src/p2p/message.rs                 | 35 +++++++++++++---------
 bitcoin/src/p2p/message_blockdata.rs       |  8 +++++
 bitcoin/src/p2p/message_network.rs         |  4 +++
 fuzz/fuzz_targets/bitcoin/deser_net_msg.rs |  2 +-
 5 files changed, 45 insertions(+), 23 deletions(-)

diff --git a/bitcoin/examples/handshake.rs b/bitcoin/examples/handshake.rs
index d77828bb3..4106cbf16 100644
--- a/bitcoin/examples/handshake.rs
+++ b/bitcoin/examples/handshake.rs
@@ -9,6 +9,9 @@ use bitcoin::consensus::{encode, Decodable};
 use bitcoin::p2p::{self, address, message, message_network};
 use bitcoin::secp256k1::rand::Rng;
 
+type NetworkMessage = message::NetworkMessage<bitcoin::Block>;
+type RawNetworkMessage = message::RawNetworkMessage<bitcoin::Block>;
+
 fn main() {
     // This example establishes a connection to a Bitcoin node, sends the initial
     // "version" message, waits for the reply, and finally closes the connection.
@@ -28,7 +31,7 @@ fn main() {
     let version_message = build_version_message(address);
 
     let first_message =
-        message::RawNetworkMessage::new(bitcoin::Network::Bitcoin.magic(), version_message);
+        RawNetworkMessage::new(bitcoin::Network::Bitcoin.magic(), version_message);
 
     if let Ok(mut stream) = TcpStream::connect(address) {
         // Send the message
@@ -40,20 +43,20 @@ fn main() {
         let mut stream_reader = BufReader::new(read_stream);
         loop {
             // Loop an retrieve new messages
-            let reply = message::RawNetworkMessage::consensus_decode(&mut stream_reader).unwrap();
+            let reply = RawNetworkMessage::consensus_decode(&mut stream_reader).unwrap();
             match reply.payload() {
-                message::NetworkMessage::Version(_) => {
+                NetworkMessage::Version(_) => {
                     println!("Received version message: {:?}", reply.payload());
 
-                    let second_message = message::RawNetworkMessage::new(
+                    let second_message = RawNetworkMessage::new(
                         bitcoin::Network::Bitcoin.magic(),
-                        message::NetworkMessage::Verack,
+                        NetworkMessage::Verack,
                     );
 
                     let _ = stream.write_all(encode::serialize(&second_message).as_slice());
                     println!("Sent verack message");
                 }
-                message::NetworkMessage::Verack => {
+                NetworkMessage::Verack => {
                     println!("Received verack message: {:?}", reply.payload());
                     break;
                 }
@@ -69,7 +72,7 @@ fn main() {
     }
 }
 
-fn build_version_message(address: SocketAddr) -> message::NetworkMessage {
+fn build_version_message(address: SocketAddr) -> NetworkMessage {
     // Building version message, see https://en.bitcoin.it/wiki/Protocol_documentation#version
     let my_address = SocketAddr::new(IpAddr::V4(Ipv4Addr::new(0, 0, 0, 0)), 0);
 
@@ -95,7 +98,7 @@ fn build_version_message(address: SocketAddr) -> message::NetworkMessage {
     let start_height: i32 = 0;
 
     // Construct the message
-    message::NetworkMessage::Version(message_network::VersionMessage::new(
+    NetworkMessage::Version(message_network::VersionMessage::new(
         services,
         timestamp as i64,
         addr_recv,
diff --git a/bitcoin/src/p2p/message.rs b/bitcoin/src/p2p/message.rs
index 11e10cafd..80d655921 100644
--- a/bitcoin/src/p2p/message.rs
+++ b/bitcoin/src/p2p/message.rs
@@ -150,9 +150,9 @@ impl std::error::Error for CommandStringError {
 
 /// A Network message
 #[derive(Clone, Debug, PartialEq, Eq)]
-pub struct RawNetworkMessage {
+pub struct RawNetworkMessage<Block> {
     magic: Magic,
-    payload: NetworkMessage,
+    payload: NetworkMessage<Block>,
     payload_len: u32,
     checksum: [u8; 4],
 }
@@ -160,7 +160,7 @@ pub struct RawNetworkMessage {
 /// A Network message payload. Proper documentation is available on at
 /// [Bitcoin Wiki: Protocol Specification](https://en.bitcoin.it/wiki/Protocol_specification)
 #[derive(Clone, PartialEq, Eq, Debug)]
-pub enum NetworkMessage {
+pub enum NetworkMessage<Block> {
     /// `version`
     Version(message_network::VersionMessage),
     /// `verack`
@@ -182,7 +182,7 @@ pub enum NetworkMessage {
     /// tx
     Tx(transaction::Transaction),
     /// `block`
-    Block(block::Block),
+    Block(Block),
     /// `headers`
     Headers(Vec<block::Header>),
     /// `sendheaders`
@@ -243,7 +243,7 @@ pub enum NetworkMessage {
     },
 }
 
-impl NetworkMessage {
+impl<Block> NetworkMessage<Block> {
     /// Return the message command as a static string reference.
     ///
     /// This returns `"unknown"` for [NetworkMessage::Unknown],
@@ -300,9 +300,9 @@ impl NetworkMessage {
     }
 }
 
-impl RawNetworkMessage {
+impl<Block: Encodable> RawNetworkMessage<Block> {
     /// Creates a [RawNetworkMessage]
-    pub fn new(magic: Magic, payload: NetworkMessage) -> Self {
+    pub fn new(magic: Magic, payload: NetworkMessage<Block>) -> Self {
         let mut engine = sha256d::Hash::engine();
         let payload_len = payload.consensus_encode(&mut engine).expect("engine doesn't error");
         let payload_len = u32::try_from(payload_len).expect("network message use u32 as length");
@@ -312,12 +312,14 @@ impl RawNetworkMessage {
     }
 
     /// Consumes the [RawNetworkMessage] instance and returns the inner payload.
-    pub fn into_payload(self) -> NetworkMessage {
+    pub fn into_payload(self) -> NetworkMessage<Block> {
         self.payload
     }
 
     /// The actual message data
-    pub fn payload(&self) -> &NetworkMessage { &self.payload }
+    pub fn payload(&self) -> &NetworkMessage<Block> {
+        &self.payload
+    }
 
     /// Magic bytes to identify the network these messages are meant for
     pub fn magic(&self) -> &Magic { &self.magic }
@@ -348,7 +350,7 @@ impl<'a> Encodable for HeaderSerializationWrapper<'a> {
     }
 }
 
-impl Encodable for NetworkMessage {
+impl<Block: Encodable> Encodable for NetworkMessage<Block> {
     fn consensus_encode<W: Write + ?Sized>(&self, writer: &mut W) -> Result<usize, io::Error> {
         match self {
             NetworkMessage::Version(ref dat) => dat.consensus_encode(writer),
@@ -393,7 +395,7 @@ impl Encodable for NetworkMessage {
     }
 }
 
-impl Encodable for RawNetworkMessage {
+impl<Block: Encodable> Encodable for RawNetworkMessage<Block> {
     fn consensus_encode<W: Write + ?Sized>(&self, w: &mut W) -> Result<usize, io::Error> {
         let mut len = 0;
         len += self.magic.consensus_encode(w)?;
@@ -433,7 +435,7 @@ impl Decodable for HeaderDeserializationWrapper {
     }
 }
 
-impl Decodable for RawNetworkMessage {
+impl<Block: Decodable> Decodable for RawNetworkMessage<Block> {
     fn consensus_decode_from_finite_reader<R: Read + ?Sized>(
         r: &mut R,
     ) -> Result<Self, encode::Error> {
@@ -547,7 +549,7 @@ mod test {
     use hex::test_hex_unwrap as hex;
 
     use super::message_network::{Reject, RejectReason, VersionMessage};
-    use super::*;
+    use super::{block, AddrV2Message, Address, CommandString, Magic, MerkleBlock};
     use crate::bip152::BlockTransactionsRequest;
     use crate::blockdata::block::Block;
     use crate::blockdata::script::ScriptBuf;
@@ -562,7 +564,12 @@ mod test {
     };
     use crate::p2p::ServiceFlags;
 
-    fn hash(slice: [u8; 32]) -> Hash { Hash::from_slice(&slice).unwrap() }
+    type NetworkMessage = super::NetworkMessage<Block>;
+    type RawNetworkMessage = super::RawNetworkMessage<Block>;
+
+    fn hash(slice: [u8; 32]) -> Hash {
+        Hash::from_slice(&slice).unwrap()
+    }
 
     #[test]
     fn full_round_ser_der_raw_network_message_test() {
diff --git a/bitcoin/src/p2p/message_blockdata.rs b/bitcoin/src/p2p/message_blockdata.rs
index 83c1d153c..db74f397f 100644
--- a/bitcoin/src/p2p/message_blockdata.rs
+++ b/bitcoin/src/p2p/message_blockdata.rs
@@ -130,6 +130,10 @@ impl GetBlocksMessage {
     pub fn new(locator_hashes: Vec<BlockHash>, stop_hash: BlockHash) -> GetBlocksMessage {
         GetBlocksMessage { version: p2p::PROTOCOL_VERSION, locator_hashes, stop_hash }
     }
+    /// Set the version number.
+    pub fn with_version(self, version: u32) -> Self {
+        Self { version, ..self }
+    }
 }
 
 impl_consensus_encoding!(GetBlocksMessage, version, locator_hashes, stop_hash);
@@ -139,6 +143,10 @@ impl GetHeadersMessage {
     pub fn new(locator_hashes: Vec<BlockHash>, stop_hash: BlockHash) -> GetHeadersMessage {
         GetHeadersMessage { version: p2p::PROTOCOL_VERSION, locator_hashes, stop_hash }
     }
+    /// Set the version number.
+    pub fn with_version(self, version: u32) -> Self {
+        Self { version, ..self }
+    }
 }
 
 impl_consensus_encoding!(GetHeadersMessage, version, locator_hashes, stop_hash);
diff --git a/bitcoin/src/p2p/message_network.rs b/bitcoin/src/p2p/message_network.rs
index a3dbc409d..1cadc8347 100644
--- a/bitcoin/src/p2p/message_network.rs
+++ b/bitcoin/src/p2p/message_network.rs
@@ -73,6 +73,10 @@ impl VersionMessage {
             relay: false,
         }
     }
+    /// Set the version number.
+    pub fn with_version(self, version: u32) -> Self {
+        Self { version, ..self }
+    }
 }
 
 impl_consensus_encoding!(
diff --git a/fuzz/fuzz_targets/bitcoin/deser_net_msg.rs b/fuzz/fuzz_targets/bitcoin/deser_net_msg.rs
index 906bcee9f..f22b293ab 100644
--- a/fuzz/fuzz_targets/bitcoin/deser_net_msg.rs
+++ b/fuzz/fuzz_targets/bitcoin/deser_net_msg.rs
@@ -1,7 +1,7 @@
 use honggfuzz::fuzz;
 
 fn do_test(data: &[u8]) {
-    let _: Result<bitcoin::p2p::message::RawNetworkMessage, _> =
+    let _: Result<bitcoin::p2p::message::RawNetworkMessage<bitcoin::Block>, _> =
         bitcoin::consensus::encode::deserialize(data);
 }
 

From 90ac9b9769ed51b77fa924be3c64a502e370da3b Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Tue, 15 Jul 2025 10:13:22 +0200
Subject: [PATCH 44/53] feat(pow): add difficulty calculation for
 pre-digishield blocks (5,001-144,999) (#9)

[XC-431](https://dfinity.atlassian.net/browse/XC-431?atlOrigin=eyJpIjoiNGZlYzIwYTg0NmE2NGNhOWE2NmUxZTBiNTdjNzE2NGIiLCJwIjoiaiJ9):
This PR adds the correct difficulty calculation for pre-digishield
blocks (i.e. blocks 5,001-144,999). It follows the previous PR
https://github.com/dfinity/rust-dogecoin/pull/8 which added the logic
for block period 0-5,000.

The main change is the addition of the correct `min_timespan` for a
difficulty adjustment interval allowed for a given block height, as
defined by [dogecoin's difficulty adjustment
algorithm](https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/dogecoin.cpp#L57).
The relevant code can be found here:
https://github.com/dfinity/rust-dogecoin/commit/09daa88aba496392b049252ff87ed1cf1545ddb4#diff-874f3e7cfb3e02a8a906534570346fd48a5a58615069afa5a60ceaf4b9542d0eR471-R478

[XC-431]:
https://dfinity.atlassian.net/browse/XC-431?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
---
 bitcoin/src/dogecoin/mod.rs | 34 ++++++++++++++++++++--------------
 bitcoin/src/pow.rs          | 21 +++++++++++++++------
 2 files changed, 35 insertions(+), 20 deletions(-)

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index 03f46eede..c1da29305 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -354,7 +354,7 @@ mod tests {
         let start_time: u64 = 1386325540; // Genesis block unix time
         let end_time: u64 = 1386475638; // Block 239 unix time
         let timespan = end_time - start_time; // Slower than expected (150,098 seconds diff)
-        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params);
+        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, 240);
         let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -366,7 +366,7 @@ mod tests {
         let start_time: u64 = 1386475638; // Block 239 unix time
         let end_time: u64 = 1386475840; // Block 479 unix time
         let timespan = end_time - start_time; // Faster than expected (202 seconds diff)
-        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params);
+        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, 480);
         let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -386,7 +386,7 @@ mod tests {
             bits: epoch_start.bits,
             nonce: epoch_start.nonce
         };
-        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params);
+        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, 240);
         let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -415,7 +415,7 @@ mod tests {
             bits: starting_bits,
             nonce: 0
         };
-        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params);
+        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, 480);
         let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -423,25 +423,31 @@ mod tests {
     #[test]
     fn compact_target_from_maximum_upward_difficulty_adjustment() {
         let params = Params::new(Network::Dogecoin);
+        let heights = vec![5000, 10000, 15000];
         let starting_bits = CompactTarget::from_consensus(21403001); // Arbitrary difficulty
         let timespan = (0.06 * params.bitcoin_params.pow_target_timespan as f64) as u64; // > 16x Faster than expected
-        let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, params);
-        let want = Target::from_compact(starting_bits)
-            .min_transition_threshold_dogecoin(5000)
-            .to_compact_lossy();
-        assert_eq!(got, want);
+        for height in heights {
+            let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+            let want = Target::from_compact(starting_bits)
+                .min_transition_threshold_dogecoin(height)
+                .to_compact_lossy();
+            assert_eq!(got, want);
+        }
     }
 
     #[test]
     fn compact_target_from_minimum_downward_difficulty_adjustment() {
         let params = Params::new(Network::Dogecoin);
+        let heights = vec![5000, 10000, 15000];
         let starting_bits = CompactTarget::from_consensus(21403001); // Arbitrary difficulty
         let timespan =  5 * params.bitcoin_params.pow_target_timespan; // > 4x Slower than expected
-        let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params);
-        let want = Target::from_compact(starting_bits)
-            .max_transition_threshold(params)
-            .to_compact_lossy();
-        assert_eq!(got, want);
+        for height in heights {
+            let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+            let want = Target::from_compact(starting_bits)
+                .max_transition_threshold(&params)
+                .to_compact_lossy();
+            assert_eq!(got, want);
+        }
     }
 
     #[test]
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index 7cc1cd4f8..d7bf4b6fe 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -455,9 +455,10 @@ impl CompactTarget {
     /// ref: <https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/dogecoin.cpp>
     ///
     /// Given the previous Target, represented as a [`CompactTarget`], the difficulty is adjusted
-    /// by taking the timespan between them, and multipling the current [`CompactTarget`] by a factor
+    /// by taking the timespan between them, and multiplying the current [`CompactTarget`] by a factor
     /// of the net timespan and expected timespan. The [`CompactTarget`] may not increase by more than
-    /// a factor of 4, adjust beyond the maximum threshold for the network, or decrease... TODO
+    /// a factor of 4, adjust beyond the maximum threshold for the network, or decrease by a factor
+    /// of 16, 8, or 4 depending on block height.
     ///
     /// # Returns
     ///
@@ -465,7 +466,8 @@ impl CompactTarget {
     pub fn from_next_work_required_dogecoin(
         last: CompactTarget,
         timespan: u64,
-        params: impl AsRef<Params>
+        params: impl AsRef<Params>,
+        height: u32
     ) -> CompactTarget {
         let params = params.as_ref();
         if params.no_pow_retargeting { 
@@ -473,8 +475,14 @@ impl CompactTarget {
         }
         // Comments relate to the `pow.cpp` file from Core.
         // ref: <https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/dogecoin.cpp>
-        let min_timespan = params.pow_target_timespan >> 4; // Lines 64
-        let max_timespan = params.pow_target_timespan << 2; // Lines 65
+        let max_timespan = params.pow_target_timespan << 2;
+        let min_timespan = if height > 10000 { // Lines 57-66
+            params.pow_target_timespan >> 2
+        } else if height > 5000 {
+            params.pow_target_timespan >> 3
+        } else {
+            params.pow_target_timespan >> 4
+        };
         let actual_timespan = timespan.clamp(min_timespan, max_timespan); // Lines 69-72 nModulatedTimespan
         let prev_target: Target = last.into();
         let maximum_retarget = prev_target.max_transition_threshold(params); // bnPowLimit
@@ -544,10 +552,11 @@ impl CompactTarget {
         last_epoch_boundary: Header,
         current: Header,
         params: impl AsRef<Params>,
+        height: u32
     ) -> CompactTarget {
         let timespan = current.time - last_epoch_boundary.time;
         let bits = current.bits;
-        CompactTarget::from_next_work_required_dogecoin(bits, timespan.into(), params)
+        CompactTarget::from_next_work_required_dogecoin(bits, timespan.into(), params, height)
     }
 
     /// Creates a [`CompactTarget`] from a consensus encoded `u32`.

From 6849413fac9109b895aa1e85423c9154ab0d5c4b Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 21 Jul 2025 10:11:48 +0200
Subject: [PATCH 45/53] refactor(params): simpler and more consistent Dogecoin
 params (#12)

Changes to Dogecoin parameters, in preparation for DigiShield difficulty
adjustment PR https://github.com/dfinity/rust-dogecoin/pull/11:
- replace `struct Params` encapsulating `bitcoin_params` and
`dogecoin_params` into unified `Params` structure.
- change `timespan` and `pow_target_timespan` types from `u64` to `i64`.
The motivation is twofold: 1) [Dogecoin
core](https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/consensus/params.h#L67)
is using `int64_t` type throughout, 2) manipulating negative `timespan`
is easier and safer to handle, which is going to be the case when
switching to DigiShield where difficulty adjustment interval is only 1
block.
- change `pow_target_spacing` type from `u64` to `i64` for consistency
with Dogecoin.
---
 bitcoin/src/dogecoin/constants.rs |  2 +-
 bitcoin/src/dogecoin/mod.rs       | 48 +++++++++++-----------
 bitcoin/src/dogecoin/params.rs    | 67 ++++++++++++++++++-------------
 bitcoin/src/pow.rs                | 34 +++++++++++-----
 4 files changed, 88 insertions(+), 63 deletions(-)

diff --git a/bitcoin/src/dogecoin/constants.rs b/bitcoin/src/dogecoin/constants.rs
index 17649be4e..458fdadd7 100644
--- a/bitcoin/src/dogecoin/constants.rs
+++ b/bitcoin/src/dogecoin/constants.rs
@@ -81,7 +81,7 @@ pub fn genesis_block(params: impl AsRef<Params>) -> Block {
     let hash: sha256d::Hash = txdata[0].compute_txid().into();
     let merkle_root: TxMerkleNode = hash.into();
 
-    match params.dogecoin_params.network {
+    match params.network {
         Network::Dogecoin => Block {
             header: block::Header {
                 version: block::Version::ONE,
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index c1da29305..a71415f30 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -17,7 +17,6 @@ use crate::dogecoin::params::Params;
 use crate::internal_macros::impl_consensus_encoding;
 use crate::io::{Read, Write};
 use crate::p2p::Magic;
-use crate::params::Params as BitcoinParams;
 use crate::prelude::*;
 use crate::{io, BlockHash, Transaction};
 use core::fmt;
@@ -178,12 +177,6 @@ impl Network {
     }
 }
 
-impl AsRef<BitcoinParams> for Network {
-    fn as_ref(&self) -> &BitcoinParams {
-        &Self::params(*self).bitcoin_params
-    }
-}
-
 impl AsRef<Params> for Network {
     fn as_ref(&self) -> &Params {
         self.params()
@@ -337,7 +330,7 @@ mod tests {
             assert_eq!(serialize(&header.block_hash_with_scrypt()), test.output);
         }
     }
-    
+
     #[test]
     fn max_target_from_compact() {
         // The highest possible target in Dogecoin is defined as 0x1e0fffff
@@ -348,25 +341,27 @@ mod tests {
     }
 
     #[test]
-    fn compact_target_from_upwards_difficulty_adjustment() {
+    fn compact_target_from_downwards_difficulty_adjustment() {
+        let height = 240;
         let params = Params::new(Network::Dogecoin);
         let starting_bits = CompactTarget::from_consensus(0x1e0ffff0); // Genesis compact target on Mainnet
-        let start_time: u64 = 1386325540; // Genesis block unix time
-        let end_time: u64 = 1386475638; // Block 239 unix time
+        let start_time: i64 = 1386325540; // Genesis block unix time
+        let end_time: i64 = 1386475638; // Block 239 unix time
         let timespan = end_time - start_time; // Slower than expected (150,098 seconds diff)
-        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, 240);
+        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
         let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
 
     #[test]
-    fn compact_target_from_downwards_difficulty_adjustment() {
+    fn compact_target_from_upwards_difficulty_adjustment() {
+        let height = 480;
         let params = Params::new(Network::Dogecoin);
         let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
-        let start_time: u64 = 1386475638; // Block 239 unix time
-        let end_time: u64 = 1386475840; // Block 479 unix time
+        let start_time: i64 = 1386475638; // Block 239 unix time
+        let end_time: i64 = 1386475840; // Block 479 unix time
         let timespan = end_time - start_time; // Faster than expected (202 seconds diff)
-        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, 480);
+        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
         let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -375,6 +370,8 @@ mod tests {
     fn compact_target_from_downwards_difficulty_adjustment_using_headers() {
         use crate::{block::Version, dogecoin::constants::genesis_block, TxMerkleNode};
         use hashes::Hash;
+
+        let height = 240;
         let params = Params::new(Network::Dogecoin);
         let epoch_start = genesis_block(&params).header;
         // Block 239, the only information used are `bits` and `time`
@@ -386,7 +383,7 @@ mod tests {
             bits: epoch_start.bits,
             nonce: epoch_start.nonce
         };
-        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, 240);
+        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
         let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -395,6 +392,8 @@ mod tests {
     fn compact_target_from_upwards_difficulty_adjustment_using_headers() {
         use crate::{block::Version, TxMerkleNode};
         use hashes::Hash;
+
+        let height = 480;
         let params = Params::new(Network::Dogecoin);
         let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 479 compact target
         // Block 239, the only information used is `time`
@@ -415,7 +414,7 @@ mod tests {
             bits: starting_bits,
             nonce: 0
         };
-        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, 480);
+        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
         let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
         assert_eq!(adjustment, adjustment_bits);
     }
@@ -425,7 +424,7 @@ mod tests {
         let params = Params::new(Network::Dogecoin);
         let heights = vec![5000, 10000, 15000];
         let starting_bits = CompactTarget::from_consensus(21403001); // Arbitrary difficulty
-        let timespan = (0.06 * params.bitcoin_params.pow_target_timespan as f64) as u64; // > 16x Faster than expected
+        let timespan = (0.06 * params.pow_target_timespan as f64) as i64; // > 16x Faster than expected
         for height in heights {
             let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
             let want = Target::from_compact(starting_bits)
@@ -440,11 +439,11 @@ mod tests {
         let params = Params::new(Network::Dogecoin);
         let heights = vec![5000, 10000, 15000];
         let starting_bits = CompactTarget::from_consensus(21403001); // Arbitrary difficulty
-        let timespan =  5 * params.bitcoin_params.pow_target_timespan; // > 4x Slower than expected
+        let timespan =  5 * params.pow_target_timespan; // > 4x Slower than expected
         for height in heights {
             let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
             let want = Target::from_compact(starting_bits)
-                .max_transition_threshold(&params)
+                .max_transition_threshold_dogecoin(&params)
                 .to_compact_lossy();
             assert_eq!(got, want);
         }
@@ -452,11 +451,12 @@ mod tests {
 
     #[test]
     fn compact_target_from_adjustment_is_max_target() {
+        let height = 480;
         let params = Params::new(Network::Dogecoin);
         let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target (max target)
-        let timespan =  5 * params.bitcoin_params.pow_target_timespan; // > 4x Slower than expected
-        let got = CompactTarget::from_next_work_required(starting_bits, timespan, &params);
-        let want = params.bitcoin_params.max_attainable_target.to_compact_lossy();
+        let timespan =  4 * params.pow_target_timespan; // 4x Slower than expected
+        let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+        let want = params.max_attainable_target.to_compact_lossy();
         assert_eq!(got, want);
     }
 
diff --git a/bitcoin/src/dogecoin/params.rs b/bitcoin/src/dogecoin/params.rs
index 78e9ab044..fc71e9fd1 100644
--- a/bitcoin/src/dogecoin/params.rs
+++ b/bitcoin/src/dogecoin/params.rs
@@ -7,25 +7,49 @@
 //!
 
 use crate::dogecoin::Network;
-use crate::network::Network as BitcoinNetwork;
-use crate::params::Params as BitcoinParams;
 use crate::Target;
 
 /// Parameters that influence chain consensus.
-#[derive(Debug, Clone)]
-pub struct Params {
-    /// Parameters inherited from Bitcoin, reused for Dogecoin consensus.
-    pub bitcoin_params: BitcoinParams,
-    /// Parameters that are not inherited from Bitcoin.
-    pub dogecoin_params: DogecoinParams,
-}
-
-/// Dogecoin-specific consensus parameters.
 #[non_exhaustive]
 #[derive(Debug, Clone)]
-pub struct DogecoinParams {
+pub struct Params {
     /// Network for which parameters are valid.
     pub network: Network,
+    /// Time when BIP16 becomes active.
+    pub bip16_time: u32,
+    /// Block height at which BIP34 becomes active.
+    pub bip34_height: u32,
+    /// Block height at which BIP65 becomes active.
+    pub bip65_height: u32,
+    /// Block height at which BIP66 becomes active.
+    pub bip66_height: u32,
+    /// Minimum blocks including miner confirmation.
+    pub rule_change_activation_threshold: u32,
+    /// Number of blocks with the same set of rules.
+    pub miner_confirmation_window: u32,
+    /// Proof of work limit value. It contains the lowest possible difficulty.
+    #[deprecated(since = "0.32.0", note = "field renamed to max_attainable_target")]
+    pub pow_limit: Target,
+    /// The maximum **attainable** target value for these params.
+    ///
+    /// Not all target values are attainable because consensus code uses the compact format to
+    /// represent targets (see [`crate::CompactTarget`]).
+    ///
+    /// Note that this value differs from Dogecoin Core's powLimit field in that this value is
+    /// attainable, but Dogecoin Core's is not. Specifically, because targets in Bitcoin are always
+    /// rounded to the nearest float expressible in "compact form", not all targets are attainable.
+    /// Still, this should not affect consensus as the only place where the non-compact form of
+    /// this is used in Dogecoin Core's consensus algorithm is in comparison and there are no
+    /// compact-expressible values between Dogecoin Core's and the limit expressed here.
+    pub max_attainable_target: Target,
+    /// Expected amount of time to mine one block.
+    pub pow_target_spacing: i64,
+    /// Difficulty recalculation interval.
+    pub pow_target_timespan: i64,
+    /// Determines whether minimal difficulty may be used for blocks or not.
+    pub allow_min_difficulty_blocks: bool,
+    /// Determines whether retargeting is disabled for this network or not.
+    pub no_pow_retargeting: bool,
 }
 
 /// The mainnet parameters.
@@ -47,8 +71,7 @@ impl Params {
 
     /// The mainnet parameters.
     pub const MAINNET: Params = Params {
-        bitcoin_params: BitcoinParams {
-            network: BitcoinNetwork::Bitcoin,
+            network: Network::Dogecoin,
             bip16_time: 1333238400,                 // Apr 1 2012
             bip34_height: 1034383, // 80d1364201e5df97e696c03bdd24dc885e8617b9de51e453c10a4f629b1e797a
             bip65_height: 3464751, // 34cd2cbba4ba366f47e5aa0db5f02c19eba2adf679ceb6653ac003bdc9a0ef1f
@@ -61,14 +84,11 @@ impl Params {
             pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
             allow_min_difficulty_blocks: false,
             no_pow_retargeting: false,
-        },
-        dogecoin_params: DogecoinParams { network: Network::Dogecoin },
     };
 
     /// The Dogecoin testnet parameters.
     pub const TESTNET: Params = Params {
-        bitcoin_params: BitcoinParams {
-            network: BitcoinNetwork::Testnet,
+            network: Network::Testnet,
             bip16_time: 1333238400,                 // Apr 1 2012
             bip34_height: 708658, // 21b8b97dcdb94caa67c7f8f6dbf22e61e0cfe0e46e1fff3528b22864659e9b38
             bip65_height: 1854705, // 955bd496d23790aba1ecfacb722b089a6ae7ddabaedf7d8fb0878f48308a71f9
@@ -81,14 +101,11 @@ impl Params {
             pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
             allow_min_difficulty_blocks: true,
             no_pow_retargeting: false,
-        },
-        dogecoin_params: DogecoinParams { network: Network::Testnet },
     };
 
     /// The Dogecoin regtest parameters.
     pub const REGTEST: Params = Params {
-        bitcoin_params: BitcoinParams {
-            network: BitcoinNetwork::Regtest,
+            network: Network::Regtest,
             bip16_time: 1333238400,  // Apr 1 2012
             bip34_height: 100000000, // not activated on regtest
             bip65_height: 1351,
@@ -101,8 +118,6 @@ impl Params {
             pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
             allow_min_difficulty_blocks: true,
             no_pow_retargeting: true,
-        },
-        dogecoin_params: DogecoinParams { network: Network::Regtest },
     };
 
     /// Creates parameters set for the given network.
@@ -115,10 +130,6 @@ impl Params {
     }
 }
 
-impl AsRef<BitcoinParams> for Params {
-    fn as_ref(&self) -> &BitcoinParams { &self.bitcoin_params }
-}
-
 impl AsRef<Params> for Params {
     fn as_ref(&self) -> &Params { self }
 }
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index d7bf4b6fe..18bb2f83d 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -19,6 +19,7 @@ use crate::block::Header;
 use crate::blockdata::block::BlockHash;
 use crate::consensus::encode::{self, Decodable, Encodable};
 use crate::consensus::Params;
+use crate::dogecoin::params::Params as DogecoinParams;
 use crate::error::{ContainsPrefixError, MissingPrefixError, ParseIntError, PrefixedHexError, UnprefixedHexError};
 
 /// Implement traits and methods shared by `Target` and `Work`.
@@ -306,7 +307,7 @@ impl Target {
     }
 
     /// Computes the minimum valid [`Target`] threshold allowed for a block in which a difficulty
-    /// adjustment occurs.
+    /// adjustment occurs for Bitcoin.
     ///
     /// The difficulty can only decrease or increase by a factor of 4 max on each difficulty
     /// adjustment period.
@@ -317,7 +318,7 @@ impl Target {
     pub fn min_transition_threshold(&self) -> Self { Self(self.0 >> 2) }
 
     /// Computes the minimum valid [`Target`] threshold allowed for a block in which a difficulty
-    /// adjustment occurs.
+    /// adjustment occurs for Dogecoin.
     ///
     /// The difficulty can only decrease by a factor of 4, 8, or 16 max on each difficulty
     /// adjustment period, depending on the height.
@@ -338,7 +339,7 @@ impl Target {
     }
 
     /// Computes the maximum valid [`Target`] threshold allowed for a block in which a difficulty
-    /// adjustment occurs.
+    /// adjustment occurs for Bitcoin.
     ///
     /// The difficulty can only decrease or increase by a factor of 4 max on each difficulty
     /// adjustment period.
@@ -350,6 +351,19 @@ impl Target {
         cmp::min(self.max_transition_threshold_unchecked(), max_attainable)
     }
 
+    /// Computes the maximum valid [`Target`] threshold allowed for a block in which a difficulty
+    /// adjustment occurs for Dogecoin.
+    ///
+    /// The difficulty can only decrease or increase by a factor of 4 max on each difficulty
+    /// adjustment period.
+    ///
+    /// We also check that the calculated target is not greater than the maximum allowed target,
+    /// this value is network specific - hence the `params` parameter.
+    pub fn max_transition_threshold_dogecoin(&self, params: impl AsRef<DogecoinParams>) -> Self {
+        let max_attainable = params.as_ref().max_attainable_target;
+        cmp::min(self.max_transition_threshold_unchecked(), max_attainable)
+    }
+
     /// Computes the maximum valid [`Target`] threshold allowed for a block in which a difficulty
     /// adjustment occurs.
     ///
@@ -465,12 +479,12 @@ impl CompactTarget {
     /// The expected [`CompactTarget`] recalculation.
     pub fn from_next_work_required_dogecoin(
         last: CompactTarget,
-        timespan: u64,
-        params: impl AsRef<Params>,
+        timespan: i64,
+        params: impl AsRef<DogecoinParams>,
         height: u32
     ) -> CompactTarget {
         let params = params.as_ref();
-        if params.no_pow_retargeting { 
+        if params.no_pow_retargeting {
             return last;
         }
         // Comments relate to the `pow.cpp` file from Core.
@@ -485,10 +499,10 @@ impl CompactTarget {
         };
         let actual_timespan = timespan.clamp(min_timespan, max_timespan); // Lines 69-72 nModulatedTimespan
         let prev_target: Target = last.into();
-        let maximum_retarget = prev_target.max_transition_threshold(params); // bnPowLimit
+        let maximum_retarget = prev_target.max_transition_threshold_dogecoin(params); // bnPowLimit
         let retarget = prev_target.0; // bnNew
-        let retarget = retarget.mul(actual_timespan.into());
-        let retarget = retarget.div(params.pow_target_timespan.into());
+        let retarget = retarget.mul((actual_timespan as u64).into()); // Line 80
+        let retarget = retarget.div((params.pow_target_timespan as u64).into()); // Line 81
         let retarget = Target(retarget);
         if retarget.ge(&maximum_retarget) {
             return maximum_retarget.to_compact_lossy();
@@ -551,7 +565,7 @@ impl CompactTarget {
     pub fn from_header_difficulty_adjustment_dogecoin(
         last_epoch_boundary: Header,
         current: Header,
-        params: impl AsRef<Params>,
+        params: impl AsRef<DogecoinParams>,
         height: u32
     ) -> CompactTarget {
         let timespan = current.time - last_epoch_boundary.time;

From 5d203f94005955ff7651e0309620af4d856f51a7 Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 4 Aug 2025 10:05:42 +0200
Subject: [PATCH 46/53] feat(pow): add digishield difficulty adjustment
 algorithm (#13)

[XC-434](https://dfinity.atlassian.net/browse/XC-434?atlOrigin=eyJpIjoiZjk1YjYwOGE4MDgxNDFkZjg2YTQ5NWU2NTZmMDlhMmIiLCJwIjoiaiJ9):
Adds digishield difficulty adjustment algorithm. Ref:
https://github.com/dogecoin/dogecoin/blob/2c513d0172e8bc86fe9a337693b26f2fdf68a013/src/dogecoin.cpp#L51

[XC-434]:
https://dfinity.atlassian.net/browse/XC-434?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
---
 bitcoin/src/dogecoin/mod.rs    | 126 ++++++++++++++++++++++++++++++---
 bitcoin/src/dogecoin/params.rs |  89 +++++++++++++++++++----
 bitcoin/src/pow.rs             |  67 +++++++++++-------
 3 files changed, 234 insertions(+), 48 deletions(-)

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index a71415f30..5f5256d14 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -353,6 +353,19 @@ mod tests {
         assert_eq!(adjustment, adjustment_bits);
     }
 
+    #[test]
+    fn compact_target_from_downards_difficulty_adjustment_digishield() {
+        let height = 1531886;
+        let params = Params::new(Network::Dogecoin);
+        let starting_bits = CompactTarget::from_consensus(0x1b01c45a); // Block 1_531_885 compact target
+        let start_time: i64 = 1483302792; // Block 1_531_884 unix time
+        let end_time: i64 = 1483302869; // Block 1_531_885 unix time
+        let timespan = end_time - start_time; // Slower than expected (77 seconds diff)
+        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+        let adjustment_bits = CompactTarget::from_consensus(0x1b01d36e); // Block 1_531_886 compact target
+        assert_eq!(adjustment, adjustment_bits);
+    }
+
     #[test]
     fn compact_target_from_upwards_difficulty_adjustment() {
         let height = 480;
@@ -366,6 +379,19 @@ mod tests {
         assert_eq!(adjustment, adjustment_bits);
     }
 
+    #[test]
+    fn compact_target_from_upwards_difficulty_adjustment_digishield() {
+        let height = 1531882;
+        let params = Params::new(Network::Dogecoin);
+        let starting_bits = CompactTarget::from_consensus(0x1b01dc29); // Block 1_531_881 compact target
+        let start_time: i64 = 1483302572; // Block 1_531_880 unix time
+        let end_time: i64 = 1483302608; // Block 1_531_881 unix time
+        let timespan = end_time - start_time; // Faster than expected (36 seconds diff)
+        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+        let adjustment_bits = CompactTarget::from_consensus(0x1b01c45a); // Block 1_531_882 compact target
+        assert_eq!(adjustment, adjustment_bits);
+    }
+
     #[test]
     fn compact_target_from_downwards_difficulty_adjustment_using_headers() {
         use crate::{block::Version, dogecoin::constants::genesis_block, TxMerkleNode};
@@ -388,6 +414,36 @@ mod tests {
         assert_eq!(adjustment, adjustment_bits);
     }
 
+    #[test]
+    fn compact_target_from_downwards_difficulty_adjustment_using_headers_digishield() {
+        use crate::{block::Version, TxMerkleNode};
+        use std::str::FromStr;
+
+        let height = 1_131_290;
+        let params = Params::new(Network::Dogecoin);
+        // Block 1_131_288, the only information used is `time`
+        let epoch_start = Header {
+            version: Version::from_consensus(6422787),
+            prev_blockhash: BlockHash::from_str("ac0ffad025605732b310be7edf52111fa9511ffc54f06d21aab1c50d4085b39f").expect("failed to parse block hash"),
+            merkle_root: TxMerkleNode::from_str("80c67973ef43f2df8a3641dac7da16ea59f55e4d77b9206c6e5cfa25d3bf094b").expect("failed to parse merkle root"),
+            time: 1458248044,
+            bits: CompactTarget::from_consensus(0x1b01e7c1),
+            nonce: 0
+        };
+        // Block 1_131_289, the only information used are `bits` and `time`
+        let current = Header {
+            version: Version::from_consensus(6422787),
+            prev_blockhash: BlockHash::from_str("7724f7b3f9652ebc121ce101a10bfabd6815518b2814bd16f7a2dcc13dd121ec").expect("failed to parse block hash"),
+            merkle_root: TxMerkleNode::from_str("33c13df68d2f74c76367659cc95436510ed5504ef3c53ae90679ec12ab4e8b81").expect("failed to parse merkle root"),
+            time: 1458248269,
+            bits: CompactTarget::from_consensus(0x1b01cf5d),
+            nonce: 0
+        };
+        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
+        let adjustment_bits = CompactTarget::from_consensus(0x1b0269d1); // Block 1_131_290 compact target
+        assert_eq!(adjustment, adjustment_bits);
+    }
+
     #[test]
     fn compact_target_from_upwards_difficulty_adjustment_using_headers() {
         use crate::{block::Version, TxMerkleNode};
@@ -419,16 +475,55 @@ mod tests {
         assert_eq!(adjustment, adjustment_bits);
     }
 
+    #[test]
+    fn compact_target_from_upwards_difficulty_adjustment_using_headers_digishield() {
+        use crate::{block::Version, TxMerkleNode};
+        use std::str::FromStr;
+
+        let height = 1_131_286;
+        let params = Params::new(Network::Dogecoin);
+        // Block 1_131_284, the only information used is `time`
+        let epoch_start = Header {
+            version: Version::from_consensus(6422787),
+            prev_blockhash: BlockHash::from_str("a695a2cc43bd5c5f32acecada764b8764b044f067909b997d4f98a6733c3fa70").expect("failed to parse block hash"),
+            merkle_root: TxMerkleNode::from_str("806736d9e0cab2de97e7afc9f2031c5a0413c0bff00d82cc38fa0d568d2f7135").expect("failed to parse merkle root"),
+            time: 1458247987,
+            bits: CompactTarget::from_consensus(0x1b02f5b6),
+            nonce: 0
+        };
+        // Block 1_131_285, the only information used are `bits` and `time`
+        let current = Header {
+            version: Version::from_consensus(6422787),
+            prev_blockhash: BlockHash::from_str("db185a7d97060e13dd53ff759f9280d473d7bb6fccc8883fbc8f1fa1f071fc82").expect("failed to parse block hash"),
+            merkle_root: TxMerkleNode::from_str("20419a4d74c0284e241ca5d3c91ea2b533d8a6502e4b6e4a7f8a2fc50d42796e").expect("failed to parse merkle root"),
+            time: 1458247995,
+            bits: CompactTarget::from_consensus(0x1b029d4f),
+            nonce: 0
+        };
+        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
+        let adjustment_bits = CompactTarget::from_consensus(0x1b025a60); // Block 1_131_286 compact target
+        assert_eq!(adjustment, adjustment_bits);
+    }
+
     #[test]
     fn compact_target_from_maximum_upward_difficulty_adjustment() {
+        let pre_digishield_heights = vec![5_000, 10_000, 15_000];
+        let digishield_heights = vec![145_000, 1_000_000];
+        let starting_bits = CompactTarget::from_consensus(0x1b025a60); // Arbitrary difficulty
         let params = Params::new(Network::Dogecoin);
-        let heights = vec![5000, 10000, 15000];
-        let starting_bits = CompactTarget::from_consensus(21403001); // Arbitrary difficulty
-        let timespan = (0.06 * params.pow_target_timespan as f64) as i64; // > 16x Faster than expected
-        for height in heights {
+        for height in pre_digishield_heights {
+            let timespan = (0.06 * params.pow_target_timespan(height) as f64) as i64; // > 16x Faster than expected
+            let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+            let want = Target::from_compact(starting_bits)
+                .min_transition_threshold_dogecoin(&params, height)
+                .to_compact_lossy();
+            assert_eq!(got, want);
+        }
+        for height in digishield_heights {
+            let timespan = -params.pow_target_timespan(height); // Negative timespan
             let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
             let want = Target::from_compact(starting_bits)
-                .min_transition_threshold_dogecoin(height)
+                .min_transition_threshold_dogecoin(&params, height)
                 .to_compact_lossy();
             assert_eq!(got, want);
         }
@@ -436,14 +531,23 @@ mod tests {
 
     #[test]
     fn compact_target_from_minimum_downward_difficulty_adjustment() {
+        let pre_digishield_heights = vec![5_000, 10_000, 15_000];
+        let digishield_heights = vec![145_000, 1_000_000];
+        let starting_bits = CompactTarget::from_consensus(0x1b02f5b6); // Arbitrary difficulty
         let params = Params::new(Network::Dogecoin);
-        let heights = vec![5000, 10000, 15000];
-        let starting_bits = CompactTarget::from_consensus(21403001); // Arbitrary difficulty
-        let timespan =  5 * params.pow_target_timespan; // > 4x Slower than expected
-        for height in heights {
+        for height in pre_digishield_heights {
+            let timespan =  4 * params.pow_target_timespan(height); // 4x Slower than expected
+            let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+            let want = Target::from_compact(starting_bits)
+                .max_transition_threshold_dogecoin(&params, height)
+                .to_compact_lossy();
+            assert_eq!(got, want);
+        }
+        for height in digishield_heights {
+            let timespan = 5 * params.pow_target_timespan(height); // 5x Slower than expected
             let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
             let want = Target::from_compact(starting_bits)
-                .max_transition_threshold_dogecoin(&params)
+                .max_transition_threshold_dogecoin(&params, height)
                 .to_compact_lossy();
             assert_eq!(got, want);
         }
@@ -454,7 +558,7 @@ mod tests {
         let height = 480;
         let params = Params::new(Network::Dogecoin);
         let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target (max target)
-        let timespan =  4 * params.pow_target_timespan; // 4x Slower than expected
+        let timespan =  4 * params.pow_target_timespan(height); // 4x Slower than expected
         let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
         let want = params.max_attainable_target.to_compact_lossy();
         assert_eq!(got, want);
diff --git a/bitcoin/src/dogecoin/params.rs b/bitcoin/src/dogecoin/params.rs
index fc71e9fd1..284116715 100644
--- a/bitcoin/src/dogecoin/params.rs
+++ b/bitcoin/src/dogecoin/params.rs
@@ -9,6 +9,11 @@
 use crate::dogecoin::Network;
 use crate::Target;
 
+
+const ONE_SECOND: i64 = 1;
+const ONE_MINUTE: i64 = 60;
+const FOUR_HOURS: i64 = 4 * 60 * 60;
+
 /// Parameters that influence chain consensus.
 #[non_exhaustive]
 #[derive(Debug, Clone)]
@@ -44,12 +49,10 @@ pub struct Params {
     pub max_attainable_target: Target,
     /// Expected amount of time to mine one block.
     pub pow_target_spacing: i64,
-    /// Difficulty recalculation interval.
-    pub pow_target_timespan: i64,
-    /// Determines whether minimal difficulty may be used for blocks or not.
-    pub allow_min_difficulty_blocks: bool,
     /// Determines whether retargeting is disabled for this network or not.
     pub no_pow_retargeting: bool,
+    /// Height after which the Digishield difficulty adjustment algorithm is used.
+    pub digishield_activation_height: u32,
 }
 
 /// The mainnet parameters.
@@ -70,6 +73,7 @@ impl Params {
     pub const DOGECOIN: Params = Params::MAINNET;
 
     /// The mainnet parameters.
+    /// Ref: <https://github.com/dogecoin/dogecoin/blob/2c513d0172e8bc86fe9a337693b26f2fdf68a013/src/chainparams.cpp#L75>
     pub const MAINNET: Params = Params {
             network: Network::Dogecoin,
             bip16_time: 1333238400,                 // Apr 1 2012
@@ -80,13 +84,13 @@ impl Params {
             miner_confirmation_window: 10080, // 60 * 24 * 7 = 10,080 blocks, or one week
             pow_limit: Target::MAX_ATTAINABLE_MAINNET_DOGE,
             max_attainable_target: Target::MAX_ATTAINABLE_MAINNET_DOGE,
-            pow_target_spacing: 60,           // 1 minute
-            pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
-            allow_min_difficulty_blocks: false,
+            pow_target_spacing: ONE_MINUTE,           // 1 minute
             no_pow_retargeting: false,
+            digishield_activation_height: 145000,
     };
 
     /// The Dogecoin testnet parameters.
+    /// Ref: <https://github.com/dogecoin/dogecoin/blob/2c513d0172e8bc86fe9a337693b26f2fdf68a013/src/chainparams.cpp#L229>
     pub const TESTNET: Params = Params {
             network: Network::Testnet,
             bip16_time: 1333238400,                 // Apr 1 2012
@@ -97,13 +101,13 @@ impl Params {
             miner_confirmation_window: 10080,       // 60 * 24 * 7 = 10,080 blocks, or one week
             pow_limit: Target::MAX_ATTAINABLE_TESTNET_DOGE,
             max_attainable_target: Target::MAX_ATTAINABLE_TESTNET_DOGE,
-            pow_target_spacing: 60,           // 1 minute
-            pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
-            allow_min_difficulty_blocks: true,
+            pow_target_spacing: ONE_MINUTE,           // 1 minute
             no_pow_retargeting: false,
+            digishield_activation_height: 145000,
     };
 
     /// The Dogecoin regtest parameters.
+    /// Ref: <https://github.com/dogecoin/dogecoin/blob/2c513d0172e8bc86fe9a337693b26f2fdf68a013/src/chainparams.cpp#L382>
     pub const REGTEST: Params = Params {
             network: Network::Regtest,
             bip16_time: 1333238400,  // Apr 1 2012
@@ -114,10 +118,9 @@ impl Params {
             miner_confirmation_window: 720,
             pow_limit: Target::MAX_ATTAINABLE_REGTEST_DOGE,
             max_attainable_target: Target::MAX_ATTAINABLE_REGTEST_DOGE,
-            pow_target_spacing: 1,            // regtest: 1 second blocks
-            pow_target_timespan: 4 * 60 * 60, // pre-digishield: 4 hours
-            allow_min_difficulty_blocks: true,
+            pow_target_spacing: ONE_SECOND,            // regtest: 1 second blocks
             no_pow_retargeting: true,
+            digishield_activation_height: 10,
     };
 
     /// Creates parameters set for the given network.
@@ -128,8 +131,68 @@ impl Params {
             Network::Regtest => Params::REGTEST,
         }
     }
+
+    /// Checks if Digishield difficulty adjustment is activated at the given block height.
+    pub const fn is_digishield_activated(&self, height: u32) -> bool {
+         height >= self.digishield_activation_height
+    }
+
+    /// Returns the target timespan (in seconds) used for PoW retargeting at the given block height.
+    pub const fn pow_target_timespan(&self, height: u32) -> i64 {
+        if !self.is_digishield_activated(height) {
+            FOUR_HOURS
+        } else {
+            match self.network {
+                Network::Dogecoin => ONE_MINUTE,
+                Network::Testnet => ONE_MINUTE,
+                Network::Regtest => ONE_SECOND,
+            }
+        }
+    }
+
+    /// Determines whether minimal difficulty may be used for mining blocks.
+    pub const fn allow_min_difficulty_blocks(&self, height: u32) -> bool {
+        match self.network {
+            Network::Dogecoin => false,
+            Network::Testnet => match height {
+                0..=144_999 => true,
+                145_000..=157_499 => false,
+                157_500.. => true,
+            }
+            Network::Regtest => true,
+        }
+    }
 }
 
 impl AsRef<Params> for Params {
     fn as_ref(&self) -> &Params { self }
 }
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn digishield_activation() {
+        let pre_digishield_heights = [5_000, 10_000, 144_999];
+        let digishield_heights = [145_000, 145_001, 1_000_000];
+        let params = [Params::MAINNET, Params::TESTNET];
+        for param in params {
+            for &height in pre_digishield_heights.iter() {
+                assert!(!param.is_digishield_activated(height));
+            }
+            for &height in digishield_heights.iter() {
+                assert!(param.is_digishield_activated(height));
+            }
+        }
+
+        let pre_digishield_heights_regtest = [0, 5, 9];
+        let digishield_heights_regtest = [10, 11, 100];
+        for &height in pre_digishield_heights_regtest.iter() {
+            assert!(!Params::REGTEST.is_digishield_activated(height));
+        }
+        for &height in digishield_heights_regtest.iter() {
+            assert!(Params::REGTEST.is_digishield_activated(height));
+        }
+    }
+}
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index 18bb2f83d..962bb4203 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -320,21 +320,25 @@ impl Target {
     /// Computes the minimum valid [`Target`] threshold allowed for a block in which a difficulty
     /// adjustment occurs for Dogecoin.
     ///
-    /// The difficulty can only decrease by a factor of 4, 8, or 16 max on each difficulty
-    /// adjustment period, depending on the height.
+    /// Pre-Digishield: The target can only decrease by a factor of 4, 8, or 16 max in each
+    /// difficulty adjustment period, depending on the height.
+    ///
+    /// Digishield: The target can decrease by 25 % max of the previous target in one adjustment.
     /// 
-    /// ref: <https://github.com/dogecoin/dogecoin/blob/2c513d0172e8bc86fe9a337693b26f2fdf68a013/src/dogecoin.cpp#L57-L66>
+    /// ref: <https://github.com/dogecoin/dogecoin/blob/2c513d0172e8bc86fe9a337693b26f2fdf68a013/src/dogecoin.cpp#L50-L66>
     ///
     /// # Returns
     ///
     /// In line with Dogecoin Core this function may return a target value of zero.
-    pub fn min_transition_threshold_dogecoin(&self, height: u32) -> Self {
-        if height > 10000 {
-            Self(self.0 >> 2)
-        } else if height > 5000 {
-            Self(self.0 >> 3)
+    pub fn min_transition_threshold_dogecoin(&self, params: impl AsRef<DogecoinParams>, height: u32) -> Self {
+        if params.as_ref().is_digishield_activated(height) {
+            Self(self.0 - (self.0 >> 2))
         } else {
-            Self(self.0 >> 4)
+            match height {
+                0..=5_000 => Self(self.0 >> 4),
+                5_001..=10_000 => Self(self.0 >> 3),
+                _ => Self(self.0 >> 2),
+            }
         }
     }
 
@@ -354,14 +358,20 @@ impl Target {
     /// Computes the maximum valid [`Target`] threshold allowed for a block in which a difficulty
     /// adjustment occurs for Dogecoin.
     ///
-    /// The difficulty can only decrease or increase by a factor of 4 max on each difficulty
+    /// Pre-Digishield: The target can only increase by a factor of 4 max in each difficulty
     /// adjustment period.
     ///
+    /// Digishield: The target can increase by 50 % max of the previous target in one adjustment.
+    ///
     /// We also check that the calculated target is not greater than the maximum allowed target,
     /// this value is network specific - hence the `params` parameter.
-    pub fn max_transition_threshold_dogecoin(&self, params: impl AsRef<DogecoinParams>) -> Self {
+    pub fn max_transition_threshold_dogecoin(&self, params: impl AsRef<DogecoinParams>, height: u32) -> Self {
         let max_attainable = params.as_ref().max_attainable_target;
-        cmp::min(self.max_transition_threshold_unchecked(), max_attainable)
+        if params.as_ref().is_digishield_activated(height) {
+            cmp::min(Self(self.0 + (self.0 >> 1)), max_attainable)
+        } else {
+            cmp::min(self.max_transition_threshold_unchecked(), max_attainable)
+        }
     }
 
     /// Computes the maximum valid [`Target`] threshold allowed for a block in which a difficulty
@@ -489,20 +499,29 @@ impl CompactTarget {
         }
         // Comments relate to the `pow.cpp` file from Core.
         // ref: <https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/dogecoin.cpp>
-        let max_timespan = params.pow_target_timespan << 2;
-        let min_timespan = if height > 10000 { // Lines 57-66
-            params.pow_target_timespan >> 2
-        } else if height > 5000 {
-            params.pow_target_timespan >> 3
-        } else {
-            params.pow_target_timespan >> 4
-        };
-        let actual_timespan = timespan.clamp(min_timespan, max_timespan); // Lines 69-72 nModulatedTimespan
+        let retarget_timespan = params.pow_target_timespan(height); // Line 44
+        let mut modulated_timespan = timespan; // Lines 45-46
+        if params.is_digishield_activated(height) { // Lines 50-56
+            modulated_timespan = retarget_timespan + (modulated_timespan - retarget_timespan) / 8; // Line 53
+            let (min_timespan, max_timespan) = (
+                retarget_timespan - (retarget_timespan >> 2),
+                retarget_timespan + (retarget_timespan >> 1),
+            );
+            modulated_timespan = modulated_timespan.clamp(min_timespan, max_timespan); // Lines 69-72
+        } else { // Lines 57-66
+            let max_timespan = retarget_timespan << 2;
+            let min_timespan = match height {
+                0..=5_000 => retarget_timespan >> 4,
+                5_001..=10_000 => retarget_timespan >> 3,
+                _ => retarget_timespan >> 2,
+            };
+            modulated_timespan = modulated_timespan.clamp(min_timespan, max_timespan); // Lines 69-72
+        }
         let prev_target: Target = last.into();
-        let maximum_retarget = prev_target.max_transition_threshold_dogecoin(params); // bnPowLimit
+        let maximum_retarget = prev_target.max_transition_threshold_dogecoin(params, height); // bnPowLimit
         let retarget = prev_target.0; // bnNew
-        let retarget = retarget.mul((actual_timespan as u64).into()); // Line 80
-        let retarget = retarget.div((params.pow_target_timespan as u64).into()); // Line 81
+        let retarget = retarget.mul((modulated_timespan as u64).into()); // Line 80
+        let retarget = retarget.div((retarget_timespan as u64).into()); // Line 81
         let retarget = Target(retarget);
         if retarget.ge(&maximum_retarget) {
             return maximum_retarget.to_compact_lossy();

From 363471f8924b565c3438d145dc8a9cd5b9214f8f Mon Sep 17 00:00:00 2001
From: Paul Liu <paul@dfinity.org>
Date: Mon, 4 Aug 2025 17:01:21 +0800
Subject: [PATCH 47/53] feat: pass p2p protocol version explicitly (#10)

Pass protocol version explicitly when constructing network messages.
Remove the previous addition of `with_version` method because it could
be confusing when to use it.

This is not a compatible change, but modifications required are fairly
minimum.
Hopefully it will not be a problem in the future.
---
 bitcoin/examples/handshake.rs        |  1 +
 bitcoin/src/p2p/message.rs           |  2 ++
 bitcoin/src/p2p/message_blockdata.rs | 17 ++++-------------
 bitcoin/src/p2p/message_network.rs   |  8 ++------
 4 files changed, 9 insertions(+), 19 deletions(-)

diff --git a/bitcoin/examples/handshake.rs b/bitcoin/examples/handshake.rs
index 4106cbf16..6c674bc05 100644
--- a/bitcoin/examples/handshake.rs
+++ b/bitcoin/examples/handshake.rs
@@ -99,6 +99,7 @@ fn build_version_message(address: SocketAddr) -> NetworkMessage {
 
     // Construct the message
     NetworkMessage::Version(message_network::VersionMessage::new(
+        p2p::PROTOCOL_VERSION,
         services,
         timestamp as i64,
         addr_recv,
diff --git a/bitcoin/src/p2p/message.rs b/bitcoin/src/p2p/message.rs
index 80d655921..1b559afc8 100644
--- a/bitcoin/src/p2p/message.rs
+++ b/bitcoin/src/p2p/message.rs
@@ -594,10 +594,12 @@ mod test {
             NetworkMessage::GetData(vec![Inventory::Transaction(hash([45u8; 32]).into())]),
             NetworkMessage::NotFound(vec![Inventory::Error]),
             NetworkMessage::GetBlocks(GetBlocksMessage::new(
+                crate::p2p::PROTOCOL_VERSION,
                 vec![hash([1u8; 32]).into(), hash([4u8; 32]).into()],
                 hash([5u8; 32]).into(),
             )),
             NetworkMessage::GetHeaders(GetHeadersMessage::new(
+                crate::p2p::PROTOCOL_VERSION,
                 vec![hash([10u8; 32]).into(), hash([40u8; 32]).into()],
                 hash([50u8; 32]).into(),
             )),
diff --git a/bitcoin/src/p2p/message_blockdata.rs b/bitcoin/src/p2p/message_blockdata.rs
index db74f397f..40a9d89b4 100644
--- a/bitcoin/src/p2p/message_blockdata.rs
+++ b/bitcoin/src/p2p/message_blockdata.rs
@@ -13,7 +13,6 @@ use crate::blockdata::block::BlockHash;
 use crate::blockdata::transaction::{Txid, Wtxid};
 use crate::consensus::encode::{self, Decodable, Encodable};
 use crate::internal_macros::impl_consensus_encoding;
-use crate::p2p;
 
 /// An inventory item.
 #[derive(PartialEq, Eq, Clone, Debug, Copy, Hash, PartialOrd, Ord)]
@@ -127,12 +126,8 @@ pub struct GetHeadersMessage {
 
 impl GetBlocksMessage {
     /// Construct a new `getblocks` message
-    pub fn new(locator_hashes: Vec<BlockHash>, stop_hash: BlockHash) -> GetBlocksMessage {
-        GetBlocksMessage { version: p2p::PROTOCOL_VERSION, locator_hashes, stop_hash }
-    }
-    /// Set the version number.
-    pub fn with_version(self, version: u32) -> Self {
-        Self { version, ..self }
+    pub fn new(version: u32, locator_hashes: Vec<BlockHash>, stop_hash: BlockHash) -> GetBlocksMessage {
+        GetBlocksMessage { version, locator_hashes, stop_hash }
     }
 }
 
@@ -140,12 +135,8 @@ impl_consensus_encoding!(GetBlocksMessage, version, locator_hashes, stop_hash);
 
 impl GetHeadersMessage {
     /// Construct a new `getheaders` message
-    pub fn new(locator_hashes: Vec<BlockHash>, stop_hash: BlockHash) -> GetHeadersMessage {
-        GetHeadersMessage { version: p2p::PROTOCOL_VERSION, locator_hashes, stop_hash }
-    }
-    /// Set the version number.
-    pub fn with_version(self, version: u32) -> Self {
-        Self { version, ..self }
+    pub fn new(version: u32, locator_hashes: Vec<BlockHash>, stop_hash: BlockHash) -> GetHeadersMessage {
+        GetHeadersMessage { version, locator_hashes, stop_hash }
     }
 }
 
diff --git a/bitcoin/src/p2p/message_network.rs b/bitcoin/src/p2p/message_network.rs
index 1cadc8347..57575693d 100644
--- a/bitcoin/src/p2p/message_network.rs
+++ b/bitcoin/src/p2p/message_network.rs
@@ -11,7 +11,6 @@ use io::{Read, Write};
 
 use crate::consensus::{encode, Decodable, Encodable, ReadExt};
 use crate::internal_macros::impl_consensus_encoding;
-use crate::p2p;
 use crate::p2p::address::Address;
 use crate::p2p::ServiceFlags;
 use crate::prelude::*;
@@ -53,6 +52,7 @@ pub struct VersionMessage {
 impl VersionMessage {
     /// Constructs a new `version` message with `relay` set to false
     pub fn new(
+        version: u32,
         services: ServiceFlags,
         timestamp: i64,
         receiver: Address,
@@ -62,7 +62,7 @@ impl VersionMessage {
         start_height: i32,
     ) -> VersionMessage {
         VersionMessage {
-            version: p2p::PROTOCOL_VERSION,
+            version,
             services,
             timestamp,
             receiver,
@@ -73,10 +73,6 @@ impl VersionMessage {
             relay: false,
         }
     }
-    /// Set the version number.
-    pub fn with_version(self, version: u32) -> Self {
-        Self { version, ..self }
-    }
 }
 
 impl_consensus_encoding!(

From ae548e793e545e2328a1acce290207309b6244d1 Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Wed, 27 Aug 2025 14:05:35 +0200
Subject: [PATCH 48/53] feat: add auxpow validation (#14)

[XC-435](https://dfinity.atlassian.net/browse/XC-435): Adds AuxPow
validation used in merged mining.

References:
- Dogecoin core:
https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/auxpow.cpp#L81
- Merged mining specification:
https://en.bitcoin.it/wiki/Merged_mining_specification

[XC-435]:
https://dfinity.atlassian.net/browse/XC-435?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
---
 bitcoin/src/dogecoin/auxpow.rs    | 1189 +++++++++++++++++++++++++++++
 bitcoin/src/dogecoin/constants.rs |    9 +-
 bitcoin/src/dogecoin/mod.rs       |  265 ++++---
 bitcoin/src/dogecoin/params.rs    |   22 +-
 bitcoin/src/pow.rs                |    6 +-
 5 files changed, 1394 insertions(+), 97 deletions(-)
 create mode 100644 bitcoin/src/dogecoin/auxpow.rs

diff --git a/bitcoin/src/dogecoin/auxpow.rs b/bitcoin/src/dogecoin/auxpow.rs
new file mode 100644
index 000000000..a5993fe8e
--- /dev/null
+++ b/bitcoin/src/dogecoin/auxpow.rs
@@ -0,0 +1,1189 @@
+// SPDX-License-Identifier: Apache-2.0
+
+//! Dogecoin AuxPow validation.
+//!
+//! This module provides functionality for validating Auxiliary Proof-of-Work (AuxPoW)
+//! blocks used in Dogecoin's merged mining.
+
+use core::fmt;
+
+use hashes::Hash;
+
+use crate::consensus::Encodable;
+use crate::internal_macros::impl_consensus_encoding;
+use crate::prelude::*;
+use crate::{BlockHash, Transaction, TxMerkleNode};
+
+/// AuxPow version bit, see <https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23>
+pub const VERSION_AUXPOW: i32 = 1 << 8;
+/// Merged mining header, see <https://github.com/dogecoin/dogecoin/blob/bc8cca48968dfa3f60b5eae6a2b92bdd2870eee3/src/auxpow.h#L24>
+pub const MERGED_MINING_HEADER: [u8; 4] = [0xfa, 0xbe, b'm', b'm'];
+
+/// AuxPow validation error.
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub enum AuxPowValidationError {
+    /// Aux POW does not originate from a valid coinbase transaction
+    AuxPowNotFromCoinbase,
+    /// Chain ID is duplicated in both parent and current block
+    ParentHasSameChainId,
+    /// Aux POW blockchain merkle branch is too long
+    ChainMerkleBranchTooLong,
+    /// Aux POW coinbase transaction has invalid merkle proof
+    InvalidCoinbaseMerkleProof,
+    /// Aux POW coinbase transaction has no inputs
+    CoinbaseHasNoInputs,
+    /// Invalid script in coinbase transaction
+    InvalidAuxPowCoinbaseScript(AuxPowCoinbaseScriptValidationError),
+}
+
+impl fmt::Display for AuxPowValidationError {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        match self {
+            AuxPowValidationError::AuxPowNotFromCoinbase =>
+                write!(f, "Aux POW does not originate from a valid coinbase transaction"),
+            AuxPowValidationError::ParentHasSameChainId =>
+                write!(f, "Chain ID duplicated in both parent and current block"),
+            AuxPowValidationError::ChainMerkleBranchTooLong =>
+                write!(f, "Aux POW blockchain merkle branch too long"),
+            AuxPowValidationError::InvalidCoinbaseMerkleProof =>
+                write!(f, "Aux POW coinbase transaction has invalid merkle proof"),
+            AuxPowValidationError::CoinbaseHasNoInputs =>
+                write!(f, "Aux POW coinbase transaction has no inputs"),
+            AuxPowValidationError::InvalidAuxPowCoinbaseScript(err) => write!(f, "{}", err),
+        }
+    }
+}
+
+/// AuxPow coinbase script validation error.
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub enum AuxPowCoinbaseScriptValidationError {
+    /// Missing blockchain merkle root in the coinbase transaction
+    MissingMerkleRoot,
+    /// Multiple merged mining headers in the coinbase transaction
+    MultipleHeaders,
+    /// Merged mining header is not just before the blockchain merkle root
+    HeaderNotAdjacent,
+    /// Blockchain merkle root must start in the first 20 bytes of the coinbase transaction
+    LegacyRootTooFar,
+    /// Missing blockchain merkle tree size and nonce in the coinbase transaction
+    MissingMerkleSizeAndNonce,
+    /// Blockchain merkle branch size does not match merkle size in the coinbase transaction
+    MerkleSizeMismatch,
+    /// Blockchain index does not match expected value derived from nonce and chain ID
+    InvalidChainIndex,
+}
+
+impl fmt::Display for AuxPowCoinbaseScriptValidationError {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        match self {
+            AuxPowCoinbaseScriptValidationError::MissingMerkleRoot =>
+                write!(f, "Aux POW missing blockchain merkle root in coinbase transaction"),
+            AuxPowCoinbaseScriptValidationError::MultipleHeaders =>
+                write!(f, "Aux POW with multiple merged mining headers in coinbase transaction"),
+            AuxPowCoinbaseScriptValidationError::HeaderNotAdjacent =>
+                write!(f, "Aux POW merged mining header not just before blockchain merkle root"),
+            AuxPowCoinbaseScriptValidationError::LegacyRootTooFar =>
+                write!(f, "Aux POW blockchain merkle root must start in first 20 bytes of the coinbase transaction"),
+            AuxPowCoinbaseScriptValidationError::MissingMerkleSizeAndNonce =>
+                write!(f, "Aux POW missing blockchain merkle tree size and nonce in coinbase transaction"),
+            AuxPowCoinbaseScriptValidationError::MerkleSizeMismatch =>
+                write!(f, "Aux POW merkle blockchain branch size does not match merkle size in coinbase transaction"),
+            AuxPowCoinbaseScriptValidationError::InvalidChainIndex =>
+                write!(f, "Aux POW blockchain index does not match expected value derived from nonce and chain ID"),
+        }
+    }
+}
+
+impl From<AuxPowCoinbaseScriptValidationError> for AuxPowValidationError {
+    fn from(err: AuxPowCoinbaseScriptValidationError) -> Self {
+        AuxPowValidationError::InvalidAuxPowCoinbaseScript(err)
+    }
+}
+
+/// Data for merged-mining AuxPow.
+///
+/// It contains the parent block's coinbase tx that can be verified to be in the parent block.
+/// The coinbase transaction's input contains the hash of the auxiliary (merged-mined) block header.
+#[derive(PartialEq, Eq, Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
+#[cfg_attr(feature = "serde", serde(crate = "actual_serde"))]
+pub struct AuxPow {
+    /// The parent block's coinbase tx.
+    pub coinbase_tx: Transaction,
+    /// The parent block's hash.
+    pub parent_hash: BlockHash,
+    /// The Merkle branch linking the coinbase tx to the parent block's Merkle root.
+    pub coinbase_branch: Vec<TxMerkleNode>,
+    /// The index of the coinbase tx in the parent block's Merkle tree. Must be 0.
+    pub coinbase_index: i32,
+    /// The Merkle branch linking the auxiliary block header to the blockchain Merkle root present
+    /// in the coinbase tx.
+    pub blockchain_branch: Vec<TxMerkleNode>,
+    /// The index of the auxiliary block header in the Merkle tree.
+    pub blockchain_index: i32,
+    /// Parent block header on which the PoW is done.
+    pub parent_block_header: crate::blockdata::block::Header,
+}
+
+impl_consensus_encoding!(
+    AuxPow,
+    coinbase_tx,
+    parent_hash,
+    coinbase_branch,
+    coinbase_index,
+    blockchain_branch,
+    blockchain_index,
+    parent_block_header
+);
+
+impl AuxPow {
+    /// Helper method to produce SHA256D(left + right) - same as [`crate::merkle_tree::PartialMerkleTree::parent_hash`]
+    fn parent_hash(left: TxMerkleNode, right: TxMerkleNode) -> TxMerkleNode {
+        let mut encoder = TxMerkleNode::engine();
+        left.consensus_encode(&mut encoder).expect("engines don't error");
+        right.consensus_encode(&mut encoder).expect("engines don't error");
+        TxMerkleNode::from_engine(encoder)
+    }
+
+    /// Computes the merkle root from a child hash and its merkle branch proof.
+    pub fn compute_merkle_root(
+        hash: BlockHash,
+        branch: &[TxMerkleNode],
+        index: i32,
+    ) -> TxMerkleNode {
+        let mut result_hash = TxMerkleNode::from_byte_array(hash.to_byte_array());
+        let mut index = index;
+
+        for branch_hash in branch {
+            if index & 1 == 1 {
+                // Hash is on the right, branch element on the left
+                result_hash = Self::parent_hash(*branch_hash, result_hash);
+            } else {
+                // Hash is on the left, branch element on the right
+                result_hash = Self::parent_hash(result_hash, *branch_hash);
+            }
+            index >>= 1;
+        }
+
+        result_hash
+    }
+
+    /// Validates the merged mining header and merkle tree data in the coinbase script.
+    ///
+    /// The validation includes:
+    ///
+    /// 1. Merkle root: Ensures the blockchain merkle root is present
+    /// 2. Merged mining header: Ensures the merged mining header (0xfabe6d6d) is present
+    /// 3. Merged mining header uniqueness: Ensures only one merged mining header exists
+    /// 4. Merkle tree: Verifies that the merkle tree size matches the blockchain branch size
+    /// 5. Merkle tree index: Verifies the AuxPow header's index in the blockchain merkle tree
+    ///
+    /// # Arguments
+    ///
+    /// * `script` - The coinbase transaction input script containing the merged mining data
+    /// * `blockchain_merkle_root` - The merkle root of the headers of the merged-mined blockchains
+    /// * `chain_id` - Chain ID of the blockchain used for deterministic index calculation
+    ///
+    /// # Returns
+    ///
+    /// `Ok(())` if all validations pass, or an `AuxPowValidationError` describing the failure
+    ///
+    /// # Merged Mining Protocol
+    ///
+    /// The coinbase script embeds merged mining data in this format:
+    /// ```text
+    /// [...prefix] [merged_mining_header] [blockchain_merkle_root] [merkle_size] [merkle_nonce] [suffix...]
+    /// ```
+    /// Where:
+    /// - `merged_mining_header`: 4-byte magic header (0xfabe6d6d)
+    /// - `blockchain_merkle_root`: 32-byte root of the blockchain merkle tree
+    /// - `merkle_size`: 4-byte little-endian merkle tree size (2^height)
+    /// - `merkle_nonce`: 4-byte little-endian nonce to calculate deterministic slot of headers into merkle tree
+    fn check_merged_mining_coinbase_script(
+        &self,
+        script: &[u8],
+        blockchain_merkle_root: &[u8; 32],
+        chain_id: i32,
+    ) -> Result<(), AuxPowCoinbaseScriptValidationError> {
+        let root_pos = Self::find_bytes(script, blockchain_merkle_root)
+            .ok_or(AuxPowCoinbaseScriptValidationError::MissingMerkleRoot)?;
+
+        match Self::find_bytes(script, &MERGED_MINING_HEADER) {
+            Some(header_pos) => {
+                // Check for multiple headers
+                let search_start = header_pos + MERGED_MINING_HEADER.len();
+                if Self::find_bytes(&script[search_start..], &MERGED_MINING_HEADER).is_some() {
+                    return Err(AuxPowCoinbaseScriptValidationError::MultipleHeaders);
+                }
+                // Check that the header immediately precedes blockchain merkle root
+                if header_pos + MERGED_MINING_HEADER.len() != root_pos {
+                    return Err(AuxPowCoinbaseScriptValidationError::HeaderNotAdjacent);
+                }
+            }
+            None => {
+                // For backward compatibility: merkle root must start early in coinbase
+                // 8-12 bytes are enough to encode extraNonce and nBits
+                if root_pos > 20 {
+                    return Err(AuxPowCoinbaseScriptValidationError::LegacyRootTooFar);
+                }
+            }
+        }
+
+        let pos_after_root = root_pos + blockchain_merkle_root.len();
+        let remaining_script = &script[pos_after_root..];
+
+        if remaining_script.len() < 8 {
+            return Err(AuxPowCoinbaseScriptValidationError::MissingMerkleSizeAndNonce);
+        }
+
+        let size_bytes =
+            [remaining_script[0], remaining_script[1], remaining_script[2], remaining_script[3]];
+        let size = u32::from_le_bytes(size_bytes);
+
+        let merkle_height = self.blockchain_branch.len();
+        if size != (1u32 << merkle_height) {
+            return Err(AuxPowCoinbaseScriptValidationError::MerkleSizeMismatch);
+        }
+
+        let nonce_bytes =
+            [remaining_script[4], remaining_script[5], remaining_script[6], remaining_script[7]];
+        let nonce = u32::from_le_bytes(nonce_bytes);
+
+        let expected_index = Self::get_expected_index(nonce, chain_id, merkle_height);
+        if self.blockchain_index != expected_index {
+            return Err(AuxPowCoinbaseScriptValidationError::InvalidChainIndex);
+        }
+
+        Ok(())
+    }
+
+    /// Returns the byte offset of the first occurrence of `needle` in `haystack`.
+    /// If the `needle` is not found, returns `None`.
+    fn find_bytes(haystack: &[u8], needle: &[u8]) -> Option<usize> {
+        if needle.is_empty() {
+            return Some(0);
+        }
+        haystack.windows(needle.len()).position(|window| window == needle)
+    }
+
+    /// Calculates the expected index of the AuxPow block header in the blockchain merkle tree.
+    ///
+    /// Given the merkle tree size, nonce, and chain ID, computes a pseudo-random slot in the blockchain
+    /// merkle tree. This prevents replay attacks in merged mining by assigning each merged-mined
+    /// block header a deterministic position in the blockchain merkle tree.
+    ///
+    /// Ref: <https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/auxpow.cpp#L164>
+    pub fn get_expected_index(nonce: u32, chain_id: i32, merkle_height: usize) -> i32 {
+        // The original C++ implementation mentions that this computation can overflow but that
+        // this is not an issue. In C++, unsigned integer overflows automatically wrap around.
+        // To replicate the wrapping behavior, we use `wrapping_mul` and `wrapping_add`.
+
+        let mut rand = nonce;
+        rand = rand.wrapping_mul(1103515245).wrapping_add(12345);
+        rand = rand.wrapping_add(chain_id as u32);
+        rand = rand.wrapping_mul(1103515245).wrapping_add(12345);
+
+        (rand % (1u32 << merkle_height)) as i32
+    }
+
+    /// Validates the AuxPow structure for merged mining.
+    ///
+    /// Ref: <https://github.com/dogecoin/dogecoin/blob/51cbc1fd5d0d045dda2ad84f53572bbf524c6a8e/src/auxpow.cpp#L81>
+    ///
+    /// # Arguments
+    ///
+    /// * `aux_block_hash` - Hash of the AuxPow block being merged-mined
+    /// * `chain_id` - Chain ID of the auxiliary blockchain (e.g. 98 for Dogecoin)
+    /// * `strict_chain_id` - If true, enforces that parent and auxiliary chains have different chain IDs
+    ///
+    /// # Returns
+    ///
+    /// `Ok(())` if the AuxPoW is valid, or an `AuxPowValidationError` describing the validation failure
+    pub fn check(
+        &self,
+        aux_block_hash: BlockHash,
+        chain_id: i32,
+        strict_chain_id: bool,
+    ) -> Result<(), AuxPowValidationError> {
+        if self.coinbase_index != 0 {
+            return Err(AuxPowValidationError::AuxPowNotFromCoinbase);
+        }
+
+        if strict_chain_id && self.parent_block_header.extract_chain_id() == chain_id {
+            return Err(AuxPowValidationError::ParentHasSameChainId);
+        }
+
+        if self.blockchain_branch.len() > 30 {
+            return Err(AuxPowValidationError::ChainMerkleBranchTooLong);
+        }
+
+        let blockchain_merkle_root = Self::compute_merkle_root(
+            aux_block_hash,
+            &self.blockchain_branch,
+            self.blockchain_index,
+        );
+
+        let mut blockchain_merkle_root_le = blockchain_merkle_root.to_byte_array();
+        blockchain_merkle_root_le.reverse();
+
+        let coinbase_hash = self.coinbase_tx.compute_txid();
+        let transactions_merkle_root = Self::compute_merkle_root(
+            BlockHash::from_byte_array(coinbase_hash.to_byte_array()),
+            &self.coinbase_branch,
+            self.coinbase_index,
+        );
+
+        if transactions_merkle_root != self.parent_block_header.merkle_root {
+            return Err(AuxPowValidationError::InvalidCoinbaseMerkleProof);
+        }
+
+        if self.coinbase_tx.input.is_empty() {
+            return Err(AuxPowValidationError::CoinbaseHasNoInputs);
+        }
+
+        let script = &self.coinbase_tx.input[0].script_sig;
+
+        self.check_merged_mining_coinbase_script(
+            script.as_bytes(),
+            &blockchain_merkle_root_le,
+            chain_id,
+        )
+        .map_err(AuxPowValidationError::InvalidAuxPowCoinbaseScript)?;
+
+        Ok(())
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use core::str::FromStr;
+
+    use hashes::Hash;
+
+    use super::*;
+    use crate::block::{Header as PureHeader, Version};
+    use crate::consensus::encode::deserialize_hex;
+    use crate::{CompactTarget, ScriptBuf, TxIn, TxOut, Txid, Witness};
+
+    const PARENT_BLOCK_CHAIN_ID: i32 = 42;
+    const AUXPOW_BLOCK_CHAIN_ID: i32 = 98; // Dogecoin chain ID
+    const BASE_VERSION: i32 = 0x00000005;
+    const NONCE: u32 = 7;
+    const MERKLE_HEIGHT: usize = 30;
+
+    /// Helper to create a dummy blockchain branch
+    fn build_blockchain_merkle_branch(merkle_height: usize) -> Vec<TxMerkleNode> {
+        (0..merkle_height).map(|i| TxMerkleNode::from_byte_array([i as u8; 32])).collect()
+    }
+
+    /// Helper to create a minimal coinbase transaction with the given script
+    fn coinbase_from_script(script: ScriptBuf) -> Transaction {
+        Transaction {
+            version: crate::transaction::Version::ONE,
+            lock_time: crate::absolute::LockTime::ZERO,
+            input: vec![TxIn {
+                previous_output: crate::OutPoint::null(),
+                script_sig: script,
+                sequence: crate::Sequence::MAX,
+                witness: Witness::default(),
+            }],
+            output: vec![TxOut {
+                value: crate::Amount::from_sat(5000000000),
+                script_pubkey: ScriptBuf::new(),
+            }],
+        }
+    }
+
+    /// Helper to create an AuxPow coinbase transaction's script
+    fn build_auxpow_coinbase_script(
+        with_header: bool,
+        blockchain_merkle_root: &[u8; 32],
+        merkle_height: usize,
+        nonce: u32,
+    ) -> ScriptBuf {
+        let mut data = Vec::new();
+
+        if with_header {
+            data.extend_from_slice(&MERGED_MINING_HEADER);
+        }
+
+        // Reverse endianness (big-endian → little-endian)
+        let mut blockchain_merkle_root_le = *blockchain_merkle_root;
+        blockchain_merkle_root_le.reverse();
+        data.extend_from_slice(&blockchain_merkle_root_le);
+
+        let size = 1u32 << merkle_height;
+        data.extend_from_slice(&size.to_le_bytes());
+        data.extend_from_slice(&nonce.to_le_bytes());
+
+        let mut script_data = vec![0x01, 0x02]; // Some prefix data
+        script_data.extend_from_slice(&data);
+
+        ScriptBuf::from_bytes(script_data)
+    }
+
+    /// Helper to create an AuxPow coinbase transaction
+    fn build_auxpow_coinbase(
+        with_header: bool,
+        blockchain_merkle_root: &[u8; 32],
+        merkle_height: usize,
+        nonce: u32,
+    ) -> Transaction {
+        let script =
+            build_auxpow_coinbase_script(with_header, blockchain_merkle_root, merkle_height, nonce);
+
+        coinbase_from_script(script)
+    }
+
+    /// Helper to assemble an AuxPow struct from a coinbase transaction, expected index, and blockchain branch
+    fn assemble_auxpow(
+        coinbase_tx: Transaction,
+        expected_index: i32,
+        blockchain_branch: Vec<TxMerkleNode>,
+    ) -> AuxPow {
+        let parent_block_header = PureHeader {
+            version: Version::from_consensus(BASE_VERSION | (PARENT_BLOCK_CHAIN_ID << 16)),
+            prev_blockhash: BlockHash::from_byte_array([0; 32]),
+            merkle_root: TxMerkleNode::from_byte_array(coinbase_tx.compute_txid().to_byte_array()),
+            time: 0,
+            bits: CompactTarget::from_consensus(0x1e0ffff0),
+            nonce: 0,
+        };
+
+        AuxPow {
+            coinbase_tx,
+            parent_hash: BlockHash::from_byte_array([2; 32]), // Dummy value (this is not checked at all)
+            coinbase_branch: vec![], // There is only a coinbase transaction in the block
+            coinbase_index: 0,
+            blockchain_branch,
+            blockchain_index: expected_index,
+            parent_block_header,
+        }
+    }
+
+    /// Helper to create a valid AuxPow
+    fn build_auxpow(
+        aux_block_hash: BlockHash,
+        chain_id: i32,
+        merkle_height: usize,
+        nonce: u32,
+        with_header: bool,
+    ) -> AuxPow {
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, expected_index);
+
+        let coinbase_tx = build_auxpow_coinbase(
+            with_header,
+            &blockchain_merkle_root.to_byte_array(),
+            merkle_height,
+            nonce,
+        );
+
+        assemble_auxpow(coinbase_tx, expected_index, blockchain_branch)
+    }
+
+    #[test]
+    fn test_valid_auxpow_modern_format() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let auxpow = build_auxpow(aux_block_hash, chain_id, merkle_height, nonce, true);
+
+        assert!(auxpow.check(aux_block_hash, chain_id, true).is_ok());
+    }
+
+    #[test]
+    fn test_valid_auxpow_legacy_format() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let auxpow = build_auxpow(aux_block_hash, chain_id, merkle_height, nonce, false);
+
+        assert!(auxpow.check(aux_block_hash, chain_id, true).is_ok());
+    }
+
+    #[test]
+    fn test_auxpow_not_from_coinbase() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let mut auxpow = build_auxpow(aux_block_hash, chain_id, merkle_height, nonce, true);
+        auxpow.coinbase_index = 1; // Not coinbase
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowValidationError::AuxPowNotFromCoinbase)
+        );
+    }
+
+    #[test]
+    fn test_parent_has_same_chain_id() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let mut auxpow = build_auxpow(aux_block_hash, chain_id, merkle_height, nonce, true);
+
+        // Set parent block to have same chain ID
+        auxpow.parent_block_header.version =
+            Version::from_consensus(BASE_VERSION | (AUXPOW_BLOCK_CHAIN_ID << 16));
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowValidationError::ParentHasSameChainId)
+        );
+
+        assert!(auxpow.check(aux_block_hash, chain_id, false).is_ok());
+    }
+
+    #[test]
+    fn test_chain_merkle_branch_too_long() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = 31; // Too long (>30)
+        let nonce = NONCE;
+
+        let auxpow = build_auxpow(aux_block_hash, chain_id, merkle_height, nonce, true);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowValidationError::ChainMerkleBranchTooLong)
+        );
+    }
+
+    #[test]
+    fn test_invalid_coinbase_merkle_proof() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let mut auxpow = build_auxpow(aux_block_hash, chain_id, merkle_height, nonce, true);
+
+        // Tamper with parent block merkle root
+        auxpow.parent_block_header.merkle_root = TxMerkleNode::from_byte_array([0xff; 32]);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowValidationError::InvalidCoinbaseMerkleProof)
+        );
+    }
+
+    #[test]
+    fn test_coinbase_has_no_inputs() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, expected_index);
+        let mut coinbase_tx = build_auxpow_coinbase(
+            true,
+            &blockchain_merkle_root.to_byte_array(),
+            merkle_height,
+            nonce,
+        );
+
+        coinbase_tx.input.clear(); // Remove inputs
+
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowValidationError::CoinbaseHasNoInputs)
+        );
+    }
+
+    #[test]
+    fn test_modified_aux_block_hash() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let modified_hash = BlockHash::from_byte_array([0x13; 32]); // Modified
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let auxpow = build_auxpow(aux_block_hash, chain_id, merkle_height, nonce, true);
+
+        assert_eq!(
+            auxpow.check(modified_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::MissingMerkleRoot.into())
+        );
+    }
+
+    #[test]
+    fn test_wrong_chain_id() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let wrong_chain_id = AUXPOW_BLOCK_CHAIN_ID + 1;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let auxpow = build_auxpow(aux_block_hash, chain_id, merkle_height, nonce, true);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, wrong_chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::InvalidChainIndex.into())
+        );
+    }
+
+    #[test]
+    fn test_missing_blockchain_merkle_root() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+        let wrong_blockchain_merkle_root = [0; 32];
+        let coinbase_tx =
+            build_auxpow_coinbase(true, &wrong_blockchain_merkle_root, merkle_height, nonce);
+
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::MissingMerkleRoot.into())
+        );
+    }
+
+    #[test]
+    fn test_multiple_headers() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, expected_index)
+                .to_byte_array();
+        let wrong_blockchain_merkle_root = [0; 32];
+
+        // Legacy: Two blockchain merkle roots with no headers
+        // Correct blockchain merkle root first
+        let script_begin =
+            build_auxpow_coinbase_script(false, &blockchain_merkle_root, merkle_height, nonce);
+        let script_end = build_auxpow_coinbase_script(
+            false,
+            &wrong_blockchain_merkle_root,
+            merkle_height,
+            nonce,
+        );
+        let script =
+            ScriptBuf::from_bytes([script_begin.into_bytes(), script_end.into_bytes()].concat());
+        let coinbase_tx = coinbase_from_script(script);
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch.clone());
+        assert!(auxpow.check(aux_block_hash, chain_id, true).is_ok());
+
+        // Wrong blockchain merkle root first
+        let script_begin = build_auxpow_coinbase_script(
+            false,
+            &wrong_blockchain_merkle_root,
+            merkle_height,
+            nonce,
+        );
+        let script_end =
+            build_auxpow_coinbase_script(false, &blockchain_merkle_root, merkle_height, nonce);
+        let script =
+            ScriptBuf::from_bytes([script_begin.into_bytes(), script_end.into_bytes()].concat());
+        let coinbase_tx = coinbase_from_script(script);
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch.clone());
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::LegacyRootTooFar.into())
+        );
+
+        // Merged mining header present with wrong blockchain merkle root following it
+        let script_begin =
+            build_auxpow_coinbase_script(false, &blockchain_merkle_root, merkle_height, nonce);
+        let script_end =
+            build_auxpow_coinbase_script(true, &wrong_blockchain_merkle_root, merkle_height, nonce);
+        let script =
+            ScriptBuf::from_bytes([script_begin.into_bytes(), script_end.into_bytes()].concat());
+        let coinbase_tx = coinbase_from_script(script);
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch.clone());
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::HeaderNotAdjacent.into())
+        );
+
+        let script_begin =
+            build_auxpow_coinbase_script(true, &wrong_blockchain_merkle_root, merkle_height, nonce);
+        let script_end =
+            build_auxpow_coinbase_script(false, &blockchain_merkle_root, merkle_height, nonce);
+        let script =
+            ScriptBuf::from_bytes([script_begin.into_bytes(), script_end.into_bytes()].concat());
+        let coinbase_tx = coinbase_from_script(script);
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch.clone());
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::HeaderNotAdjacent.into())
+        );
+
+        // Multiple headers in coinbase gets rejected
+        let script_begin =
+            build_auxpow_coinbase_script(true, &wrong_blockchain_merkle_root, merkle_height, nonce);
+        let script_end =
+            build_auxpow_coinbase_script(true, &blockchain_merkle_root, merkle_height, nonce);
+        let script =
+            ScriptBuf::from_bytes([script_begin.into_bytes(), script_end.into_bytes()].concat());
+        let coinbase_tx = coinbase_from_script(script);
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch.clone());
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::MultipleHeaders.into())
+        );
+
+        let script_begin =
+            build_auxpow_coinbase_script(true, &blockchain_merkle_root, merkle_height, nonce);
+        let script_end =
+            build_auxpow_coinbase_script(true, &wrong_blockchain_merkle_root, merkle_height, nonce);
+        let script =
+            ScriptBuf::from_bytes([script_begin.into_bytes(), script_end.into_bytes()].concat());
+        let coinbase_tx = coinbase_from_script(script);
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch.clone());
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::MultipleHeaders.into())
+        );
+
+        // Correct blockchain merkle root after merged mining header is accepted
+        let script_begin =
+            build_auxpow_coinbase_script(true, &blockchain_merkle_root, merkle_height, nonce);
+        let script_end = build_auxpow_coinbase_script(
+            false,
+            &wrong_blockchain_merkle_root,
+            merkle_height,
+            nonce,
+        );
+        let script =
+            ScriptBuf::from_bytes([script_begin.into_bytes(), script_end.into_bytes()].concat());
+        let coinbase_tx = coinbase_from_script(script);
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch.clone());
+        assert!(auxpow.check(aux_block_hash, chain_id, true).is_ok());
+
+        let script_begin = build_auxpow_coinbase_script(
+            false,
+            &wrong_blockchain_merkle_root,
+            merkle_height,
+            nonce,
+        );
+        let script_end =
+            build_auxpow_coinbase_script(true, &blockchain_merkle_root, merkle_height, nonce);
+        let script =
+            ScriptBuf::from_bytes([script_begin.into_bytes(), script_end.into_bytes()].concat());
+        let coinbase_tx = coinbase_from_script(script);
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch.clone());
+        assert!(auxpow.check(aux_block_hash, chain_id, true).is_ok());
+    }
+
+    #[test]
+    fn test_header_not_adjacent() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, expected_index);
+
+        let mut script_data = vec![0x01, 0x02];
+        script_data.extend_from_slice(&MERGED_MINING_HEADER);
+        script_data.push(0xff); // Extra byte between header and merkle root
+        let mut blockchain_merkle_root_le = blockchain_merkle_root.to_byte_array();
+        blockchain_merkle_root_le.reverse();
+        script_data.extend_from_slice(&blockchain_merkle_root_le);
+        script_data.extend_from_slice(&(1u32 << merkle_height).to_le_bytes());
+        script_data.extend_from_slice(&nonce.to_le_bytes());
+
+        let script = ScriptBuf::from_bytes(script_data);
+        let coinbase_tx = coinbase_from_script(script);
+
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::HeaderNotAdjacent.into())
+        );
+    }
+
+    #[test]
+    fn test_legacy_root_too_far() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        // Create legacy format with merkle root too far from start
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, expected_index);
+
+        let mut script_data = vec![0; 25]; // 25 bytes prefix (>20, too far)
+        let mut blockchain_merkle_root_le = blockchain_merkle_root.to_byte_array();
+        blockchain_merkle_root_le.reverse();
+        script_data.extend_from_slice(&blockchain_merkle_root_le);
+        script_data.extend_from_slice(&(1u32 << merkle_height).to_le_bytes());
+        script_data.extend_from_slice(&nonce.to_le_bytes());
+
+        let script = ScriptBuf::from_bytes(script_data);
+        let coinbase_tx = coinbase_from_script(script);
+
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::LegacyRootTooFar.into())
+        );
+    }
+
+    #[test]
+    fn test_missing_merkle_size_and_nonce() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, expected_index);
+
+        let script = build_auxpow_coinbase_script(
+            true,
+            &blockchain_merkle_root.to_byte_array(),
+            merkle_height,
+            nonce,
+        );
+        let mut script_bytes = script.into_bytes();
+        script_bytes.truncate(script_bytes.len() - 8); // Remove last 8 bytes (size + nonce)
+        let coinbase_tx = coinbase_from_script(ScriptBuf::from_bytes(script_bytes));
+
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::MissingMerkleSizeAndNonce.into())
+        );
+    }
+
+    #[test]
+    fn test_incorrect_merkle_size_in_coinbase() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, expected_index);
+
+        let script = build_auxpow_coinbase_script(
+            true,
+            &blockchain_merkle_root.to_byte_array(),
+            merkle_height - 1, // Incorrect merkle size
+            nonce,
+        );
+        let coinbase_tx = coinbase_from_script(script);
+
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::MerkleSizeMismatch.into())
+        );
+    }
+
+    #[test]
+    fn test_incorrect_nonce_in_coinbase() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, expected_index);
+
+        let script = build_auxpow_coinbase_script(
+            true,
+            &blockchain_merkle_root.to_byte_array(),
+            merkle_height,
+            nonce + 3, // Incorrect nonce
+        );
+        let coinbase_tx = coinbase_from_script(script);
+
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::InvalidChainIndex.into())
+        );
+    }
+
+    #[test]
+    fn test_invalid_chain_index() {
+        let aux_block_hash = BlockHash::from_byte_array([0x12; 32]);
+        let chain_id = AUXPOW_BLOCK_CHAIN_ID;
+        let merkle_height = MERKLE_HEIGHT;
+        let nonce = NONCE;
+
+        let expected_index = AuxPow::get_expected_index(nonce, chain_id, merkle_height);
+        let wrong_index = expected_index + 1;
+
+        let blockchain_branch = build_blockchain_merkle_branch(merkle_height);
+
+        let blockchain_merkle_root =
+            AuxPow::compute_merkle_root(aux_block_hash, &blockchain_branch, wrong_index);
+
+        let coinbase_tx = build_auxpow_coinbase(
+            true,
+            &blockchain_merkle_root.to_byte_array(),
+            merkle_height,
+            nonce,
+        );
+
+        let auxpow = assemble_auxpow(coinbase_tx, expected_index, blockchain_branch);
+
+        assert_eq!(
+            auxpow.check(aux_block_hash, chain_id, true),
+            Err(AuxPowCoinbaseScriptValidationError::MissingMerkleRoot.into())
+        );
+    }
+
+    #[test]
+    fn test_valid_auxpow_dogecoin_mainnet_single_merged_mined_chain() {
+        // AuxPow information for Dogecoin mainnet block, height 2_679_506
+        let coinbase_tx = deserialize_hex::<Transaction>("02000000010000000000000000000000000000000000000000000000000000000000000000ffffffff4d03119d1804ec4eb05c2f4254432e434f4d2f4c5443fabe6d6d283fa35edb604a913ead7e776b534f1661723da6721131eee75a39738ed2e8f8010000000000000001000a7de000000000000000ffffffff02fef83d95000000001976a91497b22b5ff0e6fd5e06c2592bdff0bfd677009f4788ac0000000000000000266a24aa21a9ed710de897f5217b49832c28a07a7f71c924d6c502efacbd3afdfe78565c9cc0d200000000").unwrap();
+        let coinbase_tx_id =
+            Txid::from_str("d7f98ad4f597cbd536529b35739d4ae8f13b788d0f6e9f4408c4b457410eed9c")
+                .unwrap();
+
+        assert_eq!(coinbase_tx.compute_txid(), coinbase_tx_id);
+        assert_eq!(coinbase_tx.input.len(), 1);
+
+        let coinbase_script = ScriptBuf::from_hex("03119d1804ec4eb05c2f4254432e434f4d2f4c5443fabe6d6d283fa35edb604a913ead7e776b534f1661723da6721131eee75a39738ed2e8f8010000000000000001000a7de000000000000000").unwrap();
+        assert_eq!(coinbase_script, coinbase_tx.input.first().unwrap().script_sig);
+
+        // Litecoin mainnet block, height 1_613_073
+        let parent_block_header = deserialize_hex::<PureHeader>("000000208adac0c3312ce198ee1bc0b0ca079a648b47f7a2d36b92680a164e9f3472b681bb83e66a3c19332e7825a0e4e6e5bed63192d8c0bf1321803d06881cbd470f44ec4eb05c8075011a855549e5").unwrap();
+        let parent_hash =
+            BlockHash::from_str("5c87f7add34f31c644275476761e4273ec27c6bb31d383f27693df84f78a4275")
+                .unwrap();
+
+        assert_eq!(parent_block_header.block_hash(), parent_hash);
+
+        let coinbase_branch = vec![
+            TxMerkleNode::from_str(
+                "6d8897d112189fdf9af120b70d16a26783ffda7a2f1968984fee9fb9e7764b79",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "37a820e558328ef2ec366c4e83e9e627cb34ced06a140423686b5ee6def33e89",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "f1369a82235d4c3a922444ae6764ee00efa9c040ea13c8ce2b83d2b1865cb5ae",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "3859ccd5dd341126af04fe193e021294cde59bcb06ebf9195c4406f96a98dd1a",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "37d8306e628ade2df4f868ce235ac0f4f5e32195664fdf865e43ed236299e81b",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "827e84f9933bd63ebab743610f2a94c2d8d1cf2e79d0879a27da359b06bee33d",
+            )
+            .unwrap(),
+        ];
+
+        let blockchain_branch = vec![];
+
+        let auxpow_mainnet_2_679_506 = AuxPow {
+            coinbase_tx,
+            parent_hash,
+            coinbase_branch,
+            coinbase_index: 0,
+            blockchain_branch,
+            blockchain_index: 0,
+            parent_block_header,
+        };
+
+        let aux_block_hash =
+            BlockHash::from_str("283fa35edb604a913ead7e776b534f1661723da6721131eee75a39738ed2e8f8")
+                .unwrap();
+
+        assert!(auxpow_mainnet_2_679_506.check(aux_block_hash, AUXPOW_BLOCK_CHAIN_ID, true).is_ok());
+    }
+
+    #[test]
+    fn test_valid_auxpow_dogecoin_mainnet_multiple_merged_mined_chains() {
+        // AuxPow information for Dogecoin mainnet block, height 1_000_000
+        let coinbase_tx = deserialize_hex::<Transaction>("01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff4c0350c90d047cbb6d5608028f23145c045200fabe6d6d5ae93eb8863161c9cd991ba9f7b0fa4353b645310b2edabb123066dea3c9150140000000000000000d2f6e6f64655374726174756d2f0000000001e81c0695000000001976a9145da2560b857f5ba7874de4a1173e67b4d509c46688ac00000000").unwrap();
+        let coinbase_tx_id =
+            Txid::from_str("02454219e64615c8a9aa813fb520a924a36229f5a658de069b5a4c588ffaa209")
+                .unwrap();
+
+        assert_eq!(coinbase_tx.compute_txid(), coinbase_tx_id);
+        assert_eq!(coinbase_tx.input.len(), 1);
+
+        let coinbase_script = ScriptBuf::from_hex("0350c90d047cbb6d5608028f23145c045200fabe6d6d5ae93eb8863161c9cd991ba9f7b0fa4353b645310b2edabb123066dea3c9150140000000000000000d2f6e6f64655374726174756d2f").unwrap();
+        assert_eq!(coinbase_script, coinbase_tx.input.first().unwrap().script_sig);
+
+        // Litecoin mainnet block, height 903_504
+        let parent_block_header = deserialize_hex::<PureHeader>("03000000d37139870c8a6853cdbdb0eba43956efccedd7f50dcd57ca13187200da12320a6102f658ec72bd6b3550dd54d3b3c9e4b7063ec4662e94e768fb1cdda77e678cd4ba6d56f542011bb8a07866").unwrap();
+        let parent_hash =
+            BlockHash::from_str("3d6a5046000041f2517ca0d436b558640803cfa2596d1d2febfe6079d84eb358")
+                .unwrap();
+
+        assert_eq!(parent_block_header.block_hash(), parent_hash);
+
+        let coinbase_branch = vec![
+            TxMerkleNode::from_str(
+                "e77d6288e0f8280ab954bcef89f5d7d524c8137f3929aa12f5e81f753032f936",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "8c104741e043384a401bd56e815b6c36f88457e9940958d1e5648cc51f71c889",
+            )
+            .unwrap(),
+        ];
+
+        let blockchain_branch = vec![
+            TxMerkleNode::from_str(
+                "0000000000000000000000000000000000000000000000000000000000000000",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "f98c4e9736d8eb8bb46299798906695c755369a3df99a93ffdded1713f1cf6e2",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "48e55233b9707330def98c80a2105eaa5fac8f687d872ffb4b4741fa2bdb247d",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "c77d206e2f3cc38e18b85aaa89a8f142a9bf0f4106925d39708f91083e7d8594",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "c98b626e977b43fffd7a2cdd179bd15dc8566b0c21252562f944f40ab5870ff7",
+            )
+            .unwrap(),
+            TxMerkleNode::from_str(
+                "4433bbe69867ef956764b17c57ccb89189c901709a8aa771ca119e1d8437912c",
+            )
+            .unwrap(),
+        ];
+
+        let auxpow_mainnet_1_000_000 = AuxPow {
+            coinbase_tx,
+            parent_hash,
+            coinbase_branch,
+            coinbase_index: 0,
+            blockchain_branch,
+            blockchain_index: 56,
+            parent_block_header,
+        };
+
+        let aux_block_hash =
+            BlockHash::from_str("6aae55bea74235f0c80bd066349d4440c31f2d0f27d54265ecd484d8c1d11b47")
+                .unwrap();
+
+        assert!(auxpow_mainnet_1_000_000.check(aux_block_hash, AUXPOW_BLOCK_CHAIN_ID, true).is_ok());
+    }
+
+    #[test]
+    fn test_valid_auxpow_dogecoin_mainnet_legacy() {
+        // AuxPow information for Dogecoin mainnet block, height 1_731_044
+        let coinbase_tx = deserialize_hex::<Transaction>("01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff6403c77a1245c608010910b320f69f1eb5e1b7bb45fbc108e4379b5a77dee5a3b0a406038989b964153901000000000000000076000000e1f54700580000262f425443432f20000000000000000000000000000000000000000000000000000000000000000000000002f2aff395000000001976a914088b3b2a325c12f47e60b87f7bdd7f280e144e0388ac0000000000000000266a24aa21a9ed79084e12cbfa366a9758d398d62cf8195a17a72c87583f64a568797872369aea00000000").unwrap();
+        let coinbase_tx_id =
+            Txid::from_str("7bae97400ac3ec58aa03703a3228d125b89823c017b8100715250171c9fb9dc5")
+                .unwrap();
+
+        assert_eq!(coinbase_tx.compute_txid(), coinbase_tx_id);
+        assert_eq!(coinbase_tx.input.len(), 1);
+
+        let coinbase_script = ScriptBuf::from_hex("03c77a1245c608010910b320f69f1eb5e1b7bb45fbc108e4379b5a77dee5a3b0a406038989b964153901000000000000000076000000e1f54700580000262f425443432f2000000000000000000000000000000000000000000000000000000000000000").unwrap();
+        assert_eq!(coinbase_script, coinbase_tx.input.first().unwrap().script_sig);
+
+        // Verify that the coinbase script does not contain the MERGED_MINING_HEADER
+        // This test confirms it's a legacy AuxPow (without the merged mining header format)
+        assert!(AuxPow::find_bytes(coinbase_script.as_bytes(), &MERGED_MINING_HEADER).is_none());
+
+        // Litecoin mainnet block, height 1_211_079
+        let parent_block_header = deserialize_hex::<PureHeader>("0000002086ac5d670b08f9c812a3778dcafd42ab0bf79d3e48b3a043ce56af64c47182cf8cc521420ec9f8f15ea770a2c91b85f5a72a02f18942a58a47210222b4924202832328596887451a04cbc280").unwrap();
+        let parent_hash =
+            BlockHash::from_str("3865ad8eea8a2b3b7452e5c75d411156907f65b42593e2d48b2ff95974897245")
+                .unwrap();
+
+        assert_eq!(parent_block_header.block_hash(), parent_hash);
+
+        let coinbase_branch = vec![
+            TxMerkleNode::from_str(
+                "2f7aeb2615e5251d107339a2e4d7177ac341f71b2d0d5931695f6133a64f497e",
+            )
+                .unwrap(),
+            TxMerkleNode::from_str(
+                "c9d13f7eb2a2fc00f6d4a4f941c214868ae508a2c410eee2e37936d742167d0c",
+            )
+                .unwrap(),
+            TxMerkleNode::from_str(
+                "bc82db9b6fd74cfba991bc2e422f6db3f2d6916053fcc6feaa5eca588b8bff1c",
+            )
+                .unwrap(),
+            TxMerkleNode::from_str(
+                "be46c579c5859312688104b479e2527058a5da9ce9dd5f7ef4247cfa3384ca99",
+            )
+                .unwrap(),
+            TxMerkleNode::from_str(
+                "f9813969c631dcd4c536fa7f5f371d840c8270644651d3c2536fb5abb0d846c2",
+            )
+                .unwrap(),
+        ];
+
+        let blockchain_branch = vec![];
+
+        let auxpow_mainnet_1_731_044 = AuxPow {
+            coinbase_tx,
+            parent_hash,
+            coinbase_branch,
+            coinbase_index: 0,
+            blockchain_branch,
+            blockchain_index: 0,
+            parent_block_header,
+        };
+
+        let aux_block_hash =
+            BlockHash::from_str("10b320f69f1eb5e1b7bb45fbc108e4379b5a77dee5a3b0a406038989b9641539")
+                .unwrap();
+
+        assert!(auxpow_mainnet_1_731_044.check(aux_block_hash, AUXPOW_BLOCK_CHAIN_ID, true).is_ok());
+    }
+}
diff --git a/bitcoin/src/dogecoin/constants.rs b/bitcoin/src/dogecoin/constants.rs
index 458fdadd7..799473e16 100644
--- a/bitcoin/src/dogecoin/constants.rs
+++ b/bitcoin/src/dogecoin/constants.rs
@@ -90,8 +90,7 @@ pub fn genesis_block(params: impl AsRef<Params>) -> Block {
                 time: 1386325540,
                 bits: CompactTarget::from_consensus(0x1e0ffff0),
                 nonce: 99943,
-            },
-            auxpow: None,
+            }.into(),
             txdata,
         },
         Network::Testnet => Block {
@@ -102,8 +101,7 @@ pub fn genesis_block(params: impl AsRef<Params>) -> Block {
                 time: 1391503289,
                 bits: CompactTarget::from_consensus(0x1e0ffff0),
                 nonce: 997879,
-            },
-            auxpow: None,
+            }.into(),
             txdata,
         },
         Network::Regtest => Block {
@@ -114,8 +112,7 @@ pub fn genesis_block(params: impl AsRef<Params>) -> Block {
                 time: 1296688602,
                 bits: CompactTarget::from_consensus(0x207fffff),
                 nonce: 2,
-            },
-            auxpow: None,
+            }.into(),
             txdata,
         },
     }
diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index 5f5256d14..ce248125f 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -8,10 +8,11 @@
 pub mod address;
 pub mod constants;
 pub mod params;
+pub mod auxpow;
 
 pub use address::*;
 
-use crate::block::{Header, TxMerkleNode};
+use crate::block::{Header as PureHeader, TxMerkleNode, Version};
 use crate::consensus::{encode, Decodable, Encodable};
 use crate::dogecoin::params::Params;
 use crate::internal_macros::impl_consensus_encoding;
@@ -20,57 +21,105 @@ use crate::p2p::Magic;
 use crate::prelude::*;
 use crate::{io, BlockHash, Transaction};
 use core::fmt;
+use core::ops::{Deref, DerefMut};
+use crate::dogecoin::auxpow::{AuxPow, VERSION_AUXPOW};
 
-/// AuxPow version bit, see <https://github.com/dogecoin/dogecoin/blob/d7cc7f8bbb5f790942d0ed0617f62447e7675233/src/primitives/pureheader.h#L23>
-pub const VERSION_AUXPOW: i32 = 1 << 8;
-
-fn is_auxpow(header: Header) -> bool { (header.version.to_consensus() & VERSION_AUXPOW) != 0 }
-
-/// Data for merge-mining AuxPoW.
+/// Dogecoin block header.
+///
+/// ### Dogecoin Core References
 ///
-/// It contains the parent block's coinbase tx that can be verified to be in the parent block.
-/// The transaction's input contains the hash to the actual merge-mined block.
+/// * [CBlockHeader definition](https://github.com/dogecoin/dogecoin/blob/7237da74b8c356568644cbe4fba19d994704355b/src/primitives/block.h#L23)
 #[derive(PartialEq, Eq, Clone, Debug)]
 #[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
 #[cfg_attr(feature = "serde", serde(crate = "actual_serde"))]
-pub struct AuxPow {
-    /// The parent block's coinbase tx.
-    pub coinbase_tx: Transaction,
-    /// The parent block's hash.
-    pub parent_hash: BlockHash,
-    /// The Merkle branch linking the coinbase tx to the parent block's Merkle root.
-    pub coinbase_branch: Vec<TxMerkleNode>,
-    /// The index of the coinbase tx in the Merkle tree.
-    pub coinbase_index: i32,
-    /// The Merkle branch linking the merge-mined block to the coinbase tx.
-    pub blockchain_branch: Vec<TxMerkleNode>,
-    /// The index of the merged-mined block in the Merkle tree.
-    pub blockchain_index: i32,
-    /// Parent block header (on which the PoW is done).
-    pub parent_block: Header,
+pub struct Header {
+    /// Block header without AuxPow information.
+    pub pure_header: PureHeader,
+    /// AuxPoW structure, present if merged mining was used to mine this block.
+    pub aux_pow: Option<AuxPow>,
 }
 
-impl_consensus_encoding!(
-    AuxPow,
-    coinbase_tx,
-    parent_hash,
-    coinbase_branch,
-    coinbase_index,
-    blockchain_branch,
-    blockchain_index,
-    parent_block
-);
+impl Deref for Header {
+    type Target = PureHeader;
+    fn deref(&self) -> &Self::Target {
+        &self.pure_header
+    }
+}
+
+impl DerefMut for Header {
+    fn deref_mut(&mut self) -> &mut Self::Target {
+        &mut self.pure_header
+    }
+}
+
+impl From<PureHeader> for Header {
+    fn from(pure_header: PureHeader) -> Self {
+        Self { pure_header, aux_pow: None }
+    }
+}
+
+impl Decodable for Header {
+    #[inline]
+    fn consensus_decode_from_finite_reader<R: Read + ?Sized>(
+        r: &mut R,
+    ) -> Result<Self, encode::Error> {
+        let pure_header: PureHeader = Decodable::consensus_decode_from_finite_reader(r)?;
+        let aux_pow = if pure_header.has_auxpow_bit() {
+            Some(Decodable::consensus_decode_from_finite_reader(r)?)
+        } else {
+            None
+        };
+
+        Ok(Self { pure_header, aux_pow })
+    }
+}
+
+impl Encodable for Header {
+    #[inline]
+    fn consensus_encode<W: Write + ?Sized>(&self, w: &mut W) -> Result<usize, io::Error> {
+        let mut len = 0;
+        len += self.pure_header.consensus_encode(w)?;
+        if let Some(ref aux_pow) = self.aux_pow {
+            len += aux_pow.consensus_encode(w)?;
+        }
+        Ok(len)
+    }
+}
+
+impl PureHeader {
+    /// Checks if a block header indicates it was merged mined and contains AuxPow information.
+    pub fn has_auxpow_bit(&self) -> bool {
+        (self.version.to_consensus() & VERSION_AUXPOW) != 0
+    }
+
+    /// Extracts the chain ID from the block header's version field.
+    pub fn extract_chain_id(&self) -> i32 {
+        self.version.to_consensus() >> 16
+    }
+
+    /// Determines if a block header represents a legacy (pre-AuxPoW) block.
+    pub fn is_legacy(&self) -> bool {
+        self.version == Version::ONE
+            // Random v2 block with no AuxPoW, treat as legacy
+            || (self.version == Version::TWO && self.extract_chain_id() == 0)
+    }
+
+    /// Extracts the base version number from a block header, removing AuxPoW and chain ID bits.
+    pub fn extract_base_version(&self) -> i32 {
+        self.version.to_consensus() % VERSION_AUXPOW
+    }
+}
 
 /// Dogecoin block.
 ///
 /// A collection of transactions with an attached proof of work.
-/// The AuxPoW is present if the block was mined using merge-mining.
+/// The AuxPoW data is present in `header` if the block was mined using merged-mining.
 ///
-/// See [Bitcoin Wiki: Block][wiki-block] and [Bitcoin Wiki: Merged_mining_specification][merge-mining]
+/// See [Bitcoin Wiki: Block][wiki-block] and [Bitcoin Wiki: Merged_mining_specification][merged-mining]
 /// for more information.
 ///
 /// [wiki-block]: https://en.bitcoin.it/wiki/Block
-/// [merge-mining]: https://en.bitcoin.it/wiki/Merged_mining_specification
+/// [merged-mining]: https://en.bitcoin.it/wiki/Merged_mining_specification
 ///
 /// ### Dogecoin Core References
 ///
@@ -79,10 +128,8 @@ impl_consensus_encoding!(
 #[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
 #[cfg_attr(feature = "serde", serde(crate = "actual_serde"))]
 pub struct Block {
-    /// The block header.
+    /// The Dogecoin block header.
     pub header: Header,
-    /// AuxPoW structure, present if merged mining was used to mine this block.
-    pub auxpow: Option<AuxPow>,
     /// List of transactions contained in the block.
     pub txdata: Vec<Transaction>,
 }
@@ -112,35 +159,7 @@ impl Block {
     }
 }
 
-impl Decodable for Block {
-    #[inline]
-    fn consensus_decode_from_finite_reader<R: Read + ?Sized>(
-        r: &mut R,
-    ) -> Result<Self, encode::Error> {
-        let header: Header = Decodable::consensus_decode_from_finite_reader(r)?;
-        let auxpow = if is_auxpow(header) {
-            Some(Decodable::consensus_decode_from_finite_reader(r)?)
-        } else {
-            None
-        };
-        let txdata = Decodable::consensus_decode_from_finite_reader(r)?;
-
-        Ok(Self { header, auxpow, txdata })
-    }
-}
-
-impl Encodable for Block {
-    #[inline]
-    fn consensus_encode<W: Write + ?Sized>(&self, w: &mut W) -> Result<usize, io::Error> {
-        let mut len = 0;
-        len += self.header.consensus_encode(w)?;
-        if let Some(ref auxpow) = self.auxpow {
-            len += auxpow.consensus_encode(w)?;
-        }
-        len += self.txdata.consensus_encode(w)?;
-        Ok(len)
-    }
-}
+impl_consensus_encoding!(Block, header, txdata);
 
 /// The cryptocurrency network to act on.
 #[derive(Copy, PartialEq, Eq, PartialOrd, Ord, Clone, Hash, Debug)]
@@ -208,20 +227,20 @@ impl core::str::FromStr for Network {
 
 #[cfg(test)]
 mod tests {
-    use hex::test_hex_unwrap as hex;
-
+    use hex::{test_hex_unwrap as hex};
+    use hashes::Hash;
     use super::*;
     use crate::block::{ValidationError, Version};
     use crate::consensus::encode::{deserialize, serialize};
     use crate::{CompactTarget, Target, Work};
     use crate::{Network as BitcoinNetwork};
 
-
     #[test]
     fn dogecoin_block_test() {
         // Mainnet Dogecoin block 5794c80b80d9c33e0737a5353cd52b1f097f61d8d2b9f471e1702345080e0002
         let some_block = hex!("01000000c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba3894b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a207d78bb52de8f001c00da8c3c0201000000010000000000000000000000000000000000000000000000000000000000000000ffffffff2602bc6d062f503253482f047178bb5208f8042975030000000d2f7374726174756d506f6f6c2f000000000100629b29c45500001976a91450e9fe87c705dcd4b7523b47e3314c2115f5d5df88ac0000000001000000015f48fabf4425324df2b5e58f4e9c771297f76f5fa37db7556f6fc1d22742da1f010000006a473044022062d29d2d26f7d826e7b72257486e294d284832743c7803a2901eb07e326b25a002207efc391b0f4e724c9d518075c0e056cc425540f845b0fd419ba8a9d49d69288301210297a2568525760a98454d84f5e5adba9fd0a41726a6fb774ddc407279e41e2061ffffffff0240bab598200000001976a91401348a2b83aeb6b1ba2a174a1a40b7c75fbeb12088ac0040be40250000001976a914025407d928ef333979d064ae233353d80e29d58c88ac00000000");
         let cutoff_block = hex!("01000000c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba3894b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a207d78bb52de8f001c00da8c3c0201000000010000000000000000000000000000000000000000000000000000000000000000ffffffff2602bc6d062f503253482f047178bb5208f8042975030000000d2f7374726174756d506f6f6c2f000000000100629b29c45500001976a91450e9fe87c705dcd4b7523b47e3314c2115f5d5df88ac0000000001000000015f48fabf4425324df2b5e58f4e9c771297f76f5fa37db7556f6fc1d22742da1f010000006a473044022062d29d2d26f7d826e7b72257486e294d284832743c7803a2901eb07e326b25a002207efc391b0f4e724c9d518075c0e056cc425540f845b0fd419ba8a9d49d69288301210297a2568525760a98454d84f5e5adba9fd0a41726a6fb774ddc407279e41e2061ffffffff0240bab598200000001976a91401348a2b83aeb6b1ba2a174a1a40b7c75fbeb12088ac0040be40250000001976a914025407d928ef333979d064ae233353d80e29d58c88ac");
+        let header = &some_block[0..80];
 
         let currhash = hex!("02000e08452370e171f4b9d2d8617f091f2bd53c35a537073ec3d9800bc89457");
         let prevhash = hex!("c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba38");
@@ -237,7 +256,7 @@ mod tests {
         assert_eq!(serialize(&real_decode.header.block_hash()), currhash);
         assert_eq!(real_decode.header.version, Version::ONE);
         assert_eq!(serialize(&real_decode.header.prev_blockhash), prevhash);
-        // assert_eq!(real_decode.header.merkle_root, real_decode.compute_merkle_root().unwrap());
+        assert_eq!(real_decode.header.merkle_root, real_decode.compute_merkle_root().unwrap());
         assert_eq!(serialize(&real_decode.header.merkle_root), merkle);
         assert_eq!(real_decode.header.time, 1388017789);
         assert_eq!(real_decode.header.bits, CompactTarget::from_consensus(469798878));
@@ -252,9 +271,81 @@ mod tests {
         assert_eq!(real_decode.header.difficulty(BitcoinNetwork::Bitcoin), 455);
         assert_eq!(real_decode.header.difficulty_float(), 455.52430084170516);
 
+        assert!(!real_decode.header.has_auxpow_bit());
+        assert_eq!(real_decode.header.extract_chain_id(), 0);
+        assert_eq!(real_decode.header.extract_base_version(), 1);
+        assert!(real_decode.header.is_legacy());
+
+        assert!(real_decode.header.aux_pow.is_none());
+
+        assert_eq!(serialize(&real_decode.header.pure_header), header);
+        assert_eq!(serialize(&real_decode.header), header);
         assert_eq!(serialize(&real_decode), some_block);
     }
 
+    #[test]
+    fn dogecoin_block_test_with_auxpow() {
+        // Mainnet Dogecoin block d3ea48350b102b90acf9eac6629072d5f697c02faf360b26d365e7b2bfb98070
+        let block = hex!("020162001e21ad14bc1ef20cf2d58e2b755ae4a7bfb75c906c74ef3dbb97cc57dcd77581b14423c43517df2b4f3277731daba29d0d865b515a6f19f5fb61d5799b28f2c9b48713540fa8071b0000000001000000010000000000000000000000000000000000000000000000000000000000000000ffffffff4f032ac209fabe6d6dd3ea48350b102b90acf9eac6629072d5f697c02faf360b26d365e7b2bfb980700100000000000000062f503253482f04ce871354080811312915000000092f7374726174756d2f000000000100f2052a010000001976a914f332ec6f1729495e7edcd8ce9d887742567fe60988ac0000000006d2bbd93141ea6d2c8434caeb01828a2a522275b66d2b21fe4ed8230cfe65a101ad2f07c348abdc05f57e2e7d8763488aad71df9f557aec46ae0207ae2bb74a1500000000000000000002000000f288b555ed9b44c814afbbbac135d95e0984a5cc7cb554fccbd2ca27c5e423cebf3021ed058ac83eaa0f64b0d405fc99216209b7e56deeeefceb3629210d1cabcb8713545a50021bc40227b50301000000010000000000000000000000000000000000000000000000000000000000000000ffffffff0d0300b1050101062f503253482fffffffff010085fd36af050000232102c9cbaeb767cc8c884204601f322c6977890cdd3d274f8b1a704ae00382102191ac0000000001000000011fcccc77028fc5fb96d60ee5f258da271ba9b4fdec12594a5dd2efa1fb5bd14b010000006b483045022100f4a17664176706f74877433dbfb8e68a5c1e45730da9248a8da3bab833cea1ca022018fee77621c20f196b82c3c8fd663959b0c8ea985b0407bdbac1414a5a5a21bf0121033fcc1cb9c1b7b11758eb2cd3a25b4ff917a5e248f5d6fcc74160dd6a450acf8bffffffff020759dd6e000000001976a914a553c686ac1aa534ffcb3b694c463944175a6f3c88ac8548f276890700001976a914a1ea13863020f36897b671ad328d98e9364f12b488ac000000000100000001215c45fc31d3beae4a5c76efbb0925d0b4bace72f62248aa3777927eecb42152000000006b483045022100bd3f18da6acd8180ed99c7c7fc6feab18653008cc58be5c32a470193aea330860220719c64121805606240c48dab2e8e3f3d82501b78b78597043ca134abf4c85443012103e6435d9ad2a3f3ff2d2c58aef41075df4eb5417c313d3ea4d5bb87ab46241940ffffffff0140ab8aac140000001976a91481db1aa49ebc6a71cad96949eb28e22af85eb0bd88ac00000000");
+        let header = &block[0..398];
+        let pure_header = &header[0..80];
+        let auxpow = &header[80..];
+        let auxpow_coinbase_tx = &auxpow[..164];
+        let auxpow_parent_hash = &auxpow[164..196];
+        let auxpow_coinbase_branch = &auxpow[196..229];
+        let auxpow_coinbase_index = &auxpow[229..233];
+        let auxpow_blockchain_branch = &auxpow[233..234];
+        let auxpow_blockchain_index = &auxpow[234..238];
+        let auxpow_parent_block_header = &auxpow[238..];
+
+        let currhash = hex!("7080b9bfb2e765d3260b36af2fc097f6d5729062c6eaf9ac902b100b3548ead3");
+        let prevhash = hex!("1e21ad14bc1ef20cf2d58e2b755ae4a7bfb75c906c74ef3dbb97cc57dcd77581");
+        let merkle = hex!("b14423c43517df2b4f3277731daba29d0d865b515a6f19f5fb61d5799b28f2c9");
+
+        let decode: Result<Block, _> = deserialize(&block);
+        assert!(decode.is_ok());
+        let block_decode = decode.unwrap();
+
+        assert_eq!(serialize(&block_decode.header.block_hash()), currhash);
+        assert_eq!(block_decode.header.version, Version::from_consensus(6422786));
+        assert_eq!(serialize(&block_decode.header.prev_blockhash), prevhash);
+        assert_eq!(block_decode.header.merkle_root, block_decode.compute_merkle_root().unwrap());
+        assert_eq!(serialize(&block_decode.header.merkle_root), merkle);
+        assert_eq!(block_decode.header.time, 1410566068);
+        assert_eq!(block_decode.header.bits, CompactTarget::from_consensus(453486607));
+        assert_eq!(block_decode.header.nonce, 0);
+
+        // Should fail because AuxPow is used
+        assert_eq!(
+            block_decode.header.validate_pow_with_scrypt(block_decode.header.target()),
+            Err(ValidationError::BadProofOfWork)
+        );
+        // Bitcoin network is used because Dogecoin's difficulty calculation is based on Bitcoin's,
+        // which uses Bitcoin's `max_attainable_target` value
+        assert_eq!(block_decode.header.difficulty(BitcoinNetwork::Bitcoin), 8559);
+        assert_eq!(block_decode.header.difficulty_float(), 8559.417587564147);
+
+        assert!(block_decode.header.has_auxpow_bit());
+        assert_eq!(block_decode.header.extract_chain_id(), 98);
+        assert_eq!(block_decode.header.extract_base_version(), 2);
+        assert!(!block_decode.header.is_legacy());
+
+        assert!(block_decode.header.aux_pow.is_some());
+        let auxpow_decode = block_decode.header.aux_pow.as_ref().unwrap();
+        assert_eq!(serialize(&auxpow_decode.coinbase_tx), auxpow_coinbase_tx);
+        assert_eq!(auxpow_decode.parent_hash.to_byte_array(), auxpow_parent_hash);
+        assert_eq!(serialize(&auxpow_decode.coinbase_branch), auxpow_coinbase_branch);
+        assert_eq!(auxpow_decode.coinbase_index.to_le_bytes(), auxpow_coinbase_index);
+        assert_eq!(serialize(&auxpow_decode.blockchain_branch), auxpow_blockchain_branch);
+        assert_eq!(auxpow_decode.blockchain_index.to_le_bytes(), auxpow_blockchain_index);
+        assert_eq!(serialize(&auxpow_decode.parent_block_header), auxpow_parent_block_header);
+
+        assert_eq!(serialize(&auxpow_decode), auxpow);
+        assert_eq!(serialize(&block_decode.header.pure_header), pure_header);
+        assert_eq!(serialize(&block_decode.header), header);
+        assert_eq!(serialize(&block_decode), block);
+    }
+
     #[test]
     fn validate_pow_with_scrypt_test() {
         let some_header = hex!("01000000c76fe7f8ec09989d32b7907966fbd347134f80a7b71efce55fec502aa126ba3894b3065289ff8ba1ab4e8391771174d47cf2c974ebd24a1bdafd6c107d5a7a207d78bb52de8f001c00da8c3c");
@@ -401,14 +492,14 @@ mod tests {
         let params = Params::new(Network::Dogecoin);
         let epoch_start = genesis_block(&params).header;
         // Block 239, the only information used are `bits` and `time`
-        let current = Header {
+        let current = PureHeader {
             version: Version::ONE,
             prev_blockhash: BlockHash::all_zeros(),
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1386475638,
             bits: epoch_start.bits,
             nonce: epoch_start.nonce
-        };
+        }.into();
         let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
         let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
         assert_eq!(adjustment, adjustment_bits);
@@ -422,23 +513,23 @@ mod tests {
         let height = 1_131_290;
         let params = Params::new(Network::Dogecoin);
         // Block 1_131_288, the only information used is `time`
-        let epoch_start = Header {
+        let epoch_start = PureHeader {
             version: Version::from_consensus(6422787),
             prev_blockhash: BlockHash::from_str("ac0ffad025605732b310be7edf52111fa9511ffc54f06d21aab1c50d4085b39f").expect("failed to parse block hash"),
             merkle_root: TxMerkleNode::from_str("80c67973ef43f2df8a3641dac7da16ea59f55e4d77b9206c6e5cfa25d3bf094b").expect("failed to parse merkle root"),
             time: 1458248044,
             bits: CompactTarget::from_consensus(0x1b01e7c1),
             nonce: 0
-        };
+        }.into();
         // Block 1_131_289, the only information used are `bits` and `time`
-        let current = Header {
+        let current = PureHeader {
             version: Version::from_consensus(6422787),
             prev_blockhash: BlockHash::from_str("7724f7b3f9652ebc121ce101a10bfabd6815518b2814bd16f7a2dcc13dd121ec").expect("failed to parse block hash"),
             merkle_root: TxMerkleNode::from_str("33c13df68d2f74c76367659cc95436510ed5504ef3c53ae90679ec12ab4e8b81").expect("failed to parse merkle root"),
             time: 1458248269,
             bits: CompactTarget::from_consensus(0x1b01cf5d),
             nonce: 0
-        };
+        }.into();
         let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
         let adjustment_bits = CompactTarget::from_consensus(0x1b0269d1); // Block 1_131_290 compact target
         assert_eq!(adjustment, adjustment_bits);
@@ -453,23 +544,23 @@ mod tests {
         let params = Params::new(Network::Dogecoin);
         let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 479 compact target
         // Block 239, the only information used is `time`
-        let epoch_start = Header {
+        let epoch_start = PureHeader{
             version: Version::ONE,
             prev_blockhash: BlockHash::all_zeros(),
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1386475638,
             bits: starting_bits,
             nonce: 0
-        };
+        }.into();
         // Block 479, the only information used are `bits` and `time`
-        let current = Header {
+        let current = PureHeader{
             version: Version::ONE,
             prev_blockhash: BlockHash::all_zeros(),
             merkle_root: TxMerkleNode::all_zeros(),
             time: 1386475840,
             bits: starting_bits,
             nonce: 0
-        };
+        }.into();
         let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
         let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
         assert_eq!(adjustment, adjustment_bits);
@@ -483,23 +574,23 @@ mod tests {
         let height = 1_131_286;
         let params = Params::new(Network::Dogecoin);
         // Block 1_131_284, the only information used is `time`
-        let epoch_start = Header {
+        let epoch_start = PureHeader {
             version: Version::from_consensus(6422787),
             prev_blockhash: BlockHash::from_str("a695a2cc43bd5c5f32acecada764b8764b044f067909b997d4f98a6733c3fa70").expect("failed to parse block hash"),
             merkle_root: TxMerkleNode::from_str("806736d9e0cab2de97e7afc9f2031c5a0413c0bff00d82cc38fa0d568d2f7135").expect("failed to parse merkle root"),
             time: 1458247987,
             bits: CompactTarget::from_consensus(0x1b02f5b6),
             nonce: 0
-        };
+        }.into();
         // Block 1_131_285, the only information used are `bits` and `time`
-        let current = Header {
+        let current = PureHeader {
             version: Version::from_consensus(6422787),
             prev_blockhash: BlockHash::from_str("db185a7d97060e13dd53ff759f9280d473d7bb6fccc8883fbc8f1fa1f071fc82").expect("failed to parse block hash"),
             merkle_root: TxMerkleNode::from_str("20419a4d74c0284e241ca5d3c91ea2b533d8a6502e4b6e4a7f8a2fc50d42796e").expect("failed to parse merkle root"),
             time: 1458247995,
             bits: CompactTarget::from_consensus(0x1b029d4f),
             nonce: 0
-        };
+        }.into();
         let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
         let adjustment_bits = CompactTarget::from_consensus(0x1b025a60); // Block 1_131_286 compact target
         assert_eq!(adjustment, adjustment_bits);
diff --git a/bitcoin/src/dogecoin/params.rs b/bitcoin/src/dogecoin/params.rs
index 284116715..44a8b3f07 100644
--- a/bitcoin/src/dogecoin/params.rs
+++ b/bitcoin/src/dogecoin/params.rs
@@ -49,10 +49,16 @@ pub struct Params {
     pub max_attainable_target: Target,
     /// Expected amount of time to mine one block.
     pub pow_target_spacing: i64,
-    /// Determines whether retargeting is disabled for this network or not.
+    /// Whether retargeting is disabled for this network or not.
     pub no_pow_retargeting: bool,
     /// Height after which the Digishield difficulty adjustment algorithm is used.
     pub digishield_activation_height: u32,
+    /// Height after which merged mining is allowed.
+    pub auxpow_height: u32,
+    /// Whether to enforce that the parent and auxiliary block headers have different chain IDs.
+    pub strict_chain_id: bool,
+    /// Expected chain ID for validating AuxPoW headers.
+    pub auxpow_chain_id: i32,
 }
 
 /// The mainnet parameters.
@@ -86,6 +92,9 @@ impl Params {
             max_attainable_target: Target::MAX_ATTAINABLE_MAINNET_DOGE,
             pow_target_spacing: ONE_MINUTE,           // 1 minute
             no_pow_retargeting: false,
+            auxpow_height: 371_337,
+            strict_chain_id: true,
+            auxpow_chain_id: 0x0062,
             digishield_activation_height: 145000,
     };
 
@@ -103,6 +112,9 @@ impl Params {
             max_attainable_target: Target::MAX_ATTAINABLE_TESTNET_DOGE,
             pow_target_spacing: ONE_MINUTE,           // 1 minute
             no_pow_retargeting: false,
+            auxpow_height: 158_100,
+            strict_chain_id: false,
+            auxpow_chain_id: 0x0062,
             digishield_activation_height: 145000,
     };
 
@@ -120,6 +132,9 @@ impl Params {
             max_attainable_target: Target::MAX_ATTAINABLE_REGTEST_DOGE,
             pow_target_spacing: ONE_SECOND,            // regtest: 1 second blocks
             no_pow_retargeting: true,
+            auxpow_height: 20,
+            strict_chain_id: true,
+            auxpow_chain_id: 0x0062,
             digishield_activation_height: 10,
     };
 
@@ -162,6 +177,11 @@ impl Params {
             Network::Regtest => true,
         }
     }
+
+    /// Checks if legacy blocks can be mined at the given block height.
+    pub const fn allow_legacy_blocks(&self, height: u32) -> bool {
+        height < self.auxpow_height
+    }
 }
 
 impl AsRef<Params> for Params {
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index 962bb4203..12e15698e 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -19,7 +19,7 @@ use crate::block::Header;
 use crate::blockdata::block::BlockHash;
 use crate::consensus::encode::{self, Decodable, Encodable};
 use crate::consensus::Params;
-use crate::dogecoin::params::Params as DogecoinParams;
+use crate::dogecoin::{params::Params as DogecoinParams, Header as DogecoinHeader};
 use crate::error::{ContainsPrefixError, MissingPrefixError, ParseIntError, PrefixedHexError, UnprefixedHexError};
 
 /// Implement traits and methods shared by `Target` and `Work`.
@@ -582,8 +582,8 @@ impl CompactTarget {
     ///
     /// The expected [`CompactTarget`] recalculation.
     pub fn from_header_difficulty_adjustment_dogecoin(
-        last_epoch_boundary: Header,
-        current: Header,
+        last_epoch_boundary: DogecoinHeader,
+        current: DogecoinHeader,
         params: impl AsRef<DogecoinParams>,
         height: u32
     ) -> CompactTarget {

From a47e2d28e94e4c35341d7167abc70b6bc8e5967d Mon Sep 17 00:00:00 2001
From: Paul Liu <paul@dfinity.org>
Date: Thu, 4 Sep 2025 20:29:29 +0800
Subject: [PATCH 49/53] feat: make Header a parameter of NetworkMessage (#16)

Because Dogecoin's Header type is now different than Bitcoin's, The
NetworkMessage type has to take Header as a parameter too.
---
 bitcoin/examples/handshake.rs              |  4 +-
 bitcoin/src/p2p/message.rs                 | 68 +++++++++++++++-------
 fuzz/fuzz_targets/bitcoin/deser_net_msg.rs |  6 +-
 3 files changed, 53 insertions(+), 25 deletions(-)

diff --git a/bitcoin/examples/handshake.rs b/bitcoin/examples/handshake.rs
index 6c674bc05..77a55d0b7 100644
--- a/bitcoin/examples/handshake.rs
+++ b/bitcoin/examples/handshake.rs
@@ -9,8 +9,8 @@ use bitcoin::consensus::{encode, Decodable};
 use bitcoin::p2p::{self, address, message, message_network};
 use bitcoin::secp256k1::rand::Rng;
 
-type NetworkMessage = message::NetworkMessage<bitcoin::Block>;
-type RawNetworkMessage = message::RawNetworkMessage<bitcoin::Block>;
+type NetworkMessage = message::NetworkMessage<bitcoin::block::Header, bitcoin::Block>;
+type RawNetworkMessage = message::RawNetworkMessage<bitcoin::block::Header, bitcoin::Block>;
 
 fn main() {
     // This example establishes a connection to a Bitcoin node, sends the initial
diff --git a/bitcoin/src/p2p/message.rs b/bitcoin/src/p2p/message.rs
index 1b559afc8..36c9f8107 100644
--- a/bitcoin/src/p2p/message.rs
+++ b/bitcoin/src/p2p/message.rs
@@ -11,7 +11,7 @@ use core::{fmt, iter};
 use hashes::{sha256d, Hash};
 use io::{Read, Write};
 
-use crate::blockdata::{block, transaction};
+use crate::blockdata::transaction;
 use crate::consensus::encode::{self, CheckedData, Decodable, Encodable, VarInt};
 use crate::merkle_tree::MerkleBlock;
 use crate::p2p::address::{AddrV2Message, Address};
@@ -150,9 +150,9 @@ impl std::error::Error for CommandStringError {
 
 /// A Network message
 #[derive(Clone, Debug, PartialEq, Eq)]
-pub struct RawNetworkMessage<Block> {
+pub struct RawNetworkMessage<Header, Block> {
     magic: Magic,
-    payload: NetworkMessage<Block>,
+    payload: NetworkMessage<Header, Block>,
     payload_len: u32,
     checksum: [u8; 4],
 }
@@ -160,7 +160,7 @@ pub struct RawNetworkMessage<Block> {
 /// A Network message payload. Proper documentation is available on at
 /// [Bitcoin Wiki: Protocol Specification](https://en.bitcoin.it/wiki/Protocol_specification)
 #[derive(Clone, PartialEq, Eq, Debug)]
-pub enum NetworkMessage<Block> {
+pub enum NetworkMessage<Header, Block> {
     /// `version`
     Version(message_network::VersionMessage),
     /// `verack`
@@ -184,7 +184,7 @@ pub enum NetworkMessage<Block> {
     /// `block`
     Block(Block),
     /// `headers`
-    Headers(Vec<block::Header>),
+    Headers(Vec<Header>),
     /// `sendheaders`
     SendHeaders,
     /// `getaddr`
@@ -243,7 +243,7 @@ pub enum NetworkMessage<Block> {
     },
 }
 
-impl<Block> NetworkMessage<Block> {
+impl<Header, Block> NetworkMessage<Header, Block> {
     /// Return the message command as a static string reference.
     ///
     /// This returns `"unknown"` for [NetworkMessage::Unknown],
@@ -300,9 +300,9 @@ impl<Block> NetworkMessage<Block> {
     }
 }
 
-impl<Block: Encodable> RawNetworkMessage<Block> {
+impl<Header: Encodable, Block: Encodable> RawNetworkMessage<Header, Block> {
     /// Creates a [RawNetworkMessage]
-    pub fn new(magic: Magic, payload: NetworkMessage<Block>) -> Self {
+    pub fn new(magic: Magic, payload: NetworkMessage<Header, Block>) -> Self {
         let mut engine = sha256d::Hash::engine();
         let payload_len = payload.consensus_encode(&mut engine).expect("engine doesn't error");
         let payload_len = u32::try_from(payload_len).expect("network message use u32 as length");
@@ -312,12 +312,12 @@ impl<Block: Encodable> RawNetworkMessage<Block> {
     }
 
     /// Consumes the [RawNetworkMessage] instance and returns the inner payload.
-    pub fn into_payload(self) -> NetworkMessage<Block> {
+    pub fn into_payload(self) -> NetworkMessage<Header, Block> {
         self.payload
     }
 
     /// The actual message data
-    pub fn payload(&self) -> &NetworkMessage<Block> {
+    pub fn payload(&self) -> &NetworkMessage<Header, Block> {
         &self.payload
     }
 
@@ -335,9 +335,9 @@ impl<Block: Encodable> RawNetworkMessage<Block> {
     pub fn command(&self) -> CommandString { self.payload.command() }
 }
 
-struct HeaderSerializationWrapper<'a>(&'a Vec<block::Header>);
+struct HeaderSerializationWrapper<'a, Header>(&'a Vec<Header>);
 
-impl<'a> Encodable for HeaderSerializationWrapper<'a> {
+impl<'a, Header: Encodable> Encodable for HeaderSerializationWrapper<'a, Header> {
     #[inline]
     fn consensus_encode<W: Write + ?Sized>(&self, w: &mut W) -> Result<usize, io::Error> {
         let mut len = 0;
@@ -350,7 +350,7 @@ impl<'a> Encodable for HeaderSerializationWrapper<'a> {
     }
 }
 
-impl<Block: Encodable> Encodable for NetworkMessage<Block> {
+impl<Header: Encodable, Block: Encodable> Encodable for NetworkMessage<Header, Block> {
     fn consensus_encode<W: Write + ?Sized>(&self, writer: &mut W) -> Result<usize, io::Error> {
         match self {
             NetworkMessage::Version(ref dat) => dat.consensus_encode(writer),
@@ -395,7 +395,7 @@ impl<Block: Encodable> Encodable for NetworkMessage<Block> {
     }
 }
 
-impl<Block: Encodable> Encodable for RawNetworkMessage<Block> {
+impl<Header: Encodable, Block: Encodable> Encodable for RawNetworkMessage<Header, Block> {
     fn consensus_encode<W: Write + ?Sized>(&self, w: &mut W) -> Result<usize, io::Error> {
         let mut len = 0;
         len += self.magic.consensus_encode(w)?;
@@ -407,9 +407,9 @@ impl<Block: Encodable> Encodable for RawNetworkMessage<Block> {
     }
 }
 
-struct HeaderDeserializationWrapper(Vec<block::Header>);
+struct HeaderDeserializationWrapper<Header>(Vec<Header>);
 
-impl Decodable for HeaderDeserializationWrapper {
+impl<Header: Decodable> Decodable for HeaderDeserializationWrapper<Header> {
     #[inline]
     fn consensus_decode_from_finite_reader<R: Read + ?Sized>(
         r: &mut R,
@@ -435,7 +435,7 @@ impl Decodable for HeaderDeserializationWrapper {
     }
 }
 
-impl<Block: Decodable> Decodable for RawNetworkMessage<Block> {
+impl<Header: Decodable, Block: Decodable> Decodable for RawNetworkMessage<Header, Block> {
     fn consensus_decode_from_finite_reader<R: Read + ?Sized>(
         r: &mut R,
     ) -> Result<Self, encode::Error> {
@@ -549,9 +549,9 @@ mod test {
     use hex::test_hex_unwrap as hex;
 
     use super::message_network::{Reject, RejectReason, VersionMessage};
-    use super::{block, AddrV2Message, Address, CommandString, Magic, MerkleBlock};
+    use super::{AddrV2Message, Address, CommandString, Magic, MerkleBlock};
     use crate::bip152::BlockTransactionsRequest;
-    use crate::blockdata::block::Block;
+    use crate::blockdata::block;
     use crate::blockdata::script::ScriptBuf;
     use crate::blockdata::transaction::Transaction;
     use crate::consensus::encode::{deserialize, deserialize_partial, serialize};
@@ -563,14 +563,40 @@ mod test {
         CFCheckpt, CFHeaders, CFilter, GetCFCheckpt, GetCFHeaders, GetCFilters,
     };
     use crate::p2p::ServiceFlags;
+    use block::{Block, Header};
 
-    type NetworkMessage = super::NetworkMessage<Block>;
-    type RawNetworkMessage = super::RawNetworkMessage<Block>;
+    type NetworkMessage = super::NetworkMessage<Header, Block>;
+    type RawNetworkMessage = super::RawNetworkMessage<Header, Block>;
 
     fn hash(slice: [u8; 32]) -> Hash {
         Hash::from_slice(&slice).unwrap()
     }
 
+    #[test]
+    fn dogecoin_ser_der_raw_network_message_test() {
+        type NetworkMessage = super::NetworkMessage<crate::dogecoin::Header, crate::dogecoin::Block>;
+        type RawNetworkMessage = super::RawNetworkMessage<crate::dogecoin::Header, crate::dogecoin::Block>;
+
+        // Dogecoin mainnet block 62959fd2246701d38917fe59920523ad66111b68e360fe3a60ebdca2dd6d4546 (height 1000013)
+        let bytes = hex!("03016200916a0b2966c72c1bb533469388c7e5d771e0d5570e897fe98453baa8226c2d7e9d73ce00d335ed419b390659c89e3af25ab2ffc8db0f1144cbf2ab8867b140e23dbe6d569e42031b0000000001000000010000000000000000000000000000000000000000000000000000000000000000ffffffff3f0359c90d04566dbe3d2cfabe6d6df5cee89f3766065a3f9ddc4ab57a1adf830944af0ef431e9d4f59c2f4e8985e70800000000000000085600096a01000000ffffffff0100f90295000000001976a91457757ed3d226faf12bd43983896ec81e7fca369a88ac0000000010ce3fcdb40c53bb040487a2ff745a7384314d4c24809aba52a35c74a5be4ca5000000000003d7bec81d9cd6968e141a0d0c1645b9dcca96ab9fb57dbc6f63a4ef669a0ad099de79681c0a67d2f2de006742ab85320b9ecc7df8f9979eff946d1f6964d3ab5956b1698e938dbe001e487469ad0c84c1b008757a7a78908378db499a602949bd00000000030000005d24356ff4b4111265187fd2e89dc7e58019221fba2e4ad0ec789ed38bfd9be152ac7cf211bf53770edf319ccc29cf8692076446430a195ed1c55ad458612d1e3dbe6d56f542011b3a4a43490101000000010000000000000000000000000000000000000000000000000000000000000000ffffffff09034d420f04566dbe3dffffffff010010a5d4e80000001976a914d1895519d5281aa005487b1ff07f3307aced8d6e88ac00000000");
+
+        let block: crate::dogecoin::Block = deserialize(&bytes).unwrap();
+        let header: crate::dogecoin::Header = deserialize(&bytes[0..446]).unwrap();
+
+        assert!(header.aux_pow.is_some());
+
+        // Test only Block and Header messages, which are different than Bitcoin.
+        let msgs = vec![
+            NetworkMessage::Block(block),
+            NetworkMessage::Headers(vec![header]),
+        ];
+
+        for msg in msgs {
+            let raw_msg = RawNetworkMessage::new(Magic::from_bytes([57, 0, 0, 0]), msg);
+            assert_eq!(deserialize::<RawNetworkMessage>(&serialize(&raw_msg)).unwrap(), raw_msg);
+        }
+    }
+
     #[test]
     fn full_round_ser_der_raw_network_message_test() {
         let version_msg: VersionMessage = deserialize(&hex!("721101000100000000000000e6e0845300000000010000000000000000000000000000000000ffff0000000000000100000000000000fd87d87eeb4364f22cf54dca59412db7208d47d920cffce83ee8102f5361746f7368693a302e392e39392f2c9f040001")).unwrap();
diff --git a/fuzz/fuzz_targets/bitcoin/deser_net_msg.rs b/fuzz/fuzz_targets/bitcoin/deser_net_msg.rs
index f22b293ab..22b5dfcad 100644
--- a/fuzz/fuzz_targets/bitcoin/deser_net_msg.rs
+++ b/fuzz/fuzz_targets/bitcoin/deser_net_msg.rs
@@ -1,8 +1,10 @@
 use honggfuzz::fuzz;
 
 fn do_test(data: &[u8]) {
-    let _: Result<bitcoin::p2p::message::RawNetworkMessage<bitcoin::Block>, _> =
-        bitcoin::consensus::encode::deserialize(data);
+    let _: Result<
+        bitcoin::p2p::message::RawNetworkMessage<bitcoin::block::Header, bitcoin::Block>,
+        _,
+    > = bitcoin::consensus::encode::deserialize(data);
 }
 
 fn main() {

From d275ae7aa5f59f5bc14b42a3e2db364d8f53daeb Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Fri, 5 Sep 2025 10:43:22 +0200
Subject: [PATCH 50/53] test: add additional tests adapted from core's
 dogecoin_tests.cpp (#15)

This PR adds additional tests for the `from_next_work_required_dogecoin`
method and `params` module. The goal is to replicate the tests found in
Dogecoin core
[dogecoin_tests.cpp](https://github.com/dogecoin/dogecoin/blob/master/src/test/dogecoin_tests.cpp).
---
 bitcoin/src/dogecoin/mod.rs    | 362 +++++++++++++++++----------------
 bitcoin/src/dogecoin/params.rs |  39 ++++
 bitcoin/src/pow.rs             |   4 +-
 3 files changed, 224 insertions(+), 181 deletions(-)

diff --git a/bitcoin/src/dogecoin/mod.rs b/bitcoin/src/dogecoin/mod.rs
index ce248125f..8982af0df 100644
--- a/bitcoin/src/dogecoin/mod.rs
+++ b/bitcoin/src/dogecoin/mod.rs
@@ -432,229 +432,233 @@ mod tests {
     }
 
     #[test]
-    fn compact_target_from_downwards_difficulty_adjustment() {
-        let height = 240;
-        let params = Params::new(Network::Dogecoin);
-        let starting_bits = CompactTarget::from_consensus(0x1e0ffff0); // Genesis compact target on Mainnet
-        let start_time: i64 = 1386325540; // Genesis block unix time
-        let end_time: i64 = 1386475638; // Block 239 unix time
-        let timespan = end_time - start_time; // Slower than expected (150,098 seconds diff)
-        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
-        let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
-        assert_eq!(adjustment, adjustment_bits);
-    }
-
-    #[test]
-    fn compact_target_from_downards_difficulty_adjustment_digishield() {
-        let height = 1531886;
-        let params = Params::new(Network::Dogecoin);
-        let starting_bits = CompactTarget::from_consensus(0x1b01c45a); // Block 1_531_885 compact target
-        let start_time: i64 = 1483302792; // Block 1_531_884 unix time
-        let end_time: i64 = 1483302869; // Block 1_531_885 unix time
-        let timespan = end_time - start_time; // Slower than expected (77 seconds diff)
-        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
-        let adjustment_bits = CompactTarget::from_consensus(0x1b01d36e); // Block 1_531_886 compact target
-        assert_eq!(adjustment, adjustment_bits);
-    }
-
-    #[test]
-    fn compact_target_from_upwards_difficulty_adjustment() {
-        let height = 480;
-        let params = Params::new(Network::Dogecoin);
-        let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
-        let start_time: i64 = 1386475638; // Block 239 unix time
-        let end_time: i64 = 1386475840; // Block 479 unix time
-        let timespan = end_time - start_time; // Faster than expected (202 seconds diff)
-        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
-        let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
-        assert_eq!(adjustment, adjustment_bits);
-    }
-
-    #[test]
-    fn compact_target_from_upwards_difficulty_adjustment_digishield() {
-        let height = 1531882;
-        let params = Params::new(Network::Dogecoin);
-        let starting_bits = CompactTarget::from_consensus(0x1b01dc29); // Block 1_531_881 compact target
-        let start_time: i64 = 1483302572; // Block 1_531_880 unix time
-        let end_time: i64 = 1483302608; // Block 1_531_881 unix time
-        let timespan = end_time - start_time; // Faster than expected (36 seconds diff)
-        let adjustment = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
-        let adjustment_bits = CompactTarget::from_consensus(0x1b01c45a); // Block 1_531_882 compact target
-        assert_eq!(adjustment, adjustment_bits);
-    }
-
-    #[test]
-    fn compact_target_from_downwards_difficulty_adjustment_using_headers() {
-        use crate::{block::Version, dogecoin::constants::genesis_block, TxMerkleNode};
-        use hashes::Hash;
-
-        let height = 240;
-        let params = Params::new(Network::Dogecoin);
-        let epoch_start = genesis_block(&params).header;
-        // Block 239, the only information used are `bits` and `time`
-        let current = PureHeader {
-            version: Version::ONE,
-            prev_blockhash: BlockHash::all_zeros(),
-            merkle_root: TxMerkleNode::all_zeros(),
-            time: 1386475638,
-            bits: epoch_start.bits,
-            nonce: epoch_start.nonce
-        }.into();
-        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
-        let adjustment_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target
-        assert_eq!(adjustment, adjustment_bits);
-    }
-
-    #[test]
-    fn compact_target_from_downwards_difficulty_adjustment_using_headers_digishield() {
-        use crate::{block::Version, TxMerkleNode};
-        use std::str::FromStr;
-
-        let height = 1_131_290;
-        let params = Params::new(Network::Dogecoin);
-        // Block 1_131_288, the only information used is `time`
-        let epoch_start = PureHeader {
-            version: Version::from_consensus(6422787),
-            prev_blockhash: BlockHash::from_str("ac0ffad025605732b310be7edf52111fa9511ffc54f06d21aab1c50d4085b39f").expect("failed to parse block hash"),
-            merkle_root: TxMerkleNode::from_str("80c67973ef43f2df8a3641dac7da16ea59f55e4d77b9206c6e5cfa25d3bf094b").expect("failed to parse merkle root"),
-            time: 1458248044,
-            bits: CompactTarget::from_consensus(0x1b01e7c1),
-            nonce: 0
-        }.into();
-        // Block 1_131_289, the only information used are `bits` and `time`
-        let current = PureHeader {
-            version: Version::from_consensus(6422787),
-            prev_blockhash: BlockHash::from_str("7724f7b3f9652ebc121ce101a10bfabd6815518b2814bd16f7a2dcc13dd121ec").expect("failed to parse block hash"),
-            merkle_root: TxMerkleNode::from_str("33c13df68d2f74c76367659cc95436510ed5504ef3c53ae90679ec12ab4e8b81").expect("failed to parse merkle root"),
-            time: 1458248269,
-            bits: CompactTarget::from_consensus(0x1b01cf5d),
-            nonce: 0
-        }.into();
-        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
-        let adjustment_bits = CompactTarget::from_consensus(0x1b0269d1); // Block 1_131_290 compact target
-        assert_eq!(adjustment, adjustment_bits);
-    }
-
-    #[test]
-    fn compact_target_from_upwards_difficulty_adjustment_using_headers() {
-        use crate::{block::Version, TxMerkleNode};
-        use hashes::Hash;
-
+    fn compact_target_from_adjustment_is_max_target() {
         let height = 480;
         let params = Params::new(Network::Dogecoin);
-        let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 479 compact target
-        // Block 239, the only information used is `time`
-        let epoch_start = PureHeader{
-            version: Version::ONE,
-            prev_blockhash: BlockHash::all_zeros(),
-            merkle_root: TxMerkleNode::all_zeros(),
-            time: 1386475638,
-            bits: starting_bits,
-            nonce: 0
-        }.into();
-        // Block 479, the only information used are `bits` and `time`
-        let current = PureHeader{
-            version: Version::ONE,
-            prev_blockhash: BlockHash::all_zeros(),
-            merkle_root: TxMerkleNode::all_zeros(),
-            time: 1386475840,
-            bits: starting_bits,
-            nonce: 0
-        }.into();
-        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
-        let adjustment_bits = CompactTarget::from_consensus(0x1e00ffff); // Block 480 compact target
-        assert_eq!(adjustment, adjustment_bits);
+        let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Max target
+        let timespan =  4 * params.pow_target_timespan(height); // 4x Slower than expected
+        let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+        let want = params.max_attainable_target.to_compact_lossy();
+        assert_eq!(got, want);
     }
 
     #[test]
-    fn compact_target_from_upwards_difficulty_adjustment_using_headers_digishield() {
-        use crate::{block::Version, TxMerkleNode};
-        use std::str::FromStr;
-
-        let height = 1_131_286;
+    fn compact_target_from_adjustment_is_max_target_digishield() {
+        let height = 145_000;
         let params = Params::new(Network::Dogecoin);
-        // Block 1_131_284, the only information used is `time`
-        let epoch_start = PureHeader {
-            version: Version::from_consensus(6422787),
-            prev_blockhash: BlockHash::from_str("a695a2cc43bd5c5f32acecada764b8764b044f067909b997d4f98a6733c3fa70").expect("failed to parse block hash"),
-            merkle_root: TxMerkleNode::from_str("806736d9e0cab2de97e7afc9f2031c5a0413c0bff00d82cc38fa0d568d2f7135").expect("failed to parse merkle root"),
-            time: 1458247987,
-            bits: CompactTarget::from_consensus(0x1b02f5b6),
-            nonce: 0
-        }.into();
-        // Block 1_131_285, the only information used are `bits` and `time`
-        let current = PureHeader {
-            version: Version::from_consensus(6422787),
-            prev_blockhash: BlockHash::from_str("db185a7d97060e13dd53ff759f9280d473d7bb6fccc8883fbc8f1fa1f071fc82").expect("failed to parse block hash"),
-            merkle_root: TxMerkleNode::from_str("20419a4d74c0284e241ca5d3c91ea2b533d8a6502e4b6e4a7f8a2fc50d42796e").expect("failed to parse merkle root"),
-            time: 1458247995,
-            bits: CompactTarget::from_consensus(0x1b029d4f),
-            nonce: 0
-        }.into();
-        let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(epoch_start, current, params, height);
-        let adjustment_bits = CompactTarget::from_consensus(0x1b025a60); // Block 1_131_286 compact target
-        assert_eq!(adjustment, adjustment_bits);
+        let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Max target
+        let timespan =  5 * params.pow_target_timespan(height); // 5x Slower than expected
+        let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
+        let want = params.max_attainable_target.to_compact_lossy();
+        assert_eq!(got, want);
     }
 
     #[test]
-    fn compact_target_from_maximum_upward_difficulty_adjustment() {
+    fn compact_target_from_minimum_downward_difficulty_adjustment() {
         let pre_digishield_heights = vec![5_000, 10_000, 15_000];
         let digishield_heights = vec![145_000, 1_000_000];
-        let starting_bits = CompactTarget::from_consensus(0x1b025a60); // Arbitrary difficulty
+        let starting_bits = CompactTarget::from_consensus(0x1b02f5b6); // Arbitrary difficulty
         let params = Params::new(Network::Dogecoin);
         for height in pre_digishield_heights {
-            let timespan = (0.06 * params.pow_target_timespan(height) as f64) as i64; // > 16x Faster than expected
+            let timespan =  4 * params.pow_target_timespan(height); // 4x Slower than expected
             let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
             let want = Target::from_compact(starting_bits)
-                .min_transition_threshold_dogecoin(&params, height)
+                .max_transition_threshold_dogecoin(&params, height)
                 .to_compact_lossy();
             assert_eq!(got, want);
         }
         for height in digishield_heights {
-            let timespan = -params.pow_target_timespan(height); // Negative timespan
+            let timespan = 5 * params.pow_target_timespan(height); // 5x Slower than expected
             let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
             let want = Target::from_compact(starting_bits)
-                .min_transition_threshold_dogecoin(&params, height)
+                .max_transition_threshold_dogecoin(&params, height)
                 .to_compact_lossy();
             assert_eq!(got, want);
         }
     }
 
     #[test]
-    fn compact_target_from_minimum_downward_difficulty_adjustment() {
+    fn should_compute_target() {
+        #[derive(Debug)]
+        struct TestCase<'a> {
+            name: &'a str,
+            height: u32,
+            starting_bits: CompactTarget,
+            start_time: i64,
+            end_time: i64,
+            expected_adjustment_bits: CompactTarget,
+        }
+
+        let test_cases = vec![
+            TestCase {
+                name: "Downwards difficulty adjustment (timespan: 150,098 s, slower than expected)",
+                height: 240,
+                starting_bits: CompactTarget::from_consensus(0x1e0ffff0), // Genesis compact target on Mainnet
+                start_time: 1386325540, // Genesis block unix time
+                end_time: 1386475638, // Block 239 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1e0fffff) // Block 240 compact target
+            },
+            // Adapted from: <https://github.com/dogecoin/dogecoin/blob/7237da74b8c356568644cbe4fba19d994704355b/src/test/dogecoin_tests.cpp#L151>
+            TestCase {
+                name: "Downwards difficulty adjustment Digishield (timespan: 252 s, slower than expected)",
+                height: 145_000,
+                starting_bits: CompactTarget::from_consensus(0x1b499dfd), // Block 145_000 compact target,
+                start_time: 1395094427, // Block 144_999 unix time
+                end_time: 1395094679, // Block 145_000 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1b671062), // Block 145_001 compact target
+            },
+            // Adapted from: <https://github.com/dogecoin/dogecoin/blob/7237da74b8c356568644cbe4fba19d994704355b/src/test/dogecoin_tests.cpp#L166>
+            TestCase {
+                name: "Downwards difficulty adjustment Digishield (timespan: 525 s, slower than expected)",
+                height: 145_000,
+                starting_bits: CompactTarget::from_consensus(0x1b3439cd), // Block 145_107 compact target
+                start_time: 1395100835, // Block 145_106 unix time
+                end_time: 1395101360, // Block 145_107 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1b4e56b3), // Block 145_108 compact target
+            },
+            TestCase {
+                name: "Downwards difficulty adjustment Digishield (timespan: 225 s, slower than expected)",
+                height: 1_131_290,
+                starting_bits: CompactTarget::from_consensus(0x1b01cf5d), // Block 1_131_289 compact target
+                start_time: 1458248044, // Block 1_131_288 unix time
+                end_time: 1458248269, // Block 1_131_289 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1b0269d1) // Block 1_131_290 compact target
+            },
+            TestCase {
+                name: "Downwards difficulty adjustment Digishield (timespan: 77 s, slower than expected)",
+                height: 1_531_886,
+                starting_bits: CompactTarget::from_consensus(0x1b01c45a), // Block 1_531_885 compact target
+                start_time: 1483302792, // Block 1_531_884 unix time
+                end_time: 1483302869, // Block 1_531_885 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1b01d36e) // Block 1_531_886 compact target
+            },
+            TestCase {
+                name: "Upwards difficulty adjustment (timespan: 202 s, faster than expected)",
+                height: 480,
+                starting_bits: CompactTarget::from_consensus(0x1e0fffff), // Block 240 compact target
+                start_time: 1386475638, // Block 239 unix time
+                end_time: 1386475840, // Block 479 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1e00ffff) // Block 480 compact target
+            },
+            // Adapted from: <https://github.com/dogecoin/dogecoin/blob/7237da74b8c356568644cbe4fba19d994704355b/src/test/dogecoin_tests.cpp#L137>
+            TestCase {
+                name: "Upwards difficulty adjustment (timespan: 12,105 s, faster than expected)",
+                height: 0,
+                starting_bits: CompactTarget::from_consensus(0x1c1a1206), // Block 9_359 compact target,
+                start_time: 1386942008, // Block 9_359 unix time,
+                end_time: 1386954113, // Block 9_599 unix time,
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1c15ea59), // Block 9_600 compact target,
+            },
+            // Adapted from: <https://github.com/dogecoin/dogecoin/blob/7237da74b8c356568644cbe4fba19d994704355b/src/test/dogecoin_tests.cpp#L181>
+            TestCase {
+                name: "Upwards difficulty adjustment Digishield (timespan: -70 s, faster than expected)",
+                height: 145_000,
+                starting_bits: CompactTarget::from_consensus(0x1b446f21), // Block 149_423 compact target
+                start_time: 1395380517, // Block 149_422 unix time
+                end_time: 1395380447, // Block 149_423 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1b335358), // Block 149_424 compact target
+            },
+            TestCase {
+                name: "Upwards difficulty adjustment Digishield (timespan: 8 s, faster than expected)",
+                height: 1_131_286,
+                starting_bits: CompactTarget::from_consensus(0x1b029d4f), // Block 1_131_285 compact target
+                start_time: 1458247987, // Block 1_131_284 unix time
+                end_time: 1458247995, // Block 1_131_285 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1b025a60) // Block 1_131_286 compact target
+            },
+            TestCase {
+                name: "Upwards difficulty adjustment Digishield (timespan: 36 s, faster than expected)",
+                height: 1_531_882,
+                starting_bits: CompactTarget::from_consensus(0x1b01dc29), // Block 1_531_881 compact target
+                start_time: 1483302572, // Block 1_531_880 unix time
+                end_time: 1483302608, // Block 1_531_881 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1b01c45a) // Block 1_531_882 compact target
+            },
+            // Adapted from: <https://github.com/dogecoin/dogecoin/blob/7237da74b8c356568644cbe4fba19d994704355b/src/test/dogecoin_tests.cpp#L196>
+            TestCase {
+                name: "Difficulty adjustment rounding Digishield (timespan: 48 s, faster than expected)",
+                height: 145_000,
+                starting_bits: CompactTarget::from_consensus(0x1b671062), // Block 145_001 compact target
+                start_time: 1395094679, // Block 145_000 unix time
+                end_time: 1395094727, // Block 145_001 unix time
+                expected_adjustment_bits: CompactTarget::from_consensus(0x1b6558a4), // Block 145_002 compact target
+            },
+        ];
+
+        let params = Params::new(Network::Dogecoin);
+
+        // Test difficulty adjustment
+        for test_case in test_cases.iter() {
+            let timespan = test_case.end_time - test_case.start_time;
+            let adjustment = CompactTarget::from_next_work_required_dogecoin(
+                test_case.starting_bits,
+                timespan,
+                &params,
+                test_case.height,
+            );
+            assert_eq!(
+                adjustment, test_case.expected_adjustment_bits,
+                "Unexpected adjustment bits for test case: {}",
+                test_case.name
+            );
+        }
+
+        // Test difficulty adjustment using headers
+        for test_case in test_cases.iter() {
+            let start_header = PureHeader {
+                version: Version::ONE,
+                prev_blockhash: BlockHash::all_zeros(),
+                merkle_root: TxMerkleNode::all_zeros(),
+                time: test_case.start_time as u32,
+                bits: CompactTarget::from_consensus(0x1e0fffff), // Note: this value does not matter
+                nonce: 0
+            }.into();
+            let end_header = PureHeader {
+                version: Version::ONE,
+                prev_blockhash: BlockHash::all_zeros(),
+                merkle_root: TxMerkleNode::all_zeros(),
+                time: test_case.end_time as u32,
+                bits: test_case.starting_bits,
+                nonce: 0
+            }.into();
+            let adjustment = CompactTarget::from_header_difficulty_adjustment_dogecoin(
+                start_header,
+                end_header,
+                &params,
+                test_case.height
+            );
+            assert_eq!(
+                adjustment, test_case.expected_adjustment_bits,
+                "Unexpected adjustment bits for test case using headers: {}",
+                test_case.name
+            );
+        }
+    }
+
+    #[test]
+    fn compact_target_from_maximum_upward_difficulty_adjustment() {
         let pre_digishield_heights = vec![5_000, 10_000, 15_000];
         let digishield_heights = vec![145_000, 1_000_000];
-        let starting_bits = CompactTarget::from_consensus(0x1b02f5b6); // Arbitrary difficulty
+        let starting_bits = CompactTarget::from_consensus(0x1b025a60); // Arbitrary difficulty
         let params = Params::new(Network::Dogecoin);
         for height in pre_digishield_heights {
-            let timespan =  4 * params.pow_target_timespan(height); // 4x Slower than expected
+            let timespan = (0.06 * params.pow_target_timespan(height) as f64) as i64; // > 16x Faster than expected
             let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
             let want = Target::from_compact(starting_bits)
-                .max_transition_threshold_dogecoin(&params, height)
+                .min_transition_threshold_dogecoin(&params, height)
                 .to_compact_lossy();
             assert_eq!(got, want);
         }
         for height in digishield_heights {
-            let timespan = 5 * params.pow_target_timespan(height); // 5x Slower than expected
+            let timespan = -params.pow_target_timespan(height); // Negative timespan
             let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
             let want = Target::from_compact(starting_bits)
-                .max_transition_threshold_dogecoin(&params, height)
+                .min_transition_threshold_dogecoin(&params, height)
                 .to_compact_lossy();
             assert_eq!(got, want);
         }
     }
 
-    #[test]
-    fn compact_target_from_adjustment_is_max_target() {
-        let height = 480;
-        let params = Params::new(Network::Dogecoin);
-        let starting_bits = CompactTarget::from_consensus(0x1e0fffff); // Block 240 compact target (max target)
-        let timespan =  4 * params.pow_target_timespan(height); // 4x Slower than expected
-        let got = CompactTarget::from_next_work_required_dogecoin(starting_bits, timespan, &params, height);
-        let want = params.max_attainable_target.to_compact_lossy();
-        assert_eq!(got, want);
-    }
-
     #[test]
     fn roundtrip_compact_target() {
         let consensus = 0x1e0f_ffff;
diff --git a/bitcoin/src/dogecoin/params.rs b/bitcoin/src/dogecoin/params.rs
index 44a8b3f07..d5af4c7d9 100644
--- a/bitcoin/src/dogecoin/params.rs
+++ b/bitcoin/src/dogecoin/params.rs
@@ -215,4 +215,43 @@ mod tests {
             assert!(Params::REGTEST.is_digishield_activated(height));
         }
     }
+
+    #[test]
+    fn hardfork_parameters() {
+        let params = &Params::MAINNET;
+
+        // Initial parameters (pre-Digishield era)
+        let initial_height = 0;
+        assert_eq!(params.pow_target_timespan(initial_height), 14400); // 4 hours
+        assert!(params.allow_legacy_blocks(initial_height));
+        assert!(!params.is_digishield_activated(initial_height));
+
+        let initial_end_height = 144999;
+        assert_eq!(params.pow_target_timespan(initial_end_height), 14400); // 4 hours
+        assert!(params.allow_legacy_blocks(initial_end_height));
+        assert!(!params.is_digishield_activated(initial_end_height));
+
+        // Digishield parameters
+        let digishield_height = 145000;
+        assert_eq!(params.pow_target_timespan(digishield_height), 60); // 1 minute
+        assert!(params.allow_legacy_blocks(digishield_height));
+        assert!(params.is_digishield_activated(digishield_height));
+
+        let digishield_end_height = 371336;
+        assert_eq!(params.pow_target_timespan(digishield_end_height), 60); // 1 minute
+        assert!(params.allow_legacy_blocks(digishield_end_height));
+        assert!(params.is_digishield_activated(digishield_end_height));
+
+        // AuxPow parameters
+        let auxpow_height = 371337;
+        assert_eq!(params.pow_target_timespan(auxpow_height), 60); // 1 minute
+        assert!(!params.allow_legacy_blocks(auxpow_height));
+        assert!(params.is_digishield_activated(auxpow_height));
+
+        // Arbitrary point after last hard-fork
+        let auxpow_high_height = 700000;
+        assert_eq!(params.pow_target_timespan(auxpow_high_height), 60); // 1 minute
+        assert!(!params.allow_legacy_blocks(auxpow_high_height));
+        assert!(params.is_digishield_activated(auxpow_high_height));
+    }
 }
diff --git a/bitcoin/src/pow.rs b/bitcoin/src/pow.rs
index 12e15698e..3670656a3 100644
--- a/bitcoin/src/pow.rs
+++ b/bitcoin/src/pow.rs
@@ -587,9 +587,9 @@ impl CompactTarget {
         params: impl AsRef<DogecoinParams>,
         height: u32
     ) -> CompactTarget {
-        let timespan = current.time - last_epoch_boundary.time;
+        let timespan = (current.time as i64) - (last_epoch_boundary.time as i64);
         let bits = current.bits;
-        CompactTarget::from_next_work_required_dogecoin(bits, timespan.into(), params, height)
+        CompactTarget::from_next_work_required_dogecoin(bits, timespan, params, height)
     }
 
     /// Creates a [`CompactTarget`] from a consensus encoded `u32`.

From 556c95e6eeae94c6e22f09a9193c75280d9cb0ae Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Mon, 3 Nov 2025 08:52:44 +0100
Subject: [PATCH 51/53] chore: update README.md (#17)

Updates the README.md file to references the upstream rust-bitcoin
README file and list the main differences between rust-dogecoin and
rust-bitcoin.
---
 .github/workflows/cron-daily-kani.yml |   4 +-
 .github/workflows/rust.yml            |   4 +-
 README.md                             | 212 +++++---------------------
 bitcoin/src/taproot/mod.rs            |   2 +-
 4 files changed, 40 insertions(+), 182 deletions(-)

diff --git a/.github/workflows/cron-daily-kani.yml b/.github/workflows/cron-daily-kani.yml
index dff1e54be..9b1e7ecaf 100644
--- a/.github/workflows/cron-daily-kani.yml
+++ b/.github/workflows/cron-daily-kani.yml
@@ -5,10 +5,12 @@ on:
     - cron: '59 23 * * *'       # midnight every day.
 jobs:
   run-kani:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     steps:
       - name: 'Checkout your code.'
         uses: actions/checkout@v4
 
       - name: 'Run Kani on your code.'
         uses: model-checking/kani-github-action@v1.1
+        with:
+          args: "--package bitcoin --package bitcoin-units"
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index bbb2a6f00..f25170545 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -295,11 +295,11 @@ jobs:
 
   Kani:
     name: Kani codegen - stable toolchain
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     steps:
       - name: "Checkout repo"
         uses: actions/checkout@v4
       - name: "Build Kani proofs"
         uses: model-checking/kani-github-action@v1.1
         with:
-          args: "--only-codegen"
+          args: "--only-codegen --package bitcoin --package bitcoin-units"
diff --git a/README.md b/README.md
index 664950da2..b7ecd9b82 100644
--- a/README.md
+++ b/README.md
@@ -1,71 +1,67 @@
 <div align="center">
-  <h1>Rust Bitcoin</h1>
+  <h1>Rust Dogecoin</h1>
 
   <img alt="Rust Bitcoin logo by Hunter Trujillo, see license and source files under /logo" src="./logo/rust-bitcoin.png" width="300" />
 
   <p>Library with support for de/serialization, parsing and executing on data-structures
-    and network messages related to Bitcoin.
+    and network messages related to Dogecoin.
   </p>
 
   <p>
     <a href="https://crates.io/crates/bitcoin"><img alt="Crate Info" src="https://img.shields.io/crates/v/bitcoin.svg"/></a>
-    <a href="https://github.com/rust-bitcoin/rust-bitcoin/blob/master/LICENSE"><img alt="CC0 1.0 Universal Licensed" src="https://img.shields.io/badge/license-CC0--1.0-blue.svg"/></a>
+    <a href="https://github.com/rust-dogecoin/rust-dogecoin/blob/doge-master/LICENSE"><img alt="Apache License 2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg"/></a>
     <a href="https://github.com/rust-bitcoin/rust-bitcoin/actions?query=workflow%3AContinuous%20integration"><img alt="CI Status" src="https://github.com/rust-bitcoin/rust-bitcoin/workflows/Continuous%20integration/badge.svg"></a>
     <a href="https://docs.rs/bitcoin"><img alt="API Docs" src="https://img.shields.io/badge/docs.rs-bitcoin-green"/></a>
     <a href="https://blog.rust-lang.org/2021/11/01/Rust-1.56.1.html"><img alt="Rustc Version 1.56.1+" src="https://img.shields.io/badge/rustc-1.56.1%2B-lightgrey.svg"/></a>
-    <a href="https://gnusha.org/bitcoin-rust/"><img alt="Chat on IRC" src="https://img.shields.io/badge/irc-%23bitcoin--rust%20on%20libera.chat-blue"></a>
-    <a href="https://github.com/model-checking/kani"><imp alt="kani" src="https://github.com/rust-bitcoin/rust-bitcoin/actions/workflows/kani.yaml/badge.svg"></a>
+    <a href="https://github.com/model-checking/kani"><img alt="kani" src="https://github.com/rust-bitcoin/rust-bitcoin/workflows/Kani%20CI/badge.svg"></a>
   </p>
 </div>
 
-[Documentation](https://docs.rs/bitcoin/)
+This library is a fork of [rust-bitcoin](https://github.com/rust-bitcoin/rust-bitcoin), adapted to support the **Dogecoin** network. For reference, see the original [rust-bitcoin README](https://github.com/dfinity/rust-dogecoin/blob/master/README.md).
 
-Supports (or should support)
+The goal of this project is to provide Dogecoin-compatible types, consensus rules, and utilities, following the architecture of rust-bitcoin, in particular:
 
-* De/serialization of Bitcoin protocol network messages
-* De/serialization of blocks and transactions
-* Script de/serialization
-* Private keys and address creation, de/serialization and validation (including full BIP32 support)
-* PSBT v0 de/serialization and all but the Input Finalizer role. Use [rust-miniscript](https://docs.rs/miniscript/latest/miniscript/psbt/index.html) to finalize.
+- **Scrypt PoW**: Scrypt-based proof-of-work validation (instead of SHA-256d used in Bitcoin)
+- **AuxPoW/Merged Mining**: AuxPow validation and Dogecoin's merged mining with other chains
+- **Difficulty Adjustment**: Dogecoin difficulty adjustment algorithms (pre-Digishield and Digishield)
+- **Network Parameters**: Consensus parameters for mainnet, testnet, and regtest
+- **Addresses**: Dogecoin-specific base58 addresses (P2PKH and P2SH)
+- **Genesis Blocks**: Genesis block definitions for mainnet, testnet, and regtest
 
-For JSONRPC interaction with Bitcoin Core, it is recommended to use
-[rust-bitcoincore-rpc](https://github.com/rust-bitcoin/rust-bitcoincore-rpc).
+## Differences from rust-bitcoin
 
-It is recommended to always use [cargo-crev](https://github.com/crev-dev/cargo-crev) to verify the
-trustworthiness of each of your dependencies, including this one.
+### 1. Core rust-bitcoin code modifications
 
-## Known limitations
+The following core files have been modified from the upstream rust-bitcoin library:
 
-### Consensus
+- `bitcoin/src/blockdata/block.rs`: Add scrypt-based proof-of-work validation (`block_hash_with_scrypt()` and `validate_pow_with_scrypt()`) to support Dogecoin's scrypt hashing algorithm.
 
-This library **must not** be used for consensus code (i.e. fully validating blockchain data). It
-technically supports doing this, but doing so is very ill-advised because there are many deviations,
-known and unknown, between this library and the Bitcoin Core reference implementation. In a
-consensus based cryptocurrency such as Bitcoin it is critical that all parties are using the same
-rules to validate data, and this library is simply unable to implement the same rules as Core.
+- `bitcoin/src/pow.rs`: Implement Dogecoin's difficulty adjustment algorithms:
+  - Pre-Digishield (blocks 0-144,999) with variable transition thresholds based on block height ranges
+  - Digishield (blocks 145,000+)
+  - Helper methods `min_transition_threshold_dogecoin()` and `max_transition_threshold_dogecoin()` for proper difficulty bounds
 
-Given the complexity of both C++ and Rust, it is unlikely that this will ever be fixed, and there
-are no plans to do so. Of course, patches to fix specific consensus incompatibilities are welcome.
+- `bitcoin/src/p2p/message.rs`: Generic `RawNetworkMessage` and `NetworkMessage` over `Header` and `Block` types to support both Bitcoin and Dogecoin block and header formats (which can include AuxPoW information).
 
-### Support for 16-bit pointer sizes
+### 2. Dogecoin-Specific module ([bitcoin/src/dogecoin/](bitcoin/src/dogecoin/))
 
-16-bit pointer sizes are not supported and we can't promise they will be. If you care about them
-please let us know, so we can know how large the interest is and possibly decide to support them.
+A Dogecoin module has been added with the following components:
 
-## Documentation
+- `mod.rs`: Dogecoin types including:
+  - `Header`: Dogecoin block header with optional AuxPoW information
+  - `Block`: Dogecoin block structure supporting both legacy and merged-mined blocks
+  - `Network`: Dogecoin network enum (mainnet, testnet, regtest)
 
-Currently can be found on [docs.rs/bitcoin](https://docs.rs/bitcoin/). Patches to add usage examples
-and to expand on existing docs would be extremely appreciated.
+- `auxpow.rs`: Implementation of Auxiliary Proof-of-Work (merged mining) validation
 
-## Contributing
+- `params.rs`: Dogecoin consensus parameters for all networks (mainnet, testnet, regtest), such as Digishield and AuxPoW activation height,
+BIP activation heights, target spacing, max attainable targets, etc
 
-Contributions are generally welcome. If you intend to make larger changes please discuss them in an
-issue before PRing them to avoid duplicate work and architectural mismatches. If you have any
-questions or ideas you want to discuss please join us in
-[#bitcoin-rust](https://web.libera.chat/?channel=#bitcoin-rust) on
-[libera.chat](https://libera.chat).
+- `constants.rs`: Dogecoin-specific constants, such as Genesis block definition, and address prefixes
 
-For more information please see `./CONTRIBUTING.md`.
+- `address/`: Dogecoin address handling with support for P2PKH and P2SH address types
+
+**Note**: Advanced Bitcoin features such as Taproot, SegWit v1, and PSBT v2 are not applicable to Dogecoin and are not supported in this fork.
 
 ## Minimum Supported Rust Version (MSRV)
 
@@ -74,146 +70,6 @@ This library should always compile with any combination of features on **Rust 1.
 To build with the MSRV you will likely need to pin a bunch of dependencies, see `./contrib/test.sh`
 for the current list.
 
-## External dependencies
-
-We integrate with a few external libraries, most notably `serde`. These
-are available via feature flags. To ensure compatibility and MSRV stability we
-provide two lock files as a means of inspecting compatible versions:
-`Cargo-minimal.lock` containing minimal versions of dependencies and
-`Cargo-recent.lock` containing recent versions of dependencies tested in our CI.
-
-We do not provide any guarantees about the content of these lock files outside
-of "our CI didn't fail with these versions". Specifically, we do not guarantee
-that the committed hashes are free from malware. It is your responsibility to
-review them.
-
-## Installing Rust
-
-Rust can be installed using your package manager of choice or [rustup.rs](https://rustup.rs). The
-former way is considered more secure since it typically doesn't involve trust in the CA system. But
-you should be aware that the version of Rust shipped by your distribution might be out of date.
-Generally this isn't a problem for `rust-bitcoin` since we support much older versions than the
-current stable one (see MSRV section).
-
-## Building
-
-The cargo feature `std` is enabled by default. At least one of the features `std` or `no-std` or
-both must be enabled.
-
-Enabling the `no-std` feature does not disable `std`. To disable the `std` feature you must disable
-default features. The `no-std` feature only enables additional features required for this crate to
-be usable without `std`. Both can be enabled without conflict.
-
-The library can be built and tested using [`cargo`](https://github.com/rust-lang/cargo/):
-
-```
-git clone git@github.com:rust-bitcoin/rust-bitcoin.git
-cd rust-bitcoin
-cargo build
-```
-
-You can run tests with:
-
-```
-cargo test
-```
-
-Please refer to the [`cargo` documentation](https://doc.rust-lang.org/stable/cargo/) for more
-detailed instructions.
-
-### Just
-
-We support [`just`](https://just.systems/man/en/) for running dev workflow commands. Run `just` from
-your shell to see list available sub-commands.
-
-### Building the docs
-
-We build docs with the nightly toolchain, you may wish to use the following shell alias to check
-your documentation changes build correctly.
-
-```
-alias build-docs='RUSTDOCFLAGS="--cfg docsrs" cargo +nightly rustdoc --features="$FEATURES" -- -D rustdoc::broken-intra-doc-links'
-```
-
-## Testing
-
-Unit and integration tests are available for those interested, along with benchmarks. For project
-developers, especially new contributors looking for something to work on, we do:
-
-- Fuzz testing with [`Hongfuzz`](https://github.com/rust-fuzz/honggfuzz-rs)
-- Mutation testing with [`Mutagen`](https://github.com/llogiq/mutagen)
-- Code verification with [`Kani`](https://github.com/model-checking/kani)
-
-There are always more tests to write and more bugs to find, contributions to our testing efforts
-extremely welcomed. Please consider testing code a first class citizen, we definitely do take PRs
-improving and cleaning up test code.
-
-### Unit/Integration tests
-
-Run as for any other Rust project `cargo test --all-features`.
-
-### Benchmarks
-
-We use a custom Rust compiler configuration conditional to guard the bench mark code. To run the
-bench marks use: `RUSTFLAGS='--cfg=bench' cargo +nightly bench`.
-
-### Mutation tests
-
-We have started doing mutation testing with [mutagen](https://github.com/llogiq/mutagen). To run
-these tests first install the latest dev version with `cargo +nightly install --git https://github.com/llogiq/mutagen`
-then run with `RUSTFLAGS='--cfg=mutate' cargo +nightly mutagen`.
-
-### Code verification
-
-We have started using [kani](https://github.com/model-checking/kani), install with `cargo install --locked kani-verifier`
- (no need to run `cargo kani setup`). Run the tests with `cargo kani`.
-
-## Pull Requests
-
-Every PR needs at least two reviews to get merged. During the review phase maintainers and
-contributors are likely to leave comments and request changes. Please try to address them, otherwise
-your PR might get closed without merging after a longer time of inactivity. If your PR isn't ready
-for review yet please mark it by prefixing the title with `WIP: `.
-
-### CI Pipeline
-
-The CI pipeline requires approval before being run on each MR.
-
-In order to speed up the review process the CI pipeline can be run locally using
-[act](https://github.com/nektos/act). The `fuzz` and `Cross` jobs will be skipped when using `act`
-due to caching being unsupported at this time. We do not *actively* support `act` but will merge PRs
-fixing `act` issues.
-
-### Githooks
-
-To assist devs in catching errors _before_ running CI we provide some githooks. If you do not
-already have locally configured githooks you can use the ones in this repository by running, in the
-root directory of the repository:
-```
-git config --local core.hooksPath githooks/
-```
-
-Alternatively add symlinks in your `.git/hooks` directory to any of the githooks we provide.
-
-## Policy on Altcoins/Altchains
-
-Since the altcoin landscape includes projects which [frequently appear and disappear, and are poorly
-designed anyway](https://download.wpsoftware.net/bitcoin/alts.pdf) we do not support any altcoins.
-Supporting Bitcoin properly is already difficult enough and we do not want to increase the
-maintenance burden and decrease API stability by adding support for other coins.
-
-Our code is public domain so by all means fork it and go wild :)
-
-
-## Release Notes
-
-Release notes are done per crate, see:
-
-- [bitcoin CHANGELOG](bitcoin/CHANGELOG.md)
-- [hashes CHANGELOG](hashes/CHANGELOG.md)
-- [internals CHANGELOG](internals/CHANGELOG.md)
-
-
 ## Licensing
 
 This project is a fork of [rust-bitcoin](https://github.com/rust-bitcoin/rust-bitcoin/tree/master), originally licensed under CC0 v1.0 Universal.
diff --git a/bitcoin/src/taproot/mod.rs b/bitcoin/src/taproot/mod.rs
index 54576c578..f44e318ac 100644
--- a/bitcoin/src/taproot/mod.rs
+++ b/bitcoin/src/taproot/mod.rs
@@ -703,7 +703,7 @@ impl TapTree {
     /// Gets the inner [`NodeInfo`] of this tree root.
     pub fn into_node_info(self) -> NodeInfo { self.0 }
 
-    /// Returns [`TapTreeIter<'_>`] iterator for a taproot script tree, operating in DFS order over
+    /// Returns [`ScriptLeaves<'_>`] iterator for a taproot script tree, operating in DFS order over
     /// tree [`ScriptLeaf`]s.
     pub fn script_leaves(&self) -> ScriptLeaves { ScriptLeaves { leaf_iter: self.0.leaf_nodes() } }
 

From df5bb2c4a2422cec3cf0bf699074a5d07ed7560e Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Fri, 7 Nov 2025 13:18:51 +0100
Subject: [PATCH 52/53] chore: add changelog v0.32.5-doge.0 and rust dogecoin
 logo (#18)

---
 .github/workflows/cron-daily-kani.yml |   2 +-
 .github/workflows/rust.yml            |   2 +-
 Cargo.toml                            |   2 +-
 README.md                             |  11 +-
 bitcoin/CHANGELOG.md                  |  41 +++++
 bitcoin/Cargo.toml                    |   9 +-
 bitcoin/embedded/Cargo.toml           |   2 +-
 bitcoin/src/lib.rs                    |   8 +-
 fuzz/Cargo.toml                       |   2 +-
 logo/README.md                        |  27 +--
 logo/rust-bitcoin-inkscape.svg        | 244 --------------------------
 logo/rust-bitcoin-large.png           | Bin 87059 -> 0 bytes
 logo/rust-bitcoin-optimized.svg       |   1 -
 logo/rust-bitcoin.png                 | Bin 14406 -> 0 bytes
 logo/rust-btc+doge.svg                |  27 +++
 logo/rust-btc+doge@4x.png             | Bin 0 -> 70509 bytes
 logo/rust-doge.svg                    |  16 ++
 logo/rust-doge@4x.png                 | Bin 0 -> 26482 bytes
 18 files changed, 111 insertions(+), 283 deletions(-)
 delete mode 100644 logo/rust-bitcoin-inkscape.svg
 delete mode 100644 logo/rust-bitcoin-large.png
 delete mode 100644 logo/rust-bitcoin-optimized.svg
 delete mode 100644 logo/rust-bitcoin.png
 create mode 100644 logo/rust-btc+doge.svg
 create mode 100644 logo/rust-btc+doge@4x.png
 create mode 100644 logo/rust-doge.svg
 create mode 100644 logo/rust-doge@4x.png

diff --git a/.github/workflows/cron-daily-kani.yml b/.github/workflows/cron-daily-kani.yml
index 9b1e7ecaf..b1e69f537 100644
--- a/.github/workflows/cron-daily-kani.yml
+++ b/.github/workflows/cron-daily-kani.yml
@@ -13,4 +13,4 @@ jobs:
       - name: 'Run Kani on your code.'
         uses: model-checking/kani-github-action@v1.1
         with:
-          args: "--package bitcoin --package bitcoin-units"
+          args: "--package bitcoin-dogecoin --package bitcoin-units"
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index f25170545..5e851b627 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -302,4 +302,4 @@ jobs:
       - name: "Build Kani proofs"
         uses: model-checking/kani-github-action@v1.1
         with:
-          args: "--only-codegen --package bitcoin --package bitcoin-units"
+          args: "--only-codegen --package bitcoin-dogecoin --package bitcoin-units"
diff --git a/Cargo.toml b/Cargo.toml
index 7cf9a0f32..a0a4dbdc3 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -5,7 +5,7 @@ resolver = "2"
 [patch.crates-io.base58ck]
 path = "base58"
 
-[patch.crates-io.bitcoin]
+[patch.crates-io.bitcoin-dogecoin]
 path = "bitcoin"
 
 [patch.crates-io.bitcoin_hashes]
diff --git a/README.md b/README.md
index b7ecd9b82..c322c8055 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,18 @@
 <div align="center">
   <h1>Rust Dogecoin</h1>
 
-  <img alt="Rust Bitcoin logo by Hunter Trujillo, see license and source files under /logo" src="./logo/rust-bitcoin.png" width="300" />
+  <img alt="Rust Dogecoin logo by DFINITY Foundation, see license and source files under /logo" src="./logo/rust-btc+doge@4x.png" width="720" />
 
   <p>Library with support for de/serialization, parsing and executing on data-structures
-    and network messages related to Dogecoin.
+    and network messages related to Bitcoin and Dogecoin.
   </p>
 
   <p>
-    <a href="https://crates.io/crates/bitcoin"><img alt="Crate Info" src="https://img.shields.io/crates/v/bitcoin.svg"/></a>
+    <a href="https://crates.io/crates/bitcoin-dogecoin"><img alt="Crate Info" src="https://img.shields.io/crates/v/bitcoin-dogecoin.svg"/></a>
     <a href="https://github.com/rust-dogecoin/rust-dogecoin/blob/doge-master/LICENSE"><img alt="Apache License 2.0" src="https://img.shields.io/badge/license-Apache--2.0-blue.svg"/></a>
-    <a href="https://github.com/rust-bitcoin/rust-bitcoin/actions?query=workflow%3AContinuous%20integration"><img alt="CI Status" src="https://github.com/rust-bitcoin/rust-bitcoin/workflows/Continuous%20integration/badge.svg"></a>
-    <a href="https://docs.rs/bitcoin"><img alt="API Docs" src="https://img.shields.io/badge/docs.rs-bitcoin-green"/></a>
+    <a href="https://github.com/rust-bitcoin/rust-bitcoin/actions?query=workflow%3AContinuous%20integration"><img alt="CI Status" src="https://github.com/dfinity/rust-dogecoin/workflows/Continuous%20integration/badge.svg"></a>
+    <a href="https://docs.rs/bitcoin-dogecoin"><img alt="API Docs" src="https://img.shields.io/badge/docs.rs-bitcoin-dogecoin-green"/></a>
     <a href="https://blog.rust-lang.org/2021/11/01/Rust-1.56.1.html"><img alt="Rustc Version 1.56.1+" src="https://img.shields.io/badge/rustc-1.56.1%2B-lightgrey.svg"/></a>
-    <a href="https://github.com/model-checking/kani"><img alt="kani" src="https://github.com/rust-bitcoin/rust-bitcoin/workflows/Kani%20CI/badge.svg"></a>
   </p>
 </div>
 
diff --git a/bitcoin/CHANGELOG.md b/bitcoin/CHANGELOG.md
index caa0de726..e2f5b9476 100644
--- a/bitcoin/CHANGELOG.md
+++ b/bitcoin/CHANGELOG.md
@@ -12,6 +12,47 @@
 - Backport - Add `XOnlyPublicKey` support for PSBT key retrieval and improve Taproot signing [#4443](https://github.com/rust-bitcoin/rust-bitcoin/pull/4443)
 - Backport - Add methods to retrieve inner types [#4450](https://github.com/rust-bitcoin/rust-bitcoin/pull/4450)
 
+# 0.32.5-doge.0 - 2025-11-03
+
+Initial release of the rust-dogecoin crate, a fork of rust-bitcoin adapted for Dogecoin.
+
+### rust-bitcoin v0.32.5 modifications
+
+- **Scrypt Proof-of-Work**: Add scrypt-based PoW validation (`block_hash_with_scrypt()` and `validate_pow_with_scrypt()`) to support Dogecoin's PoW algorithm.
+- **Difficulty Adjustment Algorithms**:
+    - Pre-Digishield algorithm (blocks 0-144,999) with variable transition thresholds based on block height ranges
+    - Digishield algorithm (blocks 145,000+)
+    - Methods `min_transition_threshold_dogecoin()` and `max_transition_threshold_dogecoin()`
+- **Generic Network Messages**: Make `RawNetworkMessage` and `NetworkMessage` generic over `Header` and `Block` types to support AuxPoW blocks
+- Updated license to Apache-2.0 for new Dogecoin-specific code
+
+### New Dogecoin module (`bitcoin/src/dogecoin/`)
+
+- **Core Types** (`mod.rs`):
+    - `Header`: Dogecoin block header with optional AuxPoW data
+    - `Block`: Block structure supporting both legacy and AuxPoW blocks
+    - `Network`: Dogecoin mainnet, Testnet, Regtest
+    - Helper methods for AuxPoW bit detection, chain ID extraction, and legacy block identification
+
+- **AuxPoW Support** (`auxpow.rs`):
+    - AuxPow validation (coinbase script validation, merkle branch verification, chain ID checks)
+    - Error types for AuxPow validation failures
+
+- **Consensus Parameters** (`params.rs`):
+    - Dogecoin PoW parameters and methods: target spacing, max attainable target, pow target timespan
+    - Digishield and AuxPoW activation height
+    - Chain ID for merged mining
+    - BIP activation heights
+
+- **Constants** (`constants.rs`):
+    - Genesis block definitions for mainnet, testnet, and regtest
+    - Prefixes for P2PKH and P2SH addresses
+
+- **Address Handling** (`address/`):
+    - Base58 address encoding/decoding with Dogecoin-specific prefixes
+    - Support for P2PKH and P2SH address types
+    - Network validation and address parsing
+
 # 0.32.5 - 2024-11-27
 
 - Backport - Re-export `bech32` crate [#3662](https://github.com/rust-bitcoin/rust-bitcoin/pull/3662)
diff --git a/bitcoin/Cargo.toml b/bitcoin/Cargo.toml
index 5897ab9ef..e7e985edb 100644
--- a/bitcoin/Cargo.toml
+++ b/bitcoin/Cargo.toml
@@ -1,8 +1,8 @@
 [package]
-name = "bitcoin"
+name = "bitcoin-dogecoin"
 version = "0.32.5-doge.0"
-license = "CC0-1.0"
-repository = "https://github.com/rust-dogecoin/rust-dogecoin/"
+license = "Apache-2.0 OR CC0-1.0"
+repository = "https://github.com/dfinity/rust-dogecoin"
 description = "General purpose library for using and interoperating with Bitcoin and Dogecoin."
 categories = ["cryptography::cryptocurrencies"]
 keywords = [ "crypto", "bitcoin", "dogecoin"]
@@ -11,6 +11,9 @@ edition = "2021"
 rust-version = "1.56.1"
 exclude = ["tests", "contrib"]
 
+[lib]
+name = "bitcoin"
+
 [features]
 default = [ "std", "secp-recovery" ]
 std = ["base58/std", "bech32/std", "hashes/std", "hex/std", "internals/std", "io/std", "secp256k1/std", "units/std"]
diff --git a/bitcoin/embedded/Cargo.toml b/bitcoin/embedded/Cargo.toml
index b12f41550..7beae92c7 100644
--- a/bitcoin/embedded/Cargo.toml
+++ b/bitcoin/embedded/Cargo.toml
@@ -15,7 +15,7 @@ cortex-m-rt = "0.6.10"
 cortex-m-semihosting = "0.3.3"
 panic-halt = "0.2.0"
 alloc-cortex-m = "0.4.1"
-bitcoin = { path="../", default-features = false, features = ["secp-lowmemory"] }
+bitcoin = { package = "bitcoin-dogecoin", path="../", default-features = false, features = ["secp-lowmemory"] }
 
 [[bin]]
 name = "embedded"
diff --git a/bitcoin/src/lib.rs b/bitcoin/src/lib.rs
index c335874e9..a863e435e 100644
--- a/bitcoin/src/lib.rs
+++ b/bitcoin/src/lib.rs
@@ -1,10 +1,10 @@
 // SPDX-License-Identifier: CC0-1.0
 
-//! # Rust Bitcoin Library
+//! # Rust Dogecoin Library
 //!
-//! This is a library that supports the Bitcoin network protocol and associated
-//! primitives. It is designed for Rust programs built to work with the Bitcoin
-//! network.
+//! This is a library that supports both the Bitcoin and Dogecoin network protocol
+//! and associated primitives. It is designed for Rust programs built to work with
+//! the Bitcoin and Dogecoin network.
 //!
 //! Except for its dependency on libsecp256k1 (and optionally libbitcoinconsensus),
 //! this library is written entirely in Rust. It illustrates the benefits of
diff --git a/fuzz/Cargo.toml b/fuzz/Cargo.toml
index f76d61899..10915e03e 100644
--- a/fuzz/Cargo.toml
+++ b/fuzz/Cargo.toml
@@ -11,7 +11,7 @@ cargo-fuzz = true
 
 [dependencies]
 honggfuzz = { version = "0.5.55", default-features = false }
-bitcoin = { path = "../bitcoin", features = [ "serde" ] }
+bitcoin = { package = "bitcoin-dogecoin", path = "../bitcoin", features = [ "serde" ] }
 
 serde = { version = "1.0.103", features = [ "derive" ] }
 serde_json = "1.0"
diff --git a/logo/README.md b/logo/README.md
index 71a563dba..efbb520e3 100644
--- a/logo/README.md
+++ b/logo/README.md
@@ -1,32 +1,19 @@
-# Rust Bitcoin Logo
+# Rust Dogecoin Logo
+
+This logo is based on the [rust-bitcoin logo](https://github.com/rust-bitcoin/rust-bitcoin/tree/master/logo) and incorporates the Dogecoin "Ð" sign inside the Rust meshed gear.
 
 ## Files
 
 Included are:
 
-- [rust-bitcoin-inkscape.svg](./rust-bitcoin-inkscape.svg) - The Inkscape source file with the things used to make the logo in case adjustments are desired
-- [rust-bitcoin-optimized.svg](./rust-bitcoin-optimized.svg) - An optimized SVG for embedding or rendering at any size desired
-- [rust-bitcoin.png](./rust-bitcoin.png) - The PNG logo rendered at 300px used by this project
-- [rust-bitcoin-large.png](./rust-bitcoin-large.png) - A larger size 1024px x 1024px for convenience for embedding in presentations
-
-## Author
-
-Hunter Trujillo, @cryptoquick on [Twitter](https://twitter.com/cryptoquick), [GitHub](https://github.com/cryptoquick), and Telegram.
+- [rust-doge.svg](./rust-doge.svg) - An SVG of the Rust Dogecoin logo for embedding or rendering at any size desired
+- [rust-doge@4x.png](./rust-doge@4x.png) - A high-resolution PNG of the Rust Dogecoin logo render at 600px x 600px
+- [rust-btc+doge.svg](./rust-btc+doge.svg) - An SVG of the Rust Bitcoin logo together with the Rust Dogecoin logo
+- [rust-btc+doge@4x.png](./rust-btc+doge@4x.png) - A high-resolution PNG of the Rust Bitcoin + Dogecoin logo render at 1440px x 680px
 
 ## License
 
 Licensed in the public domain under [CC0 1.0 Universal Public Domain Dedication](https://creativecommons.org/publicdomain/zero/1.0/), and the author of this work rescinds all claims to copyright or coercion or acts of force from any nation state over this work for any purpose
 
-Bitcoin Logo is licensed under the CC Public Domain Dedication: <https://bitcoin.stackexchange.com/a/53422> and <https://bitcointalk.org/index.php?topic=1631.0>
-
 Rust Logo is licensed under CC-BY, which allows reuse and modifications for any purpose, as long as distributors give appropriate credit and indicate changes have been made. See here: <https://www.rust-lang.org/policies/media-guide>
 
-## Acknowledgements
-
-Acknowledgement for the runners up in this PR: https://github.com/rust-bitcoin/rust-bitcoin/pull/891#issuecomment-1074476858
-
-In particular, the Rust Bitcoin Wizard gear was an incredibly inspired piece of art. Also, the meshed gears design was beloved by some but not all.
-
-Thank you to the Rust Bitcoin maintainers and community, your timely responses and guidance was appreciated.
-
-Also, thank you to the voters on the Rust in Bitcoin Telegram group: <https://t.me/rust_in_bitcoin/321>.
diff --git a/logo/rust-bitcoin-inkscape.svg b/logo/rust-bitcoin-inkscape.svg
deleted file mode 100644
index 9b504a344..000000000
--- a/logo/rust-bitcoin-inkscape.svg
+++ /dev/null
@@ -1,244 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   width="176.39641mm"
-   height="176.39641mm"
-   viewBox="0 0 176.39641 176.39641"
-   version="1.1"
-   id="svg5"
-   inkscape:version="1.1.2 (0a00cf5339, 2022-02-04, custom)"
-   sodipodi:docname="rust-bitcoin-5.svg"
-   inkscape:export-filename="/home/hunter/rust-bitcoin-4.png"
-   inkscape:export-xdpi="43.198158"
-   inkscape:export-ydpi="43.198158"
-   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
-   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
-   xmlns="http://www.w3.org/2000/svg"
-   xmlns:svg="http://www.w3.org/2000/svg">
-  <sodipodi:namedview
-     id="namedview7"
-     pagecolor="#505050"
-     bordercolor="#ffffff"
-     borderopacity="1"
-     inkscape:pageshadow="0"
-     inkscape:pageopacity="0"
-     inkscape:pagecheckerboard="1"
-     inkscape:document-units="mm"
-     showgrid="false"
-     inkscape:zoom="1.5554293"
-     inkscape:cx="-412.10488"
-     inkscape:cy="109.61604"
-     inkscape:window-width="3840"
-     inkscape:window-height="2128"
-     inkscape:window-x="0"
-     inkscape:window-y="32"
-     inkscape:window-maximized="1"
-     inkscape:current-layer="layer1"
-     fit-margin-top="0"
-     fit-margin-left="0"
-     fit-margin-right="0"
-     fit-margin-bottom="0" />
-  <defs
-     id="defs2">
-    <inkscape:path-effect
-       effect="powerclip"
-       id="path-effect9474"
-       is_visible="true"
-       lpeversion="1"
-       inverse="true"
-       flatten="false"
-       hide_clip="false"
-       message="Use fill-rule evenodd on &lt;b&gt;fill and stroke&lt;/b&gt; dialog if no flatten result after convert clip to paths." />
-    <inkscape:path-effect
-       effect="powerclip"
-       id="path-effect9474-5"
-       is_visible="true"
-       lpeversion="1"
-       inverse="true"
-       flatten="false"
-       hide_clip="false"
-       message="Use fill-rule evenodd on &lt;b&gt;fill and stroke&lt;/b&gt; dialog if no flatten result after convert clip to paths." />
-    <clipPath
-       clipPathUnits="userSpaceOnUse"
-       id="clipPath9470">
-      <path
-         fill="#ffffff"
-         d="m 75.868035,44.926438 c 0.910871,-6.088692 -3.725,-9.361829 -10.06393,-11.545348 l 2.056255,-8.247905 -5.020525,-1.251199 -2.001919,8.030553 C 59.518082,31.583651 58.162497,31.273356 56.81549,30.965918 l 2.01622,-8.083461 -5.017667,-1.251199 -2.057688,8.245045 c -1.092475,-0.248812 -2.164932,-0.49476 -3.205927,-0.753581 l 0.0057,-0.02574 -6.923778,-1.728801 -1.335566,5.362282 c 0,0 3.724997,0.853675 3.646352,0.906584 2.033376,0.507629 2.400872,1.853205 2.339385,2.919939 l -2.342245,9.396148 c 0.140134,0.03575 0.321736,0.08723 0.521931,0.167304 -0.167304,-0.04147 -0.346049,-0.08723 -0.530511,-0.131556 L 40.64855,59.151495 c -0.248809,0.617736 -0.879414,1.544338 -2.300777,1.192572 0.05005,0.07293 -3.64921,-0.910873 -3.64921,-0.910873 l -2.492388,5.746935 6.533404,1.628704 c 1.215451,0.304578 2.406591,0.623456 3.579143,0.923742 l -2.077704,8.342281 5.014804,1.251199 2.057685,-8.253624 c 1.369886,0.371784 2.699732,0.71497 4.000979,1.038137 l -2.050536,8.215016 5.020527,1.251199 2.077704,-8.326551 c 8.561062,1.620126 14.998657,0.966642 17.708398,-6.776493 2.183522,-6.234546 -0.108675,-9.83085 -4.612992,-12.175953 3.280286,-0.756441 5.751224,-2.914224 6.410428,-7.371349 z M 64.397041,61.011853 c -1.551485,6.234544 -12.048689,2.864173 -15.45195,2.019078 l 2.756926,-11.052019 c 3.403264,0.849384 14.316578,2.530996 12.695024,9.032941 z m 1.552919,-16.1755 C 64.534317,50.5075 55.797373,47.626167 52.963228,46.919777 l 2.499537,-10.02389 c 2.834146,0.706389 11.961464,2.024795 10.487195,7.940466 z"
-         id="path9472"
-         style="display:none;stroke-width:1.42994" />
-      <path
-         id="lpe_path-effect9474"
-         style="stroke-width:1.42994"
-         class="powerclip"
-         d="M 2.124689,-1.3643165 H 106.06395 V 102.57236 H 2.124689 Z M 75.868035,44.926438 c 0.910871,-6.088692 -3.725,-9.361829 -10.06393,-11.545348 l 2.056255,-8.247905 -5.020525,-1.251199 -2.001919,8.030553 C 59.518082,31.583651 58.162497,31.273356 56.81549,30.965918 l 2.01622,-8.083461 -5.017667,-1.251199 -2.057688,8.245045 c -1.092475,-0.248812 -2.164932,-0.49476 -3.205927,-0.753581 l 0.0057,-0.02574 -6.923778,-1.728801 -1.335566,5.362282 c 0,0 3.724997,0.853675 3.646352,0.906584 2.033376,0.507629 2.400872,1.853205 2.339385,2.919939 l -2.342245,9.396148 c 0.140134,0.03575 0.321736,0.08723 0.521931,0.167304 -0.167304,-0.04147 -0.346049,-0.08723 -0.530511,-0.131556 L 40.64855,59.151495 c -0.248809,0.617736 -0.879414,1.544338 -2.300777,1.192572 0.05005,0.07293 -3.64921,-0.910873 -3.64921,-0.910873 l -2.492388,5.746935 6.533404,1.628704 c 1.215451,0.304578 2.406591,0.623456 3.579143,0.923742 l -2.077704,8.342281 5.014804,1.251199 2.057685,-8.253624 c 1.369886,0.371784 2.699732,0.71497 4.000979,1.038137 l -2.050536,8.215016 5.020527,1.251199 2.077704,-8.326551 c 8.561062,1.620126 14.998657,0.966642 17.708398,-6.776493 2.183522,-6.234546 -0.108675,-9.83085 -4.612992,-12.175953 3.280286,-0.756441 5.751224,-2.914224 6.410428,-7.371349 z M 64.397041,61.011853 c 1.621554,-6.501945 -9.29176,-8.183557 -12.695024,-9.032941 l -2.756926,11.052019 c 3.403261,0.845095 13.900465,4.215466 15.45195,-2.019078 z m 1.552919,-16.1755 c 1.474269,-5.915671 -7.653049,-7.234077 -10.487195,-7.940466 l -2.499537,10.02389 c 2.834145,0.70639 11.571089,3.587723 12.986732,-2.083424 z" />
-    </clipPath>
-    <clipPath
-       clipPathUnits="userSpaceOnUse"
-       id="clipath_lpe_path-effect9474-5">
-      <path
-         fill="#ffffff"
-         d="m 75.868035,44.926438 c 0.910871,-6.088692 -3.725,-9.361829 -10.06393,-11.545348 l 2.056255,-8.247905 -5.020525,-1.251199 -2.001919,8.030553 C 59.518082,31.583651 58.162497,31.273356 56.81549,30.965918 l 2.01622,-8.083461 -5.017667,-1.251199 -2.057688,8.245045 c -1.092475,-0.248812 -2.164932,-0.49476 -3.205927,-0.753581 l 0.0057,-0.02574 -6.923778,-1.728801 -1.335566,5.362282 c 0,0 3.724997,0.853675 3.646352,0.906584 2.033376,0.507629 2.400872,1.853205 2.339385,2.919939 l -2.342245,9.396148 c 0.140134,0.03575 0.321736,0.08723 0.521931,0.167304 -0.167304,-0.04147 -0.346049,-0.08723 -0.530511,-0.131556 L 40.64855,59.151495 c -0.248809,0.617736 -0.879414,1.544338 -2.300777,1.192572 0.05005,0.07293 -3.64921,-0.910873 -3.64921,-0.910873 l -2.492388,5.746935 6.533404,1.628704 c 1.215451,0.304578 2.406591,0.623456 3.579143,0.923742 l -2.077704,8.342281 5.014804,1.251199 2.057685,-8.253624 c 1.369886,0.371784 2.699732,0.71497 4.000979,1.038137 l -2.050536,8.215016 5.020527,1.251199 2.077704,-8.326551 c 8.561062,1.620126 14.998657,0.966642 17.708398,-6.776493 2.183522,-6.234546 -0.108675,-9.83085 -4.612992,-12.175953 3.280286,-0.756441 5.751224,-2.914224 6.410428,-7.371349 z M 64.397041,61.011853 c -1.551485,6.234544 -12.048689,2.864173 -15.45195,2.019078 l 2.756926,-11.052019 c 3.403264,0.849384 14.316578,2.530996 12.695024,9.032941 z m 1.552919,-16.1755 C 64.534317,50.5075 55.797373,47.626167 52.963228,46.919777 l 2.499537,-10.02389 c 2.834146,0.706389 11.961464,2.024795 10.487195,7.940466 z"
-         id="path112"
-         style="display:block;stroke-width:1.42994" />
-    </clipPath>
-  </defs>
-  <g
-     inkscape:label="Layer 1"
-     inkscape:groupmode="layer"
-     id="layer1"
-     transform="translate(73.402031,228.93883)">
-    <rect
-       style="fill:#ffffff;stroke-width:0.264583"
-       id="rect221"
-       width="176.39641"
-       height="176.39641"
-       x="168.18069"
-       y="-348.05383" />
-    <path
-       id="path75-2-1"
-       clip-path="none"
-       style="fill:#f7931a;fill-opacity:1;stroke-width:0.913143"
-       d="m -215.99589,1.4687934 c -0.45197,0 -0.90419,0.218357 -1.17408,0.654223 l -2.48409,4.013192 c -0.39083,0.03197 -0.78135,0.07129 -1.16944,0.114205 l -3.21685,-3.451469 c -0.69914,-0.752383 -1.94674,-0.503621 -2.30374,0.459403 l -1.64745,4.409033 c -0.38169,0.109574 -0.76026,0.225457 -1.13739,0.344165 l -3.82044,-2.749185 c -0.833,-0.596823 -2.0035,-0.112829 -2.17093,0.898136 l -0.75758,4.6488106 c -0.35065,0.181714 -0.69726,0.368805 -1.04334,0.559656 l -4.28656,-1.9538856 c -0.43506,-0.199122 -0.94218,-0.158117 -1.33946,0.108521 -0.39812,0.264813 -0.63114,0.7187336 -0.61288,1.1963086 l 0.16433,4.717025 c -0.30499,0.243815 -0.60729,0.493144 -0.90588,0.745174 l -4.59404,-1.082621 c -0.46592,-0.109049 -0.95518,0.03001 -1.29398,0.367936 -0.33901,0.338153 -0.47826,0.828032 -0.36793,1.293978 l 1.0821,4.594551 c -0.25172,0.29806 -0.49932,0.599233 -0.74311,0.903821 l -4.71702,-0.163814 c -1.02634,-0.03748 -1.73288,1.019566 -1.30535,1.953369 l 1.95389,4.287077 c -0.19148,0.345262 -0.37747,0.692829 -0.55914,1.043347 l -4.64778,0.756544 c -1.01251,0.165473 -1.49795,1.337696 -0.89865,2.170409 l 2.74918,3.818371 c -0.11962,0.377132 -0.2351,0.756227 -0.34468,1.137915 l -4.40955,1.648478 c -0.96328,0.357611 -1.21089,1.605206 -0.45733,2.303735 l 3.4494,3.216341 c -0.043,0.388083 -0.0813,0.778489 -0.11421,1.168406 l -4.01215,2.484085 c -0.87394,0.53857 -0.87394,1.80857 0,2.347143 l 4.01215,2.484088 c 0.0328,0.390824 0.0713,0.780833 0.11421,1.168921 l -3.4494,3.216859 c -0.75013,0.69931 -0.50313,1.94371 0.45733,2.30322 l 4.40955,1.64796 c 0.10958,0.38169 0.22506,0.76078 0.34468,1.13791 l -2.74918,3.81992 c -0.60085,0.8326 -0.11453,2.006121 0.89917,2.169381 l 4.64726,0.75603 c 0.18171,0.35247 0.36737,0.69933 0.55914,1.04541 l -1.95389,4.28553 c -0.19892,0.4354 -0.15793,0.94281 0.10852,1.34049 0.26664,0.39904 0.72108,0.63205 1.19683,0.61288 l 4.71496,-0.16537 c 0.24563,0.30682 0.49315,0.60729 0.74517,0.90589 l -1.0821,4.59558 c -0.10958,0.46571 0.0283,0.95263 0.36793,1.2914 0.33695,0.3406 0.82737,0.47649 1.29398,0.3669 l 4.59404,-1.0821 c 0.29859,0.25385 0.60089,0.50072 0.90588,0.74362 l -0.16433,4.71806 c -0.0375,1.02589 1.01907,1.73195 1.95234,1.30431 l 4.28656,-1.95337 c 0.34517,0.19177 0.69179,0.37795 1.04334,0.55966 l 0.75758,4.64571 c 0.16632,1.01173 1.33732,1.49768 2.17093,0.90072 l 3.81889,-2.75125 c 0.37762,0.12059 0.75708,0.23559 1.13791,0.34571 l 1.64796,4.40749 c 0.16711,0.44744 0.55396,0.7784 1.02423,0.86971 0.46894,0.0946 0.95392,-0.0614 1.27899,-0.41238 l 3.21634,-3.4494 c 0.38809,0.0448 0.77913,0.0821 1.16996,0.11679 l 2.48408,4.01267 c 0.54041,0.87065 1.80674,0.87065 2.34715,0 l 2.48408,-4.01267 c 0.39011,-0.0339 0.77984,-0.0727 1.16892,-0.11679 l 3.21583,3.4494 c 0.32599,0.35065 0.81055,0.50734 1.27899,0.41238 0.46952,-0.0924 0.85712,-0.42132 1.02423,-0.86971 l 1.64796,-4.40749 c 0.38083,-0.11012 0.76026,-0.22512 1.13791,-0.34571 l 3.81992,2.75125 c 0.8332,0.59843 2.00524,0.1118 2.1699,-0.90072 l 0.75758,-4.64571 c 0.35064,-0.18171 0.69726,-0.37063 1.04334,-0.55966 l 4.28656,1.95337 c 0.93327,0.42764 1.9899,-0.27842 1.95234,-1.30431 l -0.16433,-4.71806 c 0.30498,-0.24381 0.60716,-0.48977 0.90485,-0.74362 l 4.59403,1.0821 c 0.46553,0.11133 0.95536,-0.0276 1.29295,-0.3669 0.33968,-0.33877 0.47751,-0.82569 0.36794,-1.2914 l -1.08211,-4.59558 c 0.25203,-0.2986 0.50073,-0.59907 0.74363,-0.90589 l 4.71702,0.16537 c 0.47823,0.0179 0.93145,-0.2143 1.19631,-0.61288 0.26664,-0.39813 0.30747,-0.90492 0.10749,-1.34049 l -1.95286,-4.28553 c 0.19086,-0.34608 0.37783,-0.69294 0.55863,-1.04541 l 4.64777,-0.75603 c 1.01332,-0.16383 1.49943,-1.337081 0.89866,-2.169381 l -2.74919,-3.81992 c 0.11871,-0.37713 0.2342,-0.75622 0.34468,-1.13791 l 4.40852,-1.64796 c 0.44836,-0.16802 0.77839,-0.55448 0.86971,-1.02475 0.0946,-0.46894 -0.0614,-0.95339 -0.41238,-1.27847 l -3.44836,-3.216859 c 0.042,-0.388088 0.0804,-0.779012 0.1142,-1.168921 l 4.01216,-2.484088 c 0.8741,-0.538321 0.87485,-1.808321 0.001,-2.347143 l -4.01216,-2.484085 c -0.0339,-0.390007 -0.072,-0.779217 -0.1142,-1.168406 l 3.44836,-3.216341 c 0.35066,-0.326908 0.50735,-0.811061 0.41238,-1.279506 -0.092,-0.469681 -0.42163,-0.857412 -0.87023,-1.024229 l -4.408,-1.648478 c -0.11066,-0.380579 -0.22523,-0.76 -0.34468,-1.137915 l 2.74918,-3.818371 c 0.60055,-0.832565 0.11465,-2.00592 -0.89865,-2.170409 l -4.64778,-0.756544 c -0.18101,-0.350701 -0.36709,-0.698274 -0.55862,-1.043347 l 1.95337,-4.287077 c 0.19992,-0.435117 0.15885,-0.943405 -0.108,-1.341003 -0.26474,-0.398723 -0.71804,-0.630516 -1.19631,-0.612366 l -4.71702,0.163814 c -0.24363,-0.30522 -0.49208,-0.606405 -0.74518,-0.903821 l 1.08365,-4.594551 c 0.23673,-0.999313 -0.66144,-1.898085 -1.66087,-1.661914 l -4.59404,1.082621 c -0.29826,-0.25283 -0.60028,-0.501278 -0.90589,-0.745174 l 0.16537,-4.717025 c 0.0383,-1.0262926 -1.01869,-1.7326696 -1.95234,-1.3048296 l -4.28656,1.9538856 c -0.34557,-0.190722 -0.69313,-0.377218 -1.04325,-0.559656 l -0.75757,-4.6488106 c -0.1658,-1.011754 -1.33731,-1.496423 -2.1699,-0.898136 l -3.82149,2.749185 c -0.37701,-0.120103 -0.75611,-0.234779 -1.13637,-0.344165 l -1.64796,-4.409033 c -0.35618,-0.963989 -1.60447,-1.212992 -2.30322,-0.459403 l -3.21582,3.451469 c -0.38808,-0.04294 -0.779,-0.08224 -1.16892,-0.114205 l -2.48409,-4.013192 c -0.2699,-0.435866 -0.72108,-0.654223 -1.17305,-0.654223 z m 6.98046,9.4717726 c 0.94063,-0.01085 1.86684,0.437 2.42156,1.270723 0.86822,1.300983 0.50506,3.049906 -0.81184,3.908805 -3.15982,1.948799 -6.20745,-2.623644 -3.14296,-4.715474 0.47354,-0.307667 1.00556,-0.457967 1.53324,-0.464054 z m -6.98407,3.566707 h 5.3e-4 c 0.19398,0.0013 0.38794,0.0042 0.58187,0.0088 0.002,0.0032 0.005,0.0066 0.007,0.0098 1.10678,1.617736 1.9191,2.860637 2.45567,3.700549 0.001,0.0021 0.005,0.0072 0.006,0.0093 0.005,0.0075 0.009,0.01375 0.0134,0.02119 0.51987,0.814861 0.78393,1.256254 0.78393,1.256254 0.0967,0.147358 0.20617,0.281502 0.32556,0.402042 10e-4,0.0012 0.002,0.0024 0.004,0.0036 0.001,0.0011 0.002,0.0021 0.003,0.0031 0.11993,0.120188 0.24961,0.226527 0.38758,0.318844 0.13915,0.09311 0.28652,0.171875 0.43924,0.235644 0.1506,0.06288 0.30644,0.110791 0.46561,0.144177 0.005,9.79e-4 0.009,0.0016 0.0139,0.0026 0.15922,0.03249 0.32167,0.05064 0.48472,0.05271 0.16533,0.0021 0.33158,-0.0117 0.4961,-0.04186 h 5.3e-4 c 0.16453,-0.03019 0.32733,-0.07711 0.48627,-0.14056 h 5.3e-4 c 0.15908,-0.06354 0.31382,-0.144 0.46251,-0.241845 l 4.99349,-3.286621 0.15555,-0.10232 c 9.70557,3.765959 17.28006,11.21695 20.52071,21.110341 -0.29522,0.444712 -0.57381,0.828567 -0.82889,1.205093 -3.76785,5.353534 -3.90416,5.531963 -3.90416,5.531963 -0.10279,0.145307 -0.18849,0.297382 -0.25735,0.454235 -0.0688,0.156855 -0.12084,0.318566 -0.15658,0.482142 -0.0357,0.163576 -0.0549,0.329073 -0.0584,0.494543 -0.004,0.16547 0.009,0.330981 0.0367,0.493509 0.028,0.162544 0.0716,0.322188 0.13023,0.476975 0.0586,0.154786 0.13227,0.304276 0.22065,0.446484 0.17677,0.284414 0.4124,0.538999 0.70332,0.744141 l 4.88601,3.444234 0.75654,0.5333 c -0.89849,10.285428 -6.3243,19.638629 -14.80681,25.524559 -0.002,-7.9e-4 -0.004,-0.002 -0.006,-0.003 -2.17765,-0.9069 -3.58835,-1.5381 -4.46277,-1.94665 -0.0258,-0.0121 -0.0433,-0.0209 -0.0682,-0.0326 -0.80078,-0.37639 -1.15445,-0.56689 -1.15445,-0.56689 -0.16252,-0.0726 -0.32833,-0.12677 -0.49558,-0.16382 -0.16724,-0.037 -0.33593,-0.0572 -0.50333,-0.0605 -0.1674,-0.003 -0.33362,0.01 -0.49661,0.0388 -0.16229,0.0286 -0.321,0.0731 -0.47439,0.13178 -0.002,5.3e-4 -0.004,7.9e-4 -0.005,0.002 -0.15291,0.0589 -0.30025,0.13211 -0.43976,0.21911 -0.14045,0.0876 -0.27302,0.18899 -0.39533,0.30334 -0.12108,0.11319 -0.23187,0.23952 -0.33073,0.37724 -0.002,0.003 -0.004,0.006 -0.006,0.009 -0.0983,0.13811 -0.18476,0.28768 -0.25631,0.44855 l -2.4288,5.46271 -0.48472,1.09038 c -2.55818,0.59071 -5.17507,0.88958 -7.80056,0.8909 -7.36743,-0.009 -14.54147,-2.35861 -20.48609,-6.7107 6e-5,-8e-4 -5e-5,-0.002 0,-0.003 0.005,-0.0853 0.008,-0.17288 0.007,-0.26407 l -0.093,-6.77013 c -0.002,-0.17797 -0.0224,-0.35146 -0.0589,-0.51883 -0.0363,-0.1666 -0.0888,-0.32684 -0.15554,-0.47956 -3.7e-4,-7.9e-4 -6.6e-4,-0.002 -0.001,-0.003 -4e-4,-0.001 -0.001,-0.002 -0.002,-0.003 -0.067,-0.15217 -0.14804,-0.29704 -0.24185,-0.43201 -0.0945,-0.13591 -0.2017,-0.26219 -0.31987,-0.37724 -0.11818,-0.11505 -0.24712,-0.21876 -0.38551,-0.30954 -0.13839,-0.0908 -0.28623,-0.16841 -0.44132,-0.23151 -0.15509,-0.0631 -0.31747,-0.11166 -0.48576,-0.14366 -0.16828,-0.032 -0.34241,-0.0475 -0.52038,-0.045 l -5.97741,0.0853 -0.18449,0.003 c -3.51745,-5.547081 -5.39056,-11.97777 -5.40225,-18.546157 0.011,-3.604783 0.58282,-7.185908 1.69499,-10.614855 0.0118,-0.003 0.005,-0.0011 0.0171,-0.0041 4.45781,-1.139848 5.20498,-1.30166 6.47299,-1.616956 0.16006,-0.0398 0.31487,-0.09685 0.4625,-0.168981 0.29526,-0.144262 0.56166,-0.348676 0.78497,-0.595313 0.11165,-0.123317 0.21266,-0.257286 0.30075,-0.399457 0.0881,-0.142174 0.16344,-0.292534 0.22428,-0.449069 0.0608,-0.156533 0.10708,-0.318839 0.13694,-0.485241 0.0299,-0.166404 0.0436,-0.336717 0.0388,-0.508497 -0.005,-0.171781 -0.0281,-0.345133 -0.0713,-0.517798 l -1.45213,-5.798552 -0.33435,-1.335319 c 6.59946,-7.770258 16.27821,-12.250469 26.4728,-12.254032 z m -31.19758,14.948957 c 1.19189,-0.0032 2.30664,0.734645 2.71456,1.908929 1.11834,3.507685 -4.13158,5.271532 -5.41414,1.819011 -0.50897,-1.473642 0.29002,-3.075504 1.78387,-3.576011 0.30347,-0.10214 0.61189,-0.151114 0.91571,-0.151929 z m 66.48586,13.194543 c 0.52608,-0.0019 1.08531,0.15579 1.64125,0.524 1.28946,0.896958 1.59723,2.656469 0.68678,3.927927 -0.90918,1.273461 -2.69192,1.579428 -3.98374,0.684194 -2.45596,-1.795719 -0.74593,-5.127763 1.65571,-5.136121 z m -62.02928,28.155393 c 3.72595,0.0343 3.80312,5.5067 0.0796,5.64358 -1.57744,0.0223 -2.87369,-1.2224 -2.8944,-2.77916 -0.0229,-1.55763 1.23651,-2.83933 2.81482,-2.86442 z m 41.35302,8.30233 c 1.83932,-0.0174 3.69784,1.70666 2.75591,3.93361 -0.64087,1.42265 -2.33004,2.06253 -3.77083,1.42834 -1.4425,-0.63258 -2.09338,-2.29871 -1.45469,-3.72329 0.54787,-1.14257 1.50617,-1.62955 2.46961,-1.63866 z" />
-    <path
-       d="m 330.35323,103.34875 -3.43386,-3.20864 c 0.0431,-0.387493 0.0819,-0.775439 0.11661,-1.16377 l 3.99498,-2.468047 c 0.40626,-0.250837 0.65408,-0.692851 0.65274,-1.168861 0.002,-0.476654 -0.24439,-0.91995 -0.64995,-1.170402 l -3.98304,-2.469807 c -0.0338,-0.393278 -0.0722,-0.78615 -0.11511,-1.178538 l 3.43038,-3.192943 c 0.74901,-0.695882 0.50362,-1.936751 -0.45388,-2.295158 l -4.39169,-1.645388 c -0.10834,-0.377825 -0.22238,-0.75399 -0.34209,-1.128368 l 2.74413,-3.805825 c 0.28015,-0.385928 0.33938,-0.889796 0.15637,-1.330171 -0.18074,-0.441071 -0.57808,-0.756233 -1.04871,-0.831828 l -4.63906,-0.759999 c -0.17838,-0.345626 -0.36217,-0.688428 -0.55132,-1.028278 l 1.95524,-4.275996 c 0.42618,-0.929761 -0.27572,-1.982815 -1.29789,-1.947182 l -4.69793,0.16119 c -0.24195,-0.305117 -0.48839,-0.606638 -0.73926,-0.904464 l 1.08194,-4.574749 c 0.23765,-0.994839 -0.65672,-1.891005 -1.65204,-1.655344 l -4.56736,1.07202 c -0.30038,-0.253716 -0.60377,-0.503847 -0.91011,-0.75034 l 0.16698,-4.688012 c 0.0355,-1.020452 -1.0137,-1.722733 -1.94356,-1.300903 l -4.26869,1.939465 c -0.34476,-0.190867 -0.6922,-0.376843 -1.04222,-0.557874 l -0.74937,-4.627208 c -0.15973,-1.010961 -1.33001,-1.497602 -2.15947,-0.897983 l -3.81429,2.7425 c -0.37062,-0.117656 -0.74465,-0.232255 -1.1192,-0.339553 l -1.64253,-4.404105 c -0.35707,-0.956701 -1.59553,-1.204158 -2.29282,-0.458127 l -3.20882,3.434753 c -0.38792,-0.04504 -0.77726,-0.08297 -1.16466,-0.116785 l -2.46839,-3.997846 c -0.53598,-0.871204 -1.80215,-0.87163 -2.33872,-7.88e-4 l -2.46998,3.983948 c -0.39415,0.03254 -0.786,0.07202 -1.17748,0.114357 l -3.19471,-3.430729 c -0.69707,-0.745408 -1.93434,-0.500672 -2.29513,0.453981 l -1.64736,4.392221 c -0.3779,0.109052 -0.7533,0.224153 -1.12855,0.342999 l -3.80474,-2.744858 c -0.38603,-0.279364 -0.88946,-0.338163 -1.32948,-0.155279 -0.44048,0.180924 -0.75646,0.578713 -0.83181,1.048682 l -0.76,4.639077 c -0.34544,0.178593 -0.68928,0.363072 -1.03006,0.550934 l -4.27528,-1.954108 c -0.43375,-0.197423 -0.93867,-0.157008 -1.33549,0.106895 -0.39707,0.264093 -0.6287,0.715278 -0.61188,1.191857 l 0.16012,4.698663 c -0.30401,0.241969 -0.60481,0.487933 -0.90233,0.737829 l -4.57493,-1.081052 c -0.99503,-0.236884 -1.89084,0.657514 -1.65552,1.652913 l 1.07184,4.568295 c -0.25437,0.299821 -0.50451,0.603212 -0.75034,0.910083 l -4.68686,-0.168569 c -1.02113,-0.03598 -1.72387,1.014266 -1.30108,1.944454 l 1.94,4.266009 c -0.19042,0.344962 -0.37762,0.692429 -0.55912,1.043823 l -4.62721,0.749381 c -1.01053,0.161283 -1.49597,1.331489 -0.89634,2.160727 l 2.74072,3.813911 c -0.11767,0.370643 -0.23137,0.744838 -0.33955,1.119215 l -4.40322,1.642717 c -0.9586,0.35544 -1.20653,1.596286 -0.45813,2.292803 l 3.43387,3.208639 c -0.0442,0.388096 -0.0828,0.776383 -0.11661,1.163759 l -3.99606,2.468767 c -0.86905,0.536592 -0.87045,1.799864 -0.003,2.33838 l 3.98395,2.469979 c 0.0325,0.39415 0.0718,0.786871 0.11507,1.178541 l -3.43014,3.19384 c -0.74926,0.69589 -0.50308,1.93715 0.45506,2.2944 l 4.39079,1.64522 c 0.10869,0.37969 0.22289,0.75492 0.34264,1.13034 l -2.74468,3.80384 c -0.27923,0.38641 -0.33807,0.88999 -0.15545,1.33036 0.18253,0.44174 0.58031,0.7577 1.04868,0.83183 l 4.63747,0.75874 c 0.18002,0.34758 0.36307,0.68928 0.55094,1.03007 l -1.9536,4.27725 c -0.19789,0.43342 -0.1582,0.93565 0.10743,1.33278 0.26261,0.39841 0.71495,0.62697 1.19205,0.61101 l 4.69776,-0.1603 c 0.24208,0.30618 0.48915,0.60595 0.73961,0.90269 l -1.08123,4.57582 c -0.23687,0.99458 0.6573,1.88996 1.6522,1.65444 l 4.56722,-1.07113 c 0.29967,0.25462 0.60221,0.50428 0.9101,0.75033 l -0.16644,4.68536 c -0.035,1.02053 1.01349,1.72318 1.9441,1.30285 l 4.26636,-1.94177 c 0.34529,0.19146 0.6932,0.37815 1.04365,0.56001 l 0.74972,4.62543 c 0.0759,0.46958 0.38932,0.86884 0.83079,1.04981 0.4395,0.18395 0.94308,0.12576 1.32905,-0.15358 l 3.81482,-2.74055 c 0.37029,0.11942 0.74465,0.23231 1.11958,0.34242 l 1.6427,4.40319 c 0.35788,0.95573 1.59513,1.20295 2.2928,0.45813 l 3.20865,-3.43386 c 0.38759,0.0431 0.77573,0.0811 1.16431,0.11393 l 2.46786,3.99589 c 0.24994,0.40607 0.69197,0.65388 1.16797,0.65256 0.47656,0.001 0.9197,-0.24465 1.17041,-0.64995 l 2.46961,-3.98217 c 0.39342,-0.0332 0.78636,-0.0719 1.17872,-0.11592 l 3.1935,3.43234 c 0.69689,0.74706 1.93616,0.50089 2.29462,-0.45581 l 1.6468,-4.38956 c 0.37792,-0.10903 0.75369,-0.22589 1.12855,-0.34299 l 3.80493,2.74396 c 0.828,0.59976 1.9976,0.11674 2.16112,-0.8925 l 0.76016,-4.63998 c 0.34544,-0.17858 0.68856,-0.35951 1.02881,-0.54934 l 4.27546,1.95325 c 0.43293,0.19956 0.93852,0.15932 1.33443,-0.1062 0.39785,-0.26456 0.62747,-0.71297 0.61134,-1.18919 l -0.16,-4.69954 c 0.30442,-0.24243 0.60559,-0.48735 0.90269,-0.73962 l 4.57474,1.08194 c 0.46353,0.11087 0.95136,-0.0274 1.28781,-0.36495 0.33812,-0.33679 0.47715,-0.82372 0.36683,-1.28812 l -1.07129,-4.56634 c 0.25392,-0.30075 0.50444,-0.6031 0.74978,-0.91206 l 4.68679,0.16859 c 1.02158,0.0377 1.72522,-1.0135 1.3009,-1.94356 l -1.93984,-4.2669 c 0.18956,-0.34515 0.37672,-0.69261 0.55914,-1.04382 l 4.62629,-0.74955 c 0.47066,-0.0767 0.86888,-0.38934 1.04982,-0.83079 0.18394,-0.43951 0.12575,-0.94308 -0.15357,-1.32905 l -2.73966,-3.81463 c 0.11672,-0.37083 0.23042,-0.74504 0.33955,-1.11923 l 4.40321,-1.6427 c 0.95871,-0.35515 1.20701,-1.59594 0.4588,-2.29268 z m -32.72191,27.26637 c -1.43287,-0.62366 -2.08974,-2.2901 -1.46781,-3.72371 0.61779,-1.43428 2.28274,-2.09442 3.71553,-1.47317 1.43326,0.622 2.09133,2.28779 1.47013,3.7214 -0.61994,1.43336 -2.28374,2.09365 -3.71785,1.47548 z m 9.9811,-9.9162 c -1.22578,1.11685 -2.52956,2.14497 -3.90144,3.07655 l -5.61174,-2.43171 c -1.30719,-0.56581 -2.82546,0.0365 -3.38933,1.34449 l -2.68843,6.21429 c -4.8239,1.12122 -9.83209,1.19543 -14.68708,0.2176 -4.96722,-0.98599 -9.6583,-3.04768 -13.74365,-6.04023 l -0.0931,-6.77007 c -0.018,-1.42379 -1.18795,-2.56279 -2.61172,-2.54264 l -5.97745,0.0854 c -0.84612,-1.30929 -1.60299,-2.67414 -2.26547,-4.08526 m 5.11212,12.73912 c -1.56172,0.0224 -2.84541,-1.22644 -2.86591,-2.78819 -0.0227,-1.56262 1.22435,-2.84844 2.78693,-2.8736 3.68884,0.0344 3.76542,5.52446 0.079,5.66179 z m -2.00755,-45.013569 c 0.34101,1.524829 -0.6174,3.037738 -2.14175,3.380877 -1.52409,0.341521 -3.03605,-0.618678 -3.37499,-2.14335 -0.34102,-1.524829 0.61739,-3.037739 2.14175,-3.380878 1.52409,-0.341521 3.03605,0.618679 3.37499,2.143351 z m -4.79157,7.058092 6.50067,-1.4601 c 1.38979,-0.312575 2.26355,-1.692039 1.95221,-3.082112 l -0.67419,-3.026324 c 5.75171,-2.852317 28.85231,11.498845 -9.27656,20.815729 -0.25657,-3.217608 -0.0647,-6.455261 0.57004,-9.620053 0.2475,-1.238695 0.55903,-2.449775 0.92783,-3.62714 z M 263.28072,67.15245 c 0,0 13.4354,-7.051282 21.24437,-6.95996 l 3.37344,5.330493 c 0.76116,1.203295 2.35468,1.559932 3.55613,0.795875 l 5.68824,-3.61356 c 9.63457,3.862422 16.86195,11.78439 20.03691,21.306035 l -4.74469,6.730806 c -0.81996,1.164312 -0.5432,2.772569 0.61878,3.595819 l 5.73564,4.053424 c -0.22365,2.093258 -0.57129,3.988648 -1.11144,5.938608 M 289.55606,57.236849 c 1.31792,-0.83755 3.06541,-0.446421 3.90054,0.873032 0.83564,1.320855 0.4436,3.068937 -0.87609,3.906418 -1.31793,0.83835 -3.06618,0.446634 -3.90038,-0.873927 -0.83453,-1.320719 -0.44272,-3.06771 0.87592,-3.905524 z m 27.22657,32.591547 c 0.89868,-1.276909 2.66309,-1.582063 3.93842,-0.681149 1.27546,0.90256 1.57891,2.667607 0.67812,3.944317 -0.8985,1.277833 -2.66378,1.583375 -3.9395,0.681869 -1.27416,-0.903808 -1.57694,-2.668112 -0.67702,-3.945027 z"
-       id="path11918"
-       style="fill:#ffffff;fill-opacity:1;stroke-width:0.909418"
-       inkscape:export-filename="/home/hunter/omoc-rust.png"
-       inkscape:export-xdpi="96"
-       inkscape:export-ydpi="96"
-       sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccscccccccccccsccccssccc" />
-    <path
-       d="m 300.72838,-60.57878 -3.43386,-3.20864 c 0.0431,-0.387492 0.0819,-0.775438 0.11661,-1.163769 l 3.99498,-2.468047 c 0.40626,-0.250837 0.65408,-0.692851 0.65274,-1.168861 0.002,-0.476654 -0.24439,-0.91995 -0.64995,-1.170402 l -3.98304,-2.469807 c -0.0338,-0.393278 -0.0722,-0.78615 -0.11511,-1.178538 l 3.43038,-3.192943 c 0.74901,-0.695882 0.50362,-1.936751 -0.45388,-2.295158 l -4.39169,-1.645388 c -0.10834,-0.377825 -0.22238,-0.75399 -0.34209,-1.128368 l 2.74413,-3.805825 c 0.28015,-0.385928 0.33938,-0.889796 0.15637,-1.330171 -0.18074,-0.441071 -0.57808,-0.756233 -1.04871,-0.831828 l -4.63906,-0.759999 c -0.17838,-0.345626 -0.36217,-0.688428 -0.55132,-1.028278 l 1.95524,-4.275996 c 0.42618,-0.929761 -0.27572,-1.982815 -1.29789,-1.947182 l -4.69793,0.16119 c -0.24195,-0.305117 -0.48839,-0.606638 -0.73926,-0.904464 l 1.08194,-4.574746 c 0.23765,-0.99484 -0.65672,-1.89101 -1.65204,-1.65535 l -4.56737,1.07202 c -0.30038,-0.25371 -0.60377,-0.50384 -0.91011,-0.75034 l 0.16698,-4.68801 c 0.0355,-1.02045 -1.0137,-1.72273 -1.94356,-1.3009 l -4.26869,1.93946 c -0.34476,-0.19086 -0.6922,-0.37684 -1.04222,-0.55787 l -0.74937,-4.62721 c -0.15973,-1.01096 -1.33001,-1.4976 -2.15947,-0.89798 l -3.81429,2.7425 c -0.37062,-0.11766 -0.74465,-0.23226 -1.1192,-0.33955 l -1.64253,-4.40411 c -0.35707,-0.9567 -1.59553,-1.20416 -2.29282,-0.45813 l -3.20882,3.43476 c -0.38792,-0.045 -0.77726,-0.083 -1.16466,-0.11679 l -2.46839,-3.99784 c -0.53598,-0.87121 -1.80215,-0.87163 -2.33872,-7.9e-4 l -2.46998,3.98395 c -0.39415,0.0325 -0.786,0.072 -1.17748,0.11435 l -3.19471,-3.43073 c -0.69707,-0.7454 -1.93434,-0.50067 -2.29513,0.45399 l -1.64736,4.39222 c -0.3779,0.10905 -0.7533,0.22415 -1.12855,0.343 l -3.80474,-2.74486 c -0.38603,-0.27937 -0.88946,-0.33817 -1.32948,-0.15528 -0.44048,0.18092 -0.75646,0.57871 -0.83181,1.04868 l -0.76,4.63908 c -0.34544,0.17859 -0.68928,0.36307 -1.03006,0.55093 l -4.27528,-1.95411 c -0.43375,-0.19742 -0.93867,-0.157 -1.33549,0.1069 -0.39707,0.26409 -0.6287,0.71528 -0.61188,1.19185 l 0.16012,4.69867 c -0.30401,0.24197 -0.60481,0.48793 -0.90233,0.73783 l -4.57493,-1.08106 c -0.99503,-0.23688 -1.89084,0.65752 -1.65552,1.65292 l 1.07184,4.568292 c -0.25437,0.299821 -0.50451,0.603212 -0.75034,0.910083 l -4.68686,-0.168569 c -1.02113,-0.03598 -1.72387,1.014266 -1.30108,1.944454 l 1.94,4.266009 c -0.19042,0.344962 -0.37762,0.692429 -0.55912,1.043823 l -4.62721,0.749381 c -1.01053,0.161283 -1.49597,1.331489 -0.89634,2.160727 l 2.74072,3.813911 c -0.11767,0.370643 -0.23137,0.744838 -0.33955,1.119215 l -4.40322,1.642717 c -0.9586,0.35544 -1.20653,1.596286 -0.45813,2.292803 l 3.43387,3.208639 c -0.0442,0.388096 -0.0828,0.776383 -0.11661,1.163759 l -3.99606,2.468767 c -0.86905,0.536592 -0.87045,1.799864 -0.003,2.33838 l 3.98395,2.469979 c 0.0325,0.39415 0.0718,0.786871 0.11507,1.17854 l -3.43014,3.193844 c -0.74926,0.695888 -0.50308,1.937152 0.45506,2.294403 l 4.39079,1.645216 c 0.10869,0.379692 0.22289,0.754921 0.34264,1.130341 l -2.74468,3.803844 c -0.27923,0.386404 -0.33807,0.889983 -0.15545,1.330355 0.18253,0.441742 0.58031,0.757706 1.04868,0.831834 l 4.63747,0.758737 c 0.18002,0.34758 0.36307,0.689278 0.55094,1.030075 l -1.9536,4.277243 c -0.19789,0.43342 -0.1582,0.93565 0.10743,1.332787 0.26261,0.398402 0.71495,0.626967 1.19205,0.611003 l 4.69776,-0.1603 c 0.24208,0.306184 0.48915,0.60595 0.73961,0.902689 l -1.08123,4.575826 c -0.23687,0.994577 0.6573,1.889962 1.6522,1.654443 l 4.56722,-1.071137 c 0.29967,0.254625 0.60221,0.504277 0.9101,0.750336 l -0.16644,4.685347 c -0.035,1.02053 1.01349,1.723184 1.9441,1.302854 l 4.26636,-1.941762 c 0.34529,0.19146 0.6932,0.378148 1.04365,0.560009 l 0.74972,4.625418 c 0.0759,0.469593 0.38932,0.868854 0.83079,1.049817 0.4395,0.18394 0.94308,0.125751 1.32905,-0.153576 l 3.81482,-2.74056 c 0.37029,0.11943 0.74465,0.232322 1.11958,0.342429 l 1.6427,4.403192 c 0.35788,0.955732 1.59513,1.202949 2.2928,0.458126 l 3.20865,-3.433859 c 0.38759,0.04306 0.77573,0.08105 1.16431,0.113935 l 2.46786,3.995884 c 0.24994,0.406075 0.69197,0.653885 1.16797,0.652561 0.47656,0.0014 0.9197,-0.244651 1.17041,-0.649944 l 2.46961,-3.982174 c 0.39342,-0.03322 0.78636,-0.07186 1.17872,-0.115916 l 3.1935,3.432334 c 0.69689,0.747064 1.93616,0.500892 2.29462,-0.455811 l 1.6468,-4.389556 c 0.37792,-0.109033 0.75369,-0.225892 1.12855,-0.342992 l 3.80493,2.743959 c 0.828,0.599765 1.9976,0.116742 2.16112,-0.892499 l 0.76016,-4.63998 c 0.34544,-0.178583 0.68856,-0.359504 1.02881,-0.549334 l 4.27546,1.953241 c 0.43293,0.199561 0.93852,0.159325 1.33443,-0.106196 0.39785,-0.264564 0.62747,-0.712975 0.61134,-1.189188 l -0.16,-4.699539 c 0.30442,-0.242435 0.60559,-0.487357 0.90269,-0.739621 l 4.57474,1.081939 c 0.46353,0.110871 0.95136,-0.02737 1.28781,-0.364949 0.33812,-0.336789 0.47715,-0.823722 0.36683,-1.28812 l -1.07129,-4.566346 c 0.25392,-0.300746 0.50444,-0.603092 0.74978,-0.912058 l 4.68679,0.16859 c 1.02158,0.03774 1.72522,-1.013496 1.3009,-1.943561 l -1.93984,-4.266894 c 0.18956,-0.345152 0.37672,-0.692618 0.55914,-1.043823 l 4.62629,-0.749553 c 0.47066,-0.07669 0.86888,-0.38934 1.04982,-0.830787 0.18394,-0.439506 0.12575,-0.943079 -0.15357,-1.329053 l -2.73966,-3.814627 c 0.11672,-0.370832 0.23042,-0.745036 0.33955,-1.119233 l 4.40321,-1.642696 c 0.95871,-0.355155 1.20701,-1.595942 0.4588,-2.292679 z m -32.72192,27.266373 c -1.43287,-0.623655 -2.08974,-2.290097 -1.46781,-3.723713 0.61779,-1.434279 2.28274,-2.094413 3.71553,-1.473164 1.43326,0.622 2.09133,2.287792 1.47013,3.721404 -0.61994,1.433351 -2.28374,2.09365 -3.71785,1.475473 z m 9.9811,-9.916195 c -1.22578,1.116851 -2.52956,2.144968 -3.90144,3.076548 l -5.61174,-2.431713 c -1.30719,-0.565811 -2.82546,0.03646 -3.38933,1.344492 l -2.68843,6.214286 c -4.8239,1.121229 -9.83209,1.195432 -14.68708,0.217609 -4.96722,-0.985995 -9.6583,-3.047688 -13.74365,-6.040235 l -0.0931,-6.770067 c -0.018,-1.423795 -1.18795,-2.562794 -2.61172,-2.542644 l -5.97745,0.08544 c -0.84612,-1.309288 -1.60299,-2.674138 -2.26547,-4.085264 m 5.11212,12.739121 c -1.56172,0.02244 -2.84541,-1.226437 -2.86591,-2.788187 -0.0227,-1.562618 1.22435,-2.848435 2.78693,-2.873599 3.68884,0.03444 3.76542,5.524463 0.079,5.661786 z m -2.00755,-45.013569 c 0.34101,1.524829 -0.6174,3.037738 -2.14175,3.380877 -1.52409,0.341521 -3.03605,-0.618678 -3.37499,-2.14335 -0.34102,-1.524829 0.61739,-3.037739 2.14175,-3.380878 1.52409,-0.341521 3.03605,0.618679 3.37499,2.143351 z m -4.79157,7.058092 6.50067,-1.4601 c 1.38979,-0.312575 2.26355,-1.692039 1.95221,-3.082112 l -0.67419,-3.026324 c 5.75171,-2.852317 28.85231,11.498845 -9.27656,20.815729 -0.25657,-3.217608 -0.0647,-6.455261 0.57004,-9.620053 0.2475,-1.238695 0.55903,-2.449775 0.92783,-3.62714 z m 12.32471,-17.398533 c 0,0 13.4354,-7.051281 21.24437,-6.959961 l 3.37344,5.330494 c 0.76116,1.203295 2.35468,1.559932 3.55613,0.795875 l 5.68824,-3.613559 c 9.63457,3.862421 16.86195,11.784389 20.03692,21.306034 l -4.7447,6.730806 c -0.81996,1.164312 -0.5432,2.772569 0.61878,3.595819 l 5.73565,4.053424 c -0.22365,2.093257 -0.57129,3.988652 -1.11144,5.938607 m -28.12205,-47.09318 c 1.31792,-0.83755 3.06541,-0.44642 3.90054,0.87303 0.83564,1.32086 0.4436,3.06894 -0.87609,3.90642 -1.31793,0.83835 -3.06618,0.44663 -3.90038,-0.87393 -0.83453,-1.32072 -0.44272,-3.06771 0.87592,-3.90552 z m 27.22658,32.591547 c 0.89868,-1.276909 2.66309,-1.582063 3.93842,-0.681149 1.27546,0.90256 1.57891,2.667607 0.67812,3.944317 -0.8985,1.277833 -2.66378,1.583375 -3.9395,0.681869 -1.27416,-0.903808 -1.57694,-2.668112 -0.67702,-3.945027 z"
-       id="path6469"
-       style="fill:#f5680f;fill-opacity:1;stroke-width:0.909418"
-       inkscape:export-filename="/home/hunter/omoc-rust.png"
-       inkscape:export-xdpi="96"
-       inkscape:export-ydpi="96"
-       sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccscccccccccccsccccssccc" />
-    <path
-       d="m -2.9005959,70.119893 -3.433859,-3.20864 c 0.04305,-0.387492 0.08192,-0.775438 0.116608,-1.163769 l 3.9949815,-2.468047 c 0.40626,-0.250837 0.65408,-0.692851 0.65274,-1.168861 0.002,-0.476654 -0.24439,-0.91995 -0.64995,-1.170402 l -3.9830445,-2.469807 c -0.03381,-0.393278 -0.07218,-0.78615 -0.115105,-1.178538 l 3.430379,-3.192943 c 0.7490105,-0.695882 0.5036205,-1.936751 -0.453884,-2.295158 l -4.391685,-1.645388 c -0.108339,-0.377825 -0.222382,-0.75399 -0.34209,-1.128368 l 2.74413,-3.805825 c 0.28015,-0.385928 0.339381,-0.889796 0.156365,-1.330171 -0.180743,-0.441071 -0.578076,-0.756233 -1.048711,-0.831828 L -10.86278,42.302149 c -0.178375,-0.345626 -0.362171,-0.688428 -0.551319,-1.028278 l 1.9552361,-4.275996 c 0.426189,-0.929761 -0.275719,-1.982815 -1.2978851,-1.947182 l -4.697932,0.16119 c -0.241946,-0.305117 -0.488391,-0.606638 -0.739257,-0.904464 l 1.081939,-4.574749 c 0.237651,-0.994839 -0.656724,-1.891005 -1.652036,-1.655344 l -4.567377,1.07202 c -0.30038,-0.253716 -0.60377,-0.503847 -0.910106,-0.75034 l 0.166982,-4.688012 c 0.03551,-1.020452 -1.013699,-1.722732 -1.943561,-1.300903 l -4.268697,1.939465 c -0.344754,-0.190867 -0.692193,-0.376843 -1.042212,-0.557874 l -0.749373,-4.627206 c -0.159731,-1.010962 -1.330007,-1.497603 -2.159473,-0.897983 l -3.814283,2.7425 c -0.370622,-0.117656 -0.744654,-0.232256 -1.119203,-0.339553 l -1.642534,-4.404105 c -0.357063,-0.956701 -1.595527,-1.204159 -2.292813,-0.458127 l -3.208822,3.434753 c -0.387922,-0.04504 -0.777263,-0.08297 -1.16466,-0.116785 l -2.468392,-3.997847 c -0.535982,-0.871203 -1.802155,-0.871629 -2.338724,-7.87e-4 l -2.469979,3.983948 c -0.394149,0.03254 -0.786,0.07202 -1.177477,0.114356 l -3.194714,-3.430728 c -0.697064,-0.745408 -1.934336,-0.500672 -2.295123,0.453981 l -1.647361,4.39222 c -0.377901,0.109053 -0.753301,0.224154 -1.12855,0.343 l -3.804744,-2.744858 c -0.386029,-0.279364 -0.889457,-0.338163 -1.329475,-0.155279 -0.440487,0.180924 -0.756461,0.578713 -0.831813,1.048682 l -0.760003,4.639075 c -0.345434,0.178593 -0.689278,0.363072 -1.030056,0.550934 l -4.275284,-1.954108 c -0.433744,-0.197422 -0.938664,-0.157007 -1.335483,0.106895 -0.397071,0.264093 -0.628703,0.715278 -0.611881,1.191857 l 0.160118,4.698663 c -0.304007,0.241969 -0.604812,0.487933 -0.902336,0.737829 l -4.574928,-1.081052 c -0.995027,-0.236884 -1.890835,0.657514 -1.655518,1.652913 l 1.071842,4.568295 c -0.254376,0.299821 -0.504514,0.603212 -0.75034,0.910083 l -4.68686,-0.168569 c -1.021132,-0.03598 -1.723872,1.014266 -1.301077,1.944454 l 1.939998,4.266009 c -0.190421,0.344962 -0.377618,0.692429 -0.559122,1.043823 l -4.627206,0.749381 c -1.010539,0.161283 -1.495979,1.331489 -0.896339,2.160727 l 2.740714,3.813911 c -0.117668,0.370643 -0.231369,0.744838 -0.339551,1.119215 l -4.403213,1.642717 c -0.9586,0.35544 -1.20654,1.596286 -0.45813,2.292803 l 3.433867,3.208639 c -0.04418,0.388096 -0.0828,0.776383 -0.116613,1.163759 l -3.996054,2.468767 c -0.86906,0.536592 -0.87046,1.799864 -0.003,2.33838 l 3.983946,2.469979 c 0.03252,0.39415 0.07184,0.786871 0.115065,1.17854 l -3.430551,3.193844 c -0.74926,0.695888 -0.50307,1.937152 0.45506,2.294403 l 4.390792,1.645216 c 0.108688,0.379692 0.222895,0.754921 0.342647,1.130341 l -2.744679,3.803844 c -0.27924,0.386404 -0.33808,0.889983 -0.15546,1.330355 0.18253,0.441742 0.580318,0.757706 1.04868,0.831834 l 4.637476,0.758737 c 0.180023,0.34758 0.36307,0.689278 0.550942,1.030075 l -1.953599,4.277243 c -0.197899,0.43342 -0.1582,0.93565 0.10743,1.332787 0.262606,0.398402 0.714948,0.626967 1.192044,0.611003 l 4.697764,-0.1603 c 0.242081,0.306184 0.489149,0.60595 0.739609,0.902689 l -1.081229,4.575826 c -0.23687,0.994577 0.657301,1.889962 1.652199,1.654443 l 4.567221,-1.071137 c 0.299669,0.254625 0.602208,0.504277 0.910094,0.750336 l -0.166437,4.685348 c -0.035,1.02053 1.013492,1.72318 1.944099,1.30285 l 4.26636,-1.941759 c 0.34529,0.19146 0.693205,0.378149 1.043647,0.560009 l 0.749724,4.62542 c 0.07586,0.46959 0.38932,0.86885 0.830788,1.04982 0.439506,0.18394 0.943079,0.12575 1.329054,-0.15358 l 3.814818,-2.74056 c 0.370287,0.11943 0.744648,0.23232 1.119579,0.34243 l 1.642705,4.40319 c 0.357876,0.95573 1.595126,1.20295 2.292793,0.45813 l 3.20865,-3.43386 c 0.38759,0.0431 0.775729,0.081 1.164316,0.11393 l 2.467855,3.99589 c 0.249946,0.40607 0.691969,0.65388 1.16797,0.65256 0.476565,0.001 0.919704,-0.24465 1.170412,-0.64995 l 2.469614,-3.98217 c 0.393419,-0.0332 0.786361,-0.0719 1.178715,-0.11592 l 3.193499,3.43234 c 0.696897,0.74706 1.936167,0.50089 2.294623,-0.45581 l 1.646795,-4.38956 c 0.377921,-0.10903 0.753698,-0.22589 1.12855,-0.34299 l 3.804936,2.74396 c 0.828001,0.59976 1.997602,0.11674 2.161116,-0.8925 l 0.760165,-4.63998 c 0.345434,-0.17858 0.688559,-0.35951 1.02881,-0.549336 l 4.275461,1.953246 c 0.432922,0.19956 0.938516,0.15932 1.334426,-0.1062 0.397855,-0.26456 0.627474,-0.71298 0.611337,-1.18919 l -0.159995,-4.699538 c 0.304423,-0.242435 0.605586,-0.487357 0.902688,-0.739621 l 4.574743,1.081939 c 0.463532,0.110871 0.951362,-0.02737 1.28781,-0.364949 0.338115,-0.336789 0.477145,-0.823722 0.366828,-1.28812 l -1.071289,-4.566346 c 0.253915,-0.300746 0.504439,-0.603092 0.749779,-0.912058 l 4.686785,0.16859 c 1.0215891,0.03774 1.7252211,-1.013496 1.3009001,-1.943561 l -1.9398381,-4.266894 c 0.189558,-0.345152 0.376727,-0.692618 0.559138,-1.043823 l 4.6263081,-0.749553 c 0.470661,-0.07669 0.868874,-0.38934 1.049818,-0.830787 0.18394,-0.439506 0.125751,-0.943079 -0.153576,-1.329053 l -2.739659,-3.814627 c 0.116728,-0.370832 0.230419,-0.745036 0.339554,-1.119233 l 4.403212,-1.642696 c 0.9587105,-0.355155 1.2070105,-1.595942 0.4588,-2.292679 z M -35.622516,97.386266 c -1.43287,-0.623655 -2.089745,-2.290097 -1.467808,-3.723713 0.61779,-1.434279 2.282738,-2.094413 3.715523,-1.473164 1.433263,0.622 2.091333,2.287792 1.470136,3.721404 -0.619939,1.433351 -2.283739,2.09365 -3.717851,1.475473 z m 9.981093,-9.916195 c -1.225778,1.116851 -2.529554,2.144968 -3.901431,3.076548 l -5.61174,-2.431713 c -1.307193,-0.565811 -2.825464,0.03646 -3.389335,1.344492 l -2.688434,6.214286 c -4.823894,1.121229 -9.832084,1.195432 -14.687078,0.217609 -4.967221,-0.985995 -9.658295,-3.047688 -13.743651,-6.040235 l -0.09309,-6.770067 c -0.01801,-1.423795 -1.187953,-2.562794 -2.611719,-2.542644 l -5.977454,0.08544 c -0.846117,-1.309288 -1.602988,-2.674138 -2.265464,-4.085264 m 5.112118,12.739121 c -1.561723,0.02244 -2.84541,-1.226437 -2.865913,-2.788187 -0.02268,-1.562618 1.224352,-2.848435 2.786932,-2.873599 3.68884,0.03444 3.765425,5.524463 0.07898,5.661786 z"
-       id="path6936"
-       style="fill:#f5680f;fill-opacity:1;stroke-width:0.909418"
-       inkscape:export-filename="/home/hunter/omoc-rust.png"
-       inkscape:export-xdpi="96"
-       inkscape:export-ydpi="96"
-       sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc" />
-    <path
-       id="path75-3"
-       clip-path="none"
-       style="fill:#f7931a;fill-opacity:1;stroke-width:0.913142"
-       d="m -48.083404,105.53909 c -0.451974,0 -0.904153,0.2182 -1.174052,0.65407 l -2.483751,4.01322 c -0.390827,0.032 -0.781758,0.0712 -1.169847,0.1141 l -3.21668,-3.45118 c -0.699134,-0.75238 -1.946408,-0.5035 -2.303411,0.45953 l -1.647772,4.4086 c -0.381697,0.10958 -0.760118,0.22567 -1.137248,0.34439 l -3.820269,-2.74927 c -0.832997,-0.59682 -2.003487,-0.11295 -2.170916,0.89802 l -0.757638,4.64888 c -0.35065,0.18172 -0.697578,0.3691 -1.043661,0.55995 l -4.286628,-1.9543 c -0.435056,-0.19912 -0.941871,-0.1578 -1.339144,0.10884 -0.398125,0.26481 -0.631318,0.71856 -0.613052,1.19613 l 0.164568,4.71724 c -0.304989,0.24381 -0.607311,0.49299 -0.905907,0.74502 l -4.594206,-1.08257 c -0.465917,-0.10905 -0.95513,0.0301 -1.293927,0.36804 -0.339015,0.33816 -0.478365,0.82799 -0.368041,1.29393 l 1.08204,4.59473 c -0.251726,0.29806 -0.499132,0.59922 -0.742917,0.90381 l -4.717236,-0.16404 c -1.02634,-0.0375 -1.732503,1.01944 -1.304969,1.95324 l 1.953773,4.28715 c -0.191479,0.34526 -0.377749,0.69314 -0.559422,1.04366 l -4.647836,0.75607 c -1.012514,0.16547 -1.497846,1.33767 -0.898546,2.17038 l 2.749268,3.81869 c -0.119625,0.37713 -0.235333,0.75609 -0.344906,1.13778 l -4.409134,1.64829 c -0.96328,0.35762 -1.210983,1.60542 -0.457422,2.30395 l 3.449071,3.21615 c -0.04295,0.38808 -0.08122,0.77887 -0.114092,1.16879 l -4.012175,2.48375 c -0.873931,0.53858 -0.873931,1.80901 0,2.34758 l 4.012175,2.48375 c 0.03285,0.39083 0.07119,0.78071 0.114092,1.1688 l -3.449071,3.2172 c -0.750129,0.69932 -0.503044,1.94338 0.457422,2.30289 l 4.409134,1.6483 c 0.109573,0.38169 0.225281,0.76064 0.344906,1.13777 l -2.749268,3.81974 c -0.60085,0.8326 -0.114626,2.00608 0.899073,2.16934 l 4.647309,0.75606 c 0.181713,0.35247 0.367656,0.69968 0.559422,1.04577 l -1.953773,4.28557 c -0.19892,0.4354 -0.158144,0.94253 0.10831,1.3402 0.266633,0.39905 0.720914,0.63222 1.196659,0.61305 l 4.715133,-0.16562 c 0.245631,0.30682 0.492996,0.60731 0.74502,0.90591 l -1.08204,4.59578 c -0.109575,0.46571 0.02836,0.95253 0.368041,1.2913 0.336945,0.3406 0.827313,0.47657 1.293927,0.36699 l 4.594206,-1.08204 c 0.298596,0.25385 0.600918,0.50054 0.905907,0.74344 l -0.164568,4.71829 c -0.03755,1.02589 1.018923,1.73155 1.952196,1.30391 l 4.286628,-1.95324 c 0.345168,0.19176 0.692104,0.37823 1.043661,0.55995 l 0.757638,4.64573 c 0.166314,1.01173 1.337308,1.4976 2.170916,0.90065 l 3.818691,-2.75137 c 0.377649,0.12059 0.756941,0.23583 1.137773,0.34596 l 1.648299,4.40703 c 0.167106,0.44744 0.553936,0.77884 1.024207,0.87015 0.468944,0.0946 0.953605,-0.0618 1.27868,-0.41273 l 3.216679,-3.44907 c 0.388082,0.0448 0.779022,0.082 1.169845,0.11672 l 2.483752,4.0127 c 0.540408,0.87064 1.80717,0.87064 2.347576,0 l 2.483754,-4.0127 c 0.390103,-0.0339 0.779712,-0.0727 1.168792,-0.11672 l 3.216155,3.44907 c 0.325994,0.35065 0.810237,0.5077 1.278681,0.41273 0.46952,-0.0924 0.857095,-0.42176 1.024206,-0.87015 l 1.648297,-4.40703 c 0.380836,-0.11013 0.760122,-0.22537 1.137775,-0.34596 l 3.819741,2.75137 c 0.833193,0.59842 2.005186,0.11187 2.169866,-0.90065 l 0.757638,-4.64573 c 0.350647,-0.18172 0.697578,-0.37093 1.043659,-0.55995 l 4.286629,1.95324 c 0.933269,0.42764 1.989752,-0.27802 1.952194,-1.30391 l -0.164564,-4.71829 c 0.304987,-0.24381 0.607165,-0.48959 0.904854,-0.74344 l 4.594205,1.08204 c 0.465525,0.11132 0.955287,-0.0277 1.292878,-0.36699 0.339686,-0.33877 0.477615,-0.82559 0.368039,-1.2913 l -1.082041,-4.59578 c 0.252033,-0.2986 0.500548,-0.59909 0.743443,-0.90591 l 4.7172384,0.16562 c 0.478224,0.0179 0.931273,-0.21447 1.196134,-0.61305 0.266642,-0.39813 0.307764,-0.90463 0.107783,-1.3402 l -1.9532474,-4.28557 c 0.190851,-0.34609 0.3780964,-0.6933 0.5588964,-1.04577 l 4.647836,-0.75606 c 1.013312,-0.16383 1.499326,-1.33705 0.898546,-2.16934 l -2.749267,-3.81974 c 0.118709,-0.37713 0.234418,-0.75608 0.344903,-1.13777 l 4.408078,-1.6483 c 0.44836,-0.16802 0.77884,-0.55447 0.87016,-1.02473 0.0946,-0.46895 -0.0618,-0.95308 -0.41273,-1.27816 l -3.448021,-3.2172 c 0.04199,-0.38809 0.08032,-0.77889 0.114093,-1.1688 l 4.01216799,-2.48375 c 0.8741,-0.53832 0.87484,-1.80875 0.001,-2.34758 l -4.01213799,-2.48375 c -0.03387,-0.39 -0.07184,-0.77961 -0.114091,-1.16879 l 3.448009,-3.21615 c 0.35066,-0.32691 0.5077,-0.81077 0.41273,-1.27921 -0.092,-0.46968 -0.42207,-0.85792 -0.87067,-1.02474 l -4.407535,-1.64829 c -0.110657,-0.38058 -0.225457,-0.75986 -0.344907,-1.13778 l 2.749267,-3.81869 c 0.600547,-0.83256 0.114748,-2.0059 -0.898546,-2.17038 l -4.647831,-0.75607 c -0.181012,-0.3507 -0.3673714,-0.69858 -0.5589014,-1.04366 l 1.9532484,-4.28715 c 0.199913,-0.43512 0.159067,-0.94312 -0.107783,-1.34072 -0.264738,-0.39872 -0.717867,-0.63067 -1.196134,-0.61252 l -4.7172354,0.16404 c -0.243628,-0.30522 -0.491926,-0.60639 -0.74502,-0.90381 l 1.083618,-4.59473 c 0.236725,-0.99931 -0.661477,-1.89814 -1.660917,-1.66197 l -4.594206,1.08257 c -0.298259,-0.25283 -0.600301,-0.50112 -0.905906,-0.74502 l 0.165617,-4.71724 c 0.03827,-1.02629 -1.018551,-1.73281 -1.952195,-1.30497 l -4.286628,1.9543 c -0.345675,-0.19072 -0.693541,-0.37751 -1.043659,-0.55995 l -0.757641,-4.64888 c -0.165799,-1.01176 -1.337281,-1.49631 -2.169864,-0.89802 l -3.82132,2.74927 c -0.377007,-0.12011 -0.755943,-0.235 -1.136195,-0.34439 l -1.6483,-4.4086 c -0.356181,-0.96399 -1.604138,-1.21312 -2.302884,-0.45953 l -3.216156,3.45118 c -0.38808,-0.0429 -0.778877,-0.0821 -1.168794,-0.1141 l -2.483751,-4.01322 c -0.269898,-0.43587 -0.721553,-0.65407 -1.173525,-0.65407 z m -0.0031,13.03865 a 34.748302,34.748302 0 0 1 34.74829,34.74834 34.748302,34.748302 0 0 1 -34.748345,34.74835 34.748302,34.748302 0 0 1 -34.748345,-34.74835 34.748302,34.748302 0 0 1 34.748345,-34.74834 z" />
-    <path
-       fill="#ffffff"
-       d="m -24.36435,147.44117 c 0.990626,-6.62181 -4.051155,-10.18154 -10.945113,-12.55625 l 2.236298,-8.97007 -5.460114,-1.36075 -2.177205,8.73369 c -1.435396,-0.35769 -2.909674,-0.69515 -4.374623,-1.02951 l 2.192757,-8.79123 -5.457006,-1.36075 -2.237856,8.96696 c -1.188131,-0.27059 -2.35449,-0.53808 -3.486633,-0.81956 l 0.0062,-0.028 -7.530013,-1.88017 -1.452507,5.83179 c 0,0 4.051153,0.92843 3.965622,0.98597 2.211415,0.55207 2.611089,2.01547 2.544218,3.1756 l -2.547329,10.21886 c 0.152404,0.0389 0.349907,0.0949 0.567631,0.18195 -0.181953,-0.0451 -0.376349,-0.0949 -0.576962,-0.14307 l -3.570613,14.31511 c -0.270595,0.67182 -0.956414,1.67956 -2.50223,1.29699 0.05443,0.0793 -3.968729,-0.99063 -3.968729,-0.99063 l -2.710618,6.25013 7.10546,1.77131 c 1.321873,0.33125 2.617308,0.67805 3.892526,1.00463 l -2.259624,9.07272 5.453893,1.36075 2.237853,-8.9763 c 1.48983,0.40434 2.936116,0.77757 4.351298,1.12903 l -2.230078,8.93431 5.460117,1.36076 2.259625,-9.05562 c 9.310656,1.76199 16.311916,1.05128 19.258918,-7.36983 2.374708,-6.78043 -0.118191,-10.69162 -5.016898,-13.24206 3.567503,-0.82267 6.254792,-3.16939 6.971715,-8.01677 z M -36.839727,164.935 c -1.68733,6.78043 -13.103653,3.11495 -16.804899,2.19586 l 2.998318,-12.01972 c 3.701248,0.92376 15.570116,2.75261 13.806581,9.82386 z m 1.688891,-17.59181 c -1.539595,6.16771 -11.041533,3.03409 -14.123831,2.26585 l 2.718393,-10.90157 c 3.082299,0.76824 13.008792,2.20208 11.405438,8.63572 z"
-       id="path9472-6"
-       style="display:block;stroke-width:1.55515" />
-    <path
-       d="m -81.724947,171.87513 c -4.549189,6.195 13.227176,22.50327 13.218894,9.16211 -0.0083,-13.34117 -0.09309,-6.77007 -0.09309,-6.77007 -0.01801,-1.42379 -1.187953,-2.56279 -2.611719,-2.54264 l -5.977454,0.0854 m 2.846657,8.65386 c -1.561723,0.0224 -2.84541,-1.22644 -2.865913,-2.78819 -0.02268,-1.56262 1.224352,-2.84843 2.786932,-2.8736 3.68884,0.0344 3.765425,5.52446 0.07898,5.66179 z"
-       id="path6835-7"
-       style="fill:#f5680f;fill-opacity:1;stroke-width:0.909418"
-       inkscape:export-filename="/home/hunter/omoc-rust.png"
-       inkscape:export-xdpi="96"
-       inkscape:export-ydpi="96"
-       sodipodi:nodetypes="czccccccc" />
-    <path
-       d="m -70.798384,128.22041 c -7.297572,-2.41217 -17.31446,19.53368 -4.628822,15.40316 12.685642,-4.13054 6.409953,-2.1806 6.409953,-2.1806 1.348539,-0.4571 2.07026,-1.92176 1.611129,-3.26961 l -1.928355,-5.65851 m -7.350645,5.38152 c -0.503903,-1.47836 0.287134,-3.08513 1.76611,-3.58724 1.479132,-0.50445 3.087364,0.28421 3.594166,1.76254 1.107198,3.51892 -4.090494,5.28828 -5.360276,1.8247 z"
-       id="path11910-5"
-       style="fill:#f5680f;fill-opacity:1;stroke-width:0.909418"
-       inkscape:export-filename="/home/hunter/omoc-rust.png"
-       inkscape:export-xdpi="96"
-       inkscape:export-ydpi="96"
-       sodipodi:nodetypes="czccccccc" />
-    <path
-       d="m -31.705762,118.47996 c 0.503169,-7.66942 -23.254431,-11.85693 -16.071905,-0.61425 7.182547,11.24268 3.719761,5.65738 3.719761,5.65738 0.780969,1.19062 2.379889,1.52159 3.569344,0.73883 l 4.993304,-3.28697 m -7.054326,-5.76448 c 1.304548,-0.85886 3.058437,-0.49646 3.915709,0.80913 0.859575,1.30515 0.499849,3.05986 -0.803931,3.92151 -3.128344,1.95504 -6.145737,-2.63211 -3.111778,-4.73064 z"
-       id="path11912-3"
-       style="fill:#f5680f;fill-opacity:1;stroke-width:0.909418"
-       inkscape:export-filename="/home/hunter/omoc-rust.png"
-       inkscape:export-xdpi="96"
-       inkscape:export-ydpi="96"
-       sodipodi:nodetypes="czccccccc" />
-    <path
-       d="m -10.459353,158.37052 c 7.3216904,-2.33795 2.5260804,-25.98027 -5.30895,-15.18217 -7.83528,10.79793 -3.90403,5.53182 -3.90403,5.53182 -0.82233,1.16245 -0.5453,2.77161 0.6184,3.59217 l 4.88605,3.44437 m 2.78363,-8.67434 c 1.27662,0.89983 1.5810904,2.6647 0.67971,3.94023 -0.90012,1.27754 -2.66479,1.58478 -3.94374,0.68668 -2.96411,-2.19608 0.2009,-6.68265 3.26401,-4.62692 z"
-       id="path11914-5"
-       style="fill:#f5680f;fill-opacity:1;stroke-width:0.909418"
-       inkscape:export-filename="/home/hunter/omoc-rust.png"
-       inkscape:export-xdpi="96"
-       inkscape:export-ydpi="96"
-       sodipodi:nodetypes="czccccccc" />
-    <path
-       d="m -41.644288,190.1789 c 3.716687,6.72751 25.975686,-2.57281 13.86043,-8.15916 -12.115267,-5.58634 -6.185242,-2.75414 -6.185242,-2.75414 -1.30014,-0.58063 -2.824732,0.004 -3.403416,1.30494 l -2.428782,5.46244 m 9.049998,1.04418 c -0.634485,1.4272 -2.306488,2.06897 -3.732921,1.43275 -1.428133,-0.63461 -2.072583,-2.30586 -1.440254,-3.735 1.577939,-3.3345 6.594204,-1.10207 5.173175,2.30225 z"
-       id="path11916-6"
-       style="fill:#f5680f;fill-opacity:1;stroke-width:0.909418"
-       inkscape:export-filename="/home/hunter/omoc-rust.png"
-       inkscape:export-xdpi="96"
-       inkscape:export-ydpi="96"
-       sodipodi:nodetypes="czccccccc" />
-    <path
-       id="path75-2"
-       clip-path="none"
-       style="fill:#f7931a;fill-opacity:1;stroke-width:0.913143"
-       d="m -139.12389,-113.79299 c -0.44345,0.0874 -0.84491,0.38908 -1.02543,0.86889 l -1.6612,4.41779 c -0.37728,0.10698 -0.75283,0.22104 -1.1253,0.33817 l -3.82352,-2.76432 c -0.83143,-0.60299 -2.00738,-0.11769 -2.17142,0.8962 l -0.76382,4.64437 c -0.35332,0.1813 -0.70234,0.36822 -1.0494,0.55759 l -4.27992,-1.95857 c -0.93267,-0.42448 -1.9875,0.27669 -1.95629,1.30095 l 0.15565,4.70757 c -0.3089,0.24609 -0.61279,0.49666 -0.91544,0.75084 l -4.58346,-1.08816 c -0.46536,-0.11125 -0.95498,0.027 -1.2932,0.36547 -0.33941,0.33679 -0.48026,0.827209 -0.36998,1.292246 l 1.07331,4.596225 c -0.25209,0.298192 -0.50047,0.601261 -0.7447,0.906274 l -4.71667,-0.173882 c -0.47821,-0.0169 -0.93136,0.214126 -1.19841,0.611201 -0.26724,0.39732 -0.30912,0.904882 -0.1108,1.340704 l 1.95009,4.298602 c -0.18932,0.341114 -0.37401,0.684471 -0.55431,1.03045 l -4.65968,0.751373 c -1.01421,0.161663 -1.50303,1.335391 -0.903,2.1689 l 2.74597,3.828365 c -0.1211,0.375771 -0.23641,0.752735 -0.3468,1.13179 l -4.41378,1.640962 c -0.96141,0.358139 -1.21103,1.602101 -0.46202,2.303213 l 3.43563,3.214723 c -0.0444,0.393154 -0.0845,0.787419 -0.11815,1.183093 l -4.00758,2.470004 c -0.87595,0.537124 -0.87767,1.809047 -0.003,2.348687 l 4.00622,2.488657 c 0.0329,0.389071 0.0708,0.779517 0.11388,1.168443 l -3.45611,3.212996 c -0.75331,0.697392 -0.5082,1.9433 0.45384,2.302855 l 4.41677,1.661402 c 0.10777,0.37711 0.22094,0.752319 0.33807,1.124776 l -2.76229,3.823132 c -0.60075,0.83116 -0.11779,2.004316 0.89407,2.171323 l 4.64497,0.764221 c 0.18131,0.35331 0.36793,0.702916 0.55821,1.049798 l -1.95867,4.279415 c -0.42853,0.933059 0.27554,1.990396 1.30167,1.954563 l 4.70574,-0.156836 c 0.24644,0.310684 0.49566,0.615098 0.75074,0.917575 l -1.08837,4.582449 c -0.11092,0.465657 0.0274,0.955563 0.36568,1.294208 0.33875,0.339962 0.82969,0.480693 1.29275,0.369892 l 4.59399,-1.073928 c 0.30032,0.253523 0.60128,0.500471 0.90628,0.744696 l -0.17309,4.718096 c -0.0174,0.478104 0.21198,0.929173 0.6107,1.195877 0.39646,0.269024 0.90389,0.307513 1.34051,0.109774 l 4.2981,-1.949987 c 0.34205,0.19132 0.68638,0.375085 1.03257,0.554422 l 0.75107,4.660791 c 0.16148,1.013804 1.33472,1.50222 2.1677,0.902193 l 3.82794,-2.745357 c 0.37574,0.1214 0.75182,0.23705 1.13188,0.347345 l 1.64158,4.411552 c 0.35881,0.960475 1.60168,1.210824 2.30414,0.463947 l 3.21483,-3.437755 c 0.3938,0.0453 0.78834,0.08476 1.18327,0.119162 l 2.4691,4.005652 c 0.25047,0.406682 0.69402,0.656595 1.17306,0.655254 0.4784,0.0022 0.92405,-0.24468 1.17512,-0.651902 l 2.48867,-4.006218 c 0.38941,-0.03111 0.78029,-0.0701 1.17046,-0.111644 l 3.21309,3.456622 c 0.69856,0.749716 1.94098,0.504897 2.30284,-0.453846 l 1.66132,-4.417273 c 0.37619,-0.108666 0.75107,-0.222129 1.12428,-0.340609 l 3.82212,2.762486 c 0.38763,0.280996 0.89334,0.34104 1.33459,0.15729 0.44279,-0.181416 0.75947,-0.579105 0.83672,-1.051345 l 0.76462,-4.642956 c 0.35236,-0.181682 0.70239,-0.367885 1.04959,-0.55922 l 4.27982,1.960704 c 0.93319,0.426024 1.98901,-0.278046 1.95477,-1.303292 l -0.15506,-4.704523 c 0.3089,-0.246083 0.61244,-0.498462 0.91544,-0.750835 l 4.58337,1.087649 c 0.998345,0.239106 1.8985,-0.657935 1.66328,-1.657204 l -1.073517,-4.597241 c 0.252091,-0.298183 0.501008,-0.597928 0.743995,-0.904553 l 4.716567,0.173374 c 0.47827,0.01921 0.931994,-0.211799 1.197604,-0.609986 0.267764,-0.398059 0.308838,-0.902438 0.111281,-1.338165 l -1.950287,-4.299622 c 0.189541,-0.341688 0.375443,-0.684587 0.554424,-1.032572 l 4.659982,-0.749851 c 0.472657,-0.07491 0.872434,-0.390362 1.055226,-0.832634 0.184627,-0.442174 0.126681,-0.947294 -0.153747,-1.335975 l -2.74465,-3.827036 c 0.120332,-0.376461 0.236703,-0.752929 0.345936,-1.133706 l 4.413878,-1.640462 c 0.96252,-0.356665 1.212593,-1.601779 0.462228,-2.302196 l -3.435931,-3.216242 c 0.04354,-0.392967 0.08356,-0.787233 0.118146,-1.183092 l 4.006668,-2.469296 c 0.407411,-0.251544 0.656486,-0.694526 0.655152,-1.173569 0.0021,-0.478392 -0.244591,-0.923535 -0.651806,-1.174614 l -4.005297,-2.489371 c -0.03383,-0.388877 -0.07175,-0.779854 -0.113982,-1.168941 l 3.456115,-3.212996 c 0.753513,-0.697188 0.508727,-1.943352 -0.452866,-2.303048 l -4.416765,-1.661402 c -0.108673,-0.376095 -0.221215,-0.750612 -0.33797,-1.124277 l 2.761365,-3.82242 c 0.280831,-0.388545 0.340947,-0.893855 0.157191,-1.335101 -0.181082,-0.443026 -0.579464,-0.759702 -1.051852,-0.836621 l -4.643562,-0.765034 c -0.182162,-0.351999 -0.367934,-0.702106 -0.558205,-1.049797 l 1.958971,-4.277892 c 0.428232,-0.932974 -0.275392,-1.990228 -1.301363,-1.955687 l -4.706346,0.156432 c -0.245414,-0.309077 -0.495186,-0.614122 -0.749828,-0.915638 l 1.087557,-4.583886 c 0.111945,-0.465559 -0.02657,-0.95631 -0.365261,-1.29481 -0.336845,-0.33999 -0.826414,-0.47977 -1.292154,-0.36944 l -4.596337,1.072808 c -0.29805,-0.252358 -0.60004,-0.499808 -0.90586,-0.742668 l 0.17479,-4.71739 c 0.039,-1.02622 -1.01598,-1.73437 -1.95088,-1.3094 l -4.298,1.9505 c -0.34153,-0.19037 -0.68589,-0.37573 -1.03289,-0.55595 l -0.74985,-4.65997 c -0.16087,-1.01433 -1.3345,-1.50299 -2.16779,-0.9027 l -3.82785,2.74586 c -0.37605,-0.12024 -0.75307,-0.23609 -1.13188,-0.34733 l -1.64218,-4.41461 c -0.35829,-0.96059 -1.60143,-1.20959 -2.3026,-0.4616 l -3.21779,3.43622 c -0.39312,-0.0449 -0.78724,-0.0841 -1.18147,-0.11793 l -2.46939,-4.00717 c -0.53587,-0.87693 -1.80875,-0.87987 -2.34859,-0.005 l -2.48775,4.00814 c -0.38905,0.033 -0.78021,0.07 -1.16894,0.11399 l -3.21321,-3.45713 c -0.34908,-0.37544 -0.83397,-0.50245 -1.27743,-0.415 z m 8.68019,7.94326 c 0.92077,-0.19258 1.9161,0.0678 2.62156,0.77848 1.10342,1.10855 1.08527,2.89468 -0.0407,3.992 -2.72338,2.523017 -6.59761,-1.37385 -3.99545,-4.01874 0.40512,-0.39343 0.89805,-0.64376 1.41459,-0.75177 z m -6.1626,4.84985 5e-4,-10e-5 c 0.19052,-0.0365 0.38141,-0.0711 0.57265,-0.10369 0.002,0.003 0.007,0.006 0.009,0.009 1.39869,1.373203 2.43601,2.435573 3.12486,3.155882 0.002,0.0018 0.007,0.006 0.007,0.0076 0.006,0.0069 0.0114,0.01181 0.0172,0.0182 0.66763,0.698959 1.01205,1.080959 1.01205,1.080959 0.12336,0.125885 0.25671,0.236332 0.39716,0.331511 8.5e-4,7.03e-4 0.003,0.0016 0.004,0.0031 8.5e-4,7.03e-4 0.003,0.0016 0.003,0.0024 0.14091,0.09472 0.28869,0.173983 0.44191,0.237881 0.15453,0.06443 0.31434,0.113232 0.47652,0.146263 0.15992,0.03256 0.32208,0.04945 0.4847,0.05143 0.005,2e-5 0.009,2.66e-4 0.0142,2.23e-4 0.1625,0.0011 0.32539,-0.01258 0.48576,-0.04202 0.1626,-0.03 0.32307,-0.07559 0.47864,-0.137033 l 5.1e-4,-1.03e-4 c 0.15559,-0.06144 0.30626,-0.138938 0.44993,-0.231936 l 5.1e-4,-1.01e-4 c 0.14381,-0.09306 0.28006,-0.201962 0.40701,-0.326707 l 4.26375,-4.190142 0.13287,-0.13046 c 10.25061,1.818206 19.12288,7.66397 24.215355,16.744033 -0.203648,0.4934 -0.402765,0.923878 -0.580225,1.342624 -2.66158,5.981052 -2.76081,6.182468 -2.76081,6.182468 -0.0727,0.162451 -0.12741,0.328226 -0.16468,0.495426 -0.0368,0.167296 -0.057,0.335916 -0.0603,0.503326 -0.003,0.16739 0.01,0.333476 0.0383,0.4965 0.029,0.162914 0.0728,0.322994 0.13143,0.477099 0.059,0.154076 0.13256,0.302266 0.21999,0.442799 0.0874,0.140531 0.18862,0.272954 0.30284,0.395388 0.22842,0.244861 0.50883,0.449087 0.83392,0.5941 l 5.459782,2.434477 0.845392,0.376948 c 1.107268,10.265042 -2.407605,20.490879 -9.591904,27.905909 -0.002,-3.82e-4 -0.004,-0.0011 -0.006,-0.0015 -2.31192,-0.468705 -3.81804,-0.815228 -4.75497,-1.046989 -0.0276,-0.0069 -0.0466,-0.01213 -0.0733,-0.0188 -0.85843,-0.214435 -1.24228,-0.332954 -1.24228,-0.332954 -0.17348,-0.03986 -0.34665,-0.06088 -0.5179,-0.0649 -0.17124,-0.004 -0.34065,0.0088 -0.50553,0.03796 -0.16483,0.02942 -0.3254,0.07432 -0.47973,0.13409 -0.1537,0.05943 -0.30081,0.133792 -0.43996,0.221012 -0.002,8.37e-4 -0.004,0.0017 -0.005,0.0028 -0.13868,0.08726 -0.26905,0.187682 -0.38911,0.30001 -0.12086,0.1131 -0.23131,0.238223 -0.32922,0.374057 -0.0969,0.134462 -0.18117,0.279843 -0.25153,0.434068 -9.1e-4,0.0033 -0.003,0.0066 -0.004,0.01011 -0.0697,0.154516 -0.12565,0.317989 -0.1647,0.489655 l -1.32668,5.829261 -0.26476,1.163515 c -2.39569,1.074214 -4.90539,1.873452 -7.48107,2.382413 -7.23006,1.41614 -14.72312,0.497665 -21.39706,-2.622839 -1e-4,-7.85e-4 -4.4e-4,-0.002 -2.8e-4,-0.0029 -0.0114,-0.08464 -0.0256,-0.171156 -0.0442,-0.26043 l -1.40033,-6.62438 c -0.0363,-0.174232 -0.0899,-0.340506 -0.15811,-0.497649 -0.0678,-0.156436 -0.15033,-0.303512 -0.24535,-0.440434 -5.1e-4,-7.12e-4 -5.8e-4,-0.0017 -0.001,-0.0028 -5.6e-4,-9.04e-4 -0.002,-0.0018 -0.002,-0.0025 -0.0952,-0.136352 -0.20268,-0.262818 -0.3208,-0.377104 -0.119,-0.115065 -0.24859,-0.218232 -0.3868,-0.308269 -0.13819,-0.09003 -0.28474,-0.166846 -0.43808,-0.229153 -0.15333,-0.06232 -0.31338,-0.109887 -0.47775,-0.141811 -0.16436,-0.03192 -0.33308,-0.04817 -0.50436,-0.04702 -0.17131,0.0011 -0.34515,0.01964 -0.51927,0.05647 l -5.84811,1.239492 -0.18043,0.03861 c -4.52366,-4.762243 -7.60487,-10.709392 -8.88641,-17.151552 -0.68623,-3.538886 -0.81766,-7.162989 -0.38953,-10.742277 0.0108,-0.0053 0.005,-0.0019 0.016,-0.0072 4.15329,-1.980307 4.85506,-2.283534 6.03817,-2.83806 0.14935,-0.07 0.29019,-0.155955 0.4211,-0.255222 0.2618,-0.19864 0.48364,-0.450703 0.65503,-0.735867 0.0857,-0.142573 0.15893,-0.293539 0.21789,-0.450056 0.059,-0.156527 0.1038,-0.318622 0.13352,-0.483878 0.0293,-0.165355 0.0434,-0.333532 0.0405,-0.502571 -0.003,-0.169065 -0.0224,-0.338795 -0.0603,-0.506406 -0.0381,-0.16757 -0.0943,-0.333183 -0.17007,-0.494242 l -2.54605,-5.408769 -0.58623,-1.245471 c 4.97244,-8.899694 13.60223,-15.166851 23.60374,-17.141583 z m -27.71825,20.699241 c 1.16881,-0.23341 2.40516,0.274761 3.03244,1.348013 1.77548,3.225236 -3.0343,5.970929 -4.96024,2.831565 -0.78431,-1.347412 -0.31016,-3.073545 1.05875,-3.85345 0.27799,-0.158894 0.57112,-0.266586 0.86905,-0.326126 z m 67.782423,0.08974 c 0.515747,-0.103687 1.094937,-0.057 1.711583,0.196758 1.438572,0.6307 2.080744,2.297494 1.433328,3.721004 -0.645774,1.425225 -2.335706,2.070133 -3.776255,1.441576 -2.756826,-1.286942 -1.723357,-4.886752 0.631344,-5.359338 z m -55.414503,39.61809 c 3.66228,-0.686803 4.79615,4.667401 1.16936,5.521684 -1.54335,0.326891 -3.05582,-0.64366 -3.37715,-2.167041 -0.32365,-1.523814 0.66416,-3.024848 2.20781,-3.354645 z m 42.17797,0.149579 c 1.80124,-0.372707 3.95804,0.959427 3.4645,3.326487 -0.3537,1.519715 -1.88726,2.474143 -3.42348,2.130515 -1.53759,-0.341726 -2.49836,-1.850552 -2.14718,-3.37174 0.31662,-1.226945 1.16264,-1.890036 2.10616,-2.085262 z" />
-    <path
-       fill="#ffffff"
-       d="m -106.20282,-74.830666 c 1.08468,-7.250477 -4.43576,-11.148165 -11.98424,-13.748316 l 3.84651,-15.348598 -6.0236,-1.48989 -3.73669,15.089717 c -1.57166,-0.391637 -3.1859,-0.761146 -4.78995,-1.127239 l 1.75732,-7.09216 -6.10145,-1.108086 -1.68033,6.902721 c -1.30093,-0.29629 -2.57802,-0.589163 -3.81766,-0.897378 l 0.007,-0.03066 -8.2449,-2.058671 -1.5904,6.385465 c 0,0 4.43576,1.016562 4.34211,1.079566 2.42136,0.604494 2.85898,2.206816 2.78577,3.477088 l -2.78918,11.189027 c 0.16688,0.04258 0.38312,0.103906 0.62152,0.199235 -0.19923,-0.04938 -0.41208,-0.103918 -0.63173,-0.156665 l -3.9096,15.674171 c -0.29629,0.735614 -1.04724,1.839016 -2.7398,1.420136 0.0596,0.08683 -4.34551,-1.084679 -4.34551,-1.084679 l -2.96797,6.84351 7.78004,1.939476 c 1.44737,0.362687 2.86581,0.742413 4.26209,1.099999 l -2.2021,8.790052 4.33512,8.083678 3.81482,-15.27822 c 1.63127,0.442729 3.21487,0.851393 4.76441,1.236231 l -3.73248,15.233272 5.9021,1.579479 3.84122,-15.455629 c 10.19461,1.929261 17.86055,1.151088 21.08734,-8.069514 2.60017,-7.424168 -0.12941,-11.706681 -5.4932,-14.499257 3.9062,-0.900773 6.8486,-3.470278 7.63361,-8.777874 z m -13.65978,19.154674 c -1.84751,7.424157 -14.34769,3.41068 -18.40034,2.404334 l 3.28299,-13.160848 c 4.05264,1.011449 17.04831,3.013927 15.11735,10.756514 z m 1.84924,-19.261945 c -1.68576,6.753254 -12.0898,3.322132 -15.46473,2.480957 l 2.97647,-11.936555 c 3.37492,0.841177 14.24382,2.411155 12.48826,9.455598 z"
-       id="path9472-9"
-       style="display:block;stroke-width:1.7028"
-       sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccccccc" />
-    <path
-       fill="#ffffff"
-       d="m -192.31893,43.08125 c 0.99062,-6.621808 -4.05116,-10.181536 -10.94512,-12.556241 l 3.53066,-14.050071 -5.49557,-1.388202 -3.43611,13.841138 c -1.43539,-0.357685 -2.90967,-0.695149 -4.37462,-1.029506 l 2.71789,-10.844758 -4.34101,-6.005463 -3.87899,15.665201 c -1.18813,-0.270597 -2.35449,-0.53808 -3.48663,-0.819563 l 0.006,-0.028 -7.53001,-1.880172 -1.45251,5.831795 c 0,0 4.05115,0.928422 3.96562,0.985963 2.21142,0.552077 2.61109,2.01547 2.54422,3.175605 l -2.54733,10.21886 c 0.15241,0.03888 0.34991,0.09487 0.56763,0.181954 -0.18195,-0.0451 -0.37635,-0.09487 -0.57696,-0.143076 l -3.57061,14.315111 c -0.2706,0.67182 -0.95642,1.67956 -2.50223,1.29699 0.0544,0.0793 -3.96873,-0.99063 -3.96873,-0.99063 l -2.71062,6.25013 7.10546,1.77131 c 1.32187,0.33125 2.61731,0.678051 3.89253,1.004631 l -3.52921,14.12699 5.49481,1.13355 3.46652,-13.80337 c 1.48983,0.40434 2.93612,0.77757 4.3513,1.12903 l -3.69054,14.76015 5.65644,0.50026 3.52376,-14.02096 c 9.31066,1.76199 16.31192,1.05128 19.25892,-7.369831 2.37471,-6.78043 -0.11819,-10.691621 -5.0169,-13.242059 3.5675,-0.822674 6.25479,-3.169388 6.97172,-8.016772 z m -12.47538,17.493825 c -1.68733,6.78044 -13.10365,3.11496 -16.8049,2.19587 l 2.99832,-12.019717 c 3.70125,0.923755 15.57011,2.752606 13.80658,9.823847 z m 1.68889,-17.591797 c -1.53959,6.167703 -11.04153,3.034086 -14.12383,2.265845 l 2.71839,-10.901567 c 3.0823,0.768239 13.00879,2.202083 11.40544,8.635722 z"
-       id="path9472-9-2"
-       style="display:block;stroke-width:1.55515"
-       sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccccccc" />
-    <g
-       id="g386"
-       transform="translate(-0.56516517,-4.8764483)">
-      <path
-         id="path75"
-         clip-path="none"
-         style="fill:#f7931a;fill-opacity:1;stroke-width:0.913143"
-         d="m -21.137019,-210.57938 c -0.45197,0 -0.90419,0.21835 -1.17408,0.65422 l -2.48409,4.01319 c -0.39083,0.032 -0.78135,0.0713 -1.16944,0.11421 l -3.21685,-3.45147 c -0.69914,-0.75238 -1.94674,-0.50362 -2.30374,0.4594 l -1.64745,4.40904 c -0.38169,0.10957 -0.76026,0.22545 -1.1374,0.34416 l -3.82043,-2.74919 c -0.833,-0.59682 -2.0035,-0.11282 -2.17093,0.89814 l -0.75758,4.64881 c -0.35065,0.18172 -0.69726,0.36881 -1.04334,0.55966 l -4.286563,-1.95389 c -0.435056,-0.19912 -0.94218,-0.15812 -1.339453,0.10852 -0.398125,0.26482 -0.631149,0.71874 -0.612883,1.19631 l 0.164331,4.71703 c -0.304989,0.24381 -0.607291,0.49314 -0.905887,0.74517 l -4.594035,-1.08262 c -0.465917,-0.10905 -0.955181,0.03 -1.293978,0.36794 -0.339015,0.33815 -0.47826,0.82803 -0.367936,1.29397 l 1.082104,4.59455 c -0.251723,0.29806 -0.499322,0.59924 -0.743107,0.90383 l -4.717025,-0.16382 c -1.02634,-0.0375 -1.73288,1.01957 -1.305346,1.95337 l 1.953886,4.28708 c -0.191479,0.34526 -0.377466,0.69283 -0.559139,1.04334 l -4.647779,0.75655 c -1.012514,0.16547 -1.497953,1.33769 -0.898653,2.17041 l 2.749186,3.81837 c -0.119625,0.37713 -0.235108,0.75623 -0.344682,1.13791 l -4.409549,1.64848 c -0.963281,0.35761 -1.210897,1.60521 -0.457337,2.30374 l 3.449402,3.21634 c -0.04295,0.38808 -0.08133,0.77849 -0.114205,1.1684 l -4.012158,2.48409 c -0.873931,0.53857 -0.873931,1.80857 0,2.34714 l 4.012158,2.48409 c 0.03285,0.39082 0.07131,0.78083 0.114205,1.16892 l -3.449402,3.21686 c -0.750129,0.69931 -0.503129,1.94371 0.457337,2.30322 l 4.409549,1.64796 c 0.109574,0.38169 0.225057,0.76078 0.344682,1.13791 l -2.749186,3.81992 c -0.600851,0.8326 -0.114529,2.00612 0.89917,2.16938 l 4.647262,0.75603 c 0.181713,0.35247 0.367373,0.69933 0.559139,1.04541 l -1.953886,4.28553 c -0.19892,0.4354 -0.157934,0.94281 0.10852,1.34048 0.266633,0.39905 0.721081,0.63206 1.196826,0.61289 l 4.714958,-0.16537 c 0.245631,0.30682 0.493153,0.60729 0.745174,0.90589 l -1.082104,4.59558 c -0.109575,0.46571 0.02826,0.95263 0.367936,1.2914 0.336945,0.3406 0.827364,0.47648 1.293978,0.3669 l 4.594035,-1.0821 c 0.298596,0.25385 0.600898,0.50072 0.905887,0.74362 l -0.164331,4.71806 c -0.03755,1.02589 1.019063,1.73195 1.952336,1.30431 l 4.286563,-1.95336 c 0.34516,0.19176 0.69179,0.37794 1.04334,0.55965 l 0.75758,4.64571 c 0.16631,1.01173 1.33732,1.49768 2.17093,0.90072 l 3.81889,-2.75125 c 0.37762,0.12059 0.75708,0.23559 1.13791,0.34572 l 1.64796,4.40748 c 0.16711,0.44744 0.55396,0.7784 1.02423,0.86971 0.46894,0.0946 0.95392,-0.0614 1.27899,-0.41237 l 3.21634,-3.44941 c 0.38808,0.0448 0.77913,0.0821 1.16996,0.11679 l 2.48408,4.01268 c 0.54041,0.87064 1.80674,0.87064 2.34715,0 l 2.48408,-4.01268 c 0.39011,-0.0339 0.77984,-0.0727 1.16892,-0.11679 l 3.21583,3.44941 c 0.32599,0.35064 0.81055,0.50734 1.27899,0.41237 0.46952,-0.0924 0.85712,-0.42132 1.02423,-0.86971 l 1.6479602,-4.40748 c 0.38083,-0.11013 0.76026,-0.22513 1.13791,-0.34572 l 3.81992,2.75125 c 0.8332,0.59843 2.00525,0.1118 2.1699,-0.90072 l 0.75757,-4.64571 c 0.35064998,-0.18171 0.69726998,-0.37063 1.04334998,-0.55965 l 4.28656002,1.95336 c 0.93327,0.42764 1.9899,-0.27842 1.95234,-1.30431 l -0.16433,-4.71806 c 0.30498,-0.24381 0.60716,-0.48977 0.90485,-0.74362 l 4.5940298,1.0821 c 0.46553,0.11133 0.95536,-0.0276 1.29295,-0.3669 0.33968,-0.33877 0.47751,-0.82569 0.36794,-1.2914 l -1.08211,-4.59558 c 0.25203,-0.2986 0.50073,-0.59907 0.74362,-0.90589 l 4.71703,0.16537 c 0.47822,0.0179 0.93145,-0.2143 1.19631,-0.61289 0.26664,-0.39812 0.30747,-0.90491 0.10749,-1.34048 l -1.95286,-4.28553 c 0.19086,-0.34608 0.37783,-0.69294 0.55863,-1.04541 l 4.64777,-0.75603 c 1.01332,-0.16383 1.49944,-1.33708 0.89866,-2.16938 l -2.74919,-3.81992 c 0.11871,-0.37713 0.2342,-0.75622 0.34468,-1.13791 l 4.40852,-1.64796 c 0.44836,-0.16802 0.77839,-0.55448 0.86971,-1.02475 0.0946,-0.46894 -0.0615,-0.95339 -0.41238,-1.27847 l -3.44836,-3.21686 c 0.042,-0.38809 0.0804,-0.77901 0.1142,-1.16892 l 4.01216,-2.48409 c 0.8741,-0.53832 0.87485,-1.80832 0.001,-2.34714 l -4.01215,-2.48409 c -0.0339,-0.39 -0.072,-0.77921 -0.11421,-1.1684 l 3.44837,-3.21634 c 0.35066,-0.32691 0.50735,-0.81106 0.41238,-1.27951 -0.092,-0.46968 -0.42163,-0.85741 -0.87023,-1.02423 l -4.40801,-1.64848 c -0.11065,-0.38058 -0.22523,-0.76 -0.34468,-1.13791 l 2.74919,-3.81837 c 0.60055,-0.83257 0.11464,-2.00592 -0.89865,-2.17041 l -4.64778,-0.75655 c -0.18101,-0.3507 -0.36709,-0.69827 -0.55862,-1.04334 l 1.95337,-4.28708 c 0.19991,-0.43512 0.15884,-0.9434 -0.10801,-1.341 -0.26474,-0.39873 -0.71804,-0.63052 -1.19631,-0.61237 l -4.71702,0.16382 c -0.24363,-0.30522 -0.49208,-0.60641 -0.74518,-0.90383 l 1.08366,-4.59455 c 0.23672,-0.99931 -0.66144,-1.89808 -1.66088,-1.66191 l -4.5940398,1.08262 c -0.29826,-0.25283 -0.60028,-0.50128 -0.90588,-0.74517 l 0.16536,-4.71703 c 0.0383,-1.02629 -1.01869,-1.73267 -1.95234,-1.30483 l -4.28656002,1.95389 c -0.34567,-0.19072 -0.69323,-0.37722 -1.04333998,-0.55966 l -0.75758,-4.64881 c -0.1658,-1.01175 -1.33731,-1.49642 -2.16989,-0.89814 l -3.82147,2.74919 c -0.37701,-0.1201 -0.75612,-0.23478 -1.13637,-0.34416 l -1.6479602,-4.40904 c -0.35618,-0.96399 -1.60447,-1.21299 -2.30322,-0.4594 l -3.21582,3.45147 c -0.38808,-0.0429 -0.77901,-0.0822 -1.16892,-0.11421 l -2.48409,-4.01319 c -0.2699,-0.43587 -0.72108,-0.65422 -1.17306,-0.65422 z m 6.98046,9.47177 c 0.94063,-0.0109 1.86684,0.437 2.42155,1.27072 0.86823,1.30099 0.50506,3.04991 -0.81183,3.90881 -3.15982,1.9488 -6.20745,-2.62365 -3.14296,-4.71548 0.47354,-0.30766 1.00556,-0.45796 1.53324,-0.46405 z m -6.98407,3.56671 h 5.1e-4 c 0.13007,8.7e-4 0.26011,0.003 0.39016,0.006 l -2.93315,12.20029 c -1.18813,-0.2706 -2.35447,-0.5381 -3.48661,-0.81959 l 0.006,-0.0279 -7.53029,-1.87999 -1.45211,5.83168 c 0,0 4.05118,0.92845 3.96565,0.98599 2.21142,0.55208 2.6109,2.01538 2.54403,3.17552 l -2.54713,10.21901 c 0.15241,0.0389 0.34969,0.0948 0.56741,0.1819 -0.18195,-0.0451 -0.3761,-0.0949 -0.57671,-0.14314 l -3.57084,14.31489 c -0.2706,0.67182 -0.95637,1.67964 -2.50218,1.29707 0.0544,0.0793 -3.96875,-0.99063 -3.96875,-0.99063 l -2.710425,6.25026 7.104995,1.77147 c 1.32187,0.33125 2.61756,0.67801 3.89278,1.00459 l -3.51554,12.00599 c -1.43905,-0.76859 -2.83619,-1.62458 -4.16409,-2.59674 5e-5,-8e-4 -5e-5,-0.002 0,-0.003 0.005,-0.0852 0.008,-0.17287 0.007,-0.26406 l -0.093,-6.77013 c -0.002,-0.17798 -0.0224,-0.35147 -0.0589,-0.51884 -0.0363,-0.1666 -0.0888,-0.32684 -0.15555,-0.47955 -3.7e-4,-8e-4 -6.6e-4,-0.002 -0.001,-0.003 -4e-4,-0.001 -10e-4,-0.002 -0.002,-0.003 -0.067,-0.15218 -0.14804,-0.29705 -0.24185,-0.43202 -0.0945,-0.1359 -0.2017,-0.26218 -0.31987,-0.37723 -0.11818,-0.11506 -0.24712,-0.21876 -0.38551,-0.30955 -0.13839,-0.0908 -0.28623,-0.16841 -0.441317,-0.23151 -0.155091,-0.0631 -0.317474,-0.11166 -0.485759,-0.14366 -0.168284,-0.032 -0.34241,-0.0475 -0.520381,-0.045 l -5.977413,0.0853 -0.184485,0.003 c -3.517456,-5.54707 -5.390566,-11.97776 -5.402254,-18.54615 0.01098,-3.60478 0.582817,-7.18591 1.694987,-10.61485 0.01178,-0.003 0.0053,-0.001 0.01705,-0.004 4.457815,-1.13985 5.204977,-1.30166 6.47299,-1.61696 0.160058,-0.0398 0.314873,-0.0968 0.462504,-0.16898 0.295263,-0.14426 0.561663,-0.34867 0.784965,-0.59531 0.111651,-0.12332 0.212659,-0.25729 0.300757,-0.39946 0.0881,-0.14217 0.163441,-0.29253 0.224276,-0.44907 0.06083,-0.15653 0.10708,-0.31884 0.136942,-0.48524 0.02986,-0.1664 0.04358,-0.33671 0.03876,-0.50849 -0.0048,-0.17179 -0.0281,-0.34514 -0.07131,-0.5178 l -1.452108,-5.79913 -0.334346,-1.33532 c 6.599452,-7.77026 16.278202,-12.25047 26.472802,-12.25403 z m 15.9581902,3.86901 c 8.06501,4.07633 14.27692,10.88901 17.1291898,19.59674 -0.29521,0.44471 -0.57381,0.82857 -0.82889,1.20509 -3.7678498,5.35354 -3.9041498,5.53197 -3.9041498,5.53197 -0.10279,0.1453 -0.1885,0.29738 -0.25735,0.45423 -0.0688,0.15686 -0.12084,0.31857 -0.15658,0.48214 -0.0357,0.16358 -0.0549,0.32907 -0.0584,0.49455 -0.003,0.16547 0.009,0.33098 0.0367,0.4935 0.028,0.16255 0.0716,0.32219 0.13022,0.47698 0.0586,0.15479 0.13227,0.30427 0.22066,0.44648 0.17677,0.28442 0.41239,0.539 0.70332,0.74414 l 4.8859998,3.44424 0.75654,0.5333 c -0.89852,10.28541 -6.3243398,19.63861 -14.8068398,25.52454 -0.002,-7.9e-4 -0.004,-0.002 -0.006,-0.003 -2.17765,-0.90689 -3.58835,-1.5381 -4.46277,-1.94665 -0.0258,-0.0121 -0.0433,-0.0209 -0.0682,-0.0326 -0.80077,-0.37639 -1.15445,-0.56689 -1.15445,-0.56689 -0.16252,-0.0726 -0.32833,-0.12677 -0.49557,-0.16382 -0.16725,-0.037 -0.33593,-0.0572 -0.50333,-0.0605 -0.16741,-0.003 -0.33363,0.01 -0.49661,0.0388 -0.16229,0.0286 -0.32101,0.0731 -0.47439,0.13177 -0.002,5.3e-4 -0.004,7.6e-4 -0.005,0.002 -0.15291,0.0588 -0.30025,0.13212 -0.43977,0.21911 -0.14044,0.0876 -0.27301,0.189 -0.39532,0.30334 -0.12108,0.11319 -0.2318802,0.23953 -0.3307302,0.37724 -0.002,0.003 -0.004,0.006 -0.006,0.009 -0.0983,0.13811 -0.18477,0.28769 -0.25632,0.44856 l -2.42879,5.46271 -0.48473,1.09037 c -2.55818,0.59071 -5.17506,0.88959 -7.80055,0.89091 -0.27983,-3.3e-4 -0.55692,-0.027 -0.83613,-0.0341 l 3.30264,-12.26023 c 9.3106602,1.76198 16.3117802,1.05102 19.25878018,-7.3701 2.37471002,-6.78043 -0.11804,-10.69164 -5.01674998,-13.24208 3.56749998,-0.82267 6.25473,-3.16918 6.97166,-8.01657 h 5.2e-4 c 0.99062,-6.6218 -4.05111,-10.18163 -10.94507,-12.55633 z m -5.8492502,0.10387 -2.77451,10.44794 c -1.43539,-0.35768 -2.90946,-0.69555 -4.37441,-1.02991 l 1.67794,-7.62021 c 0.11921,0.0745 0.24098,0.14479 0.36948,0.19844 0.1506,0.0629 0.30644,0.11079 0.46561,0.14418 0.005,9.8e-4 0.009,0.002 0.0139,0.003 0.15922,0.0325 0.32167,0.0506 0.48472,0.0527 0.16533,0.002 0.33158,-0.0117 0.4961,-0.0419 h 5.2e-4 c 0.16453,-0.0302 0.32733,-0.0771 0.48627,-0.14056 h 5.2e-4 c 0.15908,-0.0635 0.31382,-0.14401 0.4625,-0.24185 z m -41.306522,10.97607 c 1.191892,-0.003 2.306642,0.73465 2.714564,1.90893 1.118338,3.50769 -4.131582,5.27154 -5.41414,1.81901 -0.508973,-1.47364 0.290013,-3.0755 1.78387,-3.57601 0.303472,-0.10214 0.611891,-0.15111 0.915706,-0.15193 z m 32.686372,4.89118 c 3.0823,0.76824 13.0088602,2.20201 11.4055102,8.63565 -1.53959,6.1677 -11.0419002,3.03425 -14.1242002,2.26601 z m 33.79949,8.30337 c 0.52608,-0.002 1.0853,0.15579 1.64124,0.524 1.28947,0.89696 1.59724,2.65647 0.68679,3.92792 -0.90918,1.27347 -2.69192,1.57943 -3.98374,0.6842 -2.45596,-1.79572 -0.74593,-5.12776 1.65571,-5.13612 z m -37.88967,8.10028 c 3.70125,0.92376 15.5699202,2.75296 13.8063902,9.82421 -1.6873302,6.78043 -13.1034102,3.11482 -16.8046602,2.19573 z m -4.77284,18.5906 c 1.48983,0.40433 2.93598,0.77715 4.35116,1.12861 l -3.47473,12.88758 c -1.57123,-0.3013 -3.11981,-0.69781 -4.63176,-1.21129 z m -19.366776,1.46451 c 3.725957,0.0343 3.803124,5.5067 0.07958,5.64358 -1.577437,0.0223 -2.873688,-1.2224 -2.894397,-2.77916 -0.02291,-1.55763 1.236512,-2.83933 2.814815,-2.86442 z m 41.3530262,8.30233 c 1.83932,-0.0174 3.69784,1.70666 2.75591,3.93361 -0.64087,1.42264 -2.33004,2.06253 -3.77083,1.42834 -1.4425,-0.63259 -2.09338,-2.29871 -1.45469,-3.72329 0.54787,-1.14257 1.50617,-1.62955 2.46961,-1.63866 z" />
-      <g
-         inkscape:label="Layer 1"
-         id="layer1-3"
-         transform="translate(-156.41293,-392.70627)">
-        <path
-           d="m 254.26362,273.57035 -4.40517,-1.63745 a 54.213298,54.213298 0 0 0 -0.3409,-1.11881 l 2.73526,-3.81701 c 0.27821,-0.38802 0.33654,-0.8914 0.15186,-1.33013 a 1.3695876,1.3695876 0 0 0 -1.0508,-0.82952 l -4.6272,-0.74403 a 51.06943,51.06943 0 0 0 -0.56038,-1.04316 l 1.9349,-4.26831 a 1.3750441,1.3750441 0 0 0 -1.30334,-1.94295 l -4.68656,0.17418 a 39.007783,39.007783 0 0 0 -0.75052,-0.90938 l 1.06547,-4.56939 a 1.3695876,1.3695876 0 0 0 -0.36834,-1.28768 1.3677688,1.3677688 0 0 0 -1.28827,-0.36342 l -4.57362,1.08652 a 37.124373,37.124373 0 0 0 -0.90501,-0.73639 l 0.15631,-4.69921 a 1.3750441,1.3750441 0 0 0 -1.94804,-1.2966 l -4.27293,1.95924 a 39.484319,39.484319 0 0 0 -1.03072,-0.5497 l -0.76466,-4.63834 a 1.3732253,1.3732253 0 0 0 -2.16237,-0.89082 l -3.80144,2.7494 a 49.537966,49.537966 0 0 0 -1.12897,-0.34164 l -1.6526,-4.39025 a 1.3759535,1.3759535 0 0 0 -2.29478,-0.4514 l -3.19153,3.43473 a 41.755143,41.755143 0 0 0 -1.1767,-0.11313 l -2.47474,-3.98099 a 1.3723159,1.3723159 0 0 0 -2.33873,0.004 l -2.46275,4.00062 c -0.38733,0.0343 -0.77664,0.0727 -1.16361,0.118 l -3.21292,-3.43092 a 1.3750441,1.3750441 0 0 0 -2.29226,0.46087 l -1.63727,4.40606 c -0.37532,0.10794 -0.7492,0.22299 -1.11971,0.34108 l -3.81844,-2.73776 a 1.3732253,1.3732253 0 0 0 -2.15838,0.90058 l -0.74385,4.6281 c -0.35116,0.18192 -0.69753,0.36936 -1.04245,0.5593 l -4.27009,-1.93454 a 1.3777724,1.3777724 0 0 0 -1.94289,1.30341 l 0.17258,4.68782 c -0.30669,0.24626 -0.60874,0.49715 -0.9092,0.75143 l -4.56867,-1.06656 a 1.370497,1.370497 0 0 0 -1.28662,0.36907 c -0.33674,0.3367 -0.47501,0.82554 -0.36342,1.28825 l 1.08652,4.57363 c -0.24993,0.29792 -0.49611,0.60066 -0.73817,0.90534 l -4.69813,-0.15555 a 1.3795912,1.3795912 0 0 0 -1.19113,0.61331 1.3732253,1.3732253 0 0 0 -0.1053,1.3356 l 1.95853,4.27402 a 44.22513,44.22513 0 0 0 -0.54828,1.02858 l -4.63817,0.76555 a 1.3741347,1.3741347 0 0 0 -0.89064,2.16324 l 2.74959,3.80236 a 41.851542,41.851542 0 0 0 -0.34165,1.12896 l -4.3898,1.65068 a 1.3759535,1.3759535 0 0 0 -0.45122,2.29567 l 3.4342,3.18885 c -0.0428,0.3917 -0.0816,0.78447 -0.11367,1.17867 l -3.98099,2.47474 a 1.3732253,1.3732253 0 0 0 0.006,2.33926 l 3.99883,2.46309 c 0.0343,0.38736 0.0736,0.77647 0.11801,1.16362 l -3.43003,3.21275 a 1.3732253,1.3732253 0 0 0 0.46087,2.29226 l 4.40518,1.63744 c 0.10879,0.37514 0.2228,0.74832 0.34089,1.11881 l -2.73598,3.81808 a 1.3750441,1.3750441 0 0 0 0.89879,2.15875 l 4.6281,0.74385 c 0.18191,0.35117 0.36953,0.69841 0.56037,1.04316 l -1.93472,4.26921 a 1.3741347,1.3741347 0 0 0 1.30414,1.94181 l 4.68567,-0.174 c 0.24661,0.30848 0.49661,0.61071 0.75179,0.91098 l -1.06674,4.56778 a 1.3732253,1.3732253 0 0 0 0.36925,1.2875 c 0.33867,0.33728 0.8275,0.47554 1.28825,0.36344 l 4.57166,-1.08707 c 0.30007,0.25135 0.60066,0.49611 0.90536,0.73818 l -0.15432,4.69974 c -0.0156,0.47621 0.2146,0.92435 0.61276,1.18844 0.39586,0.26642 0.90135,0.30301 1.33544,0.10441 l 4.27312,-1.95835 c 0.34138,0.18924 0.68489,0.37064 1.03036,0.54793 l 0.76573,4.63906 a 1.3732253,1.3732253 0 0 0 2.16217,0.88992 l 3.80164,-2.74852 c 0.37465,0.11947 0.75003,0.23324 1.12896,0.34164 l 1.65207,4.38758 a 1.3777724,1.3777724 0 0 0 2.29603,0.453 l 3.18849,-3.43596 a 42.924658,42.924658 0 0 0 1.17885,0.11455 l 2.47437,3.97921 c 0.25097,0.40408 0.69409,0.6517 1.17119,0.64855 a 1.3668594,1.3668594 0 0 0 1.16719,-0.65395 l 2.46399,-3.99903 c 0.38771,-0.0325 0.77666,-0.0726 1.16506,-0.11549 l 3.21273,3.43001 a 1.3759535,1.3759535 0 0 0 2.29225,-0.46087 l 1.63745,-4.40517 a 44.616181,44.616181 0 0 0 1.11829,-0.34357 l 3.81718,2.73616 c 0.38713,0.27838 0.89051,0.33671 1.32924,0.15204 a 1.3714065,1.3714065 0 0 0 0.82952,-1.0508 l 0.7442,-4.62632 a 42.924658,42.924658 0 0 0 1.04297,-0.56126 l 4.26959,1.93649 a 1.3759535,1.3759535 0 0 0 1.94171,-1.30491 l -0.17206,-4.68514 c 0.30673,-0.24621 0.60842,-0.49891 0.90919,-0.75142 l 4.56851,1.06565 a 1.3732253,1.3732253 0 0 0 1.65023,-1.65642 l -1.08672,-4.57452 c 0.24993,-0.29792 0.49683,-0.5971 0.73764,-0.90339 l 4.69795,0.15468 a 1.3677688,1.3677688 0 0 0 1.19043,-0.61225 c 0.26517,-0.39745 0.30424,-0.89972 0.10583,-1.33293 l -1.95872,-4.27489 c 0.18748,-0.34103 0.37099,-0.6831 0.54792,-1.03037 l 4.63834,-0.76466 a 1.3686782,1.3686782 0 0 0 1.04769,-0.83306 c 0.1822,-0.44107 0.12284,-0.94398 -0.15793,-1.32999 l -2.74833,-3.80077 c 0.1184,-0.37537 0.23306,-0.75091 0.34038,-1.13056 l 4.38973,-1.65064 a 1.3741347,1.3741347 0 0 0 0.4514,-2.29477 l -3.43438,-3.18973 c 0.0419,-0.39154 0.0807,-0.7843 0.11367,-1.17868 l 3.98009,-2.47455 c 0.40477,-0.25211 0.65171,-0.69411 0.64856,-1.17119 a 1.3668594,1.3668594 0 0 0 -0.65395,-1.16719 l -3.99813,-2.46416 c -0.0352,-0.38717 -0.0745,-0.77629 -0.118,-1.16364 l 3.43002,-3.21273 a 1.3732253,1.3732253 0 0 0 -0.46019,-2.2924 z m -19.6864,37.77068 a 2.8319361,2.8319361 0 0 1 -2.78949,-2.87041 2.822842,2.822842 0 0 1 2.8608,-2.79127 2.8301173,2.8301173 0 0 1 2.79074,2.86739 2.8301173,2.8301173 0 0 1 -2.86205,2.79429 z m -3.14124,-8.73554 a 2.5763889,2.5763889 0 0 0 -2.60939,2.54683 l -0.0859,6.77035 a 34.652567,34.652567 0 0 1 -13.46874,5.86094 34.686216,34.686216 0 0 1 -15.00985,-0.27711 l -2.69496,-6.21125 a 2.5754795,2.5754795 0 0 0 -3.38987,-1.33973 l -5.48281,2.38245 a 34.678941,34.678941 0 0 1 -3.66486,-2.89664 l 27.88146,-5.60569 c 0.31563,-0.0634 0.51455,-0.16286 0.45684,-0.44991 l -1.98293,-9.86266 c -0.0577,-0.28709 -0.2796,-0.30182 -0.59523,-0.23837 l -8.15438,1.63948 -1.25694,-6.25177 8.8195,-1.77319 c 0.8051,-0.16187 4.35079,-0.63543 6.36906,3.61266 0.62696,1.30526 2.29611,5.62538 3.11019,6.9524 0.84727,1.50123 3.62703,4.28177 5.90146,3.82449 l 13.89347,-2.79334 c 0.15781,-0.0317 0.32271,-0.0834 0.4937,-0.15121 a 34.919937,34.919937 0 0 1 -2.41443,4.34246 z m -36.77971,16.62083 a 2.8255702,2.8255702 0 0 1 -3.71906,-1.46835 2.8328456,2.8328456 0 0 1 1.46423,-3.72566 2.8319361,2.8319361 0 0 1 2.25483,5.19401 z m -19.19992,-40.76291 a 2.8319361,2.8319361 0 0 1 -0.67338,3.94512 2.8246608,2.8246608 0 0 1 -3.9403,-0.67713 2.8319361,2.8319361 0 0 1 0.67338,-3.94512 2.8246608,2.8246608 0 0 1 3.9403,0.67713 z m -1.70138,8.35949 5.43584,-3.85256 a 2.580936,2.580936 0 0 0 0.61363,-3.59639 l -1.78841,-2.53274 4.83504,-0.97211 4.38173,21.79376 -9.75478,1.96123 a 34.838089,34.838089 0 0 1 -3.18139,-9.09665 c -0.24898,-1.2384 -0.42824,-2.47599 -0.54167,-3.70454 z m 25.76904,-7.38315 -1.29154,-6.42383 11.51386,-2.3149 c 0.59468,-0.11957 4.33754,-0.15689 4.87943,2.53836 0.44994,2.23786 -2.15353,3.59615 -4.42706,4.05326 l -10.67486,2.14622 z m 43.00607,-2.63095 c 0.17137,0.85236 0.30978,1.70206 0.41565,2.5518 l -3.50035,0.70377 c -0.35038,0.0704 -0.44499,0.32882 -0.376,0.67205 l 0.32321,1.60751 c 0.76075,3.78386 -1.20734,5.03575 -3.03486,5.62117 -1.74014,0.55858 -3.90429,0.009 -4.36674,-1.03108 -2.23803,-5.69644 -4.24185,-6.60615 -7.44402,-8.23037 2.99198,-2.86772 5.91493,-6.79853 5.0502,-11.0995 -0.93375,-4.64424 -4.70571,-6.92939 -7.16424,-7.92763 -3.44824,-1.39479 -6.90015,-1.11913 -7.80956,-0.93629 l -36.20078,7.27833 c 3.80751,-6.46574 9.68017,-11.68439 16.92115,-14.60956 l 5.16714,3.61869 a 2.5736607,2.5736607 0 0 0 3.58816,-0.63607 l 3.85626,-5.52659 c 10.37888,-0.14892 20.10098,4.37583 26.70018,11.93842 l -1.78428,8.03942 a 2.5836643,2.5836643 0 0 0 1.95676,3.0796 l 6.85473,1.52991 c 0.33338,1.09529 0.61739,2.21254 0.84737,3.35644 z m -43.68306,-30.06602 a 2.8237514,2.8237514 0 0 1 3.9357,-0.6976 2.8328456,2.8328456 0 0 1 0.69705,3.9423 2.8219325,2.8219325 0 0 1 -3.9359,0.69672 2.833755,2.833755 0 0 1 -0.69686,-3.94141 z m 37.68373,19.58143 a 2.8237514,2.8237514 0 0 1 3.3717,-2.14633 2.8319361,2.8319361 0 0 1 2.14581,3.37831 2.8237514,2.8237514 0 0 1 -3.37242,2.14742 2.8346644,2.8346644 0 0 1 -2.14508,-3.37939 z"
-           id="path8380"
-           style="fill:#f5680f;fill-opacity:1;stroke-width:0.909418"
-           inkscape:export-filename="/home/hunter/omoc-rust.png"
-           inkscape:export-xdpi="96"
-           inkscape:export-ydpi="96" />
-      </g>
-    </g>
-    <path
-       id="path2280"
-       clip-path="none"
-       style="fill:#f7931a;fill-opacity:1;stroke-width:3.45125"
-       d="M -473.46875 -34.167969 C -475.39437 -34.231695 -477.33899 -33.241041 -478.31445 -31.285156 L -486.3125 -15.351562 C -487.76573 -15.094933 -489.22559 -14.823369 -490.67383 -14.525391 L -503.94727 -26.443359 C -505.38912 -27.737734 -507.25704 -28.050501 -508.89648 -27.570312 L -508.89648 -27.574219 C -510.53597 -27.094257 -511.94285 -25.820665 -512.45898 -23.953125 L -517.20898 -6.7578125 C -518.59271 -6.2266377 -519.96794 -5.6712007 -521.33008 -5.1035156 L -536.66211 -14.207031 C -539.99709 -16.193702 -544.25905 -13.966896 -544.53125 -10.09375 L -545.82422 7.6484375 C -547.09244 8.4511714 -548.34402 9.274464 -549.58594 10.105469 L -566.36328 4.1894531 C -570.0185 2.9092516 -573.74945 5.9071531 -573.2832 9.7519531 L -571.09375 27.419922 C -572.17277 28.451431 -573.23244 29.498776 -574.28516 30.558594 L -591.9082 28.023438 C -593.69781 27.763406 -595.49449 28.448687 -596.65234 29.837891 C -597.8153 31.221236 -598.17695 33.115168 -597.60352 34.828125 L -592 51.763672 C -592.84737 52.971987 -593.67867 54.198469 -594.49414 55.429688 L -612.30664 56.380859 C -614.11246 56.480261 -615.73937 57.504256 -616.60938 59.089844 C -617.47999 60.676414 -617.46512 62.600864 -616.57031 64.173828 L -607.76758 79.689453 C -608.36406 81.037951 -608.94111 82.394121 -609.50195 83.757812 L -626.78711 88.171875 C -630.5497 89.125714 -631.98964 93.711391 -629.44727 96.644531 L -617.80664 110.11914 C -618.1347 111.57483 -618.44015 113.03363 -618.72656 114.49805 L -634.7832 122.17773 C -638.28014 123.8532 -638.79637 128.61982 -635.73828 131.00391 L -621.71094 141.93555 C -621.74495 143.43054 -621.75989 144.92884 -621.75195 146.42969 L -635.99609 157.0918 C -639.11042 159.4119 -638.68513 164.20015 -635.20898 165.93359 L -619.28125 173.93555 C -619.02462 175.38889 -618.74965 176.84758 -618.45508 178.29688 L -630.37109 191.56641 C -632.96925 194.44799 -631.62065 199.05424 -627.87695 200.08008 L -610.6875 204.83008 C -610.15345 206.21286 -609.59901 207.58711 -609.03125 208.94922 L -618.12695 224.28125 C -620.10527 227.61442 -617.88696 231.86628 -614.02148 232.15039 L -596.27734 233.44531 C -595.47457 234.7135 -594.65269 235.9661 -593.81836 237.20703 L -599.73438 253.98242 C -601.02977 257.64051 -598.02028 261.38083 -594.16992 260.89648 L -576.50977 258.70312 C -575.4764 259.78864 -574.43424 260.84866 -573.37109 261.90039 L -575.9082 279.52148 C -576.1671 281.31211 -575.48062 283.10809 -574.0918 284.26758 C -572.70097 285.43194 -570.80493 285.79546 -569.09961 285.2207 L -552.17188 279.61328 C -550.95509 280.46534 -549.73903 281.29199 -548.50781 282.10742 L -547.55273 299.92773 C -547.45333 301.73325 -546.43738 303.35255 -544.8457 304.2207 C -543.26174 305.09835 -541.33985 305.07061 -539.76367 304.17773 L -524.24805 295.37305 C -522.89535 295.97671 -521.53606 296.55223 -520.17188 297.10938 L -515.75781 314.39648 C -514.80477 318.15761 -510.22219 319.59687 -507.29102 317.05469 L -493.81836 305.41797 C -492.36267 305.74717 -490.90757 306.05411 -489.43945 306.33984 L -481.75781 322.38672 C -480.08016 325.87991 -475.31565 326.40018 -472.92578 323.34961 L -461.99609 309.31445 C -460.4983 309.35225 -459.0002 309.36429 -457.50195 309.35938 L -446.84375 323.59766 C -445.76243 325.04321 -444.00784 325.83221 -442.20508 325.66406 C -440.40364 325.50872 -438.81034 324.42886 -438.00391 322.81055 L -430 306.88281 C -428.54484 306.63299 -427.08537 306.3537 -425.63086 306.06445 L -412.35938 317.98047 C -409.47461 320.56468 -404.88137 319.22038 -403.8457 315.48828 L -399.09766 298.29492 C -397.71858 297.75785 -396.34499 297.20391 -394.98047 296.63086 L -379.6543 305.72852 C -378.09951 306.65431 -376.17457 306.70686 -374.57617 305.86523 C -372.97123 305.03158 -371.91517 303.42694 -371.78516 301.62305 L -370.48828 283.88672 C -369.22376 283.08289 -367.96833 282.26228 -366.72656 281.42383 L -349.94922 287.34766 C -346.29147 288.63353 -342.5572 285.62295 -343.03516 281.77539 L -345.2207 264.11914 C -344.14172 263.08767 -343.08585 262.03555 -342.03125 260.98242 L -324.4082 263.51562 C -320.56885 264.07575 -317.48531 260.39227 -318.71094 256.71094 L -324.31641 239.77148 C -323.46904 238.56321 -322.63444 237.35017 -321.82422 236.11328 L -304.01172 235.16016 C -302.20492 235.06831 -300.5752 234.04628 -299.71094 232.45703 C -298.83855 230.86751 -298.85697 228.95574 -299.75 227.38281 L -308.55469 211.86133 C -307.95756 210.51064 -307.37357 209.15599 -306.81836 207.78516 L -289.5332 203.37695 C -287.7795 202.93403 -286.38311 201.60983 -285.8457 199.88281 C -285.30122 198.15557 -285.69077 196.27387 -286.87891 194.90625 L -298.51172 181.43555 C -298.18706 179.97752 -297.8772 178.52128 -297.5957 177.05078 L -281.54102 169.37305 C -278.03936 167.7028 -277.52098 162.92982 -280.58398 160.54883 L -294.61328 149.61328 C -294.58305 148.11931 -294.56578 146.62097 -294.57031 145.11914 L -280.33008 134.46094 C -278.88214 133.37534 -278.09552 131.623 -278.26367 129.82031 C -278.41901 128.0188 -279.49883 126.42753 -281.11719 125.62109 L -297.04102 117.61328 C -297.30105 116.161 -297.5759 114.7022 -297.86719 113.25195 L -285.95312 99.980469 C -283.35421 97.099637 -284.6993 92.493317 -288.44141 91.466797 L -305.63281 86.716797 C -306.16992 85.338139 -306.72041 83.966324 -307.28711 82.599609 L -298.19531 67.271484 C -297.27054 65.713299 -297.21636 63.789693 -298.05859 62.191406 C -298.89103 60.585409 -300.49839 59.529084 -302.30273 59.400391 L -320.04102 58.101562 C -320.84658 56.838596 -321.66544 55.585791 -322.5 54.341797 L -316.58398 37.572266 C -315.28969 33.91459 -318.29835 30.172986 -322.14844 30.652344 L -339.81055 32.84375 C -340.8396 31.763901 -341.88218 30.700558 -342.94336 29.652344 L -340.41016 12.027344 C -340.14748 10.23683 -340.83657 8.4381378 -342.22656 7.2792969 C -343.61025 6.1141441 -345.50123 5.7542415 -347.2168 6.328125 L -364.15234 11.931641 C -365.36017 11.083212 -366.58059 10.25335 -367.81445 9.4433594 L -368.76367 -8.3730469 C -368.96588 -12.249179 -373.1783 -14.554716 -376.55273 -12.636719 L -392.06641 -3.8320312 C -393.41676 -4.4323336 -394.77698 -5.0120263 -396.14453 -5.5722656 L -400.55273 -22.857422 C -401.50366 -26.620735 -406.08925 -28.060898 -409.02148 -25.517578 L -422.49414 -13.878906 C -423.95062 -14.20319 -425.40927 -14.511005 -426.87305 -14.800781 L -434.55859 -30.859375 C -436.23429 -34.35317 -440.9982 -34.866736 -443.38281 -31.8125 L -454.32422 -17.783203 C -455.81925 -17.817219 -457.31709 -17.8314 -458.8125 -17.824219 L -469.4707 -32.066406 C -470.48381 -33.430728 -471.97104 -34.118404 -473.46875 -34.167969 z M -470.9082 -1.0917969 C -468.25918 -1.2353504 -465.55783 -0.41781892 -463.38477 1.4082031 C -458.85391 5.2053055 -458.31302 11.935367 -462.17773 16.449219 C -471.56997 26.873534 -487.48034 13.523404 -478.58594 2.6816406 C -477.19496 1.0627556 -475.42514 -0.046443258 -473.51758 -0.62890625 C -472.66748 -0.8885031 -471.79121 -1.0439457 -470.9082 -1.0917969 z M -446.99023 14.9375 C -440.87068 15.46103 -434.84345 16.365645 -428.94531 17.642578 L -439.20312 59.068359 C -445.14326 57.588145 -451.24604 56.190288 -457.30859 54.806641 L -447.51758 15.558594 L -447.44531 15.474609 L -446.99023 14.9375 z M -492.94141 19.138672 C -492.93385 19.15001 -492.91381 19.16249 -492.90625 19.173828 C -487.1738 23.866603 -482.90851 27.511481 -480.07031 29.988281 C -480.06275 29.99584 -480.04297 30.010019 -480.04297 30.017578 C -480.02029 30.044035 -479.99685 30.06011 -479.97266 30.082031 C -477.43649 32.297892 -476.32598 33.324795 -476.12109 33.513672 L -480.07812 49.902344 C -484.99503 48.782508 -489.82061 47.676607 -494.50586 46.511719 L -494.48047 46.394531 L -525.64258 38.615234 L -531.65234 62.748047 C -531.65234 62.748047 -514.88823 66.589977 -515.24219 66.828125 C -506.09059 69.112812 -504.43619 75.169645 -504.71289 79.970703 L -515.25391 122.25977 C -514.62318 122.42077 -513.80729 122.65337 -512.90625 123.01367 C -513.65925 122.82696 -514.4628 122.61929 -515.29297 122.41992 L -530.07031 181.66211 C -531.19015 184.44241 -534.02675 188.61247 -540.42383 187.0293 C -540.19857 187.35736 -556.84766 182.92969 -556.84766 182.92969 L -568.06641 208.79492 L -538.66211 216.125 C -533.19173 217.49576 -527.83001 218.93168 -522.55273 220.2832 L -527.10547 238.72266 L -544.25781 244.01172 L -544.92383 244.21875 C -563.57304 227.83314 -577.19747 206.49459 -584.21484 182.68164 C -588.00284 169.59435 -589.73077 155.99768 -589.33789 142.37891 C -589.29896 142.36001 -589.32018 142.37216 -589.28125 142.3457 C -574.32188 133.47738 -571.78221 132.09756 -567.51758 129.60742 C -566.97922 129.29297 -566.47852 128.92012 -566.01953 128.50195 C -565.10175 127.66505 -564.35268 126.64151 -563.80469 125.50977 C -563.53029 124.94389 -563.30728 124.34946 -563.13867 123.74023 C -562.96973 123.13094 -562.85672 122.50713 -562.80078 121.875 C -562.74711 121.24257 -562.74957 120.60401 -562.81836 119.96875 C -562.88715 119.33337 -563.01874 118.70197 -563.21875 118.08398 C -563.41906 117.46618 -563.6873 116.86167 -564.02734 116.28125 L -575.45312 96.787109 L -578.08203 92.298828 C -562.39518 57.105908 -532.04524 30.576832 -495.07031 19.738281 L -495.0625 19.724609 L -495.06055 19.724609 C -494.35582 19.522405 -493.65018 19.326514 -492.94141 19.138672 z M -406.54883 24.558594 C -383.99984 33.728478 -364.38011 48.963644 -350.13867 69.720703 C -350.73724 71.647242 -351.3398 73.336007 -351.86523 74.972656 C -359.84741 98.392537 -360.15234 99.183594 -360.15234 99.183594 C -360.3708 99.819839 -360.52003 100.46344 -360.60352 101.10547 C -360.68478 101.74776 -360.70475 102.38824 -360.66016 103.01953 C -360.61594 103.65071 -360.50784 104.27096 -360.3457 104.875 C -360.18092 105.47833 -359.96268 106.06686 -359.68945 106.62695 C -359.41468 107.18678 -359.08791 107.71951 -358.71094 108.21875 C -358.33374 108.71795 -357.90716 109.18157 -357.43555 109.60352 C -356.49237 110.44745 -355.36685 111.12147 -354.09375 111.55664 L -332.71484 118.86133 L -329.4043 119.99219 C -321.7413 158.25446 -331.4896 197.94328 -356.00781 228.30078 C -356.01537 228.30006 -356.02174 228.29819 -356.0293 228.29883 C -364.89131 227.32171 -370.67949 226.52992 -374.28516 225.97656 C -374.39174 225.95766 -374.46518 225.94934 -374.56836 225.92969 C -377.87265 225.4148 -379.35742 225.09961 -379.35742 225.09961 C -380.02402 225.0089 -380.68217 224.98816 -381.32812 225.03125 C -381.97401 225.07585 -382.60805 225.18211 -383.21875 225.34766 C -383.82922 225.51433 -384.41801 225.73779 -384.97852 226.01562 C -385.5369 226.29153 -386.06645 226.62236 -386.56055 226.99805 C -386.56811 227.00183 -386.57435 227.00403 -386.57812 227.00781 C -387.07045 227.38388 -387.52774 227.80586 -387.94141 228.26953 C -388.35787 228.73642 -388.73045 229.24639 -389.05273 229.79102 C -389.37173 230.33017 -389.63919 230.90534 -389.85156 231.50977 C -389.85394 231.5211 -389.86341 231.53598 -389.86719 231.54883 C -390.07695 232.1542 -390.23176 232.78973 -390.32031 233.44922 L -393.33008 255.8418 L -393.92969 260.3125 C -402.58171 265.17173 -411.75731 269.03532 -421.2793 271.82812 C -436.98213 276.40529 -453.29862 277.95544 -469.39844 276.55664 L -459.34766 236.11523 C -420.81685 243.40693 -391.84223 240.46475 -379.64648 205.61523 C -369.81907 177.55538 -380.13561 161.36905 -400.4082 150.81445 C -385.64461 147.40997 -374.52361 137.69889 -371.55664 117.63867 L -371.55859 117.63867 C -367.45902 90.235283 -388.32383 75.505073 -416.85352 65.677734 L -406.54883 24.558594 z M -463.39648 81.496094 C -450.64088 84.675357 -409.56013 90.609682 -416.19531 117.23438 C -422.56669 142.75847 -461.88889 129.79059 -474.64453 126.61133 L -463.39648 81.496094 z M -334.10938 83.923828 C -333.02116 83.940893 -331.87175 84.121479 -330.66797 84.494141 C -325.03821 86.378386 -322.05358 92.4349 -324.00586 98.013672 C -325.95137 103.59834 -332.09203 106.60012 -337.72852 104.72461 C -348.54382 100.819 -345.88032 86.916561 -337.17773 84.335938 C -336.22471 84.053002 -335.19759 83.906764 -334.10938 83.923828 z M -589.05664 106.63281 C -585.74873 106.69325 -582.52346 108.24946 -580.47852 111.11914 C -572.69719 122.6549 -589.86711 134.62812 -598.18555 123.4668 C -601.59661 118.66196 -600.39895 112.00329 -595.51172 108.60156 C -594.5194 107.90878 -593.45277 107.40369 -592.35156 107.07812 C -591.27153 106.75899 -590.15928 106.61267 -589.05664 106.63281 z M -480.32227 149.38086 C -465.0052 153.20366 -415.88743 160.77182 -423.18555 190.03516 C -430.16826 218.09497 -477.41337 202.92654 -492.73047 199.12305 L -480.32227 149.38086 z M -500.07227 226.3125 C -493.90684 227.98581 -487.92098 229.52986 -482.06445 230.98438 L -492.24414 272.5293 C -495.76747 271.57851 -499.26123 270.48908 -502.71289 269.24023 C -502.71353 269.23732 -502.7171 269.2323 -502.7168 269.22852 C -502.78823 268.91406 -502.87017 268.59336 -502.9707 268.26367 L -507.18164 254.58008 L -500.07227 226.3125 z M -369.5918 238.05469 C -363.93107 238.29209 -358.43252 242.50104 -359.28711 249.87695 C -360.10103 255.71784 -365.54964 259.83292 -371.44922 259.0625 C -377.35329 258.29972 -381.48367 252.94709 -380.67969 247.10156 C -379.90564 242.37538 -376.946 239.59127 -373.46094 238.53516 C -372.21344 238.15711 -370.89812 237.9999 -369.5918 238.05469 z M -528.67188 251.8457 C -517.75398 252.073 -513.88775 268.68551 -525.99609 272.71875 C -531.69419 274.47472 -537.71712 271.3377 -539.44531 265.71289 C -541.18246 260.08718 -537.97559 254.10095 -532.27734 252.33398 C -531.00688 251.97472 -529.80131 251.82219 -528.67188 251.8457 z "
-       transform="matrix(0.26458333,0,0,0.26458333,-73.402031,-228.93883)"
-       inkscape:export-filename="/home/hunter/Pictures/omoc graphics/rust-bitcoin-5.png"
-       inkscape:export-xdpi="80.031731"
-       inkscape:export-ydpi="80.031731" />
-    <rect
-       style="fill:#729fcf;fill-opacity:1;stroke-width:0.264583"
-       id="rect20060"
-       width="9.8467264"
-       height="44.83942"
-       x="-308.26736"
-       y="-127.99509"
-       transform="rotate(13.99185)" />
-    <path
-       id="path2280-6"
-       clip-path="none"
-       style="fill:#f7931a;fill-opacity:1;stroke-width:0.913143"
-       d="m -282.61236,-109.62932 c -0.43378,0.12699 -0.80643,0.46361 -0.94299,0.95773 l -1.25646,4.54948 c -0.36611,0.14054 -0.72986,0.28796 -1.09026,0.43816 l -4.057,-2.40862 c -0.88238,-0.52564 -2.00984,0.0634 -2.08186,1.08817 l -0.34232,4.6943 c -0.33555,0.21239 -0.66631,0.42998 -0.9949,0.64985 l -4.43896,-1.56505 c -0.96711,-0.33872 -1.9545,0.45462 -1.83114,1.47189 l 0.57911,4.67441 c -0.28549,0.27292 -0.56556,0.54985 -0.84409,0.83026 l -4.66284,-0.67083 c -0.4735,-0.0688 -0.94867,0.11292 -1.25502,0.48048 -0.3077,0.36601 -0.40379,0.86711 -0.25207,1.32033 l 1.483,4.48084 c -0.2242,0.3197 -0.44426,0.64392 -0.66002,0.96968 l -4.71316,0.25166 c -0.47779,0.0263 -0.90829,0.29716 -1.13848,0.71668 -0.23035,0.41978 -0.22635,0.92905 0.0104,1.34523 l 2.32939,4.10545 c -0.15782,0.35679 -0.31083,0.71538 -0.45922,1.07619 l -4.57304,1.1681 c -0.99552,0.25237 -1.37663,1.46537 -0.70396,2.24143 l 3.0797,3.56542 c -0.0868,0.38515 -0.16764,0.77097 -0.24342,1.15843 l -4.24802,2.0319 c -0.92523,0.4433 -1.06177,1.70469 -0.25265,2.33548 l 3.71126,2.89215 c -0.009,0.39555 -0.0132,0.79183 -0.0111,1.18893 l -3.76877,2.82098 c -0.824,0.61386 -0.71113,1.88076 0.2086,2.3394 l 4.21412,2.11764 c 0.0679,0.38453 0.14074,0.76998 0.21868,1.15344 l -3.15261,3.51128 c -0.68743,0.76242 -0.33107,1.98118 0.65945,2.2526 l 4.54848,1.25677 c 0.1413,0.36586 0.28781,0.72935 0.43803,1.08974 l -2.40666,4.05643 c -0.52343,0.8819 0.0633,2.00678 1.08604,2.08195 l 4.69493,0.34267 c 0.2124,0.33554 0.42976,0.66691 0.65051,0.99524 l -1.56518,4.43847 c -0.34274,0.96787 0.45372,1.95749 1.47246,1.82934 l 4.67248,-0.58011 c 0.27341,0.28721 0.54904,0.56794 0.83033,0.84621 l -0.67112,4.66186 c -0.0685,0.47377 0.11333,0.94922 0.48079,1.256 0.36799,0.30807 0.86961,0.404 1.32081,0.25193 l 4.47856,-1.48341 c 0.32194,0.22544 0.64393,0.44428 0.96969,0.66003 l 0.25261,4.7145 c 0.0263,0.47771 0.29482,0.9063 0.71595,1.136 0.41909,0.23221 0.92792,0.22484 1.34495,-0.0114 l 4.10495,-2.32925 c 0.3579,0.15972 0.71739,0.31172 1.07833,0.45913 l 1.16788,4.57419 c 0.25216,0.99513 1.46463,1.37586 2.24017,0.70324 l 3.56505,-3.07904 c 0.38515,0.0871 0.77013,0.16837 1.15857,0.24397 l 2.03232,4.24573 c 0.44388,0.92424 1.70426,1.06161 2.33658,0.25448 l 2.89205,-3.71338 c 0.39629,0.01 0.79279,0.0134 1.1892,0.0121 l 2.81991,3.76692 c 0.2861,0.38247 0.75035,0.59142 1.22733,0.54693 0.47663,-0.0411 0.89824,-0.32694 1.11161,-0.75512 l 2.11765,-4.21411 c 0.38501,-0.0661 0.77079,-0.14011 1.15563,-0.21664 l 3.51143,3.15311 c 0.76326,0.68374 1.97857,0.32799 2.25259,-0.65946 l 1.25662,-4.54897 c 0.36488,-0.1421 0.72801,-0.28888 1.08904,-0.4405 l 4.05544,2.40692 c 0.41137,0.24495 0.92042,0.25918 1.34333,0.0365 0.42464,-0.22057 0.70421,-0.64518 0.73861,-1.12246 l 0.34323,-4.69296 c 0.33457,-0.21268 0.6664,-0.42965 0.99495,-0.65149 l 4.43905,1.56718 c 0.96778,0.34022 1.95588,-0.4561 1.82942,-1.4741 l -0.57825,-4.67142 c 0.28548,-0.27291 0.56506,-0.5516 0.84409,-0.83024 l 4.66271,0.67031 c 1.01583,0.1482 1.83151,-0.82628 1.50723,-1.8003 l -1.48329,-4.48183 c 0.2242,-0.31969 0.4451,-0.64064 0.65947,-0.9679 l 4.71301,-0.25216 c 0.47805,-0.0243 0.90912,-0.29491 1.13779,-0.7154 0.23082,-0.42056 0.22628,-0.92658 -0.01,-1.34275 l -2.32968,-4.10644 c 0.15799,-0.35737 0.31224,-0.71562 0.45914,-1.07832 l 4.57348,-1.16661 c 0.464,-0.11719 0.83373,-0.46736 0.97592,-0.9243 0.14406,-0.457 0.0409,-0.95485 -0.27346,-1.3167 l -3.07825,-3.56421 c 0.0859,-0.38577 0.16791,-0.7712 0.24239,-1.16027 l 4.24815,-2.03142 c 0.92648,-0.44192 1.06337,-1.7045 0.25295,-2.33447 l -3.7117,-2.89364 c 0.008,-0.39528 0.0123,-0.79156 0.0111,-1.18892 l 3.76793,-2.8202 c 0.3831,-0.28723 0.59125,-0.75085 0.54676,-1.22781 -0.0411,-0.47665 -0.32679,-0.89776 -0.75498,-1.11113 l -4.21325,-2.11843 c -0.0688,-0.38425 -0.14176,-0.77021 -0.21883,-1.15392 l 3.15262,-3.51128 c 0.68763,-0.76222 0.33159,-1.98127 -0.65851,-2.25287 l -4.54847,-1.25678 c -0.14211,-0.36477 -0.28794,-0.72763 -0.43788,-1.08924 l 2.40579,-4.05565 c 0.24468,-0.41227 0.25904,-0.92094 0.0362,-1.34382 -0.22025,-0.42492 -0.64554,-0.70442 -1.12294,-0.73847 l -4.69359,-0.34361 c -0.21314,-0.33416 -0.42969,-0.6661 -0.6505,-0.99524 l 1.56561,-4.43698 c 0.34245,-0.96776 -0.45357,-1.95732 -1.47224,-1.83049 l -4.67312,0.57977 c -0.27227,-0.28571 -0.5485,-0.56702 -0.82927,-0.84436 l 0.6702,-4.66324 c 0.0695,-0.47374 -0.11266,-0.95001 -0.48043,-1.25662 -0.3661,-0.30828 -0.86627,-0.40339 -1.32018,-0.25155 l -4.48101,1.48252 c -0.31957,-0.22448 -0.64263,-0.44373 -0.96909,-0.65804 l -0.25089,-4.71396 c -0.0535,-1.02556 -1.16809,-1.63579 -2.06091,-1.12832 l -4.10481,2.32975 c -0.35728,-0.15883 -0.71694,-0.31241 -1.07877,-0.46064 l -1.1666,-4.57347 c -0.2516,-0.99571 -1.46448,-1.37666 -2.2403,-0.70374 l -3.56492,3.07953 c -0.38536,-0.0858 -0.77128,-0.16728 -1.15857,-0.24395 l -2.0332,-4.24873 c -0.44336,-0.9244 -1.70388,-1.06039 -2.33481,-0.25229 l -2.89516,3.71214 c -0.39556,-0.009 -0.79162,-0.0129 -1.18728,-0.011 l -2.82035,-3.76842 c -0.61269,-0.82509 -1.88065,-0.71335 -2.33948,0.20664 l -2.11656,4.21595 c -0.3845,0.0679 -0.77073,0.14 -1.15391,0.21884 l -3.51159,-3.15361 c -0.38149,-0.34247 -0.87585,-0.42528 -1.30962,-0.29823 z m 9.36046,7.12899 c 0.89969,-0.27474 1.91443,-0.10504 2.68104,0.53914 1.19879,1.00465 1.34163,2.78515 0.31909,3.97944 -2.48503,2.7581 -6.69455,-0.7739 -4.34124,-3.64245 0.36803,-0.42833 0.8364,-0.72205 1.34111,-0.87616 z m -5.70063,5.3853 4.9e-4,-1.5e-4 c 0.18646,-0.0535 0.37345,-0.10515 0.56098,-0.15485 0.002,0.003 0.007,0.006 0.009,0.009 1.51671,1.24163 2.64551,2.20624 3.39645,2.86156 0.002,0.002 0.007,0.006 0.007,0.008 0.006,0.007 0.0124,0.0108 0.0188,0.0166 0.72789,0.63596 1.10532,0.98538 1.10532,0.98538 0.13419,0.11427 0.27695,0.21226 0.42541,0.29439 9.1e-4,6.3e-4 0.003,0.002 0.004,0.003 9.1e-4,6.2e-4 0.003,0.002 0.003,0.002 0.14886,0.0816 0.30318,0.14727 0.46154,0.1971 0.15971,0.0503 0.32326,0.0845 0.48775,0.10275 0.16221,0.018 0.32524,0.0203 0.48737,0.008 0.005,-4.3e-4 0.009,-5.5e-4 0.0142,-10e-4 0.16193,-0.0135 0.32293,-0.0419 0.48001,-0.0856 0.15923,-0.0445 0.31493,-0.10437 0.46434,-0.17959 l 5e-4,-1.5e-4 c 0.14943,-0.0752 0.29249,-0.16597 0.4272,-0.27153 l 5.1e-4,-1.4e-4 c 0.13484,-0.10566 0.26072,-0.22638 0.37591,-0.36205 l 3.86895,-4.55721 0.12057,-0.1419 c 10.37273,0.88739 19.73555,5.9101 25.62531,14.49449 -0.15837,0.50973 -0.3179,0.9564 -0.45692,1.38943 -2.11195,6.19651 -2.19263,6.40605 -2.19263,6.40605 -0.0578,0.16834 -0.0973,0.33836 -0.11939,0.50823 -0.0215,0.16994 -0.0265,0.33969 -0.0147,0.50672 0.0117,0.167 0.04,0.33122 0.0829,0.49104 0.0436,0.15963 0.10157,0.31512 0.17386,0.46331 0.0727,0.14812 0.15926,0.28909 0.259,0.42118 0.0998,0.13208 0.21244,0.25485 0.33722,0.36649 0.24955,0.22329 0.54721,0.40142 0.88405,0.51656 l 5.6569,1.93273 0.87591,0.29926 c 2.0275,10.12356 -0.55187,20.62445 -7.03898,28.65654 -0.002,-1.9e-4 -0.004,-6.3e-4 -0.006,-4.6e-4 -2.34474,-0.25853 -3.87595,-0.46796 -4.82995,-0.61437 -0.0282,-0.005 -0.0475,-0.007 -0.0748,-0.0122 -0.87426,-0.13623 -1.26722,-0.2197 -1.26722,-0.2197 -0.17637,-0.024 -0.35073,-0.0294 -0.52164,-0.018 -0.17089,0.0118 -0.33846,0.0396 -0.50004,0.0834 -0.16152,0.0441 -0.3174,0.10325 -0.4657,0.17676 -0.14774,0.073 -0.28755,0.16035 -0.41828,0.25975 -0.002,10e-4 -0.004,0.002 -0.005,0.003 -0.13026,0.0995 -0.25105,0.21117 -0.3605,0.33385 -0.11019,0.12353 -0.20892,0.25809 -0.29419,0.40219 -0.0844,0.14265 -0.15522,0.29504 -0.21141,0.45496 -6.3e-4,0.003 -0.003,0.007 -0.004,0.0104 -0.0555,0.16017 -0.0965,0.32802 -0.11993,0.50251 l -0.79614,5.92507 -0.15887,1.18262 c -2.28918,1.28567 -4.71667,2.30775 -7.23603,3.04668 -7.07309,2.06171 -14.61843,1.82199 -21.54634,-0.6846 -1.7e-4,-7.7e-4 -6.3e-4,-0.002 -5.5e-4,-0.003 -0.0189,-0.0832 -0.0409,-0.16816 -0.0675,-0.25539 l -1.9914,-6.47131 c -0.0518,-0.17024 -0.12021,-0.33101 -0.20231,-0.48137 -0.0816,-0.14969 -0.17705,-0.28874 -0.28402,-0.41654 -5.7e-4,-6.7e-4 -7.6e-4,-0.002 -0.001,-0.003 -6.4e-4,-8.4e-4 -0.002,-0.002 -0.002,-0.002 -0.10711,-0.12721 -0.22554,-0.24347 -0.35347,-0.34665 -0.12889,-0.10388 -0.26724,-0.19495 -0.413,-0.27218 -0.14574,-0.0772 -0.29861,-0.14052 -0.45694,-0.18876 -0.15833,-0.0482 -0.32201,-0.0812 -0.48859,-0.0982 -0.16657,-0.017 -0.33606,-0.018 -0.50654,-10e-4 -0.17051,0.0169 -0.34198,0.0506 -0.51207,0.10307 l -5.71267,1.76128 -0.17622,0.0547 c -4.93427,-4.33536 -8.53871,-9.98077 -10.39539,-16.28128 -1.00224,-3.46268 -1.45963,-7.06021 -1.35568,-10.66351 0.0103,-0.005 0.005,-0.002 0.0153,-0.009 3.958,-2.34641 4.6296,-2.71162 5.75795,-3.37047 0.14244,-0.0832 0.27495,-0.18148 0.39639,-0.29212 0.24283,-0.22143 0.44108,-0.49245 0.58607,-0.79189 0.0726,-0.14972 0.13185,-0.30667 0.17646,-0.46786 0.0447,-0.16121 0.0746,-0.32668 0.0894,-0.49393 0.0142,-0.16733 0.0132,-0.3361 -0.005,-0.50418 -0.0182,-0.16811 -0.0528,-0.33541 -0.10572,-0.49892 -0.053,-0.16346 -0.12393,-0.32333 -0.2139,-0.4769 l -3.02296,-5.15742 -0.69604,-1.18759 c 4.15048,-9.31146 12.1806,-16.33056 21.96355,-19.19826 z m -25.74083,23.1121 c 1.14303,-0.33775 2.42014,0.057 3.14155,1.06936 2.05881,3.05217 -2.48407,6.22 -4.68499,3.2669 -0.90251,-1.27128 -0.58578,-3.03311 0.7073,-3.93315 0.26255,-0.1833 0.54478,-0.31696 0.83614,-0.4031 z m 67.5149,-6.01692 c 0.50431,-0.14972 1.08535,-0.1554 1.72235,0.0418 1.48954,0.49854 2.27925,2.10071 1.76271,3.57676 -0.51475,1.47761 -2.13972,2.27213 -3.63104,1.7759 -2.86155,-1.03336 -2.15658,-4.71164 0.14598,-5.39443 z m -51.62015,44.44909 c 3.58552,-1.01393 5.19711,4.21636 1.66203,5.39388 -1.50762,0.4646 -3.10138,-0.36575 -3.55863,-1.85398 -0.45962,-1.48847 0.38896,-3.07239 1.89662,-3.5399 z m 42.01994,-3.65068 c 1.76036,-0.53346 4.02838,0.59896 3.75009,3.00086 -0.21535,1.5454 -1.6567,2.6341 -3.21763,2.43026 -1.56212,-0.20182 -2.65491,-1.61797 -2.44219,-3.1646 0.2048,-1.25047 0.98764,-1.98709 1.90973,-2.26652 z" />
-    <path
-       fill="#ffffff"
-       d="m -246.27505,-71.20849 c 1.08468,-7.25048 -4.43576,-11.14817 -11.98424,-13.74832 l 3.84651,-15.3486 -6.0236,-1.48989 -3.73669,15.08972 c -1.57166,-0.39164 -3.1859,-0.76115 -4.78995,-1.12724 l 2.70316,-10.83589 -7.55662,4.68948 -1.171,4.84889 c -1.30093,-0.29629 -2.57802,-0.58917 -3.81766,-0.89738 l 0.007,-0.0307 -8.2449,-2.05867 -1.5904,6.38546 c 0,0 4.43576,1.01656 4.34211,1.07957 2.42136,0.60449 2.85898,2.20681 2.78577,3.47709 l -2.78918,11.18902 c 0.16688,0.0426 0.38312,0.10391 0.62152,0.19924 -0.19923,-0.0494 -0.41208,-0.10392 -0.63173,-0.15667 l -3.9096,15.67417 c -0.29629,0.73562 -1.04724,1.83902 -2.7398,1.42014 0.0596,0.0868 -4.34551,-1.08468 -4.34551,-1.08468 l -2.96797,6.84351 7.78004,1.93948 c 1.44737,0.36268 2.86581,0.74241 4.26209,1.1 l -1.33648,5.41258 5.14426,4.69127 2.14006,-8.50834 c 1.63127,0.44273 3.21487,0.85139 4.76441,1.23623 l -3.73248,15.23327 5.9021,1.57948 3.84122,-15.45563 c 10.19461,1.92926 17.86055,1.15109 21.08734,-8.06951 2.60017,-7.42417 -0.12941,-11.70669 -5.4932,-14.49926 3.9062,-0.90077 6.8486,-3.47028 7.63361,-8.77788 z m -13.65978,19.15467 c -1.84751,7.42416 -14.34769,3.41068 -18.40034,2.40434 l 3.28299,-13.16085 c 4.05264,1.01145 17.04831,3.01392 15.11735,10.75651 z m 1.84924,-19.26194 c -1.68576,6.75325 -12.0898,3.32213 -15.46473,2.48095 l 2.97647,-11.93655 c 3.37492,0.84118 14.24382,2.41115 12.48826,9.4556 z"
-       id="path2282-2"
-       style="display:block;stroke-width:1.7028"
-       sodipodi:nodetypes="ccccccccccccccccccccccccccccccccccccccccccc" />
-  </g>
-</svg>
diff --git a/logo/rust-bitcoin-large.png b/logo/rust-bitcoin-large.png
deleted file mode 100644
index f0cce3403f6f875654702fcae1df75212403fa21..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 87059
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

diff --git a/logo/rust-bitcoin-optimized.svg b/logo/rust-bitcoin-optimized.svg
deleted file mode 100644
index 31cf374ba..000000000
--- a/logo/rust-bitcoin-optimized.svg
+++ /dev/null
@@ -1 +0,0 @@
-<svg width="359.854" height="359.857" viewBox="0 0 95.211 95.212" xmlns="http://www.w3.org/2000/svg"><path d="m330.353 103.349-3.434-3.209c.043-.387.082-.775.117-1.164l3.995-2.468a1.37 1.37 0 0 0 .653-1.169 1.37 1.37 0 0 0-.65-1.17l-3.983-2.47a51.065 51.065 0 0 0-.115-1.178l3.43-3.193a1.375 1.375 0 0 0-.454-2.295l-4.392-1.646a39.007 39.007 0 0 0-.342-1.128l2.744-3.806c.28-.386.34-.89.157-1.33a1.368 1.368 0 0 0-1.049-.832l-4.639-.76a37.132 37.132 0 0 0-.551-1.028l1.955-4.276a1.375 1.375 0 0 0-1.298-1.947l-4.698.16a39.484 39.484 0 0 0-.74-.904l1.083-4.574a1.373 1.373 0 0 0-1.652-1.656l-4.568 1.072c-.3-.254-.603-.504-.91-.75l.167-4.688a1.376 1.376 0 0 0-1.943-1.301l-4.269 1.94c-.345-.191-.692-.377-1.042-.558l-.75-4.628a1.372 1.372 0 0 0-2.159-.898l-3.814 2.743c-.37-.118-.745-.232-1.12-.34l-1.642-4.404a1.375 1.375 0 0 0-2.293-.458l-3.209 3.435a41.082 41.082 0 0 0-1.164-.117l-2.469-3.998a1.373 1.373 0 0 0-2.338 0l-2.47 3.983a46.61 46.61 0 0 0-1.178.115l-3.195-3.431a1.378 1.378 0 0 0-2.295.454l-1.647 4.392c-.378.11-.753.224-1.129.343l-3.804-2.745a1.37 1.37 0 0 0-1.33-.155 1.37 1.37 0 0 0-.832 1.049l-.76 4.639c-.345.178-.689.363-1.03.55l-4.275-1.953a1.38 1.38 0 0 0-1.336.107 1.373 1.373 0 0 0-.611 1.191l.16 4.699c-.304.242-.605.488-.903.738l-4.575-1.081a1.374 1.374 0 0 0-1.655 1.653l1.072 4.568c-.255.3-.505.603-.75.91l-4.687-.168a1.376 1.376 0 0 0-1.301 1.944l1.94 4.266c-.19.345-.378.692-.56 1.044l-4.627.75a1.373 1.373 0 0 0-.896 2.16l2.74 3.814c-.117.37-.23.745-.339 1.12l-4.403 1.642a1.373 1.373 0 0 0-.458 2.293l3.434 3.208c-.045.388-.083.777-.117 1.164l-3.996 2.469c-.87.536-.87 1.8-.003 2.338l3.984 2.47c.032.394.072.787.115 1.179l-3.43 3.193a1.374 1.374 0 0 0 .455 2.295l4.39 1.645c.11.38.223.755.343 1.13l-2.744 3.804c-.28.387-.339.89-.156 1.33.183.442.58.758 1.049.832l4.637.76c.18.347.363.688.551 1.03l-1.953 4.277c-.198.433-.159.935.107 1.332a1.37 1.37 0 0 0 1.192.611l4.698-.16c.242.306.489.606.74.903l-1.082 4.576a1.373 1.373 0 0 0 1.652 1.654l4.568-1.071c.3.254.602.504.91.75l-.167 4.686a1.378 1.378 0 0 0 1.944 1.302l4.267-1.941c.345.191.693.378 1.043.56l.75 4.625c.076.47.39.869.83 1.05.44.184.944.126 1.33-.154l3.815-2.74c.37.12.744.232 1.12.342l1.642 4.403a1.376 1.376 0 0 0 2.293.458l3.209-3.433c.387.043.775.08 1.164.114l2.468 3.995a1.372 1.372 0 0 0 2.338.003l2.47-3.982c.393-.033.786-.072 1.178-.116l3.194 3.432c.697.747 1.936.501 2.295-.456l1.646-4.39c.378-.108.754-.225 1.129-.342l3.805 2.744c.828.6 1.997.117 2.16-.893l.761-4.64c.346-.178.689-.36 1.029-.549l4.275 1.953c.433.2.939.16 1.335-.106.398-.264.627-.713.611-1.19l-.16-4.699c.305-.242.606-.487.903-.74l4.575 1.083c.463.11.95-.028 1.287-.365a1.37 1.37 0 0 0 .367-1.288l-1.071-4.567c.254-.3.504-.603.75-.912l4.686.169a1.374 1.374 0 0 0 1.301-1.944l-1.94-4.267c.19-.345.377-.692.56-1.043l4.626-.75a1.37 1.37 0 0 0 1.05-.83c.184-.44.126-.944-.154-1.33l-2.74-3.814c.117-.371.231-.746.34-1.12l4.403-1.642a1.373 1.373 0 0 0 .46-2.293zm-32.722 27.266a2.832 2.832 0 0 1-1.467-3.724 2.823 2.823 0 0 1 3.715-1.473 2.83 2.83 0 0 1-2.248 5.197zm9.981-9.916a34.92 34.92 0 0 1-3.901 3.076l-5.612-2.431a2.576 2.576 0 0 0-3.39 1.344l-2.688 6.215a34.653 34.653 0 0 1-14.687.217 34.686 34.686 0 0 1-13.743-6.04l-.093-6.77a2.575 2.575 0 0 0-2.612-2.543l-5.978.086a34.68 34.68 0 0 1-2.265-4.086m5.112 12.74a2.826 2.826 0 0 1-2.866-2.789 2.833 2.833 0 0 1 2.787-2.873c3.689.034 3.766 5.524.08 5.661zm-2.007-45.014a2.832 2.832 0 0 1-2.142 3.38 2.825 2.825 0 0 1-3.375-2.143 2.832 2.832 0 0 1 2.142-3.38 2.825 2.825 0 0 1 3.375 2.143zm-4.792 7.058 6.5-1.46a2.58 2.58 0 0 0 1.953-3.082l-.674-3.027c5.751-2.852 28.852 11.5-9.277 20.816a34.838 34.838 0 0 1 .57-9.62 35.23 35.23 0 0 1 .928-3.627zm12.325-17.399s13.435-7.05 21.244-6.96l3.374 5.331a2.574 2.574 0 0 0 3.556.796l5.688-3.614c9.634 3.863 16.862 11.785 20.037 21.306l-4.745 6.731a2.584 2.584 0 0 0 .619 3.596l5.736 4.053a36.116 36.116 0 0 1-1.112 5.939m-28.122-47.093a2.824 2.824 0 0 1 3.9.873 2.833 2.833 0 0 1-.875 3.906 2.822 2.822 0 0 1-3.9-.874 2.834 2.834 0 0 1 .875-3.905zm27.227 32.591a2.824 2.824 0 0 1 3.938-.68 2.832 2.832 0 0 1 .678 3.944 2.824 2.824 0 0 1-3.94.681 2.835 2.835 0 0 1-.676-3.945z" style="fill:#fff;fill-opacity:1;stroke-width:.909418" transform="translate(201.733 209.108)"/><path style="fill:#f7931a;fill-opacity:1;stroke-width:.913143" d="M-158.176-209.107a1.371 1.371 0 0 0-1.282.763l-2.116 4.215c-.385.068-.77.14-1.154.219l-3.512-3.153a1.368 1.368 0 0 0-1.31-.299 1.37 1.37 0 0 0-.942.957l-1.257 4.55c-.366.14-.73.288-1.09.438l-4.057-2.409a1.38 1.38 0 0 0-2.082 1.088l-.342 4.695c-.336.212-.667.43-.995.65l-4.44-1.565a1.383 1.383 0 0 0-1.83 1.471l.58 4.675c-.286.273-.567.55-.845.83l-4.663-.67a1.376 1.376 0 0 0-1.255.48 1.375 1.375 0 0 0-.252 1.32l1.483 4.48c-.225.32-.444.645-.66.97l-4.713.253a1.385 1.385 0 0 0-1.139.716c-.23.42-.226.93.01 1.345l2.33 4.106c-.158.356-.31.715-.46 1.076l-4.572 1.168a1.38 1.38 0 0 0-.704 2.242l3.08 3.565c-.087.385-.168.77-.244 1.158l-4.248 2.032a1.381 1.381 0 0 0-.253 2.336l3.712 2.892c-.01.395-.013.792-.011 1.189l-3.77 2.821a1.379 1.379 0 0 0 .21 2.34l4.213 2.117c.068.384.141.77.219 1.153l-3.153 3.511a1.378 1.378 0 0 0 .66 2.253l4.548 1.257c.141.366.288.73.438 1.09l-2.406 4.056a1.381 1.381 0 0 0 1.086 2.082l4.695.343c.212.335.43.667.65.995l-1.565 4.439a1.38 1.38 0 0 0 1.472 1.829l4.673-.58c.273.287.55.567.83.846l-.67 4.662c-.07.474.112.949.48 1.256.368.308.87.404 1.32.252l4.48-1.484c.321.226.643.444.969.66l.253 4.715c.026.478.295.906.716 1.136.419.232.927.225 1.344-.012l4.106-2.33c.358.16.717.313 1.078.46l1.168 4.574a1.38 1.38 0 0 0 2.24.703l3.565-3.078c.385.087.77.168 1.158.243l2.033 4.246a1.384 1.384 0 0 0 2.337.255l2.891-3.714c.397.01.793.014 1.19.012l2.82 3.768c.286.382.75.59 1.227.546a1.373 1.373 0 0 0 1.111-.755l2.118-4.214c.385-.066.771-.14 1.156-.216l3.511 3.152a1.381 1.381 0 0 0 2.253-.659l1.256-4.55c.365-.141.729-.288 1.09-.44l4.055 2.408c.411.245.92.259 1.343.036.425-.22.704-.645.739-1.122l.343-4.693c.334-.213.667-.43.995-.652l4.44 1.567a1.382 1.382 0 0 0 1.829-1.474l-.579-4.671c.286-.273.565-.552.844-.83l4.663.67a1.38 1.38 0 0 0 1.507-1.8l-1.483-4.482c.224-.32.445-.641.66-.968l4.712-.252c.479-.025.91-.295 1.138-.716.231-.42.226-.926-.01-1.342l-2.33-4.107c.159-.357.313-.716.46-1.078l4.573-1.167c.464-.117.834-.467.976-.924a1.375 1.375 0 0 0-.273-1.317l-3.078-3.564c.086-.386.168-.771.242-1.16l4.248-2.032a1.38 1.38 0 0 0 .253-2.334l-3.712-2.894c.008-.395.013-.791.012-1.189l3.767-2.82c.383-.287.592-.75.547-1.228a1.373 1.373 0 0 0-.755-1.11l-4.213-2.12c-.069-.384-.142-.77-.219-1.153l3.153-3.512a1.378 1.378 0 0 0-.659-2.252l-4.548-1.257a54.531 54.531 0 0 0-.438-1.09l2.405-4.055c.245-.412.26-.921.037-1.344a1.375 1.375 0 0 0-1.123-.739l-4.694-.343a51.33 51.33 0 0 0-.65-.995l1.565-4.437a1.38 1.38 0 0 0-1.472-1.83l-4.673.579a39.1 39.1 0 0 0-.83-.844l.671-4.664c.07-.473-.113-.95-.48-1.256a1.373 1.373 0 0 0-1.32-.252l-4.482 1.483c-.32-.224-.642-.444-.969-.658l-.25-4.714a1.38 1.38 0 0 0-2.062-1.128l-4.104 2.33a39.772 39.772 0 0 0-1.08-.461l-1.166-4.574a1.38 1.38 0 0 0-2.24-.703l-3.565 3.079a50.075 50.075 0 0 0-1.158-.244l-2.034-4.249a1.382 1.382 0 0 0-2.335-.252l-2.895 3.712a43.13 43.13 0 0 0-1.187-.01l-2.82-3.77a1.363 1.363 0 0 0-1.058-.555zm.678 8.751c.7-.038 1.415.179 1.99.662a2.801 2.801 0 0 1 .32 3.98c-2.486 2.757-6.695-.775-4.342-3.643a2.866 2.866 0 0 1 2.032-.999zm6.328 4.241c1.619.139 3.214.378 4.774.716l-2.714 10.96a250.01 250.01 0 0 0-4.79-1.127l2.59-10.384.02-.023zm-12.158 1.112.009.009a142.161 142.161 0 0 1 3.396 2.861c.002.002.007.006.007.008.006.007.012.011.019.017.67.586.965.858 1.019.908l-1.047 4.336c-1.301-.296-2.578-.589-3.818-.897l.007-.03-8.245-2.06-1.59 6.386s4.436 1.017 4.342 1.08c2.422.604 2.86 2.207 2.786 3.477l-2.789 11.189c.167.042.383.104.621.2-.199-.05-.412-.105-.631-.158l-3.91 15.675c-.296.735-1.047 1.839-2.74 1.42.06.087-4.345-1.085-4.345-1.085l-2.968 6.844 7.78 1.939c1.447.363 2.866.743 4.262 1.1l-1.205 4.879-4.538 1.4-.176.054a34.75 34.75 0 0 1-10.396-16.282 34.75 34.75 0 0 1-1.355-10.663l.015-.009c3.958-2.346 4.63-2.711 5.758-3.37.142-.083.275-.182.396-.293a2.61 2.61 0 0 0 .586-.791 2.765 2.765 0 0 0 .266-.962 2.592 2.592 0 0 0-.11-1.003 2.418 2.418 0 0 0-.215-.477l-3.023-5.158-.695-1.187a34.748 34.748 0 0 1 21.963-19.199l.002-.004c.187-.053.374-.105.561-.155zm22.858 1.434c5.966 2.426 11.157 6.457 14.925 11.949-.158.51-.318.957-.457 1.39-2.112 6.196-2.192 6.405-2.192 6.405a2.595 2.595 0 0 0-.135 1.015 2.592 2.592 0 0 0 .853 1.742c.25.224.548.402.885.517l5.656 1.933.876.299a34.748 34.748 0 0 1-7.039 28.657h-.006a117.303 117.303 0 0 1-4.83-.615c-.028-.005-.048-.007-.075-.013-.874-.136-1.267-.22-1.267-.22a2.585 2.585 0 0 0-1.487.243c-.148.073-.288.16-.419.26-.002 0-.004.002-.005.003a2.59 2.59 0 0 0-.655.736 2.557 2.557 0 0 0-.21.455l-.005.01c-.055.16-.096.329-.12.503l-.796 5.925-.159 1.183a34.75 34.75 0 0 1-7.236 3.047 34.74 34.74 0 0 1-12.732 1.25l2.66-10.7c10.194 1.93 17.86 1.151 21.087-8.07 2.6-7.423-.13-11.706-5.493-14.499 3.906-.9 6.849-3.47 7.634-8.777 1.084-7.25-4.437-11.148-11.985-13.748zm-15.041 15.065c3.375.84 14.244 2.41 12.489 9.455-1.686 6.754-12.09 3.322-15.465 2.481zm34.207.642c.288.005.592.052.91.15a2.794 2.794 0 0 1 1.763 3.578 2.885 2.885 0 0 1-3.63 1.775c-2.862-1.033-2.157-4.711.145-5.394.253-.075.524-.114.812-.11zm-67.455 6.008a2.84 2.84 0 0 1 2.27 1.187c2.059 3.052-2.484 6.22-4.685 3.267-.902-1.271-.586-3.033.708-3.933a2.89 2.89 0 0 1 1.707-.52zm28.77 11.31c4.052 1.012 17.048 3.015 15.117 10.757-1.847 7.424-14.348 3.411-18.4 2.405zm-5.226 20.356c1.631.442 3.215.85 4.765 1.236l-2.694 10.992a34.734 34.734 0 0 1-2.77-.87v-.003a3.618 3.618 0 0 0-.068-.256l-1.114-3.62zm34.523 3.106c1.498.063 2.953 1.177 2.727 3.128-.216 1.546-1.657 2.635-3.218 2.43a2.81 2.81 0 0 1-2.443-3.164c.205-1.25.988-1.987 1.91-2.267.33-.1.679-.141 1.024-.127zm-42.09 3.65c2.889.06 3.912 4.455.708 5.522-1.507.464-3.101-.366-3.558-1.854-.46-1.488.389-3.072 1.896-3.54.336-.095.655-.135.954-.129z" transform="translate(201.733 209.108)"/></svg>
\ No newline at end of file
diff --git a/logo/rust-bitcoin.png b/logo/rust-bitcoin.png
deleted file mode 100644
index 0f59dd168e0ce89d0f9cc82dadf0e8ac6c77bc83..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 14406
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
M07*qoM6N<$f_7WJ3jhEB

diff --git a/logo/rust-btc+doge.svg b/logo/rust-btc+doge.svg
new file mode 100644
index 000000000..83e4b1f90
--- /dev/null
+++ b/logo/rust-btc+doge.svg
@@ -0,0 +1,27 @@
+<svg width="360" height="170" viewBox="0 0 360 170" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M177.778 96.4645V72.5582H181.835V96.4645H177.778ZM167.854 86.5398V82.483H191.76V86.5398H167.854Z" fill="url(#paint0_linear_7_13)"/>
+<g clip-path="url(#clip0_7_13)">
+<g clip-path="url(#clip1_7_13)">
+<path d="M267.307 130.999C273.563 130.999 315 132.298 315 84.248C315 35.4718 271.797 39.0241 271.676 39.0342H240.862V79.998H230V90.0331H240.861V124.002L246 130.999H267.307ZM258.217 90.0331H277.343V79.999H258.217V56.0342H270.97C274.248 56.0341 297.869 55.6647 297.832 83.9169C297.795 112.17 274.921 114.001 270.374 114.001H258.217V90.0331Z" fill="#B9A032"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M272 10.0023C272.753 10.0023 273.45 10.3976 273.837 11.043L277.638 17.3767C278.317 17.4325 278.993 17.4977 279.666 17.5734L284.627 12.1061C285.133 11.5486 285.893 11.2966 286.632 11.4434C287.37 11.5902 287.977 12.1145 288.23 12.8231L290.715 19.7595C291.374 19.9483 292.029 20.15 292.679 20.358L298.606 15.9691C299.21 15.5213 300.006 15.4231 300.701 15.711C301.396 15.9989 301.889 16.6311 302 17.3753L303.085 24.6702C303.692 24.9834 304.292 25.3076 304.888 25.6384L311.562 22.4869C312.242 22.1655 313.041 22.2239 313.667 22.6418C314.293 23.0599 314.654 23.7762 314.617 24.5279L314.257 31.9093C314.786 32.331 315.308 32.7614 315.824 33.1984L322.997 31.4057C323.728 31.2232 324.501 31.4371 325.033 31.9693C325.565 32.5016 325.779 33.2745 325.597 34.0048L323.802 41.1769C324.239 41.6929 324.67 42.2146 325.092 42.7436L332.474 42.3851C333.226 42.3486 333.942 42.7093 334.36 43.3351C334.778 43.9609 334.837 44.7599 334.515 45.4403L331.362 52.113C331.693 52.7088 332.017 53.3089 332.331 53.9155L339.627 55.0023C340.371 55.1132 341.003 55.6059 341.291 56.3011C341.579 56.9963 341.481 57.7918 341.033 58.3965L336.643 64.3215C336.851 64.9724 337.053 65.6265 337.241 66.2857L344.179 68.7718C344.888 69.0257 345.412 69.6323 345.559 70.3706C345.706 71.1088 345.454 71.8696 344.896 72.3753L339.427 77.3349C339.503 78.0081 339.568 78.6843 339.624 79.3633L345.959 83.1649C346.605 83.5522 347 84.2496 347 85.0023C347 85.755 346.605 86.4523 345.959 86.8396L339.624 90.6398C339.568 91.3189 339.503 91.9951 339.427 92.6683L344.896 97.6292C345.454 98.1349 345.706 98.8957 345.559 99.634C345.412 100.372 344.888 100.979 344.179 101.233L337.241 103.717C337.053 104.377 336.851 105.031 336.643 105.682L341.033 111.608C341.481 112.213 341.579 113.008 341.291 113.703C341.003 114.399 340.371 114.891 339.627 115.002L332.331 116.088C332.017 116.694 331.693 117.294 331.362 117.89L334.515 124.564C334.837 125.245 334.778 126.044 334.36 126.669C333.942 127.295 333.226 127.656 332.474 127.619L325.092 127.26C324.67 127.789 324.239 128.31 323.802 128.826L325.597 136C325.779 136.73 325.565 137.503 325.033 138.035C324.501 138.567 323.728 138.781 322.997 138.599L315.824 136.805C315.308 137.242 314.786 137.672 314.257 138.094L314.617 145.477C314.654 146.228 314.293 146.945 313.667 147.363C313.041 147.781 312.242 147.839 311.562 147.518L304.888 144.365C304.292 144.696 303.692 145.02 303.085 145.333L302 152.629C301.889 153.373 301.396 154.006 300.701 154.294C300.006 154.581 299.21 154.483 298.606 154.035L292.679 149.645C292.029 149.853 291.374 150.055 290.715 150.244L288.23 157.181C287.977 157.89 287.37 158.414 286.632 158.561C285.893 158.708 285.133 158.456 284.627 157.898L279.666 152.43C278.993 152.505 278.317 152.571 277.638 152.626L273.837 158.962C273.45 159.607 272.753 160.002 272 160.002C271.247 160.002 270.55 159.607 270.163 158.962L266.361 152.626C265.682 152.571 265.006 152.505 264.333 152.43L259.373 157.898C258.867 158.456 258.107 158.708 257.368 158.561C256.63 158.414 256.023 157.89 255.77 157.181L253.283 150.244C252.624 150.055 251.97 149.853 251.319 149.645L245.394 154.035C244.79 154.483 243.994 154.581 243.299 154.294C242.604 154.006 242.111 153.373 242 152.629L240.913 145.333C240.307 145.02 239.707 144.696 239.111 144.365L232.438 147.518C231.758 147.839 230.959 147.781 230.333 147.363C229.707 146.945 229.346 146.228 229.383 145.477L229.741 138.094C229.212 137.672 228.691 137.242 228.175 136.805L221.002 138.599C220.272 138.781 219.499 138.567 218.967 138.035C218.435 137.503 218.221 136.73 218.403 136L220.196 128.826C219.759 128.31 219.329 127.789 218.907 127.26L211.526 127.619C210.774 127.656 210.058 127.295 209.639 126.669C209.222 126.044 209.163 125.245 209.485 124.564L212.636 117.89C212.305 117.294 211.981 116.694 211.668 116.088L204.373 115.002C203.629 114.891 202.997 114.399 202.709 113.703C202.421 113.008 202.519 112.213 202.967 111.608L207.356 105.682C207.148 105.031 206.946 104.377 206.757 103.717L199.821 101.233C199.112 100.979 198.588 100.372 198.441 99.634C198.294 98.8957 198.546 98.1349 199.104 97.6292L204.571 92.6683C204.495 91.9951 204.43 91.3188 204.374 90.6398L198.041 86.8396C197.395 86.4523 197 85.755 197 85.0023C197 84.2496 197.395 83.5522 198.041 83.1649L204.374 79.3633C204.43 78.6843 204.495 78.0081 204.571 77.3349L199.104 72.3753C198.546 71.8696 198.294 71.1088 198.441 70.3706C198.588 69.6323 199.112 69.0257 199.821 68.7718L206.757 66.2857C206.946 65.6265 207.148 64.9723 207.356 64.3215L202.967 58.3965C202.519 57.7918 202.421 56.9963 202.709 56.3011C202.997 55.6059 203.629 55.1132 204.373 55.0023L211.668 53.9155C211.981 53.3089 212.305 52.7088 212.636 52.113L209.485 45.4403C209.163 44.7599 209.222 43.9609 209.639 43.3351C210.058 42.7093 210.774 42.3486 211.526 42.3851L218.907 42.7436C219.329 42.2146 219.759 41.6929 220.196 41.1769L218.403 34.0048C218.221 33.2745 218.435 32.5016 218.967 31.9693C219.499 31.4371 220.272 31.2232 221.002 31.4057L228.175 33.1984C228.691 32.7614 229.212 32.331 229.741 31.9093L229.383 24.5279C229.346 23.7762 229.707 23.0599 230.333 22.6418C230.959 22.2239 231.758 22.1655 232.438 22.4869L239.111 25.6384C239.707 25.3076 240.307 24.9834 240.913 24.6702L242 17.3753C242.111 16.6311 242.604 15.9989 243.299 15.711C243.994 15.4231 244.79 15.5213 245.394 15.9691L251.319 20.358C251.97 20.15 252.624 19.9483 253.283 19.7595L255.77 12.8231C256.023 12.1145 256.63 11.5902 257.368 11.4434C258.107 11.2966 258.867 11.5486 259.373 12.1061L264.333 17.5734C265.006 17.4977 265.682 17.4326 266.361 17.3767L270.163 11.043C270.55 10.3976 271.247 10.0023 272 10.0023ZM275.03 38.0324C273.356 39.7061 270.644 39.7061 268.97 38.0324L261.873 30.9356C245.39 34.0036 231.491 44.4203 223.708 58.6602L228.265 67.6055C229.34 69.7144 228.502 72.2954 226.393 73.37L217.452 77.925C217.154 80.2421 217 82.6042 217 85.0023C217 99.6365 222.717 112.934 232.038 122.788L241.94 121.22C244.278 120.85 246.473 122.445 246.844 124.783L248.413 134.698C255.562 138.097 263.558 140.002 272 140.002C280.442 140.002 288.437 138.097 295.585 134.698L297.156 124.783C297.527 122.445 299.722 120.85 302.06 121.22L311.961 122.788C321.282 112.934 327 99.6369 327 85.0023C327 82.6041 326.844 80.2421 326.547 77.925L317.607 73.37C315.498 72.2954 314.66 69.7144 315.735 67.6055L320.291 58.6602C312.507 44.4202 298.609 34.0033 282.126 30.9356L275.03 38.0324ZM242.698 129.545C242.34 127.285 240.218 125.744 237.958 126.102C234.314 126.679 233.187 131.374 236.173 133.543C239.158 135.712 243.274 133.189 242.698 129.545ZM304.92 126.102C302.66 125.744 300.539 127.285 300.181 129.545C299.604 133.189 303.722 135.712 306.707 133.543C309.692 131.374 308.564 126.679 304.92 126.102ZM222.006 65.8602C220.33 62.5728 215.516 62.9521 214.376 66.4615C213.236 69.9711 216.908 73.1075 220.196 71.4322C222.234 70.3936 223.044 67.8985 222.006 65.8602ZM328.503 66.4615C327.362 62.9521 322.548 62.5727 320.873 65.8602C319.834 67.8984 320.644 70.3936 322.682 71.4322C325.97 73.1075 329.643 69.9711 328.503 66.4615ZM271.439 25.0023C267.749 25.0023 265.901 29.4646 268.511 32.074C270.129 33.691 272.751 33.6914 274.369 32.074C276.978 29.4646 275.129 25.0023 271.439 25.0023Z" fill="#B9A032"/>
+</g>
+</g>
+<g clip-path="url(#clip2_7_13)">
+<path d="M81.7525 10.2036C82.503 10.1409 83.2314 10.4771 83.6714 11.0883L87.9898 17.0883C88.6715 17.0875 89.3513 17.0963 90.0289 17.1157L94.521 11.2504C94.979 10.6523 95.7169 10.3374 96.4654 10.4223C97.2138 10.5073 97.8622 10.98 98.1744 11.6655L101.23 18.3754C101.903 18.5087 102.572 18.6558 103.239 18.809L108.784 13.9379C109.349 13.441 110.135 13.2772 110.852 13.5063C111.569 13.7356 112.114 14.3251 112.287 15.058L113.976 22.2426C114.607 22.5044 115.233 22.7778 115.855 23.058L122.249 19.3598C122.9 18.9826 123.702 18.9737 124.361 19.3383C125.02 19.7031 125.439 20.3875 125.465 21.1401L125.721 28.5317C126.284 28.9081 126.84 29.2942 127.391 29.687L134.396 27.3022C135.109 27.0593 135.898 27.2083 136.473 27.6948C137.048 28.1812 137.326 28.9339 137.205 29.6772L136.013 36.9799C136.492 37.458 136.965 37.9426 137.429 38.435L144.762 37.4623C145.509 37.3634 146.253 37.6633 146.722 38.2524C147.191 38.8417 147.316 39.634 147.052 40.3393L144.463 47.2563C144.843 47.8229 145.217 48.3952 145.58 48.9741L152.947 49.4496C153.698 49.4984 154.369 49.9376 154.714 50.6069C155.059 51.2762 155.028 52.0779 154.631 52.7182L150.747 58.9926C151.008 59.6244 151.264 60.26 151.507 60.9018L158.633 62.8032C159.361 62.9974 159.935 63.5586 160.143 64.2827C160.351 65.0066 160.163 65.7866 159.649 66.3373L154.608 71.7387C154.74 72.4038 154.861 73.073 154.973 73.7455L161.608 77.0092C162.284 77.3417 162.736 78.0047 162.798 78.7553C162.861 79.5059 162.525 80.2343 161.914 80.6743L155.913 84.9916C155.914 85.6735 155.905 86.354 155.885 87.0317L161.752 91.5229C162.351 91.9808 162.665 92.7189 162.581 93.4672C162.496 94.2157 162.023 94.8649 161.337 95.1772L154.626 98.2328C154.492 98.9061 154.345 99.5752 154.192 100.242L159.064 105.787C159.561 106.352 159.725 107.138 159.496 107.855C159.266 108.572 158.678 109.116 157.945 109.289L150.758 110.979C150.497 111.61 150.223 112.235 149.943 112.857L153.643 119.25C154.02 119.902 154.028 120.704 153.664 121.363C153.299 122.022 152.615 122.442 151.862 122.468L144.469 122.724C144.093 123.287 143.707 123.843 143.314 124.394L145.701 131.399C145.943 132.112 145.794 132.9 145.308 133.475C144.822 134.05 144.068 134.329 143.325 134.207L136.021 133.015C135.543 133.494 135.058 133.967 134.566 134.431L135.541 141.764C135.64 142.511 135.339 143.256 134.75 143.725C134.16 144.194 133.369 144.318 132.664 144.054L125.745 141.466C125.178 141.846 124.607 142.219 124.028 142.581L123.552 149.949C123.504 150.7 123.065 151.372 122.396 151.717C121.727 152.062 120.925 152.03 120.285 151.634L114.008 147.749C113.377 148.011 112.741 148.267 112.099 148.51L110.2 155.636C110.006 156.364 109.443 156.937 108.719 157.145C107.995 157.353 107.216 157.165 106.666 156.651L101.262 151.611C100.597 151.742 99.928 151.863 99.2554 151.975L95.9927 158.61C95.6603 159.286 94.9982 159.738 94.2476 159.801C93.4971 159.864 92.7687 159.528 92.3287 158.916L88.0093 152.914C87.3275 152.915 86.647 152.907 85.9693 152.887L81.4791 158.754C81.0211 159.352 80.2832 159.667 79.5347 159.582C78.7863 159.497 78.138 159.025 77.8257 158.339L74.7681 151.627C74.095 151.494 73.4257 151.348 72.7593 151.195L67.2164 156.067C66.6507 156.564 65.8652 156.728 65.148 156.498C64.4307 156.269 63.8861 155.68 63.7134 154.947L62.022 147.76C61.391 147.498 60.7657 147.225 60.1441 146.945L53.7515 150.645C53.0997 151.022 52.2981 151.031 51.6392 150.666C50.9804 150.302 50.561 149.617 50.5347 148.865L50.2769 141.471C49.7143 141.095 49.1579 140.71 48.607 140.317L41.6041 142.704C40.8911 142.946 40.102 142.797 39.5269 142.311C38.9518 141.825 38.6742 141.071 38.7955 140.328L39.9859 133.024C39.5072 132.546 39.0344 132.061 38.5699 131.569L31.2378 132.542C30.4913 132.641 29.747 132.342 29.2779 131.752C28.809 131.163 28.6839 130.371 28.9478 129.665L31.5347 122.747C31.1553 122.18 30.7823 121.609 30.4195 121.03L23.0533 120.555C22.3019 120.506 21.6308 120.067 21.2857 119.398C20.9409 118.729 20.9726 117.928 21.3687 117.288L25.2515 111.011C24.9898 110.379 24.7349 109.744 24.4917 109.102L17.3667 107.202C16.6389 107.007 16.0649 106.446 15.857 105.722C15.6491 104.998 15.8373 104.218 16.3511 103.667L21.3912 98.2641C21.2596 97.5992 21.1381 96.9305 21.0259 96.2582L14.3921 92.9955C13.7162 92.6631 13.2644 92.0001 13.2017 91.2495C13.1391 90.4989 13.4751 89.7704 14.0865 89.3305L20.0865 85.0121C20.0856 84.3303 20.0944 83.6498 20.1138 82.9721L14.2476 78.4819C13.6496 78.024 13.3347 77.2859 13.4195 76.5375C13.5044 75.789 13.9771 75.1398 14.6626 74.8276L21.3736 71.7709C21.5069 71.0978 21.653 70.4285 21.8062 69.7621L16.9361 64.2182C16.4392 63.6525 16.2752 62.8671 16.5044 62.1498C16.7338 61.4328 17.3226 60.889 18.0552 60.7162L25.2408 59.0248C25.5026 58.3938 25.7759 57.7677 26.0562 57.1459L22.357 50.7543C21.9798 50.1026 21.972 49.3009 22.3365 48.642C22.7014 47.9831 23.3855 47.5628 24.1382 47.5366L31.5298 47.2797C31.9063 46.717 32.2923 46.1608 32.6851 45.6098L30.2994 38.6059C30.0567 37.893 30.2057 37.1048 30.6919 36.5297C31.1784 35.9546 31.9319 35.6761 32.6753 35.7973L39.9771 36.9877C40.4553 36.509 40.9397 36.0362 41.4322 35.5717L40.4595 28.2407C40.3605 27.494 40.6613 26.7489 41.2505 26.2797C41.8397 25.8112 42.6314 25.6869 43.3365 25.9506L50.2544 28.5375C50.821 28.158 51.3924 27.7842 51.9712 27.4213L52.4478 20.0561C52.4965 19.3046 52.9347 18.6326 53.6041 18.2875C54.2734 17.9426 55.0751 17.9744 55.7154 18.3705L61.9898 22.2543C62.6216 21.9926 63.2572 21.7368 63.899 21.4936L65.8003 14.3686C65.9946 13.641 66.5561 13.0678 67.2798 12.8598C68.0038 12.6519 68.7837 12.8401 69.3345 13.3539L74.7369 18.393C75.4017 18.2615 76.0704 18.14 76.7427 18.0278L80.0074 11.395C80.3398 10.719 81.0019 10.2663 81.7525 10.2036ZM106.434 51.9438C118.308 56.0132 126.991 62.1132 125.285 73.4614L125.289 73.4623C124.054 81.7694 119.426 85.7915 113.281 87.2016C121.718 91.5723 126.011 98.2744 121.921 109.894C116.846 124.327 104.787 125.545 88.7496 122.525L84.3912 139.932C87.0801 140.106 89.8155 140.086 92.5816 139.855C101 139.152 108.816 136.585 115.662 132.6L116.403 122.581C116.577 120.219 118.634 118.445 120.997 118.62L131.002 119.358C139.476 108.754 144.071 95.0163 142.852 80.4213C142.652 78.0298 142.301 75.6868 141.811 73.4008L132.515 69.602C130.323 68.7057 129.273 66.2018 130.169 64.0092L133.967 54.7084C128.256 46.0584 120.19 39.1696 110.761 34.8784L106.434 51.9438ZM67.9517 133.823L68.6158 136.53C70.6188 137.285 72.6752 137.924 74.775 138.444L79.2945 120.402C76.8564 119.799 74.3657 119.159 71.7994 118.466L67.9517 133.823ZM62.4869 131.866C61.9416 129.642 59.6967 128.282 57.4732 128.827C53.8868 129.706 53.1544 134.482 56.3121 136.397C59.4701 138.311 63.3659 135.452 62.4869 131.866ZM124.255 123.249C121.972 123.081 119.985 124.795 119.816 127.078C119.544 130.76 123.86 132.933 126.657 130.522C129.453 128.11 127.938 123.522 124.255 123.249ZM73.397 31.9243C57.214 36.357 44.22 47.9035 37.6431 62.7534L42.9341 71.2953C44.1813 73.309 43.56 75.9533 41.5464 77.2006L33.0093 82.4877C32.9055 84.8233 32.9483 87.1919 33.148 89.5834C34.367 104.178 41.1762 116.965 51.2925 126.016L60.4927 123.76L62.4429 115.969C60.2458 115.41 58.0145 114.817 55.7378 114.248L43.4996 111.212L48.1685 100.501C48.1685 100.501 55.0853 102.331 55.0044 102.199C57.6669 102.855 58.8486 101.126 59.314 99.975L65.4634 75.4428C65.8098 75.5253 66.1438 75.6104 66.4576 75.6879C66.0822 75.5379 65.7423 75.4417 65.48 75.3754L69.8677 57.8627C69.9821 55.8745 69.2933 53.3661 65.4849 52.4203C65.6315 52.3227 58.6973 50.7406 58.6548 50.7309L61.1568 40.7368L74.1255 43.9584L74.1148 44.0073C76.0643 44.4899 78.0738 44.9481 80.1197 45.4116L81.7554 38.8871C81.515 38.7535 81.2839 38.595 81.066 38.4106L73.397 31.9243ZM74.8531 107.205C81.2286 108.78 100.891 115.061 103.797 103.441C106.834 91.3227 86.392 88.1894 80.0171 86.6059L74.8531 107.205ZM82.3794 77.1762C87.6884 78.4929 104.054 83.8621 106.706 73.2924C109.466 62.2678 92.371 59.8103 87.0621 58.4936L82.3794 77.1762ZM36.5455 70.0766C34.6006 66.9377 29.831 67.7163 28.9859 71.311C28.1412 74.906 32.0651 77.7283 35.2046 75.7836C37.1507 74.5781 37.7507 72.0228 36.5455 70.0766ZM142.806 61.8051C141.377 58.4002 136.544 58.4224 135.147 61.8403C134.281 63.9595 135.297 66.3814 137.416 67.2475C140.834 68.6444 144.236 65.2102 142.806 61.8051ZM89.5962 47.4418C92.1198 48.015 94.659 48.5939 97.1314 49.2075L101.585 31.6498C99.0837 31.0133 96.5192 30.55 93.9058 30.2709L89.5962 47.4418ZM82.4429 25.2104C78.7627 25.5179 77.2921 30.1222 80.1119 32.5073C81.8598 33.9847 84.4754 33.7665 85.9537 32.019C88.3387 29.1992 86.1232 24.9031 82.4429 25.2104Z" fill="#F7931A"/>
+</g>
+<defs>
+<linearGradient id="paint0_linear_7_13" x1="166" y1="71.5" x2="199.5" y2="94.5" gradientUnits="userSpaceOnUse">
+<stop stop-color="#F7931A"/>
+<stop offset="1" stop-color="#B9A032"/>
+</linearGradient>
+<clipPath id="clip0_7_13">
+<rect width="150" height="150" fill="white" transform="translate(197 10.0023)"/>
+</clipPath>
+<clipPath id="clip1_7_13">
+<rect width="150" height="150" fill="white" transform="translate(197 10.0023)"/>
+</clipPath>
+<clipPath id="clip2_7_13">
+<rect width="150" height="150" fill="white" transform="translate(13 10.0023)"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/logo/rust-btc+doge@4x.png b/logo/rust-btc+doge@4x.png
new file mode 100644
index 0000000000000000000000000000000000000000..7781d631bb1c98bbcc22c2a2219bb7555a6b4c75
GIT binary patch
literal 70509
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%0A0p^aPIQsj7gvL
z5Qjy}Z+=93DMF_B{Lxbg^2@BA@6JXO$!$?EilUc{rWK_wm?dvt>XT08-bwv5AH00=
z1W*DoXiIw=Eg4<kVZ!uDi%S9(xLQ2~KDr`dTalHg69QCSh-#$auT&^Lwm%i#GbzSh
zS~%3RTSj*VqAG1F-wKGUDod3Hz9!@NrbSwGE#ajeR<Oc_XLE6%=k!XHxddp^-ug%&
zAgZ^l+ai<_4ctAz`FOk4XvHSqSAl)Ic87KIMkvt5RzA$0X|CJ<RTH2qlg}%!b-V#e
z)Wj%smhr)ao}{nc+us<BlHWDV|Le^qRs*moD$Zae9e5&B!yH8RXA~_*vFd@+6+o>)
z(!*$Jg{hH(y>IW))8jCbM0f%kW45Tm+I=tN(E5osN8o}0U1}A>Zco832-ROJwT~zh
zB!Q{Sq>qwbUh_uo+5gN(KZJc}_5B;sn8n&9EMa*T?GVDd9D7N@<G(@oo?lle9pta2
zsHvt?k7m@VuTYAX3g`8d0Ce-$q>CeF#H@@lyMGiuR|10&isuu9+9~;czuO%;%@;;V
zkIQ?;k0ITPEF)m`vhTMMeoBS+V))U<Rj;L5ec4knK;t76d!i#nW%&6EQpWh)PrgHu
zI}kw7fWMNIT&gf5OT%!P4<iSVYJI%JJarf?@i2=EsH0%XosKUUYqd^d>(Bmn7F)ev
ztR<j7yoVxmKikgD1$=d7{&9UDuN=2!hYQU3B~QRTvI${3b#S>1tRLV1!VJ%Aq*V(K
zMLPZqae_SN@F~TJmyM2XiF66wx7cJO%JPIlA@x}zo%o#@xX+3Z0SVjXW6dC0-mj*B
zJ<dNE`wPab)&V-=wHwwcm7%~+KR^Do%<3qH`EJK(Ujf0wXD74F5TeX+I7HI-^XV8G
zKK-y6eu{LwA-erso0&`TSpYDj_ZvUl0fmqk{@$<|X9=C8*a9qxH?=JT)2asg{tJ4v
z?<zTisl^ELcv7YmBO{&{8Ow(iSiJ>ySG6KcynhPQsayRV^V5Z_N_VsXO5FXw_K){Q
zY2Dij7jmo$cNI2((X9L6%R90ySAR#RN$4p_d0Uei9cPF#T8Tp+=Qja+*O?*I6K>Fp
z?QK`+3OG0SRS)``S@=R}Unet4z(WXVj{*o$oUrw}_o;O_`Osm4i(dl6xQvMB@R}k)
z?3*z&&thX^{6P*IzK5`bn1U4zi!WFnuir*T4h)DBqg-I0k;q6^1sjOQe4--;DBJj(
zHKjjpO+Sq3@q2m^a*P(Nyq3q*4r$Z!6D>lq`!ON(f_huUI6#M!6gV1+b-__S27r3a
zOd^T9{!!Np1ro1`TM7yifCClLv;<8mIhk`q7T)R86uYwaf6N9nQl9`cm;-|2&z}4V
z8eSrAwRYWabKh#2FfajsR}M)vsS@!H{K|{YD7dB@jzup_yJYGPhbeVtXnYa1<5h)n
zQDm6^Tu#fT521Z|H`D_&2$M`!;26X?LHEr;*aN2~N@mqSZvyyt!VQ{EDj@swwrD5p
zBZ{8$bS^ItWk@7ImjRhrG14J`cMnJiarFkUP#6x)tTb+*qg;gK1~$AtGu%(s?|oma
z6>`;X_Vdt%TV`oNq9f@7FHjUoy<t^1WDPh~EiZ=Sys%C_lt3<6e_yh^a@gI`EU%n8
zg#EptK56V9p4zW~El#eWs7kfuVJSR#wBI;RKSn46IH)@)%_nns8^1O()ZLCdmblgJ
zn#1jUR$7^#HPf4z(<A>KtquRd7{Bl2F3w8;#MRyZP%wn}Xuj4g${cWfVI0UDbjQyi
zG=89ddFP^A=V<AI6WMUmsG-}5Nk0Z07^<+KAB}fc)`!o$dlP=cY3#bUr(|0^il~8x
z-xTOIXXz5mtZ##8QZz$s_5g1FlbUYFagGA+8G3PE*<*=l8d>%}UTDN45@4wEFf-r`
z69pi38w;KCZ)*QaYtIp7YKA1)@q8i>dff<{yFynuWnQtNlPe(o+sQ4zJZ{!u9jk*c
zj7~09F-YEyNq!E93+jgnMx>}9))ICncnWhRXNx+}7W74R12~#itd`&P1dVeBt#C+=
zG{vgxPX%yKOvFKC8%&-F&WM8vbsz`S$Am!Lvx;&c=pkGBVKz^q+11jNjQ)pTQ@Rnb
z#G>{+rtB2wlugG7m}kOAQ4G+teofhmdd{%+vh+!SIwP2nWzl(@r|W^G6XDp9vCzhk
zoez_{4xr|Ss&UmVsUH$*y{`T)uZ#JP4r@=M(wUw+$BRNWMlv1!%!N9%J_`_Te582j
zC(Vtqcq*gfeO8Osl$I9^X%-K5u{RGP**Eu@f>&cT=#B9(eRH7*?7pPN)2chsJnVKi
zah<_TbjfwthL(G>$t&pXga-1|()sIt;2@X4Dz`jV(}8*H1OT?ej-997D2nt~(v!vj
zD%P|lG9vXaz#hM`(HsCLiwKsSHNfWxO94EX`&OX%z6kn?P*qU3Dwtv_%ina{dwV)}
z%dW}!t*I+V3r`#0e6)9+x2db{Nu&k7iUNpU{_&1fFpLS4uODx@G3(s1H|wOSUO42k
zBq^#1gxr2BULi#vW&MD%a@^5y%(;60Yuv2+>HeQZ{?Pi01MJBFr&x!<NrU}*oq0_=
zs=~Y@Y01)2(IqUvkcVALOS0RZ^wxZy(M2@hmTkE{wOzk~2S058yX^4rej@P0o8gFq
z1>CaBp&j5a^G=4WYlqx#RZ5r|^o;T6(x^z^50nfNUKYKM)5kU8xH4!xtXTZv$$`2<
zJbQBU3tzdJ^aNdmn)^p%WH;UV7Ixbp!8)KiqiUnDyKNc+MbJ;xTXvfZv;4cIoYJE&
zW_$K2)GQwJRvBo`$}Dq-3P)bW1QO^uY`g38P_??wV+^s7D)yHzVPxMi6FPkZN`N&s
zbk}po{<5Y?&j~<kYa+A;WVl#%ldm?5TOZ8t`Yk$clm;Ll1UqYNx&!2Q7G+U)Y!Bel
zmXGvgfyr-X^Ta=p-+xp~TDtI1Vks4!Gb6A^_^s#72STm*KJo5O-Iu>U3vUE<XL3_-
z2n5KyWoll&cXadJI;R02D-@gW9zE+A-ij~}MSu4_5={<Os+`+!5{`_KKP>*p;5Lsg
zdX{ZMjgXKnnek;qAFZD2fHs#!hQGHA`yhJMQlvI=`%*9tkQ0^!Ui+*R*$y}_#VeP6
zI=RvB%C8Q)_S`3_R#4UcY(+>bgJ&O>i9qT3HGbXoectwNk+Whprg|I+c)xi(8@Csi
zk6wL<8ub-IA65D9f}&Rs)?Kd8Zh20i?aKc?`{{*jNhYg|cZSvbBQV+FMqSW4DR>#B
z134>0ZmIE(nT)R}+ts334j(H-ElU6^3uTH*L08!F6)prxsTfwU@q5)Stm-V~OWY1X
z2<O>tUyOs<@ZWK-rCeQt_k5|5bd3a@Dj00bZWNCBBlKSXH=Ijlj_CHP3}JgWuY}^x
zmXJk$TSc4&Y!dO=$<lbG+*kRK)dNKN54{qri#jgLwqF@m|FH8TPJBs}rA1wmzkudx
zb!S^y6n28OB)zn0zkCm4{B!z`6k(HJf3<1jax|}H7((qIc>WSb%ZWN*p=#68CwDZD
z&gWI-r%>O<K!JNnH84>*%hz=EW1`50(E?JvQonkRyL!&nB21n90o*N!S`CO`iBBOK
zmpJhvZNt(w%$hT}`p!kmj1UK5Eg)<NPMtQ#a&-&dtAX5_NCl8ptl9NJ#z__D6ZXnW
zDzL7xfRBBWq)M~dP0$>-6|qbo?-h!t)mweO<Zb=KKiXE;ejgMP0m8MCEZt(`sJGfC
zrpewpUP>R5<F>sYa>`U!uw@IkpE#ysu!3wi{qiD~wsngdg9@8qFSpRk%gl&WE6lJ)
z;aXM%`GsfCf;c_JxJyi)zQsnuc6%@OYNSqIXOsl38}z0RBfiB1#D$R8`i|rm{J3k-
zTRVP<o``RK?19M{*ZbdC&)_oK229~nIM2g=4SWQ-@Qw>Wz6g4W{Lwz+zU;NX6?X!b
znV0NdS#Tl4Q9V8aCM*>+LQ=Zq5Zv(k8OWNqe&Mxht-ZBY>lcvR->zGXAB~;{%5DD1
zFEJdxF=v^4s~9%3G>tQD=M;-2!$=xMua0E7vF#=T{!|p0`W7ll-O}I{y3i$epe~ih
zP5Bixa1OLsg-DjC?G^&rY!zF^jb&OHRBE?SZ5Ai+XHf45wrR%j%RmV7UHArEoSvR4
z%D!5&`=nv|$Ua!sv*lK(YkMY*)W{jPTJ*?U4${EJZ>GcI{n{j**JCl1Iu}bMXGS1O
z<B7KrmQ*Bs@b7qDh1vLqi86Ki^M%k5lI2r$q`%&L)_vOxwe?@}uMoiDHMvKT1$217
z(lNsb2nNGCXNl%L=dV(l<(|Y&{PfJEtXw6sL_NAdBZ73FyqWdnd)AKG#2itqnK&ge
z0iV<=DtX;5nLkx{%={9upHaF1+Ql6P-pv!Acc;cEzXr(K|H>C5fy$Z9=Mi{UV!1m(
z<`)eI>>|GLpHXH#MU5T@9_^iiSXU7z;?H_z9?U95Op^r?y0_Dur!zRb4Yd`k&~|>G
z<j16?5jRjWn17!GLK4ReEuUvGPf2iZ@blm3P$!xHn_H034oO&aPYHO_7ELC?h)%>n
zE(6O7mQIVE=FteN&KxX{LOV68HR-U4y}8ysWTaiUP1^_EUWM<rwB@_tyhusKe@Jiq
z%Vxx(?-0D-M)l^9fT|<|<_(nlhQn+~M4mOMK8aQHPUdZmld78qR+$7l&-NFTSDxdF
zL5J}Tt;K7d_2q4Xg44l|AmoUjlPF)rNBOtU>VP5FQ35P6^UXc^a-Ir&nbg`3b@>#`
zjv9%w=Uc{C&AjT7zbF|(bf3!fbw@h`fmYc<_=^0M_z$)@qkshsH?Wj4Wcky{;=Co?
z(SQSQHKiY3a2ik^sL#?LL0aAw$wdj=7`Qiweafj{H=l0$qP_I^@cUFsz{F1B<;Fmv
z|F^|0HDYOAns2|~8;O2FB@*n~zApNB-uY7NNahJs^Ue0W9?uAIGW`{hAZ|i<Doh%b
ztw$@%zpZ8cjfM3N@Dv3P;vW&mJmB#KDtuBGRjo3W(r3(2RWmYrtga>d;RzbCmafV_
zAWWre>b!ce%ucTCVS|d2dlv;{3eJh@25=o_K-=}nWnX*A*YmS<NM}6-D6)tTGcKBY
z#A0GMywMtkZUguKaSIPRx+`u;3gQoZZv*m9Wc&r2zL6ogkQKkYx)$GYwXL3YUvjx+
zvmFuFAY|x?IIRObpvKDG*uG^Y1MN1y50E&BhFk{Mn-NL-yKEPDhT(;h7@;NkYbX=i
z3NY|lD|wae4Y%>a9_l+j-nZY$M77nZGLg$H*ltJCKkpU#>&N*K?v`XF|MWKz?esSh
z<~#UTR{{5My!Rla50Dj|T*z-=i&ofoyi_yS>p$eA2M|uT`Rk(0Vrh7Vhj>?<i@z@B
zjAMR;@iKGol&odd@*7BHYYl;M{SI>4l-<V+Q%$|x<l$<`W2C$FJ(%O%cbcv~<(63b
zg2RtdW7y{x0r3_VcX{2C4nl0W1*GX|AWB4Oqrq7Ag$$kTqXP=`RRMI12#?KgH733L
za0KGg(KAN^d;MVFl?E7Qu#h!gy9=CC$4wZ&=mCDog}meDg$H<b%Uv6k&uA+7bVEOj
zAQhtzn|0>70L!YPa};>U45tL%V1owxf>(6aG$PvVpgZMizm)5c?x<Cw%qr*96M+nF
z5bZw3c=7Jf#yL~JOHe@=TUq^9Rb2*WE$2a{(4m<&A0_co&r1;g%4@=7Zn!)0I@_kF
z{N4KB$fCsO16L$9W0}(5-dj}OyS^e42QqD!EdKCnNwCTdvP?@&$ykb!4r*mWze-Y%
zAJHfBb#J?>0=xPbs~)reOGEb*?K{}K*Z23ota<-rmT&FPHI-zdkDq>!-M;H+pj#-a
zXNyjKI+tTUWN9^Ps`C^3#isANDG4S^=)!<P&tq~~7I@wffp*-o@N)$_z~us5&qV$2
za|eg9&ZUq6inCZQmKG$6@gND*Ht>k@@wWq)cGD-t#V*)~)jk|_+v2HXBcV_X0mK45
z4(A6c?uC?}wShM;5*w?7op^Pr(8tGSm;H{FN5yCP7Q4t}<TgzQ7|BQqOU7{}<T+fi
zFmA_k_G}p@bp@B8L?}#I`~F7f`+;3OrzgTW+oq7bpdk5I%agK;|BBAwE%bWIL{O<K
z73gkTlY}7o+LD~p!_k_ie{CE4Z@DML;|lJ=ioNLIFJY20YemI-B7I+}ce&Z_nWAH*
zdk-<&xjNctr$3`)5No+mmf={OOq$x^-Z~RHy`p-#bJjBbbua}lOvA_Xcs$Nx6SMn;
zt<`zL?dD)gdC}kS`KWg=^aKpv6RGFYEct!(Fyz?L=c5~g1x-0u)!4}iD$fX;57k<#
zPyz?xV)oDgQ#MtPEsw6unFy-x2;@=d-8=)heL1le(3~{^pUr(U1ZX!&+hBdRxX=4V
zjUlIvH^$sL=1*faO-l0c5aQvlpvD+1&8{$ho^dQ18kT(41J&S*K*qW3*m!`A{P@VG
z=W7oh5kG02Q&$h8qof5U%(+EEq*rLG>X7SIJRg#pM)cA-Hi&;A144XduKJrv`lsb>
zC!B}V2W`UC-WK)tH6UP>y&u}NngNyJ!R-Z<8V>kvo`2(9-rn=$($bLAp0y5sd@%YW
zHt`4Yn@jTJSVhzSC{p{yyxcshUYTA^tw#oO>YP{d7iVnhm^gWb9=y4W3|uqU#c6J)
zYmz%sTjE1X36YDvlBZhpPS8A`IdAf1J}X(c)3^=*SZYH9-1K4RTQjDi=)aCTKZyeB
z<I)@^#e@<P8gi_P-YtC43N1HHd3)r3q^DSRs#oB+@}=o|hLOp>q@S!l-9p~Hz{Cjg
zG!D<-%7;Q`@y?6$kl6ag)YjXx!i?Od+&ldWX1VwamVaVcQUL8{$^Xqbalfl6VN<gu
zmo<EM+j$)#^c?uwpU3i&ziCX|PfVF#n(|c0*du$5`PHKO{gg(+zN}}Z`0g+$agrT{
z)`FD;_J+Oa*ViYWqU@`l-dzxV_neE|v4n6wPXa&I%70dxsTIrpy4Tb;w>Jhy*VcsG
z%g?`V{giFfti(L~dntoetcf(C1K7!HhiM4$w(^Ug#A}dDz~;6%Tn=FK0)eB23?W)1
zGlEo0M|o-(NmMOwVt>ZeigFu2rT>1A;>+IZ)`vOK>$$v!^(=A%Y|EF$*5K^Zwr>%M
z(x7_Xf>##k>L>c;v+|XP9yS4)&}cz*@s96VJ2K=8!j|Ju)`=W`*PJk%<3sUsd!zpi
z60`5zI08AGYyMmBW-NLx_fSI^Cp+|8i!~m+7>VslR~7i$&K<8mt-A$3386W%!aAfW
zYx!T~0W>xM-QTxQc`jzZUC1YdfF$G*l7ik#nG(%OQ^VMdd0}=Y1P*qK5q0=s@O_bY
z0=&3MEes9lhhQCep#J{mvS4M(LrRO)gZ}ENLfjkd1m>K^Yu<ZDib%S4!DoZqihnJZ
z%U<Pf{PWQY795qGx%)X-v`qiFZrvC#SO1PB9poj;N2<@GHn-w*i(yBP+2049Kz9{B
z64V`ZU;DO(tj%HUocAU9kZU=u^g?|L6RBNz{at%oN7t^R$y`sg%RrJDATlt$ETs*6
z;hRcBf_nLVq!m5DzCE|%mpkPmP`ZecOu=zAE{3F*N$c0gw5y&FIXrhr*`8P>l4Fg9
zPEFJH2vEsE4d;=&;hJ}Qsu)OrZ*tBmWjPSNE$XGaVMkKbuKjIR=olndU-<AY>^mO@
zevz@LPnxL#A+y%L`sD!N{cCUbM$PChkS4opjtv7h|3a|yQ+gxH-*gCDG}K;M_AC@$
zEX;o`q5A8M+E4v;+AMyL{EQFjoL7<QG2_L98<Irw7iDz_d$A}B?-!48-Xw<H8l*hV
z<7^+d)59HuqwMF>j+X3s`g8fyZ1!dhx7&QI4V>hjiGZJq9|@G_Apu^)=70T%%I&0E
z<K`~yQRVhB408JkUP&Hm4u}<Q;i2#)*Id1+e?jpXuNKJ0c=n>=Y=v#R9`GM$-(0fZ
z3GP>A#Dt*>3|Fw5kJ{e)dPW6~hK2H><j{Ax=D>9GQqrz~*AuJ~Uv?LO#UB~JMm@gw
zFE<g$4JZ#yjUCvsiwD&XxX6?Ot}z?CB303tX{hTnBBupJky)`s<l>55pp#9`+k)ST
zqS$*`kEJXleCEWgBSNmxB8N0o`>t}u1J^0nU|hY;r<;;-G^@J*!M=ls;`y?9Au(KQ
zNvo>xuz)cUGtmxw-Z=*ZJxsidG_sV(dIGsyjtXk@1i22fWQu+Lad!>lG%cK=10EA2
zt_#24#N7xb<{vC655GO5O!9j!O8ewWZ&XAdsw)r*%}U{jmw773+7tbiWVh&@C<^(E
z=j?vyMO`)7t6bi9>^psHSpuO#Axt;~VT+Tl8}At3NbBs0hCF>NTQsWl70|2Wxn{A8
zqSx|(Sh_SNE5=}oLFPDrG$n~8OH_wuJag;nzP-FKBaOQAy)U{oS9oj@LEnK#nx#pd
zU8I4@nuh&25$v%|vdeBw%FUMO<Dh3ff_lN6tP`-+-tZvF^9h*mZ7!-C(8~-hwttC=
z1C}X8Zj&2VJS;o|*`C(gFqY2d$yZ7054uRD&+pm~AbOWm*1Tbc&mRl9+OI8m{%9BJ
z1;|Y0s*=+H6Dh);gtCfT6A*w)2ktMFa#`j>n|*o%@-;Af3#_`Jybu?PXtgGb^*6hh
zqZy1QnHh%_Q^)(sFZH*q1d0B1<^W}vmmq0}`%t{Rm}FbPr-?*Y!;ocD$v6_+i6ZT(
zOjw~fAvk=+Kw<G3|INf7?iNSZJGcj8tyUa%AxMM~iDJ{`(k*wfn7W%<Z){dl*I)f3
z-}?!pr<QEfo95~uj*1xCsk8%B)n3v2T&@wrTSbtx{OW~A)B^n^^0!yAXoQ;?y?Kp%
zJ=ujmsskuVHziB$4V8@R^8uMV@wD7!<W<)B%tMe0C^jta%!VXA->bu@r9bl1?+>(7
zG8~krL(jG3_P(h5f0ulxzL70lex~%iLX=wA{S^^wuEHJgF*O;eUq{hqTjkYYTO1nk
zt}4B`cL!@CCSR?TrmXjsWdHC*gnjJ7dcI7&G(pHuT!UaC<-xFKlI@->RZ`kS5pc^~
z3Y!10y^Kf!v%i+U-YI#Du3)G~Z$p(qp0g^hbZb-Uo#fH_)`%f`AVWxQ;xdrI#T6rJ
z9Yh!Q{}sf~O}-DD0cAtJ<U!LL%pVPFUH7gx^T)s8aKW<2@9CU2#-WR%pYpqRV>*2l
zVM1>q2)EO&FSRCYOO5q6pKn_@a43eQfG?F32ipU#UXuY<XJc5i%@Nj4B&Quxv2-Gd
zC5o?YUY)rT`AL@^m=`uoHL%!!vA-2j*NB(+C0Q`Hzmn;|4OBEWwdWldb@?N0<K&uO
z8P8cYn#&^#WdsnUqb2`iSu?YO$00w48G{#ky5!x_6#N#=j$7U5r$bcm@%yis#)mhg
zrHfilmzY$9@k%jmB)8w9IC}rg-MRl_DJSiuTEs2X8aDg8)^oeG1yy1v84Mk(Eji;4
z6-xBTS?Mw(5Gmh3^gc=1NOSmGc}R2sQt;Ect2xLBnQv(>d()<el=0R#`!Cd!<p{Bz
zbuI{koE34fZvY8FMq&A%v6$q%##s;wwl86<6csgSDJM6IDk4mOsmX<g&6msaO#MwV
zp!XMHczFi{K~q)gOLciZuRt4-Uv6Fyu6nRt-O+eni4lPm-1JA=w+gG?7sR&U<B+3+
zR_X)r^&q;<6-!p@o%}iw&1)$N)E$0zn)EextS~``8z7n5!A|L|M_-xiOstAVX&2nC
z+1J4+Uej^8gfAkK^dSKag|A-LC~wh?xCJqlM$hx;KC1LVzt5(AmNfVkS`jS%YGsR7
zY9e2R3#X36v9o^0jpv_#%p@uc(*0EKMCx=*Wk3?s@Nw2Z)GL?-=!+<4sH4>W<`IJQ
zunveBw|&nEr}Kk<fsjWpHsZxop<2Bsbo@~eZOlXAp`i3CtlxK!d%Fylj7tD=)q&(p
ze>lyWkJ=2GFMmzJk8gRo5Qua1(<lovT&4_kKeKpR5sb))HQCSPR^h(nNkjy&Q)$ag
z$*H4{%i&T^q(jpZWULU9KBRaRau<&V1{wZCAWC>1d-IzG>qpHvez&9a%!-W#PZdr+
zO6#CdwLyCa8?Z}@|DlRBWD^SBh1*^In|WdoTwmRUngRar&BRyB-s!W^j^^<Jv1Yw_
zRe8?oS}8pYk7Vofy*sCw;oS&|XgcziR0^-fua{|L(0&7AS`N({jMKpE3Bq!951n1|
z^m)Z(-YBQYWBlOm1HQnWc_+oG&&=D3rtpd<9RPEEnh0b=l#7WOq4Z}N<p()ptvFu;
z6lHXaI?>37w7`b4a@nk!rHavingk{qB7HG9JN($Zf8xd;#L!uKZ?{n$NX_|`WdQ3*
zX5}S)vPvTh9{YN<P3$xDUu`esv)Gf8IP|Kn!q<FTfmG_`Wfwk%7Ug2;A($W7YWmtL
z*rksEVX~iTti`(viF0`56?mGKxKIs2Z2}a}zs*E+G=|jS6T^V%8<db>j+f`n^V;Zw
zGzg}sd^%;wrq51agT{Le{jLk}qJXH?y~XsH;U*=9g8=nC=sU@k%yz5ax>7$E{Pqcl
z;ImlV_~sj|ChR;FK*#C-yT{RQOMiU2k@HaKd*i$G-&iclKbUg@3|tRf+q@NoOR=@S
zzuWr}@^;VAPb_Zc;cvtQ&FK&ZV^%Vufg7kF!|-N}kR3lSr`6CE-Rqa!+v0ZKJE(zO
z5gzd<|E<futdZ2|F`n{PxtOQp*4kp833sPlx-vS8hUUkkTP<^e5%_5#a7bfo<o7aS
z>+J~bc=UKNieQDeKl(Us$|Q#TNU?}V<(7VUPsnfUx|9_ty9+tnH6C8YK-cvLiU0Hp
z23fE$*^q-NCd942c(Yx|qou6*<((7BMEyh9c5Ta)k>qJNxZ;LPo=z>MQR8Unc(l!-
zg62~8G_mM_QhBMksa)MM@6n(dKk808kU-Dfi|cooGjzkgCG$!=2e!B?TIjrHH^19s
zX$AL%XqT-}h=CiG0VO~FK*CxpJ0ChKz5XK2bSUPKam8?2kwGW*M!8>i5NyxkJ}49<
zL3R`-Km_P6k5JUj-8&|k58i$JphE^)FBu=#N{m_P&YiOrfcb`dcq7uavLt_mkemtA
zwcYdX0x0fRPeMWcPb}M}grYJMj?7!WCs$``T85j!LsOLi8BHA?HrvgLrJ3OuO{j?O
zlmv|5ugfycPs2AKQ$S4Xi(yWkv?&-0ZdnIME^Wp@%lz6)ye5aQ8`1pkL+~Sjr_mj8
z-4-O=14me2M()uJJT1<v0|sn!Sp9|huKU-E=md2)*V~Zcm$xq;1o^<d=~GglU<?l-
zdvQtZFnc-NHs;PqXoTsRZKvR2AF%AI!e1AHOJ&qteEd6%2oiddd4U?}fB%@XlK&z)
zN4HIl?gEhaz-0L?I0b3w5N5)9EHg7?R+~Pob>3sjJ?A#gf`$%C4}4o&u=}DU2-<zy
zz0EnrN|kH_JSNR9WhBdQ8G#4YBYuJLEYyli$`<@9bb=lD%U%v5i1gKsmbv?H8h^tu
zGx#kz>s5eq14*JxZ+}U$U?{riZa8M51SNK!`Egxf5_G+qKQfk^5j#K01dPUdx{v^Q
zFDu^#<eqZP=o!tf1Hgy7ksET&C)?Xc(;crN+jZOeE~qs0N<cWmkzB`Kukbiw(kXuj
z!n|(Vs=de!{a;tvF{xS4=!Xry+)ZGCC;GAvm6sCUUdh64Cdd&b63m9&l-e>4+NJMM
z^xlu2ym?G5*|+tzk74*TKePw_dssv&Oq|6YVXhsLNx?7McHxgnv1BGdO{<I8&HHka
z_zH>nfvbVx=f;dR-9^uoV@fD0Xn-^lCTqad)6xd(kRiZ2IU7ue9X!lnlqrK~AQsUf
zr@EC=9e2mFBbE=6P2pFch`;1`=_U`RN4{}|;H4=a&(Met&|;1kaONf@n2WK>jr$h+
zRVB>hlS>>U_w(1lGfTnKJkX}O8UNr?-sQ1Uy!xJ=`F4Ni_d`q5H%oVFL-#r6K%zp?
zdn(<W+zblE>58j~b%1z#bY5Qk^BgiTO^QMVo(mnMqj%JKBl5%d549jwA<@r2#B+jV
z3VcRLC{R%n&46vm@z}D=@(mvOMJa#tcn4{hFAJlWDS>FjtHH$KFm&5@v2%+He$^S@
zhC4<8s`NOfwBd!I0HjMb#&~Vh4VXVYvyq{`W34Q}SvIc#g!44Az4zxxV9+gpiR9s8
z`>(5m6+5v*Dcn23(YSKM`a5~gWoH7kgQHjEW_Pfb&W{vE746t1hrxxLU5?P-=h|1|
zB(aT)^&hY8_4O+!id_%+8>v-m7^0KX;4>N90`#k~5I3K{!-99t1~(oqyM3|-d5^B(
zjleS*+14h{SCseIWxC$mx(bOVIPs<9PRB<#dDufNzcD%W(%)<$-rZ6B1A?E=K?P@N
zSop8a=(!_azQMaKJN@woMgjQW%{#lx!^@m4hhxM+MUS5RWe~?cNBsY5?<@bJ{Jv-(
zQo<pnkx)WW8bPHI5hN85q>=6p=|-eM5u`)9!yyEuL1I9<o1wdL;GX&ZKKDPkFE6k4
znVIvPv(MgZueEmaPuChTHM<CZbRGmMPL`4Xfmg>1jEe>El(B;9(3&5x9=BA2m}iBD
z!MfD)s5x5OC833jH3|!#CX8f~&U*lrZ#kbdXa^0B$uEO)uIY!?W`)nz=aaN=URi;N
z?0tQdSL8IFuD37hG{hD7ZZzITP@sK+dYD99Q|yt~92)Rr9%Ot=H{qIBBEPHoLBBMJ
zP%8*w^fxtt5(-mWS29?{ql=j_Q<Z|kG8}~o7psJGr;Mx=_X$>?Jsri%FtWGZDVsj+
zuxXj7`)zD@$utg<gPUhPl0&`M$k<<~3#B8Tn6&1mqbR~08<IvPrpVg-L~b<r)zA?$
zJcl@8DZ-wKipZ?v^1_ID%0)65#C@pTy_g#W!et^ootS=s*ksI?E!*c4uJM3<@`$J*
z1E)Y5x*K0tlSc=Jc#+DStfj&HSju#6oC5BS-_YYw$xbs}68Q^ctuct7_Bguu*dY5X
z2!t-^KUw4P5R7I)vMB*QXEALwpO12XS2Os9m5(QGy$5?1-rqb^QT^a4rRv}Y*s9q)
zLA%&g*3=G&6AOY)i)E0kT%<4^tr*Gi+&9(kTxgfj!pr7`gevx~sOGgiJ=T`TX1#x}
z@Mjr_9NA$qy#WLeik64YtI3}7*jPY8WK+6R^uGU(X};}ni=XhK(rRu-f%ogYhmyq}
za7&Gut;G;E|Bbotxto_ys3L}N=ss~$D_{3tGjUSalug4M#z&jVuAEv_w#VUP*OnDe
zjxGj%d$(;QG+rZtSoQK-{|77ALV&K)v=)5it`+s&vAAKc@<~>dBEg3pr-Sb^b6iC*
zK$dU)ukPnDqBuwrA}cXb{{HSp)5dhk<7TK)UP#U5g?;YaT{(5hLTbsSI>nPyGZV?@
zsaaRv23S_gfjGR4+Rma!K4*7{?S|JIQ(@UN_kXblC$0V$+OQ07obpidEMIwH<C%}h
z|ISW?rv^DZ2NlSgfvI;)=^?ra;;FDUW+eSWanxmo&`;Vv{#}~f{)IXw$Xk8U+&lcU
z@}Jd)WmJh%xNo}zuue4o<LN--R`k@Rs<#ew0^QyfDel@Tk+Nl|W>5vx>T}WrB>y_a
z{AkS*Iy@p6B$RsUO}E7Ts^UO*sqPwy&Hboj^k(L)nY+HVkWR^%O4fSc?WzQDw7N4y
z8d)PcnK_z3FFp)Fk_*-`j`O%@RAujO;H(e{>!_!HpY@$~ZFkLv>Lo{_`+B{oA^wjI
zby_w#oAu(w?tB0x^6v`=lLsbAa&X@(C~eQ{{wk1h(h)VFb+U?2{&n{os^o092pfMl
z;xGX@7J_$nukvPfiMUXUY$3lqdwzz&b?F#ha-(_Bj?5vAwI@Hf)Ajtr87v_Mz}UEV
z8T`F+w=>)Jis-*=^PcfvzVlamMnCW<?U;z|pVP3~RqybEnWyWj-h87DN`9&Exd(#R
z_OR{&^~kOhj0=ze8L$VRRl;k|pKhRjJG?d8?bDxr|Lykl)!{#7xl+BPoxWfE1#-vw
zg5iW!syq7FPX#{gdp)=y6qkjaB_0Q^&Rvs2WWR0jOne1}u-hyr{T7y3Faxe?4qKmH
zlss7aHWDJ-nRvF-8yCB)CxXco8bO$;opqV*Ijg9o%#rBYmH+W*i&*MhMC9wVMxnAG
zc7X(xdVf}t<m6TlJQAE-IBVdPK83u`pwjM{TPq5oP_PuNH!7nxe2#!q`u3P~kY>F+
zzs*7vZ}En=|Iyby?$-)>_}?SXB;CYQ_M_lgkc7StHD`mZ<&^n;Hev2^>5;o;^YM#4
z&EQ2|oYZ^H63A}QFA_NWInc2G1VLwGJyGUw%o}uy3Iwy<*!cn9yzYmk>rUW88flfN
z8)rRj;#@27BEQTs<;&+jU-xNb69TGxUw@*(;1n&?FVrpd5`Wt`7(R7dsKq)0_I>tD
zMxLXY>(}-=5jKR2jAC8vt)vyABI*A1k0W|hzGCF##Eq>YetLGf1eLP~z}Q|~X@`ri
zpbRv4a`~KWkZI`FKbXAtEYG?;&)-WFsXV@%?`v4e5NJ=x+&R4OU{3YI73-^A+sjyd
z20DzCZA0%K7jY__*!}i~Be~TE{;hqT!R=OG&&>LT08>kTh^4<b&Em@O_jBUH)O%fb
zoL{3q^R9AXu!N&-$70dgv_9AC1S#_;l5%9fUS3(7S$;?s1M1RISI0K9uL=4*ML7De
zT{{|$BfJb=s9wcsg=Pj(&|Q`&^p7B~M=a$cL|~Mfe-xiB*Z*$tFLxEHspwLjb!is&
zqPjXdSElp%B~qY1>~YfUuyUrVTK4b#Otd6);I5`!2)Y|35&_BcGul(Al`3|)a#_E5
zXkK-rMf?35VyI_Omt<?F%*42(@nwe_;kUyqGp&fN@7H5h$S<KT3_*wr%|!CD5BhVY
zEVSSHpH%~lHOqOTf4W4=Bkg_Kg%`U+!y?h=YveGi_iJ_arnKhk<H!w{nwAT6ZKY&O
z2meUaa_rFR5g8!ZE;QfyWWy`2vE+y@Zci&)jZoSaAO-cz&^~Q$y3r_E(@)4Tcbd09
zm7do^w?L$hNmc;JLDv^D`u@If8|A}0cDO3)7zrH&GDofr6k?b1pV9mr>@8iRJ~us;
zLMXgoE$73E`GR$X#ejagj<^5k_dI<jKjL3+&A7ChL3RNAc72KAr%}VQ+=bhU)TC%G
z@YehfG>p*%C)HS_E^~!7vp8r_Fz8B+oIW7+PI*+g*~&7D_!=P&&3c8~Tb><}E6WNs
zyuMb$r<`d`b|cqfCGo>DT9(`6>^$N{?l8N;!4zecAO5iP<(u!P94|2+3d|yJJbnaT
zr6vD<H1#8&LV0z0|0+r~Shuf9yrO{*VoCO%TO6Q-sL4H3PlLUO_+$iesN-l|5VJ7J
z54^XM`A6*Nxp!RXJ@wOWde#sx<?;bPU3j_p<<mbW;s~W0-`JeD7X7-u&wow_*LV3T
z@!H2X(B5fNnd0AT_WEb;P#n!l#}hi+AZY9=+OWHo*=bdm;o_?A%6?M2F+Ml8v`mGv
zBdsE2Kaptk4762&ySY_-5YN@d9%8Rz&)+&4zgAMF_Y(q)bS=_sYc4{lg1=v){}Lcq
zFw1BX9OXun+>CfozW+KPPF#N)k{ooZzBg@e`wT`WV^LCDep41mv0SHQpeyHizMU(?
zPIGTS;lf0Y=W2q^N>py|V0IJf-BvzT;eQe?RM_M`i<(IhP`|5`cq-`Zgt@%qk=4+Y
z*MI}MG_b|P_8@Y^+Nt(<ND(Ev_YddZ#2)IZitgQc23{^ZkBqH-HWSp|rF;LJLtm%F
zr+Lvwd51Ks^^S8TsRU9<B;F$ljPz^X*?jsgUJ(B-u77F6bbK`H;Nf+Z>yW5ZXbl;D
zbF@F$$e`V|BJhgRNGo7D$^L@~AIDnwg_W=nD<;>cxoI!BVJ^X$`r#0<51WwT-mNV#
zbkH3jXT|v9c95Sy)wmc;AGJAZS#@$4xyEm(Od<VS@94`$fD#wxI{gK@beBeDEf@<1
z5jh{G4szL#1?~n_5vKeYhNZCL_#bTnsmg2y3L#55x-Q6k8+|^eCu8vXLDTM}*VN&o
z>E=Qd`(@HfipOQgKTwlmLs4&dE@?>dp!O_^e2vCSEuQn*cUtEBETMQH2J3)ry_B?|
zN=b<j42#4E1JMN^>sI(51;|+}{HvcF7-`3R2WA&cDebQ0y?)f6tbeaw5wBtKXc!jO
zB0O6d|L1ya=~i8O&^!41`_Qiq$sO@<j-AgCbk9i>UcudxI=UGzw0U-FQn*sbZ^(2{
zL6V&c!&&KAkg*u=lFSXy=BD9C6t@Xty~{uGaOn3lRpCIucrJ7}6Th!z>)&=Q(3`Kb
zBQp|@=$hP8;6_kRiLca=*9+k=$aUcRS@Zr~n}8tF%JCW({lMumU>9&8hVjJVlg?nt
zuq7TD7<<O8<7=NA*MA;NM~-{>0`Q;z^wp$#@&$}znO)7pu#mfcPOe>lH+;o(<F3*j
ze!id7w~t+uRns~eck3kcsFhm>AavpBm+gv`FT$nMWs)ClZE9f*7{=esA{ykSAt-y}
zR3v#?<0@H#lYoTRsIM!ao!M^yf4L`;<!pg1sZ7h)=WKpHsrmX$7<GM@%0Az+C!`O6
zNuCe6|Mw~ZQTCzG6ZJ2#b~FNTlL(#tdU(x5_fbf-pn(=C+db%4Cj%Xj6H!n3wK#q1
z5O4QK9vk2D8}KjJuZ>?|n7LE_$Q;dRy|DqcGo4}V*k{5k#PicFx(RhbRagHi??&wc
zW}2cAYV-`*j2jxz&mME#<a6aZ9<YNHVYeVi!Z`##P5;luHH$<Pi3HN$*Iu3^7)B@6
zyFJaXPY+8uOS}6;&sI8DAQe5@TJ2ce%x~)J$s3;qESiETGtH0b0l6VqzYijG@0fld
zfG(eC?LR(5@2}}2K8$;&jLDpmOW?6mKJ2p}$}4V)8xIcQ*aPffV3IT7>7{#A8pzZd
z*`qNjHt9$&8}ZZ1l{<jzsz;T7y-xF<G$&4!alYoJd8a9w%N?)%7j?jXt0bvLB=Wgr
zO%Ar+Z&?{w8u3oAS`S^_z^($Pr|xA9``>Df-G*1uFdY2Pr~2F{mJ)vg`pOYF`h;X)
z^562zmv81OcMST#F#>D9VWt+^?Dr&>ncSG@pH0%CAZuR!BD7!s9)GvGW4W~D3k?&V
zr-R;Q#!s~hWZ15!?j6WGoWosg1#{sk*Z54pm$JiP(PgXSs|qn7`#MGS($iH+vKmZ0
z@)wc(nY4e8j=G`eOq{(|8K^cDRCwEN4HnM-!A2ie6U2aaoNDM3dQ3>PcXX{Z#2@GH
zZyZB^k6u6-;3lRG(Jc`x&<9r>Nxs^Soi^rzG*_QXSEr%xoDzAEC;Q7@@8V_)`<Ckz
zyW58qdZ33K+J#G}SLU`?D8W%M<2tX5UU##^X|F*B|3{b+bm091Mire1?_O`rHvU;V
z6;p&qogVgq!f#AYKaF1iR>E({h&2Y=F8Usxli@JH@87#ab1Rsd4YE$t!F2#+s-rR4
z_v%*Hmvz?SVsT^KD%4f^Li(@bawW<x8rF)bPLQ-l(QwWr%YwQ7SorA!LLQ9&P42Q*
zp=k<eBez>prQm20XYJZ{uzV>Le(Z<o-l8a}T-3asYlRaw3~O)o+lZ2G_eSU%tOf{T
z*stscu<zAATzb<s!!PZ^09g4<e>bd!B)4)iU-nB2!nzh_jLz!3f#{d=?%;dVpbahs
zY!t$59~A;6KG0~Z5Fd4b`v_t~9tjPGy^h$TEhTLlGr8_%&5G*2MEX-Iqg%6^JK<E<
zA0_)rxr6oAtLzX~zq;;w(NB`%Dky(QQgM?^My1K`c@nMsF*G}D!gl*Wl%k(WCTH@2
z+bb&1aS_M~{<KZ87Ai(l`RvSc5$L8aEi%^n*q!l}Bd2rWg9Zv`yKl~}?kBf!)n=xR
z&k447Em{gSl@XFfLeH~XFC&#29{<KxXu7FOUB5<_`%-O~RX>o^TmPNp@q`|XBN(ss
zz`e@4&Od$gkfizF5@tQsy&_l`)>YBfoa*BAsfn*p)PASW?IO#6j4WL`JDp!G`Nxjr
zsibb|epVYq%#biGx7s4@rzX8fUp02Vzn*5$o~@kz^Z}Mm-2ch9igT{3Rchf;1a488
z_l`E1KWN#u7WZ-8Y1iNPbW8Ctl%4g~^_&mgJ#xtWSa(TPSoJmldS3Jo>)jqN4S27A
zj_?}zUWAI{!&qb`P6Csqy4?ciiWW7~S9l2}Do?nq**zS##6oTgI7_G^tX~sN#$@`i
zwoXM3*FKMWbt2FBN+1cJMG5}lMY9i=q<6~jKw0vpVt3R%>S0r--2rM!OnnMumcgDw
zPu)k{A&k`bT9gKu;LPfhB--KBnavy@w~OP-N#KdSH-vTdwE&iEYn@`nVeNZ8I4u*k
zm3UQ|sjlB`hs-L%+v!&OQPaPNPx6)dymo0_V!N!*cGYMI;UuyeUeT!M{|ptv1G>S;
z%G*-_=@R*4%)s-R<yc%k4u}WvJ(Kq+O|WsooX7Y4U5YFdcL{K|zd=lQXPj+`gk)zJ
zx`LL$cu~K|2eGa_w^O5evQr6fZAN=%n!gJWW<$o;2};Z~z4fkS{!N0HQS~X{-!{+R
z=l_0KzCAD&x&Vc5s3nM}GKQwEIU9x=C?@hR$A#Y=__A1Qx`;6R?j*kRRlm16sSxO(
zEZ+Rj4Hh3IOF<PeHCSh>Ru~2YpLYNFVS~N*454aN(Gs58uAEOznuQ95fvmHHnS$L>
z%V(z42;Bmr6)S$xM$xmpcUvdouFO5xYF)U+{>hFvePUOXta4yYDNu;X#apREnC7uK
zZty>7@(v$H8ornbR!8amC-g2DenCzc-EC7pTzEb7`E1`Z$1mq*FphoGYRxs0E!Rsw
zisqO*Wf3H!?|2}()wJ0zWpGv_NVejX{r1V0obI5+a}bF7TO=nr+3$(Y7+3LLc37LO
z4ZL5p*+YQDoQ~@^0ZYDnT#R<NI{TEJ!VP~XD@hg4C8zYJV7N_pVui}b2wT`IU5JU|
z@J*&bPfX97uVs<3Ubu>~g$bTIQ%-|xc4XFhPi~_*$EVb5z54+n3ZDos8Ardl&O(7J
zO6N2DL-mR|bQsQK)b)>t+e;~|5tqZGhIt{L!|{>xKd+6ZRehZf$%ph_uyvn^TgBx)
z-|!u{tsEFUM0Hgy68jJgPfA#LqUGwAsBlO`1g(GLT{G%$v3ZPx&-QL>tu`h)Ihe<g
z8`DhRlom}2h`YTn9ZF;unYfm-8}T%!P=6ZBVb_uBZ07!NJiHA49HG&7lsN&ky6Fw4
zXR@x*qVUu4oyLB*<man4Qwr7}W-H?h$?fY=2%F1vUIv+PvakasNq&@9W#h*Dqf;DV
z4=h;`I<ar8w}6<H9G2mYPs^aqW~fk~Je`zVG-5wWi|DX3uG#%9%X9ohJEH}`=a9?#
zY{gO)kWC0j><vI2Lz8vgLa;;EGhQ;oQ*<<*1+(&8T-yZDGVIFnA9<8%Wkc}rO$2(X
zG19KTL^RU7Dx1gabUGTRi*M7L1K8M-?Mm*nRc^ul_$Me#6vMEmF{Ss+CsJxQ*2E}G
z%;SlDBa;=r>1erY=gurizVKrP@BdTYMeSYg9RismyOJFN7B<1|sdF2viuJIlv!6_0
znk1kquiasNj&{M&<{x)m+Ns~B9|`LJq9h3<5-Ue!K27ngiy_e`tQaAqgx|GKN85VV
z-Z2gLrv&%g?MGY~Ow43mJ?Y57o<(MaKrfj521xE^%HuDSf(|T(!*&O1XW+PhQtE2?
zz*Pzi$mY0A=kNT*P0DqCQRqS^B~Q;>jn15IEbU$^*-kRxfD9y#iyNq@wCF?nY&pi#
z5U80QBB2KC{=A+pnZozd!~&o<o679^(&ZcZUu;#2)P`&47o7{KCu6&Sx1vGlf6ZhB
z#`J+Mi3}s~3xK;cQJdTiEt)+Cl1=X`?3OSeMv!O3IDg#m{mCY#c?2@1jDY*|I<?ki
zrEZFDpX(^{uZJ523>UU*eBuKsy=wzEP&%+?{LI)hlUB^D17ywR7Y6eP5RqSC4yAAS
zDe)|;n?%fAd*xktSsf7G_js`cl!*oFz5@)NhYcjd?WoSVu@CQabBmmOEo+RiL3cp^
zprM9t=I*eN<x_}7BkD3eHCQf`9$`}dl(mWJtJW*uW!#z^jahqYj)rmd6Xe`<>)Dx2
zzV-dMeV5#C%N5+Jtad@miMrVCuh_~ST)ZR}2mu3qnNP!9v^z-!KiCUqq&5g%<1fw&
z57Pnc>YR}rTp9oc*v41;e872b@&5Tv`YDhL${SvuW=I~-jd_|}&DWYxvG#^Ee880f
zZ$0Oa_RUewiztf&`8VR>v|l$@H{<J}XC`ISGWCzR@hM2Moi)ucL<gx8*t;XjF(uiX
zjRc}dWq&1yr!J)0f3~9^?up;?O<(~4j#J;$=V$7V3`rVm&d)DqJCbJ&E)v~}D5z%A
zcWhFdYuwKMDWCcsB{m@!Pr!08IUJ5P(kMK)k6zrmi}zKtyD=-m6z#V1CG3w|=o9df
zl;nf&$;U)$_YLD1UrdD86v=!iTSsK&nv|`FpDNqRDWN$Iy+PPZ-iva-C@8>B2ZmjJ
z4$;qI9ezpy@!-RTTk)`@4jXGDwFY<;ZB_YAF^cbYUg$&25qn5Bm;OXNl#S7G{j)UJ
zFE&iaN1rzgl>rgEf|-0D?Mu<c`zg-gSi%T>mX`x0=u~Q9#UBVg)osofEw~K?#T)z-
zBgYSO3Hm3!Cq*~1W^vf#x=1`)QQbRAnY_XjM!q2PMQ4MarY63IaY7`)!{fQrTM8XA
zB1EP{pHE+^LQKq#V>k4U{#Qb$NB`j;o!jU(Fz<Gz!HW}O>~8pwZ)rsB=N?!RWOQRQ
z(6r&-X%AwXIjBN9uV*`Ee|MK;+L4Q!exBr(ty)mr8z8RZO}MIcq>)mtWt<$f-}e64
zWP(@<Cj*)|^x4N%RHQhf#9WDFq!zTrj(PBL%U3K%X4d7!i_ShhtPYpPx5kbnA9IIB
zG#=N!%yKv@5YI=Mz4@U_IfxaR3Bt?B_DQNRxU6k&sm_Ju9aboAe13J~HSuumO&!VQ
z#n@6n&#-A&nnh1eK`lx3gNj72n<}=CG~a=hybD1Z*=<Pnj>fClF2yo7UL4f=+z-0K
z19g*>t+aTjZ!kw>vlZjy{<H7GPBu{$7F13@yXq2`lTM9`KqAgyemf9)-saI*MR9hC
zW~>GOetdqK<?-d=+JnBbotc0AA%kh_W^uP9F)`Pv!KiHl5P7<6&fz!HEoK7x#?yUB
zVbFCTV+Df!S2%3>lNlRJPXpM579UK_#b|!qo%xESSs4KKAYlWo)24rB3(C2S_R(st
ziQNZE%pMuMw=vgK+=UIPhLK~g9D+d!GeLv#<8e=c(+!AmRVIMfY;pq^WKX9-(i9Lv
zEV2w&>H4Z7W&{8fHVKO*OrH%hqMt>)DzInp|Mge)Rw!V%`8e5GoW&#3W)i6D8h9{a
zg4nNyup<2xZK+sS=BkCfUpf93<5l`4ug01yrux6vC%6ro-E-4gUXNw0f)GRHynjUJ
z`Kfj+x+@FcYbgJm4M->ojl(A-3ee>K02!!!-0>Crqv$6NFk3l=-SIz!Y0vDL-QIjK
zjrhea!O&5TZ<bMcfSmfP7}k>wbVN^Dyj$on(~^0Z*fMx|eFl3v*p$<RF8Yf>G1E0n
zC;MNZQ>tma;h_BCWWeqEtnPChVLGBjw1obnYTLC(1yeyX==%cVzq-8b4W?)2wLk7#
zJ{cqNgsJGA(`S}W5Q_p(K<Jw_<9-c2k^do)2O1inzd*X7BzCh|uN%%s$yRsbAQ2IP
zq6uG?HAPSeHP^w9?cOL$iKCqw-rOk7xV_Aw0CC|Ch5(yPWP$?Gzz<#fd-0~#)LkxM
zq9Q20pVhQ3Op4dC0zDeZLyDu0x|&qgJT;Hx1;LdX?aL*iT+f#C5Rk>L)B(R2EypJ`
z(U$UXZooe^k+yA<9KR45@aypr564`Ik<n>!_>vs7%c)WlT`#e^`zcYVd5&x}`7tUr
z0_?}n5N&*Xy!PbIYr7RVE$rUUjIs8SN3-mg>7+IGfh}e`bW_i2Eu@p2KWRSI{q?ho
z`2{UY;?J(x;QcdiJS*{E3#WBfzKEBccl?||m9F{n$y-mg=HrU8VR$HhvQAzRZKFy0
zqd$B;gn-ku1Yj&y38jB-JNG^H*5rRV1H1pPU~Qc9$oppKjwcoZkbpS*IZ<CI$zzug
ztPe0kWi$QTvRymDRJ4K_r{~V+T7gsJieVU+PK82z`eV5N>#Pq4QE5=y|IBfA|5@6`
zQdPi)L|=fg9`MqUG<adDyfe?sIc_A5RG#M@*H*BFWWnTR<u#6H))Q(KlFn@mh`kHG
z;isJTj_P!(fA!uNiKRNb6|mz_O;uxe<J)<)-6aIxgA8<n+ZCC%BQu_Cc0w9Ok>rRI
zP|UlxbQLzwvA8oR>}gJsWDsKyCQ^IabJO&Qow59<HjZ*miHbK1P+tBsd}>DYZachQ
z0YV|DDO!%)+iAqo*JOEitO=nU0JfMBK6)MTMbx6V?ea&iw~|}e%~-Fv+c>?Jngus@
zs9h3|<<l4;nScrn_WG9`PqdQ0=_`v0PLR0xw{6?6`*$+oW$==gQnpUSOZ4Dp&*ky?
zL-h?|T3(_*<2T{CH#FHy?hM=reohSFgnx~cwAiRMJIN6pK9iy=Opl>U<7HHE<>kEF
z6;hpfi#Bi{JJD~lKxx3$ckB>-&(a9NW3?h8hLlY}Mb*hO6VNyJE&K_c$c?dYgCyc8
z5nJIS#%~^wfp)X$e$>>z+yJ5fo<xW!KzKibtuUc@pRjVh{1)v~a_}~#BG>kqOai`d
zfsP_RmR;mUSkpKbr;*GJKklLr<>^mKMtRU~yh{4-3wK`uD2p0}NTRaMl_iNRc1XVP
zcCy<@@U#vex|->UwTa&ydF7$f;@?x=@?#|um2#Hb7PjIN_Fl7b5pK0yn`cfY3b6fb
z#@Pm<k?TH(w*qoa1gfME5B6oc(=yMeCX;pnuhb^*DbvpqZ|fE=Z1%?KZ26ldCi}R#
z*ZpOh6a6}+sbh&*LL-1AtK_I+>_e@O_A-1g`q2ub8?iI|=2;8*@v*q_7tenU=@mdP
z-3%rJR`59RI&|7&U_xyMmOO5sOLKqo@1!$~a*sA;2H-qgWGE^%H3FVD;jlEJ?MfP?
z&ojpfEY9CF=nr#tOX)9x(Z%%4Obt(iac51aYwfFwD3>LbuKFdp8~&)}+*Domi@B;m
z0y;uAg|fn~V)#S~Hgq|%<4c5nu@YeZL<_tEOPa6K%{@0YjaoMQBA?sw@={kduAV+g
zf7=q{87evm!%&ihA}gH8i)E%h>N8KfU#~8;&a@ow<V(?LG*sBNAsxn(C(6qN2JFMG
z&FBg8Qg2MK%<iYxe}`%G#w`bzNKdEFx^;PRrC?+zgXLu}Mm}Y4wiPSXpQ1czss*h}
zRX==(;Q@cqGeJQwqE<Px5HY4Dc?l>I5S)#+P4k`~`@e=q8Tr;X9!`&4oH$u2!%eWS
zwD)H5p5LM~m4XY4rdxj736B*E^%=T}(8x`N(GlcI4j#-nG_yi}VivI`>hzoMXw6?n
z=zr8~9;qHD)j#JO&Ui$-Y(G=YU%?+$Ilf+3tl41zj)kjbwXu8W=G%uJr_a3Ytbj<1
z&lUlEl!ngqMN_Vik3%d~QdU?$d$$7S%JUn4h5ngjw04De<5V0D>N@5#_j%v3Cd1}V
z3OX~&Bv&P>1{D=BQi247v#!8gdFn9Vr@$5w*3|SC<?}d@shdh@$GU9RF6^Hca4G+t
z559npQRyeyTkxKUgtI1*dA<)nBRAol{3SrNsW<ZhiCG(ny!CSaTb%ph0eG!n?JxQ9
zkr=ak8zIh9bcTtgj>@@tbZ<h3j>VC^L!V)wl4}!+d!85X0p@NTD|T$N?L0)JWeZ}C
zGS15L)?3W0-BI`wqB`_<=kw2bs_eBn_R&3B%-b6#9WpBTEDK6)E9PO}UEt43%=&K0
zP3Mep1)(1Qra>>$sqyz|ex<C%-EkqCTrX8j3i$g)X1d=l`n-!*tWQI$ltX0x2u38J
zN{*({8n+w%Mw`NHH)&6{bAcYhJ>WRT1qKO@w|w@#?Y$;t_F^Fg_6JN@xGmK&{S#vl
zmXy)<d(!*y)nAL!cgfrXs|@3>BcmRUV1l8&WOwu@YX>>W2B{*&?ovJH-%6q1MP3M<
zXn1xl?AwO^hchXB-9EEsrSY#`)C}Zzu!yekY^pgAC-u-i>SVBP<?;B^vyS4X@>LmK
zd1nt4m1_34cg@$Wm0jiO8Tq<pt#+q|2{EDd>FmqD+|N5vqDq7*%7+<0s~2hNSY<ib
zvK@-EGpm%$8JSZQ)tk;=ob>cp&Dpj3J8!*S#YbMC<5uS%m-7M88zWswp{dO^+H3y&
za--TeF2@mt7{{NuTy0ACSg<r+QI(tEH2#z(IysT5>v<UkL6@iEz@ZKBFv;Q#F_Fvd
zD2ID|hSZ8?&SEY?WM1#?IV%xgRn^<JA%*#Z9B}{ozdk_=H~siYB#esDy7%c9BSsh=
z+miVYJ5z5bmnlyN9sG}7(9Dg$N>kA6vSXocfA8$bF2bkKzup3w#iXAbK<MPVM1%oR
zw+o%fpJf-;ed4ee8~86XTKuT>CWc`4J5eLDS7F)m#8*3@@1x2UVhJ$&M-r9W`XAw^
z4riGNXaaX0nRiyC8caK3*1m5)R&q!%uKRUr;(VYK!O(O3N=P<lx!#X9h)6T1mZ2i}
zD^ibtAHd^I&VQc$6O%8`*!ArGYsN(pfJr3^@nk$aDY~l~V<@%$6bm_CSGsts=5M9h
zua&uy5Djy?c}nFe#|gTf-0bw;8;jz1bQPlSNEn4yMYwM&=QWNhME8DnMY!_f-2}-X
z1@Hwlo3w0xvPd;9`(~d#ij$ZMMj!+XAVTl^xW6?g{SKl?Q`bW{WJ&Lrl$YL*vFjMt
zwvCsO1IcZ}lZQYk>?wFy(dhR+vzMl9U%_Sf2q;}3+*1J8Z@6$$DSM<l;0|<EU^vG@
z&mYZ%d{_)RhGYNjIk8;W#%#yl`x@9Z30+E!U>v{4#m~{L(aUi3obVu7p#uBE($4CD
z*SoAcB?ZKdX069A|M9Mw>}421v=N;pfqoA%jB%CJ#`I7hHC;6pUekXXPn2Hx2W;IQ
z^DAm3BiV8y-8qF0xTu9S3f{!HzK=Y^@ON@myyxdLYsj=Cry}OnR6&?>lQM$IUg=Lj
z6!De!ZzB$4Hwj{E?#~yK(Bb~Z@=2HOum2>dBD6cz-tjvKBL2HR<?N1XrEQt0x{m|c
zo0!5|uNUG(7mM;y4B~~{JM}74Tz+0#lQ=PEhpzDtH_Y!U33;aZkmNt4p?g|XO;!Kx
zuRrAA(O8M~2^0LtwQv1du=MHTzxSLfM{bIN)S=}lFl$eK!+hd#>S=&{5;0W_UJCC6
z{orMB$T+bpRi$odwy$)W`L3+Jm7b3`&Fh9sB02^BhqL1Fusl&!juW=z@Y(W<@qOe&
zJVfJHN+f+!TtSxi5E+vZh)IG-)137x&G5&EsF0k#Ey=1zl?V0ZA8+0_P&Z*2^50wA
z^&^F#7&&gK4O<@XVa3<t#oTgm<*5*hLh&i5KM91nM^AZYOAz~1QMmn$1d&-ywN8GV
zSQy6W7q-T<AD#x$EMKOR*Iq0b{x0^X#Ck%wC{WeN!&CS}LSYCPT=MM84l4YO&@5>D
zJ@uF?@q`k-jwyl5ixIgT%v@Bor|FQFV)<gMEzE*qIL`j>aJ2}`hiFEgx8ZJ*r7l`Z
z{C36sx3zKs73OlIFEwAod~-3vKJia$&o)B#jo<Biew`EUr#+f}#k{#S@Dn`%w`lFc
z(SQrf2QG!V`8~yG*XORx?3(tOj?@q6JS)bhsau141r_vEj41W6`)0-6N%<P6Lh1+<
zy05pJJaxz<uq1Hn`aeBulW6uJAD*?JdTE<`HTL`ZFz2q4^0ZJev&-3!?GSEtU)Mbg
z4+<RHtjqo8jexDT@mu)iy7Py{+s#kiTqO?|*QP=ZGf-!3-$Lms<(}4UZ}J&uUe#6W
zrx-TR4fi2%AP}A+wtHG`{jucc%X2F-%)5JSYq#~USDduU>cyf^tDsS9{Ko9Qlwx!l
zt3C7KVpth0UjL$MKd(FF4>xXt=Z53?O^6>&4~4UcTjnGgB(a8VYpCP5P9HK-hTX8%
zz4bS;n7D4?QU!jUt>4^qy_e=Li1MK0H=Bh988OWxqK7{GP0Lj8FBJ`|Lt5UkHg{`l
z(!0ZS&(P0HVQ<G!$LpBoGO_uQ#2EFN2n2Pr+;>J{{mv)K+wm`E2CHr^<*`Wg!tB1O
z=k?`0ZK&P+w3nN9-Y-SZ!(aCxzx4tQ^vozoqLf79K9$b8H9;k(f1R6vvsfWKc4iac
z70H&)st`2vmMsH=spt#PWl$$M3gPqpAve$wm|1oAx=BfPK2?|%>-&cMw?XKXzNdy9
ziy}^s{@&Q+^y+yFjz%vt<kwBDEJgxJuq6e}?BGEbYcv-^7<`}b%_AadFQ)Rpu*xjv
zRIw{wMbD-k<$YiCuyRYhQL>}GZ2b>-JxqWg8PhLeL{RtRWfYxuB?jcT%!3hGaRCh7
zN<V}U1St>iI19q)o@=zpA+3aaZU0Ud!)31FXpi4dhGeu7&#7Z`=Xt3b+#C`Md2=7)
zFWEkvxhiuD$Ar4+1(~t^9wcT#H0{{npxmXy+XFPX5}B+Gjh~rSxQ8{c)U7t9=U5UU
zGifg2rrf}u$xNR!K_Np(^lP-ubCoankFaqt3D9fUO$y%D*DZ}}0N$>I`LMM;rF~u&
z&F(Dt!S(AjJ_gHIQLf8dmDi`20~J8}=gZL4xTJUUAF1IVg|abd^<w|~O#-&Hpo7;f
zzafXmFWJx;<Uq-e+Ud^$c+R}-Dt^$ws{(@IQHU(BVaU?n^LlC+^v+Y!uChP5f1U}>
z&&Eh)S_39dAuCOGKpwp+22<b{MLY}xV|w{mbx^Y5jh9$s#dz?n+RzJ!2`vuNKykK(
zOuhW+H{SVC$T^uJm$P1m@bJY7cY2Du9O%4_Y*ZeG{&Al`9AV3)@>84P9)F{S*B7w2
zv0HcQ{75d7p8_Dl4+@#ix+|WZekMZ1hd@we;RDF;4Fyg&6Q(&!>ok7aConzsAryn<
z@XopRPfW)0JSF;}5~c27lG5J}S@{nuxmn24y%Dpr9i1;q_RJ)8$W4CZJ9_pFLN+j{
zJF%;VEcFLO5_?6j8Y`(Ffd%=I-z{0609`41SrwY<tTx;UI70Wzb3U0B6Z&hSZ|vX0
z27T%*7R{Za+71p@SQNo{8u)qfH!+i;f;^jn?T%d}$iyGna%hdH&4yIuT?gA+PHF%2
zH3Nf_z+WBM4EDJ9UqdkH)p2gt*6ui32gZ5lT}}og-4jB~ZC-vJaXQ{<r}3LHu&;>}
zDB7;Tn9}=?oY^z{6`1{SAtn=%p#&Cb?ue%0D;!AT19hx!1JjhsP$k(qa6jk@kyuUR
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
YR+h}0xVcLudGvGTUMfkKN*M(FAC-Ab(f|Me

literal 0
HcmV?d00001

diff --git a/logo/rust-doge.svg b/logo/rust-doge.svg
new file mode 100644
index 000000000..e5c9666a3
--- /dev/null
+++ b/logo/rust-doge.svg
@@ -0,0 +1,16 @@
+<svg width="150" height="150" viewBox="0 0 150 150" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_7_51)">
+<g clip-path="url(#clip1_7_51)">
+<path d="M70.3066 120.997C76.563 120.997 118 122.296 118 74.2457C118 25.4695 74.797 29.0219 74.6758 29.032H43.8623V69.9957H33V80.0309H43.8613V114L49 120.997H70.3066ZM61.2168 80.0309H80.3428V69.9967H61.2168V46.0319H73.9697C77.2476 46.0319 100.869 45.6624 100.832 73.9147C100.795 102.167 77.9214 103.999 73.374 103.999H61.2168V80.0309Z" fill="#B9A032"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M75 0C75.7527 0 76.4501 0.395296 76.8373 1.04074L80.6376 7.37444C81.3166 7.43029 81.9928 7.49546 82.666 7.57115L87.627 2.10379C88.1327 1.54633 88.8935 1.29431 89.6317 1.44113C90.3699 1.58797 90.9766 2.11228 91.2305 2.82087L93.7151 9.75726C94.3744 9.94602 95.0285 10.1477 95.6794 10.3557L101.606 5.9668C102.21 5.51902 103.006 5.42083 103.701 5.70871C104.396 5.99667 104.889 6.62883 105 7.37305L106.085 14.668C106.692 14.9812 107.292 15.3054 107.888 15.6362L114.562 12.4847C115.242 12.1632 116.041 12.2217 116.667 12.6395C117.293 13.0577 117.654 13.7739 117.617 14.5257L117.257 21.9071C117.786 22.3287 118.308 22.7592 118.824 23.1962L125.998 21.4035C126.728 21.2209 127.501 21.4348 128.033 21.9671C128.565 22.4993 128.779 23.2723 128.597 24.0025L126.802 31.1747C127.239 31.6907 127.67 32.2123 128.092 32.7414L135.474 32.3828C136.226 32.3463 136.942 32.7071 137.361 33.3329C137.778 33.9586 137.837 34.7577 137.515 35.4381L134.362 42.1108C134.693 42.7066 135.017 43.3066 135.331 43.9132L142.627 45C143.371 45.111 144.003 45.6036 144.291 46.2988C144.579 46.994 144.481 47.7896 144.033 48.3943L139.643 54.3192C139.851 54.9701 140.053 55.6242 140.241 56.2835L147.179 58.7695C147.888 59.0234 148.412 59.6301 148.559 60.3683C148.706 61.1065 148.454 61.8673 147.896 62.3731L142.427 67.3326C142.503 68.0058 142.568 68.682 142.624 69.3611L148.959 73.1627C149.605 73.5499 150 74.2473 150 75C150 75.7527 149.605 76.4501 148.959 76.8373L142.624 80.6376C142.568 81.3166 142.503 81.9928 142.427 82.666L147.896 87.627C148.454 88.1327 148.706 88.8935 148.559 89.6317C148.412 90.3699 147.888 90.9766 147.179 91.2305L140.241 93.7151C140.053 94.3744 139.851 95.0285 139.643 95.6794L144.033 101.606C144.481 102.21 144.579 103.006 144.291 103.701C144.003 104.396 143.371 104.889 142.627 105L135.331 106.085C135.017 106.692 134.693 107.292 134.362 107.888L137.515 114.562C137.837 115.242 137.778 116.041 137.361 116.667C136.942 117.293 136.226 117.654 135.474 117.617L128.092 117.257C127.67 117.786 127.239 118.308 126.802 118.824L128.597 125.998C128.779 126.728 128.565 127.501 128.033 128.033C127.501 128.565 126.728 128.779 125.998 128.597L118.824 126.802C118.308 127.239 117.786 127.67 117.257 128.092L117.617 135.474C117.654 136.226 117.293 136.942 116.667 137.361C116.041 137.778 115.242 137.837 114.562 137.515L107.888 134.362C107.292 134.693 106.692 135.017 106.085 135.331L105 142.627C104.889 143.371 104.396 144.003 103.701 144.291C103.006 144.579 102.21 144.481 101.606 144.033L95.6794 139.643C95.0285 139.851 94.3744 140.053 93.7151 140.241L91.2305 147.179C90.9766 147.888 90.3699 148.412 89.6317 148.559C88.8935 148.706 88.1327 148.454 87.627 147.896L82.666 142.427C81.9928 142.503 81.3166 142.568 80.6376 142.624L76.8373 148.959C76.4501 149.605 75.7527 150 75 150C74.2473 150 73.5499 149.605 73.1627 148.959L69.3611 142.624C68.682 142.568 68.0058 142.503 67.3326 142.427L62.3731 147.896C61.8673 148.454 61.1065 148.706 60.3683 148.559C59.6301 148.412 59.0234 147.888 58.7695 147.179L56.2835 140.241C55.6242 140.053 54.9701 139.851 54.3192 139.643L48.3943 144.033C47.7896 144.481 46.994 144.579 46.2988 144.291C45.6036 144.003 45.111 143.371 45 142.627L43.9132 135.331C43.3066 135.017 42.7066 134.693 42.1108 134.362L35.4381 137.515C34.7577 137.837 33.9586 137.778 33.3329 137.361C32.7071 136.942 32.3463 136.226 32.3828 135.474L32.7414 128.092C32.2123 127.67 31.6907 127.239 31.1747 126.802L24.0025 128.597C23.2723 128.779 22.4993 128.565 21.9671 128.033C21.4348 127.501 21.2209 126.728 21.4035 125.998L23.1962 118.824C22.7592 118.308 22.3287 117.786 21.9071 117.257L14.5257 117.617C13.7739 117.654 13.0577 117.293 12.6395 116.667C12.2217 116.041 12.1632 115.242 12.4847 114.562L15.6362 107.888C15.3054 107.292 14.9812 106.692 14.668 106.085L7.37305 105C6.62883 104.889 5.99667 104.396 5.70871 103.701C5.42083 103.006 5.51902 102.21 5.9668 101.606L10.3557 95.6794C10.1477 95.0285 9.94602 94.3744 9.75726 93.7151L2.82087 91.2305C2.11228 90.9766 1.58797 90.3699 1.44113 89.6317C1.29431 88.8935 1.54633 88.1327 2.10379 87.627L7.57115 82.666C7.49546 81.9928 7.43029 81.3166 7.37444 80.6376L1.04074 76.8373C0.395296 76.4501 0 75.7527 0 75C0 74.2473 0.395296 73.5499 1.04074 73.1627L7.37444 69.3611C7.4303 68.682 7.49544 68.0058 7.57115 67.3326L2.10379 62.3731C1.54633 61.8673 1.29431 61.1065 1.44113 60.3683C1.58797 59.6301 2.11228 59.0234 2.82087 58.7695L9.75726 56.2835C9.94603 55.6242 10.1477 54.9701 10.3557 54.3192L5.9668 48.3943C5.51902 47.7896 5.42083 46.994 5.70871 46.2988C5.99667 45.6036 6.62883 45.111 7.37305 45L14.668 43.9132C14.9812 43.3066 15.3054 42.7066 15.6362 42.1108L12.4847 35.4381C12.1632 34.7577 12.2217 33.9586 12.6395 33.3329C13.0577 32.7071 13.7739 32.3463 14.5257 32.3828L21.9071 32.7414C22.3287 32.2123 22.7592 31.6907 23.1962 31.1747L21.4035 24.0025C21.2209 23.2723 21.4348 22.4993 21.9671 21.9671C22.4993 21.4348 23.2723 21.2209 24.0025 21.4035L31.1747 23.1962C31.6907 22.7592 32.2123 22.3287 32.7414 21.9071L32.3828 14.5257C32.3463 13.7739 32.7071 13.0577 33.3329 12.6395C33.9586 12.2217 34.7577 12.1632 35.4381 12.4847L42.1108 15.6362C42.7066 15.3054 43.3066 14.9812 43.9132 14.668L45 7.37305C45.111 6.62883 45.6036 5.99667 46.2988 5.70871C46.994 5.42083 47.7896 5.51902 48.3943 5.9668L54.3192 10.3557C54.9701 10.1477 55.6242 9.94603 56.2835 9.75726L58.7695 2.82087C59.0234 2.11228 59.6301 1.58797 60.3683 1.44113C61.1065 1.29431 61.8673 1.54633 62.3731 2.10379L67.3326 7.57115C68.0058 7.49544 68.682 7.4303 69.3611 7.37444L73.1627 1.04074C73.5499 0.395296 74.2473 0 75 0ZM78.0301 28.0301C76.3565 29.7038 73.6435 29.7038 71.9699 28.0301L64.8731 20.9333C48.3901 24.0014 34.4915 34.418 26.7076 48.6579L31.2653 57.6032C32.3399 59.7121 31.5019 62.2931 29.3931 63.3678L20.452 67.9227C20.1543 70.2398 20 72.6019 20 75C20 89.6343 25.7171 102.932 35.0377 112.786L44.94 111.218C47.2778 110.848 49.4735 112.443 49.8438 114.781L51.4132 124.696C58.5617 128.095 66.5579 130 75 130C83.4416 130 91.4372 128.094 98.5854 124.696L100.156 114.781C100.527 112.443 102.722 110.848 105.06 111.218L114.961 112.786C124.282 102.932 130 89.6346 130 75C130 72.6019 129.844 70.2399 129.547 67.9227L120.607 63.3678C118.498 62.2931 117.66 59.7121 118.735 57.6032L123.291 48.6579C115.507 34.418 101.609 24.001 85.1256 20.9333L78.0301 28.0301ZM45.6975 119.542C45.3397 117.283 43.2179 115.741 40.9584 116.099C37.314 116.677 36.1874 121.372 39.1727 123.541C42.1581 125.709 46.2745 123.187 45.6975 119.542ZM107.92 116.099C105.66 115.741 103.539 117.283 103.181 119.542C102.604 123.187 106.722 125.71 109.707 123.541C112.692 121.372 111.564 116.677 107.92 116.099ZM25.0056 55.858C23.33 52.5705 18.5161 52.9498 17.3758 56.4593C16.2358 59.9688 19.9082 63.1053 23.1962 61.43C25.2343 60.3914 26.0441 57.8962 25.0056 55.858ZM131.503 56.4593C130.362 52.9498 125.548 52.5705 123.873 55.858C122.834 57.8962 123.644 60.3913 125.682 61.43C128.97 63.1053 132.643 59.9688 131.503 56.4593ZM74.4392 15C70.749 15.0001 68.9015 19.4623 71.5109 22.0717C73.1285 23.6887 75.7515 23.6891 77.3689 22.0717C79.9783 19.4623 78.1294 15 74.4392 15Z" fill="#B9A032"/>
+</g>
+</g>
+<defs>
+<clipPath id="clip0_7_51">
+<rect width="150" height="150" fill="white"/>
+</clipPath>
+<clipPath id="clip1_7_51">
+<rect width="150" height="150" fill="white"/>
+</clipPath>
+</defs>
+</svg>
diff --git a/logo/rust-doge@4x.png b/logo/rust-doge@4x.png
new file mode 100644
index 0000000000000000000000000000000000000000..1d481dd9057f6204387d8443543ec95e1a3e61cd
GIT binary patch
literal 26482
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
KRV`Px3H^WDPhkoG

literal 0
HcmV?d00001


From cf61b2b36bb974d76a91eba5f2cd95c1844718a7 Mon Sep 17 00:00:00 2001
From: mducroux <mathieu.ducroux@dfinity.org>
Date: Tue, 18 Nov 2025 11:16:09 +0100
Subject: [PATCH 53/53] docs: fix docs.rs build (#19)

Following upstream commit
https://github.com/rust-bitcoin/rust-bitcoin/commit/3f3324058941f18032ab9cc5c89815fff21474fd,
the `doc_auto_cfg` feature is removed to fix the docs.rs build.
Additionally, we enable the `doc_notable_trait` feature flag, following
upstream commit
https://github.com/rust-bitcoin/rust-bitcoin/commit/dfb76c1e15933fe0058c1bb69c4b1b9acddceee8
---
 README.md            | 2 +-
 bitcoin/CHANGELOG.md | 5 +++++
 bitcoin/Cargo.toml   | 2 +-
 bitcoin/src/lib.rs   | 2 +-
 4 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index c322c8055..4a0dfc01e 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 <div align="center">
   <h1>Rust Dogecoin</h1>
 
-  <img alt="Rust Dogecoin logo by DFINITY Foundation, see license and source files under /logo" src="./logo/rust-btc+doge@4x.png" width="720" />
+  <img alt="Rust Dogecoin logo by DFINITY Foundation, see license and source files under /logo" src="https://raw.githubusercontent.com/dfinity/rust-dogecoin/doge-master/logo/rust-btc+doge@4x.png" width="720" />
 
   <p>Library with support for de/serialization, parsing and executing on data-structures
     and network messages related to Bitcoin and Dogecoin.
diff --git a/bitcoin/CHANGELOG.md b/bitcoin/CHANGELOG.md
index e2f5b9476..0ce2481f9 100644
--- a/bitcoin/CHANGELOG.md
+++ b/bitcoin/CHANGELOG.md
@@ -12,6 +12,11 @@
 - Backport - Add `XOnlyPublicKey` support for PSBT key retrieval and improve Taproot signing [#4443](https://github.com/rust-bitcoin/rust-bitcoin/pull/4443)
 - Backport - Add methods to retrieve inner types [#4450](https://github.com/rust-bitcoin/rust-bitcoin/pull/4450)
 
+# 0.32.5-doge.1 - 2025-11-10
+
+- Fix build doc on [docs.rs](https://docs.rs/crate/bitcoin-dogecoin/latest)
+- Add rust-dogecoin logo on githubusercontent
+
 # 0.32.5-doge.0 - 2025-11-03
 
 Initial release of the rust-dogecoin crate, a fork of rust-bitcoin adapted for Dogecoin.
diff --git a/bitcoin/Cargo.toml b/bitcoin/Cargo.toml
index e7e985edb..20a6649e7 100644
--- a/bitcoin/Cargo.toml
+++ b/bitcoin/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "bitcoin-dogecoin"
-version = "0.32.5-doge.0"
+version = "0.32.5-doge.1"
 license = "Apache-2.0 OR CC0-1.0"
 repository = "https://github.com/dfinity/rust-dogecoin"
 description = "General purpose library for using and interoperating with Bitcoin and Dogecoin."
diff --git a/bitcoin/src/lib.rs b/bitcoin/src/lib.rs
index a863e435e..a8d7c0584 100644
--- a/bitcoin/src/lib.rs
+++ b/bitcoin/src/lib.rs
@@ -31,7 +31,7 @@
 
 #![cfg_attr(all(not(feature = "std"), not(test)), no_std)]
 // Experimental features we need.
-#![cfg_attr(docsrs, feature(doc_auto_cfg))]
+#![cfg_attr(docsrs, feature(doc_notable_trait))]
 #![cfg_attr(bench, feature(test))]
 // Coding conventions.
 #![warn(missing_docs)]