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