Merge pull request #74 from TheBlueMatt/2022-01-ts-hu-files
[ldk-java] / gen_type_mapping.py
1 from bindingstypes import ConvInfo
2
3 class TypeMappingGenerator:
4
5     def __init__(self, java_c_types, consts, opaque_structs, clone_fns, unitary_enums, trait_structs, complex_enums, result_types, tuple_types):
6         # trick our way around circular imports
7         self.java_c_types = java_c_types
8         self.consts = consts
9         self.opaque_structs = opaque_structs
10         self.clone_fns = clone_fns
11         self.unitary_enums = unitary_enums
12         self.trait_structs = trait_structs
13         self.complex_enums = complex_enums
14         self.result_types = result_types
15         self.tuple_types = tuple_types
16
17     def map_type(self, fn_arg, print_void, ret_arr_len, is_free, holds_ref):
18         ty_info = self.java_c_types(fn_arg, ret_arr_len)
19         mapped_info = self.map_type_with_info(ty_info, print_void, ret_arr_len, is_free, holds_ref, False)
20         return mapped_info
21
22     def map_nullable_type(self, fn_arg, print_void, ret_arr_len, is_free, holds_ref):
23         ty_info = self.java_c_types(fn_arg, ret_arr_len)
24         mapped_info = self.map_type_with_info(ty_info, print_void, ret_arr_len, is_free, holds_ref, True)
25         return mapped_info
26
27     def map_type_with_info(self, ty_info, print_void, ret_arr_len, is_free, holds_ref, is_nullable):
28         mapped_info = self._do_map_type_with_info(ty_info, print_void, ret_arr_len, is_free, holds_ref, is_nullable)
29         if is_nullable:
30             mapped_info.nullable = True
31         return mapped_info
32
33     def _do_map_type_with_info(self, ty_info, print_void, ret_arr_len, is_free, holds_ref, is_nullable):
34         if ty_info.c_ty == "void":
35             if not print_void:
36                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
37                     arg_conv = None, arg_conv_name = None, arg_conv_cleanup = None,
38                     ret_conv = None, ret_conv_name = None, to_hu_conv = None, to_hu_conv_name = None, from_hu_conv = None)
39         if ty_info.c_ty.endswith("Array"):
40             arr_len = ty_info.arr_len
41             if arr_len is not None:
42                 arr_name = ty_info.var_name
43             else:
44                 arr_name = "ret"
45                 arr_len = ret_arr_len
46             if ty_info.c_ty == "int8_tArray":
47                 (set_pfx, set_sfx) = self.consts.set_native_arr_contents(arr_name + "_arr", arr_len, ty_info)
48                 ret_conv = ("int8_tArray " + arr_name + "_arr = " + self.consts.create_native_arr_call(arr_len, ty_info) + ";\n" + set_pfx, "")
49                 arg_conv_cleanup = None
50                 if not arr_len.isdigit():
51                     arg_conv = ty_info.rust_obj + " " + arr_name + "_ref;\n"
52                     arg_conv = arg_conv + arr_name + "_ref." + arr_len + " = " +  self.consts.get_native_arr_len_call[0] + arr_name + self.consts.get_native_arr_len_call[1] + ";\n"
53                     if (not ty_info.is_ptr or not holds_ref) and ty_info.rust_obj != "LDKu8slice":
54                         arg_conv = arg_conv + arr_name + "_ref." + ty_info.arr_access + " = MALLOC(" + arr_name + "_ref." + arr_len + ", \"" + ty_info.rust_obj + " Bytes\");\n"
55                         arg_conv = arg_conv + self.consts.get_native_arr_contents(arr_name, arr_name + "_ref." + ty_info.arr_access, arr_name + "_ref." + arr_len, ty_info, True) + ";"
56                     else:
57                         arg_conv = arg_conv + arr_name + "_ref." + ty_info.arr_access + " = " + self.consts.get_native_arr_contents(arr_name, "NO_DEST", arr_name + "_ref." + arr_len, ty_info, False) + ";"
58                         arg_conv_cleanup = self.consts.cleanup_native_arr_ref_contents(arr_name, arr_name + "_ref." + ty_info.arr_access, arr_name + "_ref." + arr_len, ty_info)
59                     if ty_info.rust_obj == "LDKTransaction":
60                         arg_conv = arg_conv + "\n" + arr_name + "_ref.data_is_owned = " + str(holds_ref).lower() + ";"
61                     ret_conv = (ty_info.rust_obj + " " + arr_name + "_var = ", "")
62                     ret_conv = (ret_conv[0], ";\nint8_tArray " + arr_name + "_arr = " + self.consts.create_native_arr_call(arr_name + "_var." + arr_len, ty_info) + ";\n")
63                     (pfx, sfx) = self.consts.set_native_arr_contents(arr_name + "_arr", arr_name + "_var." + arr_len, ty_info)
64                     ret_conv = (ret_conv[0], ret_conv[1] + pfx + arr_name + "_var." + ty_info.arr_access + sfx + ";")
65                     if not holds_ref and ty_info.rust_obj != "LDKu8slice":
66                         ret_conv = (ret_conv[0], ret_conv[1] + "\n" + ty_info.rust_obj.replace("LDK", "") + "_free(" + arr_name + "_var);")
67                     from_hu_conv = self.consts.primitive_arr_from_hu(ty_info.subty, None, arr_name)
68                     to_hu_conv = self.consts.primitive_arr_to_hu(ty_info.subty, None, arr_name, arr_name + "_conv")
69                 elif ty_info.rust_obj is not None:
70                     arg_conv = ty_info.rust_obj + " " + arr_name + "_ref;\n"
71                     arg_conv = arg_conv + "CHECK(" + self.consts.get_native_arr_len_call[0] + arr_name + self.consts.get_native_arr_len_call[1] + " == " + arr_len + ");\n"
72                     arg_conv = arg_conv + self.consts.get_native_arr_contents(arr_name, arr_name + "_ref." + ty_info.arr_access, arr_len, ty_info, True) + ";"
73                     ret_conv = (ret_conv[0], "." + ty_info.arr_access + set_sfx + ";")
74                     from_hu_conv = self.consts.primitive_arr_from_hu(ty_info.subty, arr_len, arr_name)
75                     to_hu_conv = self.consts.primitive_arr_to_hu(ty_info.subty, None, arr_name, arr_name + "_conv")
76                 else:
77                     arg_conv = "unsigned char " + arr_name + "_arr[" + arr_len + "];\n"
78                     arg_conv = arg_conv + "CHECK(" + self.consts.get_native_arr_len_call[0] + arr_name + self.consts.get_native_arr_len_call[1] + " == " + arr_len + ");\n"
79                     arg_conv = arg_conv + self.consts.get_native_arr_contents(arr_name, arr_name + "_arr", arr_len, ty_info, True) + ";\n"
80                     arg_conv = arg_conv + "unsigned char (*" + arr_name + "_ref)[" + arr_len + "] = &" + arr_name + "_arr;"
81                     ret_conv = (ret_conv[0] + "*", set_sfx + ";")
82                     from_hu_conv = self.consts.primitive_arr_from_hu(ty_info.subty, arr_len, arr_name)
83                     to_hu_conv = self.consts.primitive_arr_to_hu(ty_info.subty, None, arr_name, arr_name + "_conv")
84                 to_hu_conv_name = None
85                 if to_hu_conv is not None:
86                     to_hu_conv_name = arr_name + "_conv"
87                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
88                     arg_conv = arg_conv, arg_conv_name = arr_name + "_ref", arg_conv_cleanup = arg_conv_cleanup,
89                     ret_conv = ret_conv, ret_conv_name = arr_name + "_arr",
90                     to_hu_conv = to_hu_conv, to_hu_conv_name = to_hu_conv_name,
91                     from_hu_conv = from_hu_conv)
92             else:
93                 assert not arr_len.isdigit() # fixed length arrays not implemented
94                 assert ty_info.java_hu_ty[len(ty_info.java_hu_ty) - 2:] == "[]"
95                 if arr_name == "":
96                     arr_name = "ret"
97                 conv_name = arr_name + "_conv_" + str(len(ty_info.java_hu_ty))
98                 idxc = chr(ord('a') + (len(ty_info.java_hu_ty) % 26))
99                 ty_info.subty.var_name = conv_name
100                 #XXX: We'd really prefer to only ever set to False, avoiding lots of clone, but need smarter free logic
101                 #if ty_info.is_ptr or holds_ref:
102                 #    ty_info.subty.requires_clone = False
103                 ty_info.subty.requires_clone = not ty_info.is_ptr or not holds_ref
104                 if not ty_info.subty.is_native_primitive and ty_info.subty.rust_obj == "LDKChannelMonitor":
105                     # We take a Vec of references to ChannelMonitors as input to ChannelManagerReadArgs, if we clone them,
106                     # we end up freeing the clones after creating the ChannelManagerReadArgs before calling the read
107                     # function itself, resulting in a segfault. Thus, we manually check and ensure we don't clone for
108                     # ChannelMonitors inside of vecs.
109                     ty_info.subty.requires_clone = False
110                 subty = self.map_type_with_info(ty_info.subty, False, None, is_free, holds_ref, False)
111                 arg_conv = ty_info.rust_obj + " " + arr_name + "_constr;\n"
112                 pf = ""
113                 if ty_info.is_ptr:
114                     pf = "\t"
115                     arg_conv += ty_info.rust_obj + " *" + arr_name + "_ptr = NULL;\n"
116                     arg_conv += "if (" + self.consts.is_arr_some_check[0] + arr_name + self.consts.is_arr_some_check[1] + ") {\n"
117                 arg_conv += pf + arr_name + "_constr." + arr_len + " = " + self.consts.get_native_arr_len_call[0] + arr_name + self.consts.get_native_arr_len_call[1] + ";\n"
118                 arg_conv += pf + "if (" + arr_name + "_constr." + arr_len + " > 0)\n"
119                 if subty.is_native_primitive:
120                     szof = subty.c_ty
121                 else:
122                     szof = subty.rust_obj
123                 arg_conv += pf + "\t" + arr_name + "_constr." + ty_info.arr_access + " = MALLOC(" + arr_name + "_constr." + arr_len + " * sizeof(" + szof + "), \"" + ty_info.rust_obj + " Elements\");\n"
124                 arg_conv += pf + "else\n"
125                 arg_conv += pf + "\t" + arr_name + "_constr." + ty_info.arr_access + " = NULL;\n"
126                 get_arr = self.consts.get_native_arr_contents(arr_name, "NO_DEST", arr_name + "_constr." + arr_len, ty_info, False)
127                 if get_arr != None:
128                     arg_conv += pf + subty.c_ty + "* " + arr_name + "_vals = " + get_arr + ";\n"
129                 arg_conv += pf + "for (size_t " + idxc + " = 0; " + idxc + " < " + arr_name + "_constr." + arr_len + "; " + idxc + "++) {\n"
130                 if get_arr != None:
131                     arg_conv += pf + "\t" + subty.c_ty + " " + conv_name + " = " + arr_name + "_vals[" + idxc + "];"
132                     if subty.arg_conv is not None:
133                         arg_conv += "\n\t" + pf + subty.arg_conv.replace("\n", "\n\t" + pf)
134                 else:
135                     arg_conv += pf + "\t" + subty.c_ty + " " + conv_name + " = " + self.consts.get_native_arr_elem(arr_name, idxc, ty_info) + ";\n"
136                     arg_conv += pf + "\t" + subty.arg_conv.replace("\n", "\n\t" + pf)
137                 arg_conv += "\n\t" + pf + arr_name + "_constr." + ty_info.arr_access + "[" + idxc + "] = " + subty.arg_conv_name + ";\n" + pf + "}"
138                 if get_arr != None:
139                     cleanup = self.consts.cleanup_native_arr_ref_contents(arr_name, arr_name + "_vals", arr_name + "_constr." + arr_len, ty_info)
140                     if cleanup is not None:
141                         arg_conv += "\n" + pf + cleanup + ";"
142                 if ty_info.is_ptr:
143                     arg_conv_name = arr_name + "_ptr"
144                 else:
145                     arg_conv_name = arr_name + "_constr"
146                 arg_conv_cleanup = None
147                 if ty_info.is_ptr:
148                     arg_conv_cleanup = "if (" + arr_name + "_ptr != NULL) { FREE(" + arr_name + "_constr." + ty_info.arr_access + "); }"
149                 if ty_info.is_ptr:
150                     arg_conv += "\n\t" + arr_name + "_ptr = &" + arr_name + "_constr;\n}"
151
152                 if is_nullable:
153                     ret_conv = (ty_info.rust_obj + " *" + arr_name + "_var_ptr = ", "")
154                 else:
155                     ret_conv = (ty_info.rust_obj + " " + arr_name + "_var = ", "")
156                 if subty.ret_conv is None:
157                     ret_conv = ("DUMMY", "DUMMY")
158                 else:
159                     ret_conv = (ret_conv[0], ";\n" + ty_info.c_ty + " " + arr_name + "_arr = NULL;\n")
160                     indent = ""
161                     if is_nullable:
162                         ret_conv = (ret_conv[0], ret_conv[1] + "if (" + arr_name + " != NULL) {\n")
163                         ret_conv = (ret_conv[0], ret_conv[1] + "\t" + ty_info.rust_obj + " " + arr_name + "_var = *" + arr_name + "_var_ptr;\n")
164                         indent = "\t"
165                     ret_conv = (ret_conv[0], ret_conv[1] + indent + arr_name + "_arr = " + self.consts.create_native_arr_call(arr_name + "_var." + arr_len, ty_info) + ";\n")
166                     get_ptr_call = self.consts.get_native_arr_ptr_call(ty_info)
167                     if get_ptr_call is not None:
168                         ret_conv = (ret_conv[0], ret_conv[1] + indent + subty.c_ty + " *" + arr_name + "_arr_ptr = " + get_ptr_call[0] + arr_name + "_arr" + get_ptr_call[1] + ";\n")
169                     ret_conv = (ret_conv[0], ret_conv[1] + indent + "for (size_t " + idxc + " = 0; " + idxc + " < " + arr_name + "_var." + arr_len + "; " + idxc + "++) {\n")
170                     ret_conv = (ret_conv[0], ret_conv[1] + indent + "\t" + subty.ret_conv[0].replace("\n", "\n\t" + indent))
171                     ret_conv = (ret_conv[0], ret_conv[1] + indent + arr_name + "_var." + ty_info.arr_access + "[" + idxc + "]" + subty.ret_conv[1].replace("\n", "\n\t" + indent) + "\n")
172                     if get_ptr_call is not None:
173                         ret_conv = (ret_conv[0], ret_conv[1] + indent + "\t" + arr_name + "_arr_ptr[" + idxc + "] = " + subty.ret_conv_name + ";\n" + indent + "}\n")
174                     else:
175                         ret_conv = (ret_conv[0], ret_conv[1] + indent + "\t" + self.consts.get_native_arr_entry_call(ty_info, arr_name + "_arr", idxc, subty.ret_conv_name) + ";\n" + indent + "}\n")
176                     cleanup = self.consts.release_native_arr_ptr_call(ty_info, arr_name + "_arr", arr_name + "_arr_ptr")
177                     if cleanup is not None:
178                         ret_conv = (ret_conv[0], ret_conv[1] + indent + cleanup + ";")
179                     if not holds_ref and not is_nullable:
180                         # XXX: The commented if's are a bit smarter freeing, but we need to be a nudge smarter still
181                         # Note that we don't drop the full vec here - we're passing ownership to java (or have cloned) or free'd by now!
182                         ret_conv = (ret_conv[0], ret_conv[1] + "\n" + indent + "FREE(" + arr_name + "_var." + ty_info.arr_access + ");")
183                         #if subty.rust_obj is not None and subty.rust_obj in self.opaque_structs:
184                         #    ret_conv = (ret_conv[0], ret_conv[1] + "\nFREE(" + arr_name + "_var." + ty_info.arr_access + ");")
185                         #else:
186                         #    ret_conv = (ret_conv[0], ret_conv[1] + "\n" + ty_info.rust_obj.replace("LDK", "") + "_free(" + arr_name + "_var);")
187                     if is_nullable:
188                         ret_conv = (ret_conv[0], ret_conv[1] + "\n}")
189
190                 to_hu_conv = None
191                 to_hu_conv_name = None
192                 if subty.to_hu_conv is not None:
193                     to_hu_conv = self.consts.var_decl_statement(self.consts.c_type_map["uint32_t"][0], conv_name + "_len", self.consts.get_java_arr_len(arr_name)) + ";\n"
194                     to_hu_conv += self.consts.var_decl_statement(ty_info.java_hu_ty, conv_name + "_arr", self.consts.constr_hu_array(ty_info, conv_name + "_len"))
195                     to_hu_conv += ";\n" + self.consts.for_n_in_range(idxc, "0", conv_name + "_len") + "\n"
196                     to_hu_conv += "\t" + self.consts.var_decl_statement(subty.java_ty, conv_name, self.consts.get_java_arr_elem(subty, arr_name, idxc)) + ";\n"
197                     to_hu_conv += "\t" + subty.to_hu_conv.replace("\n", "\n\t") + "\n"
198                     to_hu_conv += "\t" + conv_name + "_arr[" + idxc + "] = " + subty.to_hu_conv_name + ";\n}"
199                     to_hu_conv_name = conv_name + "_arr"
200                 from_hu_conv = self.consts.primitive_arr_from_hu(ty_info.subty, None, arr_name)
201                 if subty.from_hu_conv is not None:
202                     hu_conv_b = ""
203                     if subty.from_hu_conv[1] != "":
204                         iterator = self.consts.for_n_in_arr(conv_name, arr_name, subty)
205                         hu_conv_b = iterator[0] + subty.from_hu_conv[1] + ";" + iterator[1]
206                     if from_hu_conv is not None:
207                         arr_conv = self.consts.primitive_arr_from_hu(ty_info.subty, None, self.consts.map_hu_array_elems(arr_name, conv_name, ty_info, subty))
208                         assert arr_conv[1] == ""
209                         from_hu_conv = (arr_conv[0], hu_conv_b)
210                     else:
211                         from_hu_conv = (self.consts.map_hu_array_elems(arr_name, conv_name, ty_info, subty), hu_conv_b)
212
213                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
214                     arg_conv = arg_conv, arg_conv_name = arg_conv_name, arg_conv_cleanup = arg_conv_cleanup,
215                     ret_conv = ret_conv, ret_conv_name = arr_name + "_arr", to_hu_conv = to_hu_conv, to_hu_conv_name = to_hu_conv_name, from_hu_conv = from_hu_conv)
216         elif ty_info.java_fn_ty_arg == "Ljava/lang/String;":
217             assert not is_nullable
218             if not is_free:
219                 arg_conv = "LDKStr " + ty_info.var_name + "_conv = " + self.consts.str_ref_to_c_call(ty_info.var_name) + ";"
220                 arg_conv_name = ty_info.var_name + "_conv"
221             else:
222                 arg_conv = "LDKStr dummy = { .chars = NULL, .len = 0, .chars_is_owned = false };"
223                 arg_conv_name = "dummy"
224             if ty_info.arr_access is None:
225                 assert False
226                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
227                     arg_conv = arg_conv, arg_conv_name = arg_conv_name, arg_conv_cleanup = None,
228                     ret_conv = ("const char* " + ty_info.var_name + "_str = ",
229                         ";\njstring " + ty_info.var_name + "_conv = " + self.consts.str_ref_to_native_call(ty_info.var_name + "_str", "strlen(" + ty_info.var_name + "_str)") + ";"),
230                     ret_conv_name = ty_info.var_name + "_conv",
231                     to_hu_conv = None, to_hu_conv_name = None, from_hu_conv = None)
232             else:
233                 free_str = ""
234                 if not holds_ref:
235                     free_str = "\nStr_free(" + ty_info.var_name + "_str);"
236                 to_hu_conv = self.consts.str_to_hu_conv(ty_info.var_name)
237                 to_hu_conv_name = None
238                 if to_hu_conv is not None:
239                     to_hu_conv_name = ty_info.var_name + "_conv"
240                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
241                     arg_conv = arg_conv, arg_conv_name = arg_conv_name, arg_conv_cleanup = None,
242                     ret_conv = ("LDKStr " + ty_info.var_name + "_str = ",
243                         ";\njstring " + ty_info.var_name + "_conv = " + self.consts.str_ref_to_native_call(ty_info.var_name + "_str." + ty_info.arr_access, ty_info.var_name + "_str." + ty_info.arr_len) + ";" + free_str),
244                     ret_conv_name = ty_info.var_name + "_conv",
245                     to_hu_conv=to_hu_conv, to_hu_conv_name=to_hu_conv_name,
246                     from_hu_conv = self.consts.str_from_hu_conv(ty_info.var_name))
247         elif ty_info.var_name == "" and not print_void:
248             # We don't have a parameter name, and want one, just call it arg
249             if not ty_info.is_native_primitive:
250                 assert(not is_free or ty_info.rust_obj not in self.opaque_structs)
251                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
252                     arg_conv = ty_info.rust_obj + " arg_conv = *(" + ty_info.rust_obj + "*)arg;\nFREE((void*)arg);",
253                     arg_conv_name = "arg_conv", arg_conv_cleanup = None,
254                     ret_conv = None, ret_conv_name = None, to_hu_conv = "TODO 7", to_hu_conv_name = None, from_hu_conv = None)
255             else:
256                 assert(not is_free)
257                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
258                     arg_conv = None, arg_conv_name = "arg", arg_conv_cleanup = None,
259                     ret_conv = None, ret_conv_name = None, to_hu_conv = "TODO 8", to_hu_conv_name = None, from_hu_conv = None)
260         elif ty_info.is_native_primitive:
261             assert not is_nullable
262             return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
263                 arg_conv = None, arg_conv_name = ty_info.var_name, arg_conv_cleanup = None,
264                 ret_conv = None, ret_conv_name = None, to_hu_conv = None, to_hu_conv_name = None, from_hu_conv = None)
265         else:
266             if ty_info.var_name == "":
267                 ty_info.var_name = "ret"
268
269             if ty_info.rust_obj in self.opaque_structs:
270                 from_hu_conv = (ty_info.var_name + " == null ? 0 : " + self.consts.get_ptr(ty_info.var_name) + " & ~1", self.consts.add_ref("this", ty_info.var_name))
271                 opaque_arg_conv = ty_info.rust_obj + " " + ty_info.var_name + "_conv;\n"
272                 opaque_arg_conv = opaque_arg_conv + ty_info.var_name + "_conv.inner = (void*)(" + ty_info.var_name + " & (~1));\n"
273                 if ty_info.is_ptr and holds_ref:
274                     opaque_arg_conv += ty_info.var_name + "_conv.is_owned = false;\n"
275                 else:
276                     opaque_arg_conv += ty_info.var_name + "_conv.is_owned = (" + ty_info.var_name + " & 1) || (" + ty_info.var_name + " == 0);\n"
277                 opaque_arg_conv += "CHECK_INNER_FIELD_ACCESS_OR_NULL(" + ty_info.var_name + "_conv);"
278                 if not is_free and (not ty_info.is_ptr or not holds_ref or ty_info.requires_clone == True) and ty_info.requires_clone != False:
279                     if (ty_info.rust_obj.replace("LDK", "") + "_clone") in self.clone_fns:
280                         # TODO: This is a bit too naive, even with the checks above, we really need to know if rust wants a ref or not, not just if its pass as a ptr.
281                         # arg_conv is used when converting a function argument from java normally (with holds_ref set),
282                         # and when converting a java value being returned from a trait method (with holds_ref unset).
283                         # In the second case, we need to clone before returning to C (as once we return the GC can free the object),
284                         # whereas in the first we prefer to clone in C to avoid additional Java code as much as possible.
285                         if holds_ref:
286                             opaque_arg_conv = opaque_arg_conv + "\n" + ty_info.var_name + "_conv = " + ty_info.rust_obj.replace("LDK", "") + "_clone(&" + ty_info.var_name + "_conv);"
287                             from_hu_conv = (from_hu_conv[0], "")
288                         else:
289                             from_hu_conv = (ty_info.var_name + " == null ? 0 : " + ty_info.var_name + ".clone_ptr()", "")
290                     elif ty_info.passed_as_ptr:
291                         opaque_arg_conv = opaque_arg_conv + "\n// Warning: we need a move here but no clone is available for " + ty_info.rust_obj
292                         # TODO: Once we support features cloning (which just isn't in C yet), we can make this a compile error instead!
293                         from_hu_conv = (from_hu_conv[0], from_hu_conv[1] + ";\n" +
294                             "// Due to rust's strict-ownership memory model, in some cases we need to \"move\"\n" +
295                             "// an object to pass exclusive ownership to the function being called.\n" +
296                             "// In most cases, we avoid this being visible in GC'd languages by cloning the object\n" +
297                             "// at the FFI layer, creating a new object which Rust can claim ownership of\n" +
298                             "// However, in some cases (eg here), there is no way to clone an object, and thus\n" +
299                             "// we actually have to pass full ownership to Rust.\n" +
300                             "// Thus, after this call, " + ty_info.var_name + " is reset to null and is now a dummy object.\n" + self.consts.set_null_skip_free(ty_info.var_name))
301
302                 opaque_ret_conv_suf = ";\n"
303                 opaque_ret_conv_suf += "uint64_t " + ty_info.var_name + "_ref = 0;\n"
304                 indent = ""
305                 if is_nullable:
306                     opaque_ret_conv_suf += "if ((uint64_t)" + ty_info.var_name + "_var.inner > 4096) {\n"
307                     indent = "\t"
308                 if not holds_ref and ty_info.is_ptr and (ty_info.rust_obj.replace("LDK", "") + "_clone") in self.clone_fns: # is_ptr, not holds_ref implies passing a pointed-to value to java, which needs copied
309                     opaque_ret_conv_suf += indent + ty_info.var_name + "_var = " + ty_info.rust_obj.replace("LDK", "") + "_clone(" + ty_info.var_name + ");\n"
310                 elif not holds_ref and ty_info.is_ptr:
311                     opaque_ret_conv_suf += indent + "// Warning: we may need a move here but no clone is available for " + ty_info.rust_obj + "\n"
312
313                 opaque_ret_conv_suf += indent + "CHECK((((uint64_t)" + ty_info.var_name + "_var.inner) & 1) == 0); // We rely on a free low bit, malloc guarantees this.\n"
314                 opaque_ret_conv_suf += indent + "CHECK((((uint64_t)&" + ty_info.var_name + "_var) & 1) == 0); // We rely on a free low bit, pointer alignment guarantees this.\n"
315                 opaque_ret_conv_suf += "CHECK_INNER_FIELD_ACCESS_OR_NULL(" + ty_info.var_name + "_var);\n"
316                 if holds_ref:
317                     opaque_ret_conv_suf += indent + ty_info.var_name + "_ref = (uint64_t)" + ty_info.var_name + "_var.inner & ~1;"
318                 else:
319                     opaque_ret_conv_suf += indent + ty_info.var_name + "_ref = (uint64_t)" + ty_info.var_name + "_var.inner;\n"
320                     opaque_ret_conv_suf += indent + "if (" + ty_info.var_name + "_var.is_owned) {\n"
321                     opaque_ret_conv_suf += indent + "\t" + ty_info.var_name + "_ref |= 1;\n"
322                     opaque_ret_conv_suf += indent + "}"
323                 if is_nullable:
324                     opaque_ret_conv_suf += "\n}"
325
326                 to_hu_conv_sfx = ""
327                 if not ty_info.is_ptr or holds_ref:
328                     to_hu_conv_sfx = "\n" + self.consts.add_ref(ty_info.var_name + "_hu_conv", "this") + ";"
329                 if ty_info.is_ptr:
330                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
331                         arg_conv = opaque_arg_conv, arg_conv_name = "&" + ty_info.var_name + "_conv", arg_conv_cleanup = None,
332                         ret_conv = (ty_info.rust_obj + " " + ty_info.var_name + "_var = *", opaque_ret_conv_suf),
333                         ret_conv_name = ty_info.var_name + "_ref",
334                         to_hu_conv = self.consts.to_hu_conv_templates['ptr'].replace('{human_type}', ty_info.java_hu_ty).replace('{var_name}', ty_info.var_name) + to_hu_conv_sfx,
335                         to_hu_conv_name = ty_info.var_name + "_hu_conv",
336                         from_hu_conv = from_hu_conv)
337                 else:
338                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
339                         arg_conv = opaque_arg_conv, arg_conv_name = ty_info.var_name + "_conv", arg_conv_cleanup = None,
340                         ret_conv = (ty_info.rust_obj + " " + ty_info.var_name + "_var = ", opaque_ret_conv_suf),
341                         ret_conv_name = ty_info.var_name + "_ref",
342                         to_hu_conv = self.consts.to_hu_conv_templates['default'].replace('{human_type}', ty_info.java_hu_ty).replace('{var_name}', ty_info.var_name) + to_hu_conv_sfx,
343                         to_hu_conv_name = ty_info.var_name + "_hu_conv",
344                         from_hu_conv = from_hu_conv)
345
346             assert not is_nullable
347             if not ty_info.is_ptr:
348                 if ty_info.rust_obj in self.unitary_enums:
349                     (ret_pfx, ret_sfx) = self.consts.c_unitary_enum_to_native_call(ty_info)
350                     (arg_pfx, arg_sfx) = self.consts.native_unitary_enum_to_c_call(ty_info)
351                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
352                         arg_conv = ty_info.rust_obj + " " + ty_info.var_name + "_conv = " + arg_pfx + ty_info.var_name + arg_sfx + ";",
353                         arg_conv_name = ty_info.var_name + "_conv",
354                         arg_conv_cleanup = None,
355                         ret_conv = (ty_info.c_ty + " " + ty_info.var_name + "_conv = " + ret_pfx, ret_sfx + ";"),
356                         ret_conv_name = ty_info.var_name + "_conv", to_hu_conv = None, to_hu_conv_name = None, from_hu_conv = None)
357                 base_conv = "void* " + ty_info.var_name + "_ptr = (void*)(((uint64_t)" + ty_info.var_name + ") & ~1);\n"
358                 base_conv += "CHECK_ACCESS(" + ty_info.var_name + "_ptr);\n"
359                 base_conv += ty_info.rust_obj + " " + ty_info.var_name + "_conv = *(" + ty_info.rust_obj + "*)(" + ty_info.var_name + "_ptr);"
360                 from_hu_conv = None
361                 if ty_info.rust_obj in self.trait_structs:
362                     ret_conv = (ty_info.rust_obj + "* " + ty_info.var_name + "_ret = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + "\");\n*" + ty_info.var_name + "_ret = ", ";")
363                     if holds_ref:
364                         if (ty_info.rust_obj.replace("LDK", "") + "_clone") in self.clone_fns:
365                             ret_conv = (ret_conv[0] + ty_info.rust_obj.replace("LDK", "") + "_clone(&", ");")
366                         else:
367                             ret_conv = (ret_conv[0], ";\n// Warning: We likely need to clone here, but no clone is available, so we just do it for Java instances")
368                             ret_conv = (ret_conv[0], ret_conv[1] + "" + self.consts.trait_struct_inc_refcnt(ty_info).replace(ty_info.var_name + "_conv", "(*" + ty_info.var_name + "_ret)"))
369                     if not is_free:
370                         needs_full_clone = not is_free and (not ty_info.is_ptr and not holds_ref or ty_info.requires_clone == True) and ty_info.requires_clone != False
371                         if needs_full_clone and (ty_info.rust_obj.replace("LDK", "") + "_clone") in self.clone_fns:
372                             # arg_conv is used when converting a function argument from java normally (with holds_ref set),
373                             # and when converting a java value being returned from a trait method (with holds_ref unset).
374                             # In the second case, we need to clone before returning to C (as once we return the GC can free the object),
375                             # whereas in the first we prefer to clone in C to avoid additional Java code as much as possible.
376                             if holds_ref:
377                                 base_conv += "\n" + ty_info.var_name + "_conv = " + ty_info.rust_obj.replace("LDK", "") + "_clone(&" + ty_info.var_name + "_conv);"
378                             else:
379                                 from_hu_conv = (ty_info.var_name + " == null ? 0 : " + ty_info.var_name + ".clone_ptr()", "")
380                                 base_conv += "\n" + "FREE((void*)" + ty_info.var_name + ");"
381                         else:
382                             base_conv = base_conv + self.consts.trait_struct_inc_refcnt(ty_info)
383                             if needs_full_clone:
384                                 base_conv = base_conv + "// Warning: we may need a move here but no clone is available for " + ty_info.rust_obj + "\n"
385                     else:
386                         base_conv = base_conv + "\n" + "FREE((void*)" + ty_info.var_name + ");"
387                     if from_hu_conv is None:
388                         from_hu_conv = (ty_info.var_name + " == null ? 0 : " + self.consts.get_ptr(ty_info.var_name), "")
389                     from_hu_conv = (from_hu_conv[0], self.consts.add_ref("this", ty_info.var_name))
390                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
391                         arg_conv = base_conv, arg_conv_name = ty_info.var_name + "_conv", arg_conv_cleanup = None,
392                         ret_conv = ret_conv, ret_conv_name = "(uint64_t)" + ty_info.var_name + "_ret",
393                         to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, "ret_hu_conv", "new " + ty_info.java_hu_ty + "(null, " + ty_info.var_name + ")") + ";\n" + self.consts.add_ref("ret_hu_conv", "this") + ";",
394                         to_hu_conv_name = "ret_hu_conv", from_hu_conv = from_hu_conv)
395                 needs_full_clone = not is_free and (not ty_info.is_ptr or ty_info.requires_clone == True) and ty_info.requires_clone != False
396                 if needs_full_clone:
397                     if "res" in ty_info.var_name: # XXX: This is a stupid hack
398                         needs_full_clone = False
399                     if needs_full_clone and (ty_info.rust_obj.replace("LDK", "") + "_clone") in self.clone_fns:
400                         # arg_conv is used when converting a function argument from java normally (with holds_ref set),
401                         # and when converting a java value being returned from a trait method (with holds_ref unset).
402                         # In the second case, we need to clone before returning to C (as once we return the GC can free the object),
403                         # whereas in the first we prefer to clone in C to avoid additional Java code as much as possible.
404                         if holds_ref:
405                             base_conv += "\n" + ty_info.var_name + "_conv = " + ty_info.rust_obj.replace("LDK", "") + "_clone((" + ty_info.rust_obj + "*)(((uint64_t)" + ty_info.var_name + ") & ~1));"
406                         else:
407                             from_hu_conv = (ty_info.var_name + " == null ? 0 : " + ty_info.var_name + ".clone_ptr()", "")
408                             base_conv += "\n" + "FREE((void*)" + ty_info.var_name + ");"
409                     elif needs_full_clone:
410                         base_conv = base_conv + "\n// Warning: we may need a move here but no clone is available for " + ty_info.rust_obj
411                 if not needs_full_clone and ty_info.rust_obj != "LDKu8slice" and (not holds_ref or is_free):
412                     # Don't bother free'ing slices passed in - Rust doesn't auto-free the
413                     # underlying unlike Vecs, and it gives Java more freedom.
414                     base_conv = base_conv + "\nFREE((void*)" + ty_info.var_name + ");"
415                 if ty_info.rust_obj in self.complex_enums:
416                     to_hu_conv_sfx = ""
417                     if needs_full_clone and (ty_info.rust_obj.replace("LDK", "") + "_clone") not in self.clone_fns:
418                         # We really need a full clone here, but for now we just implement
419                         # a manual clone explicitly for Option<Trait>s
420                         if ty_info.contains_trait:
421                             assert ty_info.rust_obj.startswith("LDKCOption") # We don't support contained traits for anything else yet
422                             optional_ty = ty_info.rust_obj[11:-1]
423                             assert "LDK" + optional_ty in self.trait_structs # We don't support contained traits for anything else yet
424                             to_hu_conv_sfx = self.consts.add_ref("this", ty_info.var_name)
425                             base_conv += "\nif (" + ty_info.var_name + "_conv.tag == " + ty_info.rust_obj + "_Some) {"
426                             base_conv += "\n\t// Manually implement clone for Java trait instances"
427                             optional_ty_info = self.java_c_types("LDK" + optional_ty + " " + ty_info.var_name, None)
428                             base_conv += self.consts.trait_struct_inc_refcnt(optional_ty_info).\
429                                 replace("\n", "\n\t").replace(ty_info.var_name + "_conv", ty_info.var_name + "_conv.some")
430                             base_conv += "\n}"
431                     ret_conv = ("uint64_t " + ty_info.var_name + "_ref = ((uint64_t)&", ") | 1;")
432                     if not holds_ref:
433                         ret_conv = (ty_info.rust_obj + " *" + ty_info.var_name + "_copy = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + "\");\n", "")
434                         ret_conv = (ret_conv[0] + "*" + ty_info.var_name + "_copy = ", "")
435                         ret_conv = (ret_conv[0], ";\nuint64_t " + ty_info.var_name + "_ref = (uint64_t)" + ty_info.var_name + "_copy;")
436                     if from_hu_conv is None:
437                         from_hu_conv = (self.consts.get_ptr(ty_info.var_name), "")
438                     from_hu_conv = (from_hu_conv[0], to_hu_conv_sfx)
439                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
440                         arg_conv = base_conv, arg_conv_name = ty_info.var_name + "_conv", arg_conv_cleanup = None,
441                         ret_conv = ret_conv, ret_conv_name = ty_info.var_name + "_ref",
442                         to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, ty_info.var_name + "_hu_conv", ty_info.java_hu_ty + ".constr_from_ptr(" + ty_info.var_name + ")") + ";\n" + self.consts.add_ref(ty_info.var_name + "_hu_conv", "this") + ";",
443                         to_hu_conv_name = ty_info.var_name + "_hu_conv", from_hu_conv = from_hu_conv)
444                 if ty_info.rust_obj in self.result_types:
445                     if holds_ref:
446                         # If we're trying to return a ref, we have to clone.
447                         # We just blindly assume its implemented and let the compiler fail if its not.
448                         ret_conv = (ty_info.rust_obj + "* " + ty_info.var_name + "_conv = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + "\");\n*" + ty_info.var_name + "_conv = ", ";")
449                         ret_conv = (ret_conv[0], ret_conv[1] + "\n*" + ty_info.var_name + "_conv = " + ty_info.rust_obj.replace("LDK", "") + "_clone(" + ty_info.var_name + "_conv);")
450                     else:
451                         ret_conv = (ty_info.rust_obj + "* " + ty_info.var_name + "_conv = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + "\");\n*" + ty_info.var_name + "_conv = ", ";")
452                     if from_hu_conv is None:
453                         from_hu_conv = (ty_info.var_name + " != null ? " + self.consts.get_ptr(ty_info.var_name) + " : 0", "")
454                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
455                         arg_conv = base_conv, arg_conv_name = ty_info.var_name + "_conv", arg_conv_cleanup = None,
456                         ret_conv = ret_conv, ret_conv_name = "(uint64_t)" + ty_info.var_name + "_conv",
457                         to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, ty_info.var_name + "_hu_conv", ty_info.java_hu_ty + ".constr_from_ptr(" + ty_info.var_name + ")") + ";",
458                         to_hu_conv_name = ty_info.var_name + "_hu_conv", from_hu_conv = from_hu_conv)
459                 if ty_info.rust_obj in self.tuple_types:
460                     ret_conv_name = "((uint64_t)" + ty_info.var_name + "_conv)"
461                     if holds_ref:
462                         # If we're trying to return a ref, we have to clone.
463                         if (ty_info.rust_obj.replace("LDK", "") + "_clone") not in self.clone_fns:
464                             ret_conv = (ty_info.rust_obj + "* " + ty_info.var_name + "_conv = &", "")
465                             ret_conv = (ret_conv[0], ";\n// Warning: we really need to clone here, but no clone is available for " + ty_info.rust_obj)
466                             ret_conv_name += " | 1"
467                         else:
468                             ret_conv = (ty_info.rust_obj + "* " + ty_info.var_name + "_conv = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + "\");\n*" + ty_info.var_name + "_conv = ", ";")
469                             ret_conv = (ret_conv[0], ret_conv[1] + "\n*" + ty_info.var_name + "_conv = " + ty_info.rust_obj.replace("LDK", "") + "_clone(" + ty_info.var_name + "_conv);")
470                     else:
471                         ret_conv = (ty_info.rust_obj + "* " + ty_info.var_name + "_conv = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + "\");\n*" + ty_info.var_name + "_conv = ", ";")
472                     if not ty_info.is_ptr or holds_ref:
473                         to_hu_conv_sfx = "\n" + self.consts.add_ref(ty_info.var_name + "_hu_conv", "this") + ";"
474                     else:
475                         to_hu_conv_sfx = ""
476                     if from_hu_conv is None:
477                         from_hu_conv = (ty_info.var_name + " != null ? " + self.consts.get_ptr(ty_info.var_name) + " : 0", "")
478                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
479                         arg_conv = base_conv, arg_conv_name = ty_info.var_name + "_conv", arg_conv_cleanup = None,
480                         ret_conv = ret_conv, ret_conv_name = ret_conv_name,
481                         to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, ty_info.var_name + "_hu_conv", "new " + ty_info.java_hu_ty + "(null, " + ty_info.var_name + ")") + ";" + to_hu_conv_sfx,
482                         to_hu_conv_name = ty_info.var_name + "_hu_conv", from_hu_conv = from_hu_conv)
483
484                 # The manually-defined types - TxOut and u5
485                 if ty_info.rust_obj == "LDKu5":
486                     assert from_hu_conv is None
487                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
488                         arg_conv = "", arg_conv_name = "(LDKu5){ ._0 = " + ty_info.var_name + " }", arg_conv_cleanup = None,
489                         ret_conv = ("uint8_t " + ty_info.var_name + "_val = ", "._0;"), ret_conv_name = ty_info.var_name + "_val",
490                         to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, ty_info.var_name + "_conv", "new " + ty_info.java_hu_ty + "(" + ty_info.var_name + ")") + ";",
491                         to_hu_conv_name = ty_info.var_name + "_conv", from_hu_conv = (ty_info.var_name + ".getVal()", ""))
492
493                 assert ty_info.rust_obj == "LDKTxOut"
494                 if not ty_info.is_ptr and not holds_ref:
495                     ret_conv = ("LDKTxOut* " + ty_info.var_name + "_ref = MALLOC(sizeof(LDKTxOut), \"LDKTxOut\");\n*" + ty_info.var_name + "_ref = ", ";")
496                 else:
497                     ret_conv = ("uint64_t " + ty_info.var_name + "_ref = ((uint64_t)&", ") | 1;")
498                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
499                     arg_conv = base_conv, arg_conv_name = ty_info.var_name + "_conv", arg_conv_cleanup = None,
500                     ret_conv = ret_conv, ret_conv_name = "(uint64_t)" + ty_info.var_name + "_ref",
501                     to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, ty_info.var_name + "_conv", "new " +ty_info.java_hu_ty + "(null, " + ty_info.var_name + ")") + ";",
502                     to_hu_conv_name = ty_info.var_name + "_conv", from_hu_conv = (self.consts.get_ptr(ty_info.var_name), ""))
503             elif ty_info.is_ptr:
504                 assert(not is_free)
505                 if ty_info.rust_obj in self.complex_enums:
506                     ret_conv = ("uint64_t ret_" + ty_info.var_name + " = (uint64_t)", " | 1; // Warning: We should clone here!")
507                     from_hu_sfx = self.consts.add_ref("this", ty_info.var_name)
508                     if ty_info.rust_obj.replace("LDK", "") + "_clone" in self.clone_fns:
509                         ret_conv_pfx = ty_info.rust_obj + " *ret_" + ty_info.var_name + " = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + " ret conversion\");\n"
510                         ret_conv_pfx += "*ret_" + ty_info.var_name + " = " + ty_info.rust_obj.replace("LDK", "") + "_clone("
511                         ret_conv = (ret_conv_pfx, ");")
512                         from_hu_sfx = ""
513                     return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
514                         arg_conv = ty_info.rust_obj + "* " + ty_info.var_name + "_conv = (" + ty_info.rust_obj + "*)" + ty_info.var_name + ";",
515                         arg_conv_name = ty_info.var_name + "_conv", arg_conv_cleanup = None,
516                         ret_conv = ret_conv, ret_conv_name = "(uint64_t)ret_" + ty_info.var_name,
517                         to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, ty_info.var_name + "_hu_conv", ty_info.java_hu_ty + ".constr_from_ptr(" + ty_info.var_name + ")") + ";",
518                         to_hu_conv_name = ty_info.var_name + "_hu_conv",
519                         from_hu_conv = (ty_info.var_name + " == null ? 0 : " + self.consts.get_ptr(ty_info.var_name) + " & ~1", from_hu_sfx))
520                 elif ty_info.rust_obj in self.trait_structs:
521                     if ty_info.nonnull_ptr:
522                         arg_conv = "void* " + ty_info.var_name + "_ptr = (void*)(((uint64_t)" + ty_info.var_name + ") & ~1);\n"
523                         arg_conv += "if (!(" + ty_info.var_name + " & 1)) { CHECK_ACCESS(" + ty_info.var_name + "_ptr); }\n"
524                         arg_conv += ty_info.rust_obj + "* " + ty_info.var_name + "_conv = (" + ty_info.rust_obj + "*)" + ty_info.var_name + "_ptr;"
525                         arg_conv_name = ty_info.var_name + "_conv"
526                     else:
527                         # We map Option<Trait> as *mut Trait, which we can differentiate from &Trait by the NONNULL_PTR annotation.
528                         # We handle the Option<Trait> case here.
529                         arg_conv = ty_info.rust_obj + " *" + ty_info.var_name + "_conv_ptr = NULL;\n"
530                         arg_conv += "if (" + ty_info.var_name + " != 0) {\n"
531                         arg_conv += "\t" + ty_info.rust_obj + " " + ty_info.var_name + "_conv;\n"
532                         arg_conv += "void* " + ty_info.var_name + "_ptr = (void*)(((uint64_t)" + ty_info.var_name + ") & ~1);\n"
533                         arg_conv += "CHECK_ACCESS(" + ty_info.var_name + "_ptr);\n"
534                         arg_conv += "\t" + ty_info.var_name + "_conv = *(" + ty_info.rust_obj + "*)" + ty_info.var_name + "_ptr;"
535                         arg_conv += self.consts.trait_struct_inc_refcnt(ty_info).replace("\n", "\n\t")
536                         arg_conv += "\n\t" + ty_info.var_name + "_conv_ptr = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + "\");\n"
537                         arg_conv += "\t*" + ty_info.var_name + "_conv_ptr = " + ty_info.var_name + "_conv;\n"
538                         arg_conv += "}"
539                         arg_conv_name = ty_info.var_name + "_conv_ptr"
540                     if ty_info.rust_obj.replace("LDK", "") + "_clone" in self.clone_fns:
541                         return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
542                             arg_conv = arg_conv, arg_conv_name = arg_conv_name, arg_conv_cleanup = None,
543                             ret_conv = (ty_info.rust_obj + " *" + ty_info.var_name + "_clone = MALLOC(sizeof(" + ty_info.rust_obj + "), \"" + ty_info.rust_obj + "\");\n" +
544                                 "*" + ty_info.var_name + "_clone = " + ty_info.rust_obj.replace("LDK", "") + "_clone(", ");"),
545                             ret_conv_name = "(uint64_t)" + ty_info.var_name + "_clone",
546                             to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, "ret_hu_conv", "new " + ty_info.java_hu_ty + "(null, " + ty_info.var_name + ")") + ";\n" + self.consts.add_ref("ret_hu_conv", "this") + ";",
547                             to_hu_conv_name = "ret_hu_conv",
548                             from_hu_conv = (ty_info.var_name + " == null ? 0 : " + self.consts.get_ptr(ty_info.var_name), ""))
549                     else:
550                         return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
551                             arg_conv = arg_conv, arg_conv_name = arg_conv_name, arg_conv_cleanup = None,
552                             ret_conv = ("// WARNING: This object doesn't live past this scope, needs clone!\nuint64_t ret_" + ty_info.var_name + " = ((uint64_t)", ") | 1;"),
553                             ret_conv_name = "ret_" + ty_info.var_name,
554                             to_hu_conv = self.consts.var_decl_statement(ty_info.java_hu_ty, "ret_hu_conv", "new " + ty_info.java_hu_ty + "(null, " + ty_info.var_name + ")") + ";\n" + self.consts.add_ref("ret_hu_conv", "this") + ";",
555                             to_hu_conv_name = "ret_hu_conv",
556                             from_hu_conv = (ty_info.var_name + " == null ? 0 : " + self.consts.get_ptr(ty_info.var_name), self.consts.add_ref("this", ty_info.var_name)))
557                 ret_conv = ("uint64_t ret_" + ty_info.var_name + " = (uint64_t)", ";")
558                 if holds_ref:
559                     ret_conv = (ret_conv[0], " | 1;")
560                 return ConvInfo(ty_info = ty_info, arg_name = ty_info.var_name,
561                     arg_conv = ty_info.rust_obj + "* " + ty_info.var_name + "_conv = (" + ty_info.rust_obj + "*)(" + ty_info.var_name + " & ~1);",
562                     arg_conv_name = ty_info.var_name + "_conv", arg_conv_cleanup = None,
563                     ret_conv = ret_conv, ret_conv_name = "ret_" + ty_info.var_name,
564                     to_hu_conv = "TODO 3", to_hu_conv_name = None, from_hu_conv = None) # its a pointer, no conv needed
565             assert False # We should have handled every case by now.