@waiaas/skills 2.9.0-rc.8 → 2.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waiaas/skills",
-  "version": "2.9.0-rc.8",
+  "version": "2.9.0",
   "description": "WAIaaS skill files for AI agents - install via npx @waiaas/skills add <name>",
   "license": "MIT",
   "type": "module",

package/skills/actions.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Actions"
 description: "Action Provider framework: list providers, execute DeFi actions through the 6-stage transaction pipeline"
 category: "api"
 tags: [wallet, blockchain, defi, actions, waiass, jupiter, 0x, swap, lifi, bridge, cross-chain, lido, jito, staking, liquid-staking, pendle, yield, pt, yt, drift, perp, perpetual, leverage, futures]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/admin.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Admin"
 description: "Admin API: daemon status, kill switch, notifications, settings management, JWT rotation, shutdown, oracle status, API key management"
 category: "api"
 tags: [wallet, blockchain, admin, security, oracle, defi, waiass]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]
@@ -325,7 +325,7 @@ curl -s -X POST http://localhost:3100/v1/admin/notifications/test \
 }
 ```
 
-> **ntfy channel:** In Admin UI, ntfy has its own section in Notifications Settings (separate from Other Channels). Per-app notification settings (Signing/Alerts toggles) are managed in Human Wallet Apps.
+> **ntfy channel:** Per-wallet ntfy topics (sign_topic, notify_topic) are managed in Human Wallet Apps (`POST/PUT /v1/admin/wallet-apps`). The ntfy server URL is a shared global setting (`notifications.ntfy_server`).
 
 ### GET /v1/admin/notifications/log -- Query Delivery Logs
 
@@ -390,7 +390,6 @@ curl -s http://localhost:3100/v1/admin/settings \
     "notifications.telegram_chat_id": "123456789",
     "notifications.discord_webhook_url": false,
     "notifications.ntfy_server": "https://ntfy.sh",
-    "notifications.ntfy_topic": "",
     "notifications.slack_webhook_url": false,
     "notifications.locale": "en",
     "notifications.rate_limit_rpm": "20"
@@ -467,7 +466,7 @@ curl -s http://localhost:3100/v1/admin/settings \
 
 | Category        | Keys                                                    | Description                            |
 | --------------- | ------------------------------------------------------- | -------------------------------------- |
-| `notifications` | enabled, telegram_*, discord_*, ntfy_*, slack_*, locale, rate_limit_rpm | Notification channel configuration.  |
+| `notifications` | enabled, telegram_*, discord_*, ntfy_server, slack_*, locale, rate_limit_rpm | Notification channel configuration.  |
 | `rpc`           | solana_*, evm_*                                         | Blockchain RPC endpoint URLs.          |
 | `security`      | max_sessions_*, max_pending_tx, rate_limit_*, policy_defaults_* | Security and rate limiting.         |
 | `daemon`        | log_level                                               | Daemon runtime settings.               |
@@ -529,7 +528,6 @@ Notifications:
 - `notifications.telegram_chat_id` -- Telegram chat ID
 - `notifications.discord_webhook_url` -- Discord webhook URL (credential, encrypted at rest)
 - `notifications.ntfy_server` -- ntfy server URL (default: "https://ntfy.sh")
-- `notifications.ntfy_topic` -- ntfy topic name
 - `notifications.slack_webhook_url` -- Slack webhook URL (credential, encrypted at rest)
 - `notifications.locale` -- Notification locale ("en", "ko", etc.)
 - `notifications.rate_limit_rpm` -- Notification rate limit (per minute)
@@ -878,7 +876,7 @@ If no key exists for the provider, returns 404 `ACTION_NOT_FOUND`.
 
 ## 8. Human Wallet Apps Management (v29.7)
 
-Manage Human Wallet Apps -- the wallet applications used by the human operator for signing requests and activity alerts. Apps are tied to ntfy notification topics (`waiaas-sign-{name}` for signing, `waiaas-notify-{name}` for alerts).
+Manage Human Wallet Apps -- the wallet applications used by the human operator for signing requests and activity alerts. Each app has explicit `sign_topic` and `notify_topic` fields for ntfy push notifications (defaults: `waiaas-sign-{name}`, `waiaas-notify-{name}`). Topics are editable per-app.
 
 When a wallet preset (e.g., D'CENT) is applied to a wallet via `PUT /v1/wallets/{id}/owner`, the corresponding app is automatically registered in the wallet_apps registry.
 
@@ -903,6 +901,8 @@ curl -s http://localhost:3100/v1/admin/wallet-apps \
       "display_name": "D'CENT Wallet",
       "signing_enabled": true,
       "alerts_enabled": true,
+      "sign_topic": "waiaas-sign-dcent",
+      "notify_topic": "waiaas-notify-dcent",
       "used_by": [
         {"id": "<wallet-uuid>", "label": "my-wallet"}
       ],
@@ -920,6 +920,8 @@ curl -s http://localhost:3100/v1/admin/wallet-apps \
 | `display_name` | string | Human-readable display name. |
 | `signing_enabled` | boolean | Whether signing requests are routed to this app. |
 | `alerts_enabled` | boolean | Whether activity alerts are sent to this app. |
+| `sign_topic` | string\|null | ntfy topic for signing requests (null = default `waiaas-sign-{name}`). |
+| `notify_topic` | string\|null | ntfy topic for activity alerts (null = default `waiaas-notify-{name}`). |
 | `used_by` | array | Wallets using this app (`wallet_type` = app name). |
 | `created_at` | integer | Unix timestamp (seconds). |
 | `updated_at` | integer | Unix timestamp (seconds). |
@@ -932,7 +934,7 @@ Register a new wallet app manually.
 curl -s -X POST http://localhost:3100/v1/admin/wallet-apps \
   -H 'Content-Type: application/json' \
   -H 'X-Master-Password: <password>' \
-  -d '{"name": "my-custom-wallet", "display_name": "My Custom Wallet"}'
+  -d '{"name": "my-custom-wallet", "display_name": "My Custom Wallet", "sign_topic": "custom-sign", "notify_topic": "custom-notify"}'
 ```
 
 **Request body:**
@@ -941,6 +943,8 @@ curl -s -X POST http://localhost:3100/v1/admin/wallet-apps \
 | ----- | ---- | -------- | ----------- |
 | `name` | string | Yes | Unique app identifier (lowercase, kebab-case). |
 | `display_name` | string | Yes | Human-readable display name. |
+| `sign_topic` | string | No | ntfy topic for signing requests (auto-generates `waiaas-sign-{name}` if omitted). |
+| `notify_topic` | string | No | ntfy topic for activity alerts (auto-generates `waiaas-notify-{name}` if omitted). |
 
 **Response (201):**
 ```json
@@ -951,6 +955,8 @@ curl -s -X POST http://localhost:3100/v1/admin/wallet-apps \
     "display_name": "My Custom Wallet",
     "signing_enabled": true,
     "alerts_enabled": true,
+    "sign_topic": "custom-sign",
+    "notify_topic": "custom-notify",
     "used_by": [],
     "created_at": 1707000000,
     "updated_at": 1707000000
@@ -960,15 +966,15 @@ curl -s -X POST http://localhost:3100/v1/admin/wallet-apps \
 
 Error: `WALLET_APP_DUPLICATE` (409) if an app with the same name already exists.
 
-### PUT /v1/admin/wallet-apps/{id} -- Update App Toggles
+### PUT /v1/admin/wallet-apps/{id} -- Update Wallet App
 
-Toggle signing and/or alerts for a wallet app.
+Update signing/alerts toggles and/or ntfy topics for a wallet app.
 
 ```bash
 curl -s -X PUT http://localhost:3100/v1/admin/wallet-apps/<app-uuid> \
   -H 'Content-Type: application/json' \
   -H 'X-Master-Password: <password>' \
-  -d '{"signing_enabled": true, "alerts_enabled": false}'
+  -d '{"signing_enabled": true, "alerts_enabled": false, "sign_topic": "my-sign-topic"}'
 ```
 
 **Request body:**
@@ -977,6 +983,8 @@ curl -s -X PUT http://localhost:3100/v1/admin/wallet-apps/<app-uuid> \
 | ----- | ---- | -------- | ----------- |
 | `signing_enabled` | boolean | No | Enable/disable signing request routing. |
 | `alerts_enabled` | boolean | No | Enable/disable activity alert notifications. |
+| `sign_topic` | string | No | Update ntfy signing request topic. |
+| `notify_topic` | string | No | Update ntfy activity alert topic. |
 
 **Response (200):** Same schema as POST response (includes `used_by`).
 

package/skills/policies.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Policies"
 description: "Policy engine CRUD: 12 policy types for spending limits, whitelists, time restrictions, rate limits, token/contract/approve controls, network restrictions, x402 domain controls"
 category: "api"
 tags: [wallet, blockchain, policies, security, waiass]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/quickstart.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Quickset"
 description: "End-to-end quickset: create wallet, session, check balance, send first transfer"
 category: "api"
 tags: [wallet, blockchain, solana, ethereum, quickset, quickstart, waiass]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/session-recovery.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Session Recovery"
 description: "Recover from expired or permanently expired session tokens"
 category: "api"
 tags: [wallet, blockchain, session, recovery, token, expired, waiass]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/setup.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Setup"
 description: "Zero-state daemon setup: install CLI, initialize, start daemon, create wallet, configure session"
 category: "api"
 tags: [wallet, blockchain, solana, ethereum, setup, install, waiass]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl", "npm", "npx", "waiaas", "which"]

package/skills/transactions.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Transactions"
 description: "All 5 transaction types (TRANSFER, TOKEN_TRANSFER, CONTRACT_CALL, APPROVE, BATCH) with lifecycle management"
 category: "api"
 tags: [wallet, blockchain, solana, ethereum, transactions, waiass]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]

package/skills/wallet.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS Wallet Management"
 description: "Wallet CRUD, asset queries, session management, token registry, MCP provisioning, owner management"
 category: "api"
 tags: [wallet, blockchain, solana, ethereum, sessions, tokens, mcp, waiass]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]
@@ -1015,6 +1015,44 @@ const notification = parseNotification(base64urlEncodedString);
 // notification: { version, eventType, walletId, walletName, category, title, body, details?, timestamp }
 ```
 
+## 14b. Wallet SDK: Push Relay Device Management
+
+The `@waiaas/wallet-sdk` package provides helper functions for registering and managing devices with the Push Relay server.
+
+### registerDevice(pushRelayUrl, apiKey, opts)
+
+Register a device for native push delivery via Push Relay.
+
+```typescript
+import { registerDevice } from '@waiaas/wallet-sdk';
+
+const { subscriptionToken } = await registerDevice(
+  'https://your-push-relay:3200',
+  'your-secret-api-key',
+  { walletName: 'my-wallet', pushToken: devicePushToken, platform: 'android' },
+);
+```
+
+### unregisterDevice(pushRelayUrl, apiKey, pushToken)
+
+Remove a device registration from Push Relay.
+
+```typescript
+import { unregisterDevice } from '@waiaas/wallet-sdk';
+
+await unregisterDevice('https://your-push-relay:3200', 'your-secret-api-key', devicePushToken);
+```
+
+### getSubscriptionToken(pushRelayUrl, apiKey, pushToken)
+
+Look up the subscription token for a registered device. Returns `null` if not found.
+
+```typescript
+import { getSubscriptionToken } from '@waiaas/wallet-sdk';
+
+const token = await getSubscriptionToken('https://your-push-relay:3200', 'your-secret-api-key', devicePushToken);
+```
+
 ### NotificationMessage Type
 
 ```typescript

package/skills/x402.skill.md

@@ -3,7 +3,7 @@ name: "WAIaaS x402"
 description: "x402 auto-payment protocol: fetch URLs with automatic cryptocurrency payments"
 category: "api"
 tags: [wallet, blockchain, x402, payments, waiass]
-version: "2.9.0-rc.8"
+version: "2.9.0"
 dispatch:
   kind: "tool"
   allowedCommands: ["curl"]