core-lightning/wallet/db.h

#ifndef LIGHTNING_WALLET_DB_H
#define LIGHTNING_WALLET_DB_H
#include "config.h"

struct ext_key;
struct lightningd;
struct db_stmt;
struct db;

/**
 * db_setup - Open a the lightningd database and update the schema
 *
 * Opens the database, creating it if necessary, and applying
 * migrations until the schema is updated to the current state.
 * Calls fatal() on error.
 *
 * Params:
 *  @ctx: the tal_t context to allocate from
 *  @ld: the lightningd context to hand to upgrade functions.
 *  @bip32_base: the base all of our pubkeys are constructed on
 */
struct db *db_setup(const tal_t *ctx, struct lightningd *ld,
		    const struct ext_key *bip32_base);

#endif /* LIGHTNING_WALLET_DB_H */
Use expected LIGHTNING_DIR_FILE_H define 2018-03-22 11:36:25 +01:00			`#ifndef LIGHTNING_WALLET_DB_H`
			`#define LIGHTNING_WALLET_DB_H`
wallet: Create and manage a sqlite3 database for the wallet 2017-05-12 20:24:18 +02:00			`#include "config.h"`
wallet: add check-source to makefile. And fix up resulting breakage. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2018-03-07 01:06:07 +01:00
hsmd/wallet: pass the bip32_key down into migrations we're about to add a migration that requires access to the bip32_key in order to calculate missing scriptpubkeys. prior to this patch, we don't have access to the bip32 key in the db migration, as it's set on the wallet but after the db migrations are run. here we patch it through so that every migration can access it 2020-07-29 03:20:30 +02:00			`struct ext_key;`
db: support more powerful migrations. Allow a function as well as (or instead of!) an sql statement. That will let us do things like set per-channel values to the global defaults, for example. Since we remove the NULL termination, the final entry is ARRAY_SIZE()-1 not ARRAY_SIZE()-2. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2019-02-24 06:12:09 +01:00			`struct lightningd;`
db: Implement skaffolding for the dispatch of DB-specific functions These functions implement the lookup of the query, and the dispatch to the DB-specific functions that do the actual heavy lifting. Signed-off-by: Christian Decker <decker.christian@gmail.com> 2019-07-25 22:45:02 +02:00			`struct db_stmt;`
db: Make the `db` struct private and provide accessors instead We will soon generalize the DB, so directly reaching into the `struct db` instance to talk to the sqlite3 connection is bad anyway. This increases flexibility and allows us to tailor the actual implementation to the underlying DB. Signed-off-by: Christian Decker <decker.christian@gmail.com> 2019-07-23 20:45:06 +02:00			`struct db;`
wallet: Add macro to annotate SQL statements These two simple macros have a twofold use: 1) They serve as annotations for the query extraction tool to find them when extracting queries from the C source code. 2) They replace the actual queries with names that can be used to lookup the queries in a table again, once they have been rewritten into the target SQL dialect. Signed-off-by: Christian Decker <decker.christian@gmail.com> 2019-07-17 18:11:19 +02:00
wallet: Create and manage a sqlite3 database for the wallet 2017-05-12 20:24:18 +02:00			`/**`
			`* db_setup - Open a the lightningd database and update the schema`
			`*`
			`* Opens the database, creating it if necessary, and applying`
			`* migrations until the schema is updated to the current state.`
db: we must always be in a transaction, remove nested, call fatal() We save location where transaction was started, in case we try to nest. There's now no error case; db_exec_mayfail() is the only one. This means the tests need to override fatal() if they want to intercept these errors. Signed-off-by: Rusty Russell <rusty@rustcorp.com.au> 2017-11-01 02:21:56 +01:00			`* Calls fatal() on error.`
wallet: Create and manage a sqlite3 database for the wallet 2017-05-12 20:24:18 +02:00			`*`
			`* Params:`
			`* @ctx: the tal_t context to allocate from`
Update wallet/db.h Co-Authored-By: rustyrussell <rusty@rustcorp.com.au> 2019-03-01 23:18:40 +01:00			`* @ld: the lightningd context to hand to upgrade functions.`
hsmd/wallet: pass the bip32_key down into migrations we're about to add a migration that requires access to the bip32_key in order to calculate missing scriptpubkeys. prior to this patch, we don't have access to the bip32 key in the db migration, as it's set on the wallet but after the db migrations are run. here we patch it through so that every migration can access it 2020-07-29 03:20:30 +02:00			`* @bip32_base: the base all of our pubkeys are constructed on`
wallet: Create and manage a sqlite3 database for the wallet 2017-05-12 20:24:18 +02:00			`*/`
hsmd/wallet: pass the bip32_key down into migrations we're about to add a migration that requires access to the bip32_key in order to calculate missing scriptpubkeys. prior to this patch, we don't have access to the bip32 key in the db migration, as it's set on the wallet but after the db migrations are run. here we patch it through so that every migration can access it 2020-07-29 03:20:30 +02:00			`struct db db_setup(const tal_t ctx, struct lightningd *ld,`
			`const struct ext_key *bip32_base);`
wallet: Create and manage a sqlite3 database for the wallet 2017-05-12 20:24:18 +02:00
Use expected LIGHTNING_DIR_FILE_H define 2018-03-22 11:36:25 +01:00			`#endif /* LIGHTNING_WALLET_DB_H */`