> For the complete documentation index, see [llms.txt](https://grapedao.gitbook.io/products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://grapedao.gitbook.io/products/grape-identity/tokens-tools.md).

# Tokens Tools

Token Tools is Grape's token authority workspace for mint lifecycle, authority management, metadata operations, and distributor workflows on Solana.

### Routes

* Primary route: `/token`
* Alias redirect: `/tokentools` -> `/token`

### Workspace Structure

Token Tools contains two sections:

1. Token Authority Operations
2. Holdings

It uses the same wallet connection and RPC controls as Identity.

### Core Controls

#### Wallet + RPC

* Connect/disconnect via Solana Wallet Adapter.
* Uses the shared RPC selector from the app provider context.

#### Token Program Selector

Token Authority Manager supports program-level targeting:

* SPL Token Program (default)
* SPL Token 2022
* Custom token program ID

This active program setting is applied across operations that depend on token program semantics.

### Token Authority Operations

#### 1) Authority Inventory + Risk Scanner

* Scans candidate mints for:
  * Mint authority exposure
  * Freeze authority exposure
  * Metadata update authority exposure
* Adds risk flags (for example mutable metadata or empty metadata URI where detected).
* Supports custom mint inputs.
* Exports scan results to CSV.

#### 2) Program Buffers (Upgradeable Loader)

* Discovers authority-owned upgradeable loader buffers.
* Shows buffer size and lamports.
* Supports closing buffers to a selected recipient.

#### 3) Bulk Authority Rotation Wizard

* Rotates selected authority types in batch:
  * Mint authority
  * Freeze authority
  * Metadata update authority
* Target mint list can be explicit or derived from scan results.

#### 4) Update Mint/Freeze Authority

* Updates mint authority or freeze authority for a selected mint.
* Supports revocation by leaving new authority empty.

#### 5) Authority Mints

* Enumerates mints controlled by the connected wallet.
* Scan modes:
  * Known mints (recommended)
  * Active token program
  * All programs (heavier)
* Displays program type, supply, and authority flags.

#### 6) Create Mint

* Creates a new mint with configurable decimals.
* Freeze authority modes:
  * Connected wallet
  * None
  * Custom authority
* Mint close authority extension is supported for Token-2022 mode.

#### 7) Mint Tokens

* Mints supply to destination owner ATA.
* Creates destination ATA when needed.

#### 8) Mint + Distribute (Batch)

* Batch input format: `wallet,amount` per line.
* Mints and distributes in one workflow.

#### 9) Upload Token Metadata (Irys)

User-funded upload flow from connected wallet:

* Upload image and apply URI into metadata draft.
* Upload metadata JSON draft or JSON file.
* Auto-updates URI fields after upload.

#### 10) Create Metadata Account (Metaplex)

* Creates metadata PDA for a mint.
* Inputs include name, symbol, URI, seller fee bps, mutability, and optional update authority.

#### 11) Update Metadata Authority

* Rotates Metaplex metadata update authority to a new wallet.

#### 12) Update Metadata URI Only

* Preserves existing metadata fields and updates only URI.
* Accepts mint address or metadata PDA.

#### 13) Grape Distributor Quick Wizard

Guided flow:

* Derive distributor + vault PDAs from mint
* Build allocations (`wallet,amount` or `wallet,amount,index`)
* Generate Merkle root + claim package JSON
* Prefill downstream Issue/Claim sections

Index strategy options:

* On-chain safe (recommended)
* Line-order legacy mode

#### 14) Grape Distributor (Issue/Admin)

Admin setup and maintenance:

* Initialize distributor
* Configure claim window
* Fund vault
* Claw back vault tokens
* Rotate Merkle root

#### 15) Grape Distributor (Claim/User)

User claim workflow:

* Apply claim package JSON or load from URL
* Upload claim package JSON to Irys
* Generate and copy end-user claim link (`/claims?manifest=...`)
* Submit claim with index/amount/proof
* Optional local Merkle proof verification
* Optional close-claim-status rent reclaim helper

### Deep Links

* No `?action=` deep-link routing is currently defined for `/token`.

### Holdings

Token Tools includes the same Holdings panel used in Identity:

* SOL balance and token holdings
* Metadata-enriched token display
* NFT metadata tab where available
* Mint-level details and metadata inspection

### Storage Upload API (optional server-sponsored mode)

* `POST /api/storage/upload`
* Disabled by default unless server upload mode is enabled.

### Environment Variables (Token-Relevant)

* `NEXT_PUBLIC_SOLANA_DEFAULT_RPC_URL`
  * Default RPC endpoint.
* `NEXT_PUBLIC_IRYS_NODE_URL`
  * Irys node for client upload flow (default: `https://uploader.irys.xyz`).
* `NEXT_PUBLIC_IRYS_GATEWAY_URL`
  * Gateway base for uploaded content URLs (default: `https://gateway.irys.xyz`).

Optional server-sponsored upload mode:

* `IRYS_SERVER_UPLOAD_ENABLED=true`
* `IRYS_SOLANA_PRIVATE_KEY` (required when enabled)
* Optional tuning vars:
  * `IRYS_NETWORK`
  * `IRYS_GATEWAY_URL`
  * `IRYS_RPC_URL`
  * `IRYS_MAX_UPLOAD_BYTES`
  * `IRYS_OP_TIMEOUT_MS`
  * `IRYS_UPLOAD_TIMEOUT_MS`
  * `IRYS_AUTO_FUND`