psbt

type AnalyzeInputReport struct {
	Index      int
	ScriptType types.AddressType
	HasUtxo    bool
	IsFinal    bool
	Ready      bool
	Missing    []string
}

type AnalyzeReport struct {
	Version     int
	InputCount  int
	OutputCount int
	Inputs      []AnalyzeInputReport
	CanFinalize bool
}

type BIP32Derivation struct {
	PubKey      []byte   // 压缩公钥(33)
	Fingerprint [4]byte  // 父键指纹
	Path        []uint32 // 绝对或相对路径（m/.. 样式外部表示由调用方维护）
}

type BuildResult struct {
	PSBTBase64      string  `json:"psbt_base64"`        // 给 OKX
	UnsignedTxHex   string  `json:"unsigned_tx_hex"`    // 调试/核对
	Packet          *Packet `json:"-"`                  // 你自定义 psbt 结构，便于回写签名/Finalize
	EstimatedVSize  int     `json:"estimated_vsize_vb"` // 估算
	FeeSat          int64   `json:"fee_sat"`
	ChangeOutputIdx int     `json:"change_output_index"` // -1 表示没有找零
}

type CleanupOptions struct {
	KeepWitnessScript bool // 是否保留 WitnessScript/TapLeafScript/ControlBlock/Annex
	KeepRedeemScript  bool // 是否保留 RedeemScript
	KeepUTXO          bool // 是否保留 WitnessUtxo/NonWitnessUtxo
}

type Input struct {
	// 引用的前序输出（v0 可从 UnsignedTx 读取；v2 需要显式设置）
	PrevTxID  chainhash.Hash
	PrevIndex uint32
	Sequence  uint32

	// UTXO 信息（二选一或同时提供，遵循 BIP174）
	NonWitnessUtxo *wire.MsgTx
	WitnessUtxo    *wire.TxOut

	// 脚本与派生信息
	RedeemScript  []byte
	WitnessScript []byte
	BIP32         []BIP32Derivation
	// 通用见证栈（适用于 P2WSH 任意脚本；不含最终脚本本身）
	WitnessStack [][]byte

	// 签名相关
	SighashType uint32            // txscript.SigHashType
	PartialSigs map[string][]byte // pubkey(hex) -> sig (DER+hashtype 或 Schnorr+hashtype)

	// 最终化产物
	FinalScriptSig     []byte
	FinalScriptWitness wire.TxWitness

	// Taproot 脚本路径（tapscript）相关
	// 若使用脚本路径花费，应提供：TapLeafScript、TapControlBlock；
	// 可选提供：TapAnnex（首字节应为 0x50）、TapScriptStack（额外入栈元素，不含脚本与控制块）。
	TapLeafScript   []byte
	TapControlBlock []byte
	TapAnnex        []byte
	TapScriptStack  [][]byte

	// Taproot 签名（PSBT-371 友好建模）
	// Keypath 签名：单一 schnorr+hashtype
	TapKeySig []byte
	// Scriptpath 签名：key = hex(xonlyPubKey)+":"+hex(leafHash)
	TapScriptSigs map[string][]byte
}

type Output struct {
	Value        int64
	ScriptPubKey []byte

	RedeemScript  []byte
	WitnessScript []byte
	BIP32         []BIP32Derivation
}

type Packet struct {
	// 版本：0 或 2
	Version int

	// v0：未签名交易的完整结构
	UnsignedTx *wire.MsgTx

	// v2：交易元数据（不直接包含完整 MsgTx）
	TxVersion int32
	LockTime  uint32

	Inputs  []*Input
	Outputs []*Output

	// Finalize 后清理策略
	Cleanup CleanupOptions
}

type PsbtUTXO struct {
	TxID            string // 大端 txid
	Vout            uint32
	ValueSat        int64  // 金额，sats
	ScriptPubKeyHex string // 前序输出的 pkScript(hex)

	// Legacy P2PKH/P2SH 如要签名，必须提供 non-witness 前序原始交易（hex）
	NonWitnessTxHex string // 可留空（P2WPKH/P2TR 不需要）

	// 可选，P2SH/P2WSH 的 witnessScript(hex)
	RedeemScriptHex string // 可选，P2SH/P2WSH 的 redeemScript(hex)

	// 可选，P2WSH 的 witnessScript(hex)
	WitnessScriptHex string // 可选，P2WSH 的 witnessScript(hex)
}