@wishknish/knishio-client-ts 0.9.2 → 0.9.4

package/dist/index.cjs

@@ -1849,11 +1849,15 @@ function hexToBase64(hexString) {
   try {
     const cleanHex = hexString.replace(/^0x/i, "");
     const bytes = hexStringToBuffer(cleanHex);
-    if (typeof btoa !== "undefined") {
-      return btoa(String.fromCharCode(...bytes));
-    } else {
+    if (typeof Buffer !== "undefined") {
       return Buffer.from(bytes).toString("base64");
     }
+    let binary = "";
+    const CHUNK_SIZE = 32768;
+    for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {
+      binary += String.fromCharCode(...bytes.subarray(i, i + CHUNK_SIZE));
+    }
+    return btoa(binary);
   } catch (error) {
     throw new Error(`Failed to convert hex to base64: ${error instanceof Error ? error.message : String(error)}`);
   }
@@ -3811,11 +3815,26 @@ var Wallet = class _Wallet {
     return new Uint8Array(decryptedContent);
   }
   serializeKey(key) {
-    return btoa(String.fromCharCode(...key));
+    if (typeof Buffer !== "undefined") {
+      return Buffer.from(key).toString("base64");
+    }
+    let binary = "";
+    const CHUNK_SIZE = 32768;
+    for (let i = 0; i < key.length; i += CHUNK_SIZE) {
+      binary += String.fromCharCode(...key.subarray(i, i + CHUNK_SIZE));
+    }
+    return btoa(binary);
   }
   deserializeKey(serializedKey) {
+    if (typeof Buffer !== "undefined") {
+      return new Uint8Array(Buffer.from(serializedKey, "base64"));
+    }
     const binaryString = atob(serializedKey);
-    return new Uint8Array([...binaryString].map((char) => char.charCodeAt(0)));
+    const bytes = new Uint8Array(binaryString.length);
+    for (let i = 0; i < binaryString.length; i++) {
+      bytes[i] = binaryString.charCodeAt(i);
+    }
+    return bytes;
   }
 };
 var hexStringRegex = /^[0-9a-fA-F]+$/;
@@ -4182,10 +4201,11 @@ function deepCloning(o, h) {
   return r || o;
 }
 function chunkArray(arr, size) {
-  if (!arr.length) {
-    return [];
+  const chunks = [];
+  for (let i = 0; i < arr.length; i += size) {
+    chunks.push(arr.slice(i, i + size));
   }
-  return [arr.slice(0, size)].concat(chunkArray(arr.slice(size), size));
+  return chunks;
 }
 function diff(...arrays) {
   return [].concat(...arrays.map((arr, i) => {
@@ -4473,7 +4493,7 @@ var CheckMolecule = class _CheckMolecule {
    * @return True if all validations pass
    */
   verify(senderWallet) {
-    return this.molecularHash() && this.ots() && this.batchId() && this.continuId() && this.isotopeM() && this.isotopeT() && this.isotopeC() && this.isotopeU() && this.isotopeI() && this.isotopeR() && this.isotopeV(senderWallet || null);
+    return this.molecularHash() && this.ots() && this.batchId() && this.continuId() && this.isotopeM() && this.isotopeT() && this.isotopeC() && this.isotopeU() && this.isotopeI() && this.isotopeR() && this.isotopeP() && this.isotopeA() && this.isotopeB() && this.isotopeF() && this.isotopeV(senderWallet || null);
   }
   /**
    * Validate ContinuID requirement
@@ -4661,6 +4681,141 @@ var CheckMolecule = class _CheckMolecule {
     }
     return true;
   }
+  /**
+   * Validate isotope P atoms (peering)
+   * @return True if valid
+   * @throws WrongTokenTypeException if the token slug is not USER
+   * @throws MetaMissingException if the required peerHost meta field is absent
+   */
+  isotopeP() {
+    for (const atom of this.molecule.getIsotopes("P")) {
+      if (atom.token !== "USER") {
+        throw new WrongTokenTypeException(`Check::isotopeP() - "${atom.token}" is not a valid Token slug for "${atom.isotope}" isotope Atoms!`);
+      }
+      const metas = atom.aggregatedMeta();
+      if (!Object.prototype.hasOwnProperty.call(metas, "peerHost") || !metas.peerHost) {
+        throw new MetaMissingException('Check::isotopeP() - Required meta field "peerHost" is missing!');
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate isotope A atoms (append request)
+   * @return True if valid
+   * @throws WrongTokenTypeException if the token slug is not USER
+   * @throws MetaMissingException if metaType, metaId or the action meta field is absent
+   */
+  isotopeA() {
+    for (const atom of this.molecule.getIsotopes("A")) {
+      if (atom.token !== "USER") {
+        throw new WrongTokenTypeException(`Check::isotopeA() - "${atom.token}" is not a valid Token slug for "${atom.isotope}" isotope Atoms!`);
+      }
+      if (!atom.metaType) {
+        throw new MetaMissingException('Check::isotopeA() - Required field "metaType" is missing!');
+      }
+      if (!atom.metaId) {
+        throw new MetaMissingException('Check::isotopeA() - Required field "metaId" is missing!');
+      }
+      const metas = atom.aggregatedMeta();
+      if (!Object.prototype.hasOwnProperty.call(metas, "action") || !metas.action) {
+        throw new MetaMissingException('Check::isotopeA() - Required meta field "action" is missing!');
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate isotope B atoms (buffer/exchange)
+   *
+   * Buffer molecules are cross-isotope: their V atoms do not balance on their own
+   * because a B atom absorbs the difference. isotopeV() therefore skips its V-only
+   * conservation checks whenever B (or F) atoms are present, and conservation is
+   * enforced here instead over the combined V+B set.
+   *
+   * @return True if valid
+   * @throws MetaMissingException if metaType is not walletBundle, or metaId is absent
+   * @throws TransferMalformedException if a B atom value is not a number
+   * @throws TransferUnbalancedException if V+B atom values do not sum to zero
+   */
+  isotopeB() {
+    const isotopeB = this.molecule.getIsotopes("B");
+    if (isotopeB.length === 0) {
+      return true;
+    }
+    for (const atom of isotopeB) {
+      if (!atom.metaType || atom.metaType !== "walletBundle") {
+        throw new MetaMissingException('Check::isotopeB() - B-isotope atoms must have metaType "walletBundle"!');
+      }
+      if (!atom.metaId) {
+        throw new MetaMissingException("Check::isotopeB() - B-isotope atoms must have a metaId!");
+      }
+      const value = atom.value !== null ? Number(atom.value) : Number.NaN;
+      if (Number.isNaN(value)) {
+        throw new TransferMalformedException("Check::isotopeB() - B-isotope atom value is not a valid number!");
+      }
+    }
+    const vAtoms = this.molecule.getIsotopes("V");
+    if (vAtoms.length > 0) {
+      let sum = 0;
+      for (const atom of [...vAtoms, ...isotopeB]) {
+        const value = atom.value !== null ? Number(atom.value) : Number.NaN;
+        if (!Number.isNaN(value)) {
+          sum += value;
+        }
+      }
+      if (sum !== 0) {
+        throw new TransferUnbalancedException("Check::isotopeB() - V+B atom values do not balance to zero!");
+      }
+    }
+    return true;
+  }
+  /**
+   * Validate isotope F atoms (fusion/NFT)
+   *
+   * Mirrors isotopeB() and additionally forbids negative values. Must stay paired
+   * with the hasCrossIsotope gate in isotopeV(), which is keyed on B *or* F: without
+   * this check an F-isotope molecule would skip V-only conservation with nothing
+   * validating V+F conservation in its place.
+   *
+   * @return True if valid
+   * @throws MetaMissingException if metaType is not walletBundle, or metaId is absent
+   * @throws TransferMalformedException if an F atom value is not a number, or is negative
+   * @throws TransferUnbalancedException if V+F atom values do not sum to zero
+   */
+  isotopeF() {
+    const isotopeF = this.molecule.getIsotopes("F");
+    if (isotopeF.length === 0) {
+      return true;
+    }
+    for (const atom of isotopeF) {
+      if (!atom.metaType || atom.metaType !== "walletBundle") {
+        throw new MetaMissingException('Check::isotopeF() - F-isotope atoms must have metaType "walletBundle"!');
+      }
+      if (!atom.metaId) {
+        throw new MetaMissingException("Check::isotopeF() - F-isotope atoms must have a metaId!");
+      }
+      const value = atom.value !== null ? Number(atom.value) : Number.NaN;
+      if (Number.isNaN(value)) {
+        throw new TransferMalformedException("Check::isotopeF() - F-isotope atom value is not a valid number!");
+      }
+      if (value < 0) {
+        throw new TransferMalformedException("Check::isotopeF() - F-isotope atom value must not be negative!");
+      }
+    }
+    const vAtoms = this.molecule.getIsotopes("V");
+    if (vAtoms.length > 0) {
+      let sum = 0;
+      for (const atom of [...vAtoms, ...isotopeF]) {
+        const value = atom.value !== null ? Number(atom.value) : Number.NaN;
+        if (!Number.isNaN(value)) {
+          sum += value;
+        }
+      }
+      if (sum !== 0) {
+        throw new TransferUnbalancedException("Check::isotopeF() - V+F atom values do not balance to zero!");
+      }
+    }
+    return true;
+  }
   /**
    * Validate isotope V atoms (value transfers)
    * @param senderWallet - Optional wallet for balance validation
@@ -4672,11 +4827,12 @@ var CheckMolecule = class _CheckMolecule {
     if (isotopeV.length === 0) {
       return true;
     }
+    const hasCrossIsotope = this.molecule.getIsotopes("B").length > 0 || this.molecule.getIsotopes("F").length > 0;
     const firstAtom = this.molecule.atoms[0];
     if (!firstAtom) {
       throw new exports.AtomsMissingException("Check::isotopeV() - Missing first atom");
     }
-    if (firstAtom.isotope === "V" && isotopeV.length === 2) {
+    if (!hasCrossIsotope && firstAtom.isotope === "V" && isotopeV.length === 2) {
       const endAtom = isotopeV[isotopeV.length - 1];
       if (!endAtom) {
         throw new exports.AtomsMissingException("Check::isotopeV() - Missing end atom");
@@ -4688,6 +4844,10 @@ var CheckMolecule = class _CheckMolecule {
       if (endValue < 0) {
         throw new TransferMalformedException();
       }
+      const firstValueForPair = firstAtom.value !== null ? Number(firstAtom.value) : 0;
+      if (firstValueForPair + endValue !== 0) {
+        throw new TransferUnbalancedException();
+      }
       return true;
     }
     let sum = 0;
@@ -4716,7 +4876,7 @@ var CheckMolecule = class _CheckMolecule {
         sum += value;
       }
     }
-    if (sum !== 0) {
+    if (!hasCrossIsotope && sum !== 0) {
       throw new TransferUnbalancedException();
     }
     if (senderWallet) {
@@ -4728,7 +4888,7 @@ var CheckMolecule = class _CheckMolecule {
       if (remainder < 0) {
         throw new exports.TransferBalanceException();
       }
-      if (remainder !== sum) {
+      if (!hasCrossIsotope && remainder !== sum) {
         throw new TransferRemainderException();
       }
     } else if (sum !== 0) {
@@ -7013,6 +7173,7 @@ var ValidationChainBuilder = class {
   constructor(service) {
     this.service = service;
   }
+  service;
   validators = [];
   /**
    * Add a schema validation step