decoder

type ABIDAI interface {
	GetABIInfo(address string) (*types.ABIInfo, error)
	SetABIInfo(address string, abi types.ABIInfo) error
}

type AddressDecoder interface {
	// PrivateKeyToWIF 将私钥转为 WIF（BTC 系）。
	PrivateKeyToWIF(priv []byte, isTestnet bool) (string, error)
	// PublicKeyToAddress 公钥转链上地址。
	PublicKeyToAddress(pub []byte, isTestnet bool) (string, error)
	// WIFToPrivateKey WIF 转私钥（BTC 系）。
	WIFToPrivateKey(wif string, isTestnet bool) ([]byte, error)
	// RedeemScriptToAddress 赎回脚本转多签地址（BTC 系）。
	RedeemScriptToAddress(pubs [][]byte, required uint64, isTestnet bool) (string, error)
	// AddressDecode 地址解码为内部表示（如字节）。
	AddressDecode(addr string, opts ...interface{}) ([]byte, error)
	// AddressEncode 内部表示编码为链上地址。
	AddressEncode(pub []byte, opts ...interface{}) (string, error)
	// AddressVerify 校验地址格式是否合法。
	AddressVerify(addr string, opts ...interface{}) bool
	// CustomCreateAddress 按链规则派生新地址（可选）。
	CustomCreateAddress(account *types.AssetsAccount, newIndex uint64) (*types.Address, error)
	// SupportCustomCreateAddressFunction 是否支持 CustomCreateAddress。
	SupportCustomCreateAddressFunction() bool
}

type AddressDecoderBase struct{}

type SmartContractDecoder interface {
	ABIDAI

	// GetTokenBalanceByAddress 查询地址代币余额列表
	GetTokenBalanceByAddress(contract types.SmartContract, address ...string) ([]*types.TokenBalance, error)
	// CallSmartContractABI 只读调用合约 ABI 方法，不产生链上交易
	CallSmartContractABI(wrapper wallet.WalletDAI, rawTx *types.SmartContractRawTransaction) (*types.SmartContractCallResult, *types.AdapterError)
	// CreateSmartContractRawTransaction 创建智能合约原始交易单（填充 Raw 等）
	CreateSmartContractRawTransaction(wrapper wallet.WalletDAI, rawTx *types.SmartContractRawTransaction) *types.AdapterError
	// SubmitSmartContractRawTransaction 广播智能合约交易单
	SubmitSmartContractRawTransaction(wrapper wallet.WalletDAI, rawTx *types.SmartContractRawTransaction) (*types.SmartContractReceipt, *types.AdapterError)
	// GetTokenMetadata 根据合约地址查询代币元数据
	GetTokenMetadata(contract string) (*types.SmartContract, error)
}

type SmartContractDecoderBase struct{}

type TransactionDecoder interface {
	// CreateRawTransaction 根据 rawTx 构建原始交易，填充 RawHex、Fees、Signatures 等。若 wrapper 非 nil，可回调查询（如 GetAddress/GetAssetsAccountByAddress、账户列表等）。
	CreateRawTransaction(wrapper wallet.WalletDAI, rawTx *types.RawTransaction) error
	// SignRawTransaction 对 rawTx 进行本地签名并写回 Signatures。签名由外部 MPC 完成时可不实现。
	SignRawTransaction(wrapper wallet.WalletDAI, rawTx *types.RawTransaction) error
	// SubmitRawTransaction 将已签名的 rawTx 提交到链上节点并返回交易结果；调用前应已通过 VerifyRawTransaction。若 wrapper 非 nil 可回调查询。
	SubmitRawTransaction(wrapper wallet.WalletDAI, rawTx *types.RawTransaction) (*types.Transaction, error)
	// VerifyRawTransaction 合并并校验 rawTx 的 Signatures；若 wrapper 非 nil，可回调查询（如校验地址归属）。
	VerifyRawTransaction(wrapper wallet.WalletDAI, rawTx *types.RawTransaction) error
	// GetRawTransactionFeeRate 返回当前链建议的费率与单位（如 "10"、"sat/vB"）。若 wrapper 非 nil 可回调查询。
	GetRawTransactionFeeRate(wrapper wallet.WalletDAI) (feeRate, unit string, err error)
	// EstimateRawTransactionFee 根据 rawTx 估算手续费并写回 rawTx.Fees；若 wrapper 非 nil 可回调查询。
	EstimateRawTransactionFee(wrapper wallet.WalletDAI, rawTx *types.RawTransaction) error
	// CreateSummaryRawTransactionWithError 根据汇总参数生成多笔 RawTransactionWithError；若 wrapper 非 nil 可回调查询（如过滤非本业务地址）。
	CreateSummaryRawTransactionWithError(wrapper wallet.WalletDAI, sumRawTx *types.SummaryRawTransaction) ([]*types.RawTransactionWithError, error)
}

type TransactionDecoderBase struct{}