feat: eip681

Author: schell

backend-lib/Cargo.lock

@@ -32,6 +32,7 @@ zcash_proofs = "0.26"
 zcash_protocol = "0.7"
 zcash_script = "0.4"
 zip32 = "0.2"
+eip681 = { git = "https://github.com/zcash/librustzcash.git", branch = "eip681-ffi-api" }
 
 # Infrastructure
 prost = "0.14"

backend-lib/Cargo.toml

@@ -0,0 +1,28 @@
+package cash.z.ecc.android.sdk.internal
+
+import cash.z.ecc.android.sdk.internal.model.JniEip681TransactionRequest
+
+/**
+ * Interface for EIP-681 transaction request parsing operations.
+ */
+interface Eip681 {
+    /**
+     * Parse an EIP-681 URI string into a [JniEip681TransactionRequest].
+     *
+     * @param uri a valid EIP-681 URI string (e.g. `"ethereum:0xAbC...?value=1e18"`).
+     * @return a [JniEip681TransactionRequest] representing the parsed URI.
+     * @throws RuntimeException if the input is not a valid EIP-681 URI.
+     */
+    fun parseTransactionRequest(uri: String): JniEip681TransactionRequest
+
+    /**
+     * Serialize an EIP-681 transaction request back to a normalized URI string.
+     *
+     * This parses the input URI and then serializes it back, which normalizes the URI format.
+     *
+     * @param uri a valid EIP-681 URI string.
+     * @return the normalized URI string.
+     * @throws RuntimeException if the input is not a valid EIP-681 URI.
+     */
+    fun transactionRequestToUri(uri: String): String
+}

backend-lib/src/main/java/cash/z/ecc/android/sdk/internal/Eip681.kt

@@ -0,0 +1,26 @@
+package cash.z.ecc.android.sdk.internal.jni
+
+import cash.z.ecc.android.sdk.internal.Eip681
+import cash.z.ecc.android.sdk.internal.model.JniEip681TransactionRequest
+
+class RustEip681Tool private constructor() : Eip681 {
+    override fun parseTransactionRequest(uri: String): JniEip681TransactionRequest =
+        parseEip681TransactionRequest(uri)
+
+    override fun transactionRequestToUri(uri: String): String =
+        eip681TransactionRequestToUri(uri)
+
+    companion object {
+        suspend fun new(): Eip681 {
+            RustBackend.loadLibrary()
+
+            return RustEip681Tool()
+        }
+
+        @JvmStatic
+        private external fun parseEip681TransactionRequest(input: String): JniEip681TransactionRequest
+
+        @JvmStatic
+        private external fun eip681TransactionRequestToUri(input: String): String
+    }
+}

backend-lib/src/main/java/cash/z/ecc/android/sdk/internal/jni/RustEip681Tool.kt

@@ -0,0 +1,55 @@
+package cash.z.ecc.android.sdk.internal.model
+
+import androidx.annotation.Keep
+
+/**
+ * Serves as cross layer (Kotlin, Rust) communication class for parsed EIP-681 transaction requests.
+ *
+ * EIP-681 defines a standard URI format for Ethereum transaction requests, commonly used in
+ * QR codes and deep links. This sealed class represents the three recognized forms: native
+ * ETH transfers, ERC-20 token transfers, and unrecognised (but syntactically valid) requests.
+ */
+@Keep
+sealed class JniEip681TransactionRequest {
+    /**
+     * A native ETH/chain token transfer (no function call).
+     *
+     * @param schemaPrefix the URI schema prefix (e.g. "ethereum").
+     * @param chainId the chain ID, or -1L if not specified in the URI.
+     * @param recipientAddress the recipient address (ERC-55 checksummed hex or ENS name).
+     * @param valueHex the transfer value as a `0x`-prefixed hex string, or null if not specified.
+     * @param gasLimitHex the gas limit as a `0x`-prefixed hex string, or null if not specified.
+     * @param gasPriceHex the gas price as a `0x`-prefixed hex string, or null if not specified.
+     */
+    @Keep
+    class Native(
+        val schemaPrefix: String,
+        val chainId: Long,
+        val recipientAddress: String,
+        val valueHex: String?,
+        val gasLimitHex: String?,
+        val gasPriceHex: String?
+    ) : JniEip681TransactionRequest()
+
+    /**
+     * An ERC-20 token transfer via `transfer(address,uint256)`.
+     *
+     * @param chainId the chain ID, or -1L if not specified in the URI.
+     * @param tokenContractAddress the ERC-20 token contract address (ERC-55 checksummed hex or ENS name).
+     * @param recipientAddress the transfer recipient address (ERC-55 checksummed hex or ENS name).
+     * @param valueHex the transfer value in atomic units as a `0x`-prefixed hex string.
+     */
+    @Keep
+    class Erc20(
+        val chainId: Long,
+        val tokenContractAddress: String,
+        val recipientAddress: String,
+        val valueHex: String
+    ) : JniEip681TransactionRequest()
+
+    /**
+     * A valid EIP-681 request that is not a recognized transfer pattern.
+     */
+    @Keep
+    class Unrecognised : JniEip681TransactionRequest()
+}