@lendasat/lendaswap-sdk-native 0.0.67

package/README.md

@@ -0,0 +1,116 @@
+# @lendasat/lendaswap-sdk-native
+
+Native Node.js bindings for Lendaswap with SQLite storage.
+
+## Overview
+
+This package provides native Node.js bindings via [napi-rs](https://napi.rs/) for the Lendaswap client with SQLite storage. It's designed for server-side applications, CLI tools, and backend services.
+
+**Recommended:** Use this package through `@lendasat/lendaswap-sdk` with `.withSqliteStorage()` for a unified API across browser and Node.js.
+
+## Installation
+
+```bash
+# Install both packages
+pnpm add @lendasat/lendaswap-sdk @lendasat/lendaswap-sdk-native
+```
+
+### Platform Support
+
+Pre-built binaries are available for:
+
+- macOS (x64, ARM64)
+- Linux (x64, ARM64)
+- Windows (x64)
+
+## Usage (Recommended)
+
+Use the main SDK with SQLite storage:
+
+```javascript
+import { Client } from "@lendasat/lendaswap-sdk";
+
+const client = await Client.builder()
+    .url("https://apilendaswap.lendasat.com")
+    .network("bitcoin")
+    .arkadeUrl("https://arkade.computer")
+    .esploraUrl("https://mempool.space/api")
+    .withSqliteStorage("./lendaswap.db")
+    .build();
+
+await client.init();
+
+// Get available trading pairs
+const pairs = await client.getAssetPairs();
+
+// Get a quote
+const quote = await client.getQuote("btc_lightning", "usdc_pol", 100000n);
+
+// Create a swap
+const swap = await client.createLightningToEvmSwap({
+    target_address: "0xYourPolygonAddress",
+    source_amount: 100000,
+    target_token: "usdc_pol",
+}, "polygon");
+```
+
+## Direct Usage (Advanced)
+
+For advanced use cases, you can use the native SDK directly:
+
+```javascript
+import {
+    SqliteStorageHandle,
+    ClientBuilder,
+} from "@lendasat/lendaswap-sdk-native";
+
+const storage = SqliteStorageHandle.open("./lendaswap.db");
+const client = new ClientBuilder()
+    .storage(storage)
+    .url("https://apilendaswap.lendasat.com")
+    .network("bitcoin")
+    .arkadeUrl("https://arkade.computer")
+    .esploraUrl("https://mempool.space/api")
+    .build();
+
+await client.init();
+```
+
+## CLI Example
+
+A full CLI example is available in `examples/nodejs/`:
+
+```bash
+cd client-sdk/examples/nodejs
+pnpm install
+node index.js help
+```
+
+Commands:
+
+- `pairs` - List available trading pairs
+- `tokens` - List available tokens
+- `quote <from> <to> <amount>` - Get a quote
+- `swap <from> <to> <amount> <address>` - Create and monitor a swap
+- `swaps` - List stored swaps with transaction links
+- `info` - Show wallet and API info
+
+## Supported Tokens
+
+| Token | Chain     | ID              |
+| ----- | --------- | --------------- |
+| BTC   | Lightning | `btc_lightning` |
+| BTC   | Arkade    | `btc_arkade`    |
+| BTC   | On-chain  | `btc_onchain`   |
+| USDC  | Polygon   | `usdc_pol`      |
+| USDT  | Polygon   | `usdt0_pol`     |
+| USDC  | Ethereum  | `usdc_eth`      |
+| USDT  | Ethereum  | `usdt_eth`      |
+
+## Related Packages
+
+- `@lendasat/lendaswap-sdk` - Main SDK with unified API for browser (IndexedDB) and Node.js (SQLite)
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,218 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** Swap status enum with all possible states. */
+export const enum SwapStatus {
+  /** Initial state - waiting for client to fund */
+  Pending = 'Pending',
+  /** Client's funding transaction seen but not confirmed */
+  ClientFundingSeen = 'ClientFundingSeen',
+  /** Client has funded BTC */
+  ClientFunded = 'ClientFunded',
+  /** Client refunded before server created HTLC */
+  ClientRefunded = 'ClientRefunded',
+  /** Server has locked funds in HTLC */
+  ServerFunded = 'ServerFunded',
+  /** Client is claiming by revealing the secret */
+  ClientRedeeming = 'ClientRedeeming',
+  /** Client has claimed by revealing the secret */
+  ClientRedeemed = 'ClientRedeemed',
+  /** Server has redeemed using the revealed secret (swap complete) */
+  ServerRedeemed = 'ServerRedeemed',
+  /** Client funded, server funded, but HTLC timed out */
+  ClientFundedServerRefunded = 'ClientFundedServerRefunded',
+  /** Error state: client refunded while server still has funds locked */
+  ClientRefundedServerFunded = 'ClientRefundedServerFunded',
+  /** Both parties refunded after error state */
+  ClientRefundedServerRefunded = 'ClientRefundedServerRefunded',
+  /** Swap expired before client funded */
+  Expired = 'Expired',
+  /** Client funded with wrong parameters */
+  ClientInvalidFunded = 'ClientInvalidFunded',
+  /** Client funded too late (after timeout) */
+  ClientFundedTooLate = 'ClientFundedTooLate',
+  /** Critical error: client redeemed and refunded (took all money) */
+  ClientRedeemedAndClientRefunded = 'ClientRedeemedAndClientRefunded'
+}
+/** Quote response from the API. */
+export interface QuoteResponse {
+  exchangeRate: string
+  networkFee: number
+  protocolFee: number
+  protocolFeeRate: number
+  minAmount: number
+  maxAmount: number
+}
+/** Token information. */
+export interface TokenInfo {
+  tokenId: string
+  symbol: string
+  chain: string
+  name: string
+  decimals: number
+}
+/** Asset pair information. */
+export interface AssetPair {
+  source: TokenInfo
+  target: TokenInfo
+}
+/** BTC to EVM swap response. */
+export interface BtcToEvmSwapResponse {
+  id: string
+  status: SwapStatus
+  hashLock: string
+  feeSats: number
+  assetAmount: number
+  htlcAddressEvm: string
+  htlcAddressArkade: string
+  userAddressEvm: string
+  lnInvoice: string
+  satsReceive: number
+  sourceToken: string
+  targetToken: string
+  network: string
+  createdAt: string
+  /** Bitcoin HTLC claim transaction ID */
+  bitcoinHtlcClaimTxid?: string
+  /** Bitcoin HTLC fund transaction ID */
+  bitcoinHtlcFundTxid?: string
+  /** EVM HTLC claim transaction ID */
+  evmHtlcClaimTxid?: string
+  /** EVM HTLC fund transaction ID */
+  evmHtlcFundTxid?: string
+}
+/** EVM to BTC swap response. */
+export interface EvmToBtcSwapResponse {
+  id: string
+  status: SwapStatus
+  hashLock: string
+  feeSats: number
+  assetAmount: number
+  htlcAddressEvm: string
+  htlcAddressArkade: string
+  userAddressEvm: string
+  lnInvoice: string
+  satsReceive: number
+  sourceToken: string
+  targetToken: string
+  network: string
+  createdAt: string
+  sourceTokenAddress: string
+  bitcoinHtlcFundTxid?: string
+  /** Bitcoin HTLC claim transaction ID */
+  bitcoinHtlcClaimTxid?: string
+  /** EVM HTLC claim transaction ID */
+  evmHtlcClaimTxid?: string
+  /** EVM HTLC fund transaction ID */
+  evmHtlcFundTxid?: string
+}
+/** BTC to Arkade swap response. */
+export interface BtcToArkadeSwapResponse {
+  id: string
+  status: SwapStatus
+  btcHtlcAddress: string
+  assetAmount: number
+  satsReceive: number
+  feeSats: number
+  hashLock: string
+  arkadeVhtlcAddress: string
+  targetArkadeAddress: string
+  network: string
+  createdAt: string
+  sourceToken: string
+  targetToken: string
+  btcFundTxid?: string
+  /** On-chain BTC claim transaction ID. */
+  btcClaimTxid?: string
+  /** Arkade VHTLC funding transaction ID. */
+  arkadeFundTxid?: string
+  /** Arkade VHTLC claim transaction ID. */
+  arkadeClaimTxid?: string
+}
+/** Version information. */
+export interface Version {
+  tag: string
+  commitHash: string
+}
+/** Extended swap storage data. */
+export interface ExtendedSwapStorageData {
+  swapType: string
+  btcToEvmResponse?: BtcToEvmSwapResponse
+  evmToBtcResponse?: EvmToBtcSwapResponse
+  btcToArkadeResponse?: BtcToArkadeSwapResponse
+}
+/** SQLite storage handle for Node.js. */
+export declare class SqliteStorageHandle {
+  /** Open or create a SQLite database at the given path. */
+  static open(path: string): SqliteStorageHandle
+  /** Create an in-memory SQLite database (useful for testing). */
+  static inMemory(): SqliteStorageHandle
+}
+/** Lendaswap client for Node.js with SQLite storage. */
+export declare class Client {
+  /** Create a new client with SQLite storage. */
+  constructor(storage: SqliteStorageHandle, url: string, network: string, arkadeUrl: string, esploraUrl: string)
+  /** Initialize the client (generates or loads mnemonic). */
+  init(mnemonic?: string | undefined | null): Promise<void>
+  /** Get the current mnemonic. */
+  getMnemonic(): Promise<string>
+  /** Get the user ID xpub. */
+  getUserIdXpub(): Promise<string>
+  /** Get the API version. */
+  getVersion(): Promise<Version>
+  /** Get asset pairs. */
+  getAssetPairs(): Promise<Array<AssetPair>>
+  /** Get tokens. */
+  getTokens(): Promise<Array<TokenInfo>>
+  /** Get a quote. */
+  getQuote(from: string, to: string, baseAmount: number): Promise<QuoteResponse>
+  /** Create an Arkade to EVM swap. */
+  createArkadeToEvmSwap(targetAddress: string, sourceAmount: number | undefined | null, targetAmount: number | undefined | null, targetToken: string, targetChain: string, referralCode?: string | undefined | null): Promise<BtcToEvmSwapResponse>
+  /** Create a Lightning to EVM swap. */
+  createLightningToEvmSwap(targetAddress: string, sourceAmount: number | undefined | null, targetAmount: number | undefined | null, targetToken: string, targetChain: string, referralCode?: string | undefined | null): Promise<BtcToEvmSwapResponse>
+  /** Create an EVM to Arkade swap. */
+  createEvmToArkadeSwap(targetAddress: string, userAddress: string, sourceAmount: number, sourceToken: string, sourceChain: string, referralCode?: string | undefined | null): Promise<EvmToBtcSwapResponse>
+  /** Create an EVM to Lightning swap. */
+  createEvmToLightningSwap(bolt11Invoice: string, userAddress: string, sourceToken: string, sourceChain: string, referralCode?: string | undefined | null): Promise<EvmToBtcSwapResponse>
+  /** Create an on-chain Bitcoin to Arkade swap. */
+  createBitcoinToArkadeSwap(targetArkadeAddress: string, satsReceive: number, referralCode?: string | undefined | null): Promise<BtcToArkadeSwapResponse>
+  /** Get swap by ID. */
+  getSwap(id: string): Promise<ExtendedSwapStorageData>
+  /** List all swaps. */
+  listAll(): Promise<Array<ExtendedSwapStorageData>>
+  /** Claim via Gelato relay. */
+  claimGelato(swapId: string, secret?: string | undefined | null): Promise<void>
+  /** Claim VHTLC. */
+  claimVhtlc(swapId: string): Promise<string>
+  /** Refund VHTLC. */
+  refundVhtlc(swapId: string, refundAddress: string): Promise<string>
+  /** Claim BTC to Arkade VHTLC. */
+  claimBtcToArkadeVhtlc(swapId: string): Promise<string>
+  /** Refund on-chain HTLC. */
+  refundOnchainHtlc(swapId: string, refundAddress: string): Promise<string>
+  /** Recover swaps. */
+  recoverSwaps(): Promise<Array<ExtendedSwapStorageData>>
+  /** Clear swap storage. */
+  clearSwapStorage(): Promise<void>
+  /** Delete a specific swap. */
+  deleteSwap(id: string): Promise<void>
+}
+/** Client builder for Node.js. */
+export declare class ClientBuilder {
+  /** Create a new client builder. */
+  constructor()
+  /** Set the SQLite storage. */
+  storage(storage: SqliteStorageHandle): this
+  /** Set the API URL. */
+  url(url: string): this
+  /** Set the Bitcoin network. */
+  network(network: string): this
+  /** Set the Arkade URL. */
+  arkadeUrl(url: string): this
+  /** Set the Esplora URL. */
+  esploraUrl(url: string): this
+  /** Build the client. */
+  build(): Client
+}

package/index.js

@@ -0,0 +1,318 @@
+/* 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, 'lendaswap-sdk-native.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./lendaswap-sdk-native.android-arm64.node')
+          } else {
+            nativeBinding = require('@lendasat/lendaswap-sdk-native-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'lendaswap-sdk-native.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./lendaswap-sdk-native.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@lendasat/lendaswap-sdk-native-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, 'lendaswap-sdk-native.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./lendaswap-sdk-native.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@lendasat/lendaswap-sdk-native-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'lendaswap-sdk-native.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./lendaswap-sdk-native.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@lendasat/lendaswap-sdk-native-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'lendaswap-sdk-native.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./lendaswap-sdk-native.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@lendasat/lendaswap-sdk-native-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'lendaswap-sdk-native.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./lendaswap-sdk-native.darwin-universal.node')
+      } else {
+        nativeBinding = require('@lendasat/lendaswap-sdk-native-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'lendaswap-sdk-native.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./lendaswap-sdk-native.darwin-x64.node')
+          } else {
+            nativeBinding = require('@lendasat/lendaswap-sdk-native-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'lendaswap-sdk-native.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./lendaswap-sdk-native.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@lendasat/lendaswap-sdk-native-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, 'lendaswap-sdk-native.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./lendaswap-sdk-native.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@lendasat/lendaswap-sdk-native-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'lendaswap-sdk-native.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./lendaswap-sdk-native.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@lendasat/lendaswap-sdk-native-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'lendaswap-sdk-native.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./lendaswap-sdk-native.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@lendasat/lendaswap-sdk-native-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'lendaswap-sdk-native.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./lendaswap-sdk-native.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@lendasat/lendaswap-sdk-native-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'lendaswap-sdk-native.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./lendaswap-sdk-native.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@lendasat/lendaswap-sdk-native-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'lendaswap-sdk-native.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./lendaswap-sdk-native.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@lendasat/lendaswap-sdk-native-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'lendaswap-sdk-native.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./lendaswap-sdk-native.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@lendasat/lendaswap-sdk-native-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'lendaswap-sdk-native.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./lendaswap-sdk-native.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@lendasat/lendaswap-sdk-native-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'lendaswap-sdk-native.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./lendaswap-sdk-native.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@lendasat/lendaswap-sdk-native-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'lendaswap-sdk-native.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./lendaswap-sdk-native.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@lendasat/lendaswap-sdk-native-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 { SqliteStorageHandle, SwapStatus, Client, ClientBuilder } = nativeBinding
+
+module.exports.SqliteStorageHandle = SqliteStorageHandle
+module.exports.SwapStatus = SwapStatus
+module.exports.Client = Client
+module.exports.ClientBuilder = ClientBuilder

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@lendasat/lendaswap-sdk-native",
+  "version": "0.0.67",
+  "description": "Lendaswap Client SDK - Native Node.js bindings with SQLite storage",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "license": "MIT",
+  "engines": {
+    "node": ">= 18"
+  },
+  "napi": {
+    "name": "lendaswap-sdk-native",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "aarch64-apple-darwin",
+        "x86_64-apple-darwin",
+        "x86_64-unknown-linux-gnu",
+        "aarch64-unknown-linux-gnu",
+        "x86_64-pc-windows-msvc"
+      ]
+    }
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.0"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "universal": "napi universal",
+    "version": "napi version"
+  }
+}