# D'CENT × MusiKhan User Guide

이 문서는 D'CENT 월렛 사용자가 MusiKhan Tune-to-Earn 캠페인에 쉽게 참여할 수 있도록 단계별 절차와 보상 규칙을 정리한 안내서입니다.

This document is a guide that outlines the step-by-step procedures and reward rules to help D'CENT wallet users easily participate in the MusiKhan Tune-to-Earn campaign.

### Introduction

**MusiKhan**은 HanChain의 Music RWAfi 프레임워크 기반의 대표 **Tune-to-Earn** 앱입니다. LINE Mini-Dapp 환경에서 설치 없이 음악을 듣고 보상을 받을 수 있으며, **LP 스테이킹**으로 적립되는 **Unlockable Tunes**를 사용해 Web3 전용 K-POP 트랙을 Unlock하고, **Spin 게임**으로 HAN 토큰 보상을 획득합니다.

**MusiKhan** is HanChain’s flagship **Tune-to-Earn** app built on the Music RWAfi framework. In the LINE Mini-Dapp, users can stream music and earn rewards with no installation. By staking LP tokens, you earn **Unlockable Tunes**, unlock Web3-exclusive K‑POP tracks, and play the **Spin Game** to earn **HAN**.

#### Key Features

* **LP 스테이킹**: KAIA/HAN LP를 스테이킹해 **Unlockable Tunes** (음악 감상을 위해 Unlock 할 수 있는 곡의 수량) 적립
* **LP Staking**: Stake KAIA/HAN LP to earn **Unlockable Tunes** (The number of tracks you can unlock for listening)
* **음악 스트리밍**: Unlockable Tunes로 트랙 Unlock 후 감상 (7일 유효)
* **Streaming**: Use Unlockable Tunes to unlock tracks and listen (valid for 7 days)
* **스핀 게임**: Unlock된 트랙 수만큼 스핀 기회 획득
* **Spin Game**: One spin per unlocked track
* **추천 보상**: 내가 초대한 친구의 스핀 보상 **10%**를 보너스로 획득
* **Referral**: Earn a **10%** bonus from your friend’s Spin rewards
* **소셜 경로**: 커뮤니티 참여로 추가 보상 기회
* **Social Path**: Extra rewards via community participation
* **클레임**: 적립된 HAN 토큰을 연결된 지갑으로 즉시 청구
* **Claim**: Instantly claim HAN to your connected wallet

> Join the Campaign: <https://line.khans.io/>
>
> Network: **KAIA mainnet**
>
> Wallet: **D'CENT**

***

### Step-by-Step Guide

#### 1) Launch the App

MusiKhan 앱을 실행해 시작 화면의 **Connect**를 눌러 지갑 연결을 시작합니다.

Open MusiKhan and tap **Connect** to start wallet linking.

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FmfyQaP1pxIybcEDNwQth%2F1_start.png?alt=media&#x26;token=6af284f0-1e7d-4baf-8227-beec5ff56962" alt=""><figcaption></figcaption></figure>

#### 2) Connect Your Wallet

지갑 선택 화면에서 **D'CENT Wallet**을 선택한 뒤, D'CENT 앱에서 연결 요청을 확인하고 승인합니다. 연결이 완료되면 MusiKhan으로 돌아옵니다.

Select **D'CENT Wallet**, review the connection request in the D'CENT app, and approve. You’ll return to MusiKhan once connected.

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FddAy17ZVMVcAH6ZAAVJv%2F2_connect.png?alt=media&#x26;token=3f14d4de-dda2-4f5a-a0eb-b93fd7c78639" alt="" width="375"><figcaption></figcaption></figure>

#### 3) Main Screen Overview

상단에서 연결된 지갑 주소와 HAN 잔액을 확인합니다. 중앙의 **Unlockable Tunes**에는 음악 감상을 위해 Unlock 할 수 있는 곡의 수량이 적립됩니다. **Stake KAIA/HAN**으로 스테이킹 화면으로 이동하고, **Claim Rewards**로 보상을 청구하며, **Invite Friends**에서 친구 초대를 진행합니다.

Check your connected address and HAN balance at the top. **Unlockable Tunes** shows your accrued unlock capacity. Use **Stake KAIA/HAN**, **Claim Rewards**, and **Invite Friends** as needed.

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FstNlR3K3iUWsk3j4kGzY%2F3_main.png?alt=media&#x26;token=d54787a1-3081-4648-b964-a541f24a8d2a" alt="" width="375"><figcaption></figcaption></figure>

#### 4) Stake LP Tokens (One‑Click)

**KAIA 한 자산만으로, 단 한 번의 서명**을 통하여 **KAIA-HAN** 페어에 유동성을 공급하고 생성된 **LP를 즉시 스테이킹**합니다.

With **KAIA only** and a **single signature**, MusiKhan adds liquidity to **KAIA‑HAN** and **immediately stakes** the minted LP.

* 수량 선택: 슬라이더나 입력창에서 사용할 KAIA 수량을 지정
* 안내 확인: 잠금 기간 표시 (예: 30 Days Locked)
* 실행: **One-Click LP & STAKE**를 누르고 D'CENT에서 서명
* Choose amount, review lock period (e.g., 30 Days Locked), then tap **One‑Click LP & STAKE** and approve on D'CENT

> *<mark style="color:$info;">**\*내부 처리**</mark><mark style="color:$info;">: 일부 KAIA를 자동으로 HAN으로 스왑해 페어 구성, KAIA-HAN 풀에 유동성 추가, 민팅된 LP를 즉시 스테이킹</mark>*
>
> *<mark style="color:$info;">**\*Under the hood**</mark><mark style="color:$info;">: auto‑swap part of KAIA to HAN, add liquidity, mint LP, and stake instantly</mark>*

* 결과: 시간이 지날수록 **Unlockable Tunes**가 초 단위로 적립되며 메인 화면에 반영
* Result: **Unlockable Tunes** accrue per second and appear on the main screen

**원클릭 처리 순서&#x20;***<mark style="color:$info;">**\*내부처리**</mark>*

1. KAIA로 유동성 추가를 위한 단일 서명 수행
2. 추가된 KAIA의 50%에 상응하는 HAN 수량 계산
3. KAIA 50%로 HAN 매수
4. 2단계의 KAIA 및 HAN을 KLAYswap에 유동성으로 공급 (표준 페어링 구간은 Zero Fee/Zero Slippage 적용, 3단계 매수분의 슬리피지는 리저브로 보전)
5. KLAYswap LP 스테이킹 시작 (기본 30일 락업, 누적 스테이킹 제한 없음)
6. 보상은 초 단위로 발생

**One‑Click flow&#x20;***<mark style="color:$info;">**\*Under the hood**</mark>*

1. One signature to add liquidity from KAIA
2. Calculate HAN amount equal to 50% of added KAIA
3. Use 50% of KAIA to buy HAN
4. Provide KAIA and HAN as liquidity on KLAYswap (pairing leg treated as zero fee/slippage; slippage from step 3 covered by reserves)
5. Start staking KLAYswap LP (30‑day lock; no cap on cumulative staking)
6. Rewards accrue every second

**Rewards & Contracts**

* 적립 속도: **1 LP 스테이킹당 초당 0.0000000112 Unlockable Tunes**
* Rate: **0.0000000112 Unlockable Tunes per second per 1 LP staked**
* Unlockable Tunes = 음악 감상을 위해 Unlock 할 수 있는 곡의 수량
* Unlockable Tunes = available track unlocks
* Contracts
  * HanChain (HAN): `0x1008150fEa809088Fe3423C15b05C33d1252a218`
  * KLAYswap KAIA‑HAN pool: `0xf309db1b174ce10d83248211223dfe1bd375eb37`
  * UnlockableTuneVault:  `0xf309db1b174ce10d83248211223dfe1bd375eb37`
  *

**Withdraw**

* 30일 락업 이후 언제든 선택한 LP를 출금 가능
* After 30 days, withdraw any staked LP at any time
* 락업 종료 후에도 출금 전까지 보상은 계속 적립
* Rewards continue to accrue until withdrawal
* 출금 시 기초 자산 KAIA와 HAN은 LP 지분율에 비례하여 반환
* Underlying KAIA and HAN are returned pro‑rata to your LP share

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FQ5i0yPBZyMwEFOJ3fnXB%2F4_staking.png?alt=media&#x26;token=4260cc9e-3ff4-424b-9c2b-0d1cb3b8eedf" alt="" width="375"><figcaption></figcaption></figure>

#### 5)  Music Unlock & Listen

Unlockable Tunes가 충분하면 **스트리밍** 페이지에서 곡을 선택해 Unlock합니다. 다중 선택 후 **Unlock Selected**로 일괄 Unlock할 수 있고, **Max Random**으로 보유한 Unlockable Tunes 한도 내에서 무작위 Unlock도 가능합니다. Unlock된 곡은 **7일간** 감상 할 수 있습니다.

When you have enough Unlockable Tunes, unlock tracks on the **Streaming** page. Select tracks and tap **Unlock**, or use **Unlock Selected** for batch unlock and **Max Random** for random picks within your limit. Unlocked tracks are valid for **7 days**.<br>

* Unlockable Tunes로 Web3 전용 K-POP 트랙 Unlock
* Use Tunes to unlock Web3‑exclusive K‑POP tracks
* Unlock된 곡 1개당 7일간 스트리밍 가능
* 7‑day streaming per unlocked track
* Max Random: 한 번에 여러 곡 무작위 Unlock
* Max Random for multiple at once
* Unlock된 곡 수만큼 스핀 게임 응모 수로 즉시 반영
* All unlocked tracks count as Spin entries

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FEVfD4QyE6ioc6Qpmy286%2F5_unlock.png?alt=media&#x26;token=54736a67-80ea-423e-9efa-41b1ffe126b9" alt="" width="375"><figcaption></figcaption></figure>

#### 6) Play the Spin Game

Unlock된 곡 1개당 **스핀 1회**가 주어집니다. SPIN GAME 화면에서 배수를 **x TAP** 또는 **÷ TAP**으로 조절한 뒤 **SPIN**을 누르면 **10 HAN에서 100 HAN** 사이 보상 구간 중 하나에 멈춥니다. 선택한 배수가 적용되어 HAN 보상을 획득합니다.

Each unlocked track grants **1 spin**. Adjust multiplier with **x TAP** or **÷ TAP**, then tap **SPIN**. The wheel lands between **10 HAN and 100 HAN**; your chosen multiplier applies to the result.

* 스핀 기회는 **Unlocked Tunes 수와 1:1**
* Spin chances are **1:1 with the number of Unlocked Tunes**
* **스핀 횟수 제한 없음**
* **No daily limit** on the number of spins
* &#x20;**x TAP**: 배수를 1단계 높이고 스핀 1회를 소모합니다. 스핀을 누르기 전까지 여러 번 눌러 배수를 올릴 수 있습니다.\
  **예시**) 배수를×2를로설정한   뒤 스핀 결과가 20이면, 지급 보상은 40 HAN입니다.
* **x TAP**: Increases the multiplier by one step and consumes 1 spin. You can tap multiple times before spinning to raise the multiplier.\
  **Example**) If you set the multiplier to ×2 and the wheel lands on 20 HAN, your payout is **40 HAN**.
* **÷ TAP**: 배수를 1단계 낮추고 스핀 1회를 복구합니다. 스핀 버튼을 누르기 전에만 사용할 수 있습니다.
* **÷ TAP**: Lowers the multiplier by one step and restores one spin. It can be used only before spinning.
* &#x20;보상은 앱에 누적되며 **언제든 Claim으로 출금**할 수 있습니다.
* **Rewards** accrue in-app and can be **claimed at any time**.

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FsUctNJrNMQx6H7Sjkmk0%2F6_spin.png?alt=media&#x26;token=3fbd786a-0528-4636-abb7-667dc373ead8" alt="" width="375"><figcaption></figcaption></figure>

#### 7) Claim Rewards

메인 화면의 **Claim Rewards**를 눌러 누적 보상을 내 지갑으로 청구합니다. D'CENT에서 서명 요청을 승인하면, HAN 토큰이 지갑으로 전송됩니다.

Tap **Claim Rewards** on the main screen to withdraw accumulated HAN to your wallet. Approve the signature in D'CENT to receive the tokens.

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FIfhQE5XkrR2xTllk6JSi%2F7_claim_.png?alt=media&#x26;token=d7b0c5ea-e315-49aa-86be-192a4e7bd675" alt="" width="375"><figcaption></figcaption></figure>

#### 8) Invite Friends

**Invite Friends**에서 초대한 친구 수와 추천 보상 내역을 확인할 수 있습니다.

In **Invite Friends**, view invited friends and referral earnings.

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FxP8ZxwIrnHbDI4iTvs0W%2F8_friends(1).png?alt=media&#x26;token=c3a0eb3b-3388-48ee-a8b9-4ead7aad0da0" alt="" width="375"><figcaption></figcaption></figure>

#### 9) Add a Friend

친구는 **Add Friend & Get Gift-HAN**을 눌러 **추천인의 KAIA 지갑 주소(0x 시작)**&#xB97C; 한 번만 등록할 수 있습니다. 등록 즉시 친구는 1회성 **Gift-HAN**을 받으며, 추천인은 친구의 스핀 보상 **10%**&#xB97C; 실시간으로 보너스로 받습니다.

Your friend taps **Add Friend & Get Gift‑HAN** and enters **your KAIA address (starts with 0x)**. They receive a one‑time **Gift‑HAN**; you earn a **10%** bonus from their Spin rewards in real time.

* 각 사용자는 친구를 **1회만 등록** 가능하며 이후 변경 불가
* Each user can register **one** friend only and cannot change it later
* 나를 친구로 등록하는 사람 수는 **무제한**
* **Unlimited** users can register you as their friend

<figure><img src="https://2749198054-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQOfmdwyQWazPIZYbT4c3%2Fuploads%2FVEpMe7Bax2PY9r1dyJtH%2F9_friends(2).png?alt=media&#x26;token=45dfaaeb-951a-4794-85df-f005ea11c055" alt="" width="375"><figcaption></figcaption></figure>

***

### Frequently Asked Questions (FAQ) <a href="#frequently-asked-questions-faq" id="frequently-asked-questions-faq"></a>

**Q1. 스테이킹 없이 음악을 들을 수 있나요?**
\
A1. 불가합니다. 음악 Unlock에 필요한 Unlockable Tunes는 LP 스테이킹으로 적립됩니다.

**Q1. Can I listen to music without staking?**\
A1. No. You must stake LP tokens to receive Unlockable Tunes to access the music.

**Q2. 유동성 공급과 스테이킹이 복잡하지 않나요?**
\
A2. 아닙니다. KAIA 하나만 있으면 원클릭으로 유동성 공급과 스테이킹이 한 번에 처리됩니다.

**Q2. Isn’t the process of providing liquidity and staking complicated?**\
A2. Not at all. In MusiKhan, the process is simple and seamless. You only need KAIA, a single coin, to provide liquidity to the KAIA-HAN pair pool. With just one signature, both liquidity provision and staking happen instantly in a single step.

**Q3. 스핀 보상은 언제 지급되나요?**
\
A3. 스핀 결과는 즉시 확정되며, 보상은 Claim 버튼으로 언제든 지갑으로 청구할 수 있습니다.

**Q3. When are Spin rewards paid out?**\
A3. Spin results are instant. Rewards can be claimed anytime using the Claim button.

**Q4. 추천 보상은 어디서 확인하나요?**
\
A4. Friends 탭에서 실시간 추천 수익을 확인할 수 있습니다.

**Q4. Where can I check my referral rewards?**\
A4. Go to the “Friends” tab to view real-time referral earnings.

**Q5. 여러 번 스테이킹해도 되나요?**
\
A5. 가능합니다. 여러 차례 스테이킹해 Unlockable Tunes 적립 속도를 높일 수 있습니다.

**Q5. Can I stake multiple times?**\
A5. Yes. You can stake as many times as you like to extend your access to Unlockable Tunes and accumulate more rewards.

***

### Reference

* D'CENT Wallet User Guide: <https://userguide.dcentwallet.com/>