zecTransaction

package

v1.0.30 Latest Latest Go to latest Published: Aug 9, 2021 License: GPL-3.0 Imports: 10 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

README ¶

Bitcoin Transaction Driver

        transaction_test.go测试案例说明
        Test_case1    : 花费单个P2PKH-UTXO
        Test_case2    : 花费多个P2PKH-UTXO
        Test_case3    : 花费单个P2WPKH-UTXO
        Test_case4    : 花费多个P2WPKH-UTXO
        Test_case5    : 花费P2PKH和P2WPKH混合的UTXO
        Test_case6    : 花费BECH32-UTXO
        Test_case7    : 花费BECH32-UTXO
        Test_case8    : 花费2-of-3多重签名UTXO，带隔离见证
        Test_case9    : 花费2-of-3多重签名UTXO，带隔离见证
        Test_case10   : 花费2-of-3多重签名UTXO，无隔离见证
        Test_case11   : 花费2-of-3多重签名UTXO，无隔离见证

其他类比特币验证须知

        需要修改的数据在txProfile.go里面
        可针对不同平台进行调整

当前支持

        交易单构建
        交易单签名
        交易单合并
        交易单验签

        现已支持全系地址，任意类型、数量、顺序的混合

TODO

        signSingal,anyoneCanPay...

用法：

创建空交易单 `CreateEmptyRawTransaction`

        前置条件:
                获取需要发送的utxo
                获取接收地址和找零地址
                确定手续费以及找零数额
        步骤:
                使用utxo的交易哈希(txid)和输出索引(vout)填充TxIn结构体的Prevout字段
                使用接收地址和找零地址以及对应数额填充TxOut结构体的Address字段和Amount字段
                确认交易单版本号
                确认交易单锁定时间
                确认交易是否可以追加手续费(replaceable)
                获取空交易单
        调用方式:
                CreateRawTransaction([]TxIn, []TxOut, transactionVersion, lockTime, replaceable)
        Tips:
                txid使用的是小端模式，即查询交易时的端序
                交易单版本号为目前的默认版本号02

创建用于签名的交易单哈希 `CreateRawTransactionHashForSign`

        前置条件:
                获取需要发送的utxo
                获取接收地址和找零地址
                确定手续费以及找零数额
        步骤:
                使用utxo的交易哈希(txid)和输出索引(vout)填充TxIn结构体的Prevout字段
                使用接收地址和找零地址以及对应数额填充TxOut结构体的Address字段和Amount字段
                确认交易单版本号
                确认交易单锁定时间
                确认交易是否可以追加手续费(replaceable)
                获取前置交易的锁定脚本
                确认签名类型
                获取交易单
        调用方式:
                CreateRawTransactionHashForSign([]TxIn []TxOut, transactionVersion, lockTime, replaceable, signType)
        Tips:
                txid使用的是小端模式，即查询交易时的端序
                交易单版本号为目前的默认版本号02
                签名类型一般为signAll

本地交易单签名 `SignEmptyRawTransaction`

        前置条件:
                获取空交易单emptyTrans
                获取utxo的锁定脚本以及脚本对应的私钥
        步骤:
                使用锁定脚本与私钥填充TxUnlock结构体
                确定签名类型
        调用方式:
                SignRawTransaction(emptyTrans, []TxUnlock, sigType)
        Tips:
                TxUnlock结构体数组的顺序应该与空交易单的utxo的txid顺序保持一致
                签名类型一般为signAll

客户端交易单哈希签名 `SignRawTransactionHash`

        前置条件:
                获得用于签名的交易单哈希
        步骤:
                获取前置交易的锁定脚本对应的私钥，填充TxUnlock结构体
                获取签名
        调用方式:
                SignRawTransactionHash(transForSig, []TxUnlock)
        Tips:
                TxUnlock结构体数组的顺序应该与空交易单的utxo的txid顺序保持一致

合并交易单 `InsertSignaturesToEmptyRawTransaction`

        前置条件:
                获得空交易单
                获得签名
        步骤:
                合并
        调用方式:
                InsertSignaturesToEmptyRawTransaction(emptyTrans, []SignaturePubkkey)
        Tips:
                签名数据结构体数组的顺序应该与utxo的txid顺序保持一致

交易单验签 `VerifyRawTransaction`

        前置条件:    
                获取签名后的交易单signedTrans
                获取utxo的锁定脚本
        步骤:
                使用锁定脚本填充TxUnlock结构体
        调用方式:
                VerifyRawTransaction(signedTrans, []TxUnlock)
        Tips:
                TxUnlock结构体数组的顺序应该与交易单的utxo的txid顺序保持一致

Documentation ¶

Index ¶

Constants
Variables
func Bech32Decode(address string) ([]byte, error)
func Bech32Encode(prefix, alphabet string, payload []byte) string
func CreateEmptyRawTransaction(vins []Vin, vouts []Vout, lockTime uint32, replaceable bool, ...) (string, error)
func CreateMultiSig(required byte, pubkeys [][]byte, SegwitON bool, addressPrefix AddressPrefix) (string, string, error)
func Decode(input string, alphabet *Alphabet) ([]byte, error)
func DecodeCheck(address string) ([]byte, []byte, error)
func Encode(input []byte, alphabet *Alphabet) string
func EncodeCheck(prefix []byte, hash []byte) string
func InsertSignatureIntoEmptyTransaction(txHex string, txHashes []TxHash, unlockData []TxUnlock, SegwitON bool) (string, error)
func VerifyRawTransaction(txHex string, unlockData []TxUnlock, SegwitON bool, ...) bool
type AddressPrefix
type Alphabet
- func NewAlphabet(alphabet string) *Alphabet
- func (alphabet Alphabet) String() string
type MultiTx
type NormalTx
type SignaturePubkey
- func SignRawTransactionHash(txHash string, prikey []byte) (*SignaturePubkey, error)
type Transaction
- func DecodeRawTransaction(txBytes []byte, SegwitON bool) (*Transaction, error)
type TxHash
- func CreateRawTransactionHashForSig(txHex string, unlockData []TxUnlock, SegwitON bool, ...) ([]TxHash, error)
- func (tx TxHash) GetMultiTxPubkeys() []string
- func (tx TxHash) GetNormalTxAddress() string
- func (tx TxHash) GetTxHashHex() string
- func (tx TxHash) IsMultisig() bool
type TxIn
- func (in TxIn) GetTxID() string
- func (in TxIn) GetUTXOType() int
- func (in TxIn) GetVout() uint32
type TxOut
type TxUnlock
type Vin
type Vout

Constants ¶

View Source

const (
	TypeEmpty    = 0
	TypeP2PKH    = 1
	TypeP2WPKH   = 2
	TypeBech32   = 3
	TypeMultiSig = 4
)

View Source

const (
	DefaultTxVersion     = uint32(0x80000004)
	GroupId              = uint32(0x892F2085)
	DefaultHashType      = uint32(1)
	MaxScriptElementSize = 520
)

View Source

const (
	SequenceFinal        = uint32(0xFFFFFFFF)
	SequenceMaxBip125RBF = uint32(0xFFFFFFFD)
)

View Source

const (
	SegWitSymbol  = byte(0)
	SegWitVersion = byte(1)
	SigHashAll    = byte(1)
)

View Source

const (
	OpCodeHash160     = byte(0xA9)
	OpCodeEqual       = byte(0x87)
	OpCodeEqualVerify = byte(0x88)
	OpCodeCheckSig    = byte(0xAC)
	OpCodeDup         = byte(0x76)
	OpCode_1          = byte(0x51)
	OpCheckMultiSig   = byte(0xAE)
	OpPushData1       = byte(0x4C)
	OpPushData2       = byte(0x4D)
	OpPushData3       = byte(0x4E)
)

Variables ¶

View Source

var (
	ErrorInvalidAddress = errors.New("Invalid address!")

	BTCBech32Alphabet = "qpzry9x8gf2tvdw0s3jn54khce6mua7l"

	CHARSET_REV = []int8{}/* 128 elements not displayed */

)

View Source

var (
	ZECMainnetAddressPrefix = AddressPrefix{[]byte{0x1C, 0xB8}, nil, []byte{0x1C, 0xBD}, "zc"}
	ZECTestnetAddressPrefix = AddressPrefix{[]byte{0x1D, 0x25}, nil, []byte{0x1C, 0xBA}, "zc"}
)

View Source

var (
	CurveOrder     = []byte{0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFE, 0xBA, 0xAE, 0xDC, 0xE6, 0xAF, 0x48, 0xA0, 0x3B, 0xBF, 0xD2, 0x5E, 0x8C, 0xD0, 0x36, 0x41, 0x41}
	HalfCurveOrder = []byte{0x7F, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0xFF, 0x5D, 0x57, 0x6E, 0x73, 0x57, 0xA4, 0x50, 0x1D, 0xDF, 0xE9, 0x2F, 0x46, 0x68, 0x1B, 0x20, 0xA0}
)

View Source

var (
	BitcoinAlphabet = NewAlphabet("123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz")
)

Alphabet: copy from https://en.wikipedia.org/wiki/Base58

View Source

var (
	ErrorInvalidBase58String = errors.New("invalid base58 string")
)

Errors

Functions ¶

func Bech32Decode ¶

func Bech32Decode(address string) ([]byte, error)

func Bech32Encode ¶

func Bech32Encode(prefix, alphabet string, payload []byte) string

func CreateEmptyRawTransaction ¶

func CreateEmptyRawTransaction(vins []Vin, vouts []Vout, lockTime uint32, replaceable bool, addressPrefix AddressPrefix) (string, error)

func CreateMultiSig ¶

func CreateMultiSig(required byte, pubkeys [][]byte, SegwitON bool, addressPrefix AddressPrefix) (string, string, error)

func Decode ¶

func Decode(input string, alphabet *Alphabet) ([]byte, error)

Decode docode with custom alphabet

func DecodeCheck ¶

func DecodeCheck(address string) ([]byte, []byte, error)

return prefix + hash + error

func Encode ¶

func Encode(input []byte, alphabet *Alphabet) string

Encode encode with custom alphabet

func EncodeCheck ¶

func EncodeCheck(prefix []byte, hash []byte) string

func InsertSignatureIntoEmptyTransaction ¶

func InsertSignatureIntoEmptyTransaction(txHex string, txHashes []TxHash, unlockData []TxUnlock, SegwitON bool) (string, error)

func VerifyRawTransaction ¶

func VerifyRawTransaction(txHex string, unlockData []TxUnlock, SegwitON bool, addressPrefix AddressPrefix) bool

Types ¶

type AddressPrefix ¶

type AddressPrefix struct {
	P2PKHPrefix  []byte
	P2WPKHPrefix []byte
	P2SHPrefix   []byte
	Bech32Prefix string
}

type Alphabet ¶

type Alphabet struct {
	// contains filtered or unexported fields
}

Alphabet The base58 alphabet object.

func NewAlphabet ¶

func NewAlphabet(alphabet string) *Alphabet

NewAlphabet create a custom alphabet from 58-length string. Note: len(rune(alphabet)) must be 58.

func (Alphabet) String ¶

func (alphabet Alphabet) String() string

Alphabet's string representation

type MultiTx ¶

type MultiTx struct {
	Pubkey  string
	SigType byte
	SigPub  SignaturePubkey
}

type NormalTx ¶

type NormalTx struct {
	Address string
	SigType byte
	SigPub  SignaturePubkey
}

type SignaturePubkey ¶

type SignaturePubkey struct {
	Signature []byte
	Pubkey    []byte
}

func SignRawTransactionHash ¶

func SignRawTransactionHash(txHash string, prikey []byte) (*SignaturePubkey, error)

type Transaction ¶

type Transaction struct {
	Version  []byte
	GroupId  []byte
	Vins     []TxIn
	Vouts    []TxOut
	LockTime []byte
	Witness  bool
}

func DecodeRawTransaction ¶

func DecodeRawTransaction(txBytes []byte, SegwitON bool) (*Transaction, error)

type TxHash ¶

type TxHash struct {
	Hash      string
	NRequired byte
	Normal    *NormalTx
	Multi     []MultiTx
}

func CreateRawTransactionHashForSig ¶

func CreateRawTransactionHashForSig(txHex string, unlockData []TxUnlock, SegwitON bool, addressPrefix AddressPrefix) ([]TxHash, error)

func (TxHash) GetMultiTxPubkeys ¶

func (tx TxHash) GetMultiTxPubkeys() []string

func (TxHash) GetNormalTxAddress ¶

func (tx TxHash) GetNormalTxAddress() string

func (TxHash) GetTxHashHex ¶

func (tx TxHash) GetTxHashHex() string

func (TxHash) IsMultisig ¶

func (tx TxHash) IsMultisig() bool

type TxIn ¶

type TxIn struct {
	TxID []byte
	Vout []byte
	// contains filtered or unexported fields
}

func (TxIn) GetTxID ¶

func (in TxIn) GetTxID() string

func (TxIn) GetUTXOType ¶

func (in TxIn) GetUTXOType() int

func (TxIn) GetVout ¶

func (in TxIn) GetVout() uint32

type TxOut ¶

type TxOut struct {
	// contains filtered or unexported fields
}

type TxUnlock ¶

type TxUnlock struct {
	//PrivateKey   []byte
	LockScript   string
	RedeemScript string
	Amount       uint64
	//	Address      string
	SigType byte
}

type Vin ¶

type Vin struct {
	TxID string
	Vout uint32
}

type Vout ¶

type Vout struct {
	Address string
	Amount  uint64
}

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

README ¶

Bitcoin Transaction Driver

其他类比特币验证须知

当前支持

TODO

用法：

创建空交易单 CreateEmptyRawTransaction

创建用于签名的交易单哈希 CreateRawTransactionHashForSign

本地交易单签名 SignEmptyRawTransaction

客户端交易单哈希签名 SignRawTransactionHash

合并交易单 InsertSignaturesToEmptyRawTransaction

交易单验签 VerifyRawTransaction

Documentation ¶

Index ¶

Constants ¶

Variables ¶

Functions ¶

func Bech32Decode ¶

func Bech32Encode ¶

func CreateEmptyRawTransaction ¶

func CreateMultiSig ¶

func Decode ¶

func DecodeCheck ¶

func Encode ¶

func EncodeCheck ¶

func InsertSignatureIntoEmptyTransaction ¶

func VerifyRawTransaction ¶

Types ¶

type AddressPrefix ¶

type Alphabet ¶

func NewAlphabet ¶

func (Alphabet) String ¶

type MultiTx ¶

type NormalTx ¶

type SignaturePubkey ¶

func SignRawTransactionHash ¶

type Transaction ¶

func DecodeRawTransaction ¶

type TxHash ¶

func CreateRawTransactionHashForSig ¶

func (TxHash) GetMultiTxPubkeys ¶

func (TxHash) GetNormalTxAddress ¶

func (TxHash) GetTxHashHex ¶

func (TxHash) IsMultisig ¶

type TxIn ¶

func (TxIn) GetTxID ¶

func (TxIn) GetUTXOType ¶

func (TxIn) GetVout ¶

type TxOut ¶

type TxUnlock ¶

type Vin ¶

type Vout ¶

Source Files ¶

创建空交易单 `CreateEmptyRawTransaction`

创建用于签名的交易单哈希 `CreateRawTransactionHashForSign`

本地交易单签名 `SignEmptyRawTransaction`

客户端交易单哈希签名 `SignRawTransactionHash`

合并交易单 `InsertSignaturesToEmptyRawTransaction`

交易单验签 `VerifyRawTransaction`