the-dev-z
diff --git a/‎README.md‎
Lines changed: 85 additions & 10 deletions b/‎README.md‎
Lines changed: 85 additions & 10 deletions
diff --git a/‎docs/i18n/ja/README.md‎
Lines changed: 84 additions & 9 deletions b/‎docs/i18n/ja/README.md‎
Lines changed: 84 additions & 9 deletions
diff --git a/‎docs/i18n/ru/README.md‎
Lines changed: 85 additions & 10 deletions b/‎docs/i18n/ru/README.md‎
Lines changed: 85 additions & 10 deletions
@@ -532,18 +532,93 @@ Open your browser and visit: **🌐 http://localhost:3000**
 
 ---
 
-#### 🔷 Alternative: Using Hyperliquid Exchange
+#### 🔷 Using Hyperliquid Exchange
 
-**NOFX also supports Hyperliquid** - a decentralized perpetual futures exchange. To use Hyperliquid instead of Binance:
+**NOFX supports Hyperliquid** - a high-performance decentralized perpetual futures exchange!
 
-**Step 1**: Get your Ethereum private key (for Hyperliquid authentication)
+**Why Choose Hyperliquid?**
+- 🚀 **High Performance**: Lightning-fast execution on L1 blockchain
+- 💰 **Low Fees**: Competitive maker/taker fees
+- 🔐 **Non-Custodial**: Your keys, your coins
+- 🌐 **No KYC**: Anonymous trading
+- 💎 **Deep Liquidity**: Institutional-grade order book
 
-1. Open **MetaMask** (or any Ethereum wallet)
-2. Export your private key
-3. **Remove the `0x` prefix** from the key
-4. Fund your wallet on [Hyperliquid](https://hyperliquid.xyz)
+---
+
+### 📝 Registration & Setup Guide
+
+**Step 1: Register Hyperliquid Account**
+
+1. **Visit Hyperliquid with Referral Link** (get benefits!):
+
+   **🎁 [Register Hyperliquid - Join AITRADING](https://app.hyperliquid.xyz/join/AITRADING)**
+
+2. **Connect Your Wallet**:
+   - Click "Connect Wallet" on the top right
+   - Choose MetaMask, WalletConnect, or other Web3 wallets
+   - Approve the connection
+
+3. **Enable Trading**:
+   - First connection will prompt you to sign a message
+   - This authorizes your wallet for trading (no gas fees)
+   - You'll see your wallet address displayed
+
+**Step 2: Fund Your Wallet**
+
+1. **Bridge Assets to Arbitrum**:
+   - Hyperliquid runs on Arbitrum L2
+   - Bridge USDC from Ethereum mainnet or other chains
+   - Or directly withdraw USDC from exchanges to Arbitrum
+
+2. **Deposit to Hyperliquid**:
+   - Click "Deposit" on Hyperliquid interface
+   - Select USDC amount to deposit
+   - Confirm the transaction (small gas fee on Arbitrum)
+   - Funds appear in your Hyperliquid account within seconds
+
+**Step 3: Set Up Agent Wallet (Recommended)**
+
+Hyperliquid supports **Agent Wallets** - secure sub-wallets specifically for trading automation!
+
+⚠️ **Why Use Agent Wallet:**
+- ✅ **More Secure**: Never expose your main wallet private key
+- ✅ **Limited Access**: Agent only has trading permissions
+- ✅ **Revocable**: Can be disabled anytime from Hyperliquid interface
+- ✅ **Separate Funds**: Keep main holdings safe
+
+**How to Create Agent Wallet:**
+
+1. **Log in to Hyperliquid** using your main wallet
+   - Visit [https://app.hyperliquid.xyz](https://app.hyperliquid.xyz)
+   - Connect with the wallet you registered (from referral link)
+
+2. **Navigate to Agent Settings**:
+   - Click on your wallet address (top right)
+   - Go to "Settings" → "API & Agents"
+   - Or visit: [https://app.hyperliquid.xyz/agents](https://app.hyperliquid.xyz/agents)
+
+3. **Create New Agent**:
+   - Click "Create Agent" or "Add Agent"
+   - System will generate a new agent wallet automatically
+   - **Save the agent wallet address** (starts with `0x`)
+   - **Save the agent private key** (shown only once!)
+
+4. **Agent Wallet Details**:
+   - Main Wallet: Your connected wallet (holds funds)
+   - Agent Wallet: The sub-wallet for trading (NOFX will use this)
+   - Private Key: Only needed for NOFX configuration
+
+5. **Fund Your Agent** (Optional):
+   - Transfer USDC from main wallet to agent wallet
+   - Or keep funds in main wallet (agent can trade from it)
+
+6. **Save Credentials for NOFX**:
+   - Main Wallet Address: `0xYourMainWalletAddress` (with `0x`)
+   - Agent Private Key: `YourAgentPrivateKeyWithout0x` (remove `0x` prefix)
+
+---
 
-**Step 2**: ~~Configure `config.json` for Hyperliquid~~ *Configure through web interface*
+~~Configure `config.json` for Hyperliquid~~ *Configure through web interface*
 
 ```json
 {
@@ -576,9 +651,9 @@ Open your browser and visit: **🌐 http://localhost:3000**
 
 ---
 
-#### 🔶 Alternative: Using Aster DEX Exchange
+#### 🔶 Using Aster DEX Exchange
 
-**NOFX also supports Aster DEX** - a Binance-compatible decentralized perpetual futures exchange!
+**NOFX supports Aster DEX** - a Binance-compatible decentralized perpetual futures exchange!
 
 **Why Choose Aster?**
 - 🎯 Binance-compatible API (easy migration)
 
@@ -485,18 +485,93 @@ cp config.json.example config.json
 
 ---
 
-#### 🔷 代替：Hyperliquid取引所の使用
+#### 🔷 Hyperliquid取引所の使用
 
-**NOFXはHyperliquidもサポート** - 分散型無期限先物取引所。Binanceの代わりにHyperliquidを使用するには：
+**NOFXはHyperliquidをサポート** - 高性能な分散型無期限先物取引所！
 
-**ステップ1**: Ethereum秘密鍵を取得（Hyperliquid認証用）
+**なぜHyperliquidを選ぶ？**
+- 🚀 **高性能**: L1ブロックチェーンでの超高速実行
+- 💰 **低手数料**: 競争力のあるメーカー/テイカー手数料
+- 🔐 **非カストディアル**: あなたの鍵、あなたのコイン
+- 🌐 **KYC不要**: 匿名取引
+- 💎 **豊富な流動性**: 機関投資家レベルのオーダーブック
 
-1. **MetaMask**（または任意のEthereumウォレット）を開く
-2. 秘密鍵をエクスポート
-3. キーから**`0x`プレフィックスを削除**
-4. [Hyperliquid](https://hyperliquid.xyz)でウォレットに資金を入金
+---
+
+### 📝 登録とセットアップガイド
+
+**ステップ1: Hyperliquidアカウントを登録**
+
+1. **紹介リンクでHyperliquidにアクセス**（特典を獲得！）：
+
+   **🎁 [Hyperliquid登録 - AITRADINGに参加](https://app.hyperliquid.xyz/join/AITRADING)**
+
+2. **ウォレットを接続**：
+   - 右上の「ウォレット接続」をクリック
+   - MetaMask、WalletConnect、または他のWeb3ウォレットを選択
+   - 接続を承認
+
+3. **取引を有効化**：
+   - 初回接続時にメッセージへの署名を求められます
+   - これによりウォレットでの取引が承認されます（ガス代不要）
+   - ウォレットアドレスが表示されます
+
+**ステップ2: ウォレットに資金を入金**
+
+1. **Arbitrumにアセットをブリッジ**：
+   - HyperliquidはArbitrum L2上で動作します
+   - Ethereumメインネットまたは他のチェーンからUSDCをブリッジ
+   - または取引所からArbitrumに直接USDCを出金
+
+2. **Hyperliquidに入金**：
+   - Hyperliquidインターフェースで「入金」をクリック
+   - 入金するUSDC金額を選択
+   - トランザクションを確認（Arbitrumでの少額のガス代）
+   - 数秒でHyperliquidアカウントに資金が表示されます
+
+**ステップ3: エージェントウォレットをセットアップ（推奨）**
+
+Hyperliquidは**エージェントウォレット**をサポート - 取引自動化専用の安全なサブウォレット！
+
+⚠️ **エージェントウォレットを使用する理由：**
+- ✅ **より安全**: メインウォレットの秘密鍵を公開する必要なし
+- ✅ **限定的なアクセス**: エージェントは取引権限のみ
+- ✅ **取り消し可能**: Hyperliquidインターフェースからいつでも無効化可能
+- ✅ **資金の分離**: メインの保有資産を安全に保つ
+
+**エージェントウォレットの作成方法：**
+
+1. **メインウォレットでHyperliquidにログイン**
+   - [https://app.hyperliquid.xyz](https://app.hyperliquid.xyz)にアクセス
+   - 登録したウォレットで接続（紹介リンクから）
+
+2. **エージェント設定に移動**：
+   - ウォレットアドレスをクリック（右上）
+   - 「設定」→「API & エージェント」に移動
+   - または：[https://app.hyperliquid.xyz/agents](https://app.hyperliquid.xyz/agents)にアクセス
+
+3. **新しいエージェントを作成**：
+   - 「エージェントを作成」または「エージェントを追加」をクリック
+   - システムが自動的に新しいエージェントウォレットを生成
+   - **エージェントウォレットアドレスを保存**（`0x`で始まる）
+   - **エージェント秘密鍵を保存**（一度だけ表示されます！）
+
+4. **エージェントウォレットの詳細**：
+   - メインウォレット: 接続したウォレット（資金を保有）
+   - エージェントウォレット: 取引用のサブウォレット（NOFXがこれを使用）
+   - 秘密鍵: NOFX設定にのみ必要
+
+5. **エージェントに資金を入金**（オプション）：
+   - メインウォレットからエージェントウォレットにUSDCを送金
+   - またはメインウォレットに資金を保持（エージェントはそこから取引可能）
+
+6. **NOFX用の認証情報を保存**：
+   - メインウォレットアドレス: `0xYourMainWalletAddress`（`0x`付き）
+   - エージェント秘密鍵: `YourAgentPrivateKeyWithout0x`（`0x`プレフィックスを削除）
+
+---
 
-**ステップ2**: Hyperliquid用に`config.json`を設定
+~~Hyperliquid用に`config.json`を設定~~ *Webインターフェースで設定*
 
 ```json
 {
@@ -529,7 +604,7 @@ cp config.json.example config.json
 
 ---
 
-#### 🔶 代替：Aster DEX取引所の使用
+#### 🔶 Aster DEX取引所の使用
 
 **NOFXはAster DEXもサポート** - Binance互換の分散型無期限先物取引所！
 
 
@@ -481,18 +481,93 @@ cp config.json.example config.json
 
 ---
 
-#### 🔷 Альтернатива: Использование биржи Hyperliquid
+#### 🔷 Использование биржи Hyperliquid
 
-**NOFX также поддерживает Hyperliquid** - децентрализованную биржу бессрочных фьючерсов. Чтобы использовать Hyperliquid вместо Binance:
+**NOFX поддерживает Hyperliquid** - высокопроизводительную децентрализованную биржу бессрочных фьючерсов!
 
-**Шаг 1**: Получите приватный ключ Ethereum (для аутентификации Hyperliquid)
+**Почему выбрать Hyperliquid?**
+- 🚀 **Высокая производительность**: Молниеносное исполнение на L1 блокчейне
+- 💰 **Низкие комиссии**: Конкурентные комиссии мейкер/тейкер
+- 🔐 **Без хранения**: Ваши ключи, ваши монеты
+- 🌐 **Без KYC**: Анонимная торговля
+- 💎 **Глубокая ликвидность**: Книга ордеров институционального уровня
 
-1. Откройте **MetaMask** (или любой Ethereum кошелек)
-2. Экспортируйте приватный ключ
-3. **Удалите префикс `0x`** из ключа
-4. Пополните кошелек на [Hyperliquid](https://hyperliquid.xyz)
+---
+
+### 📝 Руководство по регистрации и настройке
+
+**Шаг 1: Регистрация аккаунта Hyperliquid**
+
+1. **Посетите Hyperliquid по реферальной ссылке** (получите преимущества!):
+
+   **🎁 [Зарегистрироваться на Hyperliquid - Присоединиться AITRADING](https://app.hyperliquid.xyz/join/AITRADING)**
+
+2. **Подключите кошелек**:
+   - Нажмите "Connect Wallet" в правом верхнем углу
+   - Выберите MetaMask, WalletConnect или другие Web3 кошельки
+   - Подтвердите подключение
+
+3. **Включите торговлю**:
+   - При первом подключении появится запрос на подпись сообщения
+   - Это авторизует ваш кошелек для торговли (без комиссий за газ)
+   - Вы увидите отображенный адрес кошелька
+
+**Шаг 2: Пополнение кошелька**
+
+1. **Мост активов в Arbitrum**:
+   - Hyperliquid работает на Arbitrum L2
+   - Переведите USDC с Ethereum mainnet или других сетей
+   - Или напрямую выведите USDC с бирж на Arbitrum
+
+2. **Депозит в Hyperliquid**:
+   - Нажмите "Deposit" в интерфейсе Hyperliquid
+   - Выберите сумму USDC для депозита
+   - Подтвердите транзакцию (небольшая комиссия за газ на Arbitrum)
+   - Средства появятся на вашем аккаунте Hyperliquid в течение секунд
+
+**Шаг 3: Настройка Agent Wallet (Рекомендуется)**
+
+Hyperliquid поддерживает **Agent Wallets** - безопасные подкошельки специально для торговой автоматизации!
+
+⚠️ **Зачем использовать Agent Wallet:**
+- ✅ **Более безопасно**: Никогда не раскрывайте приватный ключ основного кошелька
+- ✅ **Ограниченный доступ**: У агента есть только торговые разрешения
+- ✅ **Отзывается**: Может быть отключен в любое время из интерфейса Hyperliquid
+- ✅ **Отдельные средства**: Держите основные активы в безопасности
+
+**Как создать Agent Wallet:**
+
+1. **Войдите в Hyperliquid** используя основной кошелек
+   - Посетите [https://app.hyperliquid.xyz](https://app.hyperliquid.xyz)
+   - Подключитесь с кошельком, который вы зарегистрировали (по реферальной ссылке)
+
+2. **Перейдите в настройки агента**:
+   - Нажмите на адрес кошелька (правый верхний угол)
+   - Перейдите в "Settings" → "API & Agents"
+   - Или посетите: [https://app.hyperliquid.xyz/agents](https://app.hyperliquid.xyz/agents)
+
+3. **Создайте нового агента**:
+   - Нажмите "Create Agent" или "Add Agent"
+   - Система автоматически сгенерирует новый кошелек агента
+   - **Сохраните адрес кошелька агента** (начинается с `0x`)
+   - **Сохраните приватный ключ агента** (показывается только один раз!)
+
+4. **Детали Agent Wallet**:
+   - Основной кошелек: Ваш подключенный кошелек (хранит средства)
+   - Кошелек агента: Подкошелек для торговли (NOFX будет использовать его)
+   - Приватный ключ: Нужен только для конфигурации NOFX
+
+5. **Пополните агента** (Опционально):
+   - Переведите USDC с основного кошелька на кошелек агента
+   - Или оставьте средства в основном кошельке (агент может торговать с него)
+
+6. **Сохраните учетные данные для NOFX**:
+   - Адрес основного кошелька: `0xYourMainWalletAddress` (с `0x`)
+   - Приватный ключ агента: `YourAgentPrivateKeyWithout0x` (удалите префикс `0x`)
+
+---
 
-**Шаг 2**: Настройте `config.json` для Hyperliquid
+~~Настройте `config.json` для Hyperliquid~~ *Настройте через веб-интерфейс*
 
 ```json
 {
@@ -525,9 +600,9 @@ cp config.json.example config.json
 
 ---
 
-#### 🔶 Альтернатива: Использование биржи Aster DEX
+#### 🔶 Использование биржи Aster DEX
 
-**NOFX также поддерживает Aster DEX** - децентрализованную биржу бессрочных фьючерсов, совместимую с Binance!
+**NOFX поддерживает Aster DEX** - децентрализованную биржу бессрочных фьючерсов, совместимую с Binance!
 
 **Почему выбрать Aster?**
 - 🎯 API совместимый с Binance (легкая миграция)