wallet

type BridgeAttestation struct {
	SourceChain      ChainType
	DestinationChain ChainType
	MessageID        ids.ID
	Payload          []byte
	Validators       []ids.NodeID
	Signatures       [][]byte // Classical signatures
	RingtailSig      []byte   // Aggregated Ringtail signature
}

type BridgeRequest struct {
	SourceChain      ChainType
	DestinationChain ChainType
	AssetID          ids.ID
	Amount           *big.Int
	Recipient        string
	Data             []byte
}

type BridgeWallet interface {
	Wallet

	// CreateBridgeTransaction creates a cross-chain transaction
	CreateBridgeTransaction(ctx context.Context, req *BridgeRequest) (UnsignedTransaction, error)

	// VerifyBridgeAttestation verifies a bridge attestation with Ringtail signatures
	VerifyBridgeAttestation(ctx context.Context, attestation *BridgeAttestation) error
}

type ChainType string

type ChainUTXOs interface {
	AddUTXO(ctx context.Context, destinationChainID ids.ID, utxo *lux.UTXO) error
	RemoveUTXO(ctx context.Context, sourceChainID, utxoID ids.ID) error

	UTXOs(ctx context.Context, sourceChainID ids.ID) ([]*lux.UTXO, error)
	GetUTXO(ctx context.Context, sourceChainID, utxoID ids.ID) (*lux.UTXO, error)
}

type ConfirmationReceipt struct {
	// Identifies the primary chain ("P", "X" or "C")
	ChainAlias string
	// ID of the issued transaction
	TxID ids.ID
	// The time from initiation to confirmation
	TotalDuration time.Duration
	// The time from issuance to confirmation. It does not include the duration
	// of issuance.
	ConfirmationDuration time.Duration
}

type Factory interface {
	// CreateWallet creates a wallet for the specified chain
	CreateWallet(ctx context.Context, chainType ChainType, keyManager KeyManager, config interface{}) (Wallet, error)

	// CreateBridgeWallet creates a bridge-enabled wallet
	CreateBridgeWallet(ctx context.Context, chainType ChainType, keyManager KeyManager, config interface{}) (BridgeWallet, error)
}

type IssuanceReceipt struct {
	// Identifies the primary chain ("P", "X" or "C")
	ChainAlias string
	// ID of the issued transaction
	TxID ids.ID
	// The time from initiation to issuance
	Duration time.Duration
}

type KeyManager interface {
	// GetPrivateKey returns the ECDSA private key
	GetPrivateKey() *ecdsa.PrivateKey

	// GetPublicKey returns the ECDSA public key
	GetPublicKey() *ecdsa.PublicKey

	// GetRingtailShare returns the Ringtail key share if available
	GetRingtailShare() []byte

	// Sign signs a message
	Sign(message []byte) ([]byte, error)

	// SignWithRingtail signs with Ringtail if available
	SignWithRingtail(message []byte) ([]byte, error)
}

type Option func(*Options)

type Options struct {
	// contains filtered or unexported fields
}

type SignedTransaction interface {
	UnsignedTransaction

	// GetSignatures returns the signatures
	GetSignatures() [][]byte

	// GetRingtailSignature returns the Ringtail signature if present
	GetRingtailSignature() []byte
}

type TransactionRequest struct {
	To      string
	AssetID ids.ID
	Amount  *big.Int
	Fee     *big.Int
	Data    []byte      // For contract calls
	Memo    []byte      // For UTXO chains
	Extra   interface{} // Chain-specific data
}

type TransactionStatus struct {
	ID          ids.ID
	Status      string // pending, confirmed, failed
	BlockNumber uint64
	BlockHash   ids.ID
	Timestamp   uint64
}

type UTXOs interface {
	AddUTXO(ctx context.Context, sourceChainID, destinationChainID ids.ID, utxo *lux.UTXO) error
	RemoveUTXO(ctx context.Context, sourceChainID, destinationChainID, utxoID ids.ID) error

	UTXOs(ctx context.Context, sourceChainID, destinationChainID ids.ID) ([]*lux.UTXO, error)
	GetUTXO(ctx context.Context, sourceChainID, destinationChainID, utxoID ids.ID) (*lux.UTXO, error)
}

type UnsignedTransaction interface {
	// GetID returns the transaction ID
	GetID() ids.ID

	// GetChainType returns the chain type
	GetChainType() ChainType

	// Bytes returns the serialized transaction
	Bytes() []byte
}

type Wallet interface {
	// GetChainType returns the type of blockchain this wallet manages
	GetChainType() ChainType

	// GetWalletType returns whether this is UTXO or account-based
	GetWalletType() WalletType

	// GetAddress returns the primary address for this wallet
	GetAddress() string

	// GetBalance returns the balance for a specific asset
	GetBalance(ctx context.Context, assetID ids.ID) (*big.Int, error)

	// CreateTransaction creates a new transaction
	CreateTransaction(ctx context.Context, req *TransactionRequest) (UnsignedTransaction, error)

	// SignTransaction signs a transaction
	SignTransaction(ctx context.Context, tx UnsignedTransaction) (SignedTransaction, error)

	// BroadcastTransaction broadcasts a signed transaction
	BroadcastTransaction(ctx context.Context, tx SignedTransaction) (ids.ID, error)

	// GetTransactionStatus returns the status of a transaction
	GetTransactionStatus(ctx context.Context, txID ids.ID) (TransactionStatus, error)
}

type WalletType string