@neuraiproject/neurai-assets 1.2.0 → 1.2.2

package/dist/NeuraiAssets.global.js

@@ -4172,7 +4172,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      addresses === undefined
 		    ) {
 		      network = networkOrParams.network;
-		      actualAddresses = networkOrParams.addresses;
+		      actualAddresses = networkOrParams.walletAddresses || networkOrParams.addresses;
 		      actualParams = networkOrParams;
 		    } else {
 		      network = networkOrParams;
@@ -4376,23 +4376,163 @@ var NeuraiAssetsBundle = (function (exports) {
 		  }
 
 		  /**
-		   * Convert amount to satoshis
-		   * @param {number} amount - Amount in asset units
-		   * @param {number} units - Decimal places
-		   * @returns {number} Amount in satoshis
+		   * Convert asset amount to protocol raw units.
+		   * Asset raw quantities in transaction payloads are always encoded with
+		   * 8 decimal places, regardless of the asset's displayed `units`.
+		   *
+		   * @param {number} amount - User-facing asset amount
+		   * @param {number} units - Asset decimal places (kept for API compatibility)
+		   * @returns {number} Amount in protocol raw units
 		   */
 		  toSatoshis(amount, units) {
-		    return Math.round(amount * Math.pow(10, units));
+		    return Math.round(amount * 100000000);
 		  }
 
 		  /**
-		   * Convert satoshis to amount
-		   * @param {number} satoshis - Amount in satoshis
-		   * @param {number} units - Decimal places
+		   * Convert protocol raw units back to a user-facing asset amount.
+		   *
+		   * @param {number} satoshis - Amount in protocol raw units
+		   * @param {number} units - Asset decimal places (kept for API compatibility)
 		   * @returns {number} Amount in asset units
 		   */
 		  fromSatoshis(satoshis, units) {
-		    return satoshis / Math.pow(10, units);
+		    return satoshis / 100000000;
+		  }
+
+		  /**
+		   * Normalize builder inputs to raw transaction inputs
+		   * @param {Array} inputs - Builder inputs
+		   * @returns {Array<{txid: string, vout: number}>} Raw transaction inputs
+		   */
+		  toRawTxInputs(inputs) {
+		    return (inputs || []).map(input => ({
+		      txid: input.txid,
+		      vout: input.vout !== undefined ? input.vout : input.outputIndex
+		    }));
+		  }
+
+		  /**
+		   * Convert XNA amount to satoshis
+		   * @param {number|null|undefined} amount - Amount in XNA
+		   * @returns {number|undefined} Amount in satoshis
+		   */
+		  xnaToSatoshis(amount) {
+		    if (amount === undefined || amount === null) {
+		      return undefined;
+		    }
+
+		    return Math.round(amount * 100000000);
+		  }
+
+		  /**
+		   * Build a typed local raw build payload compatible with
+		   * @neuraiproject/neurai-create-transaction createFromOperation(...)
+		   *
+		   * @param {string} operationType - Operation type
+		   * @param {Array} inputs - Builder inputs
+		   * @param {object|null} burnInfo - Burn metadata
+		   * @param {string|null} changeAddress - XNA change address
+		   * @param {number|null} changeAmount - XNA change amount in XNA
+		   * @param {object} operationParams - Operation-specific params
+		   * @returns {{ operationType: string, params: object }} Local raw build
+		   */
+		  buildLocalRawBuild(
+		    operationType,
+		    inputs,
+		    burnInfo = null,
+		    changeAddress = null,
+		    changeAmount = null,
+		    operationParams = {}
+		  ) {
+		    const params = {
+		      inputs: this.toRawTxInputs(inputs),
+		      ...operationParams
+		    };
+
+		    if (burnInfo && burnInfo.address && burnInfo.amount !== undefined && burnInfo.amount !== null) {
+		      params.burnAddress = burnInfo.address;
+		      params.burnAmountSats = this.xnaToSatoshis(burnInfo.amount);
+		    }
+
+		    if (changeAddress && changeAmount !== undefined && changeAmount !== null) {
+		      params.xnaChangeAddress = changeAddress;
+		      params.xnaChangeSats = this.xnaToSatoshis(changeAmount);
+		    }
+
+		    return {
+		      operationType,
+		      params
+		    };
+		  }
+
+		  /**
+		   * Normalize ordered outputs into flat entries
+		   * @param {Array|object} outputs - Transaction outputs
+		   * @returns {Array<{address: string, value: unknown}>} Output entries
+		   */
+		  getOutputEntries(outputs) {
+		    if (Array.isArray(outputs)) {
+		      return outputs.map(output => {
+		        const [address, value] = Object.entries(output)[0];
+		        return { address, value };
+		      });
+		    }
+
+		    if (outputs && typeof outputs === 'object') {
+		      return Object.entries(outputs).map(([address, value]) => ({ address, value }));
+		    }
+
+		    return [];
+		  }
+
+		  /**
+		   * Extract burn metadata from outputs
+		   * @param {Array<{address: string, value: unknown}>} entries - Output entries
+		   * @param {number} burnAmount - Burn amount in XNA
+		   * @returns {{ burnAddress: string|null, burnAmount: number }}
+		   */
+		  extractBurnMetadata(entries, burnAmount) {
+		    if (!burnAmount || burnAmount <= 0) {
+		      return {
+		        burnAddress: null,
+		        burnAmount: 0
+		      };
+		    }
+
+		    const burnEntry = entries.find(({ address, value }) => {
+		      return typeof value === 'number' &&
+		        value === burnAmount &&
+		        this.burnManager.isBurnAddress(address);
+		    });
+
+		    return {
+		      burnAddress: burnEntry ? burnEntry.address : null,
+		      burnAmount
+		    };
+		  }
+
+		  /**
+		   * Extract XNA change metadata from outputs
+		   * @param {Array<{address: string, value: unknown}>} entries - Output entries
+		   * @param {string|null} burnAddress - Burn address if present
+		   * @returns {{ changeAddress: string|null, changeAmount: number|null }}
+		   */
+		  extractChangeMetadata(entries, burnAddress = null) {
+		    const xnaOutputs = entries.filter(({ address, value }) => {
+		      return typeof value === 'number' && address !== burnAddress;
+		    });
+
+		    if (xnaOutputs.length !== 1) {
+		      return {
+		        changeAddress: null,
+		        changeAmount: null
+		      };
+		    }
+
+		    return {
+		      changeAddress: xnaOutputs[0].address,
+		      changeAmount: xnaOutputs[0].value
+		    };
 		  }
 
 		  /**
@@ -4407,13 +4547,26 @@ var NeuraiAssetsBundle = (function (exports) {
 		   * @returns {object} Formatted result
 		   */
 		  formatResult(rawTx, utxos, inputs, outputs, fee, burnAmount, extra = {}) {
+		    const outputEntries = this.getOutputEntries(outputs);
+		    const burnMetadata = this.extractBurnMetadata(outputEntries, burnAmount);
+		    const changeMetadata = this.extractChangeMetadata(outputEntries, burnMetadata.burnAddress);
+
 		    return {
 		      rawTx,
 		      utxos,
 		      inputs,
 		      outputs,
 		      fee,
-		      burnAmount,
+		      burnAmount: burnMetadata.burnAmount,
+		      network: this.network,
+		      buildStrategy: 'rpc-node',
+		      burnAddress: burnMetadata.burnAddress,
+		      changeAddress: extra.changeAddress !== undefined
+		        ? extra.changeAddress
+		        : changeMetadata.changeAddress,
+		      changeAmount: extra.changeAmount !== undefined
+		        ? extra.changeAmount
+		        : changeMetadata.changeAmount,
 		      ...extra
 		    };
 		  }
@@ -4630,7 +4783,23 @@ var NeuraiAssetsBundle = (function (exports) {
 		      {
 		        assetName,
 		        ownerTokenName: assetName + '!',
-		        operationType: 'ISSUE_ROOT'
+		        operationType: 'ISSUE_ROOT',
+		        localRawBuild: this.buildLocalRawBuild(
+		          'ISSUE_ROOT',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            toAddress,
+		            assetName,
+		            quantityRaw: this.toSatoshis(quantity, units),
+		            units,
+		            reissuable,
+		            ipfsHash: hasIpfs ? ipfsHash : undefined,
+		            ownerTokenAddress: changeAddress
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -4876,7 +5045,23 @@ var NeuraiAssetsBundle = (function (exports) {
 		        parentAssetName,
 		        ownerTokenName: assetName + '!',
 		        parentOwnerTokenUsed: ownerTokenName,
-		        operationType: 'ISSUE_SUB'
+		        operationType: 'ISSUE_SUB',
+		        localRawBuild: this.buildLocalRawBuild(
+		          'ISSUE_SUB',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            toAddress,
+		            assetName,
+		            quantityRaw: this.toSatoshis(quantity, units),
+		            units,
+		            reissuable,
+		            ipfsHash: hasIpfs ? ipfsHash : undefined,
+		            parentOwnerAddress: changeAddress
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -5029,7 +5214,22 @@ var NeuraiAssetsBundle = (function (exports) {
 		      {
 		        assetName,
 		        ownerTokenName: `${assetName}!`,
-		        operationType: 'ISSUE_DEPIN'
+		        operationType: 'ISSUE_DEPIN',
+		        localRawBuild: this.buildLocalRawBuild(
+		          'ISSUE_DEPIN',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            toAddress,
+		            assetName,
+		            quantityRaw: this.toSatoshis(quantity, 0),
+		            ipfsHash: hasIpfs ? ipfsHash : undefined,
+		            ownerTokenAddress: changeAddress,
+		            reissuable
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -5277,7 +5477,23 @@ var NeuraiAssetsBundle = (function (exports) {
 		        newTotalSupply,
 		        previousSupply: currentSupply,
 		        reissuableLocked: reissuable === false,
-		        operationType: 'REISSUE'
+		        operationType: 'REISSUE',
+		        localRawBuild: this.buildLocalRawBuild(
+		          'REISSUE',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            toAddress,
+		            assetName,
+		            quantityRaw: this.toSatoshis(quantity, units),
+		            units,
+		            reissuable: reissuable !== undefined ? reissuable : undefined,
+		            ipfsHash: newIpfs || undefined,
+		            ownerChangeAddress: isDepinAsset ? toAddress : changeAddress
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -5534,7 +5750,21 @@ var NeuraiAssetsBundle = (function (exports) {
 		        createdNFTs,
 		        nftCount,
 		        ownerTokenUsed: ownerTokenName,
-		        operationType: 'ISSUE_UNIQUE'
+		        operationType: 'ISSUE_UNIQUE',
+		        localRawBuild: this.buildLocalRawBuild(
+		          'ISSUE_UNIQUE',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            toAddress,
+		            rootName,
+		            assetTags,
+		            ipfsHashes: ipfsHashes.length > 0 ? ipfsHashes : undefined,
+		            ownerTokenAddress: changeAddress
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -5749,11 +5979,13 @@ var NeuraiAssetsBundle = (function (exports) {
 		    // Last: Issue qualifier operation
 		    const issueQualifierOutput = OutputFormatter.formatIssueQualifierOutput({
 		      asset_name: assetName,
-		      asset_quantity: quantity,
+		      asset_quantity: this.toSatoshis(quantity, 0),
 		      has_ipfs: hasIpfs,
 		      ipfs_hash: ipfsHash,
 		      root_change_address: isSub ? changeAddress : undefined,
-		      change_quantity: isSub ? parentQualifierQuantity : undefined
+		      change_quantity: isSub && parentQualifierQuantity !== null
+		        ? this.toSatoshis(parentQualifierQuantity, 0)
+		        : undefined
 		    });
 
 		    outputs.push({ [toAddress]: issueQualifierOutput });
@@ -5779,7 +6011,24 @@ var NeuraiAssetsBundle = (function (exports) {
 		        qualifierType: isSub ? 'SUB_QUALIFIER' : 'QUALIFIER',
 		        parentQualifier: isSub ? parsed.parent : null,
 		        parentQualifierUsed: parentQualifierName,
-		        operationType: isSub ? 'ISSUE_SUB_QUALIFIER' : 'ISSUE_QUALIFIER'
+		        operationType: isSub ? 'ISSUE_SUB_QUALIFIER' : 'ISSUE_QUALIFIER',
+		        localRawBuild: this.buildLocalRawBuild(
+		          isSub ? 'ISSUE_SUB_QUALIFIER' : 'ISSUE_QUALIFIER',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            toAddress,
+		            assetName,
+		            quantityRaw: this.toSatoshis(quantity, 0),
+		            ipfsHash: hasIpfs ? ipfsHash : undefined,
+		            rootChangeAddress: isSub ? changeAddress : undefined,
+		            changeQuantityRaw: isSub && parentQualifierQuantity !== null
+		              ? this.toSatoshis(parentQualifierQuantity, 0)
+		              : undefined
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -6009,7 +6258,24 @@ var NeuraiAssetsBundle = (function (exports) {
 		        ownerTokenName,
 		        verifierString,
 		        requiredQualifiers,
-		        operationType: 'ISSUE_RESTRICTED'
+		        operationType: 'ISSUE_RESTRICTED',
+		        localRawBuild: this.buildLocalRawBuild(
+		          'ISSUE_RESTRICTED',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            toAddress,
+		            assetName,
+		            quantityRaw: this.toSatoshis(quantity, units),
+		            verifierString,
+		            units,
+		            reissuable,
+		            ipfsHash: hasIpfs ? ipfsHash : undefined,
+		            ownerChangeAddress: changeAddress
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -6272,7 +6538,24 @@ var NeuraiAssetsBundle = (function (exports) {
 		        newVerifier: changeVerifier ? newVerifier : undefined,
 		        requiredQualifiers,
 		        reissuableLocked: reissuable === false,
-		        operationType: 'REISSUE_RESTRICTED'
+		        operationType: 'REISSUE_RESTRICTED',
+		        localRawBuild: this.buildLocalRawBuild(
+		          'REISSUE_RESTRICTED',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            toAddress,
+		            assetName,
+		            quantityRaw: this.toSatoshis(quantity, assetData.units || 0),
+		            units: assetData.units || 0,
+		            reissuable: reissuable !== undefined ? reissuable : undefined,
+		            ipfsHash: newIpfs || undefined,
+		            ownerChangeAddress: this.params.ownerChangeAddress || changeAddress,
+		            verifierString: changeVerifier ? newVerifier : undefined
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -6464,12 +6747,12 @@ var NeuraiAssetsBundle = (function (exports) {
 		      ? OutputFormatter.formatUntagAddressesOutput({
 		          qualifier: qualifierName,
 		          addresses: targetAddresses,
-		          change_quantity: qualifierQuantity
+		          change_quantity: this.toSatoshis(qualifierQuantity, 0)
 		        })
 		      : OutputFormatter.formatTagAddressesOutput({
 		          qualifier: qualifierName,
 		          addresses: targetAddresses,
-		          change_quantity: qualifierQuantity
+		          change_quantity: this.toSatoshis(qualifierQuantity, 0)
 		        });
 
 		    outputs.push({ [changeAddress]: operationOutput });
@@ -6495,7 +6778,20 @@ var NeuraiAssetsBundle = (function (exports) {
 		        qualifierAssetUsed: qualifierName,
 		        targetAddresses,
 		        addressCount,
-		        operationType: isUntag ? 'UNTAG_ADDRESSES' : 'TAG_ADDRESSES'
+		        operationType: isUntag ? 'UNTAG_ADDRESSES' : 'TAG_ADDRESSES',
+		        localRawBuild: this.buildLocalRawBuild(
+		          isUntag ? 'UNTAG_ADDRESSES' : 'TAG_ADDRESSES',
+		          inputs,
+		          burnInfo,
+		          changeAddress,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          {
+		            qualifierName,
+		            targetAddresses,
+		            qualifierChangeAddress: changeAddress,
+		            qualifierChangeAmountRaw: this.toSatoshis(qualifierQuantity, 0)
+		          }
+		        )
 		      }
 		    );
 		  }
@@ -6742,7 +7038,24 @@ var NeuraiAssetsBundle = (function (exports) {
 		        ownerTokenUsed: ownerTokenName,
 		        targetAddresses: targetAddresses.length > 0 ? targetAddresses : null,
 		        addressCount: targetAddresses.length,
-		        operationType
+		        operationType,
+		        localRawBuild: this.buildLocalRawBuild(
+		          operationType,
+		          inputs,
+		          null,
+		          xnaChange > 0.00000001 ? changeAddress : null,
+		          xnaChange > 0.00000001 ? parseFloat(xnaChange.toFixed(8)) : null,
+		          operationType === 'FREEZE_ADDRESSES' || operationType === 'UNFREEZE_ADDRESSES'
+		            ? {
+		                assetName,
+		                targetAddresses,
+		                ownerChangeAddress: changeAddress
+		              }
+		            : {
+		                assetName,
+		                ownerChangeAddress: changeAddress
+		              }
+		        )
 		      }
 		    );
 		  }
@@ -6919,7 +7232,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		    return {
 		      ...params,
 		      network: this.config.network,
-		      addresses: this.config.addresses,
+		      walletAddresses: this.config.addresses,
 		      changeAddress: params.changeAddress || this.config.changeAddress,
 		      toAddress: params.toAddress || this.config.toAddress
 		    };