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

• What type has this input?
• What type has this output?

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_EQUAL

bs2 = 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.028s

Or 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.out

Discalimer

Do not use in consensus related code!

License

rawTx is licensed under a BSD 3-Clause License.