Unify deprecated note field format

All the deprecated note fields have been changed to be lower case and in
the format "use `a` instead".
This commit is contained in:
Jamil Lambert, PhD 2024-10-15 15:16:01 +01:00
parent da462d67ef
commit 88b53a471e
No known key found for this signature in database
GPG Key ID: 54DC29234AB5D2C0
17 changed files with 46 additions and 59 deletions

View File

@ -28,11 +28,11 @@ const VERSION_BYTES_TESTNETS_PUBLIC: [u8; 4] = [0x04, 0x35, 0x87, 0xCF];
const VERSION_BYTES_TESTNETS_PRIVATE: [u8; 4] = [0x04, 0x35, 0x83, 0x94]; const VERSION_BYTES_TESTNETS_PRIVATE: [u8; 4] = [0x04, 0x35, 0x83, 0x94];
/// The old name for xpub, extended public key. /// The old name for xpub, extended public key.
#[deprecated(since = "0.31.0", note = "use Xpub instead")] #[deprecated(since = "0.31.0", note = "use `Xpub` instead")]
pub type ExtendedPubKey = Xpub; pub type ExtendedPubKey = Xpub;
/// The old name for xpriv, extended public key. /// The old name for xpriv, extended public key.
#[deprecated(since = "0.31.0", note = "use Xpriv instead")] #[deprecated(since = "0.31.0", note = "use `Xpriv` instead")]
pub type ExtendedPrivKey = Xpriv; pub type ExtendedPrivKey = Xpriv;
/// A chain code /// A chain code
@ -592,7 +592,7 @@ impl Xpriv {
} }
/// Constructs ECDSA compressed private key matching internal secret key representation. /// Constructs ECDSA compressed private key matching internal secret key representation.
#[deprecated(since = "TBD", note = "use `to_private_key()`")] #[deprecated(since = "TBD", note = "use `to_private_key()` instead")]
pub fn to_priv(self) -> PrivateKey { self.to_private_key() } pub fn to_priv(self) -> PrivateKey { self.to_private_key() }
/// Constructs ECDSA compressed private key matching internal secret key representation. /// Constructs ECDSA compressed private key matching internal secret key representation.
@ -615,7 +615,7 @@ impl Xpriv {
/// Derives an extended private key from a path. /// Derives an extended private key from a path.
/// ///
/// The `path` argument can be both of type `DerivationPath` or `Vec<ChildNumber>`. /// The `path` argument can be both of type `DerivationPath` or `Vec<ChildNumber>`.
#[deprecated(since = "TBD", note = "use `derive_xpriv()`")] #[deprecated(since = "TBD", note = "use `derive_xpriv()` instead")]
pub fn derive_priv<C: secp256k1::Signing, P: AsRef<[ChildNumber]>>( pub fn derive_priv<C: secp256k1::Signing, P: AsRef<[ChildNumber]>>(
&self, &self,
secp: &Secp256k1<C>, secp: &Secp256k1<C>,
@ -731,7 +731,7 @@ impl Xpriv {
impl Xpub { impl Xpub {
/// Creates extended public key from an extended private key. /// Creates extended public key from an extended private key.
#[deprecated(since = "TBD", note = "use `from_xpriv()`")] #[deprecated(since = "TBD", note = "use `from_xpriv()` instead")]
pub fn from_priv<C: secp256k1::Signing>(secp: &Secp256k1<C>, sk: &Xpriv) -> Xpub { pub fn from_priv<C: secp256k1::Signing>(secp: &Secp256k1<C>, sk: &Xpriv) -> Xpub {
Self::from_xpriv(secp, sk) Self::from_xpriv(secp, sk)
} }
@ -749,7 +749,7 @@ impl Xpub {
} }
/// Constructs ECDSA compressed public key matching internal public key representation. /// Constructs ECDSA compressed public key matching internal public key representation.
#[deprecated(since = "TBD", note = "use `to_public_key()`")] #[deprecated(since = "TBD", note = "use `to_public_key()` instead")]
pub fn to_pub(self) -> CompressedPublicKey { self.to_public_key() } pub fn to_pub(self) -> CompressedPublicKey { self.to_public_key() }
/// Constructs ECDSA compressed public key matching internal public key representation. /// Constructs ECDSA compressed public key matching internal public key representation.
@ -757,7 +757,7 @@ impl Xpub {
/// Constructs BIP340 x-only public key for BIP-340 signatures and Taproot use matching /// Constructs BIP340 x-only public key for BIP-340 signatures and Taproot use matching
/// the internal public key representation. /// the internal public key representation.
#[deprecated(since = "TBD", note = "use `to_x_only_public_key()`")] #[deprecated(since = "TBD", note = "use `to_x_only_public_key()` instead")]
pub fn to_x_only_pub(self) -> XOnlyPublicKey { self.to_x_only_public_key() } pub fn to_x_only_pub(self) -> XOnlyPublicKey { self.to_x_only_public_key() }
/// Constructs BIP340 x-only public key for BIP-340 signatures and Taproot use matching /// Constructs BIP340 x-only public key for BIP-340 signatures and Taproot use matching
@ -767,7 +767,7 @@ impl Xpub {
/// Attempts to derive an extended public key from a path. /// Attempts to derive an extended public key from a path.
/// ///
/// The `path` argument can be any type implementing `AsRef<ChildNumber>`, such as `DerivationPath`, for instance. /// The `path` argument can be any type implementing `AsRef<ChildNumber>`, such as `DerivationPath`, for instance.
#[deprecated(since = "TBD", note = "use `derive_xpub()`")] #[deprecated(since = "TBD", note = "use `derive_xpub()` instead")]
pub fn derive_pub<C: secp256k1::Verification, P: AsRef<[ChildNumber]>>( pub fn derive_pub<C: secp256k1::Verification, P: AsRef<[ChildNumber]>>(
&self, &self,
secp: &Secp256k1<C>, secp: &Secp256k1<C>,

View File

@ -47,10 +47,9 @@ pub const MAX_STACK_ELEMENT_SIZE: usize = 520;
/// How may blocks between halvings. /// How may blocks between halvings.
pub const SUBSIDY_HALVING_INTERVAL: u32 = 210_000; pub const SUBSIDY_HALVING_INTERVAL: u32 = 210_000;
/// Maximum allowed value for an integer in Script. /// Maximum allowed value for an integer in Script.
#[deprecated( /// This constant has ambiguous semantics. Please carefully check your intended use-case and define
since = "TBD", /// a new constant reflecting that.
note = "This constant has ambiguous semantics. Please carefully check your intended use-case and define a new constant reflecting that." #[deprecated(since = "TBD", note = "use a more specific constant instead")]
)]
pub const MAX_SCRIPTNUM_VALUE: u32 = 0x80000000; // 2^31 pub const MAX_SCRIPTNUM_VALUE: u32 = 0x80000000; // 2^31
/// Number of blocks needed for an output from a coinbase transaction to be spendable. /// Number of blocks needed for an output from a coinbase transaction to be spendable.
pub const COINBASE_MATURITY: u32 = 100; pub const COINBASE_MATURITY: u32 = 100;
@ -200,7 +199,7 @@ impl ChainHash {
101, 225, 90, 8, 156, 104, 214, 25, 0, 0, 0, 0, 0, 101, 225, 90, 8, 156, 104, 214, 25, 0, 0, 0, 0, 0,
]); ]);
/// `ChainHash` for testnet3 bitcoin. /// `ChainHash` for testnet3 bitcoin.
#[deprecated(since = "0.33.0", note = "Use TESTNET3 instead")] #[deprecated(since = "0.33.0", note = "use `TESTNET3` instead")]
pub const TESTNET: Self = Self([ pub const TESTNET: Self = Self([
67, 73, 127, 215, 248, 38, 149, 113, 8, 244, 163, 15, 217, 206, 195, 174, 186, 121, 151, 67, 73, 127, 215, 248, 38, 149, 113, 8, 244, 163, 15, 217, 206, 195, 174, 186, 121, 151,
32, 132, 233, 14, 173, 1, 234, 51, 9, 0, 0, 0, 0, 32, 132, 233, 14, 173, 1, 234, 51, 9, 0, 0, 0, 0,

View File

@ -223,10 +223,7 @@ crate::internal_macros::define_extension_trait! {
/// ///
/// This method has potentially confusing semantics and an unclear purpose, so it's going to be /// This method has potentially confusing semantics and an unclear purpose, so it's going to be
/// removed. Use `is_op_return` if you want `OP_RETURN` semantics. /// removed. Use `is_op_return` if you want `OP_RETURN` semantics.
#[deprecated( #[deprecated(since = "0.32.0", note = "use `is_op_return` instead")]
since = "0.32.0",
note = "The method has potentially confusing semantics and is going to be removed, you might want `is_op_return`"
)]
#[inline] #[inline]
fn is_provably_unspendable(&self) -> bool { fn is_provably_unspendable(&self) -> bool {
use crate::opcodes::Class::{IllegalOp, ReturnOp}; use crate::opcodes::Class::{IllegalOp, ReturnOp};
@ -263,7 +260,7 @@ crate::internal_macros::define_extension_trait! {
/// Returns the minimum value an output with this script should have in order to be /// Returns the minimum value an output with this script should have in order to be
/// broadcastable on todays Bitcoin network. /// broadcastable on todays Bitcoin network.
#[deprecated(since = "0.32.0", note = "use minimal_non_dust and friends")] #[deprecated(since = "0.32.0", note = "use `minimal_non_dust` etc. instead")]
fn dust_value(&self) -> crate::Amount { self.minimal_non_dust() } fn dust_value(&self) -> crate::Amount { self.minimal_non_dust() }
/// Returns the minimum value an output with this script should have in order to be /// Returns the minimum value an output with this script should have in order to be
@ -367,7 +364,7 @@ crate::internal_macros::define_extension_trait! {
} }
/// Writes the human-readable assembly representation of the script to the formatter. /// Writes the human-readable assembly representation of the script to the formatter.
#[deprecated(since = "TBD", note = "use the script's Display impl instead")] #[deprecated(since = "TBD", note = "use the script's `Display` impl instead")]
fn fmt_asm(&self, f: &mut dyn fmt::Write) -> fmt::Result { fn fmt_asm(&self, f: &mut dyn fmt::Write) -> fmt::Result {
write!(f, "{}", self) write!(f, "{}", self)
} }

View File

@ -41,7 +41,7 @@ crate::internal_macros::define_extension_trait! {
/// Extension functionality for the [`Txid`] type. /// Extension functionality for the [`Txid`] type.
pub trait TxidExt impl for Txid { pub trait TxidExt impl for Txid {
/// The "all zeros" TXID. /// The "all zeros" TXID.
#[deprecated(since = "TBD", note = "use Txid::COINBASE_PREVOUT instead")] #[deprecated(since = "TBD", note = "use `Txid::COINBASE_PREVOUT` instead")]
fn all_zeros() -> Self { Self::COINBASE_PREVOUT } fn all_zeros() -> Self { Self::COINBASE_PREVOUT }
} }
} }
@ -50,7 +50,7 @@ crate::internal_macros::define_extension_trait! {
/// Extension functionality for the [`Wtxid`] type. /// Extension functionality for the [`Wtxid`] type.
pub trait WtxidExt impl for Wtxid { pub trait WtxidExt impl for Wtxid {
/// The "all zeros" wTXID. /// The "all zeros" wTXID.
#[deprecated(since = "TBD", note = "use Wtxid::COINBASE instead")] #[deprecated(since = "TBD", note = "use `Wtxid::COINBASE` instead")]
fn all_zeros() -> Self { Self::COINBASE } fn all_zeros() -> Self { Self::COINBASE }
} }
} }
@ -83,7 +83,7 @@ crate::internal_macros::define_extension_trait! {
/// Checks if an `OutPoint` is "null". /// Checks if an `OutPoint` is "null".
#[inline] #[inline]
#[deprecated(since = "TBD", note = "use outpoint == OutPoint::COINBASE_PREVOUT instead")] #[deprecated(since = "TBD", note = "use `outpoint == OutPoint::COINBASE_PREVOUT` instead")]
fn is_null(&self) -> bool { *self == OutPoint::COINBASE_PREVOUT } fn is_null(&self) -> bool { *self == OutPoint::COINBASE_PREVOUT }
} }
} }
@ -377,11 +377,9 @@ impl Transaction {
/// Computes a "normalized TXID" which does not include any signatures. /// Computes a "normalized TXID" which does not include any signatures.
/// ///
/// This method is deprecated. Use `compute_ntxid` instead. /// This method is deprecated. `ntxid` has been renamed to `compute_ntxid` to note that it's
#[deprecated( /// computationally expensive. Use `compute_ntxid` instead.
since = "0.31.0", #[deprecated(since = "0.31.0", note = "use `compute_ntxid()` instead")]
note = "ntxid has been renamed to compute_ntxid to note that it's computationally expensive. use compute_ntxid() instead."
)]
pub fn ntxid(&self) -> sha256d::Hash { self.compute_ntxid() } pub fn ntxid(&self) -> sha256d::Hash { self.compute_ntxid() }
/// Computes a "normalized TXID" which does not include any signatures. /// Computes a "normalized TXID" which does not include any signatures.
@ -409,11 +407,9 @@ impl Transaction {
/// Computes the [`Txid`]. /// Computes the [`Txid`].
/// ///
/// This method is deprecated. Use `compute_txid` instead. /// This method is deprecated. `txid` has been renamed to `compute_txid` to note that it's
#[deprecated( /// computationally expensive. Use `compute_txid` instead.
since = "0.31.0", #[deprecated(since = "0.31.0", note = "use `compute_txid()` instead")]
note = "txid has been renamed to compute_txid to note that it's computationally expensive. use compute_txid() instead."
)]
pub fn txid(&self) -> Txid { self.compute_txid() } pub fn txid(&self) -> Txid { self.compute_txid() }
/// Computes the [`Txid`]. /// Computes the [`Txid`].
@ -433,11 +429,9 @@ impl Transaction {
/// Computes the segwit version of the transaction id. /// Computes the segwit version of the transaction id.
/// ///
/// This method is deprecated. Use `compute_wtxid` instead. /// This method is deprecated. `wtxid` has been renamed to `compute_wtxid` to note that it's
#[deprecated( /// computationally expensive. Use `compute_wtxid` instead.
since = "0.31.0", #[deprecated(since = "0.31.0", note = "use `compute_wtxid()` instead")]
note = "wtxid has been renamed to compute_wtxid to note that it's computationally expensive. use compute_wtxid() instead."
)]
pub fn wtxid(&self) -> Wtxid { self.compute_wtxid() } pub fn wtxid(&self) -> Wtxid { self.compute_wtxid() }
/// Computes the segwit version of the transaction id. /// Computes the segwit version of the transaction id.

View File

@ -296,7 +296,7 @@ impl Witness {
pub fn to_bytes(&self) -> Vec<Vec<u8>> { self.iter().map(|s| s.to_vec()).collect() } pub fn to_bytes(&self) -> Vec<Vec<u8>> { self.iter().map(|s| s.to_vec()).collect() }
/// Convenience method to create an array of byte-arrays from this witness. /// Convenience method to create an array of byte-arrays from this witness.
#[deprecated(since = "TBD", note = "Use to_bytes instead")] #[deprecated(since = "TBD", note = "use `to_bytes` instead")]
pub fn to_vec(&self) -> Vec<Vec<u8>> { self.to_bytes() } pub fn to_vec(&self) -> Vec<Vec<u8>> { self.to_bytes() }
/// Returns `true` if the witness contains no element. /// Returns `true` if the witness contains no element.

View File

@ -71,7 +71,7 @@ impl Signature {
} }
/// Serializes an ECDSA signature (inner secp256k1 signature in DER format) into `Vec`. /// Serializes an ECDSA signature (inner secp256k1 signature in DER format) into `Vec`.
#[deprecated(since = "TBD", note = "Use to_bytes instead")] #[deprecated(since = "TBD", note = "use `to_bytes` instead")]
pub fn to_vec(self) -> Vec<u8> { self.to_bytes() } pub fn to_vec(self) -> Vec<u8> { self.to_bytes() }
/// Serializes an ECDSA signature (inner secp256k1 signature in DER format) to a `writer`. /// Serializes an ECDSA signature (inner secp256k1 signature in DER format) to a `writer`.

View File

@ -58,7 +58,7 @@ impl Signature {
} }
/// Serializes the signature. /// Serializes the signature.
#[deprecated(since = "TBD", note = "Use to_bytes instead")] #[deprecated(since = "TBD", note = "use `to_bytes` instead")]
pub fn to_vec(self) -> Vec<u8> { self.to_bytes() } pub fn to_vec(self) -> Vec<u8> { self.to_bytes() }
/// Serializes the signature to `writer`. /// Serializes the signature to `writer`.

View File

@ -4,7 +4,7 @@
//! //!
//! This module is deprecated. You can find hash types in their respective, hopefully obvious, modules. //! This module is deprecated. You can find hash types in their respective, hopefully obvious, modules.
#[deprecated(since = "TBD", note = "use crate::T instead")] #[deprecated(since = "TBD", note = "use `crate::T` instead")]
pub use crate::{ pub use crate::{
BlockHash, FilterHash, FilterHeader, TxMerkleNode, Txid, WitnessCommitment, WitnessMerkleNode, BlockHash, FilterHash, FilterHeader, TxMerkleNode, Txid, WitnessCommitment, WitnessMerkleNode,
Wtxid, Wtxid,

View File

@ -96,7 +96,7 @@ pub struct Params {
/// Number of blocks with the same set of rules. /// Number of blocks with the same set of rules.
pub miner_confirmation_window: BlockInterval, pub miner_confirmation_window: BlockInterval,
/// Proof of work limit value. It contains the lowest possible difficulty. /// Proof of work limit value. It contains the lowest possible difficulty.
#[deprecated(since = "0.32.0", note = "field renamed to max_attainable_target")] #[deprecated(since = "0.32.0", note = "use `max_attainable_target` instead")]
pub pow_limit: Target, pub pow_limit: Target,
/// The maximum **attainable** target value for these params. /// The maximum **attainable** target value for these params.
/// ///
@ -129,7 +129,7 @@ pub struct Params {
/// [using-statics-or-consts]: <https://doc.rust-lang.org/reference/items/static-items.html#using-statics-or-consts> /// [using-statics-or-consts]: <https://doc.rust-lang.org/reference/items/static-items.html#using-statics-or-consts>
pub static MAINNET: Params = Params::MAINNET; pub static MAINNET: Params = Params::MAINNET;
/// The testnet3 parameters. /// The testnet3 parameters.
#[deprecated(since = "0.33.0", note = "Use TESTNET3 instead")] #[deprecated(since = "0.33.0", note = "use `TESTNET3` instead")]
pub static TESTNET: Params = Params::TESTNET3; pub static TESTNET: Params = Params::TESTNET3;
/// The testnet3 parameters. /// The testnet3 parameters.
pub static TESTNET3: Params = Params::TESTNET3; pub static TESTNET3: Params = Params::TESTNET3;
@ -163,7 +163,7 @@ impl Params {
}; };
/// The testnet3 parameters. /// The testnet3 parameters.
#[deprecated(since = "0.33.0", note = "Use TESTNET3 instead")] #[deprecated(since = "0.33.0", note = "use `TESTNET3` instead")]
pub const TESTNET: Params = Params { pub const TESTNET: Params = Params {
network: Network::Testnet(TestnetVersion::V3), network: Network::Testnet(TestnetVersion::V3),
bip16_time: 1333238400, // Apr 1 2012 bip16_time: 1333238400, // Apr 1 2012

View File

@ -217,7 +217,7 @@ impl Magic {
/// Bitcoin mainnet network magic bytes. /// Bitcoin mainnet network magic bytes.
pub const BITCOIN: Self = Self([0xF9, 0xBE, 0xB4, 0xD9]); pub const BITCOIN: Self = Self([0xF9, 0xBE, 0xB4, 0xD9]);
/// Bitcoin testnet3 network magic bytes. /// Bitcoin testnet3 network magic bytes.
#[deprecated(since = "0.33.0", note = "Use TESTNET3 instead")] #[deprecated(since = "0.33.0", note = "use `TESTNET3` instead")]
pub const TESTNET: Self = Self([0x0B, 0x11, 0x09, 0x07]); pub const TESTNET: Self = Self([0x0B, 0x11, 0x09, 0x07]);
/// Bitcoin testnet3 network magic bytes. /// Bitcoin testnet3 network magic bytes.
pub const TESTNET3: Self = Self([0x0B, 0x11, 0x09, 0x07]); pub const TESTNET3: Self = Self([0x0B, 0x11, 0x09, 0x07]);

View File

@ -286,12 +286,12 @@ impl Target {
/// Computes the minimum valid [`Target`] threshold allowed for a block in which a difficulty /// Computes the minimum valid [`Target`] threshold allowed for a block in which a difficulty
/// adjustment occurs. /// adjustment occurs.
#[deprecated(since = "0.32.0", note = "use min_transition_threshold instead")] #[deprecated(since = "0.32.0", note = "use `min_transition_threshold` instead")]
pub fn min_difficulty_transition_threshold(&self) -> Self { self.min_transition_threshold() } pub fn min_difficulty_transition_threshold(&self) -> Self { self.min_transition_threshold() }
/// Computes the maximum valid [`Target`] threshold allowed for a block in which a difficulty /// Computes the maximum valid [`Target`] threshold allowed for a block in which a difficulty
/// adjustment occurs. /// adjustment occurs.
#[deprecated(since = "0.32.0", note = "use max_transition_threshold instead")] #[deprecated(since = "0.32.0", note = "use `max_transition_threshold` instead")]
pub fn max_difficulty_transition_threshold(&self) -> Self { pub fn max_difficulty_transition_threshold(&self) -> Self {
self.max_transition_threshold_unchecked() self.max_transition_threshold_unchecked()
} }

View File

@ -123,7 +123,7 @@ mod message_signing {
} }
/// Create a `MessageSignature` from a byte slice. /// Create a `MessageSignature` from a byte slice.
#[deprecated(since = "TBD", note = "Use `from_byte_array` instead.")] #[deprecated(since = "TBD", note = "use `from_byte_array` instead")]
pub fn from_slice(bytes: &[u8]) -> Result<MessageSignature, MessageSignatureError> { pub fn from_slice(bytes: &[u8]) -> Result<MessageSignature, MessageSignatureError> {
let byte_array: [u8; 65] = let byte_array: [u8; 65] =
bytes.try_into().map_err(|_| MessageSignatureError::InvalidLength)?; bytes.try_into().map_err(|_| MessageSignatureError::InvalidLength)?;

View File

@ -19,7 +19,7 @@ pub struct TaprootMerkleBranch(Vec<TapNodeHash>);
impl TaprootMerkleBranch { impl TaprootMerkleBranch {
/// Returns a reference to the slice of hashes. /// Returns a reference to the slice of hashes.
#[deprecated(since = "0.32.0", note = "Use `as_slice` instead")] #[deprecated(since = "0.32.0", note = "use `as_slice` instead")]
#[inline] #[inline]
pub fn as_inner(&self) -> &[TapNodeHash] { &self.0 } pub fn as_inner(&self) -> &[TapNodeHash] { &self.0 }
@ -106,7 +106,7 @@ impl TaprootMerkleBranch {
} }
/// Returns the inner list of hashes. /// Returns the inner list of hashes.
#[deprecated(since = "0.32.0", note = "Use `into_vec` instead")] #[deprecated(since = "0.32.0", note = "use `into_vec` instead")]
#[inline] #[inline]
pub fn into_inner(self) -> Vec<TapNodeHash> { self.0 } pub fn into_inner(self) -> Vec<TapNodeHash> { self.0 }

View File

@ -144,7 +144,7 @@ impl Hash {
/// Computes hash from `bytes` in `const` context. /// Computes hash from `bytes` in `const` context.
/// ///
/// Warning: this function is inefficient. It should be only used in `const` context. /// Warning: this function is inefficient. It should be only used in `const` context.
#[deprecated(since = "TBD", note = "use Self::hash_unoptimized")] #[deprecated(since = "TBD", note = "use `Self::hash_unoptimized` instead")]
pub const fn const_hash(bytes: &[u8]) -> Self { Hash::hash_unoptimized(bytes) } pub const fn const_hash(bytes: &[u8]) -> Self { Hash::hash_unoptimized(bytes) }
/// Computes hash from `bytes` in `const` context. /// Computes hash from `bytes` in `const` context.

View File

@ -46,7 +46,7 @@ where
pub fn from_engine(e: HashEngine) -> Hash<T> { from_engine(e) } pub fn from_engine(e: HashEngine) -> Hash<T> { from_engine(e) }
/// Copies a byte slice into a hash object. /// Copies a byte slice into a hash object.
#[deprecated(since = "TBD", note = "Use `from_byte_array` instead.")] #[deprecated(since = "TBD", note = "use `from_byte_array` instead")]
pub fn from_slice(sl: &[u8]) -> Result<Hash<T>, FromSliceError> { pub fn from_slice(sl: &[u8]) -> Result<Hash<T>, FromSliceError> {
if sl.len() != 32 { if sl.len() != 32 {
Err(FromSliceError { expected: 32, got: sl.len() }) Err(FromSliceError { expected: 32, got: sl.len() })
@ -211,7 +211,7 @@ macro_rules! sha256t_tag {
/// ///
/// [`hash_newtype`]: crate::hash_newtype /// [`hash_newtype`]: crate::hash_newtype
#[macro_export] #[macro_export]
#[deprecated(since = "TBD", note = "use `sha256_tag!` combined with `hash_newtype!`")] #[deprecated(since = "TBD", note = "use `sha256_tag!` combined with `hash_newtype!` instead")]
macro_rules! sha256t_hash_newtype { macro_rules! sha256t_hash_newtype {
($(#[$($tag_attr:tt)*])* $tag_vis:vis struct $tag:ident = $constructor:tt($($tag_value:tt)+); $(#[$($hash_attr:tt)*])* $hash_vis:vis struct $hash_name:ident($(#[$($field_attr:tt)*])* _);) => { ($(#[$($tag_attr:tt)*])* $tag_vis:vis struct $tag:ident = $constructor:tt($($tag_value:tt)+); $(#[$($hash_attr:tt)*])* $hash_vis:vis struct $hash_name:ident($(#[$($field_attr:tt)*])* _);) => {
$crate::sha256t_tag_struct!($tag_vis, $tag, stringify!($hash_name), $(#[$($tag_attr)*])*); $crate::sha256t_tag_struct!($tag_vis, $tag, stringify!($hash_name), $(#[$($tag_attr)*])*);

View File

@ -51,10 +51,7 @@ impl Sequence {
pub const ENABLE_LOCKTIME_NO_RBF: Self = Sequence::MIN_NO_RBF; pub const ENABLE_LOCKTIME_NO_RBF: Self = Sequence::MIN_NO_RBF;
/// The sequence number that enables replace-by-fee and absolute lock time but /// The sequence number that enables replace-by-fee and absolute lock time but
/// disables relative lock time. /// disables relative lock time.
#[deprecated( #[deprecated(since = "TBD", note = "use `ENABLE_LOCKTIME_AND_RBF` instead")]
since = "TBD",
note = "This constant has ambiguous name. Please use ENABLE_LOCKTIME_AND_RBF instead."
)]
pub const ENABLE_RBF_NO_LOCKTIME: Self = Sequence(0xFFFFFFFD); pub const ENABLE_RBF_NO_LOCKTIME: Self = Sequence(0xFFFFFFFD);
/// The maximum sequence number that enables replace-by-fee and absolute lock time but /// The maximum sequence number that enables replace-by-fee and absolute lock time but
/// disables relative lock time. /// disables relative lock time.

View File

@ -996,7 +996,7 @@ impl Amount {
/// ///
/// Does not include the denomination. /// Does not include the denomination.
#[rustfmt::skip] #[rustfmt::skip]
#[deprecated(since = "TBD", note = "Use `display_in()` instead")] #[deprecated(since = "TBD", note = "use `display_in()` instead")]
pub fn fmt_value_in(self, f: &mut dyn fmt::Write, denom: Denomination) -> fmt::Result { pub fn fmt_value_in(self, f: &mut dyn fmt::Write, denom: Denomination) -> fmt::Result {
fmt_satoshi_in(self.to_sat(), false, f, denom, false, FormatOptions::default()) fmt_satoshi_in(self.to_sat(), false, f, denom, false, FormatOptions::default())
} }
@ -1406,7 +1406,7 @@ impl SignedAmount {
/// ///
/// Does not include the denomination. /// Does not include the denomination.
#[rustfmt::skip] #[rustfmt::skip]
#[deprecated(since = "TBD", note = "Use `display_in()` instead")] #[deprecated(since = "TBD", note = "use `display_in()` instead")]
pub fn fmt_value_in(self, f: &mut dyn fmt::Write, denom: Denomination) -> fmt::Result { pub fn fmt_value_in(self, f: &mut dyn fmt::Write, denom: Denomination) -> fmt::Result {
fmt_satoshi_in(self.unsigned_abs().to_sat(), self.is_negative(), f, denom, false, FormatOptions::default()) fmt_satoshi_in(self.unsigned_abs().to_sat(), self.is_negative(), f, denom, false, FormatOptions::default())
} }