Merge release/lightspark-sdk-v0.15.0 into main

RELEASING.md

@@ -7,8 +7,8 @@ For example, to cut a release branch for version `1.0.0` of the `wallet-sdk` mod
 the following from the `develop` branch:
 
 ```bash
-git checkout -b release/wallet-sdk-1.0.0
-git push -u origin release/wallet-sdk-1.0.0
+git checkout -b release/wallet-sdk-v1.0.0
+git push -u origin release/wallet-sdk-v1.0.0
 ```
 
 Alternatively, you can create the new branch from the github UI.

gradle/libs.versions.toml

@@ -21,7 +21,7 @@ ktlint = "11.3.1"
 ktor = "2.3.7"
 lightsparkCore = "0.6.0"
 lightsparkCrypto = "0.6.0"
-uma = "1.1.1"
+uma = "1.2.1"
 mavenPublish = "0.25.2"
 mockitoCore = "5.5.0"
 taskTree = "2.1.1"

lightspark-sdk/README.md

@@ -17,14 +17,14 @@ Start by installing the SDK from maven:
 **build.gradle:**
 ```groovy
   dependencies {
-    implementation "com.lightspark:lightspark-sdk:0.14.0"
+    implementation "com.lightspark:lightspark-sdk:0.15.0"
   }
 ```
 
 or with **build.gradle.kts:**
 ```kotlin
   dependencies {
-    implementation("com.lightspark:lightspark-sdk:0.14.0")
+    implementation("com.lightspark:lightspark-sdk:0.15.0")
   }
 ```
 

lightspark-sdk/gradle.properties

@@ -1,7 +1,7 @@
 GROUP=com.lightspark
 POM_ARTIFACT_ID=lightspark-sdk
 # Don't bump this manually. Run `scripts/versions.main.kt <new_version>` to bump the version instead.
-VERSION_NAME=0.14.0
+VERSION_NAME=0.15.0
 
 POM_DESCRIPTION=The Lightspark API SDK for Kotlin and Java.
 POM_INCEPTION_YEAR=2023

umaserverdemo/src/main/kotlin/com/lightspark/LightsparkClientUmaInvoiceCreator.kt

@@ -8,24 +8,54 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.future.future
 import me.uma.UmaInvoiceCreator
 
-class LightsparkClientUmaInvoiceCreator(
+/**
+ * Creates UMA invoices using the Lightspark client.
+ *
+ * @constructor Creates an instance of [LightsparkClientUmaInvoiceCreator].
+ *
+ * @param client The [LightsparkCoroutinesClient] used to create invoices.
+ * @param nodeId The ID of the node for which to create the invoice.
+ * @param expirySecs The number of seconds before the invoice expires.
+ * @param enableUmaAnalytics A flag indicating whether UMA analytics should be enabled. If `true`,
+ *      the receiver identifier will be hashed using a monthly-rotated seed and used for anonymized
+ *      analysis.
+ * @param signingPrivateKey Optional, the receiver's signing private key. Used to hash the receiver
+ *      identifier if UMA analytics is enabled.
+ */
+class LightsparkClientUmaInvoiceCreator @JvmOverloads constructor(
     private val client: LightsparkCoroutinesClient,
     private val nodeId: String,
     private val expirySecs: Int,
+    private val enableUmaAnalytics: Boolean = false,
+    private val signingPrivateKey: ByteArray? = null,
 ) : UmaInvoiceCreator {
     private val coroutineScope = CoroutineScope(Dispatchers.IO)
 
-    constructor(apiClientId: String, apiClientSecret: String, nodeId: String, expirySecs: Int) : this(
+    @JvmOverloads
+    constructor(
+        apiClientId: String,
+        apiClientSecret: String,
+        nodeId: String,
+        expirySecs: Int,
+        enableUmaAnalytics: Boolean = false,
+        signingPrivateKey: ByteArray? = null,
+    ) : this(
         LightsparkCoroutinesClient(
             ClientConfig(
                 authProvider = AccountApiTokenAuthProvider(apiClientId, apiClientSecret),
             ),
         ),
         nodeId,
         expirySecs,
+        enableUmaAnalytics,
+        signingPrivateKey,
     )
 
-    override fun createUmaInvoice(amountMsats: Long, metadata: String) = coroutineScope.future {
-        client.createUmaInvoice(nodeId, amountMsats, metadata, expirySecs).data.encodedPaymentRequest
+    override fun createUmaInvoice(amountMsats: Long, metadata: String, receiverIdentifier: String?) = coroutineScope.future {
+        if (enableUmaAnalytics && signingPrivateKey != null) {
+            client.createUmaInvoice(nodeId, amountMsats, metadata, expirySecs, signingPrivateKey, receiverIdentifier)
+        } else {
+            client.createUmaInvoice(nodeId, amountMsats, metadata, expirySecs)
+        }.data.encodedPaymentRequest
     }
 }

umaserverdemo/src/main/kotlin/com/lightspark/Vasp2.kt

@@ -246,7 +246,13 @@ class Vasp2(
         val response = try {
             uma.getPayReqResponse(
                 query = request,
-                invoiceCreator = LightsparkClientUmaInvoiceCreator(client, config.nodeID, expirySecs),
+                invoiceCreator = LightsparkClientUmaInvoiceCreator(
+                    client = client,
+                    nodeId = config.nodeID,
+                    expirySecs = expirySecs,
+                    enableUmaAnalytics = true,
+                    signingPrivateKey = config.umaSigningPrivKey,
+                ),
                 metadata = getEncodedMetadata(),
                 receivingCurrencyCode = receivingCurrency.code,
                 receivingCurrencyDecimals = receivingCurrency.decimals,