feat: add request timeout configuration and update default timeout value in NodeArweaveWallet

Author: pawanpaudel93

README.md

@@ -66,7 +66,9 @@ Creates a new wallet instance.
 
 ```typescript
 const wallet = new NodeArweaveWallet({
-  port: 3737, // Optional: port number (default: 3737, use 0 for random)
+  port: 3737,              // Optional: port number (default: 3737, use 0 for random)
+  freePort: false,         // Optional: auto-free port if in use (default: false)
+  requestTimeout: 300000,  // Optional: request timeout in ms (default: 5 minutes)
 })
 ```
 
@@ -412,6 +414,34 @@ If your desired port is already in use, you can enable automatic port freeing to
 const wallet = new NodeArweaveWallet({ freePort: true })
 ```
 
+### Request Timeout Configuration
+
+You can configure how long the wallet will wait for user responses before timing out. This is useful if you need more time to review transactions or if you want faster failures:
+
+```typescript
+// Default timeout (5 minutes = 300000ms)
+const wallet = new NodeArweaveWallet()
+
+// Custom timeout (10 minutes)
+const wallet = new NodeArweaveWallet({ 
+  requestTimeout: 600000 // 10 minutes in milliseconds
+})
+
+// Shorter timeout (1 minute) for faster failures
+const wallet = new NodeArweaveWallet({ 
+  requestTimeout: 60000 // 1 minute in milliseconds
+})
+
+// All options together
+const wallet = new NodeArweaveWallet({
+  port: 3737,
+  freePort: true,
+  requestTimeout: 300000, // 5 minutes
+})
+```
+
+**Note:** The timeout applies to individual wallet operations (signing, encrypting, etc.). If the user doesn't respond within this time, the operation will fail with a timeout error.
+
 ## 💡 Usage Examples
 
 ### CLI Tool Example
@@ -604,9 +634,17 @@ The URL will be printed to the console. Open it manually:
 http://localhost:3737
 ```
 
-### Connection Timeout
+### Request Timeout
+
+Keep the browser tab open while signing transactions. The package has a default 5-minute timeout for each wallet operation (configurable via `requestTimeout` option). If you need more time to review transactions, increase the timeout:
+
+```typescript
+const wallet = new NodeArweaveWallet({ 
+  requestTimeout: 600000 // 10 minutes
+})
+```
 
-Keep the browser tab open while signing transactions. The package has a generous 5-minute timeout, but closing the tab will interrupt operations.
+**Note:** Closing the browser tab will immediately interrupt operations regardless of the timeout setting.
 
 ## 📄 License
 

src/constants.ts

@@ -2,7 +2,7 @@ import Arweave from 'arweave'
 
 export const DEFAULT_PORT = 3737
 export const DEFAULT_HOST = '127.0.0.1'
-export const REQUEST_TIMEOUT = 120000 // 120 seconds
+export const DEFAULT_REQUEST_TIMEOUT = 300000 // 5 minutes
 export const BROWSER_TIMEOUT = 30000 // 30 seconds
 export const SHUTDOWN_DELAY = 500 // 500ms
 export const BROWSER_READY_DELAY = 500 // 500ms

src/index.ts

@@ -34,7 +34,7 @@ import {
   BROWSER_TIMEOUT,
   DEFAULT_HOST,
   DEFAULT_PORT,
-  REQUEST_TIMEOUT,
+  DEFAULT_REQUEST_TIMEOUT,
   SHUTDOWN_DELAY,
 } from './constants'
 import { base64ToBuffer, bufferToBase64 } from './utils'
@@ -64,6 +64,7 @@ export class NodeArweaveWallet {
     this.config = {
       port: config.port ?? DEFAULT_PORT,
       freePort: config.freePort ?? false,
+      requestTimeout: config.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT,
     }
   }
 
@@ -932,8 +933,8 @@ export class NodeArweaveWallet {
     return new Promise((resolve, reject) => {
       const timeout = setTimeout(() => {
         this.pendingRequests.delete(id)
-        reject(new Error(`Timeout waiting for ${type}`))
-      }, REQUEST_TIMEOUT)
+        reject(new Error(`Timeout waiting for ${type} after ${this.config.requestTimeout! / 1000} seconds`))
+      }, this.config.requestTimeout!)
 
       this.pendingRequests.set(id, {
         resolve: (value: T) => {

src/types.ts

@@ -130,6 +130,10 @@ export interface ActiveTier {
 }
 
 export interface NodeArweaveWalletConfig {
-  port?: number // Port to listen on (default: 3737, use 0 for random)
-  freePort?: boolean // Automatically free port if it's already in use (default: false)
+  /** Port to listen on (default: 3737, use 0 for random) */
+  port?: number
+  /** Automatically free port if it's already in use (default: false) */
+  freePort?: boolean
+  /** Timeout for wallet requests in milliseconds (default: 300000 = 5 minutes) */
+  requestTimeout?: number
 }