Merge pull request #3 from synonymdev/feat/derive-store-id

feat: add store id derivation

Author: coreyphillips

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "vss-rust-client-ffi"
-version = "0.2.0"
+version = "0.3.0"
 edition = "2021"
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 

Cargo.toml

@@ -32,12 +32,19 @@ cargo build --release
 ```swift
 import vss_rust_client_ffi
 
-// Initialize VSS client with LNURL-auth
+let mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+let passphrase: String? = nil
+let storeId = try vssDeriveStoreId(
+    prefix: "bitkit_v1_regtest",
+    mnemonic: mnemonic,
+    passphrase: passphrase
+)
+
 try await vssNewClientWithLnurlAuth(
     baseUrl: "https://vss.example.com",
-    storeId: "my-app-store",
-    mnemonic: "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
-    passphrase: nil,
+    storeId: storeId,
+    mnemonic: mnemonic,
+    passphrase: passphrase,
     lnurlAuthServerUrl: "https://auth.example.com/lnurl"
 )
 
@@ -73,12 +80,19 @@ vssShutdownClient()
 ```python
 from vss_rust_client_ffi import *
 
-# Initialize VSS client with LNURL-auth
+mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+passphrase = None
+store_id = vss_derive_store_id(
+    prefix="bitkit_v1_regtest",
+    mnemonic=mnemonic,
+    passphrase=passphrase
+)
+
 await vss_new_client_with_lnurl_auth(
     "https://vss.example.com",
-    "my-app-store",
-    "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
-    None,  # passphrase
+    store_id,
+    mnemonic,
+    passphrase,
     "https://auth.example.com/lnurl"
 )
 
@@ -117,12 +131,19 @@ vss_shutdown_client()
 ```kotlin
 import uniffi.vss_rust_client_ffi.*
 
-// Initialize VSS client with LNURL-auth
+val mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+val passphrase: String? = null
+val storeId = vssDeriveStoreId(
+    prefix = "bitkit_v1_regtest",
+    mnemonic = mnemonic,
+    passphrase = passphrase
+)
+
 vssNewClientWithLnurlAuth(
     baseUrl = "https://vss.example.com",
-    storeId = "my-app-store",
-    mnemonic = "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about",
-    passphrase = null,
+    storeId = storeId,
+    mnemonic = mnemonic,
+    passphrase = passphrase,
     lnurlAuthServerUrl = "https://auth.example.com/lnurl"
 )
 
@@ -171,6 +192,15 @@ Initialize the global VSS client connection with LNURL-auth authentication. Prov
 #### `vssShutdownClient() -> Void`
 Shutdown the VSS client and clean up resources. Optional but recommended for clean application shutdown.
 
+### Utility Functions
+
+#### `vssDeriveStoreId(prefix: String, mnemonic: String, passphrase: String?) -> String`
+Derives a deterministic VSS store ID from a mnemonic and optional passphrase using BIP32 key derivation.
+
+- `prefix`: A prefix to include in the store ID (e.g., "bitkit_v1_regtest")
+- `mnemonic`: BIP39 mnemonic phrase (12 or 24 words)  
+- `passphrase`: Optional BIP39 passphrase
+
 ### Data Operations
 
 #### `vssStore(key: String, value: Data) -> VssItem`
@@ -294,4 +324,4 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 - [VSS Server](https://github.com/lightningdevkit/vss-server) - The VSS server implementation
 - [vss-client](https://crates.io/crates/vss-client) - The underlying Rust client library
-- [UniFFI](https://mozilla.github.io/uniffi-rs/) - The FFI binding generator
+- [UniFFI](https://mozilla.github.io/uniffi-rs/) - The FFI binding generator

README.md

@@ -3,4 +3,4 @@ android.useAndroidX=true
 android.nonTransitiveRClass=true
 kotlin.code.style=official
 # project settings:
-version=0.2.0
+version=0.3.0