Create New Carbon Token

For a non-technical overview of Carbon and SmartNFTs, see Carbon: Native Assets on Phantasma Phoenix.

This page focuses on the technical steps to create a Carbon token.

Creating a New Carbon Token

The following code snippet demonstrates how to create a new Carbon token.

Imports

These are the imports typically required for creating a Carbon token:

import {
  Bytes32,
  CreateTokenFeeOptions,
  CreateTokenTxHelper,
  IntX,
  PhantasmaAPI,
  PhantasmaKeys,
  TokenInfoBuilder,
  TokenMetadataBuilder,
  TokenSchemasBuilder,
} from "phantasma-sdk-ts";

Initialize Deployer Keys

In the following examples, we will use the deployer’s PhantasmaKeys keypair and its Bytes32 public key.

  // Initialize PhantasmaKeys using WIF-encoded private key
  const txSender = PhantasmaKeys.fromWIF("YOUR_WIF");
  // Get the public key from the keypair
  const senderPubKey = new Bytes32(txSender.PublicKey);

Build Token Info

TokenInfoBuilder helps construct the class describing the token being deployed.

  const tokenSchemas = TokenSchemasBuilder.prepareStandard(true);

  const metadata = TokenMetadataBuilder.buildAndSerialize({
    name: "My NFT",
    description: "Example NFT",
    icon: "data:image/png;base64,...",
    url: "https://example.com",
  });

  const info = TokenInfoBuilder.build(
    "MYNFT", // New token symbol
    IntX.fromI64(0n), // Maximum token supply, or 0 for unlimited supply
    true, // Whether the token is non-fungible (NFT) or not (fungible). Currently, only NFTs are supported
    0, // Token decimals (always 0 for NFTs)
    senderPubKey, // Public key of the token creator
    metadata, // Token metadata (required for all tokens; values are strings)
    tokenSchemas,
  );

Set Token Creation Fees

CreateTokenFeeOptions is used to specify the fees for token creation. You can call the constructor without arguments to use default values.

  const feeOptions = new CreateTokenFeeOptions(
    10000, // Base fee
    10000000000, // Create token base fee
    10000000000, // Create token symbol fee
    10000 // Fee multiplier
  );

Build and Sign the Transaction

CreateTokenTxHelper simplifies the process of building and signing the token creation transaction.

  const maxData = 1_000_000_000n;
  const tx = CreateTokenTxHelper.buildTxAndSignHex(
    info, // TokenInfo instance built with TokenInfoBuilder
    txSender, // Keypair used to sign the transaction
    feeOptions, // Fee options defined above
    maxData // Create token max data (use this default value if unsure)
  );

Broadcast the Transaction

Broadcast the transaction to the network.

  const rpc = new PhantasmaAPI("https://testnet.phantasma.info/rpc", undefined as any, "testnet");

  // Use sendCarbonTransaction() to call Carbon methods
  const txHash = await rpc.sendCarbonTransaction(tx);

Parse the Result

After the transaction is mined and its result is available, parse it to obtain the new Carbon token ID. This ID can later be used to create token series and mint new NFTs.

  // Wait for transaction confirmation...
  const txInfo = await rpc.getTransaction(txHash);

  if (txInfo.state === "Halt") {
    const tokenId = CreateTokenTxHelper.parseResult(txInfo.result);
  } else {
    // Handle transaction failure
  }

For frontend signing, build a TxMsg via CreateTokenTxHelper.buildTx(...) and use PhantasmaLink.signCarbonTxAndBroadcast or EasyConnect.signCarbonTransaction.