1 package org.ldk.structs;
3 import org.ldk.impl.bindings;
4 import org.ldk.enums.*;
6 import java.util.Arrays;
10 * FilesystemPersister persists channel data on disk, where each channel's
11 * data is stored in a file named after its funding outpoint.
13 * Warning: this module does the best it can with calls to persist data, but it
14 * can only guarantee that the data is passed to the drive. It is up to the
15 * drive manufacturers to do the actual persistence properly, which they often
16 * don't (especially on consumer-grade hardware). Therefore, it is up to the
17 * user to validate their entire storage stack, to ensure the writes are
19 * Corollary: especially when dealing with larger amounts of money, it is best
20 * practice to have multiple channel data backups and not rely only on one
21 * FilesystemPersister.
23 @SuppressWarnings("unchecked") // We correctly assign various generic arrays
24 public class FilesystemPersister extends CommonBase {
25 FilesystemPersister(Object _dummy, long ptr) { super(ptr); }
26 @Override @SuppressWarnings("deprecation")
27 protected void finalize() throws Throwable {
29 if (ptr != 0) { bindings.FilesystemPersister_free(ptr); }
33 * Initialize a new FilesystemPersister and set the path to the individual channels'
36 public static FilesystemPersister of(String path_to_channel_data) {
37 long ret = bindings.FilesystemPersister_new(path_to_channel_data);
38 FilesystemPersister ret_hu_conv = new FilesystemPersister(null, ret);
39 ret_hu_conv.ptrs_to.add(ret_hu_conv);
44 * Get the directory which was provided when this persister was initialized.
46 public String get_data_dir() {
47 String ret = bindings.FilesystemPersister_get_data_dir(this.ptr);
52 * Read `ChannelMonitor`s from disk.
54 public Result_CVec_C2Tuple_BlockHashChannelMonitorZZErrorZ read_channelmonitors(KeysInterface keys_manager) {
55 long ret = bindings.FilesystemPersister_read_channelmonitors(this.ptr, keys_manager == null ? 0 : keys_manager.ptr);
56 Result_CVec_C2Tuple_BlockHashChannelMonitorZZErrorZ ret_hu_conv = Result_CVec_C2Tuple_BlockHashChannelMonitorZZErrorZ.constr_from_ptr(ret);
57 this.ptrs_to.add(keys_manager);
62 * Constructs a new Persist which calls the relevant methods on this_arg.
63 * This copies the `inner` pointer in this_arg and thus the returned Persist must be freed before this_arg is
65 public Persist as_Persist() {
66 long ret = bindings.FilesystemPersister_as_Persist(this.ptr);
67 Persist ret_hu_conv = new Persist(null, ret);
68 ret_hu_conv.ptrs_to.add(this);