> For the complete documentation index, see [llms.txt](https://docs.ackinacki.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ackinacki.com/for-users/wallets/connecting-an-acki-nacki-wallet-and-setting-up-mining-keys.md).

# Connecting an Acki Nacki Wallet and Setting Up Mining Keys

This guide explains how to connect your Acki Nacki (AN) Wallet to apps and authorize mining

### Overview

Applications integrated with the Acki Nacki ecosystem typically require two types of permissions: Wallet Authentication and Mining Authorization

Applications may handle wallet connection and mining authorization differently.

Some applications combine both actions into a single approval flow. Others, such as **Popit Music**, require them to be completed separately:

1. **Wallet Authentication** — connect your AN Wallet and create a secure session.
2. **Mining Authorization** — allows an application to use Mining Keys associated with your wallet for NACKL mining activities.

The examples in this guide use **Popit Music** to demonstrate the two-step setup process.

> **What are Mining Keys?**
>
> **Mining Keys** are cryptographic keys associated with your Acki Nacki Wallet that allow approved applications to participate in NACKL mining on your behalf.
>
> When you grant mining access, you are **not sharing your wallet ownership or private keys**. Instead, you authorize a specific application (such as Popit Music) to use dedicated mining permissions linked to your wallet for earning mining rewards.
>
> Mining Keys can be managed, revoked, or reassigned at any time in **AN Wallet → Settings → Connected Mining Apps**.

***

## Step 1 — Wallet Authentication

Wallet Authentication creates a secure connection between your AN Wallet and the application.

### 1. Select Connect AN Wallet

Open the application and tap **"Connect or sign in",**\
then choose: "**Connect Acki Nacki Wallet"**

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FEiPCusKbRzrH8R5JQfWU%2F14.jpg?alt=media&amp;token=da5c4c8f-ba45-4717-97a6-8eb71d60eed5" alt="" width="143"><figcaption></figcaption></figure>

***

### 2. Scan the QR Code

Popit Music displays a QR code for wallet connection.\
Open AN Wallet and **scan the QR** code or tap "**Open AN Wallet**" and you will be redirected directly to your wallet

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FzfuHAEh8QGGdf67ju82Y%2F13.jpg?alt=media&amp;token=f96fed9b-9535-4d89-b3af-47325152ba6c" alt="" width="142"><figcaption></figcaption></figure>

***

### 3. Enter Your Wallet Password

AN Wallet requests your password to approve the authentication request.

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FCXSPRrIxH5rm4uttVWr7%2F12.jpg?alt=media&amp;token=9ebd8878-8895-42b5-b793-e80a3fee8d5b" alt="" width="143"><figcaption></figcaption></figure>

***

### 4. Approve the Connection Request

Review the request details and confirm the connection.

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FmwkUCKxhufqN2qBu5CNq%2F11.jpg?alt=media&amp;token=8e3368f7-f81f-48b3-932b-7ffd99a5d08f" alt="" width="142"><figcaption></figcaption></figure>

When approved:

* Wallet ownership is verified
* Wallet identity is shared with the application
* A secure application session is created

The application receives:

* Wallet Name
* Wallet Address

No private keys, passwords, or seed phrases are shared.

***

### 5. Wallet Authentication Completed

The wallet confirms that the connection has been established.

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2F1Tu1Menp0HGvD2nZ1lQC%2F7-w.jpg?alt=media&amp;token=a08c0f70-3ec0-49bb-b063-73b51eaefcf5" alt="" width="143"><figcaption></figcaption></figure>

***

### 6. Verify Connected Applications (Optional)

You can review active application sessions in:

**AN Wallet → Settings → Connected Apps**

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FEZzjt1EOPB6P85oILso1%2F5-w-settings.jpg?alt=media&amp;token=7f0902ec-d9ae-4cbf-a015-ac3cd7f936ac" alt="" width="143"><figcaption></figcaption></figure>

***

## Step 2 — Mining Authorization

Mining Authorization allows the application to use Mining Keys for NACKL mining activities.

> Wallet Authentication alone does not grant mining permissions.
>
> Applications that use a two-step setup require a separate Mining Authorization approval.

***

### 1. Open Mining Setup

In Popit Music, in the user settings select: "**Setup Mining Keys"**

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FB2Qg34oW2rA7JQ10fIBs%2F8%20-pm.jpg?alt=media&amp;token=90a2e998-b901-419d-9ebf-d43cba0e4bac" alt="" width="143"><figcaption></figcaption></figure>

***

### 2. Request Mining Access

Popit Music is requesting permission to enable mining. Tap "Request Mining".\
The application will redirect you to AN Wallet. To continue, tap "Open AN Wallet".

<div><figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FBKxm385EOvG5xwqzHcXO%2F9-%20pm.jpg?alt=media&amp;token=c98b6197-9cf2-4a00-b2a9-1ec5296e6672" alt="" width="144"><figcaption></figcaption></figure> <figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FyQnlMmZ3mTuw4iZ9GwKy%2F10-pm.jpg?alt=media&amp;token=8d67ddb7-a438-41b8-97f4-360dd3462a56" alt="" width="143"><figcaption></figcaption></figure></div>

***

### 3. Review Mining Permission Request

AN Wallet displays the mining authorization request. Select "**Allow Mining"** if you permit mining

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2F6oyJK8XK1sHtONXV0OyK%2F11-w.jpg?alt=media&amp;token=02ac04a2-36a6-4dcf-86a9-c13776fffdbb" alt="" width="143"><figcaption></figcaption></figure>

***

### 6. Verify Connected Mining Applications

After approval, the application appears under:

**AN Wallet → Settings → Connected Mining Apps**

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FlVpOqm42QQECb7MMpl6m%2F12-w-settings.jpg?alt=media&amp;token=682ff0bb-51ca-4b8c-84bb-277da06b1f02" alt="" width="142"><figcaption></figcaption></figure>

***

### 7. Mining Activated

Return to the application. Mining is now active and Mining Keys have been successfully assigned.

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FtMxbcGrMstzfzcOuWgse%2F13-pm.jpg?alt=media&amp;token=1e0cf1ef-e993-4de1-9788-5832210564d8" alt="" width="144"><figcaption></figcaption></figure>

***

## Managing Permissions

### Connected Apps

Connected Apps are applications authorized to access your wallet identity and maintain an authenticated session.

Location: **AN Wallet → Settings → Connected Apps**

**Screenshot:** `5-w-settings.jpg`

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FEZzjt1EOPB6P85oILso1%2F5-w-settings.jpg?alt=media&amp;token=7f0902ec-d9ae-4cbf-a015-ac3cd7f936ac" alt="" width="143"><figcaption></figcaption></figure>

***

### Connected Mining Apps

Connected Mining Apps are applications authorized to use Mining Keys.

Location: **AN Wallet → Settings → Connected Mining Apps**

**Screenshot:** `12-w-settings.jpg`

<figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FlVpOqm42QQECb7MMpl6m%2F12-w-settings.jpg?alt=media&amp;token=682ff0bb-51ca-4b8c-84bb-277da06b1f02" alt="" width="142"><figcaption></figcaption></figure>

***

### Revoke Access

To remove an application:

1. Open AN Wallet Settings
2. Locate the application
3. Tap the **X** icon
4. Confirm removal

The application will immediately lose the associated permission.

<div><figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FS1BbLpsqybPUqbmUg6c3%2F6-%20w.jpg?alt=media&amp;token=c7dbba68-d4c6-42d7-93fa-540928391b3b" alt="" width="143"><figcaption></figcaption></figure> <figure><img src="https://2264326627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FahUdZU2HOHQjENWKWyJo%2Fuploads%2FlVpOqm42QQECb7MMpl6m%2F12-w-settings.jpg?alt=media&amp;token=682ff0bb-51ca-4b8c-84bb-277da06b1f02" alt="" width="142"><figcaption></figcaption></figure></div>