beignet 0.33.0 → 0.35.0

package/README.md

@@ -37,6 +37,8 @@ console.log(wallet.getBalance());
 
 From here: [the on-chain wallet](#on-chain-wallet) for sending, PSBTs, multisig and watch-only, or [Lightning](#lightning) for channels and payments.
 
+For adding `bgnq` direct-funding payments to another wallet, see the [standalone TypeScript payer SDK](packages/direct-funding/README.md). It includes a PSBT signing adapter, Bitcoin Core integration, and a channel-free peer client.
+
 ## Try the examples
 
 The fastest way to understand the whole system is to run the two REPL examples against a live wallet and a live node. Both are checked-in TypeScript you can read and edit.
@@ -694,6 +696,8 @@ npm run test:conformance   # 300+ official BOLT vector cases (subset of test:lig
 npm run test:chaos         # recovery kill matrices (parallel), split out of test:lightning
 npm run test:sigkill       # process-level SIGKILL chaos matrix (builds dist first)
 npm run test:api           # exported API vs tests/api-snapshot (npm run api:snapshot regenerates it)
+npm run test:direct-funding # standalone payer SDK, wallet adapters and packaging
+npm run test:direct-funding:regtest # real Core wallets and funding transactions (needs Docker)
 npm run test:integration   # daemon/Electrum integration (needs an Electrum server)
 npm run test:interop       # 300+ cases vs LND/CLN/Eclair (needs Docker)
 npm run test:interop:ffor  # FFOR Variant D chain gates on regtest (needs only the bitcoind container)

package/dist/cli/beignet-node.js

@@ -2138,6 +2138,7 @@ class BeignetNode extends typed_emitter_1.TypedEmitter {
             chainBackend: electrumBackend,
             feeEstimator: electrumBackend,
             logger: this.logger,
+            wireTrace: opts.wireTrace,
             sweepDestinationScript,
             socks5Proxy,
             socks5ProxyScope,
@@ -2552,8 +2553,22 @@ class BeignetNode extends typed_emitter_1.TypedEmitter {
             });
         });
         // Forward peer events
+        // Connects and disconnects are logged at info: a peer that evicts us
+        // (eclair's max-no-channels) and the auto reconnect after it are
+        // otherwise invisible at the level a daemon runs at.
         this.node.on('peer:connect', (pubkey) => {
-            this.log('debug', 'Peer connected', { pubkey });
+            let direction;
+            try {
+                direction = this.node.getPeerManager()?.getConnectionInfo(pubkey)
+                    ?.direction;
+            }
+            catch {
+                // The log line must not cost the gossip sync below.
+            }
+            this.log('info', 'Peer connected', {
+                pubkey,
+                ...(direction ? { direction } : {})
+            });
             // Pull the gossip graph from the peer so we can route multi-hop payments
             // to destinations beyond our direct channels. Without this the graph
             // stays empty and only direct-peer payments work.
@@ -2587,9 +2602,23 @@ class BeignetNode extends typed_emitter_1.TypedEmitter {
             }
             this.emit('peer:connect', { pubkey });
         });
-        this.node.on('peer:disconnect', (pubkey) => {
-            this.log('debug', 'Peer disconnected', { pubkey });
-            this.emit('peer:disconnect', { pubkey });
+        this.node.on('peer:disconnect', (pubkey, info) => {
+            // Subscribers (SSE, webhooks, an embedding app's diagnostics)
+            // get the same cause the log line names.
+            const cause = info
+                ? {
+                    closedBy: info.initiator === 'remote'
+                        ? 'peer'
+                        : 'us',
+                    ...(info.reason ? { reason: info.reason } : {}),
+                    direction: info.direction,
+                    ...(info.uptimeMs !== undefined
+                        ? { uptimeMs: info.uptimeMs }
+                        : {})
+                }
+                : {};
+            this.log('info', 'Peer disconnected', { pubkey, ...cause });
+            this.emit('peer:disconnect', { pubkey, ...cause });
         });
         // The transport error that caused a disconnect (pong timeout, decrypt
         // failure, socket reset, ...) is the only place the reason is known —
@@ -6844,6 +6873,11 @@ class BeignetNode extends typed_emitter_1.TypedEmitter {
         if (!channel)
             return null;
         const state = channel.getFullState();
+        // Nothing clears preReestablishState when a marked channel closes, so
+        // it names the earlier state only while the channel is still wrapped.
+        const wrappedState = state.state === types_7.ChannelState.AWAITING_REESTABLISH
+            ? state.preReestablishState
+            : null;
         // Mid-negotiation v2 channels are keyed by temporary id in the peer map
         // (see buildChannelInfo); fall back so diagnostics name the peer too.
         const peerPubkey = this.node.getChannelManager().getPeerForChannel(channelIdBuf) ||
@@ -6876,9 +6910,9 @@ class BeignetNode extends typed_emitter_1.TypedEmitter {
         if (state.fundingUnaccounted === true)
             issues.push('FUNDING_UNACCOUNTED: Neither mempool nor chain can account for the funding transaction, so the channel takes no new HTLCs. Routing hints will be skipped. Existing HTLCs still settle, and the quarantine lifts by itself if the funding reappears.');
         if (state.state !== 'NORMAL' &&
-            state.preReestablishState !== 'NORMAL' &&
+            wrappedState !== 'NORMAL' &&
             !acceptsNewThrough) {
-            issues.push(`NOT_NORMAL: Channel state is ${state.state} (pre-reestablish: ${state.preReestablishState || 'none'}). Routing hints require a usable channel.`);
+            issues.push(`NOT_NORMAL: Channel state is ${state.state} (pre-reestablish: ${wrappedState || 'none'}). Routing hints require a usable channel.`);
         }
         if (!state.announceChannel)
             issues.push('PRIVATE_CHANNEL: Channel is private (not announced). Routing hints are required for payments.');
@@ -6892,7 +6926,7 @@ class BeignetNode extends typed_emitter_1.TypedEmitter {
             channelId,
             peerPubkey,
             state: state.state,
-            preReestablishState: state.preReestablishState || null,
+            preReestablishState: wrappedState || null,
             isPeerConnected,
             announceChannel: state.announceChannel,
             announcementSigsSent: state.announcementSigsSent || false,
@@ -6960,6 +6994,8 @@ class BeignetNode extends typed_emitter_1.TypedEmitter {
             capacitySats: Number(ch.fundingSatoshis),
             isAnchor: (0, types_7.isAnchorChannel)(ch.channelType ?? null)
         };
+        if (ch.preReestablishState)
+            info.preReestablishState = ch.preReestablishState;
         // What the connected peer's init negotiated, read rather than guessed:
         // a client deciding whether to offer splice controls has no other way
         // to know, and reconstructing feature bits client-side is exactly the
@@ -7578,6 +7614,16 @@ class BeignetNode extends typed_emitter_1.TypedEmitter {
     listDirectFundingPayments() {
         return this.directFundingSender?.payments() ?? [];
     }
+    /**
+     * Every payment received against a request this node minted, newest first
+     * (issue #1893). `receiptHash` is the `paymentHash` the request was minted
+     * with. Kept after the request itself expires, so a client can still tell
+     * its request was paid: a direct-funding payment settles no invoice and pays
+     * no address, and REVERTED means the splice it went into was undone.
+     */
+    listDirectFundingReceived() {
+        return this.node.getDirectFundingRequests()?.received() ?? [];
+    }
     /**
      * Map a coded protocol refusal onto the daemon's error vocabulary. The codes
      * are carried through verbatim: they are what tells the app a refusal to