0c86200e9a1535ec378ad0436374ccadbae62deb
[ldk-java] / java_strings.py
1 from bindingstypes import *
2 from enum import Enum
3
4 class Target(Enum):
5     JAVA = 1,
6     ANDROID = 2
7
8 class Consts:
9     def __init__(self, DEBUG: bool, target: Target, **kwargs):
10         self.target = target
11         self.c_array_class_caches = set()
12         self.c_type_map = dict(
13             uint8_t = ['byte'],
14             uint16_t = ['short'],
15             uint32_t = ['int'],
16             uint64_t = ['long'],
17         )
18
19         self.to_hu_conv_templates = dict(
20             ptr = '{human_type} {var_name}_hu_conv = new {human_type}(null, {var_name});',
21             default = '{human_type} {var_name}_hu_conv = new {human_type}(null, {var_name});'
22         )
23
24         self.bindings_header = """package org.ldk.impl;
25 import org.ldk.enums.*;
26
27 public class bindings {
28         public static class VecOrSliceDef {
29                 public long dataptr;
30                 public long datalen;
31                 public long stride;
32                 public VecOrSliceDef(long dataptr, long datalen, long stride) {
33                         this.dataptr = dataptr; this.datalen = datalen; this.stride = stride;
34                 }
35         }
36         static {
37                 System.loadLibrary(\"lightningjni\");
38                 init(java.lang.Enum.class, VecOrSliceDef.class);
39                 init_class_cache();
40         }
41         static native void init(java.lang.Class c, java.lang.Class slicedef);
42         static native void init_class_cache();
43
44         public static native boolean deref_bool(long ptr);
45         public static native long deref_long(long ptr);
46         public static native void free_heap_ptr(long ptr);
47         public static native byte[] read_bytes(long ptr, long len);
48         public static native byte[] get_u8_slice_bytes(long slice_ptr);
49         public static native long bytes_to_u8_vec(byte[] bytes);
50         public static native long new_txpointer_copy_data(byte[] txdata);
51         public static native void txpointer_free(long ptr);
52         public static native byte[] txpointer_get_buffer(long ptr);
53         public static native long vec_slice_len(long vec);
54         public static native long new_empty_slice_vec();
55
56 """
57
58         self.bindings_footer = "}\n"
59
60         self.util_fn_pfx = """package org.ldk.structs;
61 import org.ldk.impl.bindings;
62 import java.util.Arrays;
63 import org.ldk.enums.*;
64
65 public class UtilMethods {
66 """
67         self.util_fn_sfx = "}"
68         self.common_base = """package org.ldk.structs;
69 import java.util.LinkedList;
70 class CommonBase {
71         long ptr;
72         LinkedList<Object> ptrs_to = new LinkedList();
73         protected CommonBase(long ptr) { this.ptr = ptr; }
74         public long _test_only_get_ptr() { return this.ptr; }
75 }
76 """
77
78         self.c_file_pfx = """#include \"org_ldk_impl_bindings.h\"
79 #include <rust_types.h>
80 #include <lightning.h>
81 #include <string.h>
82 #include <stdatomic.h>
83 #include <stdlib.h>
84
85 """
86
87         if not DEBUG:
88             self.c_file_pfx = self.c_file_pfx + """#define MALLOC(a, _) malloc(a)
89 #define FREE(p) if ((long)(p) > 1024) { free(p); }
90 #define DO_ASSERT(a) (void)(a)
91 #define CHECK(a)
92 """
93         else:
94             self.c_file_pfx = self.c_file_pfx + """#include <assert.h>
95 // Always run a, then assert it is true:
96 #define DO_ASSERT(a) do { bool _assert_val = (a); assert(_assert_val); } while(0)
97 // Assert a is true or do nothing
98 #define CHECK(a) DO_ASSERT(a)
99
100 // Running a leak check across all the allocations and frees of the JDK is a mess,
101 // so instead we implement our own naive leak checker here, relying on the -wrap
102 // linker option to wrap malloc/calloc/realloc/free, tracking everyhing allocated
103 // and free'd in Rust or C across the generated bindings shared library.
104 #include <threads.h>
105 #include <execinfo.h>
106 #include <unistd.h>
107 static mtx_t allocation_mtx;
108
109 void __attribute__((constructor)) init_mtx() {
110         DO_ASSERT(mtx_init(&allocation_mtx, mtx_plain) == thrd_success);
111 }
112
113 #define BT_MAX 128
114 typedef struct allocation {
115         struct allocation* next;
116         void* ptr;
117         const char* struct_name;
118         void* bt[BT_MAX];
119         int bt_len;
120         size_t alloc_len;
121 } allocation;
122 static allocation* allocation_ll = NULL;
123
124 void* __real_malloc(size_t len);
125 void* __real_calloc(size_t nmemb, size_t len);
126 static void new_allocation(void* res, const char* struct_name, size_t len) {
127         allocation* new_alloc = __real_malloc(sizeof(allocation));
128         new_alloc->ptr = res;
129         new_alloc->struct_name = struct_name;
130         new_alloc->bt_len = backtrace(new_alloc->bt, BT_MAX);
131         new_alloc->alloc_len = len;
132         DO_ASSERT(mtx_lock(&allocation_mtx) == thrd_success);
133         new_alloc->next = allocation_ll;
134         allocation_ll = new_alloc;
135         DO_ASSERT(mtx_unlock(&allocation_mtx) == thrd_success);
136 }
137 static void* MALLOC(size_t len, const char* struct_name) {
138         void* res = __real_malloc(len);
139         new_allocation(res, struct_name, len);
140         return res;
141 }
142 void __real_free(void* ptr);
143 static void alloc_freed(void* ptr) {
144         allocation* p = NULL;
145         DO_ASSERT(mtx_lock(&allocation_mtx) == thrd_success);
146         allocation* it = allocation_ll;
147         while (it->ptr != ptr) {
148                 p = it; it = it->next;
149                 if (it == NULL) {
150                         fprintf(stderr, "Tried to free unknown pointer %p at:\\n", ptr);
151                         void* bt[BT_MAX];
152                         int bt_len = backtrace(bt, BT_MAX);
153                         backtrace_symbols_fd(bt, bt_len, STDERR_FILENO);
154                         fprintf(stderr, "\\n\\n");
155                         DO_ASSERT(mtx_unlock(&allocation_mtx) == thrd_success);
156                         return; // addrsan should catch malloc-unknown and print more info than we have
157                 }
158         }
159         if (p) { p->next = it->next; } else { allocation_ll = it->next; }
160         DO_ASSERT(mtx_unlock(&allocation_mtx) == thrd_success);
161         DO_ASSERT(it->ptr == ptr);
162         __real_free(it);
163 }
164 static void FREE(void* ptr) {
165         if ((long)ptr < 1024) return; // Rust loves to create pointers to the NULL page for dummys
166         alloc_freed(ptr);
167         __real_free(ptr);
168 }
169
170 void* __wrap_malloc(size_t len) {
171         void* res = __real_malloc(len);
172         new_allocation(res, "malloc call", len);
173         return res;
174 }
175 void* __wrap_calloc(size_t nmemb, size_t len) {
176         void* res = __real_calloc(nmemb, len);
177         new_allocation(res, "calloc call", len);
178         return res;
179 }
180 void __wrap_free(void* ptr) {
181         if (ptr == NULL) return;
182         alloc_freed(ptr);
183         __real_free(ptr);
184 }
185
186 void* __real_realloc(void* ptr, size_t newlen);
187 void* __wrap_realloc(void* ptr, size_t len) {
188         if (ptr != NULL) alloc_freed(ptr);
189         void* res = __real_realloc(ptr, len);
190         new_allocation(res, "realloc call", len);
191         return res;
192 }
193 void __wrap_reallocarray(void* ptr, size_t new_sz) {
194         // Rust doesn't seem to use reallocarray currently
195         DO_ASSERT(false);
196 }
197
198 void __attribute__((destructor)) check_leaks() {
199         size_t alloc_count = 0;
200         size_t alloc_size = 0;
201         fprintf(stderr, "The following LDK-allocated blocks still remain.\\n");
202         fprintf(stderr, "Note that this is only accurate if System.gc(); System.runFinalization()\\n");
203         fprintf(stderr, "was called prior to exit after all LDK objects were out of scope.\\n");
204         for (allocation* a = allocation_ll; a != NULL; a = a->next) {
205                 fprintf(stderr, "%s %p (%lu bytes) remains:\\n", a->struct_name, a->ptr, a->alloc_len);
206                 backtrace_symbols_fd(a->bt, a->bt_len, STDERR_FILENO);
207                 fprintf(stderr, "\\n\\n");
208                 alloc_count++;
209                 alloc_size += a->alloc_len;
210         }
211         fprintf(stderr, "%lu allocations remained for %lu bytes.\\n", alloc_count, alloc_size);
212         fprintf(stderr, "Note that this is only accurate if System.gc(); System.runFinalization()\\n");
213         fprintf(stderr, "was called prior to exit after all LDK objects were out of scope.\\n");
214 }
215 """
216         self.c_file_pfx = self.c_file_pfx + """
217 static jmethodID ordinal_meth = NULL;
218 static jmethodID slicedef_meth = NULL;
219 static jclass slicedef_cls = NULL;
220 JNIEXPORT void Java_org_ldk_impl_bindings_init(JNIEnv * env, jclass _b, jclass enum_class, jclass slicedef_class) {
221         ordinal_meth = (*env)->GetMethodID(env, enum_class, "ordinal", "()I");
222         CHECK(ordinal_meth != NULL);
223         slicedef_meth = (*env)->GetMethodID(env, slicedef_class, "<init>", "(JJJ)V");
224         CHECK(slicedef_meth != NULL);
225         slicedef_cls = (*env)->NewGlobalRef(env, slicedef_class);
226         CHECK(slicedef_cls != NULL);
227 }
228
229 JNIEXPORT jboolean JNICALL Java_org_ldk_impl_bindings_deref_1bool (JNIEnv * env, jclass _a, jlong ptr) {
230         return *((bool*)ptr);
231 }
232 JNIEXPORT jlong JNICALL Java_org_ldk_impl_bindings_deref_1long (JNIEnv * env, jclass _a, jlong ptr) {
233         return *((long*)ptr);
234 }
235 JNIEXPORT void JNICALL Java_org_ldk_impl_bindings_free_1heap_1ptr (JNIEnv * env, jclass _a, jlong ptr) {
236         FREE((void*)ptr);
237 }
238 JNIEXPORT jbyteArray JNICALL Java_org_ldk_impl_bindings_read_1bytes (JNIEnv * env, jclass _b, jlong ptr, jlong len) {
239         jbyteArray ret_arr = (*env)->NewByteArray(env, len);
240         (*env)->SetByteArrayRegion(env, ret_arr, 0, len, (unsigned char*)ptr);
241         return ret_arr;
242 }
243 JNIEXPORT jbyteArray JNICALL Java_org_ldk_impl_bindings_get_1u8_1slice_1bytes (JNIEnv * env, jclass _b, jlong slice_ptr) {
244         LDKu8slice *slice = (LDKu8slice*)slice_ptr;
245         jbyteArray ret_arr = (*env)->NewByteArray(env, slice->datalen);
246         (*env)->SetByteArrayRegion(env, ret_arr, 0, slice->datalen, slice->data);
247         return ret_arr;
248 }
249 JNIEXPORT int64_t impl_bindings_bytes_1to_1u8_1vec (JNIEnv * env, jclass _b, jbyteArray bytes) {
250         LDKCVec_u8Z *vec = (LDKCVec_u8Z*)MALLOC(sizeof(LDKCVec_u8Z), "LDKCVec_u8");
251         vec->datalen = (*env)->GetArrayLength(env, bytes);
252         vec->data = (uint8_t*)MALLOC(vec->datalen, "LDKCVec_u8Z Bytes");
253         (*env)->GetByteArrayRegion (env, bytes, 0, vec->datalen, vec->data);
254         return (long)vec;
255 }
256 JNIEXPORT jbyteArray JNICALL Java_org_ldk_impl_bindings_txpointer_1get_1buffer (JNIEnv * env, jclass _b, jlong ptr) {
257         LDKTransaction *txdata = (LDKTransaction*)ptr;
258         LDKu8slice slice;
259         slice.data = txdata->data;
260         slice.datalen = txdata->datalen;
261         return Java_org_ldk_impl_bindings_get_1u8_1slice_1bytes(env, _b, (long)&slice);
262 }
263 JNIEXPORT int64_t JNICALL Java_org_ldk_impl_bindings_new_1txpointer_1copy_1data (JNIEnv * env, jclass _b, jbyteArray bytes) {
264         LDKTransaction *txdata = (LDKTransaction*)MALLOC(sizeof(LDKTransaction), "LDKTransaction");
265         txdata->datalen = (*env)->GetArrayLength(env, bytes);
266         txdata->data = (uint8_t*)MALLOC(txdata->datalen, "Tx Data Bytes");
267         txdata->data_is_owned = false;
268         (*env)->GetByteArrayRegion (env, bytes, 0, txdata->datalen, txdata->data);
269         return (long)txdata;
270 }
271 JNIEXPORT void JNICALL Java_org_ldk_impl_bindings_txpointer_1free (JNIEnv * env, jclass _b, jlong ptr) {
272         LDKTransaction *tx = (LDKTransaction*)ptr;
273         tx->data_is_owned = true;
274         Transaction_free(*tx);
275         FREE((void*)ptr);
276 }
277 JNIEXPORT jlong JNICALL Java_org_ldk_impl_bindings_vec_1slice_1len (JNIEnv * env, jclass _a, jlong ptr) {
278         // Check offsets of a few Vec types are all consistent as we're meant to be generic across types
279         _Static_assert(offsetof(LDKCVec_u8Z, datalen) == offsetof(LDKCVec_SignatureZ, datalen), "Vec<*> needs to be mapped identically");
280         _Static_assert(offsetof(LDKCVec_u8Z, datalen) == offsetof(LDKCVec_MessageSendEventZ, datalen), "Vec<*> needs to be mapped identically");
281         _Static_assert(offsetof(LDKCVec_u8Z, datalen) == offsetof(LDKCVec_EventZ, datalen), "Vec<*> needs to be mapped identically");
282         _Static_assert(offsetof(LDKCVec_u8Z, datalen) == offsetof(LDKCVec_C2Tuple_usizeTransactionZZ, datalen), "Vec<*> needs to be mapped identically");
283         LDKCVec_u8Z *vec = (LDKCVec_u8Z*)ptr;
284         return (long)vec->datalen;
285 }
286 JNIEXPORT int64_t JNICALL Java_org_ldk_impl_bindings_new_1empty_1slice_1vec (JNIEnv * env, jclass _b) {
287         // Check sizes of a few Vec types are all consistent as we're meant to be generic across types
288         _Static_assert(sizeof(LDKCVec_u8Z) == sizeof(LDKCVec_SignatureZ), "Vec<*> needs to be mapped identically");
289         _Static_assert(sizeof(LDKCVec_u8Z) == sizeof(LDKCVec_MessageSendEventZ), "Vec<*> needs to be mapped identically");
290         _Static_assert(sizeof(LDKCVec_u8Z) == sizeof(LDKCVec_EventZ), "Vec<*> needs to be mapped identically");
291         _Static_assert(sizeof(LDKCVec_u8Z) == sizeof(LDKCVec_C2Tuple_usizeTransactionZZ), "Vec<*> needs to be mapped identically");
292         LDKCVec_u8Z *vec = (LDKCVec_u8Z*)MALLOC(sizeof(LDKCVec_u8Z), "Empty LDKCVec");
293         vec->data = NULL;
294         vec->datalen = 0;
295         return (long)vec;
296 }
297
298 // We assume that CVec_u8Z and u8slice are the same size and layout (and thus pointers to the two can be mixed)
299 _Static_assert(sizeof(LDKCVec_u8Z) == sizeof(LDKu8slice), "Vec<u8> and [u8] need to have been mapped identically");
300 _Static_assert(offsetof(LDKCVec_u8Z, data) == offsetof(LDKu8slice, data), "Vec<u8> and [u8] need to have been mapped identically");
301 _Static_assert(offsetof(LDKCVec_u8Z, datalen) == offsetof(LDKu8slice, datalen), "Vec<u8> and [u8] need to have been mapped identically");
302
303 _Static_assert(sizeof(jlong) == sizeof(int64_t), "We assume that j-types are the same as C types");
304 _Static_assert(sizeof(jbyte) == sizeof(char), "We assume that j-types are the same as C types");
305 _Static_assert(sizeof(void*) <= 8, "Pointers must fit into 64 bits");
306
307 typedef jlongArray int64_tArray;
308 typedef jbyteArray int8_tArray;
309
310 static inline jstring str_ref_to_java(JNIEnv *env, const char* chars, size_t len) {
311         // Sadly we need to create a temporary because Java can't accept a char* without a 0-terminator
312         char* err_buf = MALLOC(len + 1, "str conv buf");
313         memcpy(err_buf, chars, len);
314         err_buf[len] = 0;
315         jstring err_conv = (*env)->NewStringUTF(env, chars);
316         FREE(err_buf);
317         return err_conv;
318 }
319 static inline LDKStr java_to_owned_str(JNIEnv *env, jstring str) {
320         uint64_t str_len = (*env)->GetStringUTFLength(env, str);
321         char* newchars = MALLOC(str_len + 1, "String chars");
322         const char* jchars = (*env)->GetStringUTFChars(env, str, NULL);
323         memcpy(newchars, jchars, str_len);
324         newchars[str_len] = 0;
325         (*env)->ReleaseStringUTFChars(env, str, jchars);
326         LDKStr res = {
327                 .chars = newchars,
328                 .len = str_len,
329                 .chars_is_owned = true
330         };
331         return res;
332 }
333 """
334
335         self.hu_struct_file_prefix = """package org.ldk.structs;
336
337 import org.ldk.impl.bindings;
338 import org.ldk.enums.*;
339 import org.ldk.util.*;
340 import java.util.Arrays;
341
342 """
343         self.c_fn_ty_pfx = "JNIEXPORT "
344         self.c_fn_args_pfx = "JNIEnv *env, jclass clz"
345         self.file_ext = ".java"
346         self.ptr_c_ty = "int64_t"
347         self.ptr_native_ty = "long"
348         self.result_c_ty = "jclass"
349         self.ptr_arr = "jobjectArray"
350         self.get_native_arr_len_call = ("(*env)->GetArrayLength(env, ", ")")
351
352     def release_native_arr_ptr_call(self, ty_info, arr_var, arr_ptr_var):
353         if ty_info.subty is None or not ty_info.subty.c_ty.endswith("Array"):
354             return "(*env)->ReleasePrimitiveArrayCritical(env, " + arr_var + ", " + arr_ptr_var + ", 0)"
355         return None
356     def create_native_arr_call(self, arr_len, ty_info):
357         if ty_info.c_ty == "int8_tArray":
358             return "(*env)->NewByteArray(env, " + arr_len + ")"
359         elif ty_info.subty.c_ty.endswith("Array"):
360             clz_var = ty_info.java_fn_ty_arg[1:].replace("[", "arr_of_")
361             self.c_array_class_caches.add(clz_var)
362             return "(*env)->NewObjectArray(env, " + arr_len + ", " + clz_var + "_clz, NULL);\n"
363         else:
364             return "(*env)->New" + ty_info.java_ty.strip("[]").title() + "Array(env, " + arr_len + ")"
365     def set_native_arr_contents(self, arr_name, arr_len, ty_info):
366         if ty_info.c_ty == "int8_tArray":
367             return ("(*env)->SetByteArrayRegion(env, " + arr_name + ", 0, " + arr_len + ", ", ")")
368         else:
369             assert False
370     def get_native_arr_contents(self, arr_name, dest_name, arr_len, ty_info, copy):
371         if ty_info.c_ty == "int8_tArray":
372             if copy:
373                 return "(*env)->GetByteArrayRegion(env, " + arr_name + ", 0, " + arr_len + ", " + dest_name + ")"
374             else:
375                 return "(*env)->GetByteArrayElements (env, " + arr_name + ", NULL)"
376         elif not ty_info.java_ty[:len(ty_info.java_ty) - 2].endswith("[]"):
377             return "(*env)->Get" + ty_info.subty.java_ty.title() + "ArrayElements (env, " + arr_name + ", NULL)"
378         else:
379             return None
380     def get_native_arr_elem(self, arr_name, idxc, ty_info):
381         if self.get_native_arr_contents(arr_name, "", "", ty_info, False) is None:
382             return "(*env)->GetObjectArrayElement(env, " + arr_name + ", " + idxc + ")"
383         else:
384             assert False # Only called if above is None
385     def get_native_arr_ptr_call(self, ty_info):
386         if ty_info.subty is not None and ty_info.subty.c_ty.endswith("Array"):
387             return None
388         return ("(*env)->GetPrimitiveArrayCritical(env, ", ", NULL)")
389     def get_native_arr_entry_call(self, ty_info, arr_name, idxc, entry_access):
390         if ty_info.subty is None or not ty_info.subty.c_ty.endswith("Array"):
391             return None
392         return "(*env)->SetObjectArrayElement(env, " + arr_name + ", " + idxc + ", " + entry_access + ")"
393     def cleanup_native_arr_ref_contents(self, arr_name, dest_name, arr_len, ty_info):
394         if ty_info.c_ty == "int8_tArray":
395             return "(*env)->ReleaseByteArrayElements(env, " + arr_name + ", (int8_t*)" + dest_name + ", 0);"
396         else:
397             return "(*env)->Release" + ty_info.java_ty.strip("[]").title() + "ArrayElements(env, " + arr_name + ", " + dest_name + ", 0)"
398
399     def str_ref_to_native_call(self, var_name, str_len):
400         return "str_ref_to_java(env, " + var_name + ", " + str_len + ")"
401     def str_ref_to_c_call(self, var_name):
402         return "java_to_owned_str(env, " + var_name + ")"
403
404     def c_fn_name_define_pfx(self, fn_name, has_args):
405         if has_args:
406             return "JNICALL Java_org_ldk_impl_bindings_" + fn_name.replace("_", "_1") + "(JNIEnv *env, jclass clz, "
407         return "JNICALL Java_org_ldk_impl_bindings_" + fn_name.replace("_", "_1") + "(JNIEnv *env, jclass clz"
408
409     def init_str(self):
410         res = ""
411         for ty in sorted(self.c_array_class_caches):
412             res = res + "static jclass " + ty + "_clz = NULL;\n"
413         res = res + "JNIEXPORT void Java_org_ldk_impl_bindings_init_1class_1cache(JNIEnv * env, jclass clz) {\n"
414         for ty in sorted(self.c_array_class_caches):
415             res = res + "\t" + ty + "_clz = (*env)->FindClass(env, \"" + ty.replace("arr_of_", "[") + "\");\n"
416             res = res + "\tCHECK(" + ty + "_clz != NULL);\n"
417             res = res + "\t" + ty + "_clz = (*env)->NewGlobalRef(env, " + ty + "_clz);\n"
418         res = res + "}\n"
419         return res
420
421     def native_c_unitary_enum_map(self, struct_name, variants, enum_doc_comment):
422         out_java_enum = "package org.ldk.enums;\n\n"
423         out_java = ""
424         out_c = ""
425         out_c = out_c + "static inline " + struct_name + " " + struct_name + "_from_java(" + self.c_fn_args_pfx + ") {\n"
426         out_c = out_c + "\tswitch ((*env)->CallIntMethod(env, clz, ordinal_meth)) {\n"
427
428         if enum_doc_comment is not None:
429             out_java_enum += "/**\n * " + enum_doc_comment.replace("\n", "\n * ") + "\n */\n"
430         out_java_enum += "public enum " + struct_name + " {\n"
431         ord_v = 0
432         for var in variants:
433             out_java_enum = out_java_enum + "\t" + var + ",\n"
434             out_c = out_c + "\t\tcase %d: return %s;\n" % (ord_v, var)
435             ord_v = ord_v + 1
436         out_java_enum = out_java_enum + "\t; static native void init();\n"
437         out_java_enum = out_java_enum + "\tstatic { init(); }\n"
438         out_java_enum = out_java_enum + "}"
439         out_java = out_java + "\tstatic { " + struct_name + ".values(); /* Force enum statics to run */ }\n"
440         out_c = out_c + "\t}\n"
441         out_c = out_c + "\tabort();\n"
442         out_c = out_c + "}\n"
443
444         out_c = out_c + "static jclass " + struct_name + "_class = NULL;\n"
445         for var in variants:
446             out_c = out_c + "static jfieldID " + struct_name + "_" + var + " = NULL;\n"
447         out_c = out_c + self.c_fn_ty_pfx + "void JNICALL Java_org_ldk_enums_" + struct_name.replace("_", "_1") + "_init (" + self.c_fn_args_pfx + ") {\n"
448         out_c = out_c + "\t" + struct_name + "_class = (*env)->NewGlobalRef(env, clz);\n"
449         out_c = out_c + "\tCHECK(" + struct_name + "_class != NULL);\n"
450         for var in variants:
451             out_c = out_c + "\t" + struct_name + "_" + var + " = (*env)->GetStaticFieldID(env, " + struct_name + "_class, \"" + var + "\", \"Lorg/ldk/enums/" + struct_name + ";\");\n"
452             out_c = out_c + "\tCHECK(" + struct_name + "_" + var + " != NULL);\n"
453         out_c = out_c + "}\n"
454         out_c = out_c + "static inline jclass " + struct_name + "_to_java(JNIEnv *env, " + struct_name + " val) {\n"
455         out_c = out_c + "\tswitch (val) {\n"
456         ord_v = 0
457         for var in variants:
458             out_c = out_c + "\t\tcase " + var + ":\n"
459             out_c = out_c + "\t\t\treturn (*env)->GetStaticObjectField(env, " + struct_name + "_class, " + struct_name + "_" + var + ");\n"
460             ord_v = ord_v + 1
461         out_c = out_c + "\t\tdefault: abort();\n"
462         out_c = out_c + "\t}\n"
463         out_c = out_c + "}\n\n"
464
465         return (out_c, out_java_enum, out_java)
466
467     def c_unitary_enum_to_native_call(self, ty_info):
468         return (ty_info.rust_obj + "_to_java(env, ", ")")
469     def native_unitary_enum_to_c_call(self, ty_info):
470         return (ty_info.rust_obj + "_from_java(env, ", ")")
471
472     def c_complex_enum_pfx(self, struct_name, variants, init_meth_jty_strs):
473         out_c = ""
474         for var in variants:
475             out_c = out_c + "static jclass " + struct_name + "_" + var + "_class = NULL;\n"
476             out_c = out_c + "static jmethodID " + struct_name + "_" + var + "_meth = NULL;\n"
477         out_c = out_c + self.c_fn_ty_pfx + "void JNICALL Java_org_ldk_impl_bindings_00024" + struct_name.replace("_", "_1") + "_init (" + self.c_fn_args_pfx + ") {\n"
478         for var_name in variants:
479             out_c = out_c + "\t" + struct_name + "_" + var_name + "_class =\n"
480             if self.target == Target.ANDROID:
481                 out_c = out_c + "\t\t(*env)->NewGlobalRef(env, (*env)->FindClass(env, \"org/ldk/impl/bindings$" + struct_name + "$" + var_name + "\"));\n"
482             else:
483                 out_c = out_c + "\t\t(*env)->NewGlobalRef(env, (*env)->FindClass(env, \"Lorg/ldk/impl/bindings$" + struct_name + "$" + var_name + ";\"));\n"
484             out_c = out_c + "\tCHECK(" + struct_name + "_" + var_name + "_class != NULL);\n"
485             out_c = out_c + "\t" + struct_name + "_" + var_name + "_meth = (*env)->GetMethodID(env, " + struct_name + "_" + var_name + "_class, \"<init>\", \"(" + init_meth_jty_strs[var_name] + ")V\");\n"
486             out_c = out_c + "\tCHECK(" + struct_name + "_" + var_name + "_meth != NULL);\n"
487         out_c = out_c + "}\n"
488         return out_c
489
490     def c_complex_enum_pass_ty(self, struct_name):
491         return "jobject"
492
493     def c_constr_native_complex_enum(self, struct_name, variant, c_params):
494         ret = "(*env)->NewObject(env, " + struct_name + "_" + variant + "_class, " + struct_name + "_" + variant + "_meth"
495         for param in c_params:
496             ret = ret + ", " + param
497         return ret + ")"
498
499     def native_c_map_trait(self, struct_name, field_vars, flattened_field_vars, field_fns, trait_doc_comment):
500         out_java_trait = ""
501         out_java = ""
502
503         # First generate most of the Java code, note that we need information about java method argument strings for C
504         out_java_trait = out_java_trait + self.hu_struct_file_prefix
505         if trait_doc_comment is not None:
506             out_java_trait += "/**\n * " + trait_doc_comment.replace("\n", "\n * ") + "\n */\n"
507         out_java_trait += "@SuppressWarnings(\"unchecked\") // We correctly assign various generic arrays\n"
508         out_java_trait = out_java_trait + "public class " + struct_name.replace("LDK","") + " extends CommonBase {\n"
509         out_java_trait = out_java_trait + "\tfinal bindings." + struct_name + " bindings_instance;\n"
510         out_java_trait = out_java_trait + "\t" + struct_name.replace("LDK", "") + "(Object _dummy, long ptr) { super(ptr); bindings_instance = null; }\n"
511         out_java_trait = out_java_trait + "\tprivate " + struct_name.replace("LDK", "") + "(bindings." + struct_name + " arg"
512         for var in flattened_field_vars:
513             if isinstance(var, ConvInfo):
514                 out_java_trait = out_java_trait + ", " + var.java_hu_ty + " " + var.arg_name
515             else:
516                 out_java_trait = out_java_trait + ", bindings." + var[0] + " " + var[1]
517         out_java_trait = out_java_trait + ") {\n"
518         out_java_trait = out_java_trait + "\t\tsuper(bindings." + struct_name + "_new(arg"
519         for var in flattened_field_vars:
520             if isinstance(var, ConvInfo):
521                 if var.from_hu_conv is not None:
522                     out_java_trait = out_java_trait + ", " + var.from_hu_conv[0]
523                 else:
524                     out_java_trait = out_java_trait + ", " + var.arg_name
525             else:
526                 out_java_trait = out_java_trait + ", " + var[1]
527         out_java_trait = out_java_trait + "));\n"
528         out_java_trait = out_java_trait + "\t\tthis.ptrs_to.add(arg);\n"
529         for var in flattened_field_vars:
530             if isinstance(var, ConvInfo):
531                 if var.from_hu_conv is not None and var.from_hu_conv[1] != "":
532                     out_java_trait = out_java_trait + "\t\t" + var.from_hu_conv[1].replace("\n", "\n\t\t") + ";\n"
533             else:
534                 out_java_trait = out_java_trait + "\t\tthis.ptrs_to.add(" + var[1] + ");\n"
535         out_java_trait = out_java_trait + "\t\tthis.bindings_instance = arg;\n"
536         out_java_trait = out_java_trait + "\t}\n"
537         out_java_trait = out_java_trait + "\t@Override @SuppressWarnings(\"deprecation\")\n"
538         out_java_trait = out_java_trait + "\tprotected void finalize() throws Throwable {\n"
539         out_java_trait = out_java_trait + "\t\tif (ptr != 0) { bindings." + struct_name.replace("LDK","") + "_free(ptr); } super.finalize();\n"
540         out_java_trait = out_java_trait + "\t}\n\n"
541
542         java_trait_constr = "\tprivate static class " + struct_name + "Holder { " + struct_name.replace("LDK", "") + " held; }\n"
543         java_trait_constr = java_trait_constr + "\tpublic static " + struct_name.replace("LDK", "") + " new_impl(" + struct_name.replace("LDK", "") + "Interface arg"
544         for var in flattened_field_vars:
545             if isinstance(var, ConvInfo):
546                 java_trait_constr = java_trait_constr + ", " + var.java_hu_ty + " " + var.arg_name
547             else:
548                 # Ideally we'd be able to take any instance of the interface, but our C code can only represent
549                 # Java-implemented version, so we require users pass a Java implementation here :/
550                 java_trait_constr = java_trait_constr + ", " + var[0].replace("LDK", "") + "." + var[0].replace("LDK", "") + "Interface " + var[1] + "_impl"
551         java_trait_constr = java_trait_constr + ") {\n\t\tfinal " + struct_name + "Holder impl_holder = new " + struct_name + "Holder();\n"
552         java_trait_constr = java_trait_constr + "\t\timpl_holder.held = new " + struct_name.replace("LDK", "") + "(new bindings." + struct_name + "() {\n"
553         out_java_trait = out_java_trait + "\tpublic static interface " + struct_name.replace("LDK", "") + "Interface {\n"
554         out_java = out_java + "\tpublic interface " + struct_name + " {\n"
555         java_meths = []
556         for fn_line in field_fns:
557             java_meth_descr = "("
558             if fn_line.fn_name != "free" and fn_line.fn_name != "clone":
559                 out_java = out_java + "\t\t " + fn_line.ret_ty_info.java_ty + " " + fn_line.fn_name + "("
560                 java_trait_constr = java_trait_constr + "\t\t\t@Override public " + fn_line.ret_ty_info.java_ty + " " + fn_line.fn_name + "("
561                 out_java_trait += "\t\t/**\n\t\t * " + fn_line.docs.replace("\n", "\n\t\t * ") + "\n\t\t */\n"
562                 out_java_trait = out_java_trait + "\t\t" + fn_line.ret_ty_info.java_hu_ty + " " + fn_line.fn_name + "("
563
564                 for idx, arg_conv_info in enumerate(fn_line.args_ty):
565                     if idx >= 1:
566                         out_java = out_java + ", "
567                         java_trait_constr = java_trait_constr + ", "
568                         out_java_trait = out_java_trait + ", "
569                     out_java = out_java + arg_conv_info.java_ty + " " + arg_conv_info.arg_name
570                     out_java_trait = out_java_trait + arg_conv_info.java_hu_ty + " " + arg_conv_info.arg_name
571                     java_trait_constr = java_trait_constr + arg_conv_info.java_ty + " " + arg_conv_info.arg_name
572                     java_meth_descr = java_meth_descr + arg_conv_info.java_fn_ty_arg
573                 java_meth_descr = java_meth_descr + ")" + fn_line.ret_ty_info.java_fn_ty_arg
574                 java_meths.append((fn_line.fn_name, java_meth_descr))
575
576                 out_java = out_java + ");\n"
577                 out_java_trait = out_java_trait + ");\n"
578                 java_trait_constr = java_trait_constr + ") {\n"
579
580                 for arg_info in fn_line.args_ty:
581                     if arg_info.to_hu_conv is not None:
582                         java_trait_constr = java_trait_constr + "\t\t\t\t" + arg_info.to_hu_conv.replace("\n", "\n\t\t\t\t") + "\n"
583
584                 if fn_line.ret_ty_info.java_ty != "void":
585                     java_trait_constr = java_trait_constr + "\t\t\t\t" + fn_line.ret_ty_info.java_hu_ty + " ret = arg." + fn_line.fn_name + "("
586                 else:
587                     java_trait_constr = java_trait_constr + "\t\t\t\targ." + fn_line.fn_name + "("
588
589                 for idx, arg_info in enumerate(fn_line.args_ty):
590                     if idx != 0:
591                         java_trait_constr = java_trait_constr + ", "
592                     if arg_info.to_hu_conv_name is not None:
593                         java_trait_constr = java_trait_constr + arg_info.to_hu_conv_name
594                     else:
595                         java_trait_constr = java_trait_constr + arg_info.arg_name
596
597                 java_trait_constr = java_trait_constr + ");\n"
598                 if fn_line.ret_ty_info.java_ty != "void":
599                     if fn_line.ret_ty_info.from_hu_conv is not None:
600                         java_trait_constr = java_trait_constr + "\t\t\t\t" + fn_line.ret_ty_info.java_ty + " result = " + fn_line.ret_ty_info.from_hu_conv[0] + ";\n"
601                         if fn_line.ret_ty_info.from_hu_conv[1] != "":
602                             java_trait_constr = java_trait_constr + "\t\t\t\t" + fn_line.ret_ty_info.from_hu_conv[1].replace("this", "impl_holder.held") + ";\n"
603                         #if fn_line.ret_ty_info.rust_obj in result_types:
604                         java_trait_constr = java_trait_constr + "\t\t\t\treturn result;\n"
605                     else:
606                         java_trait_constr = java_trait_constr + "\t\t\t\treturn ret;\n"
607                 java_trait_constr = java_trait_constr + "\t\t\t}\n"
608         java_trait_constr = java_trait_constr + "\t\t}"
609         for var in field_vars:
610             if isinstance(var, ConvInfo):
611                 java_trait_constr = java_trait_constr + ", " + var.arg_name
612             else:
613                 java_trait_constr += ", " + var[1] + ".new_impl(" + var[1] + "_impl"
614                 for suparg in var[2]:
615                     if isinstance(suparg, ConvInfo):
616                         java_trait_constr += ", " + suparg.arg_name
617                     else:
618                         java_trait_constr += ", " + suparg[1]
619                 java_trait_constr += ").bindings_instance"
620                 for suparg in var[2]:
621                     if isinstance(suparg, ConvInfo):
622                         java_trait_constr += ", " + suparg.arg_name
623                     else:
624                         java_trait_constr += ", " + suparg[1]
625         out_java_trait = out_java_trait + "\t}\n"
626         out_java_trait = out_java_trait + java_trait_constr + ");\n\t\treturn impl_holder.held;\n\t}\n"
627
628         out_java = out_java + "\t}\n"
629
630         out_java = out_java + "\tpublic static native long " + struct_name + "_new(" + struct_name + " impl"
631         for var in flattened_field_vars:
632             if isinstance(var, ConvInfo):
633                 out_java = out_java + ", " + var.java_ty + " " + var.arg_name
634             else:
635                 out_java = out_java + ", " + var[0] + " " + var[1]
636         out_java = out_java + ");\n"
637
638         # Now that we've written out our java code (and created java_meths), generate C
639         out_c = "typedef struct " + struct_name + "_JCalls {\n"
640         out_c = out_c + "\tatomic_size_t refcnt;\n"
641         out_c = out_c + "\tJavaVM *vm;\n"
642         out_c = out_c + "\tjweak o;\n"
643         for var in flattened_field_vars:
644             if isinstance(var, ConvInfo):
645                 # We're a regular ol' field
646                 pass
647             else:
648                 # We're a supertrait
649                 out_c = out_c + "\t" + var[0] + "_JCalls* " + var[1] + ";\n"
650         for fn in field_fns:
651             if fn.fn_name != "free" and fn.fn_name != "clone":
652                 out_c = out_c + "\tjmethodID " + fn.fn_name + "_meth;\n"
653         out_c = out_c + "} " + struct_name + "_JCalls;\n"
654
655         for fn_line in field_fns:
656             if fn_line.fn_name == "free":
657                 out_c = out_c + "static void " + struct_name + "_JCalls_free(void* this_arg) {\n"
658                 out_c = out_c + "\t" + struct_name + "_JCalls *j_calls = (" + struct_name + "_JCalls*) this_arg;\n"
659                 out_c = out_c + "\tif (atomic_fetch_sub_explicit(&j_calls->refcnt, 1, memory_order_acquire) == 1) {\n"
660                 out_c = out_c + "\t\tJNIEnv *env;\n"
661                 out_c = out_c + "\t\tDO_ASSERT((*j_calls->vm)->GetEnv(j_calls->vm, (void**)&env, JNI_VERSION_1_6) == JNI_OK);\n"
662                 out_c = out_c + "\t\t(*env)->DeleteWeakGlobalRef(env, j_calls->o);\n"
663                 out_c = out_c + "\t\tFREE(j_calls);\n"
664                 out_c = out_c + "\t}\n}\n"
665
666         for idx, fn_line in enumerate(field_fns):
667             if fn_line.fn_name != "free" and fn_line.fn_name != "clone":
668                 assert fn_line.ret_ty_info.ty_info.get_full_rust_ty()[1] == ""
669                 out_c = out_c + fn_line.ret_ty_info.ty_info.get_full_rust_ty()[0] + " " + fn_line.fn_name + "_" + struct_name + "_jcall("
670                 if fn_line.self_is_const:
671                     out_c = out_c + "const void* this_arg"
672                 else:
673                     out_c = out_c + "void* this_arg"
674
675                 for idx, arg in enumerate(fn_line.args_ty):
676                     out_c = out_c + ", " + arg.ty_info.get_full_rust_ty()[0] + " " + arg.arg_name + arg.ty_info.get_full_rust_ty()[1]
677
678                 out_c = out_c + ") {\n"
679                 out_c = out_c + "\t" + struct_name + "_JCalls *j_calls = (" + struct_name + "_JCalls*) this_arg;\n"
680                 out_c = out_c + "\tJNIEnv *env;\n"
681                 out_c = out_c + "\tDO_ASSERT((*j_calls->vm)->GetEnv(j_calls->vm, (void**)&env, JNI_VERSION_1_6) == JNI_OK);\n"
682
683                 for arg_info in fn_line.args_ty:
684                     if arg_info.ret_conv is not None:
685                         out_c = out_c + "\t" + arg_info.ret_conv[0].replace('\n', '\n\t')
686                         out_c = out_c + arg_info.arg_name
687                         out_c = out_c + arg_info.ret_conv[1].replace('\n', '\n\t') + "\n"
688
689                 out_c = out_c + "\tjobject obj = (*env)->NewLocalRef(env, j_calls->o);\n\tCHECK(obj != NULL);\n"
690                 if fn_line.ret_ty_info.c_ty.endswith("Array"):
691                     out_c = out_c + "\t" + fn_line.ret_ty_info.c_ty + " ret = (*env)->CallObjectMethod(env, obj, j_calls->" + fn_line.fn_name + "_meth"
692                 elif not fn_line.ret_ty_info.passed_as_ptr:
693                     out_c = out_c + "\treturn (*env)->Call" + fn_line.ret_ty_info.java_ty.title() + "Method(env, obj, j_calls->" + fn_line.fn_name + "_meth"
694                 else:
695                     out_c = out_c + "\t" + fn_line.ret_ty_info.rust_obj + "* ret = (" + fn_line.ret_ty_info.rust_obj + "*)(*env)->CallLongMethod(env, obj, j_calls->" + fn_line.fn_name + "_meth"
696
697                 for idx, arg_info in enumerate(fn_line.args_ty):
698                     if arg_info.ret_conv is not None:
699                         out_c = out_c + ", " + arg_info.ret_conv_name
700                     else:
701                         out_c = out_c + ", " + arg_info.arg_name
702                 out_c = out_c + ");\n"
703                 if fn_line.ret_ty_info.arg_conv is not None:
704                     out_c = out_c + "\t" + fn_line.ret_ty_info.arg_conv.replace("\n", "\n\t") + "\n\treturn " + fn_line.ret_ty_info.arg_conv_name + ";\n"
705
706                 out_c = out_c + "}\n"
707
708         # Write out a clone function whether we need one or not, as we use them in moving to rust
709         out_c = out_c + "static void* " + struct_name + "_JCalls_clone(const void* this_arg) {\n"
710         out_c = out_c + "\t" + struct_name + "_JCalls *j_calls = (" + struct_name + "_JCalls*) this_arg;\n"
711         out_c = out_c + "\tatomic_fetch_add_explicit(&j_calls->refcnt, 1, memory_order_release);\n"
712         for var in field_vars:
713             if not isinstance(var, ConvInfo):
714                 out_c = out_c + "\tatomic_fetch_add_explicit(&j_calls->" + var[1] + "->refcnt, 1, memory_order_release);\n"
715         out_c = out_c + "\treturn (void*) this_arg;\n"
716         out_c = out_c + "}\n"
717
718         out_c = out_c + "static inline " + struct_name + " " + struct_name + "_init (" + self.c_fn_args_pfx + ", jobject o"
719         for var in flattened_field_vars:
720             if isinstance(var, ConvInfo):
721                 out_c = out_c + ", " + var.c_ty + " " + var.arg_name
722             else:
723                 out_c = out_c + ", jobject " + var[1]
724         out_c = out_c + ") {\n"
725
726         out_c = out_c + "\tjclass c = (*env)->GetObjectClass(env, o);\n"
727         out_c = out_c + "\tCHECK(c != NULL);\n"
728         out_c = out_c + "\t" + struct_name + "_JCalls *calls = MALLOC(sizeof(" + struct_name + "_JCalls), \"" + struct_name + "_JCalls\");\n"
729         out_c = out_c + "\tatomic_init(&calls->refcnt, 1);\n"
730         out_c = out_c + "\tDO_ASSERT((*env)->GetJavaVM(env, &calls->vm) == 0);\n"
731         out_c = out_c + "\tcalls->o = (*env)->NewWeakGlobalRef(env, o);\n"
732
733         for (fn_name, java_meth_descr) in java_meths:
734             if fn_name != "free" and fn_name != "clone":
735                 out_c = out_c + "\tcalls->" + fn_name + "_meth = (*env)->GetMethodID(env, c, \"" + fn_name + "\", \"" + java_meth_descr + "\");\n"
736                 out_c = out_c + "\tCHECK(calls->" + fn_name + "_meth != NULL);\n"
737
738         for var in flattened_field_vars:
739             if isinstance(var, ConvInfo) and var.arg_conv is not None:
740                 out_c = out_c + "\n\t" + var.arg_conv.replace("\n", "\n\t") +"\n"
741         out_c = out_c + "\n\t" + struct_name + " ret = {\n"
742         out_c = out_c + "\t\t.this_arg = (void*) calls,\n"
743         for fn_line in field_fns:
744             if fn_line.fn_name != "free" and fn_line.fn_name != "clone":
745                 out_c = out_c + "\t\t." + fn_line.fn_name + " = " + fn_line.fn_name + "_" + struct_name + "_jcall,\n"
746             elif fn_line.fn_name == "free":
747                 out_c = out_c + "\t\t.free = " + struct_name + "_JCalls_free,\n"
748             else:
749                 out_c = out_c + "\t\t.clone = " + struct_name + "_JCalls_clone,\n"
750         for var in field_vars:
751             if isinstance(var, ConvInfo):
752                 if var.arg_conv_name is not None:
753                     out_c = out_c + "\t\t." + var.arg_name + " = " + var.arg_conv_name + ",\n"
754                     out_c = out_c + "\t\t.set_" + var.arg_name + " = NULL,\n"
755                 else:
756                     out_c = out_c + "\t\t." + var.var_name + " = " + var.var_name + ",\n"
757                     out_c = out_c + "\t\t.set_" + var.var_name + " = NULL,\n"
758             else:
759                 out_c += "\t\t." + var[1] + " = " + var[0] + "_init(env, clz, " + var[1]
760                 for suparg in var[2]:
761                     if isinstance(suparg, ConvInfo):
762                         out_c = out_c + ", " + suparg.arg_name
763                     else:
764                         out_c = out_c + ", " + suparg[1]
765                 out_c += "),\n"
766         out_c = out_c + "\t};\n"
767         for var in flattened_field_vars:
768             if not isinstance(var, ConvInfo):
769                 out_c = out_c + "\tcalls->" + var[1] + " = ret." + var[1] + ".this_arg;\n"
770         out_c = out_c + "\treturn ret;\n"
771         out_c = out_c + "}\n"
772
773         out_c = out_c + self.c_fn_ty_pfx + "int64_t " + self.c_fn_name_define_pfx(struct_name + "_new", True) + "jobject o"
774         for var in flattened_field_vars:
775             if isinstance(var, ConvInfo):
776                 out_c = out_c + ", " + var.c_ty + " " + var.arg_name
777             else:
778                 out_c = out_c + ", jobject " + var[1]
779         out_c = out_c + ") {\n"
780         out_c = out_c + "\t" + struct_name + " *res_ptr = MALLOC(sizeof(" + struct_name + "), \"" + struct_name + "\");\n"
781         out_c = out_c + "\t*res_ptr = " + struct_name + "_init(env, clz, o"
782         for var in flattened_field_vars:
783             if isinstance(var, ConvInfo):
784                 out_c = out_c + ", " + var.arg_name
785             else:
786                 out_c = out_c + ", " + var[1]
787         out_c = out_c + ");\n"
788         out_c = out_c + "\treturn (long)res_ptr;\n"
789         out_c = out_c + "}\n"
790
791         return (out_java, out_java_trait, out_c)
792
793     def trait_struct_inc_refcnt(self, ty_info):
794         base_conv = "\nif (" + ty_info.var_name + "_conv.free == " + ty_info.rust_obj + "_JCalls_free) {\n"
795         base_conv = base_conv + "\t// If this_arg is a JCalls struct, then we need to increment the refcnt in it.\n"
796         base_conv = base_conv + "\t" + ty_info.rust_obj + "_JCalls_clone(" + ty_info.var_name + "_conv.this_arg);\n}"
797         return base_conv
798
799     def map_complex_enum(self, struct_name, variant_list, camel_to_snake, enum_doc_comment):
800         java_hu_type = struct_name.replace("LDK", "").replace("COption", "Option")
801         out_java_enum = ""
802         out_java = ""
803         out_c = ""
804
805         out_java_enum += (self.hu_struct_file_prefix)
806         out_java_enum += "\n/**\n * " + enum_doc_comment.replace("\n", "\n * ") + "\n */\n"
807         out_java_enum += "@SuppressWarnings(\"unchecked\") // We correctly assign various generic arrays\n"
808         out_java_enum += ("public class " + java_hu_type + " extends CommonBase {\n")
809         out_java_enum += ("\tprivate " + java_hu_type + "(Object _dummy, long ptr) { super(ptr); }\n")
810         out_java_enum += ("\t@Override @SuppressWarnings(\"deprecation\")\n")
811         out_java_enum += ("\tprotected void finalize() throws Throwable {\n")
812         out_java_enum += ("\t\tsuper.finalize();\n")
813         out_java_enum += ("\t\tif (ptr != 0) { bindings." + struct_name.replace("LDK", "") + "_free(ptr); }\n")
814         out_java_enum += ("\t}\n")
815         out_java_enum += ("\tstatic " + java_hu_type + " constr_from_ptr(long ptr) {\n")
816         out_java_enum += ("\t\tbindings." + struct_name + " raw_val = bindings." + struct_name + "_ref_from_ptr(ptr);\n")
817         java_hu_subclasses = ""
818
819         init_meth_jty_strs = {}
820
821         out_java +=  ("\tpublic static class " + struct_name + " {\n")
822         out_java +=  ("\t\tprivate " + struct_name + "() {}\n")
823         for var in variant_list:
824             out_java +=  ("\t\tpublic final static class " + var.var_name + " extends " + struct_name + " {\n")
825             java_hu_subclasses = java_hu_subclasses + "\tpublic final static class " + var.var_name + " extends " + java_hu_type + " {\n"
826             out_java_enum += ("\t\tif (raw_val.getClass() == bindings." + struct_name + "." + var.var_name + ".class) {\n")
827             out_java_enum += ("\t\t\treturn new " + var.var_name + "(ptr, (bindings." + struct_name + "." + var.var_name + ")raw_val);\n")
828             init_meth_jty_str = ""
829             init_meth_params = ""
830             init_meth_body = ""
831             hu_conv_body = ""
832             for idx, field_ty in enumerate(var.fields):
833                 out_java += ("\t\t\tpublic " + field_ty.java_ty + " " + field_ty.arg_name + ";\n")
834                 java_hu_subclasses = java_hu_subclasses + "\t\tpublic final " + field_ty.java_hu_ty + " " + field_ty.arg_name + ";\n"
835                 if field_ty.to_hu_conv is not None:
836                     hu_conv_body = hu_conv_body + "\t\t\t" + field_ty.java_ty + " " + field_ty.arg_name + " = obj." + field_ty.arg_name + ";\n"
837                     hu_conv_body = hu_conv_body + "\t\t\t" + field_ty.to_hu_conv.replace("\n", "\n\t\t\t") + "\n"
838                     hu_conv_body = hu_conv_body + "\t\t\tthis." + field_ty.arg_name + " = " + field_ty.to_hu_conv_name + ";\n"
839                 else:
840                     hu_conv_body = hu_conv_body + "\t\t\tthis." + field_ty.arg_name + " = obj." + field_ty.arg_name + ";\n"
841                 init_meth_jty_str = init_meth_jty_str + field_ty.java_fn_ty_arg
842                 if idx > 0:
843                     init_meth_params = init_meth_params + ", "
844                 init_meth_params = init_meth_params + field_ty.java_ty + " " + field_ty.arg_name
845                 init_meth_body = init_meth_body + "this." + field_ty.arg_name + " = " + field_ty.arg_name + "; "
846             out_java +=  ("\t\t\t" + var.var_name + "(" + init_meth_params + ") { ")
847             out_java +=  (init_meth_body)
848             out_java +=  ("}\n")
849             out_java += ("\t\t}\n")
850             out_java_enum += ("\t\t}\n")
851             java_hu_subclasses = java_hu_subclasses + "\t\tprivate " + var.var_name + "(long ptr, bindings." + struct_name + "." + var.var_name + " obj) {\n\t\t\tsuper(null, ptr);\n"
852             java_hu_subclasses = java_hu_subclasses + hu_conv_body
853             java_hu_subclasses = java_hu_subclasses + "\t\t}\n\t}\n"
854             init_meth_jty_strs[var.var_name] = init_meth_jty_str
855         out_java += ("\t\tstatic native void init();\n")
856         out_java += ("\t}\n")
857         out_java_enum += ("\t\tassert false; return null; // Unreachable without extending the (internal) bindings interface\n\t}\n\n")
858         out_java_enum += (java_hu_subclasses)
859         out_java += ("\tstatic { " + struct_name + ".init(); }\n")
860         out_java += ("\tpublic static native " + struct_name + " " + struct_name + "_ref_from_ptr(long ptr);\n");
861
862         out_c += (self.c_complex_enum_pfx(struct_name, [x.var_name for x in variant_list], init_meth_jty_strs))
863
864         out_c += (self.c_fn_ty_pfx + self.c_complex_enum_pass_ty(struct_name) + " " + self.c_fn_name_define_pfx(struct_name + "_ref_from_ptr", True) + self.ptr_c_ty + " ptr) {\n")
865         out_c += ("\t" + struct_name + " *obj = (" + struct_name + "*)(ptr & ~1);\n")
866         out_c += ("\tswitch(obj->tag) {\n")
867         for var in variant_list:
868             out_c += ("\t\tcase " + struct_name + "_" + var.var_name + ": {\n")
869             c_params = []
870             for idx, field_map in enumerate(var.fields):
871                 if field_map.ret_conv is not None:
872                     out_c += ("\t\t\t" + field_map.ret_conv[0].replace("\n", "\n\t\t\t"))
873                     if var.tuple_variant:
874                         out_c += "obj->" + camel_to_snake(var.var_name)
875                     else:
876                         out_c += "obj->" + camel_to_snake(var.var_name) + "." + field_map.arg_name
877                     out_c += (field_map.ret_conv[1].replace("\n", "\n\t\t\t") + "\n")
878                     c_params.append(field_map.ret_conv_name)
879                 else:
880                     if var.tuple_variant:
881                         c_params.append("obj->" + camel_to_snake(var.var_name))
882                     else:
883                         c_params.append("obj->" + camel_to_snake(var.var_name) + "." + field_map.arg_name)
884             out_c += ("\t\t\treturn " + self.c_constr_native_complex_enum(struct_name, var.var_name, c_params) + ";\n")
885             out_c += ("\t\t}\n")
886         out_c += ("\t\tdefault: abort();\n")
887         out_c += ("\t}\n}\n")
888         return (out_java, out_java_enum, out_c)
889
890     def map_opaque_struct(self, struct_name, struct_doc_comment):
891         out_opaque_struct_human = ""
892         out_opaque_struct_human += self.hu_struct_file_prefix
893         out_opaque_struct_human += "\n/**\n * " + struct_doc_comment.replace("\n", "\n * ") + "\n */\n"
894         out_opaque_struct_human += "@SuppressWarnings(\"unchecked\") // We correctly assign various generic arrays\n"
895         out_opaque_struct_human += ("public class " + struct_name.replace("LDK","") + " extends CommonBase")
896         if struct_name.startswith("LDKLocked"):
897             out_opaque_struct_human += (" implements AutoCloseable")
898         out_opaque_struct_human += (" {\n")
899         out_opaque_struct_human += ("\t" + struct_name.replace("LDK", "") + "(Object _dummy, long ptr) { super(ptr); }\n")
900         if struct_name.startswith("LDKLocked"):
901             out_opaque_struct_human += ("\t@Override public void close() {\n")
902         else:
903             out_opaque_struct_human += ("\t@Override @SuppressWarnings(\"deprecation\")\n")
904             out_opaque_struct_human += ("\tprotected void finalize() throws Throwable {\n")
905             out_opaque_struct_human += ("\t\tsuper.finalize();\n")
906         out_opaque_struct_human += ("\t\tif (ptr != 0) { bindings." + struct_name.replace("LDK","") + "_free(ptr); }\n")
907         out_opaque_struct_human += ("\t}\n\n")
908         return out_opaque_struct_human
909
910
911     def map_function(self, argument_types, c_call_string, method_name, return_type_info, struct_meth, default_constructor_args, takes_self, args_known, type_mapping_generator, doc_comment):
912         out_java = ""
913         out_c = ""
914         out_java_struct = None
915
916         out_java += ("\tpublic static native ")
917         out_c += (self.c_fn_ty_pfx)
918         out_c += (return_type_info.c_ty)
919         out_java += (return_type_info.java_ty)
920         if return_type_info.ret_conv is not None:
921             ret_conv_pfx, ret_conv_sfx = return_type_info.ret_conv
922         out_java += (" " + method_name + "(")
923         have_args = len(argument_types) > 1 or (len(argument_types) > 0 and argument_types[0].c_ty != "void")
924         out_c += (" " + self.c_fn_name_define_pfx(method_name, have_args))
925
926         for idx, arg_conv_info in enumerate(argument_types):
927             if idx != 0:
928                 out_java += (", ")
929                 out_c += (", ")
930             if arg_conv_info.c_ty != "void":
931                 out_c += (arg_conv_info.c_ty + " " + arg_conv_info.arg_name)
932                 out_java += (arg_conv_info.java_ty + " " + arg_conv_info.arg_name)
933
934         out_java_struct = ""
935         if not args_known:
936             out_java_struct += ("\t// Skipped " + method_name + "\n")
937         else:
938             meth_n = method_name[len(struct_meth) + 1:].strip("_")
939             if doc_comment is not None:
940                 out_java_struct += "\t/**\n\t * " + doc_comment.replace("\n", "\n\t * ") + "\n\t */\n"
941             if not takes_self:
942                 out_java_struct += (
943                     "\tpublic static " + return_type_info.java_hu_ty + " constructor_" + meth_n + "(")
944             else:
945                 out_java_struct += ("\tpublic " + return_type_info.java_hu_ty + " " + meth_n + "(")
946             for idx, arg in enumerate(argument_types):
947                 if idx != 0:
948                     if not takes_self or idx > 1:
949                         out_java_struct += (", ")
950                 elif takes_self:
951                     continue
952                 if arg.java_ty != "void":
953                     if arg.arg_name in default_constructor_args:
954                         for explode_idx, explode_arg in enumerate(default_constructor_args[arg.arg_name]):
955                             if explode_idx != 0:
956                                 out_java_struct += (", ")
957                             out_java_struct += (
958                                 explode_arg.java_hu_ty + " " + arg.arg_name + "_" + explode_arg.arg_name)
959                     else:
960                         out_java_struct += (arg.java_hu_ty + " " + arg.arg_name)
961         out_java += (");\n")
962         out_c += (") {\n")
963         if out_java_struct is not None:
964             out_java_struct += (") {\n")
965         for info in argument_types:
966             if info.arg_conv is not None:
967                 out_c += ("\t" + info.arg_conv.replace('\n', "\n\t") + "\n")
968         if return_type_info.ret_conv is not None:
969             out_c += ("\t" + ret_conv_pfx.replace('\n', '\n\t'))
970         elif return_type_info.c_ty != "void":
971             out_c += ("\t" + return_type_info.c_ty + " ret_val = ")
972         else:
973             out_c += ("\t")
974         if c_call_string is None:
975             out_c += (method_name + "(")
976         else:
977             out_c += (c_call_string)
978         for idx, info in enumerate(argument_types):
979             if info.arg_conv_name is not None:
980                 if idx != 0:
981                     out_c += (", ")
982                 elif c_call_string is not None:
983                     continue
984                 out_c += (info.arg_conv_name)
985         out_c += (")")
986         if return_type_info.ret_conv is not None:
987             out_c += (ret_conv_sfx.replace('\n', '\n\t'))
988         else:
989             out_c += (";")
990         for info in argument_types:
991             if info.arg_conv_cleanup is not None:
992                 out_c += ("\n\t" + info.arg_conv_cleanup.replace("\n", "\n\t"))
993         if return_type_info.ret_conv is not None:
994             out_c += ("\n\treturn " + return_type_info.ret_conv_name + ";")
995         elif return_type_info.c_ty != "void":
996             out_c += ("\n\treturn ret_val;")
997         out_c += ("\n}\n\n")
998
999         if args_known:
1000             out_java_struct += ("\t\t")
1001             if return_type_info.java_ty != "void":
1002                 out_java_struct += (return_type_info.java_ty + " ret = ")
1003             out_java_struct += ("bindings." + method_name + "(")
1004             for idx, info in enumerate(argument_types):
1005                 if idx != 0:
1006                     out_java_struct += (", ")
1007                 if idx == 0 and takes_self:
1008                     out_java_struct += ("this.ptr")
1009                 elif info.arg_name in default_constructor_args:
1010                     out_java_struct += ("bindings." + info.java_hu_ty + "_new(")
1011                     for explode_idx, explode_arg in enumerate(default_constructor_args[info.arg_name]):
1012                         if explode_idx != 0:
1013                             out_java_struct += (", ")
1014                         expl_arg_name = info.arg_name + "_" + explode_arg.arg_name
1015                         if explode_arg.from_hu_conv is not None:
1016                             out_java_struct += (
1017                                 explode_arg.from_hu_conv[0].replace(explode_arg.arg_name, expl_arg_name))
1018                         else:
1019                             out_java_struct += (expl_arg_name)
1020                     out_java_struct += (")")
1021                 elif info.from_hu_conv is not None:
1022                     out_java_struct += (info.from_hu_conv[0])
1023                 else:
1024                     out_java_struct += (info.arg_name)
1025             out_java_struct += (");\n")
1026             if return_type_info.to_hu_conv is not None:
1027                 if not takes_self:
1028                     out_java_struct += ("\t\t" + return_type_info.to_hu_conv.replace("\n", "\n\t\t").replace("this",
1029                                                                                                                return_type_info.to_hu_conv_name) + "\n")
1030                 else:
1031                     out_java_struct += ("\t\t" + return_type_info.to_hu_conv.replace("\n", "\n\t\t") + "\n")
1032
1033             for idx, info in enumerate(argument_types):
1034                 if idx == 0 and takes_self:
1035                     pass
1036                 elif info.arg_name in default_constructor_args:
1037                     for explode_arg in default_constructor_args[info.arg_name]:
1038                         expl_arg_name = info.arg_name + "_" + explode_arg.arg_name
1039                         if explode_arg.from_hu_conv is not None and return_type_info.to_hu_conv_name:
1040                             out_java_struct += ("\t\t" + explode_arg.from_hu_conv[1].replace(explode_arg.arg_name,
1041                                                                                                expl_arg_name).replace(
1042                                 "this", return_type_info.to_hu_conv_name) + ";\n")
1043                 elif info.from_hu_conv is not None and info.from_hu_conv[1] != "":
1044                     if not takes_self and return_type_info.to_hu_conv_name is not None:
1045                         out_java_struct += (
1046                             "\t\t" + info.from_hu_conv[1].replace("this", return_type_info.to_hu_conv_name).replace("\n", "\n\t\t") + ";\n")
1047                     else:
1048                         out_java_struct += ("\t\t" + info.from_hu_conv[1].replace("\n", "\n\t\t") + ";\n")
1049
1050             if return_type_info.to_hu_conv_name is not None:
1051                 out_java_struct += ("\t\treturn " + return_type_info.to_hu_conv_name + ";\n")
1052             elif return_type_info.java_ty != "void" and return_type_info.rust_obj != "LDK" + struct_meth:
1053                 out_java_struct += ("\t\treturn ret;\n")
1054             out_java_struct += ("\t}\n\n")
1055
1056         return (out_java, out_c, out_java_struct)