@buildonspark/issuer-sdk 0.0.83 → 0.0.85

package/dist/index.cjs

@@ -20,7 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  IssuerSparkWallet: () => IssuerSparkWallet
+  IssuerSparkWallet: () => IssuerSparkWalletBrowser
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -41,7 +41,6 @@ if (typeof window !== "undefined") {
 // src/issuer-wallet/issuer-spark-wallet.ts
 var import_lrc20_sdk = require("@buildonspark/lrc20-sdk");
 var import_spark_sdk5 = require("@buildonspark/spark-sdk");
-var import_core = require("@lightsparkdev/core");
 var import_spark_sdk6 = require("@buildonspark/spark-sdk");
 var import_utils4 = require("@noble/curves/abstract/utils");
 var import_spark_sdk7 = require("@buildonspark/spark-sdk");
@@ -336,57 +335,13 @@ var IssuerSparkWallet = class _IssuerSparkWallet extends import_spark_sdk5.Spark
     options
   }) {
     const wallet = new _IssuerSparkWallet(options, signer);
+    wallet.initializeTracer(wallet);
     const initResponse = await wallet.initWallet(mnemonicOrSeed, accountNumber);
-    if (import_core.isNode) {
-      wallet.wrapIssuerSparkWalletWithTracing();
-    }
     return {
       wallet,
       ...initResponse
     };
   }
-  wrapIssuerSparkWalletWithTracing() {
-    this.getIssuerTokenBalance = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.getIssuerTokenBalance",
-      this.getIssuerTokenBalance.bind(this)
-    );
-    this.getIssuerTokenMetadata = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.getIssuerTokenMetadata",
-      this.getIssuerTokenMetadata.bind(this)
-    );
-    this.getIssuerTokenIdentifier = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.getIssuerTokenIdentifier",
-      this.getIssuerTokenIdentifier.bind(this)
-    );
-    this.createToken = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.createToken",
-      this.createToken.bind(this)
-    );
-    this.mintTokens = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.mintTokens",
-      this.mintTokens.bind(this)
-    );
-    this.burnTokens = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.burnTokens",
-      this.burnTokens.bind(this)
-    );
-    this.freezeTokens = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.freezeTokens",
-      this.freezeTokens.bind(this)
-    );
-    this.unfreezeTokens = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.unfreezeTokens",
-      this.unfreezeTokens.bind(this)
-    );
-    this.getIssuerTokenDistribution = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.getIssuerTokenDistribution",
-      this.getIssuerTokenDistribution.bind(this)
-    );
-    this.announceTokenL1 = this.wrapWithOtelSpan(
-      "SparkIssuerWallet.announceTokenL1",
-      this.announceTokenL1.bind(this)
-    );
-  }
   constructor(configOptions, signer) {
     super(configOptions, signer);
     this.issuerTokenTransactionService = new IssuerTokenTransactionService(
@@ -397,6 +352,7 @@ var IssuerSparkWallet = class _IssuerSparkWallet extends import_spark_sdk5.Spark
       this.config,
       this.connectionManager
     );
+    this.wrapIssuerSparkWalletMethodsWithTracing();
   }
   /**
    * Gets the token balance for the issuer's token.
@@ -570,9 +526,6 @@ var IssuerSparkWallet = class _IssuerSparkWallet extends import_spark_sdk5.Spark
       network: this.config.getNetworkType()
     });
     const issuerTokenIdentifier = await this.getIssuerTokenIdentifier();
-    if (issuerTokenIdentifier === null) {
-      throw new import_spark_sdk5.ValidationError("Issuer token identifier not found");
-    }
     return await this.transferTokens({
       tokenIdentifier: issuerTokenIdentifier,
       tokenAmount,
@@ -592,13 +545,6 @@ var IssuerSparkWallet = class _IssuerSparkWallet extends import_spark_sdk5.Spark
       this.config.getNetworkType()
     );
     const issuerTokenIdentifier = await this.getIssuerTokenIdentifier();
-    if (issuerTokenIdentifier === null) {
-      throw new import_spark_sdk5.ValidationError("Issuer token identifier not found", {
-        field: "issuerTokenIdentifier",
-        value: issuerTokenIdentifier,
-        expected: "non-null token identifier"
-      });
-    }
     const rawTokenIdentifier = (0, import_spark_sdk7.decodeBech32mTokenIdentifier)(
       issuerTokenIdentifier,
       this.config.getNetworkType()
@@ -625,13 +571,6 @@ var IssuerSparkWallet = class _IssuerSparkWallet extends import_spark_sdk5.Spark
       this.config.getNetworkType()
     );
     const issuerTokenIdentifier = await this.getIssuerTokenIdentifier();
-    if (issuerTokenIdentifier === null) {
-      throw new import_spark_sdk5.ValidationError("Issuer token identifier not found", {
-        field: "issuerTokenIdentifier",
-        value: issuerTokenIdentifier,
-        expected: "non-null token identifier"
-      });
-    }
     const rawTokenIdentifier = (0, import_spark_sdk7.decodeBech32mTokenIdentifier)(
       issuerTokenIdentifier,
       this.config.getNetworkType()
@@ -704,6 +643,64 @@ var IssuerSparkWallet = class _IssuerSparkWallet extends import_spark_sdk5.Spark
       );
     }
   }
+  getTraceName(methodName) {
+    return `IssuerSparkWallet.${methodName}`;
+  }
+  wrapPublicIssuerSparkWalletMethodWithOtelSpan(methodName) {
+    const original = this[methodName];
+    if (typeof original !== "function") {
+      throw new Error(
+        `Method ${methodName} is not a function on IssuerSparkWallet.`
+      );
+    }
+    const wrapped = this.wrapWithOtelSpan(
+      this.getTraceName(methodName),
+      original.bind(this)
+    );
+    this[methodName] = wrapped;
+  }
+  wrapIssuerSparkWalletMethodsWithTracing() {
+    const methods = [
+      "getIssuerTokenBalance",
+      "getIssuerTokenMetadata",
+      "getIssuerTokenIdentifier",
+      "createToken",
+      "mintTokens",
+      "burnTokens",
+      "freezeTokens",
+      "unfreezeTokens",
+      "getIssuerTokenDistribution",
+      "announceTokenL1"
+    ];
+    methods.forEach(
+      (m) => this.wrapPublicIssuerSparkWalletMethodWithOtelSpan(m)
+    );
+  }
+};
+
+// src/issuer-wallet/issuer-spark-wallet.browser.ts
+var import_spark_sdk10 = require("@buildonspark/spark-sdk");
+var IssuerSparkWalletBrowser = class _IssuerSparkWalletBrowser extends IssuerSparkWallet {
+  static async initialize({
+    mnemonicOrSeed,
+    accountNumber,
+    signer,
+    options
+  }) {
+    const wallet = new _IssuerSparkWalletBrowser(options, signer);
+    wallet.initializeTracer(wallet);
+    const initResponse = await wallet.initWallet(mnemonicOrSeed, accountNumber);
+    return {
+      wallet,
+      ...initResponse
+    };
+  }
+  initializeTracerEnv({
+    spanProcessors,
+    traceUrls
+  }) {
+    (0, import_spark_sdk10.initializeTracerEnv)({ spanProcessors, traceUrls });
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -1,162 +1,14 @@
-import { SparkWallet, SparkWalletProps, ConfigOptions, SparkSigner, Bech32mTokenIdentifier } from '@buildonspark/spark-sdk';
-import { OutputWithPreviousTransactionData } from '@buildonspark/spark-sdk/proto/spark';
+import { I as IssuerSparkWallet } from './issuer-spark-wallet-BFzkv4X5.cjs';
+export { a as IssuerTokenMetadata, T as TokenDistribution } from './issuer-spark-wallet-BFzkv4X5.cjs';
+import { SparkWalletProps } from '@buildonspark/spark-sdk';
+import '@buildonspark/spark-sdk/proto/spark';
 
-/**
- * Token metadata containing essential information about issuer's token.
- * This is the wallet's internal representation with JavaScript-friendly types.
- *
- * rawTokenIdentifier: This is the raw binary token identifier - This is used to encode the human readable token identifier.
- *
- * tokenPublicKey: This is the hex-encoded public key of the token issuer - Same as issuerPublicKey.
- *
- * @example
- * ```typescript
- * const tokenMetadata: IssuerTokenMetadata = {
- *   rawTokenIdentifier: new Uint8Array([1, 2, 3]),
- *   tokenPublicKey: "0348fbb...",
- *   tokenName: "SparkToken",
- *   tokenTicker: "SPK",
- *   decimals: 8,
- *   maxSupply: 1000000n
- *   isFreezable: true
- * };
- * ```
- */
-type IssuerTokenMetadata = {
-    /** Raw binary token identifier - This is used to encode the human readable token identifier */
-    rawTokenIdentifier: Uint8Array;
-    /** Public key of the token issuer - Same as issuerPublicKey */
-    tokenPublicKey: string;
-    /** Human-readable name of the token (e.g., SparkToken)*/
-    tokenName: string;
-    /** Short ticker symbol for the token (e.g., "SPK") */
-    tokenTicker: string;
-    /** Number of decimal places for token amounts */
-    decimals: number;
-    /** Maximum supply of tokens that can ever be minted */
-    maxSupply: bigint;
-    /** Whether the token is freezable */
-    isFreezable: boolean;
-};
-interface TokenDistribution {
-    totalCirculatingSupply: bigint;
-    totalIssued: bigint;
-    totalBurned: bigint;
-    numHoldingAddress: number;
-    numConfirmedTransactions: bigint;
-}
-
-/**
- * Represents a Spark wallet with minting capabilities.
- * This class extends the base SparkWallet with additional functionality for token minting,
- * burning, and freezing operations.
- */
-declare class IssuerSparkWallet extends SparkWallet {
-    private issuerTokenTransactionService;
-    private tokenFreezeService;
-    protected tracerId: string;
-    /**
-     * Initializes a new IssuerSparkWallet instance.
-     * @param options - Configuration options for the wallet
-     * @returns An object containing the initialized wallet and initialization response
-     */
+declare class IssuerSparkWalletBrowser extends IssuerSparkWallet {
     static initialize({ mnemonicOrSeed, accountNumber, signer, options, }: SparkWalletProps): Promise<{
         mnemonic?: string | undefined;
-        wallet: IssuerSparkWallet;
-    }>;
-    private wrapIssuerSparkWalletWithTracing;
-    protected constructor(configOptions?: ConfigOptions, signer?: SparkSigner);
-    /**
-     * Gets the token balance for the issuer's token.
-     * @returns An object containing the token balance as a bigint
-     */
-    getIssuerTokenBalance(): Promise<{
-        tokenIdentifier: Bech32mTokenIdentifier | undefined;
-        balance: bigint;
-    }>;
-    /**
-     * Retrieves information about the issuer's token.
-     * @returns An object containing token information including public key, name, symbol, decimals, max supply, and freeze status
-     * @throws {NetworkError} If the token metadata cannot be retrieved
-     */
-    getIssuerTokenMetadata(): Promise<IssuerTokenMetadata>;
-    /**
-     * Retrieves the bech32m encoded token identifier for the issuer's token.
-     * @returns The bech32m encoded token identifier for the issuer's token
-     * @throws {NetworkError} If the token identifier cannot be retrieved
-     */
-    getIssuerTokenIdentifier(): Promise<Bech32mTokenIdentifier | null>;
-    /**
-     * Create a new token on Spark.
-     *
-     * @param params - Object containing token creation parameters.
-     * @param params.tokenName - The name of the token.
-     * @param params.tokenTicker - The ticker symbol for the token.
-     * @param params.decimals - The number of decimal places for the token.
-     * @param params.isFreezable - Whether the token can be frozen.
-     * @param [params.maxSupply=0n] - (Optional) The maximum supply of the token. Defaults to <code>0n</code>.
-     *
-     * @returns The transaction ID of the announcement.
-     *
-     * @throws {ValidationError} If `decimals` is not a safe integer or other validation fails.
-     * @throws {NetworkError} If the announcement transaction cannot be broadcast.
-     */
-    createToken({ tokenName, tokenTicker, decimals, isFreezable, maxSupply, }: {
-        tokenName: string;
-        tokenTicker: string;
-        decimals: number;
-        isFreezable: boolean;
-        maxSupply?: bigint;
-    }): Promise<string>;
-    /**
-     * Mints new tokens
-     * @param tokenAmount - The amount of tokens to mint
-     * @returns The transaction ID of the mint operation
-     */
-    mintTokens(tokenAmount: bigint): Promise<string>;
-    /**
-     * Burns issuer's tokens
-     * @param tokenAmount - The amount of tokens to burn
-     * @param selectedOutputs - Optional array of outputs to use for the burn operation
-     * @returns The transaction ID of the burn operation
-     */
-    burnTokens(tokenAmount: bigint, selectedOutputs?: OutputWithPreviousTransactionData[]): Promise<string>;
-    /**
-     * Freezes tokens associated with a specific Spark address.
-     * @param sparkAddress - The Spark address whose tokens should be frozen
-     * @returns An object containing the IDs of impacted outputs and the total amount of frozen tokens
-     */
-    freezeTokens(sparkAddress: string): Promise<{
-        impactedOutputIds: string[];
-        impactedTokenAmount: bigint;
-    }>;
-    /**
-     * Unfreezes previously frozen tokens associated with a specific Spark address.
-     * @param sparkAddress - The Spark address whose tokens should be unfrozen
-     * @returns An object containing the IDs of impacted outputs and the total amount of unfrozen tokens
-     */
-    unfreezeTokens(sparkAddress: string): Promise<{
-        impactedOutputIds: string[];
-        impactedTokenAmount: bigint;
+        wallet: IssuerSparkWalletBrowser;
     }>;
-    /**
-     * Retrieves the distribution information for the issuer's token.
-     * @throws {NotImplementedError} This feature is not yet supported
-     */
-    getIssuerTokenDistribution(): Promise<TokenDistribution>;
-    /**
-     * Announces a new token on the L1 (Bitcoin) network.
-     * @param tokenName - The name of the token
-     * @param tokenTicker - The ticker symbol for the token
-     * @param decimals - The number of decimal places for the token
-     * @param maxSupply - The maximum supply of the token
-     * @param isFreezable - Whether the token can be frozen
-     * @param feeRateSatsPerVb - The fee rate in satoshis per virtual byte (default: 4.0)
-     * @returns The transaction ID of the announcement
-     * @throws {ValidationError} If decimals is not a safe integer
-     * @throws {NetworkError} If the announcement transaction cannot be broadcast
-     */
-    announceTokenL1(tokenName: string, tokenTicker: string, decimals: number, maxSupply: bigint, isFreezable: boolean, feeRateSatsPerVb?: number): Promise<string>;
+    protected initializeTracerEnv({ spanProcessors, traceUrls, }: Parameters<IssuerSparkWallet["initializeTracerEnv"]>[0]): void;
 }
 
-export { IssuerSparkWallet, type IssuerTokenMetadata, type TokenDistribution };
+export { IssuerSparkWalletBrowser as IssuerSparkWallet };

package/dist/index.d.ts

@@ -1,162 +1,14 @@
-import { SparkWallet, SparkWalletProps, ConfigOptions, SparkSigner, Bech32mTokenIdentifier } from '@buildonspark/spark-sdk';
-import { OutputWithPreviousTransactionData } from '@buildonspark/spark-sdk/proto/spark';
+import { I as IssuerSparkWallet } from './issuer-spark-wallet-BFzkv4X5.js';
+export { a as IssuerTokenMetadata, T as TokenDistribution } from './issuer-spark-wallet-BFzkv4X5.js';
+import { SparkWalletProps } from '@buildonspark/spark-sdk';
+import '@buildonspark/spark-sdk/proto/spark';
 
-/**
- * Token metadata containing essential information about issuer's token.
- * This is the wallet's internal representation with JavaScript-friendly types.
- *
- * rawTokenIdentifier: This is the raw binary token identifier - This is used to encode the human readable token identifier.
- *
- * tokenPublicKey: This is the hex-encoded public key of the token issuer - Same as issuerPublicKey.
- *
- * @example
- * ```typescript
- * const tokenMetadata: IssuerTokenMetadata = {
- *   rawTokenIdentifier: new Uint8Array([1, 2, 3]),
- *   tokenPublicKey: "0348fbb...",
- *   tokenName: "SparkToken",
- *   tokenTicker: "SPK",
- *   decimals: 8,
- *   maxSupply: 1000000n
- *   isFreezable: true
- * };
- * ```
- */
-type IssuerTokenMetadata = {
-    /** Raw binary token identifier - This is used to encode the human readable token identifier */
-    rawTokenIdentifier: Uint8Array;
-    /** Public key of the token issuer - Same as issuerPublicKey */
-    tokenPublicKey: string;
-    /** Human-readable name of the token (e.g., SparkToken)*/
-    tokenName: string;
-    /** Short ticker symbol for the token (e.g., "SPK") */
-    tokenTicker: string;
-    /** Number of decimal places for token amounts */
-    decimals: number;
-    /** Maximum supply of tokens that can ever be minted */
-    maxSupply: bigint;
-    /** Whether the token is freezable */
-    isFreezable: boolean;
-};
-interface TokenDistribution {
-    totalCirculatingSupply: bigint;
-    totalIssued: bigint;
-    totalBurned: bigint;
-    numHoldingAddress: number;
-    numConfirmedTransactions: bigint;
-}
-
-/**
- * Represents a Spark wallet with minting capabilities.
- * This class extends the base SparkWallet with additional functionality for token minting,
- * burning, and freezing operations.
- */
-declare class IssuerSparkWallet extends SparkWallet {
-    private issuerTokenTransactionService;
-    private tokenFreezeService;
-    protected tracerId: string;
-    /**
-     * Initializes a new IssuerSparkWallet instance.
-     * @param options - Configuration options for the wallet
-     * @returns An object containing the initialized wallet and initialization response
-     */
+declare class IssuerSparkWalletBrowser extends IssuerSparkWallet {
     static initialize({ mnemonicOrSeed, accountNumber, signer, options, }: SparkWalletProps): Promise<{
         mnemonic?: string | undefined;
-        wallet: IssuerSparkWallet;
-    }>;
-    private wrapIssuerSparkWalletWithTracing;
-    protected constructor(configOptions?: ConfigOptions, signer?: SparkSigner);
-    /**
-     * Gets the token balance for the issuer's token.
-     * @returns An object containing the token balance as a bigint
-     */
-    getIssuerTokenBalance(): Promise<{
-        tokenIdentifier: Bech32mTokenIdentifier | undefined;
-        balance: bigint;
-    }>;
-    /**
-     * Retrieves information about the issuer's token.
-     * @returns An object containing token information including public key, name, symbol, decimals, max supply, and freeze status
-     * @throws {NetworkError} If the token metadata cannot be retrieved
-     */
-    getIssuerTokenMetadata(): Promise<IssuerTokenMetadata>;
-    /**
-     * Retrieves the bech32m encoded token identifier for the issuer's token.
-     * @returns The bech32m encoded token identifier for the issuer's token
-     * @throws {NetworkError} If the token identifier cannot be retrieved
-     */
-    getIssuerTokenIdentifier(): Promise<Bech32mTokenIdentifier | null>;
-    /**
-     * Create a new token on Spark.
-     *
-     * @param params - Object containing token creation parameters.
-     * @param params.tokenName - The name of the token.
-     * @param params.tokenTicker - The ticker symbol for the token.
-     * @param params.decimals - The number of decimal places for the token.
-     * @param params.isFreezable - Whether the token can be frozen.
-     * @param [params.maxSupply=0n] - (Optional) The maximum supply of the token. Defaults to <code>0n</code>.
-     *
-     * @returns The transaction ID of the announcement.
-     *
-     * @throws {ValidationError} If `decimals` is not a safe integer or other validation fails.
-     * @throws {NetworkError} If the announcement transaction cannot be broadcast.
-     */
-    createToken({ tokenName, tokenTicker, decimals, isFreezable, maxSupply, }: {
-        tokenName: string;
-        tokenTicker: string;
-        decimals: number;
-        isFreezable: boolean;
-        maxSupply?: bigint;
-    }): Promise<string>;
-    /**
-     * Mints new tokens
-     * @param tokenAmount - The amount of tokens to mint
-     * @returns The transaction ID of the mint operation
-     */
-    mintTokens(tokenAmount: bigint): Promise<string>;
-    /**
-     * Burns issuer's tokens
-     * @param tokenAmount - The amount of tokens to burn
-     * @param selectedOutputs - Optional array of outputs to use for the burn operation
-     * @returns The transaction ID of the burn operation
-     */
-    burnTokens(tokenAmount: bigint, selectedOutputs?: OutputWithPreviousTransactionData[]): Promise<string>;
-    /**
-     * Freezes tokens associated with a specific Spark address.
-     * @param sparkAddress - The Spark address whose tokens should be frozen
-     * @returns An object containing the IDs of impacted outputs and the total amount of frozen tokens
-     */
-    freezeTokens(sparkAddress: string): Promise<{
-        impactedOutputIds: string[];
-        impactedTokenAmount: bigint;
-    }>;
-    /**
-     * Unfreezes previously frozen tokens associated with a specific Spark address.
-     * @param sparkAddress - The Spark address whose tokens should be unfrozen
-     * @returns An object containing the IDs of impacted outputs and the total amount of unfrozen tokens
-     */
-    unfreezeTokens(sparkAddress: string): Promise<{
-        impactedOutputIds: string[];
-        impactedTokenAmount: bigint;
+        wallet: IssuerSparkWalletBrowser;
     }>;
-    /**
-     * Retrieves the distribution information for the issuer's token.
-     * @throws {NotImplementedError} This feature is not yet supported
-     */
-    getIssuerTokenDistribution(): Promise<TokenDistribution>;
-    /**
-     * Announces a new token on the L1 (Bitcoin) network.
-     * @param tokenName - The name of the token
-     * @param tokenTicker - The ticker symbol for the token
-     * @param decimals - The number of decimal places for the token
-     * @param maxSupply - The maximum supply of the token
-     * @param isFreezable - Whether the token can be frozen
-     * @param feeRateSatsPerVb - The fee rate in satoshis per virtual byte (default: 4.0)
-     * @returns The transaction ID of the announcement
-     * @throws {ValidationError} If decimals is not a safe integer
-     * @throws {NetworkError} If the announcement transaction cannot be broadcast
-     */
-    announceTokenL1(tokenName: string, tokenTicker: string, decimals: number, maxSupply: bigint, isFreezable: boolean, feeRateSatsPerVb?: number): Promise<string>;
+    protected initializeTracerEnv({ spanProcessors, traceUrls, }: Parameters<IssuerSparkWallet["initializeTracerEnv"]>[0]): void;
 }
 
-export { IssuerSparkWallet, type IssuerTokenMetadata, type TokenDistribution };
+export { IssuerSparkWalletBrowser as IssuerSparkWallet };