@buildonspark/issuer-sdk 0.1.0 → 0.1.2

package/dist/native/index.react-native.d.ts

@@ -38,6 +38,8 @@ type IssuerTokenMetadata = {
     maxSupply: bigint;
     /** Whether the token is freezable */
     isFreezable: boolean;
+    /** Extra metadata of the token */
+    extraMetadata?: Uint8Array;
 };
 interface TokenDistribution {
     totalCirculatingSupply: bigint;
@@ -90,18 +92,20 @@ declare abstract class IssuerSparkWallet extends SparkWallet {
      * @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>.
+     * @param params.extraMetadata - (Optional) This can be used to store additional bytes data to be associated with a token, like image data.
      *
      * @returns The transaction ID of the announcement.
      *
      * @throws {SparkValidationError} If `decimals` is not a safe integer or other validation fails.
      * @throws {SparkRequestError} If the announcement transaction cannot be broadcast.
      */
-    createToken({ tokenName, tokenTicker, decimals, isFreezable, maxSupply, }: {
+    createToken({ tokenName, tokenTicker, decimals, isFreezable, maxSupply, extraMetadata, }: {
         tokenName: string;
         tokenTicker: string;
         decimals: number;
         isFreezable: boolean;
         maxSupply?: bigint;
+        extraMetadata?: Uint8Array;
     }): Promise<string>;
     /**
      * Mints new tokens

package/dist/native/index.react-native.js

@@ -215,7 +215,7 @@ var IssuerTokenTransactionService = class extends TokenTransactionService {
       ]
     };
   }
-  async constructCreateTokenTransaction(tokenPublicKey, tokenName, tokenTicker, decimals, maxSupply, isFreezable) {
+  async constructCreateTokenTransaction(tokenPublicKey, tokenName, tokenTicker, decimals, maxSupply, isFreezable, extraMetadata) {
     return {
       version: 2,
       network: this.config.getNetworkProto(),
@@ -227,7 +227,8 @@ var IssuerTokenTransactionService = class extends TokenTransactionService {
           tokenTicker,
           decimals,
           maxSupply: numberToBytesBE(maxSupply, 16),
-          isFreezable
+          isFreezable,
+          extraMetadata
         }
       },
       tokenOutputs: [],
@@ -237,7 +238,7 @@ var IssuerTokenTransactionService = class extends TokenTransactionService {
       invoiceAttachments: []
     };
   }
-  async constructPartialCreateTokenTransaction(tokenPublicKey, tokenName, tokenTicker, decimals, maxSupply, isFreezable) {
+  async constructPartialCreateTokenTransaction(tokenPublicKey, tokenName, tokenTicker, decimals, maxSupply, isFreezable, extraMetadata) {
     return {
       version: 3,
       tokenTransactionMetadata: {
@@ -255,7 +256,8 @@ var IssuerTokenTransactionService = class extends TokenTransactionService {
           tokenTicker,
           decimals,
           maxSupply: numberToBytesBE(maxSupply, 16),
-          isFreezable
+          isFreezable,
+          extraMetadata
         }
       },
       partialTokenOutputs: []
@@ -274,7 +276,8 @@ var MIN_SYMBOL_SIZE = 3;
 var MAX_SYMBOL_SIZE = 6;
 var MAX_DECIMALS = 255;
 var MAXIMUM_MAX_SUPPLY = (1n << 128n) - 1n;
-function validateTokenParameters(tokenName, tokenTicker, decimals, maxSupply) {
+var MAX_TOKEN_CONTENT_SIZE = 1024;
+function validateTokenParameters(tokenName, tokenTicker, decimals, maxSupply, extraMetadata) {
   if (!isNfcNormalized(tokenName)) {
     throw new SparkValidationError2("Token name must be NFC-normalised UTF-8", {
       field: "tokenName",
@@ -333,6 +336,16 @@ function validateTokenParameters(tokenName, tokenTicker, decimals, maxSupply) {
       expected: `>=0 and <=${MAXIMUM_MAX_SUPPLY.toString()}`
     });
   }
+  if (extraMetadata && extraMetadata.length > MAX_TOKEN_CONTENT_SIZE) {
+    throw new SparkValidationError2(
+      `Extra metadata must be less than ${MAX_TOKEN_CONTENT_SIZE} bytes`,
+      {
+        field: "extraMetadata",
+        value: extraMetadata.length,
+        expected: `<${MAX_TOKEN_CONTENT_SIZE}`
+      }
+    );
+  }
 }
 
 // src/issuer-wallet/issuer-spark-wallet.ts
@@ -398,7 +411,8 @@ var IssuerSparkWallet = class extends SparkWallet {
         tokenTicker: metadata.tokenTicker,
         decimals: metadata.decimals,
         maxSupply: bytesToNumberBE(metadata.maxSupply),
-        isFreezable: metadata.isFreezable
+        isFreezable: metadata.isFreezable,
+        extraMetadata: metadata.extraMetadata ? new Uint8Array(metadata.extraMetadata) : void 0
       };
     }
     const sparkTokenClient = await this.connectionManager.createSparkTokenClient(
@@ -433,7 +447,8 @@ var IssuerSparkWallet = class extends SparkWallet {
         tokenTicker: metadata.tokenTicker,
         decimals: metadata.decimals,
         maxSupply: bytesToNumberBE(metadata.maxSupply),
-        isFreezable: metadata.isFreezable
+        isFreezable: metadata.isFreezable,
+        extraMetadata: metadata.extraMetadata
       };
     } catch (error) {
       throw new SparkRequestError2("Failed to fetch token metadata", { error });
@@ -460,6 +475,7 @@ var IssuerSparkWallet = class extends SparkWallet {
    * @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>.
+   * @param params.extraMetadata - (Optional) This can be used to store additional bytes data to be associated with a token, like image data.
    *
    * @returns The transaction ID of the announcement.
    *
@@ -471,9 +487,16 @@ var IssuerSparkWallet = class extends SparkWallet {
     tokenTicker,
     decimals,
     isFreezable,
-    maxSupply = 0n
+    maxSupply = 0n,
+    extraMetadata
   }) {
-    validateTokenParameters(tokenName, tokenTicker, decimals, maxSupply);
+    validateTokenParameters(
+      tokenName,
+      tokenTicker,
+      decimals,
+      maxSupply,
+      extraMetadata
+    );
     const issuerPublicKey = await super.getIdentityPublicKey();
     if (this.config.getTokenTransactionVersion() === "V2") {
       const tokenTransaction = await this.issuerTokenTransactionService.constructCreateTokenTransaction(
@@ -482,7 +505,8 @@ var IssuerSparkWallet = class extends SparkWallet {
         tokenTicker,
         decimals,
         maxSupply,
-        isFreezable
+        isFreezable,
+        extraMetadata
       );
       return await this.issuerTokenTransactionService.broadcastTokenTransaction(
         tokenTransaction
@@ -494,7 +518,8 @@ var IssuerSparkWallet = class extends SparkWallet {
         tokenTicker,
         decimals,
         maxSupply,
-        isFreezable
+        isFreezable,
+        extraMetadata
       );
       return await this.issuerTokenTransactionService.broadcastTokenTransactionV3(
         partialTokenTransaction

package/dist/proto/spark.d.cts

@@ -1,4 +1,4 @@
 export * from '@buildonspark/spark-sdk/proto/spark';
 import '@buildonspark/spark-sdk/proto/spark_token';
-import '@buildonspark/spark-sdk/types';
 import '@buildonspark/spark-sdk/test-utils';
+import '@buildonspark/spark-sdk/types';

package/dist/proto/spark.d.ts

@@ -1,4 +1,4 @@
 export * from '@buildonspark/spark-sdk/proto/spark';
 import '@buildonspark/spark-sdk/proto/spark_token';
-import '@buildonspark/spark-sdk/types';
 import '@buildonspark/spark-sdk/test-utils';
+import '@buildonspark/spark-sdk/types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildonspark/issuer-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Spark Issuer SDK for token issuance",
   "license": "Apache-2.0",
   "main": "./dist/index.browser.js",
@@ -76,7 +76,7 @@
     "types": "tsc"
   },
   "dependencies": {
-    "@buildonspark/spark-sdk": "0.5.0",
+    "@buildonspark/spark-sdk": "0.5.2",
     "@noble/curves": "^1.8.0",
     "@scure/btc-signer": "^1.5.0",
     "buffer": "^6.0.3"
@@ -90,7 +90,7 @@
     "jest": "^29.7.0",
     "madge": "^8.0.0",
     "node-fetch": "^3.3.2",
-    "prettier": "^3.6.2",
+    "prettier": "^3.7.4",
     "publint": "^0.3.9",
     "react": "19.0.0",
     "react-native": "0.79.4",

package/src/issuer-wallet/issuer-spark-wallet.ts

@@ -97,6 +97,9 @@ export abstract class IssuerSparkWallet extends SparkWallet {
         decimals: metadata.decimals,
         maxSupply: bytesToNumberBE(metadata.maxSupply),
         isFreezable: metadata.isFreezable,
+        extraMetadata: metadata.extraMetadata
+          ? new Uint8Array(metadata.extraMetadata)
+          : undefined,
       };
     }
 
@@ -135,6 +138,7 @@ export abstract class IssuerSparkWallet extends SparkWallet {
         decimals: metadata.decimals,
         maxSupply: bytesToNumberBE(metadata.maxSupply),
         isFreezable: metadata.isFreezable,
+        extraMetadata: metadata.extraMetadata,
       };
     } catch (error) {
       throw new SparkRequestError("Failed to fetch token metadata", { error });
@@ -164,6 +168,7 @@ export abstract class IssuerSparkWallet extends SparkWallet {
    * @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>.
+   * @param params.extraMetadata - (Optional) This can be used to store additional bytes data to be associated with a token, like image data.
    *
    * @returns The transaction ID of the announcement.
    *
@@ -176,14 +181,22 @@ export abstract class IssuerSparkWallet extends SparkWallet {
     decimals,
     isFreezable,
     maxSupply = 0n,
+    extraMetadata,
   }: {
     tokenName: string;
     tokenTicker: string;
     decimals: number;
     isFreezable: boolean;
     maxSupply?: bigint;
+    extraMetadata?: Uint8Array;
   }): Promise<string> {
-    validateTokenParameters(tokenName, tokenTicker, decimals, maxSupply);
+    validateTokenParameters(
+      tokenName,
+      tokenTicker,
+      decimals,
+      maxSupply,
+      extraMetadata,
+    );
 
     const issuerPublicKey = await super.getIdentityPublicKey();
 
@@ -196,6 +209,7 @@ export abstract class IssuerSparkWallet extends SparkWallet {
           decimals,
           maxSupply,
           isFreezable,
+          extraMetadata,
         );
 
       return await this.issuerTokenTransactionService.broadcastTokenTransaction(
@@ -210,6 +224,7 @@ export abstract class IssuerSparkWallet extends SparkWallet {
           decimals,
           maxSupply,
           isFreezable,
+          extraMetadata,
         );
 
       return await this.issuerTokenTransactionService.broadcastTokenTransactionV3(

package/src/issuer-wallet/types.ts

@@ -34,6 +34,8 @@ export type IssuerTokenMetadata = {
   maxSupply: bigint;
   /** Whether the token is freezable */
   isFreezable: boolean;
+  /** Extra metadata of the token */
+  extraMetadata?: Uint8Array;
 };
 
 export interface TokenDistribution {

package/src/services/token-transactions.ts

@@ -90,6 +90,7 @@ export class IssuerTokenTransactionService extends TokenTransactionService {
     decimals: number,
     maxSupply: bigint,
     isFreezable: boolean,
+    extraMetadata: Uint8Array | undefined,
   ): Promise<TokenTransaction> {
     return {
       version: 2,
@@ -103,6 +104,7 @@ export class IssuerTokenTransactionService extends TokenTransactionService {
           decimals: decimals,
           maxSupply: numberToBytesBE(maxSupply, 16),
           isFreezable: isFreezable,
+          extraMetadata: extraMetadata,
         },
       },
       tokenOutputs: [],
@@ -121,6 +123,7 @@ export class IssuerTokenTransactionService extends TokenTransactionService {
     decimals: number,
     maxSupply: bigint,
     isFreezable: boolean,
+    extraMetadata?: Uint8Array,
   ): Promise<PartialTokenTransaction> {
     return {
       version: 3,
@@ -142,6 +145,7 @@ export class IssuerTokenTransactionService extends TokenTransactionService {
           decimals: decimals,
           maxSupply: numberToBytesBE(maxSupply, 16),
           isFreezable: isFreezable,
+          extraMetadata: extraMetadata,
         },
       },
       partialTokenOutputs: [],

package/src/tests/integration/nft-creation.test.ts

@@ -0,0 +1,86 @@
+import { jest } from "@jest/globals";
+import { IssuerSparkWalletTesting } from "../utils/issuer-test-wallet.js";
+import { TEST_CONFIGS } from "./test-configs.js";
+import { MAX_TOKEN_CONTENT_SIZE } from "../../utils/create-validation.js";
+
+describe.each(TEST_CONFIGS)(
+  "nft creation tests - $name",
+  ({ name, config }) => {
+    jest.setTimeout(80000);
+
+    it("should create an nft", async () => {
+      const { wallet: issuerWallet } =
+        await IssuerSparkWalletTesting.initialize({
+          options: config,
+        });
+
+      const tokenName = `${name}NFT`;
+      const tokenTicker = "NFT";
+      const extraMetadata = new Uint8Array([1, 2, 3]);
+      const createTransactionId = await issuerWallet.createToken({
+        tokenName,
+        tokenTicker,
+        decimals: 0,
+        isFreezable: false,
+        maxSupply: 1n,
+        extraMetadata,
+      });
+
+      expect(typeof createTransactionId).toBe("string");
+      expect(createTransactionId.length).toBeGreaterThan(0);
+
+      const metadata = await issuerWallet.getIssuerTokenMetadata();
+      expect(metadata.tokenName).toEqual(tokenName);
+      expect(metadata.tokenTicker).toEqual(tokenTicker);
+      expect(metadata.maxSupply).toEqual(1n);
+      expect(metadata.decimals).toEqual(0);
+      expect(Array.from(metadata.extraMetadata!)).toEqual(
+        Array.from(extraMetadata),
+      );
+
+      const txId = await issuerWallet.mintTokens(1n);
+      expect(typeof txId).toBe("string");
+      expect(txId.length).toBeGreaterThan(0);
+
+      const tokenIdentifier = await issuerWallet.getIssuerTokenIdentifier();
+      expect(tokenIdentifier).toBeDefined();
+      expect(tokenIdentifier!.length).toBeGreaterThan(0);
+
+      const { balance: satsBalance, tokenBalances: tokenBalancesMap } =
+        await issuerWallet.getBalance();
+      expect(satsBalance).toEqual(0n);
+      expect(tokenBalancesMap.size).toEqual(1);
+      expect(tokenBalancesMap.get(tokenIdentifier)).toBeDefined();
+      expect(tokenBalancesMap.get(tokenIdentifier)?.balance).toEqual(1n);
+
+      const tokenMetadata =
+        tokenBalancesMap.get(tokenIdentifier)?.tokenMetadata;
+      expect(tokenMetadata).toBeDefined();
+      expect(tokenMetadata?.tokenName).toEqual(tokenName);
+      expect(tokenMetadata?.tokenTicker).toEqual(tokenTicker);
+      expect(tokenMetadata?.maxSupply).toEqual(1n);
+      expect(tokenMetadata?.decimals).toEqual(0);
+      expect(tokenMetadata?.extraMetadata).toEqual(extraMetadata);
+    });
+
+    it("should fail to create an nft with extra metadata longer than MAX_TOKEN_CONTENT_SIZE bytes", async () => {
+      const { wallet: issuerWallet } =
+        await IssuerSparkWalletTesting.initialize({
+          options: config,
+        });
+
+      const extraMetadata = new Uint8Array(MAX_TOKEN_CONTENT_SIZE + 1);
+
+      await expect(
+        issuerWallet.createToken({
+          tokenName: "NFTLONGMETADATA",
+          tokenTicker: "NFTLONG",
+          decimals: 0,
+          isFreezable: false,
+          maxSupply: 1n,
+          extraMetadata,
+        }),
+      ).rejects.toThrow();
+    });
+  },
+);

package/src/tests/integration/test-configs.ts

@@ -0,0 +1,32 @@
+import { ConfigOptions, WalletConfig } from "@buildonspark/spark-sdk";
+
+export const TOKENS_SCHNORR_V2_CONFIG: Required<ConfigOptions> = {
+  ...WalletConfig.LOCAL,
+  tokenSignatures: "SCHNORR",
+  tokenTransactionVersion: "V2",
+};
+
+export const TOKENS_SCHNORR_V3_CONFIG: Required<ConfigOptions> = {
+  ...WalletConfig.LOCAL,
+  tokenSignatures: "SCHNORR",
+  tokenTransactionVersion: "V3",
+};
+
+export const TOKENS_ECDSA_V2_CONFIG: Required<ConfigOptions> = {
+  ...WalletConfig.LOCAL,
+  tokenSignatures: "ECDSA",
+  tokenTransactionVersion: "V2",
+};
+
+export const TOKENS_ECDSA_V3_CONFIG: Required<ConfigOptions> = {
+  ...WalletConfig.LOCAL,
+  tokenSignatures: "ECDSA",
+  tokenTransactionVersion: "V3",
+};
+
+export const TEST_CONFIGS = [
+  { name: "E2", config: TOKENS_ECDSA_V2_CONFIG },
+  { name: "E3", config: TOKENS_ECDSA_V3_CONFIG },
+  { name: "S2", config: TOKENS_SCHNORR_V2_CONFIG },
+  { name: "S3", config: TOKENS_SCHNORR_V3_CONFIG },
+];

package/src/tests/integration/token-creation.test.ts

@@ -1,21 +1,6 @@
-import { ConfigOptions, WalletConfig } from "@buildonspark/spark-sdk";
 import { jest } from "@jest/globals";
 import { IssuerSparkWalletTesting } from "../utils/issuer-test-wallet.js";
-
-export const TOKENS_SCHNORR_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "SCHNORR",
-};
-
-export const TOKENS_ECDSA_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "ECDSA",
-};
-
-const TEST_CONFIGS = [
-  { name: "TE", config: TOKENS_ECDSA_CONFIG },
-  { name: "TS", config: TOKENS_SCHNORR_CONFIG },
-];
+import { TEST_CONFIGS } from "./test-configs.js";
 
 describe.each(TEST_CONFIGS)(
   "token creation tests - $name",

package/src/tests/integration/token-invoices.test.ts

@@ -1,8 +1,6 @@
 import {
-  ConfigOptions,
   filterTokenBalanceForTokenIdentifier,
   SparkRequestError,
-  WalletConfig,
 } from "@buildonspark/spark-sdk";
 import { jest } from "@jest/globals";
 import { IssuerSparkWalletTesting } from "../utils/issuer-test-wallet.js";
@@ -11,21 +9,7 @@ import {
   SparkWalletTesting,
 } from "@buildonspark/spark-sdk/test-utils";
 import { InvoiceStatus } from "@buildonspark/spark-sdk/proto/spark";
-
-export const TOKENS_SCHNORR_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "SCHNORR",
-};
-
-export const TOKENS_ECDSA_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "ECDSA",
-};
-
-const TEST_CONFIGS = [
-  { name: "TE", config: TOKENS_ECDSA_CONFIG },
-  { name: "TS", config: TOKENS_SCHNORR_CONFIG },
-];
+import { TEST_CONFIGS } from "./test-configs.js";
 
 describe.each(TEST_CONFIGS)(
   "token invoice tests - $name",

package/src/tests/integration/token-lifecycle.test.ts

@@ -1,26 +1,8 @@
-import {
-  ConfigOptions,
-  filterTokenBalanceForTokenIdentifier,
-  WalletConfig,
-} from "@buildonspark/spark-sdk";
+import { filterTokenBalanceForTokenIdentifier } from "@buildonspark/spark-sdk";
 import { jest } from "@jest/globals";
 import { IssuerSparkWalletTesting } from "../utils/issuer-test-wallet.js";
 import { SparkWalletTesting } from "@buildonspark/spark-sdk/test-utils";
-
-export const TOKENS_SCHNORR_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "SCHNORR",
-};
-
-export const TOKENS_ECDSA_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "ECDSA",
-};
-
-const TEST_CONFIGS = [
-  { name: "TE", config: TOKENS_ECDSA_CONFIG },
-  { name: "TS", config: TOKENS_SCHNORR_CONFIG },
-];
+import { TEST_CONFIGS } from "./test-configs.js";
 
 describe.each(TEST_CONFIGS)(
   "token lifecycle tests - $name",

package/src/tests/integration/token-minting.test.ts

@@ -1,21 +1,6 @@
-import { ConfigOptions, WalletConfig } from "@buildonspark/spark-sdk";
 import { jest } from "@jest/globals";
 import { IssuerSparkWalletTesting } from "../utils/issuer-test-wallet.js";
-
-export const TOKENS_SCHNORR_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "SCHNORR",
-};
-
-export const TOKENS_ECDSA_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "ECDSA",
-};
-
-const TEST_CONFIGS = [
-  { name: "TE", config: TOKENS_ECDSA_CONFIG },
-  { name: "TS", config: TOKENS_SCHNORR_CONFIG },
-];
+import { TEST_CONFIGS } from "./test-configs.js";
 
 describe.each(TEST_CONFIGS)(
   "token minting tests - $name",

package/src/tests/integration/token-monitoring.test.ts

@@ -1,27 +1,9 @@
-import {
-  ConfigOptions,
-  filterTokenBalanceForTokenIdentifier,
-  WalletConfig,
-} from "@buildonspark/spark-sdk";
+import { filterTokenBalanceForTokenIdentifier } from "@buildonspark/spark-sdk";
 import { jest } from "@jest/globals";
 import { bytesToHex } from "@noble/curves/utils";
 import { IssuerSparkWalletTesting } from "../utils/issuer-test-wallet.js";
 import { SparkWalletTesting } from "@buildonspark/spark-sdk/test-utils";
-
-export const TOKENS_SCHNORR_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "SCHNORR",
-};
-
-export const TOKENS_ECDSA_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "ECDSA",
-};
-
-const TEST_CONFIGS = [
-  { name: "TE", config: TOKENS_ECDSA_CONFIG },
-  { name: "TS", config: TOKENS_SCHNORR_CONFIG },
-];
+import { TEST_CONFIGS } from "./test-configs.js";
 
 describe.each(TEST_CONFIGS)(
   "token monitoring tests - $name",
@@ -202,9 +184,10 @@ describe.each(TEST_CONFIGS)(
       }
 
       for (let index = 0; index < 100; ++index) {
-        await issuerWallet.mintTokens(tokenAmount);
+        const dynamicAmount = BigInt(index + 1);
+        await issuerWallet.mintTokens(dynamicAmount);
         await issuerWallet.transferTokens({
-          tokenAmount,
+          tokenAmount: dynamicAmount,
           tokenIdentifier: tokenIdentifier!,
           receiverSparkAddress: await userWallet.getSparkAddress(),
         });

package/src/tests/integration/token-outputs.test.ts

@@ -1,26 +1,8 @@
-import {
-  ConfigOptions,
-  filterTokenBalanceForTokenIdentifier,
-  WalletConfig,
-} from "@buildonspark/spark-sdk";
+import { filterTokenBalanceForTokenIdentifier } from "@buildonspark/spark-sdk";
 import { jest } from "@jest/globals";
 import { IssuerSparkWalletTesting } from "../utils/issuer-test-wallet.js";
 import { SparkWalletTesting } from "@buildonspark/spark-sdk/test-utils";
-
-export const TOKENS_SCHNORR_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "SCHNORR",
-};
-
-export const TOKENS_ECDSA_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "ECDSA",
-};
-
-const TEST_CONFIGS = [
-  { name: "TE", config: TOKENS_ECDSA_CONFIG },
-  { name: "TS", config: TOKENS_SCHNORR_CONFIG },
-];
+import { TEST_CONFIGS } from "./test-configs.js";
 
 describe.each(TEST_CONFIGS)(
   "token output tests - $name",

package/src/tests/integration/token-transfers.test.ts

@@ -1,26 +1,8 @@
-import {
-  ConfigOptions,
-  filterTokenBalanceForTokenIdentifier,
-  WalletConfig,
-} from "@buildonspark/spark-sdk";
+import { filterTokenBalanceForTokenIdentifier } from "@buildonspark/spark-sdk";
 import { jest } from "@jest/globals";
 import { IssuerSparkWalletTesting } from "../utils/issuer-test-wallet.js";
 import { SparkWalletTesting } from "@buildonspark/spark-sdk/test-utils";
-
-export const TOKENS_SCHNORR_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "SCHNORR",
-};
-
-export const TOKENS_ECDSA_CONFIG: Required<ConfigOptions> = {
-  ...WalletConfig.LOCAL,
-  tokenSignatures: "ECDSA",
-};
-
-const TEST_CONFIGS = [
-  { name: "TE", config: TOKENS_ECDSA_CONFIG },
-  { name: "TS", config: TOKENS_SCHNORR_CONFIG },
-];
+import { TEST_CONFIGS } from "./test-configs.js";
 
 describe.each(TEST_CONFIGS)(
   "token transfer tests - $name",

package/src/utils/create-validation.ts

@@ -18,12 +18,14 @@ const MIN_SYMBOL_SIZE = 3; // bytes
 const MAX_SYMBOL_SIZE = 6; // bytes
 const MAX_DECIMALS = 255; // fits into single byte
 const MAXIMUM_MAX_SUPPLY = (1n << 128n) - 1n; // fits into 16 bytes (u128)
+export const MAX_TOKEN_CONTENT_SIZE = 1024; // fits into 1024 bytes
 
 export function validateTokenParameters(
   tokenName: string,
   tokenTicker: string,
   decimals: number,
   maxSupply: bigint,
+  extraMetadata?: Uint8Array,
 ) {
   if (!isNfcNormalized(tokenName)) {
     throw new SparkValidationError("Token name must be NFC-normalised UTF-8", {
@@ -92,4 +94,15 @@ export function validateTokenParameters(
       expected: `>=0 and <=${MAXIMUM_MAX_SUPPLY.toString()}`,
     });
   }
+
+  if (extraMetadata && extraMetadata.length > MAX_TOKEN_CONTENT_SIZE) {
+    throw new SparkValidationError(
+      `Extra metadata must be less than ${MAX_TOKEN_CONTENT_SIZE} bytes`,
+      {
+        field: "extraMetadata",
+        value: extraMetadata.length,
+        expected: `<${MAX_TOKEN_CONTENT_SIZE}`,
+      },
+    );
+  }
 }