types

type AddressBalanceInfo struct {
	Address     string // 地址
	Confirmed   int64  // 已确认余额（聪）
	Unconfirmed int64  // 未确认余额（聪）
	Total       int64  // 总余额（聪）
	Error       error  // 查询错误（如果有）
}

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 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 Runes struct {
	ID               string          `db:"id"`                 // Rune 的唯一 ID（通常是 `block_height-tx_index` 或内部编码）。可作为主键。
	Number           int64           `db:"number"`             // (postgre: int8)Rune 序号（按诞生顺序的编号）。
	Name             string          `db:"name"`               // 原始名称（不含空格/分隔符）。
	SpacedName       string          `db:"spaced_name"`        // 带 spacer 的展示名（协议允许在 name 中插入分隔符以增强可读性）。
	BlockHash        string          `db:"block_hash"`         // 铸造/诞生所在区块哈希。
	BlockHeight      int             `db:"block_height"`       // 诞生区块高度。用于范围/时间查询。
	TxIndex          int64           `db:"tx_index"`           // (postgre: int8)该区块内的交易索引（定位同高内顺序）。
	TxID             string          `db:"tx_id"`              // 诞生交易哈希。
	Divisibility     int16           `db:"divisibility"`       // (postgres: int2)小数位精度（等价 ERC-20 decimals）。
	Premine          decimal.Decimal `db:"premine"`            // (postgres: numberic)预挖/预留发行量（在 terms 之外直接进入供给）。
	Symbol           string          `db:"symbol"`             // 代币符号（截图中默认值显示为 `'r'::text`，不同实现可能为空）。
	TermsAmount      decimal.Decimal `db:"terms_amount"`       // (postgres: numberic)**每次 mint 的单位数量**（按规则铸造时的一次配额）。
	TermsCap         decimal.Decimal `db:"terms_cap"`          // (postgres: numberic)**总的可 mint 次数上限**（“能铸几次”）。达到后不可再 mint。
	TermsHeightStart int             `db:"terms_height_start"` // 允许 mint 的起始高度（闭区间起点）。
	TermsHeightEnd   int             `db:"terms_height_end"`   // 允许 mint 的结束高度（闭区间终点）。
	TermsOffsetStart int             `db:"terms_offset_start"` // 允许 mint 的相对高度起点（相对“诞生高度”的偏移）。实现上常用于 height + offset 的双窗限制。
	TermsOffsetEnd   int             `db:"terms_offset_end"`   // 允许 mint 的相对高度终点。
	Turbo            bool            `db:"turbo"`              // 是否为“turbo”模式（部分实现里代表宽松/快速铸造规则或 gas/费用优化标记，阅读你用的 indexer 定义为准）。
	Cenotaph         bool            `db:"cenotaph"`           // 失效/空墓标记：表示该 Rune 在诞生 tx 上因规则错误被判定为无效（常见于 ordinals 语境中的“Cenotaph”概念）。通常不应被统计进有效供给。
	Timestamp        int64           `db:"timestamp"`          // (postgre: int8)诞生区块时间（Unix 秒）。
}

type RunesBalanceChanges struct {
	RuneID          string          `db:"rune_id"`          // 关联的 Rune。
	BlockHeight     int             `db:"block_height"`     // 统计到的区块高度（该高度时点的余额口径）。
	Address         string          `db:"address"`          // 地址。
	Balance         decimal.Decimal `db:"balance"`          // (postgre: numeric)该地址在该高度的**余额**（注意是累计量，而非当区块的 delta）。
	TotalOperations int64           `db:"total_operations"` // (postgre: int8)该地址到此高度累计发生的相关事件数（便于做增量/校验）。默认 0。
}

type RunesLedger struct {
	RuneID          string          `db:"rune_id"`          // 关联的 Rune。
	BlockHash       string          `db:"block_hash"`       // 所在区块哈希。
	BlockHeight     int             `db:"block_height"`     // 区块高度。
	TxIndex         int64           `db:"tx_index"`         // (postgre: int8)区块内交易索引。
	EventIndex      int64           `db:"event_index"`      // (postgre: int8)**同一交易内的事件序号**（确保事件稳定排序，便于回放）。
	TxID            string          `db:"tx_id"`            // 交易哈希。
	Output          int             `db:"output"`           // (postgre: int8)事件关联的 `vout`（收款/分发通常能落到具体输出；`mint` 可能无明确地址时该列可空）。
	Address         string          `db:"address"`          // 地址字段（实现里常作**发送方**或通用地址；搭配 `receiver_address` 使用，见下）。
	ReceiverAddress string          `db:"receiver_address"` // **接收方地址**（`receive` 事件一定有值；`send` 常为空；`mint` 视实现是否能归集到具体 vout）。
	Amount          decimal.Decimal `db:"amount"`           // (postgre: numeric)本事件的数量（正值）。
	Operation       string          `db:"operation"`        // (postgre: public.ledger_operation)**枚举**：常见有 `mint` / `send` / `receive` / `burn`。不同实现也可能仅用三类。
	Timestamp       int64           `db:"timestamp"`        // (postgre: int8)区块时间（Unix 秒）。
}

type RunesSupplyChanges struct {
	RuneID          string          `db:"rune_id"`          // 关联的 Rune。
	BlockHeight     int             `db:"block_height"`     // 统计到的区块高度。
	Minted          decimal.Decimal `db:"minted"`           // (postgre: numeric)**该高度内新增**的铸造量（delta）。
	TotalMints      decimal.Decimal `db:"total_mints"`      // (postgre: numeric)截至该高度的**累计铸造总量**。
	Burned          decimal.Decimal `db:"burned"`           // (postgre: numeric)**该高度内销毁**量（delta，若协议/实现支持）。
	TotalBurns      decimal.Decimal `db:"total_burns"`      // (postgre: numeric)截至该高度的**累计销毁总量**。
	TotalOperations int64           `db:"total_operations"` // (postgre: int8)截至该高度与该 Rune 有关的累计事件数（便于做增量/校验）。默认 0。
}

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

type WalletInfo struct {
	P2PKH      string `json:"p2pkh"`
	P2PSH      string `json:"p2psh"`
	P2WPKH     string `json:"p2wpkh"`
	P2TR       string `json:"p2tr"`
	Mnemonic   string `json:"mnemonic"`
	XPRV       string `json:"xprv"`
	BTCBalance int64  `json:"btc_balance,omitempty"`
}