WIP: Graal native-image build of Java Schnorr Example

This is now rebased for JDK 25-ea and can compile because only native-image
is run on JDK 25 and it is not run directly from Gradle.

To build native image use:

./gradlew secp-examples-java:nativeCompile

Running does not work on aarch64-macOS and has not been tested on Linux.


Note: the Arena.ofConfined() change should probably not be merged to `master`,
but is currently necessary to work with native-image.

# Conflicts:
#	secp-examples-java/src/main/java/org/bitcoinj/secp/examples/ForeignRegistrationFeature.java
#	secp-integration-test/src/test/java/org/bitcoinj/secp/integration/package-info.java
#	secp256k1-examples-java/build.gradle

Author: msgilligan

README.adoc

@@ -100,6 +100,20 @@ Run the script:
 
 * `./secp-examples-java/build/install/secp-examples-java/bin/secp-examples-java`
 
+== Build and run a native image (Currently targets GraalVM for JDK 25-ea)
+
+To build using GraalVM `native-image`:
+
+. Make sure you have GraalVM 25 or later installed
+. Make sure `GRAALVM_HOME` points to the Graal JDK 25 installation
+. `./gradlew secp-examples-java:nativeCompile`
+
+To run the compiled, native executable:
+
+. `export LD_LIBRARY_PATH="$HOME/.nix-profile/lib:$LD_LIBRARY_PATH"`
+. `./secp-examples-java/build/schnorr`
+. Don't blink!
+
 == Building with Nix
 
 NOTE:: We currently only support setting up a development environment with Nix. In the future we hope to support a full Nix build.

secp-examples-java/build.gradle

@@ -13,12 +13,16 @@ dependencies {
     implementation project(':secp-api')
     runtimeOnly project(':secp-bouncy')
     runtimeOnly project(':secp-ffm')
+
+    // This is only needed for ForeignRegistrationFeature and the native-image build
+    implementation group: 'org.graalvm.sdk', name: 'nativeimage', version: '24.0.0'
 }
 
 jar {
     inputs.property("moduleName", moduleName)
     manifest {
         attributes  'Implementation-Title': 'Example secp256k1-jdk Apps',
+                'Main-Class': application.mainClass,
                 'Implementation-Version': archiveVersion.get()
     }
 }
@@ -36,6 +40,10 @@ run {
     jvmArgs += '--enable-native-access=org.bitcoinj.secp.ffm'
 }
 
+configurations {
+    nativeToolImplementation.extendsFrom implementation
+}
+
 tasks.register('runEcdsa', JavaExec) {
     javaLauncher = javaToolchains.launcherFor {
         languageVersion = JavaLanguageVersion.of(javaToolchainVersion)
@@ -46,3 +54,23 @@ tasks.register('runEcdsa', JavaExec) {
     mainClass = 'org.bitcoinj.secp.examples.Ecdsa'
     jvmArgs += '--enable-native-access=org.bitcoinj.secp.ffm'
 }
+
+// Compile a native image using GraalVM's native-image tool
+// Graal must be installed at $GRAALVM_HOME
+tasks.register('nativeCompile', Exec) {
+    dependsOn jar
+    workingDir = projectDir
+    executable = "${System.env.GRAALVM_HOME}/bin/native-image"
+    args = ['--verbose',
+            '--no-fallback',
+            '-cp', "${-> configurations.nativeToolImplementation.asPath}", // Lazy configuration resolution
+            '-jar', jar.archiveFile.get(),
+            '-H:Path=build',
+            '-H:Name=schnorr',
+            '-H:+ForeignAPISupport',
+            '--features=org.bitcoinj.secp.examples.ForeignRegistrationFeature',
+            '--enable-native-access=ALL-UNNAMED',
+            '-H:+ReportUnsupportedElementsAtRuntime',
+            '-H:+ReportExceptionStackTraces'
+    ]
+}

secp-examples-java/src/main/java/module-info.java

@@ -17,4 +17,5 @@
 module org.bitcoinj.secp.examples {
     requires org.bitcoinj.secp.api;
     requires org.jspecify;
+    requires org.graalvm.nativeimage;
 }

secp-examples-java/src/main/java/org/bitcoinj/secp/examples/ForeignRegistrationFeature.java

@@ -0,0 +1,46 @@
+/*
+ * Copyright 2023-2024 secp256k1-jdk Developers.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.bitcoinj.secp.examples;
+
+import org.graalvm.nativeimage.hosted.Feature;
+import org.graalvm.nativeimage.hosted.RuntimeForeignAccess;
+
+import java.lang.foreign.FunctionDescriptor;
+import java.lang.foreign.Linker;
+
+import static java.lang.foreign.ValueLayout.*;
+
+/**
+ *
+ */
+public class ForeignRegistrationFeature implements Feature {
+    public void duringSetup(Feature.DuringSetupAccess access) {
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.ofVoid());
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(JAVA_INT, JAVA_INT, JAVA_INT));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(JAVA_LONG, JAVA_INT));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(JAVA_INT, JAVA_INT, JAVA_INT, JAVA_INT));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(JAVA_INT, JAVA_LONG, JAVA_LONG, JAVA_LONG));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(JAVA_INT, JAVA_LONG, JAVA_LONG, JAVA_LONG, JAVA_LONG, JAVA_LONG));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(JAVA_INT, JAVA_LONG, JAVA_LONG, JAVA_LONG, JAVA_LONG, JAVA_LONG, JAVA_LONG));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(JAVA_INT, JAVA_LONG, JAVA_LONG, JAVA_LONG, JAVA_LONG, JAVA_INT));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(JAVA_INT, JAVA_LONG, JAVA_LONG));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.ofVoid(JAVA_LONG, JAVA_LONG));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.ofVoid(JAVA_LONG));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.ofVoid(JAVA_INT, JAVA_INT));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.of(ADDRESS, JAVA_INT, JAVA_INT), Linker.Option.firstVariadicArg(1));
+        RuntimeForeignAccess.registerForDowncall(FunctionDescriptor.ofVoid(JAVA_INT), Linker.Option.captureCallState("errno"));
+    }
+}

secp-ffm/src/main/java/org/bitcoinj/secp/ffm/Secp256k1Foreign.java

@@ -73,7 +73,7 @@ public Secp256k1Foreign(int flags) {
     }
 
     public Secp256k1Foreign(int flags, boolean randomize) {
-        arena = Arena.ofShared();
+        arena = Arena.ofConfined();     // Changed from `ofShared` for use in Graal native-image tools
         /* Before we can call actual API functions, we need to create a "context". */
         ctx = secp256k1_h.secp256k1_context_create(flags);
 

secp-integration-test/src/test/java/org/bitcoinj/secp/integration/package-info.java

@@ -14,4 +14,4 @@
  * limitations under the License.
  */
 @org.jspecify.annotations.NullMarked
-package org.bitcoinj.secp.integration;
+package org.bitcoinj.secp.integration;