@l.x/hashcash-native 1.0.2 → 1.0.4

package/ios/HybridHashcash.swift

@@ -0,0 +1,133 @@
+import Foundation
+import CommonCrypto
+import NitroModules
+
+/**
+ * Native hashcash proof-of-work solver for iOS.
+ *
+ * Uses CommonCrypto for SHA256 hashing. The computation runs on a
+ * background thread via Nitro's Promise.async to avoid blocking
+ * the main/JS thread.
+ *
+ * Performance notes:
+ * - Cancellation is checked every 1000 iterations to balance responsiveness
+ *   with cancellation check overhead
+ * - NSLock provides thread-safe access to the cancellation flag
+ *   (Swift's standard pattern for thread-safe booleans, equivalent to
+ *   Java's AtomicBoolean pattern)
+ * - Native CommonCrypto is significantly faster than JS crypto
+ */
+class HybridHashcash: HybridHashcashSpec {
+    /// Thread-safe cancellation flag. Checked every 1000 iterations
+    /// to allow responsive cancellation without excessive overhead.
+    private var cancelled = false
+
+    /// NSLock for thread-safe cancellation flag access.
+    /// Swift's standard pattern for synchronizing access to shared state.
+    private let lock = NSLock()
+
+    private var isCancelled: Bool {
+        lock.lock()
+        defer { lock.unlock() }
+        return cancelled
+    }
+
+    private func setCancelled(_ value: Bool) {
+        lock.lock()
+        defer { lock.unlock() }
+        cancelled = value
+    }
+
+    /**
+     * Find a proof-of-work solution for the given challenge.
+     *
+     * Iterates through counter values computing SHA256 hashes until
+     * one is found with the required number of leading zero bytes.
+     */
+    func findProof(params: FindProofParams) throws -> Promise<HashcashProofResult?> {
+        return Promise.async { [weak self] in
+            guard let self = self else { return nil }
+
+            self.setCancelled(false)
+
+            let challenge = params.challenge
+            let rangeStart = Int(params.rangeStart ?? 0)
+            let rangeSize = Int(params.rangeSize ?? challenge.maxProofLength)
+            let rangeEnd = rangeStart + rangeSize
+
+            let startTime = CFAbsoluteTimeGetCurrent()
+
+            for counter in rangeStart..<rangeEnd {
+                // Check cancellation every 1000 iterations
+                if counter % 1000 == 0 && self.isCancelled {
+                    return nil
+                }
+
+                // Compute hash for this counter
+                let hash = self.computeHash(
+                    subject: challenge.subject,
+                    nonce: challenge.nonce,
+                    counter: counter
+                )
+
+                // Check if hash meets difficulty requirement
+                if self.checkDifficulty(hash: hash, difficulty: Int(challenge.difficulty)) {
+                    let timeMs = (CFAbsoluteTimeGetCurrent() - startTime) * 1000
+
+                    return HashcashProofResult(
+                        counter: String(counter),
+                        hashBase64: hash.base64EncodedString(),
+                        attempts: Double(counter - rangeStart + 1),
+                        timeMs: timeMs
+                    )
+                }
+            }
+
+            return nil
+        }
+    }
+
+    /**
+     * Cancel any in-progress proof search.
+     */
+    func cancel() throws {
+        setCancelled(true)
+    }
+
+    // MARK: - Private Helpers
+
+    /**
+     * Compute SHA256 hash of "{subject}:{nonce}:{counter}"
+     */
+    private func computeHash(subject: String, nonce: String, counter: Int) -> Data {
+        let solutionString = "\(subject):\(nonce):\(counter)"
+        guard let data = solutionString.data(using: .utf8) else {
+            return Data()
+        }
+
+        var hash = [UInt8](repeating: 0, count: Int(CC_SHA256_DIGEST_LENGTH))
+        data.withUnsafeBytes { bytes in
+            _ = CC_SHA256(bytes.baseAddress, CC_LONG(data.count), &hash)
+        }
+
+        return Data(hash)
+    }
+
+    /**
+     * Check if hash has required number of leading zero bytes.
+     *
+     * difficulty=1 means first byte must be 0x00
+     * difficulty=2 means first two bytes must be 0x00, etc.
+     */
+    private func checkDifficulty(hash: Data, difficulty: Int) -> Bool {
+        guard hash.count >= difficulty else { return false }
+
+        for i in 0..<difficulty {
+            if hash[i] != 0 {
+                return false
+            }
+        }
+
+        return true
+    }
+}

package/lib/benchmark.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Hashcash Benchmark Utility
+ *
+ * Compares native vs JS hashcash implementation performance.
+ * Run this in your app to measure the speedup from native code.
+ */
+/** biome-ignore-all lint/suspicious/noConsole: dev only file */
+interface BenchmarkResult {
+    implementation: 'native' | 'js';
+    difficulty: number;
+    counter: string | null;
+    attempts: number;
+    timeMs: number;
+}
+interface BenchmarkSummary {
+    native: BenchmarkResult;
+    js: BenchmarkResult;
+    speedup: number;
+}
+/**
+ * Run a single benchmark with the native implementation
+ */
+export declare function benchmarkNative(difficulty: number): Promise<BenchmarkResult>;
+/**
+ * Run a single benchmark with the JS implementation
+ * Requires passing in the findProof function from @l.x/sessions
+ */
+export declare function benchmarkJS(difficulty: number, findProof: (params: {
+    challenge: {
+        difficulty: number;
+        subject: string;
+        algorithm: 'sha256';
+        nonce: string;
+        max_proof_length: number;
+    };
+}) => {
+    counter: string;
+    attempts: number;
+    timeMs: number;
+} | null): Promise<BenchmarkResult>;
+/**
+ * Run a comparison benchmark between native and JS implementations
+ */
+export declare function runBenchmark(difficulty: number, jsFindProof: (params: {
+    challenge: {
+        difficulty: number;
+        subject: string;
+        algorithm: 'sha256';
+        nonce: string;
+        max_proof_length: number;
+    };
+}) => {
+    counter: string;
+    attempts: number;
+    timeMs: number;
+} | null): Promise<BenchmarkSummary>;
+/**
+ * Run benchmarks at multiple difficulty levels
+ */
+export declare function runFullBenchmark(jsFindProof: (params: {
+    challenge: {
+        difficulty: number;
+        subject: string;
+        algorithm: 'sha256';
+        nonce: string;
+        max_proof_length: number;
+    };
+}) => {
+    counter: string;
+    attempts: number;
+    timeMs: number;
+} | null): Promise<void>;
+export {};
+//# sourceMappingURL=benchmark.d.ts.map

package/lib/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../src/benchmark.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,gEAAgE;AAIhE,UAAU,eAAe;IACvB,cAAc,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,UAAU,gBAAgB;IACxB,MAAM,EAAE,eAAe,CAAA;IACvB,EAAE,EAAE,eAAe,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBlF;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,QAAQ,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAA;CACF,KAAK;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GACjE,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,QAAQ,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAA;CACF,KAAK;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GACjE,OAAO,CAAC,gBAAgB,CAAC,CAyB3B;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAA;QAClB,OAAO,EAAE,MAAM,CAAA;QACf,SAAS,EAAE,QAAQ,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAA;CACF,KAAK;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GACjE,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/lib/benchmark.js

@@ -0,0 +1,92 @@
+/**
+ * Hashcash Benchmark Utility
+ *
+ * Compares native vs JS hashcash implementation performance.
+ * Run this in your app to measure the speedup from native code.
+ */
+/** biome-ignore-all lint/suspicious/noConsole: dev only file */
+import { HashcashNative } from './index';
+/**
+ * Run a single benchmark with the native implementation
+ */
+export async function benchmarkNative(difficulty) {
+    var _a, _b;
+    const challenge = {
+        difficulty,
+        subject: 'Benchmark',
+        nonce: 'dGVzdC1ub25jZS1iZW5jaG1hcms=', // "test-nonce-benchmark" in base64
+        maxProofLength: 10000000,
+    };
+    const startTime = performance.now();
+    const result = await HashcashNative.findProof({ challenge });
+    const endTime = performance.now();
+    return {
+        implementation: 'native',
+        difficulty,
+        counter: (_a = result === null || result === void 0 ? void 0 : result.counter) !== null && _a !== void 0 ? _a : null,
+        attempts: (_b = result === null || result === void 0 ? void 0 : result.attempts) !== null && _b !== void 0 ? _b : 0,
+        timeMs: endTime - startTime,
+    };
+}
+/**
+ * Run a single benchmark with the JS implementation
+ * Requires passing in the findProof function from @l.x/sessions
+ */
+export async function benchmarkJS(difficulty, findProof) {
+    var _a, _b, _c;
+    const challenge = {
+        difficulty,
+        subject: 'Benchmark',
+        algorithm: 'sha256',
+        nonce: 'dGVzdC1ub25jZS1iZW5jaG1hcms=',
+        max_proof_length: 10000000,
+    };
+    const result = findProof({ challenge });
+    return {
+        implementation: 'js',
+        difficulty,
+        counter: (_a = result === null || result === void 0 ? void 0 : result.counter) !== null && _a !== void 0 ? _a : null,
+        attempts: (_b = result === null || result === void 0 ? void 0 : result.attempts) !== null && _b !== void 0 ? _b : 0,
+        timeMs: (_c = result === null || result === void 0 ? void 0 : result.timeMs) !== null && _c !== void 0 ? _c : 0,
+    };
+}
+/**
+ * Run a comparison benchmark between native and JS implementations
+ */
+export async function runBenchmark(difficulty, jsFindProof) {
+    console.log(`\n🏁 Starting hashcash benchmark (difficulty=${difficulty})...\n`);
+    // Run native first
+    console.log('⏱️  Running native implementation...');
+    const nativeResult = await benchmarkNative(difficulty);
+    console.log(`   Native: ${nativeResult.timeMs.toFixed(2)}ms (${nativeResult.attempts} attempts)`);
+    // Run JS
+    console.log('⏱️  Running JS implementation...');
+    const jsResult = await benchmarkJS(difficulty, jsFindProof);
+    console.log(`   JS: ${jsResult.timeMs.toFixed(2)}ms (${jsResult.attempts} attempts)`);
+    const speedup = jsResult.timeMs / nativeResult.timeMs;
+    console.log(`\n📊 Results:`);
+    console.log(`   Native: ${nativeResult.timeMs.toFixed(2)}ms`);
+    console.log(`   JS:     ${jsResult.timeMs.toFixed(2)}ms`);
+    console.log(`   Speedup: ${speedup.toFixed(2)}x faster with native\n`);
+    return {
+        native: nativeResult,
+        js: jsResult,
+        speedup,
+    };
+}
+/**
+ * Run benchmarks at multiple difficulty levels
+ */
+export async function runFullBenchmark(jsFindProof) {
+    console.log('═══════════════════════════════════════════');
+    console.log('   HASHCASH NATIVE vs JS BENCHMARK');
+    console.log('═══════════════════════════════════════════');
+    const difficulties = [1, 2];
+    for (const difficulty of difficulties) {
+        await runBenchmark(difficulty, jsFindProof);
+    }
+    console.log('═══════════════════════════════════════════');
+    console.log('   BENCHMARK COMPLETE');
+    console.log('═══════════════════════════════════════════\n');
+}
+//# sourceMappingURL=benchmark.js.map

package/lib/benchmark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.js","sourceRoot":"","sources":["../src/benchmark.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+import type { Hashcash } from './specs/Hashcash.nitro';
+/**
+ * Native hashcash proof-of-work solver.
+ *
+ * Uses platform-native SHA256 implementation for better performance
+ * than JavaScript-based hashing.
+ */
+export declare const HashcashNative: Hashcash;
+export { benchmarkJS, benchmarkNative, runBenchmark, runFullBenchmark, } from './benchmark';
+export type { FindProofParams, Hashcash, HashcashChallenge, HashcashProofResult, } from './specs/Hashcash.nitro';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,UAAwD,CAAA;AAEnF,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA"}

package/lib/index.js

@@ -0,0 +1,10 @@
+import { NitroModules } from 'react-native-nitro-modules';
+/**
+ * Native hashcash proof-of-work solver.
+ *
+ * Uses platform-native SHA256 implementation for better performance
+ * than JavaScript-based hashing.
+ */
+export const HashcashNative = NitroModules.createHybridObject('Hashcash');
+export { benchmarkJS, benchmarkNative, runBenchmark, runFullBenchmark, } from './benchmark';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAGzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,kBAAkB,CAAW,UAAU,CAAC,CAAA;AAEnF,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,GACjB,MAAM,aAAa,CAAA"}

package/lib/specs/Hashcash.nitro.d.ts

@@ -0,0 +1,59 @@
+import type { HybridObject } from 'react-native-nitro-modules';
+/**
+ * Challenge parameters for hashcash proof-of-work
+ */
+export interface HashcashChallenge {
+    /** Number of zero bytes required at start of hash */
+    difficulty: number;
+    /** Subject string (e.g., "Lx") */
+    subject: string;
+    /** Base64-encoded nonce from backend */
+    nonce: string;
+    /** Maximum counter value to try */
+    maxProofLength: number;
+}
+/**
+ * Result of a successful proof-of-work computation
+ */
+export interface HashcashProofResult {
+    /** The counter value that produced a valid hash */
+    counter: string;
+    /** Base64-encoded SHA256 hash */
+    hashBase64: string;
+    /** Number of hash attempts made */
+    attempts: number;
+    /** Time taken in milliseconds */
+    timeMs: number;
+}
+/**
+ * Parameters for findProof
+ */
+export interface FindProofParams {
+    challenge: HashcashChallenge;
+    rangeStart?: number;
+    rangeSize?: number;
+}
+/**
+ * Native hashcash proof-of-work solver.
+ *
+ * Computes SHA256 hashes to find a counter value that produces
+ * a hash with the required number of leading zero bytes.
+ */
+export interface Hashcash extends HybridObject<{
+    ios: 'swift';
+    android: 'kotlin';
+}> {
+    /**
+     * Find a proof-of-work solution for the given challenge.
+     *
+     * @param params - Challenge parameters and optional range limits
+     * @returns ProofResult if found, undefined if cancelled or no solution in range
+     */
+    findProof(params: FindProofParams): Promise<HashcashProofResult | undefined>;
+    /**
+     * Cancel any in-progress proof search.
+     * The current findProof call will return undefined.
+     */
+    cancel(): void;
+}
+//# sourceMappingURL=Hashcash.nitro.d.ts.map

package/lib/specs/Hashcash.nitro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hashcash.nitro.d.ts","sourceRoot":"","sources":["../../src/specs/Hashcash.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAA;IACf,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,iBAAiB,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,QACf,SAAQ,YAAY,CAAC;IACnB,GAAG,EAAE,OAAO,CAAA;IACZ,OAAO,EAAE,QAAQ,CAAA;CAClB,CAAC;IACF;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAA;IAE5E;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAA;CACf"}

package/lib/specs/Hashcash.nitro.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Hashcash.nitro.js.map

package/lib/specs/Hashcash.nitro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hashcash.nitro.js","sourceRoot":"","sources":["../../src/specs/Hashcash.nitro.ts"],"names":[],"mappings":""}

package/nitro.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://nitro.margelo.com/nitro.schema.json",
+  "cxxNamespace": ["hashcashnative"],
+  "ios": {
+    "iosModuleName": "NitroHashcashNative"
+  },
+  "android": {
+    "androidNamespace": ["hashcashnative"],
+    "androidCxxLibName": "NitroHashcashNative"
+  },
+  "autolinking": {
+    "Hashcash": {
+      "swift": "HybridHashcash",
+      "kotlin": "HybridHashcash"
+    }
+  },
+  "ignorePaths": ["**/node_modules"]
+}

package/nitrogen/generated/.gitattributes

@@ -0,0 +1 @@
+** linguist-generated=true

package/nitrogen/generated/android/NitroHashcashNative+autolinking.cmake

@@ -0,0 +1,81 @@
+#
+# NitroHashcashNative+autolinking.cmake
+# This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+# https://github.com/mrousavy/nitro
+# Copyright © 2025 Marc Rousavy @ Margelo
+#
+
+# This is a CMake file that adds all files generated by Nitrogen
+# to the current CMake project.
+#
+# To use it, add this to your CMakeLists.txt:
+# ```cmake
+# include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroHashcashNative+autolinking.cmake)
+# ```
+
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_NITROHASHCASHNATIVE_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
+# Add all headers that were generated by Nitrogen
+include_directories(
+  "../nitrogen/generated/shared/c++"
+  "../nitrogen/generated/android/c++"
+  "../nitrogen/generated/android/"
+)
+
+# Add all .cpp sources that were generated by Nitrogen
+target_sources(
+  # CMake project name (Android C++ library name)
+  NitroHashcashNative PRIVATE
+  # Autolinking Setup
+  ../nitrogen/generated/android/NitroHashcashNativeOnLoad.cpp
+  # Shared Nitrogen C++ sources
+  ../nitrogen/generated/shared/c++/HybridHashcashSpec.cpp
+  # Android-specific Nitrogen C++ sources
+  ../nitrogen/generated/android/c++/JHybridHashcashSpec.cpp
+)
+
+# From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
+# Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
+target_compile_definitions(
+  NitroHashcashNative PRIVATE
+  -DFOLLY_NO_CONFIG=1
+  -DFOLLY_HAVE_CLOCK_GETTIME=1
+  -DFOLLY_USE_LIBCPP=1
+  -DFOLLY_CFG_NO_COROUTINES=1
+  -DFOLLY_MOBILE=1
+  -DFOLLY_HAVE_RECVMMSG=1
+  -DFOLLY_HAVE_PTHREAD=1
+  # Once we target android-23 above, we can comment
+  # the following line. NDK uses GNU style stderror_r() after API 23.
+  -DFOLLY_HAVE_XSI_STRERROR_R=1
+)
+
+# Add all libraries required by the generated specs
+find_package(fbjni REQUIRED) # <-- Used for communication between Java <-> C++
+find_package(ReactAndroid REQUIRED) # <-- Used to set up React Native bindings (e.g. CallInvoker/TurboModule)
+find_package(react-native-nitro-modules REQUIRED) # <-- Used to create all HybridObjects and use the Nitro core library
+
+# Link all libraries together
+target_link_libraries(
+        NitroHashcashNative
+        fbjni::fbjni                              # <-- Facebook C++ JNI helpers
+        ReactAndroid::jsi                         # <-- RN: JSI
+        react-native-nitro-modules::NitroModules  # <-- NitroModules Core :)
+)
+
+# Link react-native (different prefab between RN 0.75 and RN 0.76)
+if(ReactAndroid_VERSION_MINOR GREATER_EQUAL 76)
+    target_link_libraries(
+        NitroHashcashNative
+        ReactAndroid::reactnative                 # <-- RN: Native Modules umbrella prefab
+    )
+else()
+    target_link_libraries(
+        NitroHashcashNative
+        ReactAndroid::react_nativemodule_core     # <-- RN: TurboModules Core
+    )
+endif()

package/nitrogen/generated/android/NitroHashcashNative+autolinking.gradle

@@ -0,0 +1,27 @@
+///
+/// NitroHashcashNative+autolinking.gradle
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+/// This is a Gradle file that adds all files generated by Nitrogen
+/// to the current Gradle project.
+///
+/// To use it, add this to your build.gradle:
+/// ```gradle
+/// apply from: '../nitrogen/generated/android/NitroHashcashNative+autolinking.gradle'
+/// ```
+
+logger.warn("[NitroModules] 🔥 NitroHashcashNative is boosted by nitro!")
+
+android {
+  sourceSets {
+    main {
+      java.srcDirs += [
+        // Nitrogen files
+        "${project.projectDir}/../nitrogen/generated/android/kotlin"
+      ]
+    }
+  }
+}

package/nitrogen/generated/android/NitroHashcashNativeOnLoad.cpp

@@ -0,0 +1,44 @@
+///
+/// NitroHashcashNativeOnLoad.cpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#ifndef BUILDING_NITROHASHCASHNATIVE_WITH_GENERATED_CMAKE_PROJECT
+#error NitroHashcashNativeOnLoad.cpp is not being built with the autogenerated CMakeLists.txt project. Is a different CMakeLists.txt building this?
+#endif
+
+#include "NitroHashcashNativeOnLoad.hpp"
+
+#include <jni.h>
+#include <fbjni/fbjni.h>
+#include <NitroModules/HybridObjectRegistry.hpp>
+
+#include "JHybridHashcashSpec.hpp"
+#include <NitroModules/DefaultConstructableObject.hpp>
+
+namespace margelo::nitro::hashcashnative {
+
+int initialize(JavaVM* vm) {
+  using namespace margelo::nitro;
+  using namespace margelo::nitro::hashcashnative;
+  using namespace facebook;
+
+  return facebook::jni::initialize(vm, [] {
+    // Register native JNI methods
+    margelo::nitro::hashcashnative::JHybridHashcashSpec::registerNatives();
+
+    // Register Nitro Hybrid Objects
+    HybridObjectRegistry::registerHybridObjectConstructor(
+      "Hashcash",
+      []() -> std::shared_ptr<HybridObject> {
+        static DefaultConstructableObject<JHybridHashcashSpec::javaobject> object("com/margelo/nitro/hashcashnative/HybridHashcash");
+        auto instance = object.create();
+        return instance->cthis()->shared();
+      }
+    );
+  });
+}
+
+} // namespace margelo::nitro::hashcashnative

package/nitrogen/generated/android/NitroHashcashNativeOnLoad.hpp

@@ -0,0 +1,25 @@
+///
+/// NitroHashcashNativeOnLoad.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © 2025 Marc Rousavy @ Margelo
+///
+
+#include <jni.h>
+#include <NitroModules/NitroDefines.hpp>
+
+namespace margelo::nitro::hashcashnative {
+
+  /**
+   * Initializes the native (C++) part of NitroHashcashNative, and autolinks all Hybrid Objects.
+   * Call this in your `JNI_OnLoad` function (probably inside `cpp-adapter.cpp`).
+   * Example:
+   * ```cpp (cpp-adapter.cpp)
+   * JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM* vm, void*) {
+   *   return margelo::nitro::hashcashnative::initialize(vm);
+   * }
+   * ```
+   */
+  int initialize(JavaVM* vm);
+
+} // namespace margelo::nitro::hashcashnative