@wishknish/knishio-client-ts 0.7.6 → 0.7.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wishknish/knishio-client-ts",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "productName": "Knish.IO TypeScript SDK Client",
   "description": "TypeScript implementation of the Knish.IO SDK to consume Knish.IO GraphQL APIs with enhanced type safety.",
   "license": "GPL-3.0-or-later",

package/src/KnishIOClient.ts

@@ -433,6 +433,28 @@ export default class KnishIOClient {
     secret = secret || this.getSecret()
     bundle = bundle || this.getBundle()
 
+    // For non-USER source wallets (V/B isotopes), capture the current USER
+    // ContinuID position BEFORE overwriting the client's remainder wallet.
+    // This position is needed by addContinuIdAtom() for previousPosition metadata.
+    let continuIdPosition: string | null = null
+    if (sourceWallet && sourceWallet.token !== 'USER') {
+      if (this.lastMoleculeQuery &&
+        this.getRemainderWallet() &&
+        this.getRemainderWallet()?.token === 'USER' &&
+        this.lastMoleculeQuery.response() &&
+        this.lastMoleculeQuery.response()?.success()
+      ) {
+        // Carry-forward: use last successful USER remainder wallet position
+        continuIdPosition = this.getRemainderWallet()?.position || null
+        this.log('info', `KnishIOClient::createMolecule() - Captured USER ContinuID position ${continuIdPosition?.substring(0, 16)}... for non-USER source wallet`)
+      } else {
+        // Query server for current ContinuID position
+        const userWallet = await this.getSourceWallet()
+        continuIdPosition = userWallet?.position || null
+        this.log('info', `KnishIOClient::createMolecule() - Queried USER ContinuID position ${continuIdPosition?.substring(0, 16)}... for non-USER source wallet`)
+      }
+    }
+
     // Sets the source wallet as the last remainder wallet (to maintain ContinuID)
     if (!sourceWallet &&
       this.lastMoleculeQuery &&
@@ -463,7 +485,8 @@ export default class KnishIOClient {
       sourceWallet,
       remainderWallet: this.getRemainderWallet()!,
       cellSlug: this.getCellSlug(),
-      version: this.getServerSdkVersion()
+      version: this.getServerSdkVersion(),
+      continuIdPosition
     })
   }
 
@@ -1496,9 +1519,13 @@ export default class KnishIOClient {
       })
     }
 
-    // Create molecule with the source wallet (same pattern as transferToken)
+    // Create remainder wallet from source (must be same token for V-isotope conservation)
+    const remainderWallet = sourceWallet.createRemainder(this.getSecret())
+
+    // Create molecule with the token-specific source and remainder wallets
     const molecule = await this.createMolecule({
-      sourceWallet
+      sourceWallet,
+      remainderWallet
     })
 
     // Create a transfer to null address (burn)
@@ -1955,8 +1982,20 @@ export default class KnishIOClient {
       })
     }
 
+    // Create remainder wallet from source (must be same token)
+    const remainderWallet = sourceWallet.createRemainder(this.getSecret())
+
+    // Build the molecule with the token-specific source and remainder wallets
+    const molecule = await this.createMolecule({
+      sourceWallet,
+      remainderWallet
+    })
+
     // Create the molecule mutation
-    const mutation = await this.createMoleculeMutation({ mutationClass: MutationDepositBufferToken })
+    const mutation = await this.createMoleculeMutation({
+      mutationClass: MutationDepositBufferToken,
+      molecule
+    })
 
     // Initialize the deposit buffer token mutation
     await mutation.fillMolecule({

package/src/core/Molecule.ts

@@ -78,6 +78,7 @@ export default class Molecule {
   public remainderWallet: Wallet | null
   public atoms: Atom[]
   public version: string | null | undefined
+  public continuIdPosition: string | null
   public parentHashes: string[]
   public local?: number
 
@@ -91,7 +92,8 @@ export default class Molecule {
     sourceWallet = null,
     remainderWallet = null,
     cellSlug = null,
-    version = null
+    version = null,
+    continuIdPosition = null
   }: {
     secret?: string | null
     bundle?: string | null
@@ -99,6 +101,7 @@ export default class Molecule {
     remainderWallet?: Wallet | null
     cellSlug?: string | null
     version?: string | number | null
+    continuIdPosition?: string | null
   } = {}) {
     this.status = null
     this.molecularHash = null
@@ -107,6 +110,7 @@ export default class Molecule {
     this.secret = secret
     this.bundle = bundle
     this.sourceWallet = sourceWallet
+    this.continuIdPosition = continuIdPosition
     this.atoms = []
     this.parentHashes = []
 
@@ -209,8 +213,12 @@ export default class Molecule {
     // ContinuID metadata for chain integrity validation
     const continuIdMeta: Record<string, any> = {}
 
-    // previousPosition: the source wallet's position being consumed
-    if (this.sourceWallet && this.sourceWallet.position) {
+    // previousPosition: the current USER ContinuID position being consumed.
+    // For non-USER source wallets (V/B isotopes), use the explicitly passed
+    // continuIdPosition from createMolecule() instead of the TOKEN wallet position.
+    if (this.continuIdPosition) {
+      continuIdMeta.previousPosition = this.continuIdPosition
+    } else if (this.sourceWallet && this.sourceWallet.position) {
       continuIdMeta.previousPosition = this.sourceWallet.position
     }
 
@@ -661,13 +669,29 @@ export default class Molecule {
       throw new BalanceInsufficientException()
     }
 
-    // Burn tokens by removing from source (matching JS SDK)
+    // Create burn address wallet (null bundle = token destruction)
+    const burnWallet = new Wallet({
+      bundle: '0000000000000000000000000000000000000000000000000000000000000000',
+      token: this.sourceWallet.token
+    })
+
+    // V-atom 1: Debit full balance from source
     this.addAtom(Atom.create({
       isotope: 'V',
       wallet: this.sourceWallet,
-      value: -amount
+      value: -Number(this.sourceWallet.balance)
+    }))
+
+    // V-atom 2: Credit burn amount to burn address
+    this.addAtom(Atom.create({
+      isotope: 'V',
+      wallet: burnWallet,
+      value: amount,
+      metaType: 'walletBundle',
+      metaId: burnWallet.bundle!
     }))
-    // Remainder atom (matching JS SDK)
+
+    // V-atom 3: Remainder back to source identity
     this.addAtom(Atom.create({
       isotope: 'V',
       wallet: this.remainderWallet!,