@wishknish/knishio-client-js 0.6.4 → 0.7.5

package/src/Wallet.js

@@ -50,15 +50,16 @@ import {
   chunkSubstr,
   isHex,
   randomString
-} from './libraries/strings'
+} from './libraries/strings.js'
 import {
   generateBatchId,
   generateBundleHash,
-  generateSecret
-} from './libraries/crypto'
-import TokenUnit from './TokenUnit'
-import WalletCredentialException from './exception/WalletCredentialException'
-import { ml_kem768 as MlKEM768 } from '@noble/post-quantum/ml-kem'
+  generateSecret,
+  shake256
+} from './libraries/crypto.js'
+import TokenUnit from './TokenUnit.js'
+import WalletCredentialException from './exception/WalletCredentialException.js'
+import { ml_kem768 as MlKEM768 } from '@noble/post-quantum/ml-kem.js'
 
 /**
  * Wallet class represents the set of public and private
@@ -86,7 +87,7 @@ export default class Wallet {
     characters = null
   }) {
     this.token = token
-    this.balance = 0
+    this.balance = '0'
     this.molecules = {}
 
     // Empty values
@@ -207,11 +208,23 @@ export default class Wallet {
     token,
     position
   }) {
+    if (!secret) {
+      throw new WalletCredentialException('Wallet::generateKey() - Secret is required!')
+    }
+    if (!position) {
+      throw new WalletCredentialException('Wallet::generateKey() - Position is required!')
+    }
+
+    // Normalize non-hex secret via SHAKE256 (matching Rust/Kotlin behavior)
+    const secretHex = isHex(secret) ? secret : shake256(secret, 1024)
+    // Normalize non-hex position via SHAKE256
+    const positionHex = isHex(position) ? position : shake256(position, 256)
+
     // Converting secret to bigInt
-    const bigIntSecret = BigInt(`0x${ secret }`)
+    const bigIntSecret = BigInt(`0x${ secretHex }`)
 
     // Adding new position to the user secret to produce the indexed key
-    const indexedKey = bigIntSecret + BigInt(`0x${ position }`)
+    const indexedKey = bigIntSecret + BigInt(`0x${ positionHex }`)
 
     // Hashing the indexed key to produce the intermediate key
     const intermediateKeySponge = new JsSHA('SHAKE256', 'TEXT')
@@ -270,16 +283,18 @@ export default class Wallet {
    * Initializes the ML-KEM key pair
    */
   initializeMLKEM () {
-    // Generate a 64-byte (512-bit) seed from the Knish.IO private key
-    const seedHex = generateSecret(this.key, 64)
+    // Generate a 64-byte (512-bit) seed from the Knish.IO private key  
+    // Use deterministic approach: generateSecret(key, 128) → 128 hex chars = 64 bytes
+    const seedHex = generateSecret(this.key, 128)  // 128 hex chars = 64 bytes
 
-    // Convert the hex string to a Uint8Array
+    // Convert the hex string to a Uint8Array  
     const seed = new Uint8Array(64)
     for (let i = 0; i < 64; i++) {
       seed[i] = parseInt(seedHex.substr(i * 2, 2), 16)
     }
 
     const { publicKey, secretKey } = MlKEM768.keygen(seed)
+
     this.pubkey = this.serializeKey(publicKey)
     this.privkey = secretKey // Note: We're keeping privkey as UInt8Array for security
   }
@@ -293,6 +308,46 @@ export default class Wallet {
     return new Uint8Array(binaryString.length).map((_, i) => binaryString.charCodeAt(i))
   }
 
+  /**
+   * Returns balance as a Number for arithmetic operations.
+   * WARNING: Precision loss for values > 2^53.
+   *
+   * @return {number}
+   */
+  balanceAsNumber () {
+    return Number(this.balance)
+  }
+
+  /**
+   * Returns balance as a BigInt for precision-safe integer arithmetic.
+   * Truncates any fractional component.
+   *
+   * @return {bigint}
+   */
+  balanceAsBigInt () {
+    const str = String(this.balance)
+    const intPart = str.includes('.') ? str.split('.')[0] : str
+    return BigInt(intPart || '0')
+  }
+
+  /**
+   * Sets balance from a BigInt value
+   *
+   * @param {bigint} value
+   */
+  setBalanceBigInt (value) {
+    this.balance = value.toString()
+  }
+
+  /**
+   * Sets balance from a Number value, storing as String
+   *
+   * @param {number} value
+   */
+  setBalanceNumber (value) {
+    this.balance = String(value)
+  }
+
   /**
    *
    * @returns {*[]}

package/src/exception/AtomIndexException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Atoms must have an index so that they can be sorted in a Molecule

package/src/exception/AtomsMissingException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Empty molecules are not allowed

package/src/exception/AuthorizationRejectedException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when attempt to authorize is rejected by the node

package/src/exception/BalanceInsufficientException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when the node does not have enough tokens to fulfill a T request

package/src/exception/BatchIdException.js

@@ -1,4 +1,4 @@
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Generic code exception

package/src/exception/CodeException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Generic code exception

package/src/exception/DecryptionKeyException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Decryption key exception

package/src/exception/InvalidResponseException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Exception for bad GraphQL responses

package/src/exception/MetaMissingException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * M isotope atoms must always contain metadata

package/src/exception/MolecularHashMismatchException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Molecular hash does not match - contents may have been tampered with

package/src/exception/MolecularHashMissingException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * A molecular hash is always required.

package/src/exception/NegativeAmountException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when a negative amount is provided

package/src/exception/PolicyInvalidException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Exception for bad GraphQL responses

package/src/exception/SignatureMalformedException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when a molecular signature is malformed

package/src/exception/SignatureMismatchException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when signature does not match the public key

package/src/exception/StackableUnitAmountException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when a stackable token is being transferred with both unit IDs AND an amount specified (ambiguous)

package/src/exception/StackableUnitDecimalsException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when a stackable token is being created with units and non-zero decimals

package/src/exception/TransferBalanceException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when you try to transfer more tokens than you have available

package/src/exception/TransferMalformedException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when V isotope atoms are arranged incorrectly

package/src/exception/TransferMismatchedException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when the token slugs of wallets involved in a transfer do not match

package/src/exception/TransferRemainderException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when the remainder atom in a V isotope transfer is incorrect

package/src/exception/TransferToSelfException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when attempting to transfer tokens to yourself

package/src/exception/TransferUnbalancedException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when V isotope atom amounts do not add up to zero

package/src/exception/UnauthenticatedException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when attempting to transact without an auth token

package/src/exception/WalletCredentialException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when failing to retrieve shadow wallets

package/src/exception/WalletShadowException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when failing to retrieve shadow wallets

package/src/exception/WrongTokenTypeException.js

@@ -45,7 +45,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import BaseException from './BaseException'
+import BaseException from './BaseException.js'
 
 /**
  * Thrown when trying to use an inappropriate token slug for a particular isotope

package/src/exception/index.js

@@ -45,31 +45,31 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
-import AtomIndexException from './AtomIndexException'
-import AtomsMissingException from './AtomsMissingException'
-import AuthorizationRejectedException from './AuthorizationRejectedException'
-import BalanceInsufficientException from './BalanceInsufficientException'
-import BatchIdException from './BatchIdException'
-import CodeException from './CodeException'
-import InvalidResponseException from './InvalidResponseException'
-import MetaMissingException from './MetaMissingException'
-import MolecularHashMismatchException from './MolecularHashMismatchException'
-import MolecularHashMissingException from './MolecularHashMissingException'
-import NegativeAmountException from './NegativeAmountException'
-import PolicyInvalidException from './PolicyInvalidException'
-import SignatureMalformedException from './SignatureMalformedException'
-import SignatureMismatchException from './SignatureMismatchException'
-import StackableUnitAmountException from './StackableUnitAmountException'
-import StackableUnitDecimalsException from './StackableUnitDecimalsException'
-import TransferBalanceException from './TransferBalanceException'
-import TransferMalformedException from './TransferMalformedException'
-import TransferMismatchedException from './TransferMismatchedException'
-import TransferRemainderException from './TransferRemainderException'
-import TransferToSelfException from './TransferToSelfException'
-import TransferUnbalancedException from './TransferUnbalancedException'
-import UnauthenticatedException from './UnauthenticatedException'
-import WalletShadowException from './WalletShadowException'
-import WrongTokenTypeException from './WrongTokenTypeException'
+import AtomIndexException from './AtomIndexException.js'
+import AtomsMissingException from './AtomsMissingException.js'
+import AuthorizationRejectedException from './AuthorizationRejectedException.js'
+import BalanceInsufficientException from './BalanceInsufficientException.js'
+import BatchIdException from './BatchIdException.js'
+import CodeException from './CodeException.js'
+import InvalidResponseException from './InvalidResponseException.js'
+import MetaMissingException from './MetaMissingException.js'
+import MolecularHashMismatchException from './MolecularHashMismatchException.js'
+import MolecularHashMissingException from './MolecularHashMissingException.js'
+import NegativeAmountException from './NegativeAmountException.js'
+import PolicyInvalidException from './PolicyInvalidException.js'
+import SignatureMalformedException from './SignatureMalformedException.js'
+import SignatureMismatchException from './SignatureMismatchException.js'
+import StackableUnitAmountException from './StackableUnitAmountException.js'
+import StackableUnitDecimalsException from './StackableUnitDecimalsException.js'
+import TransferBalanceException from './TransferBalanceException.js'
+import TransferMalformedException from './TransferMalformedException.js'
+import TransferMismatchedException from './TransferMismatchedException.js'
+import TransferRemainderException from './TransferRemainderException.js'
+import TransferToSelfException from './TransferToSelfException.js'
+import TransferUnbalancedException from './TransferUnbalancedException.js'
+import UnauthenticatedException from './UnauthenticatedException.js'
+import WalletShadowException from './WalletShadowException.js'
+import WrongTokenTypeException from './WrongTokenTypeException.js'
 
 export {
   AtomIndexException,

package/src/index.js

@@ -46,11 +46,17 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
  */
 
-import Atom from './Atom'
-import Molecule from './Molecule'
-import Wallet from './Wallet'
-import Meta from './Meta'
-import KnishIOClient from './KnishIOClient'
+import Atom from './Atom.js'
+import Molecule from './Molecule.js'
+import Wallet from './Wallet.js'
+import Meta from './Meta.js'
+import KnishIOClient from './KnishIOClient.js'
+import MutationPeering from './mutation/MutationPeering.js'
+import MutationAppendRequest from './mutation/MutationAppendRequest.js'
+import QueryMetaTypeViaMolecule from './query/QueryMetaTypeViaMolecule.js'
+import ResponsePeering from './response/ResponsePeering.js'
+import ResponseAppendRequest from './response/ResponseAppendRequest.js'
+import ResponseMetaTypeViaMolecule from './response/ResponseMetaTypeViaMolecule.js'
 import {
   base64ToHex,
   bufferToHexString,
@@ -60,11 +66,12 @@ import {
   hexToBase64,
   isHex,
   randomString
-} from './libraries/strings'
+} from './libraries/strings.js'
 import {
   generateBundleHash,
-  generateSecret
-} from './libraries/crypto'
+  generateSecret,
+  shake256
+} from './libraries/crypto.js'
 
 export {
   Atom,
@@ -73,6 +80,18 @@ export {
   Meta,
   KnishIOClient,
 
+  // queries
+  QueryMetaTypeViaMolecule,
+
+  // mutations
+  MutationPeering,
+  MutationAppendRequest,
+
+  // responses
+  ResponsePeering,
+  ResponseAppendRequest,
+  ResponseMetaTypeViaMolecule,
+
   // strings
   chunkSubstr,
   base64ToHex,
@@ -85,5 +104,6 @@ export {
 
   // crypto
   generateSecret,
-  generateBundleHash
+  generateBundleHash,
+  shake256
 }

package/src/instance/Rules/Callback.js

@@ -46,11 +46,11 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
 
-import Meta from './Meta'
-import RuleArgumentException from './exception/RuleArgumentException'
-import { isNumeric } from '../../libraries/strings'
-import { intersect } from '../../libraries/array'
-import CodeException from '../../exception/CodeException'
+import Meta from './Meta.js'
+import RuleArgumentException from './exception/RuleArgumentException.js'
+import { isNumeric } from '../../libraries/strings.js'
+import { intersect } from '../../libraries/array.js'
+import CodeException from '../../exception/CodeException.js'
 
 export default class Callback {
   /**

package/src/instance/Rules/Condition.js

@@ -46,7 +46,7 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
 
-import RuleArgumentException from './exception/RuleArgumentException'
+import RuleArgumentException from './exception/RuleArgumentException.js'
 
 export default class Condition {
   /**

package/src/instance/Rules/Rule.js

@@ -46,10 +46,10 @@ Please visit https://github.com/WishKnish/KnishIO-Client-JS for information.
 License: https://github.com/WishKnish/KnishIO-Client-JS/blob/master/LICENSE
 */
 
-import Callback from './Callback'
-import Condition from './Condition'
-import RuleArgumentException from './exception/RuleArgumentException'
-import MetaMissingException from '../../exception/MetaMissingException'
+import Callback from './Callback.js'
+import Condition from './Condition.js'
+import RuleArgumentException from './exception/RuleArgumentException.js'
+import MetaMissingException from '../../exception/MetaMissingException.js'
 
 export default class Rule {
   /**

package/src/instance/Rules/exception/RuleArgumentException.js

@@ -1,4 +1,4 @@
-import BaseException from '../../../exception/BaseException'
+import BaseException from '../../../exception/BaseException.js'
 
 export default class RuleArgumentException extends BaseException {
   /**