https://github.com/Nomzegh/web3py-cheatsheet

Web3 Cheatsheet - твой помощник в написании будущих скриптов для всех существующих EVM сетей.

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

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

Вот как раз для маленьких повторяемых фич и был создан этот репозиторий.

./payable-utilities: обычный трансфер, отмена транзакции, дисперс нативного токена, трансфер фулл баланса с приватников, транзакция типа eip1559, функции юнисвапа.

./nonpayable-utilities: декодинг транзакции, высчитывание всех газовых значений, генератор кастомных адресов, мониторинг пендинг транзакций, подпись сообщения.

./wallets: использование N к-ва приватных ключей с файла, генератор приватников в файл.

Теперь мы отдельно рассмотрим каждый файл и узнаем где он может пригодиться.

Payable Utilities - Платные инструменты

• cancel_transaction.py - отмена зависшей предыдущей транзакции. Возвращает хеш транзакции.

  С помощью этого кода можно отменить pending транзакцию. Зачастую, транзакция “зависает“ в блокчейне из-за слишком малого gasPrice. По сути, код делает обычный пустой трансфер с tx[“value”]: 0 самому себе, поставив тот же nonce (порядок транзакции), что и у зависшей транзакции, но с gasPrice уже повыше.
  
  Зачем: был поставлен слишком малый gasPrice, и отправка следующих транзакций - невозможна.

• native_transfer.py - пересыл нативного токена.

  Возвращает хеш транзакции. Самый обычный трансфер нативного токена от адреса A к адресу B. Тут ничего особенного.
  
  Зачем: это самый базовый трансфер, который пригодится нам везде.

• disperse_native.py - пересыл нативного токена на адреса с disperse_addresses.txt. Возвращает хеши каждой транзакции.
  
  Использует обычный трансфер нативного токена от одного адреса к нескольким. Для работы нужно создать disperse_addresses.txt и поместить туда все адреса на которые нужно разделить токены. Наотмену от native_transfer.py, этот код не ожидает результата транзакции, поэтому заранее отправит все транзакции с nonce повыше. К сожалению, этот способ дисперса довольно топорный, и для абузов лучше подойдет вывод с биржи, но он будет дороже.
  
  Зачем: нам нужно вывести деньги на мультиакки для дальнейших транзакций.

• transfer_all_native.py - пересыл полного баланса нативного токена всех приватных ключей из private_keys.txt на один адрес.
  
  Для работы нужно создать private_keys.txt и поместить туда приватные ключи, с которых мы хотим снять фулл баланс. Довольно часто может пригодится в случаях, когда после какого-то абуза остается много приватников с мелким балансом, а выводить вручную супер затратно по времени. (Вот останется на 100 адресах по $0.1-$1 в каком-то BNB, а если вывести полный баланс, то уже +$10-$100, что довольно приятно.)
  
  Зачем: остался баланс на “заброшенных” приватниках после очередного абуза

• eip1559_example.py - пример трансфер-транзакции типа eip-1559.
  
  Чем она отличается от транзакции типа Legacy? В Legacy мы устанавливаем комиссию через параметр gasPrice, и чем выше это значение - тем больше шанс что наша транзакция попадет в блок.В EIP-1559 у нас немного другие параметры: base fee (базовая комса которая сжигается)miner tip - “чаевые, взятка” для майнера. В коде мы вписываем два новых параметра вместо gasPrice: maxPriorityFeePerGas (вызываем через web.eth.max_priority_fee) и maxFeePerGas = base_fee + max_priority_fee. Этот тип транзакции пока самый актуальный, так что лучше использовать его вместо Legacy.
  
  Зачем: большинство DAPP использует именно этот тип транзакций, так что в абузах лучше использовать его, но Legacy транзы никто не отменял.

• uniswap_functions.py - **пример нескольких функций на всем известном Uniswap.
  **
  Для начала нужно установить библиотеку Uniswap через команду:

  pip install uniswap-python
  

  В файле есть 4 функции - две для того чтобы узнать точные ценовые значения, и две для свапов. Очень удобная библиотека для свапов где нужно минимум кода для работы.
  
  Зачем: мы можем интегрировать свапы/парсинг цен в код, если нужно иметь дело с DEX обменниками.

Non-Payable Utilities - Бесплатные Инструменты

• estimate_gas_values.py - пример как высчитывать следующие параметры: gas, gasPrice, baseFee, maxFeePerGas, maxPriorityFeePerGas
  
  Тут ничего сложного, просто функции которые возвращают каждое значение для Legacy и EIP-1559 транзакций. Так же, есть функция для вычисления всегда правильных значений tx[“gas”], чтобы никогда не столкнуться с ошибкой Out of gas.
  
  Зачем: без этих значений мы просто не сможем отправить ни одну транзакцию

• vanity_generator.py - генератор адресов с кастомным префиксом.
  
  Вот хотите вы себе крутой пацанский префикс адреса чтобы вас друзья уважали? Это не проблема.
  
  Дед инсайд? 0xdead
  Элитный криптоюзер? 0x1337
  Любитель кофе? 0xс0ffee
  Роняешь запад? 0xFACE
  …? 0xda7baeb
  Или же вы просто хотите блатные номера с 77777 в начале? 0x77777
  
  Все это можно сгенерировать с помощью этого кода, который еще и может работать через multiprocessing. Но имейте в виду, что чем длиннее кастом префикс вы хотите - тем дольше вы будете его генерировать. Так же, контроллируйте нагрузку процессора к-вом процессов. Доступные буквы A-F и цифры 0-9
  
  Зачем: пользы в этом мало, но генерируем, если хотим слегка кастомный адрес.

• sign_message.py - генератор подписи с помощью приватного ключа.
  
  Очень часто бывает, что для логина на сайт проекта, мы подписываем сообщение, и при этом не платим за газ. Так вот, это оно и есть. В большинстве случаев, мы вызываем уникальное сообщение через requests, подписываем его, и полученную сигнатуру вставляем уже в другой запрос.
  
  Зачем: многие проекты используют логин через подпись текстового сообщения. Сигнатуру мы отправляем на их API и получаем access_token для различных действий.

• web3_with_proxy.py - маленький пример использования прокси с web3py.
  
  Имея прокси в формате http://login:password@ip:port, мы можем создать некий слой соединения с помощью requests.session и начать делать наши транзакции. Можно сразу на месте проверить и работоспособность прокси, и подключились ли вы к web3.
  
  Зачем: мы можем использовать такой метод подключения прокси к веб3, если хотим работать с мультиакками.

• decode_transaction.py - расшифровка txData любой транзакции.
  
  Практически всегда критически важно знать что именно нужно вписывать в параметры функции контракта N.
  Ключевым элементом расшифровки txData и отправки нормальных транзакций, является ABI (интерфейс) целого контракта или одной функции.
  Как же действовать в следующих ситуациях?
  
  Контракт проекта полностью верифицирован на скане.
  В таком случае код не понадобится - вы просто смотрите введенные параметры транзакции сразу на скане, и используем ABI в нужных целях.
  
  Контракт проекта не верифицирован на скане.
  Тут не стоит расстраиваться, у вас еще есть шанс расшифровать свою транзакцию. Первым делом вбиваем в гугле первые символы (метод айди функции) нашей txData - к примеру 0xf340fa01. (Так же есть хороший инструмент - openchain.xyz)
  
  Если в поиске видны результаты с этой функцией, но на сканах других чейнов - просто заходим и копируем ABI этого контракта. Теперь вы можете коллить эту функцию в будущем, либо расшифровать свою транзакцию с помощью decode_transaction.py или через openchain.xyz.
  
  Контракт не верифицирован на скане, а хеш метод не гуглится.
  Вот тут уже можно грустить, так как теперь шанс найти ABI очень мал. Пробуем найти документацию или репозиторий проекта на Github, и в поиске вбиваем ключевые слова по типу contracts, ABI или банально адрес контракта.
  
  Если после всех шагов вы не смогли найти ABI, тогда можете попробовать изменить txData вручную, но тут уже надо быть осторожным, так как даже один лишний/неправильный символ зафейлит вашу транзакцию. Для ручного редактирования txData лучше воспользоваться ChatGPT 4.
  
  Зачем: имея ABI, нам важно знать что вписывалось в транзакцию в tx[“data”].

• pending_tx_monitoring.py - мониторинг pending транзакций.
  
  Бывают редкие случаи, когда нам нужно в какой-то определенный момент отправить транзакцию. Возьмем в пример прошлогодний проект - Friendtech. Суть была в том, чтобы как можно быстрее купить акцию популярного инфла.
  
  Зная адрес этого инфла, мы могли чекать пендинг транзакции, и как только мы увидели транзу с определенной txData от этого адреса - мы сразу же запускаем свою транзакцию на покупку.
  
  Так же, довольно часто мониторинг мемпула/пендинг транзакций используются в NFT и других сейлах. И для самой лучшей эффективности нам нужно поставить свою ноду на сервер, так как публичные RPC довольно слабые и там легко поймать рейт лимит.
  
  Зачем: используется если важен момент и скорость отправки транзакции

Wallets - кошельки

• multiple_keys_usage.py - небольшой пример использования нескольких приватных ключей с/без прокси.
  
  Для работы мы должны создать файлы private_keys.txt и proxies.txt (формат прокси следующий: login:password@ip:port). В случае, если вы хотите быстро спамить транзакциями с кучи кошельков - хорошим решением будет прикрутить asyncio, но об этом в другой раз.
  
  Зачем: нам нужно знать как использовать мультиакки для транзакций.

• simple_generator.py - самый обычный генератор новых кошельков.Запустив код, нам нужно указать количество желаемых кошельков, и в результате получим приватники и адреса, записанные в private_keys.txt и public_keys.txt соответственно.
  
  Зачем: нам нужно создать N количество кошельков для дальнейших использований.

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

https://t.me/roccrypto

Let’s get started!

zkSync Era

Deploy price: ~5$ in ETH Deploy difficulty: Classic method (code) - difficult. Thirdweb method - easy.

Classic method:

• Download Visual Studio Code from the official website: https://code.visualstudio.com/

• Choose English language and leave the checkboxes in their default state.

• After the installation, create a folder on your desktop named zksync

• Launch VSCode and open this folder

• Download & install Node.js from its official website. During the installation, leave the settings unchanged. Afterwards, restart your PC.

• Go back to VSCode, press CTRL + J to open the terminal.

• Insert the following command into the terminal:

npm init -y

• If you have such output, then everything is fine:

• Insert the following command and wait till the installation finishes

npm add -D typescript ts-node @types/node ethers@^5.7.2 zksync-web3@^0.14.3 @ethersproject/hash @ethersproject/web hardhat @matterlabs/hardhat-zksync-solc @matterlabs/hardhat-zksync-deploy

• Insert the following command which will install the OpenZeppelin contract library:

npm install @openzeppelin/contracts

• Press “+” and create the file hardhat.config.ts

• Insert the following code in hardhat.config.ts and press CTRL + S to save the file:

import "@matterlabs/hardhat-zksync-deploy";
import "@matterlabs/hardhat-zksync-solc";

module.exports = {
  zksolc: {
    version: "1.3.5",
    compilerSource: "binary",
    settings: {},
  },
  defaultNetwork: "zkSyncMainnet",

  networks: {
    zkSyncMainnet: {
      url: "https://zksync2-mainnet.zksync.io",
      ethNetwork: "mainnet",
      zksync: true,
    },
  },
  solidity: {
    version: "0.8.17",
  },
};

• Press on another “+” and create the contracts folder. Press on this folder and create the contract.sol file in it. Any parameters (those in “ “ quotes) you can customize according to your needs (full token name & ticker). Insert the following code:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.9;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";

contract Roccrypto is ERC20, Ownable {
    constructor() ERC20("roccrypto", "rocc") {
        _mint(msg.sender, 100 * 10 ** decimals());
    }

    function mint(address to, uint256 amount) public onlyOwner {
        _mint(to, amount);
    }
}

• Press CTRL + S to save your file

  Here we create a simple ERC-20 Token with the ticker rocc. Any other contracts can be used from OpenZeppelin documentation. However, in order to deploy them, we have to understand JavaScript/TypeScript programming languages. If you want to deploy some other contracts which are not mentioned in this guide, and you don’t know any of this programming languages - use ChatGPT. It will easily write the deploy.ts script for the contract you want to deploy.

  https://docs.openzeppelin.com/

• Compile the contract by inserting the following command:

npx hardhat compile

• If you have such output, then everything is fine:

• Open the zksync folder and create a new folder named deploy. In that file we must create the typescript file deploy.ts. Insert the following code and change the 0x123… addreess, to which the tokens will be minted. Press CTRL + S:

import fs from "fs";
import { utils, Wallet } from "zksync-web3";
import * as ethers from "ethers";
import { HardhatRuntimeEnvironment } from "hardhat/types";
import { Deployer } from "@matterlabs/hardhat-zksync-deploy";

const PRIV_KEY = fs.readFileSync(".secret").toString();

export default async function (hre: HardhatRuntimeEnvironment) {
  console.log(`Running deploy script for the Roccrypto contract`);

  const wallet = new Wallet(PRIV_KEY);

  const deployer = new Deployer(hre, wallet);
  const artifact = await deployer.loadArtifact("Roccrypto");

  const roccryptoContract = await deployer.deploy(artifact, []);
  console.log("constructor args:" + roccryptoContract.interface.encodeDeploy([]));

  const contractAddress = roccryptoContract.address;
  console.log(`${artifact.contractName} was deployed to ${contractAddress}`);

  // Mint some tokens to an address.
  const to = "0x123..."; // Адрес куда минтить токены.
  const amount = ethers.utils.parseEther("10"); // Сколько токенов нужно заминтить на этот адрес
  const mintHandle = await roccryptoContract.mint(to, amount);
  await mintHandle.wait();

  console.log(`Minted ${amount} tokens to ${to}`);
}

• Create a file named .secret in general zksync folder. We have to insert a private key from which the contract will be deployed. Keep in mind, that your address has to have a balance of ~5$ in ETH in zkSync Era mainnet. It is highly not recommended to hold a signifficant balance if you are unsure about your next actions. Please test first and then deploy on multiple accounts. I am not responsible for your funds.

• Finally, deploy the contract with the command:

npx hardhat deploy-zksync

We’ve successfully deployed our contract and minted some rocc tokens to our address.

Thirdweb method:

You can also deploy zkSync smart contracts by using Thirdweb. If you simply don’t like the classic method - you better use this one.

• Go to Thirdweb website and find the contract we need - Token

https://thirdweb.com/explore

• Press Deploy now

• Fill in the details of our token and make sure to select zkSync Era Mainnet.

• Press Deploy Now and sign the transaction.

• That’s it, we’ve successfully deployed our contract:

Base

Deploy price: FREE (Goerli ETH) Bridge: bridge.base.org/deposit Deploy difficulty: Easy

To begin with, use the bridge to obtain ETH to your wallet.

• Go to Chainlist, find Base Goerli Testnet, and connect your wallet to it. Make sure you switched the network afterwards.

• Go to OpenZeppelin Contracts Wizard.

• Choose ERC-20 token and fill in the parameters according to your preferences. Check the boxes for Mintable and Burnable

• Press Open in Remix

• Check the box for Auto compile

• Choose Injected Provider - Metamask and connect the wallet to the website.

• Press the Deploy button and confirm the transaction in Metamask

Now we have successfully deployed the contract on Base! However, to avoid repeating the same contracts every time, I suggest experimenting and deploying different ones.

Scroll

Deploy price: FREE (Goerli ETH) Bridge: scroll.io/bridge Deploy difficulty: Easy

To begin with, use the bridge to obtain ETH to your wallet.

• Go to Chainlist, find Scroll Alpha Testnet and connect your wallet to it. Make sure you switched the network afterwards.

• Go to OpenZeppelin Contracts Wizard.

• Choose ERC-20 token and fill in the parameters according to your preferences. Check the boxes for Mintable and Burnable

• Press Open in Remix

• Check the box for Auto compile

• Choose Injected Provider - Metamask and connect the wallet to the website.

• Press the Deploy button and confirm the transaction in Metamask

Congratulations! We have successfully deployed our final contract!

If this guide was useful, share it and follow my channels for more:

https://twitter.com/roccrypto_tw

https://t.me/roccrypto

Схема работы всего этого довольно проста: • Деплоим свой контракт, который работает в качестве ячейки хранения для баланса. Состоит он из трех функций: Deposit, Withdraw и getBalance.• Взаимодействуем с этим контрактом, отсылая ETH на адрес, вызывая функцию Deposit. • Когда мы прогнали нужное количество транзакций и объем Эфира, вызываем функцию Withdraw, забирая свой баланс обратно на кошелек.

Стратегии:

1. Фарм количества транзакций

2. Прогон объема в ETH (Transaction Value, как было в Arbitrum)

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

Цена одной транзакции: ~0.10$ - 0.15$ в ETH

Разбавляя активность кошельков деплоями своих контрактов, и взаимодействий с ними, мы показываем, что мы некие "билдеры" и хотим сделать свой вклад в развитие сети.

Уверяю, кастомные контракты - это тема, которую многие недооценивают. Даже самый дебильный, но личный, контракт будет лучше любой очередной транзакции на юзлессной dapp'ке.

Скрипт

Без скрипта я вас снова не оставил. Далее вы найдете пошаговый гайд + репозиторий с Github, где есть весь опенсорс код скрипта. С ним можно работать на нескольких кошельках, а время между депозитами и количество ETH - рандомное.

Контракт

В гайде мы будем использовать контракт, который задеплоил я. Сильно настаиваю на том, чтобы вы задеплоили свой, а не использовали мой, так как это свяжет ваши кошельки с другими. Если вы полный ноль в деплое - сначала прочитайте прошлую статью. После - прочитайте эту статью до конца, и в конце будет код точно такого же контракта. Но если вы не переживаете за связь кошельков, то пожалуйста:

0x7442E417C0B53d622d93F5D7BbD84eEd808F26C5. Я его верифицировал на zkSync скане, так что код полностью открыт.

Как было упомянуто раньше, в нем всего 3 простых функции:

• Deposit - депозит ETH на контракт

• Withdraw - вывод ETH с контракта

• getBalance - проверка баланса, безгазовая функция

Депозит

Чтобы задепозитить вручную, заходим на контракт, нажимаем на Write и подключаем кошелек кнопкой Connect MetaMask. Далее, deposit и вписуем к-во ETH, например 0.00001.

В окне транзакции от Metamask, мы должны вручную поменять лимит газа, установив его на 500000. В результате вам покажет цену около 0.20$, но на деле заплатите вы меньше (0.1$-0.15$), так как газ, который не был использован сетью, вернется через Gas Refund (компенсация газа). Подтверждаем транзакцию и мы успешно задепозитили ETH на контракт.

Вывод

Чтобы вывести, мы так же заходим в раздел Write. После нажатия на withdraw, мы вписываем в поле количество ETH, которое хотим вывести. Но функция withdraw принимает значения ETH только в Wei, так что заходим на сайт и конвертируем Ether в Wei. Подтверждаем транзакцию на кнопку write, и мы успешно вывели свои деньги с контракта!

Скрипт

Если вы не хотите все это делать вручную, я подготовил для этого скрипт. **Внимание! Я не отвечаю за ваши средства, так что все действия вы делаете на свой страх и риск. И мой контракт, и следующий код - opensouce, вы можете сами их проверить, если желаете. ** Репозиторий:

https://github.com/Nomzegh/zkSyncTXs

Конфиг

Чтобы нормально начать работать со скриптом, вам нужно выставить значения в конфиге под себя:

• from_sec : минимальное значение в секундах, от которого код будет ждать между транзакциями

• to_sec : максимальное значение в секундах, до которого код будет ждать между транзакциями

• eth_min : Минимальное значение в ETH, от которого скрипт будет рандомить число ETH для депозита

• eth_max : Максимальное значение в ETH, до которого скрипт будет рандомить число ETH для депозита

• contract_address : Всегда 0x7442E417C0B53d622d93F5D7BbD84eEd808F26C5, либо заменить на свой контракт

• RPC : Всегда https://mainnet.era.zksync.io, либо заменить на свою RPC

Приватные ключи

Чтобы работал скрипт, нужно вставить приватные ключи аккаунтов, с которыми хотите работать в скрипте.Для этого нужно создать файл keys.txt, который должен находиться возле двух других файлов, необходимых для работы скрипта (cheap_zk.py и abi.py).

Запуск

После запуска нам нужно выбрать одну из опций - вписать цифру:

1 : Депозит. При выборе Deposit, скрипт выберет рандомное значение ETH, которое он задепозитит, исходя из минимальных/максимальных значений в конфиге. 2 : Вывод. При выборе Withdraw, скрипт проверит ваш баланс на контракте, и выведет полную сумму ETH обратно на ваш кошелек. 3 : Проверка баланса. При выборе Check Balance, скрипт проверит ваш баланс на контракте, но выводить его не будет.

Деплой своего контракта

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

Эта часть статьи для более продвинутых пользователей, так что если вы пропустили мою прошлую статью о том, как деплоить контракты на zkSyncEra Mainnet, советую её прочитать, так как не будете понимать следующее.

• В hardhat.config.ts , до всего того, что мы вписывали ранее, вписываем импорт:

import "@matterlabs/hardhat-zksync-verify";

• Заходим в папку contracts и редактируем файл contract.sol:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract EtherDeposit {
    mapping(address => uint256) private balances;

    event Deposit(address indexed account, uint256 amount);
    event Withdrawal(address indexed account, uint256 amount);

    function deposit() external payable {
        require(msg.value > 0, "Invalid deposit amount");

        balances[msg.sender] += msg.value;
        emit Deposit(msg.sender, msg.value);
    }

    function withdraw(uint256 amount) external {
        require(amount > 0, "Invalid withdrawal amount");
        require(balances[msg.sender] >= amount, "Insufficient balance");

        balances[msg.sender] -= amount;

        (bool success, ) = payable(msg.sender).call{value: amount}("");
        if (!success) {
            revert("Withdrawal failed");
        }

        emit Withdrawal(msg.sender, amount);
    }

    function getBalance() public view returns (uint256) {
        return balances[msg.sender];
    }
}

• Заходим в папку deploy и редактируем deploy.ts:

import fs from "fs";
import { utils, Wallet } from "zksync-web3";
import * as ethers from "ethers";
import { HardhatRuntimeEnvironment } from "hardhat/types";
import { Deployer } from "@matterlabs/hardhat-zksync-deploy";

const PRIV_KEY = fs.readFileSync(".secret").toString();

export default async function (hre: HardhatRuntimeEnvironment) {
  console.log(`Running deploy script for your contract`);

  const wallet = new Wallet(PRIV_KEY);

  const deployer = new Deployer(hre, wallet);
  const artifact = await deployer.loadArtifact("EtherDeposit");

  const contract = await deployer.deploy(artifact, []);
  console.log("constructor args:" + contract.interface.encodeDeploy([]));

  const contractAddress = contract.address;
  console.log(`${artifact.contractName} was deployed to ${contractAddress}`);
}

• Не забываем в файл .secrets вписать приватный ключ

• Компилируем контракт командой:

npx hardhat compile

• Если контракт успешно скомпилился, деплоим его командой:

npx hardhat deploy-zksync

• Верифицируем контракт для zkSync Scan:

npm i -D @matterlabs/hardhat-zksync-verify

npx hardhat verify 0xВАШ_АДРЕС_КОНТРАКТА

Вот и все, вы задеплоили свой контракт, и теперь адрес контракта с конфига можете заменить на свой.

https://t.me/roccrypto

Приступим!

zkSync Era

Цена деплоя: ~5$ в ETH Сложность деплоя: 1 способ - классика, сложно. 2 способ - Thirdweb, легко

• Качаем Visual Studio Code с оф. сайта https://code.visualstudio.com/

• Выбираем Английский язык при установке и оставляем дефолтные галочки

• После установки, создаем папку на робочем столе с названием zksync

• Запускаем VSCode и открываем там же эту папку

• Качаем Node.js с офф сайта и устанавливаем. При установке ничего не меняем. После перезагружаем ПК.

• Заходим обратно в VScode, нажимаем CTRL + J, чтобы снизу открылся терминал.

• Вставляем туда следующее:

npm init -y

• Если после команды у вас так, то все отлично:

• Вставляем следующую команду и ждем конца загрузки:

npm add -D typescript ts-node @types/node ethers@^5.7.2 zksync-web3@^0.14.3 @ethersproject/hash @ethersproject/web hardhat @matterlabs/hardhat-zksync-solc @matterlabs/hardhat-zksync-deploy

• Пишем команду, которая установит библиотеку с контрактами OpenZeppelin:

  npm install @openzeppelin/contracts
  

• Жмем плюсик и создаем новый файл с названием hardhat.config.ts

• Вставляем код в hardhat.config.ts и после жмем CTRL+S:

import "@matterlabs/hardhat-zksync-deploy";
import "@matterlabs/hardhat-zksync-solc";

module.exports = {
  zksolc: {
    version: "1.3.5",
    compilerSource: "binary",
    settings: {},
  },
  defaultNetwork: "zkSyncMainnet",

  networks: {
    zkSyncMainnet: {
      url: "https://zksync2-mainnet.zksync.io",
      ethNetwork: "mainnet",
      zksync: true,
    },
  },
  solidity: {
    version: "0.8.17",
  },
};

• Нажимаем на другой плюсик и создаем папку с названием contracts Нажимаем на папку и создаем файл contract.sol . Любые параметры (те что в “ “) ставим под себя - полное название, тикер токена. Вставляем код контракта:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.9;

import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";

contract Roccrypto is ERC20, Ownable {
    constructor() ERC20("roccrypto", "rocc") {
        _mint(msg.sender, 100 * 10 ** decimals());
    }

    function mint(address to, uint256 amount) public onlyOwner {
        _mint(to, amount);
    }
}

• Сохраняем файл на CTRL+S

Тут мы создаем самый обычный ERC20 токен с тикером rocc . Любые другие контракты мы можем брать с документации OpenZeppelin. Но чтобы их деплоить, нужно немного понимать JS/TS. Если вы захотите деплоить другие контракты, которых нет в гайде, но не знаете эти ЯП - воспользуйтесь ChatGPT, чтобы он вам написал deploy.ts скрипт для деплоя ваших контрактов.

https://docs.openzeppelin.com/

• Компилируем контракт командой в терминале:

  npx hardhat compile
  

Если все успешно, у вас должен быть такой результат:

• Жмем на общую папку zksync и в ней создаем папку с названием deploy . В этой папке создаем файл deploy.ts , вставляем код и меняем в нем адрес 0x123..., на который будут минтиться токены. Сохраняем на CTRL+S:

import fs from "fs";
import { utils, Wallet } from "zksync-web3";
import * as ethers from "ethers";
import { HardhatRuntimeEnvironment } from "hardhat/types";
import { Deployer } from "@matterlabs/hardhat-zksync-deploy";

const PRIV_KEY = fs.readFileSync(".secret").toString();

export default async function (hre: HardhatRuntimeEnvironment) {
  console.log(`Running deploy script for the Roccrypto contract`);

  const wallet = new Wallet(PRIV_KEY);

  const deployer = new Deployer(hre, wallet);
  const artifact = await deployer.loadArtifact("Roccrypto");

  const roccryptoContract = await deployer.deploy(artifact, []);
  console.log("constructor args:" + roccryptoContract.interface.encodeDeploy([]));

  const contractAddress = roccryptoContract.address;
  console.log(`${artifact.contractName} was deployed to ${contractAddress}`);

  // Mint some tokens to an address.
  const to = "0x123..."; // Адрес куда минтить токены.
  const amount = ethers.utils.parseEther("10"); // Сколько токенов нужно заминтить на этот адрес
  const mintHandle = await roccryptoContract.mint(to, amount);
  await mintHandle.wait();

  console.log(`Minted ${amount} tokens to ${to}`);
}

• Создаем файл .secret в общей папке zksync. В этот файл мы должны вставить приватный ключ (с балансом, ~5$ в ETH сети zkSync Era), с которого будет деплоится наш контракт. Не держите много баланса, если не уверены в своих следующих действиях. Советую сначала протестировать, а потом деплоить на мультиакках.

• Деплоим контракт с помощью команды:

  npx hardhat deploy-zksync
  

Ура, мы смогли задеплоить контракт и заминтить токены на наш адрес!

UPD: BONUS

Еще контракты на zkSync можно деплоить через сервис Thirdweb, и если вам не нравится классический способ/не доверяете ему - юзаем этот.

• Заходим на Thirdweb и ищем нужный нам контракт - Token

https://thirdweb.com/explore

• Нажимаем Deploy now

• Заполняем данные нашего токена и обязательно выбираем zkSync Era Mainnet

• Жмем Deploy Now и подписываем транзакцию.

• В результате имеем легкий способ для деплоя контракта

Base

Цена деплоя: FREE (Goerlii ETH) Мост: bridge.base.org/deposit** Сложность деплоя:** Легко

Для начала пользуемся мостом и получаем нативные ETH на кошелек.

• Заходим на Chainlist, ищем Base Goerli Testnet и подключаем к нему кошелек. Обязательно переключаем сеть внутри самого кошелька!

• Заходим на Contracts Wizard от OpenZeppelin

• Выбираем ERC20 токен и заполняем первый пункт на свой вкус. Ставим галочки на Mintable и Burnable

• Нажимаем открыть в Remix

• Ставим галочку на Auto compile

• Выбираем Injected Provider - Metamask и подключем кошелек к сайту

• Нажимаем Deploy, подтверждаем транзакцию в Metamask

Теперь мы успешно задеплоили контракт на Base! Но чтобы каждый раз не повторяться, советую поэкспериментировать и деплоить разные контракты.

Scroll

Цена деплоя: FREE (Goerli ETH) Мост: scroll.io/bridge** Сложность:** Легко

Для начала пользуемся мостом и получаем нативные ETH на кошелек.

• Заходим на Chainlist, ищем Scroll Alpha Testnet и подключаем к нему кошелек. Обязательно переключаем сеть внутри самого кошелька!

• Заходим на Contracts Wizard от OpenZeppelin

• Выбираем ERC20 токен и заполняем первый пункт на свой вкус. Ставим галочки на Mintable и Burnable

• Нажимаем открыть в Remix

• Ставим галочку на Auto compile

• Выбираем Injected Provider - Metamask и подключем кошелек к сайту

• Нажимаем Deploy, подтверждаем транзакцию в Metamask

Вот мы и задеплоили наш финальный контракт!

Следующая статья будет о том, как правильно верифицировать и взаимодействовать с нашими свежими контрактами. Ведь мы дофига “билдеры”, и тем самым подходим под нужные критерии несколькими транзакциями: мы задеплоили контракт и будем с ним взаимодействовать, прогнали транзакцию в нужной нам сети, а в будущем даже будем гонять объем через свои контракты, затрагивая пункт Transaction value.

https://t.me/roccrypto