@waiaas/wallet-sdk 2.9.0-rc.2 → 2.9.0-rc.3

package/dist/channels/index.d.ts

@@ -3,4 +3,5 @@
  */
 export { sendViaNtfy, subscribeToRequests, subscribeToNotifications, parseNotification, } from './ntfy.js';
 export { sendViaTelegram } from './telegram.js';
+export { sendViaRelay } from './relay.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/channels/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/channels/index.js

@@ -3,4 +3,5 @@
  */
 export { sendViaNtfy, subscribeToRequests, subscribeToNotifications, parseNotification, } from './ntfy.js';
 export { sendViaTelegram } from './telegram.js';
+export { sendViaRelay } from './relay.js';
 //# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/channels/relay.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Push Relay channel function for the WAIaaS Signing Protocol.
+ *
+ * Sends a SignResponse via the Push Relay server, which forwards it to ntfy.
+ * This allows wallet apps to only know the Push Relay URL, without needing
+ * direct access to the ntfy server.
+ *
+ * @see internal/design/73-signing-protocol-v1.md Section 7.4
+ */
+import type { SignResponse } from '@waiaas/core';
+/**
+ * Send a SignResponse via Push Relay.
+ *
+ * Posts the response to the Push Relay's `/v1/sign-response` endpoint,
+ * which relays it to the ntfy response topic for the daemon to receive.
+ *
+ * @param response - Validated SignResponse object
+ * @param responseTopic - ntfy response topic name (from SignRequest.responseChannel.responseTopic)
+ * @param pushRelayUrl - Push Relay server URL (e.g., "https://push-relay.example.com")
+ */
+export declare function sendViaRelay(response: SignResponse, responseTopic: string, pushRelayUrl: string): Promise<void>;
+//# sourceMappingURL=relay.d.ts.map

package/dist/channels/relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../../src/channels/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/channels/relay.js

@@ -0,0 +1,37 @@
+/**
+ * Push Relay channel function for the WAIaaS Signing Protocol.
+ *
+ * Sends a SignResponse via the Push Relay server, which forwards it to ntfy.
+ * This allows wallet apps to only know the Push Relay URL, without needing
+ * direct access to the ntfy server.
+ *
+ * @see internal/design/73-signing-protocol-v1.md Section 7.4
+ */
+/**
+ * Send a SignResponse via Push Relay.
+ *
+ * Posts the response to the Push Relay's `/v1/sign-response` endpoint,
+ * which relays it to the ntfy response topic for the daemon to receive.
+ *
+ * @param response - Validated SignResponse object
+ * @param responseTopic - ntfy response topic name (from SignRequest.responseChannel.responseTopic)
+ * @param pushRelayUrl - Push Relay server URL (e.g., "https://push-relay.example.com")
+ */
+export async function sendViaRelay(response, responseTopic, pushRelayUrl) {
+    const url = `${pushRelayUrl.replace(/\/$/, '')}/v1/sign-response`;
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            requestId: response.requestId,
+            action: response.action,
+            ...(response.signature !== undefined ? { signature: response.signature } : {}),
+            signerAddress: response.signerAddress,
+            responseTopic,
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to send response via Push Relay: HTTP ${String(res.status)}`);
+    }
+}
+//# sourceMappingURL=relay.js.map

package/dist/channels/relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.js","sourceRoot":"","sources":["../../src/channels/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAsB,EACtB,aAAqB,EACrB,YAAoB;IAEpB,MAAM,GAAG,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,CAAC;IAElE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;QAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,aAAa;SACd,CAAC;KACH,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,gDAAgD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -8,6 +8,7 @@
  *   - buildSignResponse(requestId, action, signature?, signerAddress) - Create SignResponse
  *   - formatDisplayMessage(request) - Human-readable transaction summary
  *   - sendViaNtfy(response, topic, serverUrl?) - Publish to ntfy response topic
+ *   - sendViaRelay(response, topic, pushRelayUrl) - Send via Push Relay server
  *   - sendViaTelegram(response, botUsername) - Generate Telegram deeplink URL
  *   - subscribeToRequests(topic, callback, serverUrl?) - SSE subscription for sign requests
  *   - subscribeToNotifications(topic, callback, serverUrl?) - SSE subscription for notifications
@@ -19,7 +20,7 @@
 export { parseSignRequest } from './parse-request.js';
 export { buildSignResponse } from './build-response.js';
 export { formatDisplayMessage } from './display.js';
-export { sendViaNtfy, subscribeToRequests, sendViaTelegram, subscribeToNotifications, parseNotification, } from './channels/index.js';
+export { sendViaNtfy, subscribeToRequests, sendViaTelegram, sendViaRelay, subscribeToNotifications, parseNotification, } from './channels/index.js';
 export { InvalidSignRequestUrlError, SignRequestExpiredError, SignRequestValidationError, } from './errors.js';
 export type { SignRequest, SignResponse, WalletLinkConfig, NotificationMessage, } from '@waiaas/core';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -8,6 +8,7 @@
  *   - buildSignResponse(requestId, action, signature?, signerAddress) - Create SignResponse
  *   - formatDisplayMessage(request) - Human-readable transaction summary
  *   - sendViaNtfy(response, topic, serverUrl?) - Publish to ntfy response topic
+ *   - sendViaRelay(response, topic, pushRelayUrl) - Send via Push Relay server
  *   - sendViaTelegram(response, botUsername) - Generate Telegram deeplink URL
  *   - subscribeToRequests(topic, callback, serverUrl?) - SSE subscription for sign requests
  *   - subscribeToNotifications(topic, callback, serverUrl?) - SSE subscription for notifications
@@ -21,7 +22,7 @@ export { parseSignRequest } from './parse-request.js';
 export { buildSignResponse } from './build-response.js';
 export { formatDisplayMessage } from './display.js';
 // Channel functions
-export { sendViaNtfy, subscribeToRequests, sendViaTelegram, subscribeToNotifications, parseNotification, } from './channels/index.js';
+export { sendViaNtfy, subscribeToRequests, sendViaTelegram, sendViaRelay, subscribeToNotifications, parseNotification, } from './channels/index.js';
 // Error classes
 export { InvalidSignRequestUrlError, SignRequestExpiredError, SignRequestValidationError, } from './errors.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,gBAAgB;AAChB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAE7B,gBAAgB;AAChB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waiaas/wallet-sdk",
-  "version": "2.9.0-rc.2",
+  "version": "2.9.0-rc.3",
   "description": "WAIaaS Wallet Signing SDK - integrate wallet apps with WAIaaS signing protocol",
   "license": "MIT",
   "type": "module",
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "zod": "^3.24.0",
-    "@waiaas/core": "2.9.0-rc.2"
+    "@waiaas/core": "2.9.0-rc.3"
   },
   "devDependencies": {
     "@types/node": "^25.2.3",