src

type Address struct {
	Address string
	Comment string
}

type Addresses map[string]string

type Keys struct {
	ScanSecretKey  [32]byte
	SpendSecretKey [32]byte
	Mnemonic       string
}

type Label struct {
	// todo add created_at field
	Comment       string `json:"comment"`
	*bip352.Label `json:"label"`
}

type LabelsMapping map[[33]byte]Label

type OwnedUTXO struct {
	Txid         [32]byte      `json:"txid,omitempty"`
	Vout         uint32        `json:"vout,omitempty"`
	Amount       uint64        `json:"amount"`
	PrivKeyTweak [32]byte      `json:"priv_key_tweak,omitempty"`
	PubKey       [32]byte      `json:"pub_key,omitempty"`
	Timestamp    uint64        `json:"timestamp,omitempty"`
	State        UTXOState     `json:"utxo_state,omitempty"`
	Label        *bip352.Label `json:"label"` // the pubKey associated with the label
}

type Recipient struct {
	Address    string
	PkScript   []byte
	Amount     int64
	Annotation string
	Data       map[string]any
}

type UTXOMapping map[[36]byte]struct{}

type UTXOState int8

type UtxoCollection []*OwnedUTXO

type Wallet struct {
	PubKeyScan     [33]byte        `json:"pub_key_scan"`
	PubKeySpend    [33]byte        `json:"pub_key_spend"`
	BirthHeight    uint64          `json:"birth_height,omitempty"`
	LastScanHeight uint64          `json:"last_scan,omitempty"`
	UTXOs          UtxoCollection  `json:"utxos,omitempty"`
	Labels         []*bip352.Label `json:"labels"`       // Labels contains all labels except for the change label
	ChangeLabel    *bip352.Label   `json:"change_label"` // ChangeLabel is separate in order to make it clear that it's special and is not just shown like other labels
	NextLabelM     uint32          `json:"next_label_m"` // NextLabelM indicates which m will be used to derive the next label
	// todo Important: if taken out we need to keep the tweak fro that UTXO otherwise it will be found but basically unspendable
	PubKeysToWatch [][32]byte `json:"pub_keys_to_watch"` // todo this can be taken out, we can check for new payments to old pub-keys via electrum.
	Addresses      Addresses  `json:"addresses"`
	// todo should LabelsMapping be integrated with Wallet.Labels
	LabelsMapping LabelsMapping `json:"labels_mapping"` // never show LabelsMapping addresses to the user - it includes the change label which should NEVER be shown to normal users
	UTXOMapping   UTXOMapping   `json:"utxo_mapping"`   // used to keep track of utxos and not add the same twice
	// contains filtered or unexported fields
}