quantumcoin 7.0.10 → 7.0.12

package/README-SDK.md

@@ -303,7 +303,6 @@ Wrapper returned by `provider.sendTransaction(...)` and `provider.getTransaction
 - `data: string`
 - `value: bigint`
 - `gasLimit: bigint | null`
-- `gasPrice: bigint | null`
 - `chainId: number | null`
 - `blockNumber: number | null`
 - `txType: number | null` — Transaction type (e.g. `1` for a standard transfer)
@@ -371,11 +370,12 @@ Core signing implementation.
 **Properties**
 - `address: string`
 - `privateKey: string` (getter; hex string)
+- `publicKey: string` (getter; hex string)
+- `seed: string | null` (getter; pre-expansion seed as hex, or `null` if the wallet has no seed source)
 - `provider: AbstractProvider | null`
 
 **Methods**
 - `getAddress(): Promise<string>`
-- `signMessageSync(message: string | Uint8Array): string`
 - `signTransaction(tx: TransactionRequest): Promise<string>`
 - `sendTransaction(tx: TransactionRequest): Promise<TransactionResponse>`
 
@@ -387,7 +387,6 @@ User-facing wallet class.
 
 **Static methods**
 - `Wallet.createRandom(provider?: AbstractProvider, keyType?: number | null): Wallet` — `keyType`: `null`/`3` (default, hybrid compact) or `5` (hybrid5)
-- `Wallet.createRandomSeed(keyType?: number | null): string[]` — returns seed words (32 for keyType 3, 36 for keyType 5); pass to `fromPhrase` to open
 - `Wallet.fromSeed(seed: number[], provider?: AbstractProvider): Wallet` — opens wallet from raw seed bytes (64/72/96 length)
 - `Wallet.fromEncryptedJsonSync(json: string, password: string, provider?: AbstractProvider): Wallet`
 - `Wallet.fromPhrase(phrase: string | string[], provider?: AbstractProvider): Wallet`
@@ -400,8 +399,22 @@ User-facing wallet class.
 - `getTransactionCount(blockTag?: string): Promise<number>`
 - `encryptSync(password: string | Uint8Array): string`
 - `connect(provider: AbstractProvider): Wallet`
+- `getPhrase(): string[] | null` — returns the seed phrase (list of words) when the wallet has a seed, else `null`. Works for `createRandom`, `fromPhrase`, `fromSeed`, and `fromEncryptedJsonSync` on a version-5 keystore. Returns `null` for `fromKeys` and for v3/v4 keystores.
 - `getSigningContext(fullSign?: boolean | null): number` — returns the recommended signing context for this wallet (based on public key type). Setting `fullSign` to `true` may incur additional gas cost.
 
+**Seed & phrase applicability**
+
+| Factory | `seed` | `getPhrase()` |
+| --- | --- | --- |
+| `new Wallet(privateKey)` | `null` | `null` |
+| `Wallet.createRandom(provider?, keyType?)` | non-null | 32 or 36 words |
+| `Wallet.fromPhrase(phrase)` | non-null | 32 / 36 / 48 words |
+| `Wallet.fromSeed(seed)` | non-null | 32 / 36 / 48 words |
+| `Wallet.fromKeys(priv, pub)` | `null` | `null` |
+| `Wallet.fromEncryptedJsonSync(json, pw)` — v5 keystore (from `encryptSync` on seed-bearing wallet, or `encryptSeedSync`) | non-null | original words |
+| `Wallet.fromEncryptedJsonSync(json, pw)` — v3 / v4 keystore | `null` | `null` |
+| `wallet.connect(provider)` | same as source | same as source |
+
 **Example(s):**
 - `examples/wallet-offline.js`
 
@@ -561,8 +574,6 @@ From `quantumcoin`:
 - `getCreateAddress({ from, nonce }): string`
 - `getCreate2Address(from: string, salt: string, initCodeHash: string): string`
 - `computeAddress(publicKey: string|Uint8Array): string`
-- `verifyMessage(message: string|Uint8Array, signature: string): string`
-- `recoverAddress(message: string|Uint8Array, signature: string): string`
 
 **Example(s):**
 - `examples/wallet-offline.js`

package/README.md

@@ -44,20 +44,31 @@ console.log(await provider.getBlockNumber());
 ## Wallet (offline + online)
 
 ```js
-const { Wallet, verifyMessage } = require("quantumcoin");
+const { Wallet } = require("quantumcoin");
 const { Initialize } = require("quantumcoin/config");
 
 await Initialize(null);
 
 const wallet = Wallet.createRandom();
-const sig = wallet.signMessageSync("Hello, QuantumCoin!");
-console.log(verifyMessage("Hello, QuantumCoin!", sig));
 
 const encrypted = wallet.encryptSync("mySecurePassword123");
 const restored = Wallet.fromEncryptedJsonSync(encrypted, "mySecurePassword123");
 console.log(restored.address);
 ```
 
+### Seed phrase (`getPhrase()`)
+
+Any wallet that was constructed from a seed exposes its seed words via `getPhrase()`:
+
+```js
+const wallet = Wallet.createRandom();
+const phrase = wallet.getPhrase();      // string[] of seed words, or null
+const restored = Wallet.fromPhrase(phrase);
+console.log(restored.address === wallet.address); // true
+```
+
+`getPhrase()` returns the seed words whenever `wallet.seed` is non-null — i.e. wallets produced by `createRandom`, `fromPhrase`, `fromSeed`, or `fromEncryptedJsonSync` on a version-5 keystore (produced by `encryptSync` on a seed-bearing wallet or by `encryptSeedSync`). It returns `null` for wallets constructed via `fromKeys` or from v3/v4 keystores.
+
 ### Encrypt a raw seed
 
 You can encrypt raw seed bytes (pre-expansion) into a portable wallet JSON (version 5 format) without first opening the wallet:

package/config.js

@@ -106,10 +106,18 @@ function getConfig() {
     return _config;
 }
 
-// Export Config class and Initialize function
+/**
+ * Returns the pending initialization promise, or null if Initialize() has not been called.
+ * @return {Promise<boolean>|null}
+ */
+function getInitializationPromise() {
+    return _initializationPromise;
+}
+
 module.exports = {
     Config,
     Initialize,
     isInitialized,
-    getConfig
+    getConfig,
+    getInitializationPromise
 };

package/examples/example.js

@@ -47,11 +47,6 @@ async function main() {
   const wallet = qc.Wallet.createRandom();
   console.log("Random wallet address:", wallet.address);
   logAddress("random_wallet", wallet.address);
-  const sig = wallet.signMessageSync("Hello, QuantumCoin!");
-  console.log("Signed message signature:", sig.slice(0, 18) + "...");
-  const recovered = qc.verifyMessage("Hello, QuantumCoin!", sig);
-  console.log("Recovered address:", recovered);
-  logAddress("recovered", recovered);
 
   const encrypted = wallet.encryptSync("mySecurePassword123");
   console.log("Encrypted wallet JSON length:", encrypted.length);

package/examples/example.ts

@@ -38,11 +38,6 @@ async function main(): Promise<void> {
   const wallet = qc.Wallet.createRandom();
   console.log("Random wallet address:", wallet.address);
   logAddress("random_wallet", wallet.address);
-  const sig = wallet.signMessageSync("Hello, QuantumCoin!");
-  console.log("Signed message signature:", sig.slice(0, 18) + "...");
-  const recovered = qc.verifyMessage("Hello, QuantumCoin!", sig);
-  console.log("Recovered address:", recovered);
-  logAddress("recovered", recovered);
 
   const encrypted = wallet.encryptSync("mySecurePassword123");
   console.log("Encrypted wallet JSON length:", encrypted.length);

package/examples/node_modules/.bin/esbuild

@@ -0,0 +1,16 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../esbuild/bin/esbuild" "$@"
+else 
+  exec node  "$basedir/../esbuild/bin/esbuild" "$@"
+fi

package/examples/node_modules/.bin/esbuild.cmd

@@ -0,0 +1,17 @@
+@ECHO off
+GOTO start
+:find_dp0
+SET dp0=%~dp0
+EXIT /b
+:start
+SETLOCAL
+CALL :find_dp0
+
+IF EXIST "%dp0%\node.exe" (
+  SET "_prog=%dp0%\node.exe"
+) ELSE (
+  SET "_prog=node"
+  SET PATHEXT=%PATHEXT:;.JS;=;%
+)
+
+endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\esbuild\bin\esbuild" %*

package/examples/node_modules/.bin/esbuild.ps1

@@ -0,0 +1,28 @@
+#!/usr/bin/env pwsh
+$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
+
+$exe=""
+if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
+  # Fix case when both the Windows and Linux builds of Node
+  # are installed in the same directory
+  $exe=".exe"
+}
+$ret=0
+if (Test-Path "$basedir/node$exe") {
+  # Support pipeline input
+  if ($MyInvocation.ExpectingInput) {
+    $input | & "$basedir/node$exe"  "$basedir/../esbuild/bin/esbuild" $args
+  } else {
+    & "$basedir/node$exe"  "$basedir/../esbuild/bin/esbuild" $args
+  }
+  $ret=$LASTEXITCODE
+} else {
+  # Support pipeline input
+  if ($MyInvocation.ExpectingInput) {
+    $input | & "node$exe"  "$basedir/../esbuild/bin/esbuild" $args
+  } else {
+    & "node$exe"  "$basedir/../esbuild/bin/esbuild" $args
+  }
+  $ret=$LASTEXITCODE
+}
+exit $ret

package/examples/node_modules/.bin/sdkgen

@@ -0,0 +1,16 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../quantumcoin/generate-sdk.js" "$@"
+else 
+  exec node  "$basedir/../quantumcoin/generate-sdk.js" "$@"
+fi

package/examples/node_modules/.bin/sdkgen.cmd

@@ -0,0 +1,17 @@
+@ECHO off
+GOTO start
+:find_dp0
+SET dp0=%~dp0
+EXIT /b
+:start
+SETLOCAL
+CALL :find_dp0
+
+IF EXIST "%dp0%\node.exe" (
+  SET "_prog=%dp0%\node.exe"
+) ELSE (
+  SET "_prog=node"
+  SET PATHEXT=%PATHEXT:;.JS;=;%
+)
+
+endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\quantumcoin\generate-sdk.js" %*

package/examples/node_modules/.bin/sdkgen.ps1

@@ -0,0 +1,28 @@
+#!/usr/bin/env pwsh
+$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
+
+$exe=""
+if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
+  # Fix case when both the Windows and Linux builds of Node
+  # are installed in the same directory
+  $exe=".exe"
+}
+$ret=0
+if (Test-Path "$basedir/node$exe") {
+  # Support pipeline input
+  if ($MyInvocation.ExpectingInput) {
+    $input | & "$basedir/node$exe"  "$basedir/../quantumcoin/generate-sdk.js" $args
+  } else {
+    & "$basedir/node$exe"  "$basedir/../quantumcoin/generate-sdk.js" $args
+  }
+  $ret=$LASTEXITCODE
+} else {
+  # Support pipeline input
+  if ($MyInvocation.ExpectingInput) {
+    $input | & "node$exe"  "$basedir/../quantumcoin/generate-sdk.js" $args
+  } else {
+    & "node$exe"  "$basedir/../quantumcoin/generate-sdk.js" $args
+  }
+  $ret=$LASTEXITCODE
+}
+exit $ret

package/examples/node_modules/.bin/tsx

@@ -0,0 +1,16 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"
+else 
+  exec node  "$basedir/../tsx/dist/cli.mjs" "$@"
+fi

package/examples/node_modules/.bin/tsx.cmd

@@ -0,0 +1,17 @@
+@ECHO off
+GOTO start
+:find_dp0
+SET dp0=%~dp0
+EXIT /b
+:start
+SETLOCAL
+CALL :find_dp0
+
+IF EXIST "%dp0%\node.exe" (
+  SET "_prog=%dp0%\node.exe"
+) ELSE (
+  SET "_prog=node"
+  SET PATHEXT=%PATHEXT:;.JS;=;%
+)
+
+endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\tsx\dist\cli.mjs" %*

package/examples/node_modules/.bin/tsx.ps1

@@ -0,0 +1,28 @@
+#!/usr/bin/env pwsh
+$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
+
+$exe=""
+if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
+  # Fix case when both the Windows and Linux builds of Node
+  # are installed in the same directory
+  $exe=".exe"
+}
+$ret=0
+if (Test-Path "$basedir/node$exe") {
+  # Support pipeline input
+  if ($MyInvocation.ExpectingInput) {
+    $input | & "$basedir/node$exe"  "$basedir/../tsx/dist/cli.mjs" $args
+  } else {
+    & "$basedir/node$exe"  "$basedir/../tsx/dist/cli.mjs" $args
+  }
+  $ret=$LASTEXITCODE
+} else {
+  # Support pipeline input
+  if ($MyInvocation.ExpectingInput) {
+    $input | & "node$exe"  "$basedir/../tsx/dist/cli.mjs" $args
+  } else {
+    & "node$exe"  "$basedir/../tsx/dist/cli.mjs" $args
+  }
+  $ret=$LASTEXITCODE
+}
+exit $ret

package/examples/node_modules/.package-lock.json

@@ -0,0 +1,144 @@
+{
+  "name": "quantumcoinjs-sdk-examples",
+  "version": "1.0.1",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "..": {
+      "name": "quantumcoin",
+      "version": "7.0.12",
+      "license": "MIT",
+      "dependencies": {
+        "quantum-coin-js-sdk": "1.0.35",
+        "seed-words": "^1.0.2"
+      },
+      "bin": {
+        "sdkgen": "generate-sdk.js"
+      },
+      "devDependencies": {
+        "tsx": "^4.19.0"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.7.tgz",
+      "integrity": "sha512-56hiAJPhwQ1R4i+21FVF7V8kSD5zZTdHcVuRFMW0hn753vVfQN8xlx4uOPT4xoGH0Z/oVATuR82AiqSTDIpaHg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/esbuild": {
+      "version": "0.27.7",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.7.tgz",
+      "integrity": "sha512-IxpibTjyVnmrIQo5aqNpCgoACA/dTKLTlhMHihVHhdkxKyPO1uBBthumT0rdHmcsk9uMonIWS0m4FljWzILh3w==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.7",
+        "@esbuild/android-arm": "0.27.7",
+        "@esbuild/android-arm64": "0.27.7",
+        "@esbuild/android-x64": "0.27.7",
+        "@esbuild/darwin-arm64": "0.27.7",
+        "@esbuild/darwin-x64": "0.27.7",
+        "@esbuild/freebsd-arm64": "0.27.7",
+        "@esbuild/freebsd-x64": "0.27.7",
+        "@esbuild/linux-arm": "0.27.7",
+        "@esbuild/linux-arm64": "0.27.7",
+        "@esbuild/linux-ia32": "0.27.7",
+        "@esbuild/linux-loong64": "0.27.7",
+        "@esbuild/linux-mips64el": "0.27.7",
+        "@esbuild/linux-ppc64": "0.27.7",
+        "@esbuild/linux-riscv64": "0.27.7",
+        "@esbuild/linux-s390x": "0.27.7",
+        "@esbuild/linux-x64": "0.27.7",
+        "@esbuild/netbsd-arm64": "0.27.7",
+        "@esbuild/netbsd-x64": "0.27.7",
+        "@esbuild/openbsd-arm64": "0.27.7",
+        "@esbuild/openbsd-x64": "0.27.7",
+        "@esbuild/openharmony-arm64": "0.27.7",
+        "@esbuild/sunos-x64": "0.27.7",
+        "@esbuild/win32-arm64": "0.27.7",
+        "@esbuild/win32-ia32": "0.27.7",
+        "@esbuild/win32-x64": "0.27.7"
+      }
+    },
+    "node_modules/get-tsconfig": {
+      "version": "4.13.8",
+      "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.13.8.tgz",
+      "integrity": "sha512-J87BxkLXykmisLQ+KA4x2+O6rVf+PJrtFUO8lGyiRg4lyxJLJ8/v0sRAKdVZQOy6tR6lMRAF1NqzCf9BQijm0w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "resolve-pkg-maps": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
+      }
+    },
+    "node_modules/quantum-coin-js-sdk": {
+      "version": "1.0.35",
+      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.35.tgz",
+      "integrity": "sha512-hJWYxPT5x+us/61hciuW5Ky9b0cRVStBRpKniFiz/usQJkM/Pw/8dNlgdBLU2H8ZvSuBp930Y+eRp9dpYRcYNA==",
+      "license": "MIT",
+      "dependencies": {
+        "seed-words": "1.0.2"
+      }
+    },
+    "node_modules/quantumcoin": {
+      "resolved": "..",
+      "link": true
+    },
+    "node_modules/resolve-pkg-maps": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
+      "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
+      }
+    },
+    "node_modules/seed-words": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/seed-words/-/seed-words-1.0.2.tgz",
+      "integrity": "sha512-ia58deuPjcR8DpJ8uIgZ7gqDnIWD8vnjb4jX/sEsIDcuQaH/AJj9J8L3DXkUHfUGqAq9Y6pVMuG90t3XUJH90g==",
+      "license": "MIT"
+    },
+    "node_modules/tsx": {
+      "version": "4.21.0",
+      "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.21.0.tgz",
+      "integrity": "sha512-5C1sg4USs1lfG0GFb2RLXsdpXqBSEhAaA/0kPL01wxzpMqLILNxIxIOKiILz+cdg/pLnOUxFYOR5yhHU666wbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.27.0",
+        "get-tsconfig": "^4.7.5"
+      },
+      "bin": {
+        "tsx": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      }
+    }
+  }
+}

package/examples/node_modules/@esbuild/win32-x64/README.md

@@ -0,0 +1,3 @@
+# esbuild
+
+This is the Windows 64-bit binary for esbuild, a JavaScript bundler and minifier. See https://github.com/evanw/esbuild for details.

package/examples/node_modules/@esbuild/win32-x64/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@esbuild/win32-x64",
+  "version": "0.27.7",
+  "description": "The Windows 64-bit binary for esbuild, a JavaScript bundler.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evanw/esbuild.git"
+  },
+  "license": "MIT",
+  "preferUnplugged": true,
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ]
+}

package/examples/node_modules/esbuild/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Evan Wallace
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/examples/node_modules/esbuild/README.md

@@ -0,0 +1,3 @@
+# esbuild
+
+This is a JavaScript bundler and minifier. See https://github.com/evanw/esbuild and the [JavaScript API documentation](https://esbuild.github.io/api/) for details.