@open-wallet-standard/core 0.3.0

package/bin/ows

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("child_process");
+const { existsSync } = require("fs");
+const { join } = require("path");
+const { platform, arch } = process;
+
+const PLATFORM_MAP = {
+  "darwin-arm64": {
+    pkg: "@open-wallet-standard/core-darwin-arm64",
+    bin: "ows",
+  },
+  "darwin-x64": {
+    pkg: "@open-wallet-standard/core-darwin-x64",
+    bin: "ows",
+  },
+  "linux-x64": {
+    pkg: "@open-wallet-standard/core-linux-x64-gnu",
+    bin: "ows",
+  },
+  "linux-arm64": {
+    pkg: "@open-wallet-standard/core-linux-arm64-gnu",
+    bin: "ows",
+  },
+};
+
+const key = `${platform}-${arch}`;
+const entry = PLATFORM_MAP[key];
+
+if (!entry) {
+  console.error(
+    `ows: unsupported platform ${platform}-${arch}. ` +
+      `Install the CLI manually: https://openwallet.sh`
+  );
+  process.exit(1);
+}
+
+// Try to find the binary in the platform-specific optional dependency
+let binPath;
+
+// 1. Check inside node_modules (normal npm install)
+try {
+  const pkgDir = require.resolve(`${entry.pkg}/package.json`);
+  binPath = join(pkgDir, "..", entry.bin);
+} catch {}
+
+// 2. Check local npm/ directory (development / monorepo)
+if (!binPath || !existsSync(binPath)) {
+  const localDir = join(
+    __dirname,
+    "..",
+    "npm",
+    entry.pkg.split("/").pop(),
+    entry.bin
+  );
+  if (existsSync(localDir)) {
+    binPath = localDir;
+  }
+}
+
+if (!binPath || !existsSync(binPath)) {
+  console.error(
+    `ows: CLI binary not found for ${platform}-${arch}.\n` +
+      `The platform package ${entry.pkg} may not be installed.\n` +
+      `Install the CLI manually: https://openwallet.sh`
+  );
+  process.exit(1);
+}
+
+try {
+  execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (e) {
+  if (e.status !== undefined) {
+    process.exit(e.status);
+  }
+  throw e;
+}

package/index.d.ts

@@ -0,0 +1,62 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+/** A single account within a wallet (one per chain family). */
+export interface AccountInfo {
+  chainId: string
+  address: string
+  derivationPath: string
+}
+/** Wallet information returned by create/import/list/get operations. */
+export interface WalletInfo {
+  id: string
+  name: string
+  accounts: Array<AccountInfo>
+  createdAt: string
+}
+/** Result from a signing operation. */
+export interface SignResult {
+  signature: string
+  recoveryId?: number
+}
+/** Result from a sign-and-send operation. */
+export interface SendResult {
+  txHash: string
+}
+/** Generate a new BIP-39 mnemonic phrase. */
+export declare function generateMnemonic(words?: number | undefined | null): string
+/** Derive an address from a mnemonic for the given chain. */
+export declare function deriveAddress(mnemonic: string, chain: string, index?: number | undefined | null): string
+/** Create a new universal wallet (derives addresses for all chains). */
+export declare function createWallet(name: string, passphrase?: string | undefined | null, words?: number | undefined | null, vaultPathOpt?: string | undefined | null): WalletInfo
+/** Import a wallet from a mnemonic phrase (derives addresses for all chains). */
+export declare function importWalletMnemonic(name: string, mnemonic: string, passphrase?: string | undefined | null, index?: number | undefined | null, vaultPathOpt?: string | undefined | null): WalletInfo
+/**
+ * Import a wallet from a hex-encoded private key.
+ * All 6 chains are supported: the provided key is used for its curve's chains,
+ * and a random key is generated for the other curve.
+ * The optional `chain` parameter specifies the key's source chain (e.g. "evm", "solana")
+ * to determine which curve it uses. Defaults to "evm" (secp256k1).
+ *
+ * Alternatively, provide explicit keys for each curve via `secp256k1Key` and `ed25519Key`.
+ * When both are given, `privateKeyHex` and `chain` are ignored.
+ */
+export declare function importWalletPrivateKey(name: string, privateKeyHex: string, passphrase?: string | undefined | null, vaultPathOpt?: string | undefined | null, chain?: string | undefined | null, secp256K1Key?: string | undefined | null, ed25519Key?: string | undefined | null): WalletInfo
+/** List all wallets in the vault. */
+export declare function listWallets(vaultPathOpt?: string | undefined | null): Array<WalletInfo>
+/** Get a single wallet by name or ID. */
+export declare function getWallet(nameOrId: string, vaultPathOpt?: string | undefined | null): WalletInfo
+/** Delete a wallet from the vault. */
+export declare function deleteWallet(nameOrId: string, vaultPathOpt?: string | undefined | null): void
+/** Export a wallet's secret (mnemonic or private key). */
+export declare function exportWallet(nameOrId: string, passphrase?: string | undefined | null, vaultPathOpt?: string | undefined | null): string
+/** Rename a wallet. */
+export declare function renameWallet(nameOrId: string, newName: string, vaultPathOpt?: string | undefined | null): void
+/** Sign a transaction. Returns hex-encoded signature. */
+export declare function signTransaction(wallet: string, chain: string, txHex: string, passphrase?: string | undefined | null, index?: number | undefined | null, vaultPathOpt?: string | undefined | null): SignResult
+/** Sign a message. Returns hex-encoded signature. */
+export declare function signMessage(wallet: string, chain: string, message: string, passphrase?: string | undefined | null, encoding?: string | undefined | null, index?: number | undefined | null, vaultPathOpt?: string | undefined | null): SignResult
+/** Sign and broadcast a transaction. Returns the transaction hash. */
+export declare function signAndSend(wallet: string, chain: string, txHex: string, passphrase?: string | undefined | null, index?: number | undefined | null, rpcUrl?: string | undefined | null, vaultPathOpt?: string | undefined | null): SendResult

package/index.js

@@ -0,0 +1,327 @@
+/* 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, 'ows-node.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./ows-node.android-arm64.node')
+          } else {
+            nativeBinding = require('@open-wallet-standard/core-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'ows-node.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./ows-node.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@open-wallet-standard/core-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, 'ows-node.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./ows-node.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@open-wallet-standard/core-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'ows-node.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./ows-node.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@open-wallet-standard/core-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'ows-node.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./ows-node.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@open-wallet-standard/core-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'ows-node.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./ows-node.darwin-universal.node')
+      } else {
+        nativeBinding = require('@open-wallet-standard/core-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'ows-node.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./ows-node.darwin-x64.node')
+          } else {
+            nativeBinding = require('@open-wallet-standard/core-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'ows-node.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./ows-node.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@open-wallet-standard/core-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, 'ows-node.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./ows-node.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@open-wallet-standard/core-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'ows-node.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./ows-node.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@open-wallet-standard/core-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'ows-node.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./ows-node.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@open-wallet-standard/core-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'ows-node.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./ows-node.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@open-wallet-standard/core-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'ows-node.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./ows-node.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@open-wallet-standard/core-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'ows-node.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./ows-node.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@open-wallet-standard/core-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'ows-node.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./ows-node.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@open-wallet-standard/core-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'ows-node.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./ows-node.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@open-wallet-standard/core-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'ows-node.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./ows-node.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@open-wallet-standard/core-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'ows-node.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./ows-node.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@open-wallet-standard/core-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 { generateMnemonic, deriveAddress, createWallet, importWalletMnemonic, importWalletPrivateKey, listWallets, getWallet, deleteWallet, exportWallet, renameWallet, signTransaction, signMessage, signAndSend } = nativeBinding
+
+module.exports.generateMnemonic = generateMnemonic
+module.exports.deriveAddress = deriveAddress
+module.exports.createWallet = createWallet
+module.exports.importWalletMnemonic = importWalletMnemonic
+module.exports.importWalletPrivateKey = importWalletPrivateKey
+module.exports.listWallets = listWallets
+module.exports.getWallet = getWallet
+module.exports.deleteWallet = deleteWallet
+module.exports.exportWallet = exportWallet
+module.exports.renameWallet = renameWallet
+module.exports.signTransaction = signTransaction
+module.exports.signMessage = signMessage
+module.exports.signAndSend = signAndSend

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@open-wallet-standard/core",
+  "version": "0.3.0",
+  "description": "Node.js native bindings for the Open Wallet Standard",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "bin": {
+    "ows": "bin/ows"
+  },
+  "napi": {
+    "name": "ows-node",
+    "triples": {
+      "defaults": false,
+      "additional": [
+        "x86_64-apple-darwin",
+        "aarch64-apple-darwin",
+        "x86_64-unknown-linux-gnu",
+        "aarch64-unknown-linux-gnu"
+      ]
+    }
+  },
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release",
+    "build:debug": "napi build --platform",
+    "prepublishOnly": "napi build --platform --release",
+    "publish:all": "node publish.mjs",
+    "test": "node --test __test__/index.spec.mjs"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.0"
+  },
+  "optionalDependencies": {
+    "@open-wallet-standard/core-linux-x64-gnu": "0.3.0",
+    "@open-wallet-standard/core-linux-arm64-gnu": "0.3.0",
+    "@open-wallet-standard/core-darwin-x64": "0.3.0",
+    "@open-wallet-standard/core-darwin-arm64": "0.3.0"
+  },
+  "license": "MIT",
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "bin/ows"
+  ]
+}