# Revoke Authorities

### 1. Overview

In Solana’s SPL token standard, each token can have several types of authorities:

| Type             | Purpose                                        | Typical Owner |
| ---------------- | ---------------------------------------------- | ------------- |
| Mint Authority   | Can mint new tokens (increase supply).         | Token creator |
| Freeze Authority | Can freeze/unfreeze user accounts.             | Admin or DAO  |
| Update Authority | Can update metadata (logo, name, description). | Project owner |

Once these authorities are revoked (set to null), no wallet or program can perform these actions again — the token becomes immutable.

### 2. Accessing the Revoke Menu

1. Open Toolther → Mint, Freeze or Update page.
2. In the right menu, select the authority type you want to revoke:

   * Revoke Mint Authority
   * Revoke Freeze Authority
   * Revoke Update Authority

Each action opens a similar interface with:

* Token selector — list of tokens where your connected wallet currently holds authority.
* Network indicator — Devnet or Mainnet.
* Action button — “Revoke” or “Transfer Authority”.

***

### 3. Step-by-Step Instructions

#### Step 1: Connect Your Wallet

Click Connect Wallet and approve the connection.

Toolther supports Phantom, Solflare, Backpack, and Ledger wallets.

#### Step 2: Select Token

Click Select Token → choose the token where you hold the authority.

Toolther automatically scans your wallet and shows only mints where your wallet currently holds that permission.

#### Step 3: Confirm Your Role

Before proceeding, Toolther verifies:

* You are the current authority for the selected token.
* The token exists and is accessible via your connected network (Devnet/Mainnet).

If not, an error message appears:

> “You do not have permission to perform this action.”

#### Step 4: Choose Revoke or Transfer

* Revoke (Nullify) — permanently remove the authority (cannot be undone).
* Transfer — assign the authority to another wallet or program (for DAOs, multi-sigs, etc.).<br>

#### Step 5: Approve Transaction<br>

Click Confirm, then approve in your wallet popup.

Toolther sends a SetAuthority instruction to the Solana token program.

#### Step 6: Verify

After confirmation, Toolther will display:

* Transaction signature (with link to Solscan).
* Updated authority status:
  * Mint Authority: null
  * Freeze Authority: null
  * Update Authority: null

***

### 4. Revoke Types Explained

#### 4.1 Revoke Mint Authority

Purpose: Prevent any future token minting.

Recommended: After the full token supply is minted and distributed.

Effect: Supply becomes permanently fixed.

#### 4.2 Revoke Freeze Authority

Purpose: Prevent future freezing/unfreezing of token accounts.

Recommended: After launch if your project does not require account control.

Effect: All accounts remain forever active.

#### 4.3 Revoke Update Authority

Purpose: Prevent further metadata edits (name, logo, or description).

Recommended: After finalizing token branding and metadata IPFS.

Effect: Token metadata becomes immutable.

***

### 5. Common Errors

| Error                  | Cause                               | Solution                                            |
| ---------------------- | ----------------------------------- | --------------------------------------------------- |
| “Not authorized”       | You are not the current authority.  | Connect the correct wallet that owns the authority. |
| “Token not found”      | Token is missing or RPC not synced. | Click Refresh or switch to the correct network.     |
| “Transaction rejected” | Wallet declined transaction.        | Reconfirm and sign again.                           |
| “Immutable token”      | Authority already revoked earlier.  | No further actions needed.                          |

### 6. Best Practices

* Always mint your full supply before revoking Mint Authority.
* Double-check IPFS metadata before revoking Update Authority.
* For compliance or DAO tokens, consider transferring authority to a multisig or program-owned address instead of full revocation.
* Keep transaction links for audit and transparency.

***

### 7. Summary Table

| Action                  | Requires Permission | Reversible | Result               |
| ----------------------- | ------------------- | ---------- | -------------------- |
| Revoke Mint Authority   | Yes                 | No         | Fixed supply         |
| Revoke Freeze Authority | Yes                 | No         | No freezing possible |
| Revoke Update Authority | Yes                 | No         | Immutable metadata   |

In short:

Revoke when you are ready to make your token truly decentralized.

After these steps, no one — not even you — can modify, freeze, or mint the token again.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolther.app/guides/revoke-authorities.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.