exchange

Base system with REST service to issue digital coins, run by the payment service provider
Log | Files | Refs | Submodules | README | LICENSE

iterate_prewires_below_open_shards.h (2080B)


      1 /*
      2    This file is part of TALER
      3    Copyright (C) 2026 Taler Systems SA
      4 
      5    TALER is free software; you can redistribute it and/or modify it under the
      6    terms of the GNU General Public License as published by the Free Software
      7    Foundation; either version 3, or (at your option) any later version.
      8 
      9    TALER is distributed in the hope that it will be useful, but WITHOUT ANY
     10    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
     11    A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
     12 
     13    You should have received a copy of the GNU General Public License along with
     14    TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
     15  */
     16 /**
     17  * @file src/include/exchange-database/iterate_prewires_below_open_shards.h
     18  * @brief implementation of the iterate_prewires_below_open_shards function for Postgres
     19  * @author Christian Grothoff
     20  */
     21 #ifndef EXCHANGE_DATABASE_ITERATE_PREWIRES_BELOW_OPEN_SHARDS_H
     22 #define EXCHANGE_DATABASE_ITERATE_PREWIRES_BELOW_OPEN_SHARDS_H
     23 
     24 #include "taler/taler_json_lib.h"
     25 #include "exchangedb_lib.h"
     26 #include "exchange-database/iterate_prewires.h"
     27 
     28 
     29 /**
     30  * Function called to get unfinished wire transfer preparations that lie
     31  * below every shard of @a job_name that is still open, that is, in shards
     32  * that were completed while the transaction inserting the row had not yet
     33  * committed.  Locks the rows returned until the end of the transaction and
     34  * skips rows another transaction holds locked.
     35  *
     36  * Primary test table: `prewire` (see test_prewire.c).
     37  *
     38  * @param pg the database context
     39  * @param job_name name of the work shard job that processes `prewire`
     40  * @param limit maximum number of results to return
     41  * @param cb function to call for each unfinished item
     42  * @param cb_cls closure for @a cb
     43  * @return transaction status code
     44  */
     45 enum GNUNET_DB_QueryStatus
     46 TALER_EXCHANGEDB_iterate_prewires_below_open_shards (
     47   struct TALER_EXCHANGEDB_PostgresContext *pg,
     48   const char *job_name,
     49   uint64_t limit,
     50   TALER_EXCHANGEDB_WirePreparationIterator cb,
     51   void *cb_cls);
     52 
     53 #endif