Foundry с 0. Часть 19
Сегодня мы поговорим о деплое контрактов в локальную, тестовые и обычные блокчейн сети нашего контракта, а также о его верификации, публичных сервисах нод и работе с приватными ключами.
Изначально я планировал разделить это все на несколько постов, но решил, что для большей наглядности будет лучше объединить все в одном. Практиковаться будем с нашим контрактом Counter из предыдущих постов.
Для начала поднимем тему rpc-url и приватных ключей, а точнее, работу с ними в написании тестов.
В постах про cast команды нам нужно было часто указывать специальную ссылку для подключения к блокчейн узлам, чтобы можно было получать необходимую информацию. Мы писали что-то типа:
cast chain-id --rpc-url link
где вместо link нужно было подставить https://blablabla... Или же создавали кошелек на основе приватного ключа:
cast wallet address --private-key PRIVATE_KEY
где вместо PRIVATE_KEY указывали настоящий приватный ключ.
Я точно не могу сказать и рассказать почему, но это считается не безопасным способом, т.е. не рекомендуется указывать свои конфиденциальные данные в терминале. Возможно, потому что эту информацию могут получить хакеры через вирусы, или потому что VScode отправляет массу информации в Microsoft... В общем, не делайте так.
Для вашего личного тестирования смарт контрактов, более безопасным будет использование переменных среды. Как это сделать?
Нам нужно будет в корне нашего проекта создать отдельный файл ".env". Обратите внимание, что точка в начале названия обязательна.
Уже в этом файле мы делаем запись:
RPC_LINK=https://mainnet.infura.io/v3/...
PRIVATE_KEY=ndsf349jf9...
и другие по необходимости.
Затем в терминале выполняем команду:
source .env
К слову сказать, что тут вам потребуется установленный python на свой компьютер.
Также, возможно, у вас будут возникать ошибки, типа "command not found" или какие-то вроде них. Это означает, что переменные среды не применяются для проекта. В моем случае помогли:
1. Установка pytnon
2. Переход на bash терминал с PowerShell
3. Написание переменных, знака равенства и значения вместе
4. Возможно, вам также потребуется добавить слово export перед переменной
После этого необходимо проверить, чтобы запись .env была в файле .gitignore во избежание случайной загрузки конфиденциальных данный на сервера GitHub в открытый доступ. Если записи нет, то просто добавьте ее вручную.
Теперь команды cast можно выполнять так:
cast chain-id --rpc-url $RPC_LINK
Обратите внимание на знак $ перед RPC_LINK!
P.S. В Части 2 я писал, где можно получить rpc-url бесплатно.
Так вы сможете скрыть конфиденциальную информацию с команд терминала.
Есть еще более безопасный вариант использования информации о приватных ключах в командах терминала, но он задействует keystore json файл с паролем. Это чуть более продвинутый способ и, если захотите, то напишу отдельный пост на эту тему. А пока идем дальше.
Итак, на данный момент у нас должна быть rpc ссылка от одного из сервисов нод блокчейна, и мы должны понимать, что такое переменные среды. Все это нужно для того, чтобы научиться делать деплой контрактов.
Сам деплой можно делать в локальный блокчейн Anvil, в тестовые сети, типа Goerly, или в основные сети. Начнем с первого.
Для запуска Anvil достаточно выполнить команду в терминале:
anvil
При этом нам предоставят 10 аккаунтов для проведения тестов вместе с их приватными ключами, мнемоник фразу, chain id и rpc ссылку, которая выглядит как: Listening on 127.0.0.1:8...
Более того, блокчейн установит для вас base fee, gas limit и timestamp, которыми вы можете управлять в случае необходимости.
В целом, деплой контрактов в различные сети ничем особым не отличается, происходит это с помощью специального скрипта, который тоже пишется на Solidity.
Заходим в папку scripts и открываем / создаем новый файл, назовем его Counter.s.sol.
Обратите внимание, что по принципу названия файлов для тестов, где окончание t.sol обязательно, в данном случае для скриптов также обязательно окончание s.sol.
В этом файле создаем следующий скрипт:
Сегодня мы поговорим о деплое контрактов в локальную, тестовые и обычные блокчейн сети нашего контракта, а также о его верификации, публичных сервисах нод и работе с приватными ключами.
Изначально я планировал разделить это все на несколько постов, но решил, что для большей наглядности будет лучше объединить все в одном. Практиковаться будем с нашим контрактом Counter из предыдущих постов.
Для начала поднимем тему rpc-url и приватных ключей, а точнее, работу с ними в написании тестов.
В постах про cast команды нам нужно было часто указывать специальную ссылку для подключения к блокчейн узлам, чтобы можно было получать необходимую информацию. Мы писали что-то типа:
cast chain-id --rpc-url link
где вместо link нужно было подставить https://blablabla... Или же создавали кошелек на основе приватного ключа:
cast wallet address --private-key PRIVATE_KEY
где вместо PRIVATE_KEY указывали настоящий приватный ключ.
Я точно не могу сказать и рассказать почему, но это считается не безопасным способом, т.е. не рекомендуется указывать свои конфиденциальные данные в терминале. Возможно, потому что эту информацию могут получить хакеры через вирусы, или потому что VScode отправляет массу информации в Microsoft... В общем, не делайте так.
Для вашего личного тестирования смарт контрактов, более безопасным будет использование переменных среды. Как это сделать?
Нам нужно будет в корне нашего проекта создать отдельный файл ".env". Обратите внимание, что точка в начале названия обязательна.
Уже в этом файле мы делаем запись:
RPC_LINK=https://mainnet.infura.io/v3/...
PRIVATE_KEY=ndsf349jf9...
и другие по необходимости.
Затем в терминале выполняем команду:
source .env
К слову сказать, что тут вам потребуется установленный python на свой компьютер.
Также, возможно, у вас будут возникать ошибки, типа "command not found" или какие-то вроде них. Это означает, что переменные среды не применяются для проекта. В моем случае помогли:
1. Установка pytnon
2. Переход на bash терминал с PowerShell
3. Написание переменных, знака равенства и значения вместе
4. Возможно, вам также потребуется добавить слово export перед переменной
После этого необходимо проверить, чтобы запись .env была в файле .gitignore во избежание случайной загрузки конфиденциальных данный на сервера GitHub в открытый доступ. Если записи нет, то просто добавьте ее вручную.
Теперь команды cast можно выполнять так:
cast chain-id --rpc-url $RPC_LINK
Обратите внимание на знак $ перед RPC_LINK!
P.S. В Части 2 я писал, где можно получить rpc-url бесплатно.
Так вы сможете скрыть конфиденциальную информацию с команд терминала.
Есть еще более безопасный вариант использования информации о приватных ключах в командах терминала, но он задействует keystore json файл с паролем. Это чуть более продвинутый способ и, если захотите, то напишу отдельный пост на эту тему. А пока идем дальше.
Итак, на данный момент у нас должна быть rpc ссылка от одного из сервисов нод блокчейна, и мы должны понимать, что такое переменные среды. Все это нужно для того, чтобы научиться делать деплой контрактов.
Сам деплой можно делать в локальный блокчейн Anvil, в тестовые сети, типа Goerly, или в основные сети. Начнем с первого.
Для запуска Anvil достаточно выполнить команду в терминале:
anvil
При этом нам предоставят 10 аккаунтов для проведения тестов вместе с их приватными ключами, мнемоник фразу, chain id и rpc ссылку, которая выглядит как: Listening on 127.0.0.1:8...
Более того, блокчейн установит для вас base fee, gas limit и timestamp, которыми вы можете управлять в случае необходимости.
В целом, деплой контрактов в различные сети ничем особым не отличается, происходит это с помощью специального скрипта, который тоже пишется на Solidity.
Заходим в папку scripts и открываем / создаем новый файл, назовем его Counter.s.sol.
Обратите внимание, что по принципу названия файлов для тестов, где окончание t.sol обязательно, в данном случае для скриптов также обязательно окончание s.sol.
В этом файле создаем следующий скрипт: