@neuraiproject/neurai-assets 1.3.3 → 1.4.1

package/README.md

@@ -2,6 +2,17 @@
 
 Complete asset management library for Neurai blockchain. Supports creation, reissuance, and queries for all asset types in a non-custodial way.
 
+> **1.4.1**: fix — the constructor dropped `config.assetMarker`, so the
+> wallet-level override documented in 1.4.0 never reached the builders
+> (per-operation `params.assetMarker` was unaffected). Precedence is now
+> effective: `params.assetMarker` > `config.assetMarker` > node.
+>
+> **1.4.0**: NIP-040 `assetMarker` in `localRawBuild` (see below); RPC
+> rejection messages from `@neuraiproject/neurai-rpc` >= 0.5 are surfaced
+> correctly (they carry no `.message`); name-length caps now mirror the node
+> (full name, owner `!` included: 31 mainnet / 121 testnet-regtest, validated
+> against a regtest node); peer `neurai-rpc ^0.6.0`.
+
 ## Features
 
 - ✅ **Non-custodial**: Library builds unsigned transactions, your wallet signs them
@@ -525,6 +536,26 @@ The library automatically validates that the owner token is returned in each ope
 
 **Note**: In addition to the burned cost, all operations pay a network fee (calculated automatically).
 
+## NIP-040 asset marker (local raw builds)
+
+Asset payloads open with a 3-byte marker that NIP-040 migrates from the
+Ravencoin-inherited `rvn` to `xna` at an activation height per network
+(testnet: 303000, already crossed; regtest: 1; mainnet: not scheduled yet).
+
+- Transactions built **through the node** (`createrawtransaction`) need
+  nothing: the node stamps the marker itself.
+- The `localRawBuild` metadata (consumed by
+  `@neuraiproject/neurai-create-transaction createFromOperation`, >= 0.7.0)
+  now carries `params.assetMarker`. Builders resolve it once per build:
+  1. `params.assetMarker` / `config.assetMarker` if you set it (`'rvn'` |
+     `'xna'` — offline builds or tests);
+  2. otherwise the node's `getblockchaininfo.asset_marker` (node commit
+     `347362b` or later);
+  3. `'rvn'` when the node predates that field or the call fails — which
+     matches what such a node enforces.
+
+No height tables and no network inference: the node (or you) decides.
+
 ## Validations
 
 The library validates client-side:

package/dist/NeuraiAssets.global.js

@@ -7,6 +7,55 @@ var NeuraiAssetsBundle = (function (exports) {
 
 	var src = {exports: {}};
 
+	/**
+	 * Extract a human-readable message from an RPC rejection.
+	 *
+	 * @neuraiproject/neurai-rpc >= 0.5 never rejects with a plain Error, so
+	 * `error.message` is undefined for every node failure. It uses three shapes:
+	 *
+	 *   1. {error: {code, message}, description}      JSON-RPC error (also on HTTP 200)
+	 *   2. {statusText, status, description, error}   HTTP response other than 200
+	 *   3. {originalError, type: 'ServerUnreachable', error, description}
+	 *
+	 * In shape 3 `error` is a string, in shapes 1 and 2 it is an object (or
+	 * null). Plain Errors (thrown by this library or by mocks) keep working
+	 * through the `error.message` candidate.
+	 */
+
+	var rpcErrorMessage_1;
+	var hasRequiredRpcErrorMessage;
+
+	function requireRpcErrorMessage () {
+		if (hasRequiredRpcErrorMessage) return rpcErrorMessage_1;
+		hasRequiredRpcErrorMessage = 1;
+		function rpcErrorMessage(error) {
+		  if (!error) {
+		    return '';
+		  }
+		  if (typeof error === 'string') {
+		    return error;
+		  }
+
+		  const candidates = [
+		    error.error && error.error.message,
+		    typeof error.error === 'string' ? error.error : null,
+		    error.description,
+		    error.message,
+		    error.statusText
+		  ];
+
+		  for (const candidate of candidates) {
+		    if (typeof candidate === 'string' && candidate.length > 0) {
+		      return candidate;
+		    }
+		  }
+		  return '';
+		}
+
+		rpcErrorMessage_1 = { rpcErrorMessage };
+		return rpcErrorMessage_1;
+	}
+
 	/**
 	 * Validation Error Classes
 	 * Errors thrown during parameter validation
@@ -332,6 +381,7 @@ var NeuraiAssetsBundle = (function (exports) {
 	function requireAssetQueries () {
 		if (hasRequiredAssetQueries) return AssetQueries_1;
 		hasRequiredAssetQueries = 1;
+		const { rpcErrorMessage } = requireRpcErrorMessage();
 		const { AssetNotFoundError, InvalidAddressError } = requireErrors();
 
 		class AssetQueries {
@@ -373,14 +423,14 @@ var NeuraiAssetsBundle = (function (exports) {
 		      }
 
 		      // RPC error - likely asset doesn't exist
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        throw new AssetNotFoundError(
 		          `Asset ${assetName} not found on blockchain`,
 		          assetName
 		        );
 		      }
 
-		      throw new Error(`Failed to get asset data: ${error.message}`);
+		      throw new Error(`Failed to get asset data: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -397,7 +447,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const assets = await this.rpc('listassets', [filter, verbose, count, start]);
 		      return assets || [];
 		    } catch (error) {
-		      throw new Error(`Failed to list assets: ${error.message}`);
+		      throw new Error(`Failed to list assets: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -415,7 +465,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const myAssets = await this.rpc('listmyassets', [assetName, verbose, count, start, confs]);
 		      return myAssets || {};
 		    } catch (error) {
-		      throw new Error(`Failed to list my assets: ${error.message}`);
+		      throw new Error(`Failed to list my assets: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -436,13 +486,13 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const result = await this.rpc('listaddressesbyasset', [assetName, onlyCount, count, start]);
 		      return result || (onlyCount ? 0 : []);
 		    } catch (error) {
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        throw new AssetNotFoundError(
 		          `Asset ${assetName} not found on blockchain`,
 		          assetName
 		        );
 		      }
-		      throw new Error(`Failed to list addresses by asset: ${error.message}`);
+		      throw new Error(`Failed to list addresses by asset: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -463,7 +513,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const result = await this.rpc('listassetbalancesbyaddress', [address, onlyTotal, count, start]);
 		      return result || (onlyTotal ? 0 : []);
 		    } catch (error) {
-		      throw new Error(`Failed to list asset balances by address: ${error.message}`);
+		      throw new Error(`Failed to list asset balances by address: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -487,10 +537,10 @@ var NeuraiAssetsBundle = (function (exports) {
 		      return result === true || result === 1;
 		    } catch (error) {
 		      // If tag doesn't exist or address doesn't have it, return false
-		      if (error.message && (error.message.includes('not found') || error.message.includes('does not have'))) {
+		      if (rpcErrorMessage(error).includes('not found') || rpcErrorMessage(error).includes('does not have')) {
 		        return false;
 		      }
-		      throw new Error(`Failed to check address tag: ${error.message}`);
+		      throw new Error(`Failed to check address tag: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -509,10 +559,10 @@ var NeuraiAssetsBundle = (function (exports) {
 		      return tags || [];
 		    } catch (error) {
 		      // If no tags found, return empty array
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        return [];
 		      }
-		      throw new Error(`Failed to list tags for address: ${error.message}`);
+		      throw new Error(`Failed to list tags for address: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -530,13 +580,13 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const addresses = await this.rpc('listaddressesfortag', [qualifierName]);
 		      return addresses || [];
 		    } catch (error) {
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        throw new AssetNotFoundError(
 		          `Qualifier ${qualifierName} not found on blockchain`,
 		          qualifierName
 		        );
 		      }
-		      throw new Error(`Failed to list addresses for tag: ${error.message}`);
+		      throw new Error(`Failed to list addresses for tag: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -560,10 +610,10 @@ var NeuraiAssetsBundle = (function (exports) {
 		      return result === true || result === 1;
 		    } catch (error) {
 		      // If address doesn't meet requirements, return false
-		      if (error.message && (error.message.includes('not found') || error.message.includes('does not meet'))) {
+		      if (rpcErrorMessage(error).includes('not found') || rpcErrorMessage(error).includes('does not meet')) {
 		        return false;
 		      }
-		      throw new Error(`Failed to check address restriction: ${error.message}`);
+		      throw new Error(`Failed to check address restriction: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -590,7 +640,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      }
 		      return false;
 		    } catch (error) {
-		      throw new Error(`Failed to check if address is frozen: ${error.message}`);
+		      throw new Error(`Failed to check if address is frozen: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -608,13 +658,13 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const result = await this.rpc('checkglobalrestriction', [restrictedAssetName]);
 		      return result === true || result === 1;
 		    } catch (error) {
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        throw new AssetNotFoundError(
 		          `Restricted asset ${restrictedAssetName} not found on blockchain`,
 		          restrictedAssetName
 		        );
 		      }
-		      throw new Error(`Failed to check global restriction: ${error.message}`);
+		      throw new Error(`Failed to check global restriction: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -632,13 +682,13 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const result = await this.rpc('getverifierstring', [restrictedAssetName]);
 		      return result || '';
 		    } catch (error) {
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        throw new AssetNotFoundError(
 		          `Restricted asset ${restrictedAssetName} not found on blockchain`,
 		          restrictedAssetName
 		        );
 		      }
-		      throw new Error(`Failed to get verifier string: ${error.message}`);
+		      throw new Error(`Failed to get verifier string: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -680,7 +730,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const result = await this.rpc('getsnapshotrequest', [assetName, blockHeight]);
 		      return result;
 		    } catch (error) {
-		      throw new Error(`Failed to get snapshot request: ${error.message}`);
+		      throw new Error(`Failed to get snapshot request: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -703,7 +753,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const result = await this.rpc('cancelsnapshotrequest', [assetName, blockHeight]);
 		      return result === true || result === 1;
 		    } catch (error) {
-		      throw new Error(`Failed to cancel snapshot request: ${error.message}`);
+		      throw new Error(`Failed to cancel snapshot request: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -721,13 +771,13 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const result = await this.rpc('listdepinholders', [assetName]);
 		      return result || [];
 		    } catch (error) {
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        throw new AssetNotFoundError(
 		          `DEPIN asset ${assetName} not found on blockchain`,
 		          assetName
 		        );
 		      }
-		      throw new Error(`Failed to list DEPIN holders: ${error.message}`);
+		      throw new Error(`Failed to list DEPIN holders: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -750,7 +800,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const result = await this.rpc('checkdepinvalidity', [assetName, address]);
 		      return result || { has_asset: false };
 		    } catch (error) {
-		      throw new Error(`Failed to check DEPIN validity: ${error.message}`);
+		      throw new Error(`Failed to check DEPIN validity: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -764,7 +814,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      const assets = await this.listAssets('*', false, 1, 0);
 		      return Array.isArray(assets) ? assets.length : 0;
 		    } catch (error) {
-		      throw new Error(`Failed to get asset count: ${error.message}`);
+		      throw new Error(`Failed to get asset count: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -1050,7 +1100,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		    addressPrefix: 'N',
 		    authScriptAddressPrefix: 'nq1',
 		    pqAddressPrefix: 'nq1',
-		    assetNameMaxLength: 32,
+		    assetNameMaxLength: 31,
 		    defaultRPCPort: 19001,
 		    coin: 'XNA',
 		    baseNetwork: 'xna'
@@ -1061,7 +1111,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		    addressPrefix: 't',
 		    authScriptAddressPrefix: 'tnq1',
 		    pqAddressPrefix: 'tnq1',
-		    assetNameMaxLength: 32,  // Same as mainnet
+		    assetNameMaxLength: 121, // DePIN networks (testnet/regtest) extend the cap
 		    defaultRPCPort: 19101,
 		    coin: 'TXNA',
 		    baseNetwork: 'xna-test'
@@ -1072,7 +1122,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		    addressPrefix: 'N',
 		    authScriptAddressPrefix: 'nq1',
 		    pqAddressPrefix: 'nq1',
-		    assetNameMaxLength: 32,
+		    assetNameMaxLength: 31,
 		    defaultRPCPort: 19001,
 		    coin: 'XNA',
 		    baseNetwork: 'xna'
@@ -1083,7 +1133,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		    addressPrefix: 't',
 		    authScriptAddressPrefix: 'tnq1',
 		    pqAddressPrefix: 'tnq1',
-		    assetNameMaxLength: 32,
+		    assetNameMaxLength: 121,
 		    defaultRPCPort: 19101,
 		    coin: 'TXNA',
 		    baseNetwork: 'xna-test'
@@ -1911,6 +1961,8 @@ var NeuraiAssetsBundle = (function (exports) {
 	function requireNetworkDetector () {
 		if (hasRequiredNetworkDetector) return networkDetector;
 		hasRequiredNetworkDetector = 1;
+		const { rpcErrorMessage } = requireRpcErrorMessage();
+
 		const {
 		  NETWORKS,
 		  areAddressNetworksCompatible,
@@ -1945,7 +1997,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      // Default to mainnet
 		      return 'xna';
 		    } catch (error) {
-		      throw new Error(`Failed to detect network from RPC: ${error.message}`);
+		      throw new Error(`Failed to detect network from RPC: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -2465,6 +2517,7 @@ var NeuraiAssetsBundle = (function (exports) {
 	function requireOwnerTokenManager () {
 		if (hasRequiredOwnerTokenManager) return OwnerTokenManager_1;
 		hasRequiredOwnerTokenManager = 1;
+		const { rpcErrorMessage } = requireRpcErrorMessage();
 		const { AssetNameParser } = requireUtils();
 		const {
 		  OwnerTokenNotFoundError,
@@ -2523,7 +2576,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      }
 
 		      throw new AssetError(
-		        `Failed to find owner token ${ownerTokenName}: ${error.message}`
+		        `Failed to find owner token ${ownerTokenName}: ${rpcErrorMessage(error)}`
 		      );
 		    }
 		  }
@@ -2661,7 +2714,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      return ownerTokenUTXOs;
 		    } catch (error) {
 		      throw new AssetError(
-		        `Failed to get owner tokens: ${error.message}`
+		        `Failed to get owner tokens: ${rpcErrorMessage(error)}`
 		      );
 		    }
 		  }
@@ -2853,6 +2906,7 @@ var NeuraiAssetsBundle = (function (exports) {
 	function requireUTXOSelector () {
 		if (hasRequiredUTXOSelector) return UTXOSelector_1;
 		hasRequiredUTXOSelector = 1;
+		const { rpcErrorMessage } = requireRpcErrorMessage();
 		const { InsufficientFundsError } = requireErrors();
 		const { estimateTransactionVbytes } = requireFeeSizing();
 
@@ -2891,7 +2945,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        return utxos.filter(utxo => !utxo.assetName || utxo.assetName === 'XNA');
 		      }
 		    } catch (error) {
-		      throw new Error(`Failed to get UTXOs: ${error.message}`);
+		      throw new Error(`Failed to get UTXOs: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -3493,7 +3547,10 @@ var NeuraiAssetsBundle = (function (exports) {
 		const { InvalidAssetNameError } = requireErrors();
 
 		const MIN_ASSET_LENGTH = 3;
-		const MAINNET_MAX_NAME_LENGTH = 32;
+		// Full-name caps, mirror of the node (assets_fromscript.cpp:31-47): the limit
+		// applies to the COMPLETE name, owner '!' and tags included, so a mainnet
+		// root is effectively capped at 30 (its owner token "ROOT!" must fit in 31).
+		const MAINNET_MAX_NAME_LENGTH = 31;
 		const TESTNET_MAX_NAME_LENGTH = 121;
 
 		const ROOT_NAME_CHARACTERS = /^[A-Z0-9._]{3,}$/;
@@ -4363,6 +4420,7 @@ var NeuraiAssetsBundle = (function (exports) {
 	function requireBaseAssetTransactionBuilder () {
 		if (hasRequiredBaseAssetTransactionBuilder) return BaseAssetTransactionBuilder_1;
 		hasRequiredBaseAssetTransactionBuilder = 1;
+		const { rpcErrorMessage } = requireRpcErrorMessage();
 		const { BurnManager, OwnerTokenManager, UTXOSelector, OutputOrderer } = requireManagers();
 		const { AssetNameValidator, AmountValidator } = requireValidators();
 
@@ -4423,6 +4481,9 @@ var NeuraiAssetsBundle = (function (exports) {
 		    // post-selection recompute). The fee rate is stable for the duration of
 		    // a single build, so cache the first lookup and reuse it.
 		    this._feeRatePromise = null;
+
+		    // NIP-040 marker for the localRawBuild metadata; resolved once per build.
+		    this._assetMarkerPromise = null;
 		  }
 
 		  /**
@@ -4515,7 +4576,7 @@ var NeuraiAssetsBundle = (function (exports) {
 
 		      return rawTx;
 		    } catch (error) {
-		      throw new Error(`Failed to create raw transaction: ${error.message}`);
+		      throw new Error(`Failed to create raw transaction: ${rpcErrorMessage(error)}`);
 		    }
 		  }
 
@@ -4677,19 +4738,73 @@ var NeuraiAssetsBundle = (function (exports) {
 		    return Math.round(amount * 100000000);
 		  }
 
+		  /**
+		   * NIP-040 marker for every asset output of the localRawBuild metadata.
+		   *
+		   * The chain decides which marker ("rvn" or "xna") new asset outputs must
+		   * carry, per network and height, and the node reports the one required for
+		   * the next block as `getblockchaininfo.asset_marker` (node commit 347362b).
+		   * Resolution order:
+		   *   1. `params.assetMarker` (explicit caller override — offline builds,
+		   *      tests, or a node this library should not ask);
+		   *   2. `getblockchaininfo.asset_marker` from the connected node;
+		   *   3. `'rvn'` when the node predates the field or the call fails
+		   *      (matches what such a node enforces; documented in the README).
+		   * The RPC-built transaction path never needs this: the node stamps the
+		   * marker itself in `createrawtransaction`.
+		   *
+		   * @returns {Promise<'rvn'|'xna'>} Marker for locally built asset outputs
+		   */
+		  resolveAssetMarker() {
+		    if (!this._assetMarkerPromise) {
+		      this._assetMarkerPromise = this._fetchAssetMarker();
+		    }
+		    return this._assetMarkerPromise;
+		  }
+
+		  async _fetchAssetMarker() {
+		    const override = this.params.assetMarker;
+		    if (override !== undefined && override !== null) {
+		      if (override !== 'rvn' && override !== 'xna') {
+		        throw new Error(
+		          `Invalid assetMarker: ${override} (expected 'rvn' or 'xna', the value of getblockchaininfo.asset_marker)`
+		        );
+		      }
+		      return override;
+		    }
+
+		    let info = null;
+		    try {
+		      info = await this.rpc('getblockchaininfo', []);
+		    } catch (error) {
+		      return 'rvn';
+		    }
+		    const marker = info ? info.asset_marker : undefined;
+		    if (marker === undefined || marker === null) {
+		      return 'rvn';
+		    }
+		    if (marker !== 'rvn' && marker !== 'xna') {
+		      throw new Error(`Node reported an unknown asset_marker: ${marker}`);
+		    }
+		    return marker;
+		  }
+
 		  /**
 		   * Build a typed local raw build payload compatible with
 		   * @neuraiproject/neurai-create-transaction createFromOperation(...)
 		   *
+		   * Stamps the NIP-040 `assetMarker` (see resolveAssetMarker) so
+		   * createFromOperation >= 0.7.0 emits the marker the chain requires.
+		   *
 		   * @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
+		   * @returns {Promise<{ operationType: string, params: object }>} Local raw build
 		   */
-		  buildLocalRawBuild(
+		  async buildLocalRawBuild(
 		    operationType,
 		    inputs,
 		    burnInfo = null,
@@ -4699,6 +4814,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		  ) {
 		    const params = {
 		      inputs: this.toRawTxInputs(inputs),
+		      assetMarker: await this.resolveAssetMarker(),
 		      ...operationParams
 		    };
 
@@ -4835,7 +4951,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		      return assetData !== null && assetData !== undefined;
 		    } catch (error) {
 		      // If asset doesn't exist, RPC will throw error
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        return false;
 		      }
 		      // Re-throw other errors
@@ -4852,7 +4968,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		    try {
 		      return await this.rpc('getassetdata', [assetName]);
 		    } catch (error) {
-		      if (error.message && error.message.includes('not found')) {
+		      if (rpcErrorMessage(error).includes('not found')) {
 		        return null;
 		      }
 		      throw error;
@@ -5038,7 +5154,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        assetName,
 		        ownerTokenName: assetName + '!',
 		        operationType: 'ISSUE_ROOT',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          'ISSUE_ROOT',
 		          inputs,
 		          burnInfo,
@@ -5306,7 +5422,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        ownerTokenName: assetName + '!',
 		        parentOwnerTokenUsed: ownerTokenName,
 		        operationType: 'ISSUE_SUB',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          'ISSUE_SUB',
 		          inputs,
 		          burnInfo,
@@ -5476,7 +5592,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        assetName,
 		        ownerTokenName: `${assetName}!`,
 		        operationType: 'ISSUE_DEPIN',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          'ISSUE_DEPIN',
 		          inputs,
 		          burnInfo,
@@ -5744,7 +5860,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        previousSupply: currentSupply,
 		        reissuableLocked: reissuable === false,
 		        operationType: 'REISSUE',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          'REISSUE',
 		          inputs,
 		          burnInfo,
@@ -6007,7 +6123,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        isDepin,
 		        ownerTokenUsed: isDepin ? ownerTokenName : null,
 		        operationType: 'TRANSFER',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          'TRANSFER',
 		          inputs,
 		          null, // no burn
@@ -6291,7 +6407,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        nftCount,
 		        ownerTokenUsed: ownerTokenName,
 		        operationType: 'ISSUE_UNIQUE',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          'ISSUE_UNIQUE',
 		          inputs,
 		          burnInfo,
@@ -6552,7 +6668,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        parentQualifier: isSub ? parsed.parent : null,
 		        parentQualifierUsed: parentQualifierName,
 		        operationType: isSub ? 'ISSUE_SUB_QUALIFIER' : 'ISSUE_QUALIFIER',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          isSub ? 'ISSUE_SUB_QUALIFIER' : 'ISSUE_QUALIFIER',
 		          inputs,
 		          burnInfo,
@@ -6806,7 +6922,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        verifierString,
 		        requiredQualifiers,
 		        operationType: 'ISSUE_RESTRICTED',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          'ISSUE_RESTRICTED',
 		          inputs,
 		          burnInfo,
@@ -7092,7 +7208,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        requiredQualifiers,
 		        reissuableLocked: reissuable === false,
 		        operationType: 'REISSUE_RESTRICTED',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          'REISSUE_RESTRICTED',
 		          inputs,
 		          burnInfo,
@@ -7334,7 +7450,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        targetAddresses,
 		        addressCount,
 		        operationType: isUntag ? 'UNTAG_ADDRESSES' : 'TAG_ADDRESSES',
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          isUntag ? 'UNTAG_ADDRESSES' : 'TAG_ADDRESSES',
 		          inputs,
 		          burnInfo,
@@ -7596,7 +7712,7 @@ var NeuraiAssetsBundle = (function (exports) {
 		        targetAddresses: targetAddresses.length > 0 ? targetAddresses : null,
 		        addressCount: targetAddresses.length,
 		        operationType,
-		        localRawBuild: this.buildLocalRawBuild(
+		        localRawBuild: await this.buildLocalRawBuild(
 		          operationType,
 		          inputs,
 		          null,
@@ -7757,6 +7873,10 @@ var NeuraiAssetsBundle = (function (exports) {
 		   * @param {Array<string>} config.addresses - Wallet addresses
 		   * @param {string} config.changeAddress - Default change address
 		   * @param {string} config.toAddress - Default receiving address
+		   * @param {('rvn'|'xna')} [config.assetMarker] - NIP-040 marker for locally
+		   *   built raw transactions. Omit to use the node's
+		   *   getblockchaininfo.asset_marker (falls back to 'rvn' on nodes that do
+		   *   not report it). Per-operation params.assetMarker overrides this.
 		   */
 		  constructor(rpc, config = {}) {
 		    if (!rpc || typeof rpc !== 'function') {
@@ -7768,7 +7888,11 @@ var NeuraiAssetsBundle = (function (exports) {
 		      network: config.network || 'xna',
 		      addresses: config.addresses || [],
 		      changeAddress: config.changeAddress || null,
-		      toAddress: config.toAddress || null
+		      toAddress: config.toAddress || null,
+		      // NIP-040: documented since 1.4.0 but dropped here until 1.4.1, which
+		      // made the config-level override silently inoperative (per-operation
+		      // params.assetMarker was unaffected).
+		      assetMarker: config.assetMarker
 		    };
 
 		    // Initialize query interface
@@ -7794,7 +7918,10 @@ var NeuraiAssetsBundle = (function (exports) {
 		      network: this.config.network,
 		      walletAddresses: this.config.addresses,
 		      changeAddress: params.changeAddress || this.config.changeAddress,
-		      toAddress: params.toAddress || this.config.toAddress
+		      toAddress: params.toAddress || this.config.toAddress,
+		      // NIP-040: marker for the localRawBuild metadata. Undefined lets the
+		      // builder ask the node (getblockchaininfo.asset_marker).
+		      assetMarker: params.assetMarker !== undefined ? params.assetMarker : this.config.assetMarker
 		    };
 		  }