@neuraiproject/neurai-assets 1.2.1 → 1.2.3

package/README.md

@@ -10,7 +10,7 @@ Complete asset management library for Neurai blockchain. Supports creation, reis
 - ✅ **RPC queries**: Complete wrapper for all asset query methods
 - ✅ **Client-side validation**: Prevents errors before creating transactions
 - ✅ **Owner token protection**: Validation to prevent permanent loss
-- ✅ **PQ-ready networks**: Supports `xna-pq` and `xna-pq-test` with `nq1...` / `tnq1...` addresses
+- ✅ **Legacy + AuthScript destinations**: Supports classic `N...` / `t...` and witness-v1 `nq1...` / `tnq1...` addresses
 
 ## Supported Asset Types
 
@@ -87,14 +87,14 @@ const signedTx = await wallet.signTransaction(result.rawTx);
 const txid = await wallet.broadcastTransaction(signedTx);
 ```
 
-You can also initialize the library with PQ networks and addresses:
+You can also initialize the library with AuthScript addresses:
 
 ```javascript
 const assetsPQ = new NeuraiAssets(rpc, {
-  network: 'xna-pq',                 // or 'xna-pq-test'
-  addresses: ['nq1yourpqaddress...'],
-  changeAddress: 'nq1yourpqchange...',
-  toAddress: 'nq1recipientpqaddress...'
+  network: 'xna',                    // 'xna-pq' / 'xna-pq-test' remain valid aliases
+  addresses: ['nq1yourauthscriptaddress...'],
+  changeAddress: 'nq1yourauthscriptchange...',
+  toAddress: 'nq1recipientauthscriptaddress...'
 });
 ```
 
@@ -148,8 +148,8 @@ const result = await assets.createDepinAsset({
 });
 ```
 
-> **Note**: DEPIN assets always use `units = 0`. The library accepts both legacy
-> and PQ addresses as recipients depending on the configured network.
+> **Note**: DEPIN assets always use `units = 0`. Recipient and change destinations
+> can be either legacy or AuthScript, as long as they belong to the same chain family.
 
 ### Create UNIQUE Assets (NFTs)
 
@@ -504,17 +504,17 @@ const assets = new NeuraiAssets(rpc, {
   toAddress: 't...'
 });
 
-// PQ Mainnet
+// AuthScript mainnet using the canonical network label
 const assetsPQ = new NeuraiAssets(rpc, {
-  network: 'xna-pq',
+  network: 'xna',
   addresses: ['nq1...'],
   changeAddress: 'nq1...',
   toAddress: 'nq1...'
 });
 
-// PQ Testnet
+// AuthScript testnet using the canonical network label
 const assetsPQTest = new NeuraiAssets(rpc, {
-  network: 'xna-pq-test',
+  network: 'xna-test',
   addresses: ['tnq1...'],
   changeAddress: 'tnq1...',
   toAddress: 'tnq1...'
@@ -523,13 +523,13 @@ const assetsPQTest = new NeuraiAssets(rpc, {
 
 The library accepts these network names:
 
-- `xna`: legacy/mainnet address flow (`N...`)
-- `xna-test`: legacy/testnet address flow (`t...`)
-- `xna-pq`: PQ mainnet address flow (`nq1...`)
-- `xna-pq-test`: PQ testnet address flow (`tnq1...`)
+- `xna`: mainnet chain family, valid for both legacy `N...` and AuthScript `nq1...`
+- `xna-test`: testnet chain family, valid for both legacy `t...` and AuthScript `tnq1...`
+- `xna-pq`: compatibility alias for AuthScript mainnet flows
+- `xna-pq-test`: compatibility alias for AuthScript testnet flows
 
-If you need to derive PQ addresses, use `neurai-key` and pass the resulting `nq1...`
-or `tnq1...` addresses into this library.
+If you need to derive AuthScript addresses, use `neurai-key` and pass the resulting
+`nq1...` or `tnq1...` addresses into this library.
 
 ## Update Configuration
 
@@ -648,6 +648,6 @@ const txid = await wallet.broadcastTransaction(signedTx);
 console.log('Transaction ID:', txid);
 ```
 
-For PQ wallets, derive addresses externally with `neurai-key` using `xna-pq` or
-`xna-pq-test`, then initialize `NeuraiAssets` with those addresses and the matching
-network name.
+For AuthScript wallets, derive addresses externally with `neurai-key`, then initialize
+`NeuraiAssets` with those `nq1...` / `tnq1...` addresses. The recommended network labels
+are `xna` and `xna-test`; `xna-pq` and `xna-pq-test` remain available as compatibility aliases.

package/dist/NeuraiAssets.global.js

@@ -1040,11 +1040,15 @@ var NeuraiAssetsBundle = (function (exports) {
 	function requireNetworks () {
 		if (hasRequiredNetworks) return networks;
 		hasRequiredNetworks = 1;
+		const MAINNET_NETWORKS = ['xna', 'mainnet', 'xna-pq', 'mainnet-pq'];
+		const TESTNET_NETWORKS = ['xna-test', 'testnet', 'regtest', 'xna-pq-test', 'testnet-pq'];
+
 		const NETWORKS = {
 		  MAINNET: {
 		    name: 'xna',
 		    displayName: 'Neurai Mainnet',
 		    addressPrefix: 'N',
+		    authScriptAddressPrefix: 'nq1',
 		    pqAddressPrefix: 'nq1',
 		    assetNameMaxLength: 32,
 		    defaultRPCPort: 19001,
@@ -1055,6 +1059,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		    name: 'xna-test',
 		    displayName: 'Neurai Testnet',
 		    addressPrefix: 't',
+		    authScriptAddressPrefix: 'tnq1',
 		    pqAddressPrefix: 'tnq1',
 		    assetNameMaxLength: 32,  // Same as mainnet
 		    defaultRPCPort: 19101,
@@ -1063,8 +1068,9 @@ var NeuraiAssetsBundle = (function (exports) {
 		  },
 		  MAINNET_PQ: {
 		    name: 'xna-pq',
-		    displayName: 'Neurai Mainnet PQ',
+		    displayName: 'Neurai Mainnet AuthScript',
 		    addressPrefix: 'N',
+		    authScriptAddressPrefix: 'nq1',
 		    pqAddressPrefix: 'nq1',
 		    assetNameMaxLength: 32,
 		    defaultRPCPort: 19001,
@@ -1073,8 +1079,9 @@ var NeuraiAssetsBundle = (function (exports) {
 		  },
 		  TESTNET_PQ: {
 		    name: 'xna-pq-test',
-		    displayName: 'Neurai Testnet PQ',
+		    displayName: 'Neurai Testnet AuthScript',
 		    addressPrefix: 't',
+		    authScriptAddressPrefix: 'tnq1',
 		    pqAddressPrefix: 'tnq1',
 		    assetNameMaxLength: 32,
 		    defaultRPCPort: 19101,
@@ -1144,32 +1151,68 @@ var NeuraiAssetsBundle = (function (exports) {
 
 		/**
 		 * Get network configuration
+		 * `xna-pq` / `xna-pq-test` are preserved as compatibility aliases for
+		 * AuthScript address flows on the same mainnet/testnet families.
+		 *
 		 * @param {string} networkName - Network name ('xna', 'xna-test', 'xna-pq', or 'xna-pq-test')
 		 * @returns {object} Network configuration
 		 */
 		function getNetworkConfig(networkName) {
-		  if (networkName === 'xna' || networkName === 'mainnet') {
-		    return NETWORKS.MAINNET;
-		  } else if (networkName === 'xna-test' || networkName === 'testnet') {
-		    return NETWORKS.TESTNET;
-		  } else if (networkName === 'xna-pq' || networkName === 'mainnet-pq') {
-		    return NETWORKS.MAINNET_PQ;
-		  } else if (networkName === 'xna-pq-test' || networkName === 'testnet-pq') {
-		    return NETWORKS.TESTNET_PQ;
+		  if (MAINNET_NETWORKS.includes(networkName)) {
+		    return networkName === 'xna-pq' || networkName === 'mainnet-pq'
+		      ? NETWORKS.MAINNET_PQ
+		      : NETWORKS.MAINNET;
+		  } else if (TESTNET_NETWORKS.includes(networkName)) {
+		    return networkName === 'xna-pq-test' || networkName === 'testnet-pq'
+		      ? NETWORKS.TESTNET_PQ
+		      : NETWORKS.TESTNET;
 		  } else {
 		    throw new Error(`Unknown network: ${networkName}`);
 		  }
 		}
 
 		/**
-		 * Detect network from address prefix
+		 * Resolve a network name to its chain family.
+		 * AuthScript aliases share the same family as legacy addresses.
+		 *
+		 * @param {string} networkName - Network name
+		 * @returns {'mainnet'|'testnet'} Network family
+		 */
+		function resolveAddressNetworkFamily(networkName) {
+		  if (MAINNET_NETWORKS.includes(networkName)) {
+		    return 'mainnet';
+		  }
+
+		  if (TESTNET_NETWORKS.includes(networkName)) {
+		    return 'testnet';
+		  }
+
+		  throw new Error(`Unknown network: ${networkName}`);
+		}
+
+		/**
+		 * Determine whether two network labels are compatible for address use.
+		 * This treats legacy and AuthScript labels on the same chain as compatible.
+		 *
+		 * @param {string} left - First network name
+		 * @param {string} right - Second network name
+		 * @returns {boolean} True if both belong to the same chain family
+		 */
+		function areAddressNetworksCompatible(left, right) {
+		  return resolveAddressNetworkFamily(left) === resolveAddressNetworkFamily(right);
+		}
+
+		/**
+		 * Detect network from address prefix.
+		 * `nq1...` / `tnq1...` are AuthScript witness-v1 destinations.
+		 *
 		 * @param {string} address - Neurai address
 		 * @returns {string} Network name ('xna', 'xna-test', 'xna-pq', or 'xna-pq-test')
 		 */
 		function detectNetworkFromAddress(address) {
-		  if (address.startsWith(NETWORKS.MAINNET_PQ.pqAddressPrefix)) {
+		  if (address.startsWith(NETWORKS.MAINNET_PQ.authScriptAddressPrefix)) {
 		    return 'xna-pq';
-		  } else if (address.startsWith(NETWORKS.TESTNET_PQ.pqAddressPrefix)) {
+		  } else if (address.startsWith(NETWORKS.TESTNET_PQ.authScriptAddressPrefix)) {
 		    return 'xna-pq-test';
 		  } else if (address.startsWith('N')) {
 		    return 'xna';
@@ -1182,9 +1225,13 @@ var NeuraiAssetsBundle = (function (exports) {
 
 		networks = {
 		  NETWORKS,
+		  MAINNET_NETWORKS,
+		  TESTNET_NETWORKS,
 		  ASSET_NAME_RULES,
 		  ASSET_LIMITS,
 		  getNetworkConfig,
+		  resolveAddressNetworkFamily,
+		  areAddressNetworksCompatible,
 		  detectNetworkFromAddress
 		};
 		return networks;
@@ -1212,9 +1259,13 @@ var NeuraiAssetsBundle = (function (exports) {
 		} = requireBurnAddresses();
 		const {
 		  NETWORKS,
+		  MAINNET_NETWORKS,
+		  TESTNET_NETWORKS,
 		  ASSET_NAME_RULES,
 		  ASSET_LIMITS,
 		  getNetworkConfig,
+		  resolveAddressNetworkFamily,
+		  areAddressNetworksCompatible,
 		  detectNetworkFromAddress
 		} = requireNetworks();
 
@@ -1237,9 +1288,13 @@ var NeuraiAssetsBundle = (function (exports) {
 
 		  // Networks
 		  NETWORKS,
+		  MAINNET_NETWORKS,
+		  TESTNET_NETWORKS,
 		  ASSET_NAME_RULES,
 		  ASSET_LIMITS,
 		  getNetworkConfig,
+		  resolveAddressNetworkFamily,
+		  areAddressNetworksCompatible,
 		  detectNetworkFromAddress
 		};
 		return constants$1;
@@ -1856,7 +1911,11 @@ var NeuraiAssetsBundle = (function (exports) {
 	function requireNetworkDetector () {
 		if (hasRequiredNetworkDetector) return networkDetector;
 		hasRequiredNetworkDetector = 1;
-		const { NETWORKS } = requireConstants();
+		const {
+		  NETWORKS,
+		  areAddressNetworksCompatible,
+		  resolveAddressNetworkFamily
+		} = requireConstants();
 
 		class NetworkDetector {
 		  /**
@@ -1893,18 +1952,18 @@ var NeuraiAssetsBundle = (function (exports) {
 		  /**
 		   * Detect network from address
 		   * @param {string} address - Neurai address
-		   * @returns {string} Network name ('xna', 'xna-test', 'xna-pq', or 'xna-pq-test')
+		   * @returns {string} Network label ('xna', 'xna-test', 'xna-pq', or 'xna-pq-test')
 		   */
 		  static detectFromAddress(address) {
 		    if (!address || typeof address !== 'string') {
 		      throw new Error('Address must be a non-empty string');
 		    }
 
-		    if (address.startsWith(NETWORKS.MAINNET_PQ.pqAddressPrefix)) {
+		    if (address.startsWith(NETWORKS.MAINNET_PQ.authScriptAddressPrefix)) {
 		      return 'xna-pq';
 		    }
 
-		    if (address.startsWith(NETWORKS.TESTNET_PQ.pqAddressPrefix)) {
+		    if (address.startsWith(NETWORKS.TESTNET_PQ.authScriptAddressPrefix)) {
 		      return 'xna-pq-test';
 		    }
 
@@ -1924,31 +1983,32 @@ var NeuraiAssetsBundle = (function (exports) {
 		  /**
 		   * Detect network from multiple addresses
 		   * @param {string[]} addresses - Array of addresses
-		   * @returns {string} Network name ('xna', 'xna-test', 'xna-pq', or 'xna-pq-test')
+		   * @returns {string} Network label. Mixed legacy/AuthScript addresses on the same
+		   * chain are normalized to the chain family label (`xna` or `xna-test`).
 		   */
 		  static detectFromAddresses(addresses) {
 		    if (!Array.isArray(addresses) || addresses.length === 0) {
 		      throw new Error('Addresses must be a non-empty array');
 		    }
 
-		    // Detect from first address
-		    const network = this.detectFromAddress(addresses[0]);
+		    const firstNetwork = this.detectFromAddress(addresses[0]);
+		    const family = resolveAddressNetworkFamily(firstNetwork);
 
 		    // Verify all addresses are from the same network
 		    for (let i = 1; i < addresses.length; i++) {
 		      const otherNetwork = this.detectFromAddress(addresses[i]);
-		      if (otherNetwork !== network) {
-		        throw new Error(`Mixed network addresses detected: ${network} and ${otherNetwork}`);
+		      if (!areAddressNetworksCompatible(firstNetwork, otherNetwork)) {
+		        throw new Error(`Mixed network addresses detected: ${firstNetwork} and ${otherNetwork}`);
 		      }
 		    }
 
-		    return network;
+		    return family === 'mainnet' ? 'xna' : 'xna-test';
 		  }
 
 		  /**
 		   * Validate that addresses match expected network
 		   * @param {string[]} addresses - Array of addresses
-		   * @param {string} expectedNetwork - Expected network ('xna', 'xna-test', 'xna-pq', or 'xna-pq-test')
+		   * @param {string} expectedNetwork - Expected network label
 		   * @returns {boolean} True if all addresses match network
 		   */
 		  static validateAddressesNetwork(addresses, expectedNetwork) {
@@ -1958,7 +2018,7 @@ var NeuraiAssetsBundle = (function (exports) {
 
 		    for (const address of addresses) {
 		      const network = this.detectFromAddress(address);
-		      if (network !== expectedNetwork) {
+		      if (!areAddressNetworksCompatible(network, expectedNetwork)) {
 		        throw new Error(
 		          `Address ${address} is from ${network} but expected ${expectedNetwork}`
 		        );
@@ -4376,23 +4436,27 @@ 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;
 		  }
 
 		  /**
@@ -5975,11 +6039,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 });
@@ -6741,12 +6807,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 });