Skip to content

feat: adds Liquid Auth /Start API and WebSockets/WebRTC - #22

Draft
HashMapsData2Value wants to merge 7 commits into
masterfrom
feat/fee-cover-api
Draft

HashMapsData2Value wants to merge 7 commits into
masterfrom
feat/fee-cover-api

Conversation

@HashMapsData2Value

@HashMapsData2Value HashMapsData2Value commented Jan 20, 2026

Copy link
Copy Markdown
Contributor
  • Adds the v1/liquid/start API. Making a request to it will return a request id and start up a SignalClient. (This is equivalent to the in-browser Liquid Auth module that presents the request id as a QR code)
  • Adds a Signal Client Manager. It's a singleton that lives in memory. Manages each signal
  • Polyfills for WebRTC (node-datachannel) and socket.io (ws).
  • Expanded on the Docker image distro environment, since more software are needed to handle WebSockets and WebRTC.

@HashMapsData2Value
HashMapsData2Value marked this pull request as draft January 20, 2026 12:14
[WIP] working liquid client

[WIP] working headless liquidauth

chore: cleanup and tests

chore: signal controller tests

chore: .env

chore: include .env

chore: package
Comment thread package.json
},
"dependencies": {
"@algorandfoundation/algo-models": "1.0.0-canary.4",
"@algorandfoundation/liquid-client": "./algorandfoundation-liquid-client-1.0.0-canary.3.tgz",

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Make sure to remove before merge. Dependent on algorandfoundation/liquid-auth-js#24

@github-actions

Copy link
Copy Markdown

Coverage report

Caution

Test run failed

St.
Category Percentage Covered / Total
🟡 Statements
74.39% (-10.77% 🔻)
799/1074
🔴 Branches
50.97% (-18.47% 🔻)
131/257
🟡 Functions
60.81% (-12.45% 🔻)
90/148
🟡 Lines
75.25% (-9.59% 🔻)
739/982
Show new covered files 🐣
St.
File Statements Branches Functions Lines
🟢
... / signal-client.module.ts
100% 100% 100% 100%
🟡
... / signal-client.manager.ts
71.79% 47.37% 46.15% 73.57%
🔴
... / signal-fsm.ts
32.93% 24.36% 40% 35.17%
🟡
... / utils.ts
62.07% 28.57% 36.36% 60.71%
🟢
... / signal-client.controller.ts
100% 66.67% 100% 100%
🟡 polyfills/webrtc.ts 70% 77.5% 0% 77.14%
🟢
... / algokit-utils-transact.d.ts
100% 100% 100% 100%

Test suite run failed

Failed tests: 1/104. Failed suites: 1/17.
  ● SignalClientController › start returns session shape when manager succeeds

    expect(received).toEqual(expected) // deep equality

    - Expected  - 1
    + Received  + 1

      Object {
        "expiresAt": 12345,
    -   "origin": "https://debug.liquidauth.com",
    +   "origin": "https://beetle-never.ngrok-free.app",
        "requestId": "r1",
        "status": "starting",
      }

      18 |     mockManager.startOffer.mockResolvedValueOnce(fakeSession);
      19 |     const result = await controller.start();
    > 20 |     expect(result).toEqual({
         |                    ^
      21 |       requestId: fakeSession.requestId,
      22 |       expiresAt: fakeSession.expiresAt,
      23 |       status: fakeSession.state,

      at Object.<anonymous> (liquid-auth/signal-client.controller.spec.ts:20:20)

Report generated by 🧪jest coverage report action from d60b9b0

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant