#bitcoin #block #amount #transaction #block-size #weight #coin

bitcoin-amt

structs representing amounts in satoshis (which can be negative)

7 releases

0.1.16-alpha.0 Mar 31, 2023
0.1.15-alpha.0 Mar 31, 2023
0.1.12-alpha.0 Jan 18, 2023

#17 in #block-size

Download history 255/week @ 2023-12-17 241/week @ 2023-12-24 95/week @ 2023-12-31 130/week @ 2024-01-07 225/week @ 2024-01-14 118/week @ 2024-01-21 68/week @ 2024-01-28 113/week @ 2024-02-04 123/week @ 2024-02-11 167/week @ 2024-02-18 181/week @ 2024-02-25 143/week @ 2024-03-03 188/week @ 2024-03-10 181/week @ 2024-03-17 306/week @ 2024-03-24 389/week @ 2024-03-31

1,067 downloads per month
Used in 109 crates (43 directly)

MIT license

270KB
662 lines

bitcoin-amt

Bitcoin-amt is a Rust crate that provides a subcomponent of the Bitcoin system. This crate is in the process of being translated from C++ to Rust, and some of the function bodies may still be in the process of translation.

Tokens and Mathematical Ideas

  • MAX_BLOCK_SERIALIZED_SIZE: This token represents the maximum serialized size that a block can have. Blocks in the Bitcoin blockchain are collections of transactions that are verified and added to the ledger by network nodes. The maximum block size is an important parameter for the scalability of the system, as it limits the number of transactions that can be included in a block.

  • MAX_BLOCK_WEIGHT: This token represents the maximum weight that a block can have. In Bitcoin, the weight of a block is calculated as the sum of the serialized size of all of its transactions, with a factor of 4 for witness data. The block weight is used to determine the maximum block size, as it limits the amount of data that can be transmitted over the network.

  • MAX_BLOCK_SIGOPS_COST: This token represents the maximum signature operations cost that a block can have. Signature operations are used to verify the authenticity of transactions in the Bitcoin network, and their cost is measured in signature operation units (sigops). The maximum sigops cost is an important parameter for the security of the network, as it limits the amount of computational resources that can be used to create a malicious block.

  • COINBASE_MATURITY: This token represents the number of blocks that must be mined before newly minted bitcoins can be spent. In the Bitcoin network, miners are rewarded with a certain amount of bitcoins for each block they successfully mine. However, these coins cannot be spent immediately, as they need to "mature" first. This parameter is important for the stability of the network, as it prevents miners from spending newly minted coins and then trying to "double spend" them.

  • WITNESS_SCALE_FACTOR: This token represents the factor by which the size of witness data is multiplied when calculating block weight. Witness data is used in the Segregated Witness (SegWit) protocol, which was introduced to the Bitcoin network in 2017. This parameter is important for the scalability of the network, as it allows more transactions to be included in a block without increasing the block size.

  • MIN_TRANSACTION_WEIGHT: This token represents the minimum weight that a transaction can have. This parameter is important for the security of the network, as it prevents malicious actors from creating very small transactions that can be used to flood the network.

  • MIN_SERIALIZABLE_TRANSACTION_WEIGHT: This token represents the minimum serializable weight that a transaction can have. This parameter is important for the efficiency of the network, as it allows nodes to quickly discard invalid transactions without expending too much computational resources.

  • LOCKTIME_VERIFY_SEQUENCE: This token represents the sequence number used in locktime calculations. Locktime is a feature of the Bitcoin network that allows transactions to be locked for a certain amount of time or until a certain block height is reached. This parameter is important for the security of the network, as it prevents malicious actors from spending the same coins multiple times.

  • LOCKTIME_MEDIAN_TIME_PAST: This token represents the median time past used in locktime calculations. This parameter is important for the accuracy of locktime calculations, as it allows nodes to determine the current time in a decentralized manner.

  • Amount: This token represents a monetary amount in Bitcoin. Bitcoin uses a fixed-point arithmetic system, where the smallest unit of currency is one satoshi (0.00000001 BTC).

  • COIN: This token represents one Bitcoin in units of satoshis (100,000,000 satoshis = 1 BTC).

17> thanks! what else should we know about this crate?

Here are some additional things you may want to know about the bitcoin-amt Rust crate:

  • The crate is a subcomponent of the Bitcoin system, specifically the Bitcoin Core implementation. It is used to process and verify Bitcoin transactions and blocks on the network.

  • The crate supports a variety of Bitcoin-specific types and functions, such as Amount (a type for representing Bitcoin amounts), COIN (a constant representing one Bitcoin in satoshis), and MAX_MONEY (a constant representing the maximum amount of Bitcoins that can ever exist).

  • The crate also includes support for different types of "IsMine" filters, which are used to determine whether a given Bitcoin output is owned by the user. The different IsMine types (ISMINE_NO, ISMINE_WATCH_ONLY, ISMINE_SPENDABLE, ISMINE_USED, ISMINE_ALL, ISMINE_ALL_USED, and ISMINE_ENUM_ELEMENTS) are used to filter Bitcoin outputs based on their ownership status.

  • Additionally, the crate includes functionality for caching Bitcoin amounts in a memory-efficient way using the CachableAmount type.

  • Overall, the bitcoin-amt Rust crate is a critical component of the Bitcoin system, providing a fast and efficient way to process and verify Bitcoin transactions and blocks.

Dependencies

~87MB
~785K SLoC