/*
  This file is part of Challenger
  Copyright (C) 2023 Taler Systems SA

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

  Challenger 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 General Public License for more details.

  You should have received a copy of the GNU General Public License along with
  Challenger; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
*/
/**
 * @file include/challenger_database_lib.h
 * @brief database helper functions for postgres used by challenger
 * @author Christian Grothoff
 */
#ifndef CHALLENGER_DB_LIB_H
#define CHALLENGER_DB_LIB_H

#include <taler/taler_util.h>

struct CHALLENGERDB_PostgresContext;

/**
 * Connect to the challenger database.
 *
 * @param cfg configuration to use
 * @return NULL on failure
 */
struct CHALLENGERDB_PostgresContext *
CHALLENGERDB_connect (
  const struct GNUNET_CONFIGURATION_Handle *cfg);


/**
 * Connect to the challenger database for administration.
 * Disables the check that the database schema is current.
 *
 * @param cfg configuration to use
 * @return NULL on failure
 */
struct CHALLENGERDB_PostgresContext *
CHALLENGERDB_connect_admin (
  const struct GNUNET_CONFIGURATION_Handle *cfg);


/**
 * Disconnect from the challenger database.
 *
 * @param[in] pg context to disconnect and free
 */
void
CHALLENGERDB_disconnect (struct CHALLENGERDB_PostgresContext *pg);


#endif  /* CHALLENGER_DB_LIB_H */

/* end of challenger_database_lib.h */
