types

type AddressInfo struct {
	PKScript  []byte               // 原始脚本
	Typ       AddressType          // 地址类型
	Cls       txscript.ScriptClass // 脚本类型
	ReqSigs   int                  // 需要签名数（多签时有意义）
	Addresses []string             // 可能为 0/1/N
}

type AddressScriptInfo struct {
	Address         string               // 地址
	Typ             AddressType          // 地址类型
	Cls             txscript.ScriptClass // 脚本类型
	ScriptPubKeyHex []byte               // 脚本哈希 => PKScript
	ScriptAsm       string               // 脚本汇编

	// “哈希/程序”层面（地址能直接给出的）
	PubKeyHashHex       []byte // P2PKH: 20 bytes
	RedeemScriptHashHex []byte // P2SH:  20 bytes

	// SegWit
	IsWitness         bool   // 是否为见证地址
	WitnessVersion    int    // 见证版本：0（SegWit v0）、1（Taproot）、-1（非SegWit）
	WitnessProgramHex []byte // v0: 20/32 bytes; v1+: 32 bytes
	WitnessProgramLen int    // 见证数据长度：20字节或32字节
	BechEncoding      string // bech32 / bech32m

	// Taproot
	TaprootOutputKeyHex []byte // 等同于 witness program (v=1, 32B x-only pubkey)
}

type AddressType string

type BRC20Action struct {
	Op   string `json:"op"`            // 操作类型
	Tick string `json:"tick"`          // 代币符号
	Amt  string `json:"amt,omitempty"` // 数量
	Max  string `json:"max,omitempty"` // 最大数量
	Lim  string `json:"lim,omitempty"` // 限制
}

type ChainBlock struct {
	Hash              string  `json:"hash"`              // 区块哈希
	Confirmations     int     `json:"confirmations"`     // 确认数
	Height            int     `json:"height"`            // 高度
	Version           int     `json:"version"`           // 版本
	VersionHex        string  `json:"versionHex"`        // 版本十六进制
	MerkleRoot        string  `json:"merkleroot"`        // 默克尔根
	Time              int     `json:"time"`              // 时间
	MedianTime        int     `json:"mediantime"`        // 中位时间
	Nonce             int     `json:"nonce"`             // 随机数
	Bits              string  `json:"bits"`              // 难度位
	Difficulty        float64 `json:"difficulty"`        // 难度
	Chainwork         string  `json:"chainwork"`         // 工作量
	NTx               int     `json:"nTx"`               // 交易数
	PreviousBlockHash string  `json:"previousblockhash"` // 上一个区块哈希
	NextBlockHash     string  `json:"nextblockhash"`     // 下一个区块哈希

	// 区块链头数据不包含以下字段
	StrippedSize int      `json:"strippedsize"` // 剥离大小
	Size         int      `json:"size"`         // 大小
	Weight       int      `json:"weight"`       // 权重
	Tx           []string `json:"tx"`           // 交易
}

type Hash32 [32]byte

type Network string

type OrdinalsEnvelope struct {
	ContentType string           `json:"content_type,omitempty"` // 若 key=0x01 存在，ASCII 解码
	BodyHex     string           `json:"body_hex,omitempty"`     // key=0x00 的所有分片合并后的十六进制
	Records     []OrdinalsRecord `json:"records"`                // 完整 TLV（有序）
}

type OrdinalsRecord struct {
	KeyHex   string `json:"key_hex"`
	ValueHex string `json:"value_hex"`
}

type Runestone struct {
	BodyHex string `json:"body_hex"` // 十六进制编码的 payload
}

type ScriptOp struct {
	Op      string `json:"op"`                 // 操作码
	DataHex string `json:"data_hex,omitempty"` // 数据十六进制
	DataLen int    `json:"data_len,omitempty"` // 数据长度，单位：字节
}

type TapControlBlock struct {
	Header       byte     `json:"header"`        // 原始头字节
	LeafVersion  byte     `json:"leaf_version"`  // header & 0xfe
	Parity       int      `json:"parity"`        // (header >> 7) & 1
	InternalKey  string   `json:"internal_key"`  // 32B x-only pubkey (hex)
	MerkleHashes []string `json:"merkle_hashes"` // 0或多段32B（hex）
}

type Tx struct {
	Version  int32   // 交易版本
	LockTime uint32  // 交易锁定时间
	TxIn     []TxIn  // 交易输入
	TxOut    []TxOut // 交易输出

}

type TxIn struct {
	PreviousOutPoint TxOutPoint // 上一笔交易的输出点
	Sequence         uint32     // 交易序列号
	ScriptSig        []byte     // scriptSig
	Witness          TxWitness  // 若任一输入 Witness 非空，序列化需写入 marker/flag，并在所有 TxOut 之后写入全部 Witness
}

type TxInputParams struct {
	FromAddress   []string  `json:"from_address"`   // 来源地址数组-可以是多个, 但是目前版本只支持1个地址
	ToAddress     []string  `json:"to_address"`     // 目标地址数组-可以是多个, 但是要和Amount一一对应
	AmountBTC     []float64 `json:"amount"`         // 金额-单位BTC
	FeeRate       float64   `json:"fee_rate"`       // 费用率(sat/vB)
	Locktime      int64     `json:"locktime"`       // 锁定时间(秒)
	Replaceable   bool      `json:"replaceable"`    // 是否可替换RBF
	Data          string    `json:"data"`           // 可选 交付附加数据
	PublicKey     string    `json:"public_key"`     // 公钥 => 从OKX获取, 后续要删除, 改用其他方式录入钱包
	ChangeAddress string    `json:"change_address"` // 找零地址
}

type TxOut struct {
	Value      int64  // satoshi
	PkScript   []byte // scriptPubKey
	ScriptType string // 可选, 用于显示 解析出的脚本类别
	Address    string // 可选, 用于显示 解析得到的人类可读地址
}

type TxOutPoint struct {
	Hash  Hash32 // 上一笔交易的 txid（逻辑上大端显示；写入时小端序）
	Index uint32 // vout 索引，从 0 开始
}

type TxUTXO struct {
	OutPoint TxOutPoint // 定位该 UTXO
	Value    int64      // satoshi
	PkScript []byte     // 原始 scriptPubKey
	Height   uint32     // 产出该 UTXO 的区块高度；mempool 可置 0 或特约定值
	Coinbase bool       // 该 UTXO 是否来自 coinbase 交易
	Address  string     // 解析得到的人类可读地址（可选）

}

type TxUnsignedPSBT struct {
	PSBTBase64 string `json:"psbt_base64"`     // 导出签名用的PSBT数据
	UnsignedTx string `json:"unsigned_tx_hex"` // 调试/核对
}

type TxWitness [][]byte

type VarInt = uint64