Настройка Среды Разработки

Добро пожаловать в экосистему разработки Aptos! Это руководство поможет вам настроить полную среду разработки для создания dApps на блокчейне Aptos.

К концу этого руководства у вас будет:

• Установлена и настроена Aptos CLI
• Настроена среда разработки для выбранного SDK
• Создан и профинансирован тестовый аккаунт
• Проверена настройка путем выполнения первой транзакции

Aptos CLI - это ваш главный инструмент для взаимодействия с блокчейном Aptos. Он позволяет управлять аккаунтами, публиковать контракты и выполнять транзакции.

brew install aptos

wget https://github.com/aptos-labs/aptos-core/releases/download/aptos-cli-v4.2.0/aptos-cli-4.2.0-MacOSX-x86_64.zip
unzip aptos-cli-4.2.0-MacOSX-x86_64.zip
chmod +x aptos
mv aptos /usr/local/bin/

wget https://github.com/aptos-labs/aptos-core/releases/download/aptos-cli-v4.2.0/aptos-cli-4.2.0-Ubuntu-x86_64.zip
unzip aptos-cli-4.2.0-Ubuntu-x86_64.zip
chmod +x aptos
sudo mv aptos /usr/local/bin/

cargo install --git https://github.com/aptos-labs/aptos-core.git aptos --branch mainnet

# Используйте PowerShell в качестве администратора
Invoke-WebRequest -Uri "https://github.com/aptos-labs/aptos-core/releases/download/aptos-cli-v4.2.0/aptos-cli-4.2.0-Windows-x86_64.zip" -OutFile "aptos-cli.zip"
Expand-Archive -Path "aptos-cli.zip" -DestinationPath "C:\aptos"
# Добавьте C:\aptos в переменную среды PATH

cargo install --git https://github.com/aptos-labs/aptos-core.git aptos --branch mainnet

Проверьте, что CLI установлен правильно:

aptos --version

Вы должны увидеть что-то вроде:

aptos 4.2.0

Выберите SDK в зависимости от вашего предпочитаемого языка программирования:

npm install @aptos-labs/ts-sdk
# или
yarn add @aptos-labs/ts-sdk
# или
pnpm add @aptos-labs/ts-sdk

mkdir my-aptos-dapp
cd my-aptos-dapp
npm init -y
npm install @aptos-labs/ts-sdk typescript @types/node
npx tsc --init

import { Aptos, AptosConfig, Network } from "@aptos-labs/ts-sdk";

// Подключение к devnet для разработки
const config = new AptosConfig({ network: Network.DEVNET });
const aptos = new Aptos(config);

async function main() {
  console.log("Подключено к Aptos devnet");

  // Получение информации о сети
  const chainId = await aptos.getChainId();
  console.log(`Chain ID: ${chainId}`);
}

main().catch(console.error);

npx tsx src/index.ts

pip install aptos-sdk

mkdir my-aptos-dapp
cd my-aptos-dapp
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install aptos-sdk

import asyncio
from aptos_sdk.async_client import RestClient

# Подключение к devnet для разработки
NODE_URL = "https://fullnode.devnet.aptoslabs.com/v1"

async def main():
    rest_client = RestClient(NODE_URL)

    print("Подключено к Aptos devnet")

    # Получение информации о сети
    chain_id = await rest_client.chain_id()
    print(f"Chain ID: {chain_id}")

if __name__ == "__main__":
    asyncio.run(main())

python main.py

[dependencies]
aptos-sdk = "0.1"
tokio = { version = "1.0", features = ["full"] }

cargo new my-aptos-dapp
cd my-aptos-dapp

use aptos_sdk::rest_client::RestClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Подключение к devnet для разработки
    let rest_client = RestClient::new("https://fullnode.devnet.aptoslabs.com".parse()?);

    println!("Подключено к Aptos devnet");

    // Получение информации о сети
    let chain_id = rest_client.get_chain_id().await?;
    println!("Chain ID: {}", chain_id);

    Ok(())
}

cargo run

go mod init my-aptos-dapp
go get github.com/aptos-labs/aptos-go-sdk

package main

import (
    "fmt"
    "log"

    "github.com/aptos-labs/aptos-go-sdk/client"
)

func main() {
    // Подключение к devnet для разработки
    nodeURL := "https://fullnode.devnet.aptoslabs.com"
    aptosClient := client.NewRestClient(nodeURL)

    fmt.Println("Подключено к Aptos devnet")

    // Получение информации о сети
    chainID, err := aptosClient.GetChainID()
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Chain ID: %d\n", chainID)
}

go run main.go

Теперь создадим тестовый аккаунт для разработки:

1. Инициализация нового аккаунта

   aptos init

   Вам будет предложено:

   • Сеть: Выберите devnet для разработки
   • Приватный ключ: Нажмите Enter для генерации нового ключа
   • CLI создаст новый аккаунт и сохранит конфигурацию

2. Проверьте ваш новый аккаунт

   aptos account list

   Это покажет адрес вашего аккаунта.

3. Профинансируйте ваш аккаунт

   aptos account fund-with-faucet --account default

   Это добавит тестовые APT на ваш аккаунт для покрытия комиссий за транзакции.

4. Проверьте баланс

   aptos account balance

   Вы должны увидеть что-то вроде:

   100000000 APT

Давайте выполним простую транзакцию, чтобы убедиться, что все работает:

aptos account transfer --account 0x1 --amount 100

Эта команда переведет 100 Octas (наименьшая единица APT) на адрес 0x1. Если транзакция прошла успешно, ваша среда настроена правильно!

1. Установите VS Code

2. Установите полезные расширения:

   • Move - Синтаксис и поддержка языка Move
   • REST Client - Для тестирования API
   • GitLens - Расширенная поддержка Git

3. Настройте пользовательские настройки (settings.json):

   {
     "move.languageServer.enable": true,
     "editor.formatOnSave": true,
     "editor.codeActionsOnSave": {
       "source.fixAll": true
     }
   }

• Документация Aptos - Полная документация
• SDK TypeScript - TypeScript SDK справочник
• SDK Python - Python SDK справочник
• Move Book - Изучение языка Move
• Discord сообщество - Поддержка разработчиков
• GitHub - Исходный код и примеры

CLI не найдена

command not found: aptos

• Убедитесь, что CLI добавлена в ваш PATH
• Перезапустите терминал после установки
• Проверьте права на выполнение файла (chmod +x aptos)

Ошибки сети

Failed to connect to network

• Проверьте подключение к интернету
• Убедитесь, что используете правильные URL конечных точек
• Попробуйте переключиться на другую сеть (devnet/testnet)

Проблемы с финансированием аккаунта

Faucet request failed

• Убедитесь, что используете devnet или testnet (mainnet не имеет faucet)
• Подождите несколько минут и повторите попытку
• Проверьте, что адрес аккаунта корректен

Ошибки SDK

Module not found / Import errors

• Убедитесь, что установлены все зависимости
• Проверьте версии пакетов
• Очистите кэш пакетного менеджера и переустановите

Если вы столкнулись с проблемами:

1. Проверьте FAQ для распространенных вопросов
2. Найдите похожие проблемы в GitHub Issues
3. Присоединитесь к Discord сообществу для поддержки в реальном времени
4. Создайте новую issue с подробным описанием проблемы

Теперь, когда ваша среда разработки настроена, вы готовы:

1. Изучить Move - Начать с Move Book
2. Создать первую транзакцию - Руководство по первой транзакции
3. Написать смарт-контракт - Первый модуль Move
4. Создать dApp - Сквозное руководство по dApp

Добро пожаловать в экосистему Aptos! 🚀