TxnLab · drichar · Jun 27, 2025 · Jan 22, 2025 · Jan 23, 2025 · Apr 10, 2025
diff --git a/.github/renovate.json b/.github/renovate.json
@@ -29,6 +29,7 @@
       "rangeStrategy": "bump",
       "matchPackageNames": [
         "/@agoralabs-sh/avm-web-provider/",
+        "/@algorandfoundation/liquid-auth-use-wallet-client/",
         "/@magic-ext/algorand/",
         "/magic-sdk/",
         "/lute-connect/",

diff --git a/docs/getting-started/supported-wallets.md b/docs/getting-started/supported-wallets.md
@@ -200,6 +200,36 @@ WalletId.BIATEC
 * [Biatec Website](https://wallet.biatec.io)
 * [Biatec GitHub Repository](https://github.com/scholtz/wallet)
 
+#### Liquid Auth (experimental)
+
+ Liquid Auth is a self-hosted authentication service that provides a simple way to associate Passkeys to spending KeyPairs commonly found in cryptocurrencies, in accordance with the FIDO2 WebAuthn specification. In addition to authentication, Liquid Auth provides a Peer to Peer signaling service.
+
+ Not only can you authenticate users, you can also establish secure, WebRTC-based connections between a mobile wallet and a desktop dApp. Liquid Auth serves as an alternative to protocols where access is controlled or limited by centralized entities.
+
+ The Liquid Auth wallet provider defaults to `window.origin` as the origin, assuming the Liquid Auth backend is hosted on the same domain. Alternatively, you can specify a custom endpoint.
+
+```typescript
+import { WalletId } from '@txnlab/use-wallet'
+
+{
+  id: WalletId.LIQUID,
+  options: {
+      origin?: string,
+      RTC_config_username: string,
+      RTC_config_credential: string
+  }
+}
+``` 
+
+ The example use cases are configured to use the Algorand Foundation-hosted endpoint at `https://debug.liquidauth.com`, with `liquid-auth` as the username and `sqmcP4MiTKMT4TGEDSk9jgHY` as the credential. This endpoint is suitable for testing but should NOT be used in production environments.
+
+
+ {% hint style="info" %}
+ The Liquid Auth provider is currently experimental and subject to change in future releases. It requires users to have an Android v14+ device or an iOS 17+ device, and for developers to set up a [specific backend](https://liquidauth.com/server/introduction/). For more info, please refer to the [documentation](https://liquidauth.com/guides/getting-started/).
+ {% endhint %}
+
+[Liquid Auth documentation](https://liquidauth.com/guides/getting-started/)
+
 ### Development Wallets
 
 #### KMD

diff --git a/examples/nuxt/package.json b/examples/nuxt/package.json
@@ -12,6 +12,7 @@
     "test:e2e": "playwright test"
   },
   "dependencies": {
+    "@algorandfoundation/liquid-auth-use-wallet-client": "^1.4.0-canary.1",
     "@blockshake/defly-connect": "^1.2.1",
     "@noble/ed25519": "2.3.0",
     "@perawallet/connect": "^1.4.1",

diff --git a/examples/nuxt/plugins/walletManager.client.ts b/examples/nuxt/plugins/walletManager.client.ts
@@ -18,6 +18,14 @@ export default defineNuxtPlugin((nuxtApp) => {
       },
       WalletId.KMD,
       WalletId.KIBISIS,
+      {
+        id: WalletId.LIQUID,
+        options: {
+          origin: 'https://debug.liquidauth.com',
+          RTC_config_username: 'liquid-auth',
+          RTC_config_credential: 'sqmcP4MiTKMT4TGEDSk9jgHY'
+        }
+      },
       WalletId.LUTE,
       {
         id: WalletId.MAGIC,

diff --git a/examples/react-ts/package.json b/examples/react-ts/package.json
@@ -10,6 +10,7 @@
     "test:e2e": "playwright test"
   },
   "dependencies": {
+    "@algorandfoundation/liquid-auth-use-wallet-client": "^1.4.0-canary.1",
     "@blockshake/defly-connect": "^1.2.1",
     "@noble/ed25519": "2.3.0",
     "@perawallet/connect": "^1.4.1",

diff --git a/examples/react-ts/src/App.tsx b/examples/react-ts/src/App.tsx
@@ -21,6 +21,14 @@ const walletManager = new WalletManager({
     },
     WalletId.KMD,
     WalletId.KIBISIS,
+    {
+      id: WalletId.LIQUID,
+      options: {
+        origin: 'https://debug.liquidauth.com',
+        RTC_config_username: 'liquid-auth',
+        RTC_config_credential: 'sqmcP4MiTKMT4TGEDSk9jgHY'
+      }
+    },
     WalletId.LUTE,
     {
       id: WalletId.MAGIC,

diff --git a/examples/solid-ts/package.json b/examples/solid-ts/package.json
@@ -11,6 +11,7 @@
     "test:e2e": "playwright test"
   },
   "dependencies": {
+    "@algorandfoundation/liquid-auth-use-wallet-client": "^1.4.0-canary.1",
     "@blockshake/defly-connect": "^1.2.1",
     "@noble/ed25519": "2.3.0",
     "@perawallet/connect": "^1.4.1",

diff --git a/examples/solid-ts/src/App.tsx b/examples/solid-ts/src/App.tsx
@@ -21,6 +21,14 @@ const walletManager = new WalletManager({
     },
     WalletId.KMD,
     WalletId.KIBISIS,
+    {
+      id: WalletId.LIQUID,
+      options: {
+        origin: 'https://debug.liquidauth.com',
+        RTC_config_username: 'liquid-auth',
+        RTC_config_credential: 'sqmcP4MiTKMT4TGEDSk9jgHY'
+      }
+    },
     WalletId.LUTE,
     {
       id: WalletId.MAGIC,

diff --git a/examples/svelte-ts/vite.config.ts b/examples/svelte-ts/vite.config.ts
@@ -3,5 +3,9 @@ import { defineConfig } from 'vite'
 import { nodePolyfills } from 'vite-plugin-node-polyfills'
 
 export default defineConfig({
-  plugins: [sveltekit(), nodePolyfills()]
+  plugins: [sveltekit(), nodePolyfills()],
+  ssr: {
+    noExternal: ['@algorandfoundation/liquid-auth-use-wallet-client'],
+    external: ['cbor-x']
+  }
 })
diff --git a/examples/vanilla-ts/package.json b/examples/vanilla-ts/package.json
@@ -16,6 +16,7 @@
     "vite-plugin-node-polyfills": "0.23.0"
   },
   "dependencies": {
+    "@algorandfoundation/liquid-auth-use-wallet-client": "^1.4.0-canary.1",
     "@blockshake/defly-connect": "^1.2.1",
     "@noble/ed25519": "2.3.0",
     "@perawallet/connect": "^1.4.1",

diff --git a/examples/vanilla-ts/src/main.ts b/examples/vanilla-ts/src/main.ts
@@ -21,6 +21,14 @@ const walletManager = new WalletManager({
     },
     WalletId.KMD,
     WalletId.KIBISIS,
+    {
+      id: WalletId.LIQUID,
+      options: {
+        origin: 'https://debug.liquidauth.com',
+        RTC_config_username: 'liquid-auth',
+        RTC_config_credential: 'sqmcP4MiTKMT4TGEDSk9jgHY'
+      }
+    },
     WalletId.LUTE,
     {
       id: WalletId.MAGIC,

diff --git a/examples/vue-ts/package.json b/examples/vue-ts/package.json
@@ -10,6 +10,7 @@
     "test:e2e": "playwright test"
   },
   "dependencies": {
+    "@algorandfoundation/liquid-auth-use-wallet-client": "^1.4.0-canary.1",
     "@blockshake/defly-connect": "^1.2.1",
     "@noble/ed25519": "2.3.0",
     "@perawallet/connect": "^1.4.1",

diff --git a/examples/vue-ts/src/main.ts b/examples/vue-ts/src/main.ts
@@ -21,6 +21,14 @@ app.use(WalletManagerPlugin, {
     },
     WalletId.KMD,
     WalletId.KIBISIS,
+    {
+      id: WalletId.LIQUID,
+      options: {
+        origin: 'https://debug.liquidauth.com',
+        RTC_config_username: 'liquid-auth',
+        RTC_config_credential: 'sqmcP4MiTKMT4TGEDSk9jgHY'
+      }
+    },
     WalletId.LUTE,
     {
       id: WalletId.MAGIC,

diff --git a/packages/use-wallet/package.json b/packages/use-wallet/package.json
@@ -41,6 +41,7 @@
   },
   "devDependencies": {
     "@agoralabs-sh/avm-web-provider": "1.7.0",
+    "@algorandfoundation/liquid-auth-use-wallet-client": "^1.4.0-canary.1",
     "@blockshake/defly-connect": "1.2.1",
     "@magic-ext/algorand": "24.1.0",
     "@magic-sdk/provider": "29.1.0",
@@ -59,6 +60,7 @@
   },
   "peerDependencies": {
     "@agoralabs-sh/avm-web-provider": "^1.7.0",
+    "@algorandfoundation/liquid-auth-use-wallet-client": "^1.4.0-canary.1",
     "@blockshake/defly-connect": "^1.2.1",
     "@perawallet/connect": "^1.4.1",
     "@walletconnect/modal": "^2.7.0",
@@ -70,6 +72,9 @@
     "@agoralabs-sh/avm-web-provider": {
       "optional": true
     },
+    "@algorandfoundation/liquid-auth-use-wallet-client": {
+      "optional": true
+    },
     "@blockshake/defly-connect": {
       "optional": true
     },