backup

type AssetBackup struct {
	// Asset contains the core asset state including amount, version,
	// script key, and witnesses.
	Asset *asset.Asset

	// AnchorOutpoint is the outpoint where this asset is currently
	// anchored.
	AnchorOutpoint wire.OutPoint

	// AnchorBlockHeight is the block height where this asset was confirmed.
	AnchorBlockHeight uint32

	// ScriptKeyInfo contains the key derivation information needed to
	// reconstruct the script key for spending.
	ScriptKeyInfo *ScriptKeyBackup

	// AnchorInternalKeyInfo contains the key derivation information for the
	// internal key used in the anchor taproot output.
	AnchorInternalKeyInfo *KeyDescriptorBackup

	// ProofFileBlob contains the complete encoded proof file for
	// this asset. This preserves the full proof chain and all
	// proof data without needing to reconstruct anything.
	// Used in v1 backups.
	ProofFileBlob []byte

	// StrippedProofFileBlob contains a proof file with blockchain-
	// derivable fields removed (BlockHeader, AnchorTx, TxMerkleProof,
	// BlockHeight). Used in v2+ backups to reduce backup size.
	StrippedProofFileBlob []byte

	// RehydrationHintsBlob contains the serialized FileHints needed
	// to reconstruct the stripped fields from blockchain data.
	// Used in v2+ backups alongside StrippedProofFileBlob.
	RehydrationHintsBlob []byte

	// AnchorOutputPkScript is the pk_script of the anchor output.
	// Needed for registering spend notifications during import.
	AnchorOutputPkScript []byte
}

type ChainQuerier interface {
	// GetBlockByHeight returns a full block given its height.
	GetBlockByHeight(ctx context.Context,
		blockHeight int64) (*wire.MsgBlock, error)
}

type ExportMode int

type FileHints struct {
	// Hints contains the rehydration hints for each proof transition.
	Hints []ProofHint
}

type ImportConfig struct {
	// SpendChecker is used to detect stale backup entries whose anchor
	// outpoints have already been spent.
	SpendChecker SpendChecker

	// ChainQuerier provides access to blockchain data for rehydrating
	// stripped proofs.
	ChainQuerier ChainQuerier

	// ProofArchive is used to check for existing proofs and to import
	// new proofs.
	ProofArchive proof.Archiver

	// KeyRegistrar is used to register anchor internal keys and script
	// keys so the wallet can sign for imported assets.
	KeyRegistrar KeyRegistrar

	// ProofVerifier provides the verification context for imported proofs.
	ProofVerifier proof.VerifierCtx
}

type KeyDescriptorBackup struct {
	// PubKey is the public key.
	PubKey *btcec.PublicKey

	// KeyLocator contains the derivation path info (family + index).
	KeyLocator keychain.KeyLocator
}

type KeyLocatorLookup interface {
	// FetchInternalKeyLocator returns the key locator for an internal key
	// given its public key. Returns ErrKeyLocatorNotFound if the key is
	// not found.
	FetchInternalKeyLocator(ctx context.Context,
		pubKey *btcec.PublicKey) (keychain.KeyLocator, error)
}

type KeyRegistrar interface {
	// InsertInternalKey inserts an internal key into the database.
	InsertInternalKey(ctx context.Context,
		keyDesc keychain.KeyDescriptor) error

	// InsertScriptKey inserts a script key into the database.
	InsertScriptKey(ctx context.Context, scriptKey asset.ScriptKey,
		keyType asset.ScriptKeyType) error
}

type ProofHint struct {
	// AnchorTxHash is the txid of the anchor transaction. This is used
	// to locate the transaction within its block during rehydration.
	AnchorTxHash [32]byte

	// BlockHeight is the height of the block containing the anchor
	// transaction.
	BlockHeight uint32
}

type ScriptKeyBackup struct {
	// PubKey is the final tweaked script key.
	PubKey *btcec.PublicKey

	// RawKey is the key descriptor for the internal key before tweaking.
	RawKey keychain.KeyDescriptor

	// Tweak is the tweak applied to derive the final script key.
	// If nil, a BIP-0086 tweak is assumed.
	Tweak []byte
}

type SpendChecker interface {
	// RegisterSpendNtfn dispatches a spend notification request to the
	// chain notifier. If the outpoint has already been spent, the
	// notification is dispatched immediately.
	RegisterSpendNtfn(ctx context.Context, outpoint *wire.OutPoint,
		pkScript []byte, heightHint int32,
		optFuncs ...lndclient.NotifierOption) (
		chan *chainntnfs.SpendDetail, chan error, error)
}

type WalletBackup struct {
	// Version is the backup format version.
	Version uint32

	// Assets contains the backup data for each active asset.
	Assets []*AssetBackup

	// FederationURLs contains the universe federation server URLs used
	// in v3 (optimistic) backups to fetch proofs on import.
	FederationURLs []string
}