javascript-solid-server 0.0.106 → 0.0.108

package/PAY.md

@@ -9,13 +9,15 @@ JSS has a built-in payment system. Resources under `/pay/*` cost satoshis to acc
 ```
 User (Nostr keypair)
   │
-  ├── POST /pay/.deposit   → credit sat balance
-  ├── GET  /pay/.balance   → check balance
+  ├── POST /pay/.deposit   → credit sat balance (multi-chain: txo:tbtc3:, txo:tbtc4:, etc.)
+  ├── GET  /pay/.balance   → check balance (includes per-chain balances)
   ├── GET  /pay/*          → spend 1 sat, get resource
   ├── POST /pay/.buy       → spend sats, get tokens (Bitcoin TX)
   ├── POST /pay/.withdraw  → spend balance, get tokens back
   ├── POST /pay/.sell      → list tokens for sale
-  └── POST /pay/.swap      → buy someone's sell order
+  ├── POST /pay/.swap      → buy someone's sell order
+  ├── GET  /pay/.pool      → AMM pool state (multi-chain)
+  └── POST /pay/.pool      → AMM: swap, add-liquidity, remove-liquidity
 ```
 
 All state lives in two places:
@@ -59,6 +61,17 @@ Response:
 
 The `token` field is only present when `--pay-token` is configured. `rate` is sats per token.
 
+When `--pay-chains` is configured, the response also includes:
+```json
+{
+  "chains": [
+    { "id": "tbtc3", "unit": "tbtc3", "name": "Bitcoin Testnet3" },
+    { "id": "tbtc4", "unit": "tbtc4", "name": "Bitcoin Testnet4" }
+  ],
+  "pool": "/pay/.pool"
+}
+```
+
 ### GET /pay/.balance
 **Requires NIP-98 auth.**
 
@@ -280,9 +293,10 @@ jss token info PODS
 
 | File | Contents |
 |------|----------|
-| `/.well-known/webledgers/webledgers.json` | Sat balances per DID (webledgers.org spec) |
+| `/.well-known/webledgers/webledgers.json` | Balances per DID — multi-currency array format (webledgers.org spec) |
 | `/.well-known/webledgers/replay.json` | Seen MRC20 state hashes (replay protection) |
 | `/.well-known/webledgers/offers.json` | Open sell orders (secondary market) |
+| `/.well-known/webledgers/pool.json` | AMM pool state (reserves, LP shares, k) |
 | `/.well-known/token/<ticker>.json` | MRC20 token trail (state chain, keys, UTXO) |
 
 ## Source Files
@@ -330,6 +344,18 @@ jss token info PODS
 6. POST /pay/.swap           → buys the 50 PODS, seller gets 750 sats credited
 ```
 
+### Cross-chain AMM trading
+```
+1. Configure pod:  jss start --pay --pay-chains "tbtc3,tbtc4"
+2. User A deposits: POST /pay/.deposit "txo:tbtc3:<txid>:<vout>" → gets tbtc3 balance
+3. User B deposits: POST /pay/.deposit "txo:tbtc4:<txid>:<vout>" → gets tbtc4 balance
+4. User A adds liquidity: POST /pay/.pool { "action": "add-liquidity", "tbtc3": 1000, "tbtc4": 5000 }
+5. User B swaps: POST /pay/.pool { "action": "swap", "sell": "tbtc4", "amount": 500 }
+   → receives ~90 tbtc3 (constant product formula, 0.3% fee)
+6. User A removes liquidity: POST /pay/.pool { "action": "remove-liquidity", "all": true }
+   → gets back proportional share of both currencies + earned fees
+```
+
 ### Full exit
 ```
 1. POST /pay/.withdraw { "all": true }  → converts entire balance to portable tokens

package/README.md

@@ -158,9 +158,12 @@ jss --help             # Show help
 | `--pay-address <addr>` | Address for receiving deposits | - |
 | `--pay-token <ticker>` | Token to sell (enables primary market + withdrawal) | - |
 | `--pay-rate <n>` | Sats per token for buy/withdraw | 1 |
+| `--pay-chains <ids>` | Multi-chain deposits + AMM (e.g. "tbtc3,tbtc4") | - |
 | `--mongo` | Enable MongoDB-backed /db/ route | false |
 | `--mongo-url <url>` | MongoDB connection URL | mongodb://localhost:27017 |
 | `--mongo-database <name>` | MongoDB database name | solid |
+| `--webrtc` | Enable WebRTC signaling server | false |
+| `--webrtc-path <path>` | WebRTC signaling WebSocket path | /.webrtc |
 | `-q, --quiet` | Suppress logs | false |
 
 ### Environment Variables
@@ -194,6 +197,7 @@ export JSS_PAY_RATE=10
 export JSS_MONGO=true
 export JSS_MONGO_URL=mongodb://localhost:27017
 export JSS_MONGO_DATABASE=solid
+export JSS_WEBRTC=true
 jss start
 ```
 
@@ -822,6 +826,42 @@ curl -X DELETE http://localhost:3000/db/alice/notes/1 \
 
 Supported formats: `50MB`, `1GB`, `500KB`, `1TB`
 
+## WebRTC Signaling
+
+Peer-to-peer communication via WebRTC, using JSS as the signaling server. Once peers are connected, all media and data flows directly between them.
+
+```bash
+jss start --webrtc
+```
+
+### How It Works
+
+1. Both peers connect to `wss://your.pod/.webrtc` (WebID auth required)
+2. Caller sends an SDP offer targeting the callee's WebID
+3. JSS relays the offer/answer and ICE candidates between peers
+4. Once a direct path is found, the peer-to-peer connection is established
+5. JSS steps out — video, audio, files, and data flow directly between peers
+
+### Protocol
+
+Messages are JSON over WebSocket:
+
+```js
+// Send an offer to another user
+{ "type": "offer", "to": "https://bob.example/profile/card#me", "sdp": "..." }
+
+// Receive an offer from another user
+{ "type": "offer", "from": "https://alice.example/profile/card#me", "sdp": "..." }
+
+// ICE candidate exchange
+{ "type": "candidate", "to": "https://bob.example/profile/card#me", "candidate": {...} }
+
+// Hang up
+{ "type": "hangup", "to": "https://bob.example/profile/card#me" }
+```
+
+On connect, peers receive a list of online users and get notified when others join or leave.
+
 ## HTTP 402 Paid Access
 
 Monetize API endpoints with per-request satoshi payments. Resources under `/pay/*` require NIP-98 authentication and a positive balance.
@@ -834,11 +874,16 @@ jss start --pay --pay-cost 10 --pay-address your-address --pay-token PODS --pay-
 
 | Method | Path | Description |
 |--------|------|-------------|
-| GET | `/pay/.info` | Public: cost, token info, available routes |
+| GET | `/pay/.info` | Public: cost, token info, chains, pool |
 | GET | `/pay/.balance` | Check your balance (NIP-98 auth) |
 | POST | `/pay/.deposit` | Deposit sats via TXO URI or MRC20 state proof |
 | POST | `/pay/.buy` | Buy tokens with sat balance (requires `--pay-token`) |
 | POST | `/pay/.withdraw` | Withdraw balance as portable tokens (requires `--pay-token`) |
+| GET | `/pay/.offers` | List open sell orders (secondary market) |
+| POST | `/pay/.sell` | Create a sell order (requires `--pay-token`) |
+| POST | `/pay/.swap` | Execute a swap against a sell order |
+| GET | `/pay/.pool` | AMM pool state (requires `--pay-chains`) |
+| POST | `/pay/.pool` | AMM swap, add/remove liquidity |
 | GET | `/pay/*` | Paid resource access (deducts balance) |
 
 ### How It Works
@@ -879,6 +924,39 @@ curl -X POST -H "Authorization: Nostr <base64-event>" \
 
 Deposit verification uses the mempool API (default: testnet4). The `X-Balance` and `X-Cost` headers are returned on successful paid requests. Buy and withdraw return portable MRC20 proofs with Bitcoin anchor data for independent verification.
 
+### Secondary Market
+
+Users can trade tokens peer-to-peer through the pod. Sell orders are created via `/pay/.sell` and filled via `/pay/.swap`. The pod acts as escrow — transferring tokens on the Bitcoin-anchored MRC20 trail and settling sats in the webledger.
+
+### Multi-Chain AMM
+
+Enable multi-chain deposits and an automated market maker:
+
+```bash
+jss start --pay --pay-chains "tbtc3,tbtc4"
+```
+
+Deposits detect the chain from the TXO URI prefix (`txo:tbtc3:txid:vout`). Each chain's balance is tracked separately. The AMM uses a constant-product formula (x × y = k) with a 0.3% fee.
+
+```bash
+# Add liquidity
+curl -X POST -H "Authorization: Nostr <token>" \
+  -H "Content-Type: application/json" \
+  http://localhost:3000/pay/.pool \
+  -d '{"action": "add-liquidity", "tbtc3": 1000, "tbtc4": 5000}'
+
+# Swap
+curl -X POST -H "Authorization: Nostr <token>" \
+  -H "Content-Type: application/json" \
+  http://localhost:3000/pay/.pool \
+  -d '{"action": "swap", "sell": "tbtc3", "amount": 100}'
+
+# Check pool state
+curl http://localhost:3000/pay/.pool
+```
+
+Supported chains: `btc`, `tbtc3`, `tbtc4`, `ltc`, `signet`.
+
 ## Authentication
 
 ### Simple Tokens (Development)

package/bin/jss.js

@@ -65,6 +65,9 @@ program
   .option('--no-nostr', 'Disable Nostr relay')
   .option('--nostr-path <path>', 'Nostr relay WebSocket path (default: /relay)')
   .option('--nostr-max-events <n>', 'Max events in relay memory (default: 1000)', parseInt)
+  .option('--webrtc', 'Enable WebRTC signaling server')
+  .option('--no-webrtc', 'Disable WebRTC signaling server')
+  .option('--webrtc-path <path>', 'WebRTC signaling WebSocket path (default: /.webrtc)')
   .option('--activitypub', 'Enable ActivityPub federation')
   .option('--no-activitypub', 'Disable ActivityPub federation')
   .option('--ap-username <name>', 'ActivityPub username (default: me)')
@@ -87,6 +90,7 @@ program
   .option('--pay-address <addr>', 'Address for receiving deposits')
   .option('--pay-token <ticker>', 'Token to sell (enables primary market)')
   .option('--pay-rate <n>', 'Sats per token for primary market (default: 1)', parseInt)
+  .option('--pay-chains <chains>', 'Comma-separated chain IDs for multi-chain deposits/AMM (e.g. "tbtc3,tbtc4")')
   .option('--mongo', 'Enable MongoDB-backed /db/ route')
   .option('--no-mongo', 'Disable MongoDB-backed /db/ route')
   .option('--mongo-url <url>', 'MongoDB connection URL (default: mongodb://localhost:27017)')
@@ -141,6 +145,8 @@ program
         nostr: config.nostr,
         nostrPath: config.nostrPath,
         nostrMaxEvents: config.nostrMaxEvents,
+        webrtc: config.webrtc,
+        webrtcPath: config.webrtcPath,
         activitypub: config.activitypub,
         apUsername: config.apUsername,
         apDisplayName: config.apDisplayName,
@@ -159,6 +165,7 @@ program
         payAddress: config.payAddress,
         payToken: config.payToken,
         payRate: config.payRate,
+        payChains: config.payChains,
         mongo: config.mongo,
         mongoUrl: config.mongoUrl,
         mongoDatabase: config.mongoDatabase,
@@ -184,6 +191,7 @@ program
         if (config.solidosUi) console.log('  SolidOS UI: enabled (modern interface)');
         if (config.git) console.log('  Git: enabled (clone/push support)');
         if (config.nostr) console.log(`  Nostr: enabled (${config.nostrPath})`);
+        if (config.webrtc) console.log(`  WebRTC: enabled (${config.webrtcPath || '/.webrtc'})`);
         if (config.activitypub) console.log(`  ActivityPub: enabled (@${config.apUsername || 'me'})`);
         if (config.singleUser) console.log(`  Single-user: ${config.singleUserName || 'me'} (registration disabled)`);
         else if (config.inviteOnly) console.log('  Registration: invite-only');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "javascript-solid-server",
-  "version": "0.0.106",
+  "version": "0.0.108",
   "description": "A minimal, fast Solid server",
   "main": "src/index.js",
   "type": "module",

package/src/config.js

@@ -54,6 +54,10 @@ export const defaults = {
   nostrPath: '/relay',
   nostrMaxEvents: 1000,
 
+  // WebRTC signaling
+  webrtc: false,
+  webrtcPath: '/.webrtc',
+
   // ActivityPub federation
   activitypub: false,
   apUsername: 'me',
@@ -90,6 +94,7 @@ export const defaults = {
   payAddress: null,
   payToken: null,
   payRate: 1,
+  payChains: null,  // comma-separated chain IDs, e.g. "tbtc3,tbtc4"
 
   // MongoDB-backed /db/ route
   mongo: false,
@@ -133,6 +138,8 @@ const envMap = {
   JSS_NOSTR: 'nostr',
   JSS_NOSTR_PATH: 'nostrPath',
   JSS_NOSTR_MAX_EVENTS: 'nostrMaxEvents',
+  JSS_WEBRTC: 'webrtc',
+  JSS_WEBRTC_PATH: 'webrtcPath',
   JSS_ACTIVITYPUB: 'activitypub',
   JSS_AP_USERNAME: 'apUsername',
   JSS_AP_DISPLAY_NAME: 'apDisplayName',
@@ -152,6 +159,7 @@ const envMap = {
   JSS_PAY_ADDRESS: 'payAddress',
   JSS_PAY_TOKEN: 'payToken',
   JSS_PAY_RATE: 'payRate',
+  JSS_PAY_CHAINS: 'payChains',
   JSS_MONGO: 'mongo',
   JSS_MONGO_URL: 'mongoUrl',
   JSS_MONGO_DATABASE: 'mongoDatabase',