rawtx
A Golang module that helps you answer questions about raw bitcoin transactions, their inputs, outputs and scripts.
Transactions
Transactions can be deserialized from a hex string or from a wire.MsgTx. Based on that following questions can be answered.
- How many inputs?
- How many outputs?
- Whats the sum of all ouputs?
- Spends SegWit?
- Spends nested SegWit?
- Spends native SegWit?
- Spends multisig?
- What is the locktime?
- Is a coinbase transaction?
- Is BIP69 compliant? Wait, what is BIP-69?
- Signals explicit RBF?
- Whats the size in bytes?
- Whats the vsize in vbytes?
- and more...
Input and Output type
Following is answered:
| spends? | pays to? | |
|---|---|---|
| P2PK | ✓ | ✓ |
| P2PKH | ✓ | ✓ |
| P2SH-P2WPKH | ✓ | can't tell from the rawtx |
| P2WPKH_V0 | ✓ | ✓ |
| P2MS | ✓ | ✓ |
| P2SH | ✓ | ✓ |
| P2SH-P2WSH | ✓ | can't tell from the rawtx |
| P2WSH_V0 | ✓ | ✓ |
| OP_RETURN | can't spend an OP_RETURN output |
✓ |
Additionally you might ask:
- What is the reedem script of this P2SH, P2SH-P2WSH or P2WSH_V0 input?
- What is the OP_RETURN data pushed by this output?
- and is this input unilitteraly closing a lightning channel?
Bitcoin Script
There is a BitcoinScript parser for byte slices build in.
A ParsedBitcoinScript is a slice of ParsedOpCodes.
It has a String() method which displays the OP codes in a bitcoin developer readable format.
bs1 := BitcoinScript{0x6e, 0x87, 0x91, 0x69, 0xa7, 0x7c, 0xa7, 0x87}
pbs1 := bs1.Parse()
fmt.Println(pbs1.String())
// -> OP_2DUP OP_EQUAL OP_NOT OP_VERIFY OP_SHA1 OP_SWAP OP_SHA1 OP_EQUALbs2 = BitcoinScript{byte(OpRETURN), byte(OpDATA2), byte(OpCHECKLOCKTIMEVERIFY), byte(OpDATA12)}
pbs2 = bs2.Parse()
fmt.Println(pbs2.String())
// -> OP_RETURN OP_DATA_2(b10c)The actual OpCode behind the ParsedOpCode can, but doesn't have to push data. You can check if a ParsedOpCode is
- a signature? (and what's the SigHash?)
- a compressed public key?
- an uncompressed public key?
- or either a compressed or uncompressed public key?
- or compare it any other OpCode.
Running tests
Either normal test suit with coverage report in percent.
$ make test
...
PASS
coverage: 100.0% of statements
ok github.com/0xB10C/rawtx 0.028sOr with detailed coverage HTML report opened in your browser.
$ make cover
...
PASS
coverage: 100.0% of statements
ok github.com/0xB10C/rawtx 0.028s
go tool cover -html=count.outDiscalimer
Do not use in consensus related code!
License
rawTx is licensed under a BSD 3-Clause License.