quantumcoin 7.0.14 → 7.0.15

package/README-SDK.md

@@ -184,6 +184,7 @@ Base provider implementation. Subclasses implement `_perform`.
 - `getTransactionCount(address: string, blockTag?: string | null): Promise<number>`
 - `call(tx: TransactionRequest, blockTag?: string | null): Promise<string>`
 - `estimateGas(tx: TransactionRequest): Promise<bigint>`
+- `getFeeData(walletOrKeyType: Wallet | number, fullSign?: boolean | null): Promise<FeeData>` — returns fee data for a wallet (its key type is read via `getKeyType()`) or for a key type number (`3` or `5`) passed directly. `fullSign` applies only to key type `3` (full signing costs more gas) and is ignored for key type `5`. `FeeData` currently exposes a single field `gasPrice: bigint`, the price **per unit of gas** in wei (so the total transaction fee is `gasPrice * gasLimit`). Only DynamicFeeTx (dynamic-fee) transactions are supported; the EIP-1559 fields `maxFeePerGas` / `maxPriorityFeePerGas` are **not supported yet** (QuantumCoin has no base-fee / priority-tip model) and are absent from `FeeData`. Like ethers, this is a provider method; later releases may issue a network call (hence the `Promise`).
 - `getCode(address: string, blockTag?: string | null): Promise<string>`
 - `getStorageAt(address: string, position: bigint, blockTag?: string | null): Promise<string>`
 - `getLogs(filter: Filter | FilterByBlockHash): Promise<Log[]>`
@@ -403,6 +404,7 @@ User-facing wallet class.
 - `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.
+- `getKeyType(): number` — returns the wallet's key type, derived from its public key length: `3` (HYBRIDEDMLDSASLHDSA) or `5` (HYBRIDEDMLDSASLHDSA5). The key type drives gas-price selection in `getFeeData`. Throws for an unsupported public key size.
 
 **Seed & phrase applicability**
 

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

@@ -6,10 +6,10 @@
   "packages": {
     "..": {
       "name": "quantumcoin",
-      "version": "7.0.14",
+      "version": "7.0.15",
       "license": "MIT",
       "dependencies": {
-        "quantum-coin-js-sdk": "1.0.36",
+        "quantum-coin-js-sdk": "1.0.37",
         "seed-words": "^1.0.2"
       },
       "bin": {
@@ -92,9 +92,9 @@
       }
     },
     "node_modules/quantum-coin-js-sdk": {
-      "version": "1.0.36",
-      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.36.tgz",
-      "integrity": "sha512-FfK+xPTrylc2rKbQzC6AXodlLWOtXerGHZ34de6d1XmvDKduO7Q2zeHrp3YDa4UgSB0Di8zzNV15LgXz7ll2Nw==",
+      "version": "1.0.37",
+      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.37.tgz",
+      "integrity": "sha512-/ADjDgXsjRjGFBA6btrbsAfVxnm+L2WnIXeLsIC2xtCkQZb8ru84cAA7FEPEgpiZbyU200bvatWtyb4VDP/DVw==",
       "license": "MIT",
       "dependencies": {
         "seed-words": "1.0.2"

package/examples/node_modules/quantum-coin-js-sdk/README.md

@@ -161,6 +161,7 @@ Example Project: https://github.com/quantumcoinproject/quantum-coin-js-sdk/tree/
     * ~~[~signTransaction(wallet, toAddress, coins, nonce, data)](#module_quantum-coin-js-sdk..signTransaction) ⇒ <code>Promise.&lt;SignResult&gt;</code>~~
     * [~hexStringToUint8Array(hex)](#module_quantum-coin-js-sdk..hexStringToUint8Array) ⇒ <code>Uint8Array</code>
     * [~signRawTransaction(transactionSigningRequest)](#module_quantum-coin-js-sdk..signRawTransaction) ⇒ <code>SignResult</code>
+    * [~getGasPrice(keyType, [fullSign])](#module_quantum-coin-js-sdk..getGasPrice) ⇒ <code>Object</code>
     * [~sign(privateKey, message, [signingContext])](#module_quantum-coin-js-sdk..sign) ⇒ <code>Object</code>
     * [~verify(publicKey, signature, message)](#module_quantum-coin-js-sdk..verify) ⇒ <code>Object</code>
     * ~~[~sendCoins(wallet, toAddress, coins, nonce)](#module_quantum-coin-js-sdk..sendCoins) ⇒ <code>Promise.&lt;SendResult&gt;</code>~~
@@ -1442,6 +1443,19 @@ Another usecase for this function is when you want to first store a signed trans
 | --- | --- | --- |
 | transactionSigningRequest | <code>TransactionSigningRequest</code> | An object of type TransactionSigningRequest with the transaction signing details. |
 
+<a name="module_quantum-coin-js-sdk..getGasPrice"></a>
+
+### quantum-coin-js-sdk~getGasPrice(keyType, [fullSign]) ⇒ <code>Object</code>
+Returns the gas price per unit of gas (per-gas-unit), in wei, for the signing context implied by keyType and fullSign. This is NOT the total transaction fee (total fee = gasPrice * gasLimit). fullSign is ignored for keyType 5 (always context 1); it only affects keyType 3 (false = compact/context 0, true = full/context 2).
+
+**Kind**: inner method of [<code>quantum-coin-js-sdk</code>](#module_quantum-coin-js-sdk)  
+**Returns**: <code>Object</code> - { resultCode, gasPrice }: resultCode 0 and gasPrice as a decimal wei string on success; negative resultCode with null gasPrice on invalid keyType.  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| keyType | <code>number</code> | 3 (HYBRIDEDMLDSASLHDSA) or 5 (HYBRIDEDMLDSASLHDSA5). |
+| [fullSign] | <code>boolean</code> \| <code>null</code> | Optional. Use full (non-compact) signing for keyType 3. Ignored for keyType 5. Defaults to false. |
+
 <a name="module_quantum-coin-js-sdk..sign"></a>
 
 ### quantum-coin-js-sdk~sign(privateKey, message, [signingContext]) ⇒ <code>Object</code>

package/examples/node_modules/quantum-coin-js-sdk/example/conversion-example.js

@@ -1,4 +1,4 @@
-const ethers = require('ethers');
+const { formatEther, parseEther } = require('quantumcoin');
 
 let hexValue = "0xDE0B6B3A7640000";
 
@@ -7,13 +7,13 @@ let weiValueExample = BigInt(hexValue).toString();
 console.log("hex to wei example: hex:" + hexValue + ", wei: " + weiValueExample);
 
 //Convert wei to eth
-let ethValueExample = ethers.formatEther(weiValueExample);
+let ethValueExample = formatEther(weiValueExample);
 console.log("wei to eth example: wei:" + weiValueExample + ", eth (coins): " + ethValueExample);
 
 //Convert eth to wei
-let weiValueExample2 = ethers.parseUnits(ethValueExample, "ether");
+let weiValueExample2 = parseEther(ethValueExample);
 console.log("eth to wei example: eth (coins):" + ethValueExample + ", wei: " + weiValueExample2);
 
 //Convert wei to hex
-let hexValue2 =  ethers.toBeHex(weiValueExample2);
+let hexValue2 =  "0x" + BigInt(weiValueExample2).toString(16);
 console.log("wei to hex example : hex: " + hexValue2 + ", wei: " + weiValueExample2);

package/examples/node_modules/quantum-coin-js-sdk/example/example-misc.js

@@ -1,5 +1,4 @@
 const qcsdk = require('quantum-coin-js-sdk');
-const ethers = require('ethers');
 
 var clientConfigVal = new qcsdk.Config("https://sdk.readrelay.quantumcoinapi.com", "https://sdk.writerelay.quantumcoinapi.com", 123123, "", ""); //Mainnet
 

package/examples/node_modules/quantum-coin-js-sdk/example/example-rpc-send.js

@@ -1,5 +1,4 @@
 const qcsdk = require('quantum-coin-js-sdk');
-const ethers = require('ethers');
 
 //This example shows how to manage wallets, sign a transaction and send a transaction using JSON RPC
 //You may use empty values for the read and write URLs

package/examples/node_modules/quantum-coin-js-sdk/example/example-send.js

@@ -1,5 +1,4 @@
 const qcsdk = require('quantum-coin-js-sdk');
-const ethers = require('ethers');
 
 var clientConfigVal = new qcsdk.Config("https://sdk.readrelay.quantumcoinapi.com", "https://sdk.writerelay.quantumcoinapi.com", 123123, "", ""); //Mainnet
 

package/examples/node_modules/quantum-coin-js-sdk/example/example-token-pack-unpack.js

@@ -1,5 +1,4 @@
 const qcsdk = require('quantum-coin-js-sdk');
-const ethers = require('ethers');
 
 /**
  * Example: Token Pack/Unpack Operations

package/examples/node_modules/quantum-coin-js-sdk/example/example-wallet-version4.js

@@ -1,5 +1,4 @@
 const qcsdk = require('quantum-coin-js-sdk');
-const ethers = require('ethers');
 
 
 var clientConfigVal = new qcsdk.Config("", "", 123123, "", ""); //Mainnet

package/examples/node_modules/quantum-coin-js-sdk/example/example.js

@@ -1,5 +1,5 @@
 const qcsdk = require('quantum-coin-js-sdk');
-const ethers = require('ethers');
+const { formatEther, parseEther } = require('quantumcoin');
 
 var clientConfigVal = new qcsdk.Config("https://sdk.readrelay.quantumcoinapi.com", "https://sdk.writerelay.quantumcoinapi.com", 123123, "", ""); //Mainnet
 
@@ -22,10 +22,10 @@ let hexValue = "0x56BC75E2D63100000";
 let weiValueExample = BigInt(hexValue).toString(); //convert hex to wei
 console.log("hex to wei example: hex:" + hexValue + ", wei: " + weiValueExample);
 
-let ethValueExample = ethers.formatEther(weiValueExample); //convert wei to eth
+let ethValueExample = formatEther(weiValueExample); //convert wei to eth
 console.log("wei to eth example: wei:" + weiValueExample + ", eth (coins): " + ethValueExample);
 
-let weiValueExample2 = ethers.parseUnits(ethValueExample, "ether"); //convert eth to wei
+let weiValueExample2 = parseEther(ethValueExample); //convert eth to wei
 console.log("eth to wei example: eth (coins):" + ethValueExample + ", wei: " + weiValueExample2);
 
 //Initialize the SDK
@@ -65,7 +65,7 @@ qcsdk.initialize(clientConfigVal).then((initResult) => {
         console.log("     address: " + accountDetailsResult.accountDetails.address);
 
         console.log("     balance (wei): " + accountDetailsResult.accountDetails.balance);
-        var etherValue = ethers.formatEther(accountDetailsResult.accountDetails.balance)
+        var etherValue = formatEther(accountDetailsResult.accountDetails.balance)
         console.log("     balance coins (ether): " + etherValue);
 
         console.log("     nonce: " + accountDetailsResult.accountDetails.nonce);
@@ -265,7 +265,7 @@ qcsdk.initialize(clientConfigVal).then((initResult) => {
             console.log("          To Address: " + txn.to);
 
             let weiValueExample = BigInt(txn.value).toString(); //value is in hex. convert hex to wei
-            let ethValueExample = ethers.formatEther(weiValueExample); //convert wei to eth
+            let ethValueExample = formatEther(weiValueExample); //convert wei to eth
             console.log("          Value (hex): " + txn.value + " , (wei): " + weiValueExample + " , coins (eth): " + ethValueExample);            
 
             console.log("          Status: " + txn.status);

package/examples/node_modules/quantum-coin-js-sdk/example/package-lock.json

@@ -9,126 +9,48 @@
       "version": "1.0.0",
       "license": "MIT",
       "dependencies": {
-        "ethers": "^6.13.4",
-        "quantum-coin-js-sdk": "file:.."
+        "quantum-coin-js-sdk": "file:..",
+        "quantumcoin": "^7.0.14"
       }
     },
     "..": {
-      "version": "1.0.36",
+      "version": "1.0.37",
       "license": "MIT",
       "dependencies": {
         "seed-words": "1.0.2"
       }
     },
-    "node_modules/@adraffy/ens-normalize": {
-      "version": "1.10.1",
-      "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.10.1.tgz",
-      "integrity": "sha512-96Z2IP3mYmF1Xg2cDm8f1gWGf/HUVedQ3FMifV4kG/PQ4yEP51xDtRAEfhVNt5f/uzpNkZHwWQuUcu6D6K+Ekw==",
-      "license": "MIT"
+    "node_modules/quantum-coin-js-sdk": {
+      "resolved": "..",
+      "link": true
     },
-    "node_modules/@noble/curves": {
-      "version": "1.2.0",
-      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.2.0.tgz",
-      "integrity": "sha512-oYclrNgRaM9SsBUBVbb8M6DTV7ZHRTKugureoYEncY5c65HOmRzvSiTE3y5CYaPYJA/GVkrhXEoF0M3Ya9PMnw==",
+    "node_modules/quantumcoin": {
+      "version": "7.0.14",
+      "resolved": "https://registry.npmjs.org/quantumcoin/-/quantumcoin-7.0.14.tgz",
+      "integrity": "sha512-yWqgIZcx51z3iAcK7kJJ400WeI1pzYbz3A6OasTvPfYYx9MhRTspfOlfeVtRZob1bky4f5san5+rD+76kTGncA==",
       "license": "MIT",
       "dependencies": {
-        "@noble/hashes": "1.3.2"
-      },
-      "funding": {
-        "url": "https://paulmillr.com/funding/"
-      }
-    },
-    "node_modules/@noble/hashes": {
-      "version": "1.3.2",
-      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.3.2.tgz",
-      "integrity": "sha512-MVC8EAQp7MvEcm30KWENFjgR+Mkmf+D189XJTkFIlwohU5hcBbn1ZkKq7KVTi2Hme3PMGF390DaL52beVrIihQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 16"
+        "quantum-coin-js-sdk": "1.0.36",
+        "seed-words": "^1.0.2"
       },
-      "funding": {
-        "url": "https://paulmillr.com/funding/"
+      "bin": {
+        "sdkgen": "generate-sdk.js"
       }
     },
-    "node_modules/@types/node": {
-      "version": "22.7.5",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.7.5.tgz",
-      "integrity": "sha512-jML7s2NAzMWc//QSJ1a3prpk78cOPchGvXJsC3C6R6PSMoooztvRVQEz89gmBTBY1SPMaqo5teB4uNHPdetShQ==",
-      "license": "MIT",
-      "dependencies": {
-        "undici-types": "~6.19.2"
-      }
-    },
-    "node_modules/aes-js": {
-      "version": "4.0.0-beta.5",
-      "resolved": "https://registry.npmjs.org/aes-js/-/aes-js-4.0.0-beta.5.tgz",
-      "integrity": "sha512-G965FqalsNyrPqgEGON7nIx1e/OVENSgiEIzyC63haUMuvNnwIgIjMs52hlTCKhkBny7A2ORNlfY9Zu+jmGk1Q==",
-      "license": "MIT"
-    },
-    "node_modules/ethers": {
-      "version": "6.16.0",
-      "resolved": "https://registry.npmjs.org/ethers/-/ethers-6.16.0.tgz",
-      "integrity": "sha512-U1wulmetNymijEhpSEQ7Ct/P/Jw9/e7R1j5XIbPRydgV2DjLVMsULDlNksq3RQnFgKoLlZf88ijYtWEXcPa07A==",
-      "funding": [
-        {
-          "type": "individual",
-          "url": "https://github.com/sponsors/ethers-io/"
-        },
-        {
-          "type": "individual",
-          "url": "https://www.buymeacoffee.com/ricmoo"
-        }
-      ],
+    "node_modules/quantumcoin/node_modules/quantum-coin-js-sdk": {
+      "version": "1.0.36",
+      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.36.tgz",
+      "integrity": "sha512-FfK+xPTrylc2rKbQzC6AXodlLWOtXerGHZ34de6d1XmvDKduO7Q2zeHrp3YDa4UgSB0Di8zzNV15LgXz7ll2Nw==",
       "license": "MIT",
       "dependencies": {
-        "@adraffy/ens-normalize": "1.10.1",
-        "@noble/curves": "1.2.0",
-        "@noble/hashes": "1.3.2",
-        "@types/node": "22.7.5",
-        "aes-js": "4.0.0-beta.5",
-        "tslib": "2.7.0",
-        "ws": "8.17.1"
-      },
-      "engines": {
-        "node": ">=14.0.0"
+        "seed-words": "1.0.2"
       }
     },
-    "node_modules/quantum-coin-js-sdk": {
-      "resolved": "..",
-      "link": true
-    },
-    "node_modules/tslib": {
-      "version": "2.7.0",
-      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.7.0.tgz",
-      "integrity": "sha512-gLXCKdN1/j47AiHiOkJN69hJmcbGTHI0ImLmbYLHykhgeN0jVGola9yVjFgzCUklsZQMW55o+dW7IXv3RCXDzA==",
-      "license": "0BSD"
-    },
-    "node_modules/undici-types": {
-      "version": "6.19.8",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",
-      "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==",
+    "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/ws": {
-      "version": "8.17.1",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
-      "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=10.0.0"
-      },
-      "peerDependencies": {
-        "bufferutil": "^4.0.1",
-        "utf-8-validate": ">=5.0.2"
-      },
-      "peerDependenciesMeta": {
-        "bufferutil": {
-          "optional": true
-        },
-        "utf-8-validate": {
-          "optional": true
-        }
-      }
     }
   }
 }

package/examples/node_modules/quantum-coin-js-sdk/example/package.json

@@ -9,7 +9,7 @@
   "author": "Quantum Coin Community",
   "license": "MIT",
   "dependencies": {
-    "ethers": "^6.13.4",
+    "quantumcoin": "^7.0.14",
     "quantum-coin-js-sdk": "file:.."
   }
 }

package/examples/node_modules/quantum-coin-js-sdk/index.d.ts

@@ -826,6 +826,22 @@ export class TransactionSigningRequest {
  * @return {SignResult}  Returns a promise of type SignResult.
  */
 export function signRawTransaction(transactionSigningRequest: TransactionSigningRequest): SignResult;
+/**
+ * Returns the gas price per unit of gas (per-gas-unit), in wei, for the signing context implied by keyType and fullSign.
+ * The returned gasPrice is the price PER UNIT OF GAS, NOT the total transaction fee (total fee = gasPrice * gasLimit).
+ * This mirrors the dynamic-fee gas price logic in quantum-coin-go core/types/dynamic_fee_tx.go.
+ *
+ * fullSign is ignored for keyType 5 (which always uses signing context 1). For keyType 3, fullSign selects the scheme: false = compact (context 0), true = full (context 2).
+ *
+ * @function getGasPrice
+ * @param {number} keyType - 3 (HYBRIDEDMLDSASLHDSA) or 5 (HYBRIDEDMLDSASLHDSA5).
+ * @param {boolean|null} [fullSign] - Optional. Use full (non-compact) signing for keyType 3. Ignored for keyType 5. Defaults to false.
+ * @returns {{ resultCode: number, gasPrice: string|null }} resultCode 0 and gasPrice as a decimal wei string (per gas unit) on success; resultCode -940 with gasPrice null for an invalid keyType.
+ */
+export function getGasPrice(keyType: number, fullSign?: boolean | null): {
+    resultCode: number;
+    gasPrice: string | null;
+};
 /**
  * Sign a message with a private key. Optional signingContext selects algorithm (same pattern as signRawTransaction); if null/omitted, derived from private key type.
  * @param {number[]|Uint8Array} privateKey - Private key bytes.

package/examples/node_modules/quantum-coin-js-sdk/index.js

@@ -44,6 +44,14 @@ const DEFAULT_GAS = 21000;
 const API_KEY_HEADER_NAME = "X-API-KEY";
 const REQUEST_ID_HEADER_NAME = "X-REQUEST-ID";
 
+// Dynamic-fee gas pricing (mirrors quantum-coin-go core/types/dynamic_fee_tx.go).
+// Base dynamic price = defaults.DEFAULT_PRICE / 10. BigInt is used because the
+// level multipliers push the value above Number.MAX_SAFE_INTEGER.
+const DEFAULT_PRICE_WEI = 47619047619047600n;
+const DYNAMIC_BASE_GAS_PRICE_WEI = DEFAULT_PRICE_WEI / 10n;
+const SIGNING_CONTEXT_LEVEL1_MULTIPLIER = 20n;
+const SIGNING_CONTEXT_LEVEL2_MULTIPLIER = 30n;
+
 // Key type and seed constants (CIRCL migration; see pqc-circl-migration.md)
 const KEY_TYPE_HYBRIDEDMLDSASLHDSA = 3;
 const KEY_TYPE_HYBRIDEDMLDSASLHDSA5 = 5;
@@ -2363,6 +2371,35 @@ function signRawTransaction(transactionSigningRequest) {
     return new SignResult(0, txHashHex, txnData);
 }
 
+/**
+ * Returns the gas price per unit of gas (per-gas-unit), in wei, for the signing context implied by keyType and fullSign.
+ * The returned value is the price PER UNIT OF GAS, NOT the total transaction fee (total fee = gasPrice * gasLimit).
+ * This mirrors the dynamic-fee gas price logic in quantum-coin-go core/types/dynamic_fee_tx.go.
+ *
+ * fullSign is IGNORED for keyType 5 (KEY_TYPE_HYBRIDEDMLDSASLHDSA5), which always uses signing context 1.
+ * For keyType 3 (KEY_TYPE_HYBRIDEDMLDSASLHDSA), fullSign selects the scheme: false = compact (context 0), true = full (context 2).
+ *
+ * @function getGasPrice
+ * @param {number} keyType - 3 (KEY_TYPE_HYBRIDEDMLDSASLHDSA) or 5 (KEY_TYPE_HYBRIDEDMLDSASLHDSA5).
+ * @param {boolean|null} [fullSign] - Optional. Use full (non-compact) signing for keyType 3. Ignored for keyType 5. Defaults to false.
+ * @returns {{ resultCode: number, gasPrice: string|null }} resultCode 0 and gasPrice as a decimal wei string (per gas unit) on success; resultCode -940 with gasPrice null for an invalid keyType.
+ */
+function getGasPrice(keyType, fullSign) {
+    const useFullSign = fullSign === true;
+    let multiplier;
+    if (keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA) {
+        // signing context 0 (compact) or 2 (full)
+        multiplier = useFullSign ? SIGNING_CONTEXT_LEVEL2_MULTIPLIER : 1n;
+    } else if (keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA5) {
+        // signing context 1; fullSign is not applicable for this key type
+        multiplier = SIGNING_CONTEXT_LEVEL1_MULTIPLIER;
+    } else {
+        return { resultCode: -940, gasPrice: null };
+    }
+    const price = DYNAMIC_BASE_GAS_PRICE_WEI * multiplier;
+    return { resultCode: 0, gasPrice: price.toString() };
+}
+
 /**
  * Sign a message with a private key. Optional signingContext selects algorithm (same pattern as signRawTransaction); if null/omitted, derived from private key type.
  * @param {number[]|Uint8Array} privateKey - Private key bytes.
@@ -3128,6 +3165,7 @@ module.exports = {
     combinePublicKeySignature,
     TransactionSigningRequest,
     signRawTransaction,
+    getGasPrice,
     sign,
     verify,
     packMethodData,

package/examples/node_modules/quantum-coin-js-sdk/package.json

@@ -1,10 +1,10 @@
 {
   "name": "quantum-coin-js-sdk",
-  "version": "1.0.36",
+  "version": "1.0.37",
   "description": "Quantum Coin - Q SDK in JavaScript",
   "main": "index.js",
   "scripts": {
-    "test": "node --test tests/non-transactional.preinit.test.js tests/non-transactional.test.js tests/sign-raw-transaction.test.js tests/sign-verify.test.js tests/transactional.rpc.test.js tests/transactional.relay.test.js",
+    "test": "node --test tests/non-transactional.preinit.test.js tests/non-transactional.test.js tests/sign-raw-transaction.test.js tests/sign-verify.test.js tests/get-gas-price.test.js tests/transactional.rpc.test.js tests/transactional.relay.test.js",
     "build": "npx -p typescript tsc index.js --declaration --allowJs --emitDeclarationOnly"
   },
   "repository": {

package/examples/node_modules/quantum-coin-js-sdk/tests/get-gas-price.test.js

@@ -0,0 +1,59 @@
+/**
+ * Tests for getGasPrice(keyType, fullSign).
+ * Verifies per-gas-unit price (in wei) for each signing context implied by keyType/fullSign,
+ * mirroring the dynamic-fee pricing in quantum-coin-go core/types/dynamic_fee_tx.go.
+ */
+const { describe, test } = require('node:test');
+const assert = require('node:assert/strict');
+
+const qcsdk = require('..');
+
+// Base dynamic-fee price = DEFAULT_PRICE (47619047619047600) / 10
+const BASE = '4761904761904760';      // context 0 (x1)
+const LEVEL1 = '95238095238095200';   // context 1 (x20)
+const LEVEL2 = '142857142857142800';  // context 2 (x30)
+
+describe('getGasPrice', () => {
+  test('keyType 3, fullSign false -> base price (context 0)', () => {
+    const result = qcsdk.getGasPrice(3, false);
+    assert.equal(result.resultCode, 0);
+    assert.equal(result.gasPrice, BASE);
+  });
+
+  test('keyType 3, fullSign true -> level2 price (context 2)', () => {
+    const result = qcsdk.getGasPrice(3, true);
+    assert.equal(result.resultCode, 0);
+    assert.equal(result.gasPrice, LEVEL2);
+  });
+
+  test('keyType 5, fullSign false -> level1 price (context 1)', () => {
+    const result = qcsdk.getGasPrice(5, false);
+    assert.equal(result.resultCode, 0);
+    assert.equal(result.gasPrice, LEVEL1);
+  });
+
+  test('keyType 5, fullSign true -> ignored, same as keyType 5 false', () => {
+    const withFull = qcsdk.getGasPrice(5, true);
+    assert.equal(withFull.resultCode, 0);
+    assert.equal(withFull.gasPrice, LEVEL1);
+    assert.equal(withFull.gasPrice, qcsdk.getGasPrice(5, false).gasPrice);
+  });
+
+  test('keyType 3 with omitted fullSign -> defaults to false (base price)', () => {
+    const omitted = qcsdk.getGasPrice(3);
+    assert.equal(omitted.resultCode, 0);
+    assert.equal(omitted.gasPrice, BASE);
+
+    const nullFull = qcsdk.getGasPrice(3, null);
+    assert.equal(nullFull.resultCode, 0);
+    assert.equal(nullFull.gasPrice, BASE);
+  });
+
+  test('invalid keyType -> negative resultCode and null gasPrice', () => {
+    for (const invalid of [4, 0, null, undefined]) {
+      const result = qcsdk.getGasPrice(invalid, false);
+      assert.ok(result.resultCode < 0, `expected negative resultCode for keyType ${invalid}`);
+      assert.equal(result.gasPrice, null);
+    }
+  });
+});

package/examples/package-lock.json

@@ -9,7 +9,7 @@
       "version": "1.0.1",
       "license": "MIT",
       "dependencies": {
-        "quantum-coin-js-sdk": "1.0.36",
+        "quantum-coin-js-sdk": "1.0.37",
         "quantumcoin": "file:.."
       },
       "devDependencies": {
@@ -18,10 +18,10 @@
     },
     "..": {
       "name": "quantumcoin",
-      "version": "7.0.14",
+      "version": "7.0.15",
       "license": "MIT",
       "dependencies": {
-        "quantum-coin-js-sdk": "1.0.36",
+        "quantum-coin-js-sdk": "1.0.37",
         "seed-words": "^1.0.2"
       },
       "bin": {
@@ -544,9 +544,9 @@
       }
     },
     "node_modules/quantum-coin-js-sdk": {
-      "version": "1.0.36",
-      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.36.tgz",
-      "integrity": "sha512-FfK+xPTrylc2rKbQzC6AXodlLWOtXerGHZ34de6d1XmvDKduO7Q2zeHrp3YDa4UgSB0Di8zzNV15LgXz7ll2Nw==",
+      "version": "1.0.37",
+      "resolved": "https://registry.npmjs.org/quantum-coin-js-sdk/-/quantum-coin-js-sdk-1.0.37.tgz",
+      "integrity": "sha512-/ADjDgXsjRjGFBA6btrbsAfVxnm+L2WnIXeLsIC2xtCkQZb8ru84cAA7FEPEgpiZbyU200bvatWtyb4VDP/DVw==",
       "license": "MIT",
       "dependencies": {
         "seed-words": "1.0.2"

package/examples/package.json

@@ -26,7 +26,7 @@
     "tsx": "^4.19.0"
   },
   "dependencies": {
-    "quantum-coin-js-sdk": "1.0.36",
+    "quantum-coin-js-sdk": "1.0.37",
     "quantumcoin": "file:.."
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quantumcoin",
-  "version": "7.0.14",
+  "version": "7.0.15",
   "description": "QuantumCoin.js - a post quantum cryptography SDK for QuantumCoin",
   "main": "index.js",
   "types": "src/index.d.ts",
@@ -90,6 +90,6 @@
   },
   "dependencies": {
     "seed-words": "^1.0.2",
-    "quantum-coin-js-sdk": "1.0.36"
+    "quantum-coin-js-sdk": "1.0.37"
   }
 }

package/src/index.d.ts

@@ -106,6 +106,7 @@ declare const _exports: {
     TransactionResponse: typeof import("./providers/provider").TransactionResponse;
     TransactionReceipt: typeof import("./providers/provider").TransactionReceipt;
     Log: typeof import("./providers/provider").Log;
+    FeeData: typeof import("./providers/provider").FeeData;
     version: string;
     ZeroAddress: string;
     ZeroHash: string;

package/src/providers/index.d.ts

@@ -13,5 +13,6 @@ declare const _exports: {
     TransactionResponse: typeof import("./provider").TransactionResponse;
     TransactionReceipt: typeof import("./provider").TransactionReceipt;
     Log: typeof import("./provider").Log;
+    FeeData: typeof import("./provider").FeeData;
 };
 export = _exports;

package/src/providers/provider.d.ts

@@ -93,6 +93,13 @@ export class AbstractProvider extends Provider {
      * @returns {Promise<bigint>}
      */
     estimateGas(tx: TransactionRequest): Promise<bigint>;
+    /**
+     * Returns fee data (currently the gas price per unit of gas, in wei).
+     * Supports only DynamicFeeTx (dynamic-fee transactions); other fee tx types are not supported.
+     * @param walletOrKeyType A Wallet, or a key type number (3 or 5).
+     * @param fullSign Full signing (keyType 3 only; ignored for keyType 5).
+     */
+    getFeeData(walletOrKeyType: import("../wallet/wallet").Wallet | number, fullSign?: boolean | null): Promise<FeeData>;
     /**
      * @param {string} address
      * @param {string=} blockTag
@@ -204,3 +211,12 @@ export class Log {
     getTransaction(): Promise<TransactionResponse>;
     getTransactionReceipt(): Promise<TransactionReceipt>;
 }
+/**
+ * Fee data for a transaction. Currently only `gasPrice` (per unit of gas, in wei)
+ * is populated. `maxFeePerGas` / `maxPriorityFeePerGas` are not supported yet:
+ * QuantumCoin uses a fixed per-scheme fee model with no EIP-1559 base fee / priority tip.
+ */
+export class FeeData {
+    constructor(gasPrice: bigint);
+    gasPrice: bigint | null;
+}

package/src/providers/provider.js

@@ -6,6 +6,7 @@
  */
 
 const { EventEmitter } = require("events");
+const qcsdk = require("quantum-coin-js-sdk");
 const { makeError, assertArgument } = require("../errors");
 const { normalizeHex, toQuantityHex, isHexString } = require("../internal/hex");
 
@@ -263,6 +264,20 @@ class Block {
   }
 }
 
+/**
+ * Fee data for a transaction. Currently only `gasPrice` (per unit of gas, in wei)
+ * is populated. `maxFeePerGas` / `maxPriorityFeePerGas` are not supported yet:
+ * QuantumCoin uses a fixed per-scheme fee model with no EIP-1559 base fee / priority tip.
+ */
+class FeeData {
+  /**
+   * @param {bigint} gasPrice
+   */
+  constructor(gasPrice) {
+    this.gasPrice = gasPrice;
+  }
+}
+
 /**
  * Base Provider class.
  */
@@ -459,6 +474,30 @@ class AbstractProvider extends Provider {
     return _hexToBigInt(gas);
   }
 
+  /**
+   * Returns fee data (currently the gas price per unit of gas, in wei).
+   * Supports only DynamicFeeTx (dynamic-fee transactions); other fee tx types are not supported.
+   * @param {import("../wallet/wallet").Wallet|number} walletOrKeyType A Wallet, or a key type number (3 or 5).
+   * @param {boolean|null=} fullSign  Full signing (keyType 3 only; ignored for keyType 5).
+   * @returns {Promise<FeeData>}
+   */
+  async getFeeData(walletOrKeyType, fullSign) {
+    let keyType;
+    if (typeof walletOrKeyType === "number") {
+      keyType = walletOrKeyType;
+    } else if (walletOrKeyType && typeof walletOrKeyType.getKeyType === "function") {
+      keyType = walletOrKeyType.getKeyType();
+    } else {
+      assertArgument(false, "expected a Wallet or a keyType number", "walletOrKeyType", walletOrKeyType);
+    }
+
+    const res = qcsdk.getGasPrice(keyType, fullSign ?? false);
+    if (!res || res.resultCode !== 0 || res.gasPrice == null) {
+      throw makeError("getGasPrice failed", "UNKNOWN_ERROR", { resultCode: res && res.resultCode, keyType });
+    }
+    return new FeeData(BigInt(res.gasPrice));
+  }
+
   /**
    * @param {string} address
    * @param {string=} blockTag
@@ -520,5 +559,6 @@ module.exports = {
   TransactionResponse,
   TransactionReceipt,
   Log,
+  FeeData,
 };
 

package/src/wallet/wallet.d.ts

@@ -70,6 +70,16 @@ export class Wallet extends BaseWallet {
      * @returns {number}
      */
     getSigningContext(fullSign?: boolean | null): number;
+    /**
+     * Returns the key type of this wallet, derived from its public key length:
+     * 3 (KEY_TYPE_HYBRIDEDMLDSASLHDSA) or 5 (KEY_TYPE_HYBRIDEDMLDSASLHDSA5).
+     *
+     * The key type drives gas-price selection via `getFeeData`. Note that the
+     * underlying quantum-coin-js-sdk gas-price model supports only DynamicFeeTx
+     * (dynamic-fee transactions); legacy/other transaction fee types are not supported.
+     * @returns {number} 3 or 5.
+     */
+    getKeyType(): number;
     /**
      * Creates a new random wallet.
      * @param {import("../providers/provider").AbstractProvider=} provider

package/src/wallet/wallet.js

@@ -83,6 +83,27 @@ function _getNumber(value, name) {
   return Number(bi);
 }
 
+// Key type / public-key-length constants. The quantum-coin-js-sdk defines these
+// key types internally (KEY_TYPE_HYBRIDEDMLDSASLHDSA = 3,
+// KEY_TYPE_HYBRIDEDMLDSASLHDSA5 = 5) but does not export them, so we mirror them
+// here and derive the key type from the public key length.
+const KEY_TYPE_HYBRIDEDMLDSASLHDSA = 3;
+const KEY_TYPE_HYBRIDEDMLDSASLHDSA5 = 5;
+const PUBLIC_KEY_LENGTH_KEYTYPE3 = 1408;
+const PUBLIC_KEY_LENGTH_KEYTYPE5 = 2688;
+
+/**
+ * Maps a public key length to the wallet key type.
+ * @param {number} pubLen
+ * @returns {number} KEY_TYPE_HYBRIDEDMLDSASLHDSA (3) or KEY_TYPE_HYBRIDEDMLDSASLHDSA5 (5).
+ * @throws if the public key length is unsupported.
+ */
+function _keyTypeFromPublicKeyLength(pubLen) {
+  if (pubLen === PUBLIC_KEY_LENGTH_KEYTYPE3) return KEY_TYPE_HYBRIDEDMLDSASLHDSA;
+  if (pubLen === PUBLIC_KEY_LENGTH_KEYTYPE5) return KEY_TYPE_HYBRIDEDMLDSASLHDSA5;
+  throw makeError("unsupported public key size", "UNSUPPORTED_OPERATION", { publicKeyLength: pubLen });
+}
+
 /**
  * SigningKey wrapper (PQC private/public key bytes).
  */
@@ -468,14 +489,26 @@ class Wallet extends BaseWallet {
    */
   getSigningContext(fullSign) {
     const fs = fullSign ?? false;
-    const pubLen = this.signingKey.publicKeyBytes.length;
-    if (pubLen === 1408) {
+    const keyType = _keyTypeFromPublicKeyLength(this.signingKey.publicKeyBytes.length);
+    if (keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA) {
       return fs ? 2 : 0;
     }
-    if (pubLen === 2688) {
-      return 1;
-    }
-    throw makeError("unsupported public key size", "UNSUPPORTED_OPERATION", { publicKeyLength: pubLen });
+    return 1;
+  }
+
+  /**
+   * Returns the key type of this wallet, derived from its public key length:
+   * 3 (KEY_TYPE_HYBRIDEDMLDSASLHDSA) or 5 (KEY_TYPE_HYBRIDEDMLDSASLHDSA5).
+   *
+   * The key type drives gas-price selection via `getFeeData`. Note that the
+   * underlying quantum-coin-js-sdk gas-price model supports only DynamicFeeTx
+   * (dynamic-fee transactions); legacy/other transaction fee types are not supported.
+   *
+   * @returns {number} 3 or 5.
+   * @throws if the public key length is unsupported.
+   */
+  getKeyType() {
+    return _keyTypeFromPublicKeyLength(this.signingKey.publicKeyBytes.length);
   }
 
   /**
@@ -499,7 +532,12 @@ class Wallet extends BaseWallet {
   static createRandom(provider, keyType) {
     _requireInitialized();
     if (keyType != null) {
-      assertArgument(keyType === 3 || keyType === 5, "keyType must be null, 3, or 5", "keyType", keyType);
+      assertArgument(
+        keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA || keyType === KEY_TYPE_HYBRIDEDMLDSASLHDSA5,
+        "keyType must be null, 3, or 5",
+        "keyType",
+        keyType,
+      );
     }
     const words = qcsdk.newWalletSeedWords(keyType ?? null);
     if (!words || !Array.isArray(words)) {

package/test/unit/address-wallet.test.js

@@ -888,6 +888,28 @@ describe("Address + Wallet (offline)", () => {
     w.signingKey.publicKeyBytes = new Uint8Array(100);
     assert.throws(() => w.getSigningContext(), /unsupported public key size/);
   });
+
+  // ---------------------------------------------------------------------------
+  // getKeyType
+  // ---------------------------------------------------------------------------
+
+  it("getKeyType: 32-word and 48-word wallets (pubKey 1408) return 3", async () => {
+    await Initialize(null);
+    assert.strictEqual(qc.Wallet.fromPhrase(TEST_SEED_WORDS_32).getKeyType(), 3);
+    assert.strictEqual(qc.Wallet.fromPhrase(TEST_SEED_WORDS).getKeyType(), 3);
+  });
+
+  it("getKeyType: 36-word wallet (pubKey 2688) returns 5", async () => {
+    await Initialize(null);
+    assert.strictEqual(qc.Wallet.fromPhrase(TEST_SEED_WORDS_36).getKeyType(), 5);
+  });
+
+  it("getKeyType: throws for unsupported public key size", async () => {
+    await Initialize(null);
+    const w = qc.Wallet.fromPhrase(TEST_SEED_WORDS_32);
+    w.signingKey.publicKeyBytes = new Uint8Array(100);
+    assert.throws(() => w.getKeyType(), /unsupported public key size/);
+  });
 });
 
 describe("Security: universal key-pair verification", () => {

package/test/unit/address-wallet.test.ts

@@ -874,4 +874,26 @@ describe("Address + Wallet (offline)", () => {
     (w.signingKey as any).publicKeyBytes = new Uint8Array(100);
     assert.throws(() => w.getSigningContext(), /unsupported public key size/);
   });
+
+  // ---------------------------------------------------------------------------
+  // getKeyType
+  // ---------------------------------------------------------------------------
+
+  it("getKeyType: 32-word and 48-word wallets (pubKey 1408) return 3", async () => {
+    await Initialize(null);
+    assert.strictEqual(qc.Wallet.fromPhrase(TEST_SEED_WORDS_32).getKeyType(), 3);
+    assert.strictEqual(qc.Wallet.fromPhrase(TEST_SEED_WORDS).getKeyType(), 3);
+  });
+
+  it("getKeyType: 36-word wallet (pubKey 2688) returns 5", async () => {
+    await Initialize(null);
+    assert.strictEqual(qc.Wallet.fromPhrase(TEST_SEED_WORDS_36).getKeyType(), 5);
+  });
+
+  it("getKeyType: throws for unsupported public key size", async () => {
+    await Initialize(null);
+    const w = qc.Wallet.fromPhrase(TEST_SEED_WORDS_32);
+    (w.signingKey as any).publicKeyBytes = new Uint8Array(100);
+    assert.throws(() => w.getKeyType(), /unsupported public key size/);
+  });
 });

package/test/unit/providers.test.js

@@ -10,6 +10,7 @@
  const assert = require("node:assert/strict");
  
  const qc = require("../../index");
+ const { Initialize } = require("../../config");
  const { logSuite, logTest } = require("../verbose-logger");
  
  describe("JsonRpcProvider", () => {
@@ -249,4 +250,56 @@ describe("Extra providers", () => {
      assert.throws(() => new qc.FallbackProvider([]));
    });
  });
+
+describe("Provider.getFeeData", () => {
+  logSuite("Provider.getFeeData");
+
+  // Expected per-gas-unit prices (wei). BASE is keyType 3 (compact / context 0);
+  // keyType 3 full-sign is BASE x 30; keyType 5 is BASE x 20.
+  const FEE_BASE = 4761904761904760n;
+  const FEE_KT3_FULL = 142857142857142800n;
+  const FEE_KT5 = 95238095238095200n;
+
+  it("prices by keyType number", async () => {
+    logTest("prices by keyType number", {});
+    const p = new qc.JsonRpcProvider();
+    assert.strictEqual((await p.getFeeData(3)).gasPrice, FEE_BASE);
+    assert.strictEqual((await p.getFeeData(3, true)).gasPrice, FEE_KT3_FULL);
+    assert.strictEqual((await p.getFeeData(5)).gasPrice, FEE_KT5);
+    assert.strictEqual((await p.getFeeData(5, true)).gasPrice, FEE_KT5);
+  });
+
+  it("prices by wallet (reads keyType from wallet)", async () => {
+    logTest("prices by wallet", {});
+    await Initialize(null);
+    const p = new qc.JsonRpcProvider();
+
+    const w3 = qc.Wallet.createRandom(undefined, 3);
+    assert.strictEqual((await p.getFeeData(w3)).gasPrice, FEE_BASE);
+    assert.strictEqual((await p.getFeeData(w3, false)).gasPrice, FEE_BASE);
+    assert.strictEqual((await p.getFeeData(w3, null)).gasPrice, FEE_BASE);
+    assert.strictEqual((await p.getFeeData(w3, true)).gasPrice, FEE_KT3_FULL);
+
+    const w5 = qc.Wallet.createRandom(undefined, 5);
+    assert.strictEqual((await p.getFeeData(w5)).gasPrice, FEE_KT5);
+    assert.strictEqual((await p.getFeeData(w5, true)).gasPrice, FEE_KT5);
+  });
+
+  it("FeeData exposes only gasPrice (maxFeePerGas / maxPriorityFeePerGas unsupported)", async () => {
+    logTest("FeeData exposes only gasPrice", {});
+    const p = new qc.JsonRpcProvider();
+    const fd = await p.getFeeData(3);
+    assert.ok(fd instanceof qc.FeeData);
+    assert.strictEqual(fd.maxFeePerGas, undefined);
+    assert.strictEqual(fd.maxPriorityFeePerGas, undefined);
+  });
+
+  it("rejects invalid keyType and invalid first argument", async () => {
+    logTest("rejects invalid inputs", {});
+    const p = new qc.JsonRpcProvider();
+    await assert.rejects(() => p.getFeeData(99), /getGasPrice failed/);
+    await assert.rejects(() => p.getFeeData({}), /expected a Wallet or a keyType number/);
+    await assert.rejects(() => p.getFeeData(null), /expected a Wallet or a keyType number/);
+  });
+});
  

package/test/unit/providers.test.ts

@@ -9,6 +9,7 @@ import { describe, it } from "node:test";
 import assert from "node:assert/strict";
 
 import qc from "../../index";
+import { Initialize } from "../../config";
 import { logSuite, logTest } from "../verbose-logger";
 
 describe("JsonRpcProvider", () => {
@@ -249,3 +250,55 @@ describe("Extra providers", () => {
     assert.throws(() => new qc.FallbackProvider([]));
   });
 });
+
+describe("Provider.getFeeData", () => {
+  logSuite("Provider.getFeeData");
+
+  // Expected per-gas-unit prices (wei). BASE is keyType 3 (compact / context 0);
+  // keyType 3 full-sign is BASE x 30; keyType 5 is BASE x 20.
+  const FEE_BASE = 4761904761904760n;
+  const FEE_KT3_FULL = 142857142857142800n;
+  const FEE_KT5 = 95238095238095200n;
+
+  it("prices by keyType number", async () => {
+    logTest("prices by keyType number", {});
+    const p = new qc.JsonRpcProvider();
+    assert.strictEqual((await p.getFeeData(3)).gasPrice, FEE_BASE);
+    assert.strictEqual((await p.getFeeData(3, true)).gasPrice, FEE_KT3_FULL);
+    assert.strictEqual((await p.getFeeData(5)).gasPrice, FEE_KT5);
+    assert.strictEqual((await p.getFeeData(5, true)).gasPrice, FEE_KT5);
+  });
+
+  it("prices by wallet (reads keyType from wallet)", async () => {
+    logTest("prices by wallet", {});
+    await Initialize(null);
+    const p = new qc.JsonRpcProvider();
+
+    const w3 = qc.Wallet.createRandom(undefined, 3);
+    assert.strictEqual((await p.getFeeData(w3)).gasPrice, FEE_BASE);
+    assert.strictEqual((await p.getFeeData(w3, false)).gasPrice, FEE_BASE);
+    assert.strictEqual((await p.getFeeData(w3, null)).gasPrice, FEE_BASE);
+    assert.strictEqual((await p.getFeeData(w3, true)).gasPrice, FEE_KT3_FULL);
+
+    const w5 = qc.Wallet.createRandom(undefined, 5);
+    assert.strictEqual((await p.getFeeData(w5)).gasPrice, FEE_KT5);
+    assert.strictEqual((await p.getFeeData(w5, true)).gasPrice, FEE_KT5);
+  });
+
+  it("FeeData exposes only gasPrice (maxFeePerGas / maxPriorityFeePerGas unsupported)", async () => {
+    logTest("FeeData exposes only gasPrice", {});
+    const p = new qc.JsonRpcProvider();
+    const fd = await p.getFeeData(3);
+    assert.ok(fd instanceof qc.FeeData);
+    assert.strictEqual((fd as any).maxFeePerGas, undefined);
+    assert.strictEqual((fd as any).maxPriorityFeePerGas, undefined);
+  });
+
+  it("rejects invalid keyType and invalid first argument", async () => {
+    logTest("rejects invalid inputs", {});
+    const p = new qc.JsonRpcProvider();
+    await assert.rejects(() => p.getFeeData(99), /getGasPrice failed/);
+    await assert.rejects(() => p.getFeeData({} as any), /expected a Wallet or a keyType number/);
+    await assert.rejects(() => p.getFeeData(null as any), /expected a Wallet or a keyType number/);
+  });
+});