README
¶
Bitgodine
Chain analysis is the attempt to deanonymize pseudo confidential transactions in Bitcoin’s blockchain. This work is usually made by companies working with big institutions, and their techniques are largely unknown. Chain analysis should be open in order to help the technology to establish the best practices and mitigate these techniques.
bitgodine is a new open source Bitcoin chain analysis platform, inspired from previous Politecnico di Milano's work, Bitiodine. This work leverages previous work on chain analysis' heuristics to provide a new Bitcoin’s flows tracing approach, based on probabilistic reliability of heuristics on secure basis heuristics. In this way we provide a convenient platform to trace Bitcoin's flows specifying their probability and entities tagging.
Project Status
This project is not under development. I worked massively on this project as part of my master thesis, but it was interrupted due to my dropout.
Contributing
See [CONTRIBUTING.md](https://github.com/xn3cr0nx/bitgodine/blob/main/CONTRIBUTING.md).
Maintainers
- Patrick Jusic, Toggl Track, Politecnico di Milano
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
internal
|
|
|
analysis
Package analysis applicability vs reliability: applicability describes in a deterministic way if an heuristic is applicable to a transaction based on its conditions while reliability is the degree of reliability the heuristic provides whether it is applicable to the transaction.
|
Package analysis applicability vs reliability: applicability describes in a deterministic way if an heuristic is applicable to a transaction based on its conditions while reliability is the degree of reliability the heuristic provides whether it is applicable to the transaction. |
|
heuristics/backward
Package backward heuristic It checks the transactions that come before the one in which we want to find the change address.
|
Package backward heuristic It checks the transactions that come before the one in which we want to find the change address. |
|
heuristics/behaviour
Package behaviour client heuristic This heuristic checks if there are output addresses that are the first time they appear in the Blockchain.
|
Package behaviour client heuristic This heuristic checks if there are output addresses that are the first time they appear in the Blockchain. |
|
heuristics/forward
Package forward heuristic It checks the transactions that come after the one in which we want to find the change address.
|
Package forward heuristic It checks the transactions that come after the one in which we want to find the change address. |
|
heuristics/locktime
Package locktime heuristic It checks for each output of a transaction, if the spending transactions locktime is the same of the original transaction.
|
Package locktime heuristic It checks for each output of a transaction, if the spending transactions locktime is the same of the original transaction. |
|
heuristics/optimal
Package optimal change heuristic It tries to locate in the output set of a transaction an address that receives an amount which is smaller or equal than all inputs values.
|
Package optimal change heuristic It tries to locate in the output set of a transaction an address that receives an amount which is smaller or equal than all inputs values. |
|
heuristics/peeling
Package peeling chain heuristic Since in this case we are looking for a set of transactions that have different length, can be really difficult to be sure that a series of transactions that have one input and two outputs is a peeling chains transaction, also because a chain can be connected in the middle point of another chain.
|
Package peeling chain heuristic Since in this case we are looking for a set of transactions that have different length, can be really difficult to be sure that a series of transactions that have one input and two outputs is a peeling chains transaction, also because a chain can be connected in the middle point of another chain. |
|
heuristics/power
Package power of ten heuristic It checks if in the outputs set there are addresses that have an amount in Satoshi that is a power of ten.
|
Package power of ten heuristic It checks if in the outputs set there are addresses that have an amount in Satoshi that is a power of ten. |
|
heuristics/reuse
Package reuse heuristic This heuristic just checks if an address that appears in the input set, appears also in the output set, we just need to count the number of transactions in which this condition is satisfied.
|
Package reuse heuristic This heuristic just checks if an address that appears in the input set, appears also in the output set, we just need to count the number of transactions in which this condition is satisfied. |
|
heuristics/shadow
Package shadow heuristic This heuristic checks if there are output addresses that are the first time they appear in the Blockchain.
|
Package shadow heuristic This heuristic checks if there are output addresses that are the first time they appear in the Blockchain. |
|
heuristics/type
Package class heuristic This heuristic is the address type heuristic and it checks if the all the inputs are of the same type and then try to locate only one output that is of the same type.
|
Package class heuristic This heuristic is the address type heuristic and it checks if the all the inputs are of the same type and then try to locate only one output that is of the same type. |
|
spider/bitcoinabuse
Package bitcoinabuse Spider for address tags resource from bitcoinabuse.com
|
Package bitcoinabuse Spider for address tags resource from bitcoinabuse.com |
|
spider/blockchain
Package blockchain Spider for address tags resource from blockchain.com
|
Package blockchain Spider for address tags resource from blockchain.com |
|
spider/checkbitcoinaddress
Package checkbitcoinaddress Spider for address tags resource from checkbitcoinaddress.com
|
Package checkbitcoinaddress Spider for address tags resource from checkbitcoinaddress.com |
|
spider/walletexplorer
Package walletexplorer Spider for address tags resource from walletexplorer.com
|
Package walletexplorer Spider for address tags resource from walletexplorer.com |
|
utxoset
Package utxoset package to keep track of utxoset during parsing.
|
Package utxoset package to keep track of utxoset during parsing. |
|
pkg
|
|
Click to show internal directories.
Click to hide internal directories.