@pipeit/fastlane 0.1.0

package/browser.js

@@ -0,0 +1,22 @@
+/**
+ * Browser stub for @pipeit/fastlane.
+ *
+ * This module provides empty exports for browser environments
+ * where the native QUIC client cannot run.
+ *
+ * In the browser, TPU submission routes through the /api/tpu endpoint
+ * which uses the real native client on the server.
+ */
+
+// Stub TpuClient that throws helpful error if accidentally used in browser
+export class TpuClient {
+    constructor() {
+        throw new Error(
+            '@pipeit/fastlane cannot be used in the browser. ' +
+                'TPU submission should route through the API endpoint. ' +
+                'Configure tpu.apiRoute in your execution config.',
+        );
+    }
+}
+
+export default { TpuClient };

package/index.d.ts

@@ -0,0 +1,40 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** Configuration for the TPU client. */
+export interface TpuClientConfig {
+  /** RPC URL for fetching leader schedule and cluster info. */
+  rpcUrl: string
+  /** WebSocket URL for slot update subscriptions. */
+  wsUrl: string
+  /** Number of upcoming leaders to send transactions to (default: 2). */
+  fanout?: number
+  /** Whether to pre-warm connections to upcoming leaders (default: true). */
+  prewarmConnections?: boolean
+}
+/** Result from sending a transaction. */
+export interface SendResult {
+  /** Whether the transaction was successfully delivered. */
+  delivered: boolean
+  /** Latency in milliseconds. */
+  latencyMs: number
+  /** Number of leaders the transaction was sent to. */
+  leaderCount: number
+}
+/** Native QUIC client for direct Solana TPU transaction submission. */
+export declare class TpuClient {
+  /** Creates a new TPU client instance. */
+  constructor(config: TpuClientConfig)
+  /** Sends a serialized transaction to TPU endpoints. */
+  sendTransaction(transaction: Buffer): Promise<SendResult>
+  /** Gets the current estimated slot number. */
+  getCurrentSlot(): number
+  /** Gets the number of active QUIC connections. */
+  getConnectionCount(): Promise<number>
+  /** Waits for the client to be fully initialized. */
+  waitReady(): Promise<void>
+  /** Shuts down the client and closes all connections. */
+  shutdown(): void
+}

package/index.js

@@ -0,0 +1,315 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'fastlane.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fastlane.android-arm64.node')
+          } else {
+            nativeBinding = require('@pipeit/fastlane-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'fastlane.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fastlane.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@pipeit/fastlane-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fastlane.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fastlane.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@pipeit/fastlane-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'fastlane.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fastlane.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@pipeit/fastlane-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fastlane.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fastlane.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@pipeit/fastlane-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'fastlane.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./fastlane.darwin-universal.node')
+      } else {
+        nativeBinding = require('@pipeit/fastlane-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'fastlane.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fastlane.darwin-x64.node')
+          } else {
+            nativeBinding = require('@pipeit/fastlane-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'fastlane.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fastlane.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@pipeit/fastlane-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'fastlane.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./fastlane.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@pipeit/fastlane-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fastlane.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fastlane.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@pipeit/fastlane-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fastlane.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fastlane.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@pipeit/fastlane-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fastlane.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fastlane.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@pipeit/fastlane-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fastlane.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fastlane.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@pipeit/fastlane-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fastlane.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fastlane.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@pipeit/fastlane-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fastlane.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fastlane.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@pipeit/fastlane-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'fastlane.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fastlane.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@pipeit/fastlane-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'fastlane.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./fastlane.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@pipeit/fastlane-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'fastlane.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./fastlane.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@pipeit/fastlane-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { TpuClient } = nativeBinding
+
+module.exports.TpuClient = TpuClient

package/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@pipeit/fastlane",
+    "version": "0.1.0",
+    "description": "Native QUIC client for direct Solana TPU transaction submission",
+    "main": "index.js",
+    "types": "index.d.ts",
+    "exports": {
+        ".": {
+            "browser": "./browser.js",
+            "default": "./index.js"
+        },
+        "./browser": "./browser.js"
+    },
+    "browser": "./browser.js",
+    "napi": {
+        "name": "fastlane",
+        "triples": {
+            "defaults": false,
+            "additional": [
+                "aarch64-apple-darwin",
+                "x86_64-unknown-linux-gnu",
+                "x86_64-pc-windows-msvc"
+            ]
+        }
+    },
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/stevesarmiento/pipeit.git",
+        "directory": "packages/fastlane"
+    },
+    "files": [
+        "index.js",
+        "index.d.ts",
+        "browser.js",
+        "*.node"
+    ],
+    "scripts": {
+        "artifacts": "napi artifacts",
+        "build": "which cargo > /dev/null 2>&1 && napi build --platform --release || echo 'Skipping native build (cargo not found)'",
+        "build:debug": "napi build --platform",
+        "build:native": "napi build --platform --release",
+        "test": "node --test test.mjs",
+        "universal": "napi universal",
+        "version": "napi version"
+    },
+    "devDependencies": {
+        "@napi-rs/cli": "^2.18.0"
+    },
+    "engines": {
+        "node": ">= 18"
+    }
+}