Перейти к основному содержимому

Обзор Blueprint

Резюме: На предыдущих этапах мы установили и настроили все инструменты, необходимые для разработки смарт-контрактов в TON, и создали наш первый шаблон проекта.

к сведению

Мы рекомендуем установить расширение Tact для VS Code. Оно содержит подсветку синтаксиса, подсказки об ошибках, а также делает опыт разработки более гладким.

Прежде чем приступить к разработке смарт-контракта, давайте кратко опишем структуру проекта и объясним, как использовать Blueprint.

Структура проекта

warning

Если вы выбрали не те названия, которые были предложены в предыдущих шагах, то названия файлов с исходным кодом и некоторые сущности в коде могут отличаться.

Project structure
Example/
├── contracts/ # Folder containing smart contracts code
│ ├── hello_world.tact # Main contract file
├── scripts/ # Deployment and on-chain interaction scripts
│ ├── deployHelloWorld.ts # Script to deploy the contract
│ └── incrementHelloWorld.ts # Script to interact with the contract
├── tests/ # Test folder for local contract testing
│ └── HelloWorld.spec.ts # Test specifications for the contract
└── wrappers/ # TypeScript wrappers for contract interaction
├── HelloWorld.ts # Wrapper class for smart contract
└── HelloWorld.compile.ts # Script for contract compilation

/contracts

Эта директория содержит исходный код ваших смарт-контрактов, написанных на одном из языков программирования, доступных для этого в TON.

/scripts

Папка scripts содержит файлы на языке TypeScript, которые помогут вам разворачивать ваши смарт-контракты в блокчейне и взаимодействовать с ними, используя ранее реализованные обёртки.

/tests

Этот каталог содержит тестовые файлы для ваших смарт-контрактов. Тестировать контракты прямо в сети TON — не лучший вариант, так как развёртывание требует некоторого времени и может приводить к потере средств. Эта тестовая площадка позволяет исполнять несколько смарт-контрактов и даже отправлять сообщения между ними у вас в "локальной сети". Тесты крайне важны, чтобы убедиться, чтобы ваши смарт-контракты действуют ожидаемым образом, до развёртывания их в сеть.

/wrappers

Чтобы взаимодействовать с вашим смарт-контрактом извне блокчейна, вам потребуется сериализовать и десериализовать отправленные ему сообщения. Обёртки — это классы, разработанные, чтобы «зеркалировать» реализацию вашего смарт-контракта, делая его функциональность простой в использовании.

Процесс разработки

Почти любая разработка смарт-контрактов состоит из пяти простых шагов:

  1. Отредактируйте код смарт-контракта в папке /contracts и соберите его, запустив скрипт сборки:
npx blueprint build
  1. Обновите обёртку контракта в папке /wrappers, чтобы соответствовать изменениям в контракте.

  2. Обновите тесты в папке /tests, чтобы проверить корректность новой функциональности, и запустите тестовый скрипт:

npx blueprint test
  1. Повторите шаги 1-3, пока не достигнете желаемого результата.

  2. Обновите сценарий развёртывания в папке /scripts и запустите его с помощью этой команды:

npx blueprint run
подсказка

Все примеры в этом руководстве следуют последовательности этих 1-3 шагов и приводят соответствующие образцы кода. А шаг 5, процесс развёртывания, освещён в последней части гайда: Развёртывание в сеть.

Кроме того, вы всегда можете сгенерировать такую же структуру для другого смарт-контракта (если, например, хотите создать несколько контрактов, взаимодействующих друг с другом), используя следующую команду:

npx blueprint create PascalCase # Don't forget to name the contract in PascalCase

Следующий шаг

Теперь всё готово: пришло время начать писать смарт-контракты. Мы начнём с базовых задач: хранения данных и get-методов.

Хранение данных и get-методы

Was this article useful?