Token

The thru token command provides comprehensive token management functionality, including minting, transfers, account management, and administrative operations.

Tip

Transaction Fees: Currently all transaction fees are set to 0. Transaction fees will be implemented and charged in future releases.

Prerequisites

• CLI setup with configured keys and RPC endpoint

Command Overview

Initialize Mint Create a new token with specified properties

Initialize Account Create token accounts for holding tokens

Transfer Move tokens between accounts

Mint To Create new tokens and add to account

Burn Permanently destroy tokens

Close Account Close token accounts and reclaim balance

Freeze Account Freeze accounts to prevent transfers

Thaw Account Unfreeze previously frozen accounts

Derive Mint Account Calculate mint account address from creator and seed

Derive Token Account Calculate token account address from mint, owner, and seed

Initialize Mint

Create a new mint account on the blockchain and initialize it as a token mint with specified properties.

thru token initialize-mint $creator $ticker $seed [OPTIONS]

creator · string · required

Creator address used for mint account derivation, formatted as a 46-char ta…[address] or 64-char hex key. Effectively, this must be the feepayer.

ticker · string · required

Token symbol, maximum 8 characters (e.g., “USDC”, “ETH”)

seed · string · required

32-byte hex string for deterministic mint address derivation. To convert a readable string into a zero-padded 32-byte seed, run thru program seed-to-hex $seed.

string

Optional mint authority address. If omitted, the creator is used as mint authority.

string

Optional hex-encoded state proof for mint account creation. If not provided, the state proof is automatically generated.

string

Address that can freeze/unfreeze token accounts (optional)

integer

Number of decimal places for token precision (0-18)

string

Account to pay transaction fees

Example:

Basic mint

thru token initialize-mint \
  ta...[creator] \
  GOLD \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

With freeze authority

thru token initialize-mint \
  ta...[creator] \
  SILVER \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \
  --freeze-authority ta...[freeze_authority] \
  --decimals 6

Custom state proof

thru token initialize-mint \
  ta...[creator] \
  BRONZE \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \
  --state-proof a1b2c3d4e5f6789... \
  --fee-payer treasury

Tip

On success, the mint is created and can be used for token operations

Initialize Account

Create a new token account on the blockchain that can hold tokens from a specific mint.

Note

Address Derivation: Token account addresses are automatically derived using SHA256(owner + mint + user_seed), creating a unique address for each mint and owner combination. You can verify the derived address using derive-token-account.

thru token initialize-account $mint $owner $seed [OPTIONS]

mint · string · required

The mint address for which to create an account

owner · string · required

Address that will own and control this token account

seed · string · required

32-byte hex string for deterministic account address derivation. This seed is hashed with the owner and mint to create the final token account address.

string

Optional hex-encoded state proof for token account creation. If not provided, the state proof is automatically generated.

string

Account to pay transaction fees

Example:

Create account

thru token initialize-account \
  ta...[mint] \
  ta...[owner] \
  fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210

With custom fee payer

thru token initialize-account \
  ta...[mint] \
  ta...[owner] \
  fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 \
  --fee-payer treasury

Custom state proof

thru token initialize-account \
  ta...[mint] \
  ta...[owner] \
  fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210 \
  --state-proof f9e8d7c6b5a4321... \
  --fee-payer treasury

Tip

Use derive-token-account to verify the account address that will be automatically created

Transfer

Transfer tokens between two token accounts. Both accounts must be associated with the same mint, and neither account can be frozen. The fee payer must be the owner of the source token account to authorize the transfer.

thru token transfer $from $to $amount [OPTIONS]

from · string · required

Source token account address

to · string · required

Destination token account address

amount · integer · required

Amount to transfer (in smallest token units)

string

Account to pay transaction fees (must be the owner of the source token account)

Example:

Simple transfer

thru token transfer \
  ta...[from_token_account] \
  ta...[to_token_account] \
  1000000

With custom fee payer

thru token transfer \
  ta...[from_token_account] \
  ta...[to_token_account] \
  500000 \
  --fee-payer alice

Caution

The amount is specified in the smallest token units. For a token with 9 decimals, 1000000000 represents 1.0 tokens

Mint To

Mint new tokens directly to a token account. The destination account must be associated with the specified mint and cannot be frozen. Only the designated mint authority can perform this operation.

thru token mint-to $mint $to $authority $amount [OPTIONS]

mint · string · required

The mint address from which to create new tokens

to · string · required

Destination token account to receive the minted tokens

authority · string · required

Mint authority address (must match the mint’s authority)

amount · integer · required

Amount to mint (in smallest token units)

string

Account to pay transaction fees

Example:

Mint tokens

thru token mint-to \
  ta...[mint] \
  ta...[destination_token_account] \
  alice \
  5000000000

Large mint operation

thru token mint-to \
  ta...[mint] \
  ta...[destination_token_account] \
  treasury \
  1000000000000 \
  --fee-payer treasury

Tip

Only the designated mint authority can mint new tokens

Burn

Permanently destroy tokens from an account. The account must be associated with the specified mint and cannot be frozen. Only the account owner can perform this operation.

thru token burn $account $mint $authority $amount [OPTIONS]

account · string · required

Token account containing tokens to burn

mint · string · required

The mint address of the tokens being burned

authority · string · required

Account owner address (must be the owner of the token account being burned)

amount · integer · required

Amount to burn (in smallest token units)

string

Account to pay transaction fees

Example:

Burn tokens

thru token burn \
  ta...[token_account] \
  ta...[mint] \
  alice \
  1000000

Burn with authority

thru token burn \
  ta...[token_account] \
  ta...[mint] \
  burn_authority \
  5000000 \
  --fee-payer treasury

Caution

Burned tokens are permanently destroyed and cannot be recovered

Close Account

Close a token account and transfer any remaining balance. The account must have a zero balance before closing. Only the account owner can perform this operation.

thru token close-account $account $destination $authority [OPTIONS]

account · string · required

Token account to close

destination · string · required

Account to receive any remaining token balance

authority · string · required

Account owner address (must be the owner of the token account being closed)

string

Account to pay transaction fees

Example:

Close account

thru token close-account \
  ta...[token_account] \
  ta...[destination_account] \
  alice

Close with custom fee payer

thru token close-account \
  ta...[token_account] \
  ta...[destination_account] \
  alice \
  --fee-payer treasury

Caution

The account must have exactly zero tokens before it can be closed

Freeze Account

Freeze a token account to prevent transfers. The account must be associated with the specified mint. Only the mint’s freeze authority can perform this operation, and the mint must have freeze authority enabled.

thru token freeze-account $account $mint $authority [OPTIONS]

account · string · required

Token account to freeze

mint · string · required

The mint address associated with the account

authority · string · required

Freeze authority address (must match the mint’s freeze authority)

string

Account to pay transaction fees

Example:

thru token freeze-account \
  ta...[token_account] \
  ta...[mint] \
  freeze_authority

Caution

This operation will fail if the mint does not have freeze authority enabled during mint creation

Note

Frozen accounts cannot send or receive tokens until unfrozen

Thaw Account

Unfreeze a previously frozen token account. The account must be associated with the specified mint. Only the mint’s freeze authority can perform this operation, and the mint must have freeze authority enabled.

thru token thaw-account $account $mint $authority [OPTIONS]

account · string · required

Token account to unfreeze

mint · string · required

The mint address associated with the account

authority · string · required

Freeze authority address (must match the mint’s freeze authority)

string

Account to pay transaction fees

Example:

thru token thaw-account \
  ta...[token_account] \
  ta...[mint] \
  freeze_authority

Caution

This operation will fail if the mint does not have freeze authority enabled during mint creation

Tip

After thawing, the account can participate in transfers normally

Derive Mint Account Address

Calculate the deterministic mint account address that would be created for a given creator and seed combination. Use this to predict the mint address before calling initialize-mint.

Caution

Mint vs Token Account: This command derives the address for a mint account (the token definition itself). To derive the address for a token account (which holds token balances), use derive-token-account instead.

Note

Address Derivation: Mint account addresses are derived using SHA256(creator + seed), then used with the token program for final PDA derivation. This ensures each creator can create unique mints with different seeds.

thru token derive-mint-account $creator $seed

creator · string · required

Creator address

seed · string · required

Seed for derivation (32 bytes hex, 64 hex characters)

Example:

Derive mint address

thru token derive-mint-account \
  ta...[creator] \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

JSON output

thru --json token derive-mint-account \
  ta...[creator] \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

Tip

Returns the calculated mint account address that will be used when creating the mint

Tip

Use this command before running initialize-mint to know the mint address that will be created

Derive Token Account Address

Calculate the deterministic token account address that would be created for a given mint, owner, and seed combination. Use this to predict token account addresses before calling initialize-account.

Caution

Token vs Mint Account: This command derives the address for a token account (which holds token balances for an owner). To derive the address for a mint account (the token definition itself), use derive-mint-account instead.

thru token derive-token-account $mint $owner [OPTIONS]

mint · string · required

Mint account address

owner · string · required

Account owner address

string

Seed for derivation (32 bytes hex, optional - defaults to all zeros)

Example:

Default seed (all zeros)

thru token derive-token-account \
  ta...[mint] \
  ta...[owner]

Custom seed

thru token derive-token-account \
  ta...[mint] \
  ta...[owner] \
  --seed fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210

JSON output

thru --json token derive-token-account \
  ta...[mint] \
  ta...[owner] \
  --seed fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210

Tip

Returns the calculated token account address that can be used with other commands

Note

Address Formula: The derived address is calculated as SHA256(owner + mint + seed), then used with the token program as the owner for final PDA derivation. This ensures unique addresses for each combination.

Common Usage Patterns

Initialize a Token Mint

1. (Optional) Verify the mint address

   You can optionally verify the mint account address that will be created:

   thru token derive-mint-account \
     ta...[creator] \
     0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef

   Where:

   • First argument: creator address
   • Second argument: seed for mint derivation (save this securely!)

   Note

   The seed is crucial - save it securely as you’ll need it for creating the mint

2. Initialize the mint

   Create the mint account - the address and state proof are automatically derived:

   thru token initialize-mint \
     ta...[creator] \
     MYTOKEN \
     0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \
     --freeze-authority ta...[freeze_authority] \
     --decimals 6

   Where:

   • First argument: creator address
   • Second argument: token symbol/ticker
   • Third argument: seed for deterministic address derivation

   Tip

   The command automatically derives the mint address and generates the required state proof

Initialize a Token Account

Creating a token account is now simplified with automatic address and state proof derivation:

1. (Optional) Verify the token account address

   You can optionally verify the token account address that will be created:

   thru token derive-token-account \
     ta...[mint] \
     ta...[owner] \
     --seed fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210

   Where:

   • First argument: mint address (from the mint initialization)
   • Second argument: account owner address
   • --seed: unique seed for this token account (save this!)

2. Initialize the token account

   Create the token account - the address and state proof are automatically derived:

   thru token initialize-account \
     ta...[mint] \
     ta...[owner] \
     fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210

   Where:

   • First argument: mint address
   • Second argument: account owner address
   • Third argument: seed for deterministic address derivation

   Tip

   The command automatically derives the token account address and generates the required state proof

Best Practices

Tip

Seed Management: Store seeds securely and use deterministic generation for reproducible addresses

Tip

Authority Management: Use dedicated key management for mint and freeze authorities

Caution

Security: Never share private keys or store them in plain text. Use the CLI’s key management system