Skip to main content
The thru-cli token command provides comprehensive token management functionality, including minting, transfers, account management, and administrative operations.
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 authority 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-cli token initialize-mint <mint_authority> <ticker> <seed> [OPTIONS]
​
mint_authority
string
required
Address that can mint new tokens. Use key name from configuration file or full address.
​
ticker
string
required
Token symbol, maximum 8 characters (e.g., “USDC”, “ETH”)
​
seed
string
required
32-byte hex string for deterministic mint address derivation
​
--state-proof
string
Optional hex-encoded state proof for mint account creation. If not provided, the state proof is automatically generated.
​
--freeze-authority
string
Address that can freeze/unfreeze token accounts (optional)
​
--decimals
integer
default:"9"
Number of decimal places for token precision (0-18)
​
--fee-payer
string
default:"default"
Account to pay transaction fees
Example: 
thru-cli token initialize-mint \
  ta9876543210fedcba9876543210fedcba98765432 \
  GOLD \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
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.
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-cli 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.
​
--state-proof
string
Optional hex-encoded state proof for token account creation. If not provided, the state proof is automatically generated.
​
--fee-payer
string
default:"default"
Account to pay transaction fees
Example: 
thru-cli token initialize-account \
  ta1234567890abcdef1234567890abcdef12345678 \
  ta9876543210fedcba9876543210fedcba98765432 \
  fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210
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-cli 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)
​
--fee-payer
string
default:"default"
Account to pay transaction fees (must be the owner of the source token account)
Example: 
thru-cli token transfer \
  ta1111111111111111111111111111111111111111 \
  ta2222222222222222222222222222222222222222 \
  1000000
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-cli 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)
​
--fee-payer
string
default:"default"
Account to pay transaction fees
Example: 
thru-cli token mint-to \
  ta1234567890abcdef1234567890abcdef12345678 \
  ta9999999999999999999999999999999999999999 \
  alice \
  5000000000
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-cli 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)
​
--fee-payer
string
default:"default"
Account to pay transaction fees
Example: 
thru-cli token burn \
  ta9999999999999999999999999999999999999999 \
  ta1234567890abcdef1234567890abcdef12345678 \
  alice \
  1000000
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-cli 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)
​
--fee-payer
string
default:"default"
Account to pay transaction fees
Example: 
thru-cli token close-account \
  ta9999999999999999999999999999999999999999 \
  ta8888888888888888888888888888888888888888 \
  alice
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-cli 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)
​
--fee-payer
string
default:"default"
Account to pay transaction fees
Example: 
thru-cli token freeze-account \
  ta9999999999999999999999999999999999999999 \
  ta1234567890abcdef1234567890abcdef12345678 \
  freeze_authority
This operation will fail if the mint does not have freeze authority enabled during mint creation
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-cli 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)
​
--fee-payer
string
default:"default"
Account to pay transaction fees
Example: 
thru-cli token thaw-account \
  ta9999999999999999999999999999999999999999 \
  ta1234567890abcdef1234567890abcdef12345678 \
  freeze_authority
This operation will fail if the mint does not have freeze authority enabled during mint creation
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 mint authority and seed combination. Use this to predict the mint address before calling initialize-mint.
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.
Address Derivation: Mint account addresses are derived using SHA256(mint_authority + seed), then used with the token program for final PDA derivation. This ensures each mint authority can create unique mints with different seeds.
thru-cli token derive-mint-account <mint_authority> <seed>
​
mint_authority
string
required
Mint authority address
​
seed
string
required
Seed for derivation (32 bytes hex, 64 hex characters)
Example: 
thru-cli token derive-mint-account \
  ta9876543210fedcba9876543210fedcba98765432 \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
Returns the calculated mint account address that will be used when creating the mint
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.
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-cli token derive-token-account <mint> <owner> [OPTIONS]
​
mint
string
required
Mint account address
​
owner
string
required
Account owner address
​
--seed
string
Seed for derivation (32 bytes hex, optional - defaults to all zeros)
Example: 
thru-cli token derive-token-account \
  ta1234567890abcdef1234567890abcdef12345678 \
  ta9876543210fedcba9876543210fedcba98765432
Returns the calculated token account address that can be used with other commands
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-cli token derive-mint-account \
  ta9876543210fedcba9876543210fedcba98765432 \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
Where:
  • First argument: mint authority address
  • Second argument: seed for mint derivation (save this securely!)
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-cli token initialize-mint \
  ta9876543210fedcba9876543210fedcba98765432 \
  MYTOKEN \
  0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef \
  --freeze-authority ta5555444433332222111100009999888877776666 \
  --decimals 6
Where:
  • First argument: mint authority address
  • Second argument: token symbol/ticker
  • Third argument: seed for deterministic address derivation
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-cli token derive-token-account \
  ta1234567890abcdef1234567890abcdef12345678 \
  ta9876543210fedcba9876543210fedcba98765432 \
  --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-cli token initialize-account \
  ta1234567890abcdef1234567890abcdef12345678 \
  ta9876543210fedcba9876543210fedcba98765432 \
  fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210
Where:
  • First argument: mint address
  • Second argument: account owner address
  • Third argument: seed for deterministic address derivation
The command automatically derives the token account address and generates the required state proof

​
Best Practices

Seed Management: Store seeds securely and use deterministic generation for reproducible addresses
Authority Management: Use dedicated key management for mint and freeze authorities
Security: Never share private keys or store them in plain text. Use the CLI’s key management system