cm cli docs translations (#399)

* cm cli translations

* code rabbit

src/pages/ja/cli/cm/create.md

@@ -0,0 +1,249 @@
+---
+title: "キャンディマシンを作成"
+metaTitle: "MPLX CLI - キャンディマシン作成コマンド"
+description: "MPLX CLIを使用してMPL Coreキャンディマシンを作成します。検証、アセットアップロード、完全なセットアップ自動化を備えたインタラクティブウィザードモード。"
+---
+
+`mplx cm create`コマンドは、設定可能な設定とアセットアップロードを持つ新しいMPL Coreキャンディマシンを作成します。初心者向けのインタラクティブウィザードと上級ユーザー向けの手動設定の両方を提供します。
+
+## 使用方法
+
+```bash
+# インタラクティブウィザード (推奨)
+mplx cm create --wizard
+
+# ディレクトリテンプレートを作成
+mplx cm create --template
+
+# 手動作成 (既存のcm-config.jsonが必要)
+mplx cm create
+```
+
+## 前提条件アセット
+
+選択したモード(ウィザードまたは手動)に関係なく、アセットを準備する必要があります。ダミーアセットで試したい場合は、`mplx cm create --template`を使用して作成できます。すべての画像とメタデータファイルは、独自の`assets`フォルダーにある必要があります。
+
+*画像ファイル:*
+
+- **フォーマット**: PNG、JPG
+- **命名**: 連続的 (0.png、1.png、2.png、...)
+
+*メタデータファイル:*
+
+- **フォーマット**: JSON
+- **命名**: 画像ファイルと一致 (0.json、1.json、2.json、...)
+- **スキーマ**: 標準[Metaplex Coreメタデータフォーマット](/ja/core/json-schema)
+
+*コレクションファイル:*
+
+- **collection.png**: コレクション画像
+- **collection.json**: コレクションメタデータ
+
+## テンプレートモード
+
+開始するための基本的なディレクトリ構造を作成します:
+
+```bash
+mplx cm create --template
+```
+
+これにより、以下の構造が作成されますが、キャンディマシンは作成されません。
+
+```text
+candy-machine-template/
+├── assets/
+│   ├── 0.png              # サンプル画像
+│   ├── 0.json             # サンプルメタデータ
+│   ├── collection.png     # サンプルコレクション画像
+│   └── collection.json    # サンプルコレクションメタデータ
+└── cm-config.json         # サンプル設定
+```
+
+テンプレート作成後:
+
+1. サンプルアセットを実際のファイルに置き換える
+2. `cm-config.json`の設定を更新
+3. `mplx cm create`を実行してデプロイ
+
+## インタラクティブウィザードモード
+
+ウィザードは、包括的な検証と進行状況追跡を備えたガイド付きのユーザーフレンドリーな体験を提供します。**これはほとんどのユーザーに推奨されるアプローチです。**
+
+### ウィザードワークフロー
+
+1. プロジェクトセットアップ
+2. アセット検出と検証
+3. コレクション設定
+4. キャンディマシンとキャンディガードの設定
+5. アセットのアップロードと処理
+6. キャンディマシンの作成
+7. アイテムの挿入
+
+## 手動設定モード
+
+設定プロセスを完全に制御したい上級ユーザー向け。
+
+### 前提条件
+
+1. 適切な構造を持つ**キャンディマシンアセットディレクトリ**
+2. 必要な設定を含む**手動作成された`cm-config.json`**。以下の例を参照
+3. 以下に示す構造で`assets/`ディレクトリに**準備されたアセット**
+
+### ディレクトリ構造
+
+```text
+my-candy-machine/
+├── assets/
+│   ├── 0.png
+│   ├── 0.json
+│   ├── 1.png
+│   ├── 1.json
+│   ├── ...
+│   ├── collection.png
+│   └── collection.json
+└── cm-config.json          # 必須
+```
+
+### 設定ファイル形式
+
+この構造で`cm-config.json`を作成します:
+
+```json
+{
+  "name": "My Candy Machine",
+  "config": {
+    "collection": "CollectionPublicKey...",  // 既存のコレクション
+    "itemsAvailable": 100,
+    "isMutable": true,
+    "isSequential": false,
+    "guardConfig": {
+      "solPayment": {
+        "lamports": 1000000000,
+        "destination": "111111111111111111111111111111111"
+      },
+      "mintLimit": {
+        "id": 1,
+        "limit": 1
+      }
+    },
+    "groups": [
+      {
+        "label": "wl",
+        "guards": {
+          "allowList": {
+            "merkleRoot": "MerkleRootHash..."
+          },
+          "solPayment": {
+            "lamports": 500000000,
+            "destination": "111111111111111111111111111111111"
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+### 手動ワークフロー
+
+```bash
+# 1. キャンディマシンディレクトリに移動
+cd ./my-candy-machine
+
+# 2. 既存の設定を使用してキャンディマシンを作成
+mplx cm create
+
+# 3. アセットをストレージにアップロード
+mplx cm upload
+
+# 4. アイテムをキャンディマシンに挿入
+mplx cm insert
+
+# 5. セットアップを検証 (オプション)
+mplx cm validate
+```
+
+## 設定オプション
+
+### コア設定
+
+| 設定 | 説明 | 必須 |
+|---------|-------------|----------|
+| `name` | キャンディマシンの表示名 | ✅ |
+| `itemsAvailable` | ミントする総アイテム数 | ✅ |
+| `isMutable` | ミント後にNFTを更新できるか | ✅ |
+| `isSequential` | アイテムを順番にミントするか | ✅ |
+| `collection` | 既存のコレクションアドレス (オプション) | ❌ |
+
+### ガード設定
+
+**グローバルガード** (`guardConfig`):
+
+- すべてのグループとキャンディマシン全体に適用
+- グループガードによってオーバーライドできない
+- 普遍的な制限に便利
+
+**ガードグループ** (`groups`):
+
+- 特定のグループにのみ適用
+- ミントフェーズごとに異なるルールを許可
+- グループラベルは最大6文字に制限
+
+### 一般的なガードの例
+
+#### 基本的なパブリックセール
+
+```json
+{
+  "guardConfig": {
+    "solPayment": {
+      "lamports": 1000000000,
+      "destination": "YourWalletAddress..."
+    },
+    "mintLimit": {
+      "id": 1,
+      "limit": 1
+    }
+  }
+}
+```
+
+#### ホワイトリストフェーズ
+
+```json
+{
+  "groups": [
+    {
+      "label": "wl",
+      "guards": {
+        "allowList": {
+          "merkleRoot": "MerkleRootHash..."
+        },
+        "solPayment": {
+          "lamports": 500000000,
+          "destination": "YourWalletAddress..."
+        }
+      }
+    }
+  ]
+}
+```
+
+### ヘルプの取得
+
+- コマンドオプションについては`mplx cm create --help`を使用
+- サポートについては[Metaplex Discord](https://discord.gg/metaplex)に参加
+
+## 関連コマンド
+
+- [`mplx cm upload`](/ja/cli/cm/upload) - アセットをストレージにアップロード
+- [`mplx cm insert`](/ja/cli/cm/insert) - アイテムをキャンディマシンに挿入
+- [`mplx cm validate`](/ja/cli/cm/validate) - アセットキャッシュを検証
+- [`mplx cm fetch`](/ja/cli/cm/fetch) - キャンディマシン情報を表示
+
+## 次のステップ
+
+1. 手動で作成した場合は**[アセットをアップロード](/ja/cli/cm/upload)**
+2. アセットをキャンディマシンにロードするために**[アイテムを挿入](/ja/cli/cm/insert)**
+3. すべてが機能することを確認するために**[セットアップを検証](/ja/cli/cm/validate)**
+4. 高度な設定については**[ガードについて学ぶ](/ja/core-candy-machine/guards)**

src/pages/ja/cli/cm/fetch.md

@@ -0,0 +1,29 @@
+---
+title: "情報を取得"
+metaTitle: "MPLX CLI - キャンディマシン情報取得"
+description: "MPLX CLIを使用してMPL Coreキャンディマシン情報を取得して表示します。設定、ガード設定、アイテムステータス、デプロイ詳細を表示。"
+---
+
+`mplx cm fetch`コマンドは、設定、ガード設定、アイテムステータス、デプロイ詳細を含むキャンディマシンに関する包括的な情報を取得して表示します。このコマンドは、キャンディマシンのセットアップを監視および検証するために不可欠です。
+
+## 使用方法
+
+```bash
+# 現在のキャンディマシンディレクトリから情報を取得
+mplx cm fetch
+
+# アドレスで特定のキャンディマシンを取得
+mplx cm fetch <candy_machine_address>
+
+```
+
+fetchコマンドは詳細情報用の追加フラグをサポートしています:
+
+- `--items`: ロードされたアイテムに関する詳細情報を含める
+
+## 関連コマンド
+
+- [`mplx cm create`](/ja/cli/cm/create) - 取得するキャンディマシンを作成
+- [`mplx cm insert`](/ja/cli/cm/insert) - アイテムをロード (アイテム数に影響)
+- [`mplx cm validate`](/ja/cli/cm/validate) - キャッシュとオンチェーンデータを検証
+- [`mplx cm withdraw`](/ja/cli/cm/withdraw) - ステータス確認後にクリーンアップ

src/pages/ja/cli/cm/index.md

@@ -0,0 +1,226 @@
+---
+title: "キャンディマシンコマンド"
+metaTitle: "MPLX CLI - キャンディマシンコマンド"
+description: "MPLX CLIを使用してMPL Coreキャンディマシンを作成および管理します。インタラクティブウィザード、アセットアップロード、完全なキャンディマシンのライフサイクル管理。"
+---
+
+MPLX CLIは、Solana上で**MPL Coreキャンディマシン**を作成および管理するための包括的なサポートを提供します。これらのコマンドを使用すると、設定可能なミントルールを持つNFTコレクションの作成、アセットのアップロード、直感的なコマンドラインインターフェイスを通じてキャンディマシン全体のライフサイクルを管理できます。
+
+## クイックスタート
+
+インタラクティブウィザードですぐに始めましょう:
+
+```bash
+mplx cm create --wizard
+```
+
+この単一のコマンドで、キャンディマシンを作成するためのすべてを処理します: アセットの検証、アップロード、ガード設定を含むキャンディマシンの作成、進行状況追跡を伴うアイテムの挿入。
+
+## コマンド概要
+
+| コマンド | 目的 | 主要機能 |
+|---------|---------|--------------|
+| [`create`](/ja/cli/cm/create) | 新しいキャンディマシンを作成 | インタラクティブウィザード、テンプレート生成、手動設定 |
+| [`upload`](/ja/cli/cm/upload) | アセットをストレージにアップロード | インテリジェントキャッシング、進行状況追跡、検証 |
+| [`insert`](/ja/cli/cm/insert) | キャンディマシンにアイテムを挿入 | スマートロード検出、バッチ処理 |
+| [`validate`](/ja/cli/cm/validate) | アセットキャッシュを検証 | 包括的な検証、エラー報告 |
+| [`fetch`](/ja/cli/cm/fetch) | キャンディマシン情報を取得 | 設定、ガード設定、ステータスの表示 |
+| [`withdraw`](/ja/cli/cm/withdraw) | 引き出しと削除 | クリーンな引き出し、残高回復 |
+
+## 主要機能
+
+### インタラクティブウィザード
+
+- **ガイド付きセットアップ**: ステップバイステップのキャンディマシン作成
+- **アセット検証**: 包括的なファイルとメタデータの検証
+- **進行状況追跡**: すべての操作のリアルタイムインジケーター
+- **エラー回復**: 実行可能なガイダンス付きの詳細なエラーメッセージ
+
+### インテリジェントアセット管理
+
+- **スマートキャッシング**: 可能な限り既存のアップロードを再利用
+- **バッチ処理**: 効率的なアセットのアップロードと挿入
+- **ファイル検証**: 適切な命名とメタデータ形式を保証
+- **コレクションサポート**: 自動コレクション作成
+
+### 柔軟な設定
+
+- **ガードサポート**: すべてのCore Candy Machineガードをサポート
+- **ガードグループ**: 異なるルールで異なるミントフェーズを作成
+- **テンプレート生成**: ディレクトリ構造の迅速なセットアップ
+- **手動設定**: 上級ユーザーはカスタム設定を作成可能
+
+## ディレクトリ構造
+
+すべてのキャンディマシンコマンドは、以下の構造を持つ**キャンディマシンアセットディレクトリ**から動作します:
+
+```text
+my-candy-machine/
+├── assets/
+│   ├── 0.png              # 画像ファイル (PNG, JPG)
+│   ├── 0.json             # メタデータファイル
+│   ├── 1.png
+│   ├── 1.json
+│   ├── ...
+│   ├── collection.png      # コレクション画像
+│   └── collection.json     # コレクションメタデータ
+├── asset-cache.json        # アセットアップロードキャッシュ (生成)
+└── cm-config.json          # キャンディマシン設定 (ウィザード使用時に生成)
+```
+
+## ワークフローオプション
+
+### オプション1: ウィザードモード (推奨)
+
+初心者とほとんどのユースケースに最適:
+
+```bash
+mplx cm create --wizard
+```
+
+**実行内容:**
+
+1. アセットと設定を検証
+2. 進行状況追跡を伴うすべてのアセットをアップロード
+3. オンチェーンでキャンディマシンを作成
+4. トランザクション進行状況を伴うすべてのアイテムを挿入
+5. 包括的な完了サマリーを提供
+
+### オプション2: 手動モード (上級)
+
+完全な制御を望む上級ユーザー向け:
+
+```bash
+# 1. ディレクトリと設定を手動でセットアップ
+mkdir my-candy-machine && cd my-candy-machine
+# (assets/ディレクトリを作成してアセットを追加)
+
+# 2. アセットをアップロード
+mplx cm upload
+
+# 3. キャンディマシンを作成
+mplx cm create
+
+# 4. アイテムを挿入
+mplx cm insert
+
+# 5. 検証 (オプション)
+mplx cm validate
+```
+
+## ガード設定
+
+CLIはすべてのCore Candy Machineガードとガードグループをサポートしています:
+
+### グローバルガード
+
+```json
+{
+  "guardConfig": {
+    "solPayment": {
+      "lamports": 1000000000,
+      "destination": "111111111111111111111111111111111"
+    },
+    "mintLimit": {
+      "id": 1,
+      "limit": 1
+    }
+  }
+}
+```
+
+### ガードグループ (ミントフェーズ)
+
+```json
+{
+  "groups": [
+    {
+      "label": "wl",
+      "guards": {
+        "allowList": {
+          "merkleRoot": "MerkleRootHash..."
+        },
+        "solPayment": {
+          "lamports": 500000000,
+          "destination": "111111111111111111111111111111111"
+        }
+      }
+    },
+    {
+      "label": "public",
+      "guards": {
+        "solPayment": {
+          "lamports": 1000000000,
+          "destination": "111111111111111111111111111111111"
+        }
+      }
+    }
+  ]
+}
+```
+
+## 利用可能なガード
+
+CLIはすべてのCore Candy Machineガードをサポートしています:
+
+**ペイメントガード**: `solPayment`、`solFixedFee`、`tokenPayment`、`token2022Payment`、`nftPayment`、`assetPayment`、`assetPaymentMulti`
+
+**アクセス制御**: `addressGate`、`allowList`、`nftGate`、`tokenGate`、`assetGate`、`programGate`、`thirdPartySigner`
+
+**時間ベース**: `startDate`、`endDate`
+
+**制限**: `mintLimit`、`allocation`、`nftMintLimit`、`assetMintLimit`、`redeemedAmount`
+
+**バーンガード**: `nftBurn`、`tokenBurn`、`assetBurn`、`assetBurnMulti`
+
+**特別**: `botTax`、`edition`、`vanityMint`
+
+**フリーズガード**: `freezeSolPayment`、`freezeTokenPayment`
+
+詳細なガードドキュメントについては、[Core Candy Machineガード](/ja/core-candy-machine/guards)リファレンスを参照してください。
+
+## ベストプラクティス
+
+### 🎯 ディレクトリの整理
+
+- 各キャンディマシンを独自のディレクトリに保持
+- 説明的なディレクトリ名を使用
+- 一貫したアセット命名を維持 (0.png、1.pngなど)
+- キャンディマシンディレクトリをバックアップ
+
+### 📁 アセットの準備
+
+- 一貫した命名を使用 (0.png、1.pngなど)
+- メタデータJSONファイルが画像ファイルと一致することを確認
+- 画像フォーマットを検証 (PNG、JPGサポート)
+- ファイルサイズを適切に保つ (< 10MB推奨)
+- 有効な「name」フィールドを持つcollection.jsonを含める
+
+### ⚙️ 設定
+
+- メインネット前にdevnetでテスト
+- ガイド付き設定にはウィザードを使用
+- 設定ファイルをバックアップ
+- ガード設定を文書化
+- 少なくとも1つのガードまたはガードグループの追加を検討
+
+### 🚀 デプロイ
+
+- キャンディマシンの作成を検証
+- ミント機能をテスト
+- トランザクションステータスを監視
+- 検証用のエクスプローラーリンクを保持
+
+## 関連ドキュメント
+
+- [Core Candy Machine概要](/ja/core-candy-machine) - MPL Core Candy Machinesの理解
+- [Core Candy Machineガード](/ja/core-candy-machine/guards) - 完全なガードリファレンス
+- [CLIインストール](/ja/cli/installation) - MPLX CLIのセットアップ
+- [CLI設定](/ja/cli/config/wallets) - ウォレットとRPCのセットアップ
+
+## 次のステップ
+
+1. まだの場合は**[CLIをインストール](/ja/cli/installation)**
+2. ウィザードを使用して**[最初のキャンディマシンを作成](/ja/cli/cm/create)**
+3. 高度なミントルールのために**[ガード設定を探索](/ja/core-candy-machine/guards)**
+4. 段階的なローンチのために**[ガードグループについて学ぶ](/ja/core-candy-machine/guard-groups)**

src/pages/ja/cli/cm/insert.md

@@ -0,0 +1,53 @@
+---
+title: "アイテムを挿入"
+metaTitle: "MPLX CLI - アイテム挿入コマンド"
+description: "MPLX CLIを使用してアップロードされたアセットをMPL Coreキャンディマシンに挿入します。"
+---
+
+`mplx cm insert`コマンドは、キャッシュファイルからアップロードされたアセットをオンチェーンのキャンディマシンに挿入し、ミントで使用できるようにします。スマートロード検出、効率的なバッチ処理、詳細なトランザクション追跡が特徴です。
+
+## 使用方法
+
+```bash
+# 現在のキャンディマシンディレクトリからアイテムを挿入
+mplx cm insert
+
+# 特定のキャンディマシンディレクトリからアイテムを挿入
+mplx cm insert <directory>
+```
+
+## 要件
+
+insertコマンドを実行する前に、以下があることを確認してください:
+
+1. **アセットキャッシュ**: アップロードされたURIを含む有効な`asset-cache.json`
+2. **キャンディマシン**: キャッシュにIDが含まれる作成済みのキャンディマシン
+3. **ウォレット残高**: トランザクション手数料に十分なSOL
+4. **ネットワークアクセス**: Solanaネットワークへの安定した接続
+
+### 前提条件
+
+```bash
+# 1. キャンディマシンが作成されている必要があります
+mplx cm create
+
+# 2. アセットをアップロード
+mplx cm upload
+
+# 3. 次にアイテムを挿入
+mplx cm insert
+```
+
+## 関連コマンド
+
+- [`mplx cm upload`](/ja/cli/cm/upload) - アセットをアップロード (挿入前に必要)
+- [`mplx cm create`](/ja/cli/cm/create) - キャンディマシンを作成 (挿入前に必要)
+- [`mplx cm validate`](/ja/cli/cm/validate) - キャッシュとアップロードを検証
+- [`mplx cm fetch`](/ja/cli/cm/fetch) - 挿入ステータスを確認
+
+## 次のステップ
+
+1. すべてのアイテムがロードされていることを確認するために**[挿入を検証](/ja/cli/cm/fetch)**
+2. キャンディマシンが機能することを確認するために**[ミントをテスト](/ja/core-candy-machine/mint)**
+3. 問題をチェックするために**[キャッシュとアセットを検証](/ja/cli/cm/validate)**
+4. 適切なガードで**[ローンチを計画](/ja/core-candy-machine/guides)**

src/pages/ja/cli/cm/upload.md

@@ -0,0 +1,87 @@
+---
+title: "アセットをアップロード"
+metaTitle: "MPLX CLI - アセットアップロードコマンド"
+description: "MPLX CLIを使用してキャンディマシンアセットを分散型ストレージにアップロードします。インテリジェントキャッシング、進行状況追跡、包括的な検証。"
+---
+
+`mplx cm upload`コマンドは、アセットを分散型ストレージにアップロードし、アップロードURIとメタデータを含む`asset-cache.json`ファイルを生成します。このコマンドは、インテリジェントキャッシング、進行状況追跡、包括的な検証を提供します。
+
+## 使用方法
+
+```bash
+# 現在のキャンディマシンディレクトリからアセットをアップロード
+mplx cm upload
+
+# 特定のキャンディマシンディレクトリからアセットをアップロード
+mplx cm upload <directory>
+```
+
+### ディレクトリ構造
+
+```text
+my-candy-machine/
+├── assets/
+│   ├── 0.png              # 画像ファイル (PNG, JPG)
+│   ├── 0.json             # メタデータファイル
+│   ├── 1.png
+│   ├── 1.json
+│   ├── ...
+│   ├── collection.png      # コレクション画像
+│   └── collection.json     # コレクションメタデータ
+└── asset-cache.json        # アップロード後に生成
+```
+
+## アップロードプロセス
+
+1. アセット検出: コマンドは自動的に`assets/`ディレクトリをスキャンし、画像、メタデータ、コレクションファイルを識別します。
+2. 検証フェーズ: ファイルの整合性を検証します。たとえば、すべての画像ファイルに一致するメタデータファイルがあり、メタデータが有効なjsonであることを確認します。
+3. キャッシュチェック: すでにアップロードされたファイルを識別するために`asset-cache.json`ファイルが検証されます。
+4. アップロード: 実際のアップロードが行われます。
+5. キャッシュ生成: `asset-cache.json`ファイルが生成されます
+
+## 生成されたアセットキャッシュ
+
+`asset-cache.json`ファイルには、アップロードされたアセットに関する詳細情報が含まれています。手動で検査および使用することは上級ユーザーのみに推奨されます。
+
+例:
+
+```json
+{
+  "candyMachineId": null,
+  "collection": null,
+  "assetItems": {
+    "0": {
+      "name": "Asset #0",
+      "image": "0.png",
+      "imageUri": "https://gateway.irys.xyz/ABC123...",
+      "imageType": "image/png",
+      "json": "0.json",
+      "jsonUri": "https://gateway.irys.xyz/DEF456...",
+      "loaded": false
+    },
+    "1": {
+      "name": "Asset #1",
+      "image": "1.png",
+      "imageUri": "https://gateway.irys.xyz/GHI789...",
+      "imageType": "image/png",
+      "json": "1.json",
+      "jsonUri": "https://gateway.irys.xyz/JKL012...",
+      "loaded": false
+    }
+  }
+}
+```
+
+## 関連コマンド
+
+- [`mplx cm create`](/ja/cli/cm/create) - キャンディマシンを作成 (自動的にアップロード可能)
+- [`mplx cm validate`](/ja/cli/cm/validate) - アップロードされたアセットを検証
+- [`mplx cm insert`](/ja/cli/cm/insert) - アップロードされたアセットをキャンディマシンに挿入
+- [`mplx cm fetch`](/ja/cli/cm/fetch) - キャンディマシンとアセット情報を表示
+
+## 次のステップ
+
+1. すべてが正しくアップロードされたことを確認するために**[アップロードを検証](/ja/cli/cm/validate)**
+2. アップロードされたアセットを使用して**[キャンディマシンを作成](/ja/cli/cm/create)**
+3. アセットをキャンディマシンにロードするために**[アイテムを挿入](/ja/cli/cm/insert)**
+4. すべてが機能していることを確認するために**[セットアップを監視](/ja/cli/cm/fetch)**

src/pages/ja/cli/cm/validate.md

@@ -0,0 +1,36 @@
+---
+title: "キャッシュを検証"
+metaTitle: "MPLX CLI - キャッシュ検証コマンド"
+description: "MPLX CLIを使用してキャンディマシンアセットキャッシュとアップロードを検証します。包括的な検証、エラー検出、キャッシュ整合性検証。"
+---
+
+`mplx cm validate`コマンドは、すべてのアセットが適切にアップロードされアクセス可能であることを確認するためにアセットキャッシュファイルを検証します。包括的な検証、エラー検出、キャッシュ整合性検証を提供します。
+
+## 使用方法
+
+```bash
+# 現在のキャンディマシンディレクトリでキャッシュを検証
+mplx cm validate
+
+# 特定のキャッシュファイルを検証
+mplx cm validate <path_to_asset_cache>
+
+# オンチェーン挿入を検証 (キャンディマシンが存在する必要があります)
+mplx cm validate --onchain
+```
+
+検証コマンドが問題を示す場合、エラーに応じて、アセットの問題を確認するか、uploadまたはinsertコマンドを実行することをお勧めします。
+
+## 関連コマンド
+
+- [`mplx cm upload`](/ja/cli/cm/upload) - アセットをアップロードしてキャッシュを作成
+- [`mplx cm create`](/ja/cli/cm/create) - キャンディマシンを作成
+- [`mplx cm insert`](/ja/cli/cm/insert) - 検証されたアセットを挿入
+- [`mplx cm fetch`](/ja/cli/cm/fetch) - キャンディマシンのステータスを確認
+
+## 次のステップ
+
+1. 検証中に見つかった**[問題を修正](/ja/cli/cm/upload)**
+2. キャッシュが有効な場合は**[キャンディマシンを作成](/ja/cli/cm/create)**
+3. アセットをロードするために**[アイテムを挿入](/ja/cli/cm/insert)**
+4. 成功を確認するために**[デプロイを監視](/ja/cli/cm/fetch)**

src/pages/ja/cli/cm/withdraw.md

@@ -0,0 +1,53 @@
+---
+title: "引き出し"
+metaTitle: "MPLX CLI - キャンディマシン引き出し"
+description: "MPLX CLIを使用してMPL Coreキャンディマシンを引き出して削除し、レントSOLを回収します。"
+---
+
+`mplx cm withdraw`コマンドは、キャンディマシンを引き出して削除し、残っているSOL残高を回収し、オンチェーンアカウントをクリーンアップします。この操作は元に戻せず、キャンディマシンが不要になった場合に使用する必要があります。すでにミントされたNFTは影響を受けません。
+
+{% callout title="元に戻せません" type="warning" %}
+このコマンドは元に戻せません。実行すると、キャンディマシンは破壊され、再作成できません。
+{% /callout %}
+
+## 使用方法
+
+```bash
+# 現在のディレクトリからキャンディマシンを引き出し
+mplx cm withdraw
+
+# アドレスで特定のキャンディマシンを引き出し
+mplx cm withdraw --address <candy_machine_address>
+
+```
+
+使用できるオプションフラグ:
+
+- `--address`: キャンディマシンアドレスを直接指定
+- `--force`: *危険* 確認プロンプトをスキップ (細心の注意を払って使用)
+
+### ⚠️ 元に戻せない操作
+
+- **永久削除**: キャンディマシンアカウントは永久に削除されます
+- **回復不可**: 元に戻すことも復元することもできません
+- **データ損失**: すべてのオンチェーン設定と状態が失われます
+- **ミントされたNFT**: 既存のミントされたNFTは影響を受けません
+
+### 🛡️ ベストプラクティス
+
+**計画:**
+
+- 引き出しのタイミングを慎重に計画
+- チームメンバーと調整
+
+**実行:**
+
+- すべてのパラメータを再確認
+- 練習のためにdevnetを使用
+
+## 関連コマンド
+
+- [`mplx cm fetch`](/ja/cli/cm/fetch) - 引き出し前にステータスを確認
+- [`mplx cm create`](/ja/cli/cm/create) - 新しいキャンディマシンを作成
+- [`mplx cm validate`](/ja/cli/cm/validate) - 引き出し前に検証
+- [`solana balance`](https://docs.solana.com/cli) - 回収された残高を確認

src/pages/ko/cli/cm/create.md

@@ -0,0 +1,249 @@
+---
+title: "캔디 머신 생성"
+metaTitle: "MPLX CLI - 캔디 머신 생성 명령어"
+description: "MPLX CLI를 사용하여 MPL Core 캔디 머신을 생성합니다. 검증, 자산 업로드 및 완전한 설정 자동화를 갖춘 대화형 마법사 모드."
+---
+
+`mplx cm create` 명령어는 구성 가능한 설정과 자산 업로드를 통해 새로운 MPL Core 캔디 머신을 생성합니다. 초보자를 위한 대화형 마법사와 고급 사용자를 위한 수동 구성을 모두 제공합니다.
+
+## 사용법
+
+```bash
+# 대화형 마법사 (권장)
+mplx cm create --wizard
+
+# 디렉토리 템플릿 생성
+mplx cm create --template
+
+# 수동 생성 (기존 cm-config.json 필요)
+mplx cm create
+```
+
+## 전제 조건 자산
+
+선택한 모드(마법사 또는 수동)와 관계없이 자산을 준비해야 합니다. 더미 자산으로 실험하고 싶다면 `mplx cm create --template`를 사용하여 생성할 수 있습니다. 모든 이미지 및 메타데이터 파일은 별도의 `assets` 폴더에 있어야 합니다.
+
+*이미지 파일:*
+
+- **형식**: PNG, JPG
+- **이름 지정**: 순차적 (0.png, 1.png, 2.png, ...)
+
+*메타데이터 파일:*
+
+- **형식**: JSON
+- **이름 지정**: 이미지 파일과 일치 (0.json, 1.json, 2.json, ...)
+- **스키마**: 표준 [Metaplex Core 메타데이터 형식](/ko/core/json-schema)
+
+*컬렉션 파일:*
+
+- **collection.png**: 컬렉션 이미지
+- **collection.json**: 컬렉션 메타데이터
+
+## 템플릿 모드
+
+시작하기 위한 기본 디렉토리 구조를 생성합니다:
+
+```bash
+mplx cm create --template
+```
+
+이것은 다음 구조를 생성하지만 캔디 머신은 생성하지 않습니다.
+
+```text
+candy-machine-template/
+├── assets/
+│   ├── 0.png              # 예제 이미지
+│   ├── 0.json             # 예제 메타데이터
+│   ├── collection.png     # 예제 컬렉션 이미지
+│   └── collection.json    # 예제 컬렉션 메타데이터
+└── cm-config.json         # 예제 구성
+```
+
+템플릿 생성 후:
+
+1. 예제 자산을 실제 파일로 교체
+2. `cm-config.json`에서 구성 업데이트
+3. `mplx cm create`를 실행하여 배포
+
+## 대화형 마법사 모드
+
+마법사는 포괄적인 검증과 진행 상황 추적을 통해 안내되는 사용자 친화적인 경험을 제공합니다. **이것은 대부분의 사용자에게 권장되는 접근 방식입니다.**
+
+### 마법사 워크플로우
+
+1. 프로젝트 설정
+2. 자산 검색 및 검증
+3. 컬렉션 구성
+4. 캔디 머신 및 캔디 가드 설정
+5. 자산 업로드 및 처리
+6. 캔디 머신 생성
+7. 아이템 삽입
+
+## 수동 구성 모드
+
+구성 프로세스를 완전히 제어하고자 하는 고급 사용자를 위한 것입니다.
+
+### 전제 조건
+
+1. 적절한 구조를 가진 **캔디 머신 자산 디렉토리**
+2. 필수 구성이 포함된 **수동으로 생성된 `cm-config.json`**. 아래 예제 참조
+3. 아래와 같은 구조의 `assets/` 디렉토리에 **준비된 자산**
+
+### 디렉토리 구조
+
+```text
+my-candy-machine/
+├── assets/
+│   ├── 0.png
+│   ├── 0.json
+│   ├── 1.png
+│   ├── 1.json
+│   ├── ...
+│   ├── collection.png
+│   └── collection.json
+└── cm-config.json          # 필수
+```
+
+### 구성 파일 형식
+
+이 구조로 `cm-config.json`을 생성합니다:
+
+```json
+{
+  "name": "My Candy Machine",
+  "config": {
+    "collection": "CollectionPublicKey...",  // 기존 컬렉션
+    "itemsAvailable": 100,
+    "isMutable": true,
+    "isSequential": false,
+    "guardConfig": {
+      "solPayment": {
+        "lamports": 1000000000,
+        "destination": "111111111111111111111111111111111"
+      },
+      "mintLimit": {
+        "id": 1,
+        "limit": 1
+      }
+    },
+    "groups": [
+      {
+        "label": "wl",
+        "guards": {
+          "allowList": {
+            "merkleRoot": "MerkleRootHash..."
+          },
+          "solPayment": {
+            "lamports": 500000000,
+            "destination": "111111111111111111111111111111111"
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+### 수동 워크플로우
+
+```bash
+# 1. 캔디 머신 디렉토리로 이동
+cd ./my-candy-machine
+
+# 2. 기존 구성을 사용하여 캔디 머신 생성
+mplx cm create
+
+# 3. 스토리지에 자산 업로드
+mplx cm upload
+
+# 4. 캔디 머신에 아이템 삽입
+mplx cm insert
+
+# 5. 설정 검증 (선택사항)
+mplx cm validate
+```
+
+## 구성 옵션
+
+### 핵심 설정
+
+| 설정 | 설명 | 필수 |
+|---------|-------------|----------|
+| `name` | 캔디 머신의 표시 이름 | ✅ |
+| `itemsAvailable` | 민팅할 총 아이템 수 | ✅ |
+| `isMutable` | 민팅 후 NFT를 업데이트할 수 있는지 여부 | ✅ |
+| `isSequential` | 아이템을 순서대로 민팅할지 여부 | ✅ |
+| `collection` | 기존 컬렉션 주소 (선택사항) | ❌ |
+
+### 가드 구성
+
+**글로벌 가드** (`guardConfig`):
+
+- 모든 그룹과 캔디 머신 전체에 적용
+- 그룹 가드로 재정의할 수 없음
+- 범용 제한에 유용
+
+**가드 그룹** (`groups`):
+
+- 특정 그룹에만 적용
+- 민팅 단계별로 다른 규칙 허용
+- 그룹 레이블은 최대 6자로 제한
+
+### 일반적인 가드 예제
+
+#### 기본 퍼블릭 세일
+
+```json
+{
+  "guardConfig": {
+    "solPayment": {
+      "lamports": 1000000000,
+      "destination": "YourWalletAddress..."
+    },
+    "mintLimit": {
+      "id": 1,
+      "limit": 1
+    }
+  }
+}
+```
+
+#### 화이트리스트 단계
+
+```json
+{
+  "groups": [
+    {
+      "label": "wl",
+      "guards": {
+        "allowList": {
+          "merkleRoot": "MerkleRootHash..."
+        },
+        "solPayment": {
+          "lamports": 500000000,
+          "destination": "YourWalletAddress..."
+        }
+      }
+    }
+  ]
+}
+```
+
+### 도움말 받기
+
+- 명령 옵션은 `mplx cm create --help` 사용
+- 지원은 [Metaplex Discord](https://discord.gg/metaplex) 참여
+
+## 관련 명령어
+
+- [`mplx cm upload`](/ko/cli/cm/upload) - 스토리지에 자산 업로드
+- [`mplx cm insert`](/ko/cli/cm/insert) - 캔디 머신에 아이템 삽입
+- [`mplx cm validate`](/ko/cli/cm/validate) - 자산 캐시 검증
+- [`mplx cm fetch`](/ko/cli/cm/fetch) - 캔디 머신 정보 보기
+
+## 다음 단계
+
+1. 수동으로 생성한 경우 **[자산 업로드](/ko/cli/cm/upload)**
+2. 캔디 머신에 자산을 로드하기 위해 **[아이템 삽입](/ko/cli/cm/insert)**
+3. 모든 것이 작동하는지 확인하기 위해 **[설정 검증](/ko/cli/cm/validate)**
+4. 고급 구성을 위해 **[가드에 대해 배우기](/ko/core-candy-machine/guards)**

src/pages/ko/cli/cm/fetch.md

@@ -0,0 +1,29 @@
+---
+title: "정보 가져오기"
+metaTitle: "MPLX CLI - 캔디 머신 정보 가져오기"
+description: "MPLX CLI를 사용하여 MPL Core 캔디 머신 정보를 가져오고 표시합니다. 구성, 가드 설정, 아이템 상태 및 배포 세부 정보 보기."
+---
+
+`mplx cm fetch` 명령어는 구성, 가드 설정, 아이템 상태 및 배포 세부 정보를 포함한 캔디 머신에 대한 포괄적인 정보를 검색하고 표시합니다. 이 명령은 캔디 머신 설정을 모니터링하고 검증하는 데 필수적입니다.
+
+## 사용법
+
+```bash
+# 현재 캔디 머신 디렉토리에서 정보 가져오기
+mplx cm fetch
+
+# 주소로 특정 캔디 머신 가져오기
+mplx cm fetch <candy_machine_address>
+
+```
+
+fetch 명령어는 자세한 정보를 위한 추가 플래그를 지원합니다:
+
+- `--items`: 로드된 아이템에 대한 자세한 정보 포함
+
+## 관련 명령어
+
+- [`mplx cm create`](/ko/cli/cm/create) - 가져올 캔디 머신 생성
+- [`mplx cm insert`](/ko/cli/cm/insert) - 아이템 로드 (아이템 수에 영향)
+- [`mplx cm validate`](/ko/cli/cm/validate) - 캐시와 온체인 데이터 검증
+- [`mplx cm withdraw`](/ko/cli/cm/withdraw) - 상태 확인 후 정리

src/pages/ko/cli/cm/index.md

@@ -0,0 +1,226 @@
+---
+title: "캔디 머신 명령어"
+metaTitle: "MPLX CLI - 캔디 머신 명령어"
+description: "MPLX CLI를 사용하여 MPL Core 캔디 머신을 생성하고 관리합니다. 대화형 마법사, 자산 업로드, 완전한 캔디 머신 라이프사이클 관리."
+---
+
+MPLX CLI는 Solana에서 **MPL Core 캔디 머신**을 생성하고 관리하기 위한 포괄적인 지원을 제공합니다. 이러한 명령을 사용하면 구성 가능한 민팅 규칙을 가진 NFT 컬렉션을 생성하고, 자산을 업로드하며, 직관적인 명령줄 인터페이스를 통해 전체 캔디 머신 라이프사이클을 관리할 수 있습니다.
+
+## 빠른 시작
+
+대화형 마법사로 빠르게 시작하세요:
+
+```bash
+mplx cm create --wizard
+```
+
+이 단일 명령으로 캔디 머신을 생성하는 모든 것을 처리합니다: 자산 검증, 업로드, 가드 구성을 포함한 캔디 머신 생성, 진행 상황 추적을 통한 아이템 삽입.
+
+## 명령 개요
+
+| 명령어 | 목적 | 주요 기능 |
+|---------|---------|--------------|
+| [`create`](/ko/cli/cm/create) | 새 캔디 머신 생성 | 대화형 마법사, 템플릿 생성, 수동 구성 |
+| [`upload`](/ko/cli/cm/upload) | 스토리지에 자산 업로드 | 지능형 캐싱, 진행 상황 추적, 검증 |
+| [`insert`](/ko/cli/cm/insert) | 캔디 머신에 아이템 삽입 | 스마트 로딩 감지, 배치 처리 |
+| [`validate`](/ko/cli/cm/validate) | 자산 캐시 검증 | 포괄적인 검증, 오류 보고 |
+| [`fetch`](/ko/cli/cm/fetch) | 캔디 머신 정보 가져오기 | 구성, 가드 설정, 상태 표시 |
+| [`withdraw`](/ko/cli/cm/withdraw) | 인출 및 삭제 | 깔끔한 인출, 잔액 회복 |
+
+## 주요 기능
+
+### 대화형 마법사
+
+- **안내식 설정**: 단계별 캔디 머신 생성
+- **자산 검증**: 포괄적인 파일 및 메타데이터 검증
+- **진행 상황 추적**: 모든 작업에 대한 실시간 표시기
+- **오류 복구**: 실행 가능한 안내가 포함된 상세한 오류 메시지
+
+### 지능형 자산 관리
+
+- **스마트 캐싱**: 가능한 경우 기존 업로드 재사용
+- **배치 처리**: 효율적인 자산 업로드 및 삽입
+- **파일 검증**: 적절한 이름 지정 및 메타데이터 형식 보장
+- **컬렉션 지원**: 자동 컬렉션 생성
+
+### 유연한 구성
+
+- **가드 지원**: 모든 Core Candy Machine 가드 지원
+- **가드 그룹**: 서로 다른 규칙을 가진 다양한 민팅 단계 생성
+- **템플릿 생성**: 빠른 디렉토리 구조 설정
+- **수동 구성**: 고급 사용자는 사용자 정의 구성 생성 가능
+
+## 디렉토리 구조
+
+모든 캔디 머신 명령은 다음 구조를 가진 **캔디 머신 자산 디렉토리**에서 작동합니다:
+
+```text
+my-candy-machine/
+├── assets/
+│   ├── 0.png              # 이미지 파일 (PNG, JPG)
+│   ├── 0.json             # 메타데이터 파일
+│   ├── 1.png
+│   ├── 1.json
+│   ├── ...
+│   ├── collection.png      # 컬렉션 이미지
+│   └── collection.json     # 컬렉션 메타데이터
+├── asset-cache.json        # 자산 업로드 캐시 (생성됨)
+└── cm-config.json          # 캔디 머신 구성 (마법사 사용 시 생성됨)
+```
+
+## 워크플로우 옵션
+
+### 옵션 1: 마법사 모드 (권장)
+
+초보자와 대부분의 사용 사례에 완벽:
+
+```bash
+mplx cm create --wizard
+```
+
+**수행 작업:**
+
+1. 자산 및 구성 검증
+2. 진행 상황 추적을 통해 모든 자산 업로드
+3. 온체인에서 캔디 머신 생성
+4. 트랜잭션 진행 상황과 함께 모든 아이템 삽입
+5. 포괄적인 완료 요약 제공
+
+### 옵션 2: 수동 모드 (고급)
+
+완전한 제어를 원하는 고급 사용자를 위해:
+
+```bash
+# 1. 수동으로 디렉토리 및 구성 설정
+mkdir my-candy-machine && cd my-candy-machine
+# (assets/ 디렉토리를 생성하고 자산 추가)
+
+# 2. 자산 업로드
+mplx cm upload
+
+# 3. 캔디 머신 생성
+mplx cm create
+
+# 4. 아이템 삽입
+mplx cm insert
+
+# 5. 검증 (선택사항)
+mplx cm validate
+```
+
+## 가드 구성
+
+CLI는 모든 Core Candy Machine 가드 및 가드 그룹을 지원합니다:
+
+### 글로벌 가드
+
+```json
+{
+  "guardConfig": {
+    "solPayment": {
+      "lamports": 1000000000,
+      "destination": "111111111111111111111111111111111"
+    },
+    "mintLimit": {
+      "id": 1,
+      "limit": 1
+    }
+  }
+}
+```
+
+### 가드 그룹 (민팅 단계)
+
+```json
+{
+  "groups": [
+    {
+      "label": "wl",
+      "guards": {
+        "allowList": {
+          "merkleRoot": "MerkleRootHash..."
+        },
+        "solPayment": {
+          "lamports": 500000000,
+          "destination": "111111111111111111111111111111111"
+        }
+      }
+    },
+    {
+      "label": "public",
+      "guards": {
+        "solPayment": {
+          "lamports": 1000000000,
+          "destination": "111111111111111111111111111111111"
+        }
+      }
+    }
+  ]
+}
+```
+
+## 사용 가능한 가드
+
+CLI는 모든 Core Candy Machine 가드를 지원합니다:
+
+**결제 가드**: `solPayment`, `solFixedFee`, `tokenPayment`, `token2022Payment`, `nftPayment`, `assetPayment`, `assetPaymentMulti`
+
+**액세스 제어**: `addressGate`, `allowList`, `nftGate`, `tokenGate`, `assetGate`, `programGate`, `thirdPartySigner`
+
+**시간 기반**: `startDate`, `endDate`
+
+**제한**: `mintLimit`, `allocation`, `nftMintLimit`, `assetMintLimit`, `redeemedAmount`
+
+**소각 가드**: `nftBurn`, `tokenBurn`, `assetBurn`, `assetBurnMulti`
+
+**특수**: `botTax`, `edition`, `vanityMint`
+
+**동결 가드**: `freezeSolPayment`, `freezeTokenPayment`
+
+자세한 가드 문서는 [Core Candy Machine 가드](/ko/core-candy-machine/guards) 참조를 확인하세요.
+
+## 모범 사례
+
+### 🎯 디렉토리 구성
+
+- 각 캔디 머신을 별도의 디렉토리에 보관
+- 설명적인 디렉토리 이름 사용
+- 일관된 자산 이름 지정 유지 (0.png, 1.png 등)
+- 캔디 머신 디렉토리 백업
+
+### 📁 자산 준비
+
+- 일관된 이름 지정 사용 (0.png, 1.png 등)
+- 메타데이터 JSON 파일이 이미지 파일과 일치하는지 확인
+- 이미지 형식 검증 (PNG, JPG 지원)
+- 파일 크기를 적절하게 유지 (< 10MB 권장)
+- 유효한 "name" 필드가 있는 collection.json 포함
+
+### ⚙️ 구성
+
+- 메인넷 전에 데브넷에서 테스트
+- 안내식 구성을 위해 마법사 사용
+- 구성 파일 백업
+- 가드 설정 문서화
+- 최소한 하나의 가드 또는 가드 그룹 추가 고려
+
+### 🚀 배포
+
+- 캔디 머신 생성 확인
+- 민팅 기능 테스트
+- 트랜잭션 상태 모니터링
+- 검증을 위한 탐색기 링크 보관
+
+## 관련 문서
+
+- [Core Candy Machine 개요](/ko/core-candy-machine) - MPL Core 캔디 머신 이해
+- [Core Candy Machine 가드](/ko/core-candy-machine/guards) - 완전한 가드 참조
+- [CLI 설치](/ko/cli/installation) - MPLX CLI 설정
+- [CLI 구성](/ko/cli/config/wallets) - 지갑 및 RPC 설정
+
+## 다음 단계
+
+1. 아직 설치하지 않았다면 **[CLI 설치](/ko/cli/installation)**
+2. 마법사를 사용하여 **[첫 번째 캔디 머신 생성](/ko/cli/cm/create)**
+3. 고급 민팅 규칙을 위한 **[가드 구성 탐색](/ko/core-candy-machine/guards)**
+4. 단계별 출시를 위한 **[가드 그룹에 대해 배우기](/ko/core-candy-machine/guard-groups)**

src/pages/ko/cli/cm/insert.md

@@ -0,0 +1,53 @@
+---
+title: "아이템 삽입"
+metaTitle: "MPLX CLI - 아이템 삽입 명령어"
+description: "MPLX CLI를 사용하여 업로드된 자산을 MPL Core 캔디 머신에 삽입합니다."
+---
+
+`mplx cm insert` 명령어는 캐시 파일에서 업로드된 자산을 온체인 캔디 머신에 삽입하여 민팅에 사용할 수 있도록 합니다. 스마트 로딩 감지, 효율적인 배치 처리 및 상세한 트랜잭션 추적 기능이 있습니다.
+
+## 사용법
+
+```bash
+# 현재 캔디 머신 디렉토리에서 아이템 삽입
+mplx cm insert
+
+# 특정 캔디 머신 디렉토리에서 아이템 삽입
+mplx cm insert <directory>
+```
+
+## 요구 사항
+
+insert 명령을 실행하기 전에 다음이 있는지 확인하세요:
+
+1. **자산 캐시**: 업로드된 URI가 포함된 유효한 `asset-cache.json`
+2. **캔디 머신**: 캐시에 ID가 있는 생성된 캔디 머신
+3. **지갑 잔액**: 트랜잭션 수수료를 위한 충분한 SOL
+4. **네트워크 액세스**: Solana 네트워크에 대한 안정적인 연결
+
+### 전제 조건
+
+```bash
+# 1. 캔디 머신이 생성되어 있어야 합니다
+mplx cm create
+
+# 2. 자산 업로드
+mplx cm upload
+
+# 3. 그런 다음 아이템 삽입
+mplx cm insert
+```
+
+## 관련 명령어
+
+- [`mplx cm upload`](/ko/cli/cm/upload) - 자산 업로드 (삽입 전 필요)
+- [`mplx cm create`](/ko/cli/cm/create) - 캔디 머신 생성 (삽입 전 필요)
+- [`mplx cm validate`](/ko/cli/cm/validate) - 캐시 및 업로드 검증
+- [`mplx cm fetch`](/ko/cli/cm/fetch) - 삽입 상태 확인
+
+## 다음 단계
+
+1. 모든 아이템이 로드되었는지 확인하기 위해 **[삽입 확인](/ko/cli/cm/fetch)**
+2. 캔디 머신이 작동하는지 확인하기 위해 **[민팅 테스트](/ko/core-candy-machine/mint)**
+3. 문제를 확인하기 위해 **[캐시 및 자산 검증](/ko/cli/cm/validate)**
+4. 적절한 가드로 **[출시 계획](/ko/core-candy-machine/guides)**

src/pages/ko/cli/cm/upload.md

@@ -0,0 +1,87 @@
+---
+title: "자산 업로드"
+metaTitle: "MPLX CLI - 자산 업로드 명령어"
+description: "MPLX CLI를 사용하여 캔디 머신 자산을 분산 스토리지에 업로드합니다. 지능형 캐싱, 진행 상황 추적 및 포괄적인 검증."
+---
+
+`mplx cm upload` 명령어는 자산을 분산 스토리지에 업로드하고 업로드 URI 및 메타데이터를 포함하는 `asset-cache.json` 파일을 생성합니다. 이 명령은 지능형 캐싱, 진행 상황 추적 및 포괄적인 검증을 제공합니다.
+
+## 사용법
+
+```bash
+# 현재 캔디 머신 디렉토리에서 자산 업로드
+mplx cm upload
+
+# 특정 캔디 머신 디렉토리에서 자산 업로드
+mplx cm upload <directory>
+```
+
+### 디렉토리 구조
+
+```text
+my-candy-machine/
+├── assets/
+│   ├── 0.png              # 이미지 파일 (PNG, JPG)
+│   ├── 0.json             # 메타데이터 파일
+│   ├── 1.png
+│   ├── 1.json
+│   ├── ...
+│   ├── collection.png      # 컬렉션 이미지
+│   └── collection.json     # 컬렉션 메타데이터
+└── asset-cache.json        # 업로드 후 생성됨
+```
+
+## 업로드 프로세스
+
+1. 자산 검색: 명령이 자동으로 `assets/` 디렉토리를 스캔하여 이미지, 메타데이터 및 컬렉션 파일을 식별합니다.
+2. 검증 단계: 파일의 무결성을 확인합니다. 예를 들어 모든 이미지 파일에 일치하는 메타데이터 파일이 있고 메타데이터가 유효한 json인지 확인합니다.
+3. 캐시 확인: 이미 업로드된 파일을 식별하기 위해 `asset-cache.json` 파일을 검증합니다.
+4. 업로드: 실제 업로드가 수행됩니다.
+5. 캐시 생성: `asset-cache.json` 파일이 생성됩니다
+
+## 생성된 자산 캐시
+
+`asset-cache.json` 파일에는 업로드된 자산에 대한 자세한 정보가 포함되어 있습니다. 수동으로 검사하고 사용하는 것은 고급 사용자에게만 권장됩니다.
+
+예제:
+
+```json
+{
+  "candyMachineId": null,
+  "collection": null,
+  "assetItems": {
+    "0": {
+      "name": "Asset #0",
+      "image": "0.png",
+      "imageUri": "https://gateway.irys.xyz/ABC123...",
+      "imageType": "image/png",
+      "json": "0.json",
+      "jsonUri": "https://gateway.irys.xyz/DEF456...",
+      "loaded": false
+    },
+    "1": {
+      "name": "Asset #1",
+      "image": "1.png",
+      "imageUri": "https://gateway.irys.xyz/GHI789...",
+      "imageType": "image/png",
+      "json": "1.json",
+      "jsonUri": "https://gateway.irys.xyz/JKL012...",
+      "loaded": false
+    }
+  }
+}
+```
+
+## 관련 명령어
+
+- [`mplx cm create`](/ko/cli/cm/create) - 캔디 머신 생성 (자동으로 업로드 가능)
+- [`mplx cm validate`](/ko/cli/cm/validate) - 업로드된 자산 검증
+- [`mplx cm insert`](/ko/cli/cm/insert) - 업로드된 자산을 캔디 머신에 삽입
+- [`mplx cm fetch`](/ko/cli/cm/fetch) - 캔디 머신 및 자산 정보 보기
+
+## 다음 단계
+
+1. 모든 것이 올바르게 업로드되었는지 확인하기 위해 **[업로드 검증](/ko/cli/cm/validate)**
+2. 업로드된 자산을 사용하여 **[캔디 머신 생성](/ko/cli/cm/create)**
+3. 캔디 머신에 자산을 로드하기 위해 **[아이템 삽입](/ko/cli/cm/insert)**
+4. 모든 것이 작동하는지 확인하기 위해 **[설정 모니터링](/ko/cli/cm/fetch)**

src/pages/ko/cli/cm/validate.md

@@ -0,0 +1,36 @@
+---
+title: "캐시 검증"
+metaTitle: "MPLX CLI - 캐시 검증 명령어"
+description: "MPLX CLI를 사용하여 캔디 머신 자산 캐시 및 업로드를 검증합니다. 포괄적인 검증, 오류 감지 및 캐시 무결성 확인."
+---
+
+`mplx cm validate` 명령어는 모든 자산이 올바르게 업로드되고 액세스 가능한지 확인하기 위해 자산 캐시 파일을 검증합니다. 포괄적인 검증, 오류 감지 및 캐시 무결성 확인을 제공합니다.
+
+## 사용법
+
+```bash
+# 현재 캔디 머신 디렉토리에서 캐시 검증
+mplx cm validate
+
+# 특정 캐시 파일 검증
+mplx cm validate <path_to_asset_cache>
+
+# 온체인 삽입 검증 (캔디 머신이 존재해야 함)
+mplx cm validate --onchain
+```
+
+검증 명령이 문제를 표시하면 오류에 따라 자산 문제를 확인하거나 upload 또는 insert 명령을 실행하는 것이 좋습니다.
+
+## 관련 명령어
+
+- [`mplx cm upload`](/ko/cli/cm/upload) - 자산 업로드 및 캐시 생성
+- [`mplx cm create`](/ko/cli/cm/create) - 캔디 머신 생성
+- [`mplx cm insert`](/ko/cli/cm/insert) - 검증된 자산 삽입
+- [`mplx cm fetch`](/ko/cli/cm/fetch) - 캔디 머신 상태 확인
+
+## 다음 단계
+
+1. 검증 중 발견된 **[문제 수정](/ko/cli/cm/upload)**
+2. 캐시가 유효한 경우 **[캔디 머신 생성](/ko/cli/cm/create)**
+3. 자산을 로드하기 위해 **[아이템 삽입](/ko/cli/cm/insert)**
+4. 성공을 확인하기 위해 **[배포 모니터링](/ko/cli/cm/fetch)**

src/pages/ko/cli/cm/withdraw.md

@@ -0,0 +1,53 @@
+---
+title: "인출"
+metaTitle: "MPLX CLI - 캔디 머신 인출"
+description: "MPLX CLI를 사용하여 MPL Core 캔디 머신을 인출하고 삭제하여 렌트 SOL을 회수합니다."
+---
+
+`mplx cm withdraw` 명령어는 캔디 머신을 인출하고 삭제하여 남은 SOL 잔액을 회수하고 온체인 계정을 정리합니다. 이 작업은 되돌릴 수 없으며 캔디 머신이 더 이상 필요하지 않을 때 사용해야 합니다. 이미 민팅된 NFT는 영향을 받지 않습니다.
+
+{% callout title="되돌릴 수 없음" type="warning" %}
+이 명령은 되돌릴 수 없습니다. 실행하면 캔디 머신이 파괴되고 다시 만들 수 없습니다.
+{% /callout %}
+
+## 사용법
+
+```bash
+# 현재 디렉토리에서 캔디 머신 인출
+mplx cm withdraw
+
+# 주소로 특정 캔디 머신 인출
+mplx cm withdraw --address <candy_machine_address>
+
+```
+
+사용할 수 있는 선택적 플래그:
+
+- `--address`: 캔디 머신 주소 직접 지정
+- `--force`: *위험* 확인 프롬프트 건너뛰기 (극도로 주의해서 사용)
+
+### ⚠️ 되돌릴 수 없는 작업
+
+- **영구 삭제**: 캔디 머신 계정이 영구적으로 삭제됩니다
+- **복구 불가**: 되돌리거나 복원할 수 없습니다
+- **데이터 손실**: 모든 온체인 구성 및 상태가 손실됩니다
+- **민팅된 NFT**: 기존 민팅된 NFT는 영향을 받지 않습니다
+
+### 🛡️ 모범 사례
+
+**계획:**
+
+- 인출 시기를 신중하게 계획
+- 팀원과 조율
+
+**실행:**
+
+- 모든 매개변수 재확인
+- 연습을 위해 데브넷 사용
+
+## 관련 명령어
+
+- [`mplx cm fetch`](/ko/cli/cm/fetch) - 인출 전 상태 확인
+- [`mplx cm create`](/ko/cli/cm/create) - 새 캔디 머신 생성
+- [`mplx cm validate`](/ko/cli/cm/validate) - 인출 전 검증
+- [`solana balance`](https://docs.solana.com/cli) - 회수된 잔액 확인