/*
  This file is part of Anastasis
  Copyright (C) 2020-2022 Anastasis SARL

  Anastasis is free software; you can redistribute it and/or modify it under the
  terms of the GNU Affero General Public License as published by the Free Software
  Foundation; either version 3, or (at your option) any later version.

  Anastasis is distributed in the hope that it will be useful, but WITHOUT ANY
  WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.

  You should have received a copy of the GNU Affero General Public License along with
  Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
*/
/**
 * @file include/anastasis/anastasis-database/iterate_recovery_meta_data.h
 * @brief Anastasis database: iterate recovery meta data
 * @author Christian Grothoff
 */
#ifndef ANASTASIS_DATABASE_ITERATE_RECOVERY_META_DATA_H
#define ANASTASIS_DATABASE_ITERATE_RECOVERY_META_DATA_H

#include <gnunet/gnunet_util_lib.h>
#include <gnunet/gnunet_db_lib.h>
#include "anastasis_service.h"
#include "anastasis/anastasis-database/common.h"

/**
 * Fetch recovery document meta data for user. Returns
 * meta data in descending order from @a max_version.
 * The size of the result set may be limited.
 *
 * @param account_pub public key of the user's account
 * @param max_version the maximum version number the user requests
 * @param cb function to call on each result
 * @param cb_cls closure for @a cb
 * @return transaction status
 */
enum GNUNET_DB_QueryStatus
ANASTASIS_DB_iterate_recovery_meta_data (
  const struct ANASTASIS_CRYPTO_AccountPublicKeyP *account_pub,
  uint32_t max_version,
  ANASTASIS_DB_RecoveryMetaCallback cb,
  void *cb_cls);

#endif
