tx

type AddLiquidityParams struct {
	State    *pool.State
	Deposit0 uint64 // satoshis of Asset0 to add
	Deposit1 uint64 // satoshis of Asset1 to add
	// Pool output addresses (from pool.json)
	PoolAAddr     string
	PoolBAddr     string
	LpReserveAddr string
	// User inputs: one or more UTXOs per asset. Change is returned if total > needed.
	Asset0Inputs []UserInput
	Asset1Inputs []UserInput
	LBTCInputs   []UserInput
	ChangeAddr   string // address to receive any surplus from user inputs
	UserLPAddr   string // address to receive LP tokens
	// Asset IDs
	LPAssetID string
	Asset0    string
	Asset1    string
	LBTCAsset string
	Fee       uint64
	// Pool swap/add-variant binaries, CMRs, and control blocks
	PoolABinaryHex        string
	PoolBBinaryHex        string
	LpReserveBinaryHex    string
	PoolACMRHex           string
	PoolBCMRHex           string
	LpReserveCMRHex       string
	PoolAControlBlock     string
	PoolBControlBlock     string
	LpReserveControlBlock string
}

type AddLiquidityResult struct {
	TxHex            string
	LPMinted         uint64
	PoolAWitness     [][]byte // attach to input[0] after wallet signing
	PoolBWitness     [][]byte // attach to input[1] after wallet signing
	LpReserveWitness [][]byte // attach to input[2] after wallet signing
}

type CreatePoolParams struct {
	// pool_creation UTXO — provides LP issuance anchor + fee
	CreationTxID   string
	CreationVout   uint32
	CreationAmount uint64 // L-BTC sats in the creation UTXO

	// Deposit UTXOs — user wallet UTXOs providing the initial reserves
	Asset0TxID   string
	Asset0Vout   uint32
	Asset0Amount uint64 // total amount in this UTXO (deposit0 + any change)

	Asset1TxID   string
	Asset1Vout   uint32
	Asset1Amount uint64 // total amount in this UTXO (deposit1 + any change)

	BuildDir  string // path to directory containing .shl/.args files
	Deposit0  uint64 // satoshis of Asset0 to lock in pool_a
	Deposit1  uint64 // satoshis of Asset1 to lock in pool_b
	Asset0    string // hex asset ID (display format)
	Asset1    string
	LBTCAsset string // L-BTC asset ID
	Fee       uint64 // satoshis fee (paid from creation UTXO)
	FeeNum    uint64 // protocol fee numerator (for OP_RETURN announcement)
	FeeDen    uint64 // protocol fee denominator (for OP_RETURN announcement)
	Announce  bool   // include OP_RETURN pool announcement output

	ChangeAddr string // address to receive Asset0/Asset1/L-BTC change
	Network    *network.Network
}

type CreatePoolResult struct {
	TxHex             string
	LPAssetID         string // 32-byte hex
	LPMinted          uint64
	PoolConfig        *pool.Config
	SimplicityWitness [][]byte // witness for input[0]; attach after wallet signing
}

type RemoveLiquidityParams struct {
	State        *pool.State
	LPBurned     uint64 // LP tokens to return to reserve
	UserLPAmount uint64 // full LP UTXO balance (input[3] total); change returned to user
	// Pool output addresses
	PoolAAddr     string
	PoolBAddr     string
	LpReserveAddr string
	// User's LP token UTXO (input[3] = LP_RETURN_INPUT in contracts)
	UserLPTxID string
	UserLPVout uint32
	// User's L-BTC UTXO for fee (input[4])
	UserLBTCTxID   string
	UserLBTCVout   uint32
	UserLBTCAmount uint64 // actual UTXO amount; change returned if > Fee
	// Where to send payouts
	UserAsset0Addr string // receives payout0 of Asset0
	UserAsset1Addr string // receives payout1 of Asset1
	ChangeAddr     string // receives LP change and L-BTC change
	// Asset IDs
	Asset0    string
	Asset1    string
	LPAssetID string
	LBTCAsset string
	Fee       uint64
	// Pool remove-variant binaries, CMRs, and control blocks
	PoolABinaryHex        string
	PoolBBinaryHex        string
	LpReserveBinaryHex    string
	PoolACMRHex           string
	PoolBCMRHex           string
	LpReserveCMRHex       string
	PoolAControlBlock     string
	PoolBControlBlock     string
	LpReserveControlBlock string
}

type RemoveLiquidityResult struct {
	TxHex            string
	Payout0          uint64   // Asset0 paid to user
	Payout1          uint64   // Asset1 paid to user
	PoolAWitness     [][]byte // attach to input[0] after wallet signing
	PoolBWitness     [][]byte // attach to input[1] after wallet signing
	LpReserveWitness [][]byte // attach to input[2] after wallet signing
}

type SwapParams struct {
	// Pool state
	State *pool.State
	// Which direction: true = Asset0→Asset1, false = Asset1→Asset0
	SwapAsset0In bool
	// Amount in (satoshis)
	AmountIn uint64
	// Minimum acceptable output (slippage guard, checked off-chain only)
	MinAmountOut uint64
	// User's input UTXO (provides AmountIn of the input asset)
	UserTxID        string
	UserVout        uint32
	UserAsset       string
	UserInputAmount uint64 // actual UTXO amount; change returned if > AmountIn (or > AmountIn+Fee when input is L-BTC)
	// Where to send output asset and change
	UserOutputAddr string
	ChangeAddr     string // receives input asset change and L-BTC change (if any)
	// Pool output addresses (from pool.json)
	PoolAAddr string
	PoolBAddr string
	// Asset IDs
	Asset0    string
	Asset1    string
	LBTCAsset string
	Fee       uint64
	// Fee parameters — must match what was compiled into the contracts.
	// Read from pool.json (Config.FeeNum / Config.FeeDen).
	FeeNum uint64
	FeeDen uint64
	// Optional: separate L-BTC UTXO for fee (when input asset != L-BTC)
	// If not set, fee is deducted from the user's input UTXO (input asset must be L-BTC).
	FeeTxID   string
	FeeVout   uint32
	FeeAmount uint64 // actual fee UTXO amount; L-BTC change returned if > Fee
	// Pool swap-variant binaries, CMRs, and control blocks
	PoolABinaryHex    string
	PoolBBinaryHex    string
	PoolACMRHex       string
	PoolBCMRHex       string
	PoolAControlBlock string
	PoolBControlBlock string
}

type SwapResult struct {
	TxHex        string
	AmountOut    uint64
	PoolAWitness [][]byte // attach to input[0] after wallet signing
	PoolBWitness [][]byte // attach to input[1] after wallet signing
}

type UserInput struct {
	TxID   string
	Vout   uint32
	Amount uint64 // satoshis
}