@wishknish/knishio-client-ts 0.9.3 → 0.9.4

package/dist/index.cjs

@@ -4493,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
@@ -4681,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
@@ -4692,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");
@@ -4708,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;
@@ -4736,7 +4876,7 @@ var CheckMolecule = class _CheckMolecule {
         sum += value;
       }
     }
-    if (sum !== 0) {
+    if (!hasCrossIsotope && sum !== 0) {
       throw new TransferUnbalancedException();
     }
     if (senderWallet) {
@@ -4748,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) {