Get started with ethereum

Getting started with Ethereum & Solidity on Windows — part 1

Oct 2, 2017 · 3 min read

Getting started with Ethereum & Solidity development on Windows can be somewhat daunting as most tools are designed for linux. Coming from a Microsoft background I do prefer some of my familiar tools to avoid the additional hurdles. After playing around for a bit, it’s actually quite easy to get started. So let me guide you setting-up your Windows environment and get yourself ready for developing your first smart contract on Ethereum.

The tools we’re going use for it are;

Default installation for these will do just fine, but at least make sure that (Node and Git) are added to the PATH variables on your system.

Now that we’ve got our basics, let’s continue installing the rest of our tools via Node.js (which we’ve just installed). Open up a PowerShell window, with administrative access, to execute the following commands.

The windows-build-tools are required to compile native Node modules. And the combination of ethereumjs-testrpc together with the truffle framework, will basically give you everything you need to start developing right away. We’ll follow up on those later on.

If everything is OK, we can now continue to Visual Studio Code and install one more extension for Solidity. You can either search for it in the Extension marketplace or directly from the terminal;

So now it’s time to get our first project up and running. Create a new folder ‘truffledemo’ or mkdir truffledemo and open it up with VS Code. From your integrated terminal we’ll start off with initializing the default project truffle is providing us, to test and show our environment is running correctly.

EDIT: Since truffle v4 init will give you a clean, empty truffle solution. For installing the MetaCoin project you need the following command.

Once completed, you’ll have a default project structure containing a set of example Solidity contracts, which act as an alt-coin on Ethereum. More info can be found at the truffle docs.

We’ll leave these as they are right now and open up a new PowerShell window. You can do so from within the integrated terminal as well, but I’d like to leave it running in the background without interfering within VS Code. Execute the command testrpc which will start your Ethereum client. It simulates all client behavior making testing and development so much easier and faster.

As you can see right now is that testrpc is listening on localhost:8545 and will act as your locally running Ethereum Node. Meaning that if we go back to VS Code (leaving testrpc running) we can now test our contracts, from the terminal again..

Which will compile our solidity contracts and will execute the tests, which are part of the default project.

That’s it! You can now start developing and testing your smart contracts and play around with it for a bit. We’ll dive into more details on all the tools and details in future posts. If you want to know anything specific, feel free to post below.

UPDATE: If you’re up for it; feel free to continue to part 2.

Источник

Getting Started with Geth

To use Geth, you need to install it first. You can install Geth in a variety of ways that you can find in the “Install and Build” section. These include installing it via your favorite package manager, downloading a standalone pre-built binary, running it as a docker container or building it yourself.

For this guide, we assume you have Geth installed and are ready to find out how to use it. The guide shows you how to create accounts, sync to a network, and then send transactions between accounts.

This guide uses Clef, which is our preferred tool for signing transactions with Geth, and will replace Geth’s account management.

Initialize Clef

First, initialize Clef with a random master seed, which is also encrypted with the password you define. The password must be at least 10 characters.

Create accounts

Create two accounts with the clef newaccount command, set a password for each of them, and note the public address for each.

Clef outputs a debug message about Failed to reload keystore contents , we fix that in a later step.

Start Geth

Networks

You can connect a Geth node to several different networks using the network name as an argument. These include the main Ethereum network, a private network you create, and three test networks that use different consensus algorithms:

• Ropsten: Proof-of-work test network
• Rinkeby: Proof-of-authority test network
• Görli: Proof-of-authority test network

For this guide, we use the Görli network.

Sync modes

You can start Geth in one of three different sync modes using the —syncmode » » argument that determines what sort of node it is in the network.

• Full: Downloads all blocks (including headers, transactions, and receipts) and generates the state of the blockchain incrementally by executing every block.
• Fast (Default): Downloads all blocks (including headers, transactions and receipts), verifies all headers, and downloads the state and verifies it against the headers.
• Light: Downloads all block headers, block data, and verifies some randomly.

For this tutorial, we use a light sync:

Start Clef

Start Clef, setting the keystore and chain id (goerli is 5) for the network we want to connect to:

To begin with, you see errors about a missing keystore, and we fix that soon.

Start Geth

The command below also enables the Geth RPC interface (which we cover below), and sets Clef as the transaction signer.

Get ETH

Unless you have Ether in another account on the Görli network, you can use a faucet to send ETH to one of your new account addresses to use for this guide.

Connect to Geth with IPC or RPC

You can interact with Geth in two ways: Directly with the node using the JavaScript console over IPC, or connecting to the node remotely over HTTP using RPC.

IPC allows you to do more, especially when it comes to creating and interacting with accounts, but you need direct access to the node.

RPC allows remote applications to access your node but has limitations and security considerations, and by default only allows access to methods in the eth and shh namespaces. Find out how to override this setting in the RPC docs.

Using IPC

Connect to console

Connect to the IPC console on a node from another terminal window:

Check account balance

Getting the balance of an account does not require a signed transaction, so Clef does not ask for approval, and Geth returns the value.

Send ETH to account

Send 0.01 ETH from the account that you added ETH to with the Görli faucet, to the second account you created:

This action does require signing the transaction, so Clef prompts you to approve it, and if you do, asks you for the password you are sending the ETH from. If the password is correct, Geth proceeds with the transaction.

To check, get the account balance of the second account:

Using RPC

Connect to RPC

You can use standard HTTP requests to connect to a Geth node using the RPC APIs, for example:

Check account balance

Getting the balance of an account does not require a signed transaction, so Clef does not ask for approval, and Geth returns the value.

Send ETH to accounts

Send 0.01 ETH from the account that you added ETH to with the Görli faucet, to the second account you created:

This action does require signing, so Clef prompts you to approve it, and if you do, asks you for the password you are sending the ETH from. If the password is correct, Geth proceeds with the transaction.

To check, get the account balance of the second account:

© 2013–2019. The go-ethereum Authors. Edit this page.

Источник

Создаём собственный блокчейн на Ethereum

Как создать приватный блокчейн Ethereum с нуля?

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

Инструкция включает в себя следующее:

• Создание приватного блокчейна Ethereum с помощью geth.
• Создание кошелька MetaMask для работы с приватным блокчейном.
• Перевод средств между несколькими аккаунтами.
• Создание, развёртывание и вызов смарт-контракта в приватном блокчейне с помощью remix.
• Создание обозревателя блоков Ethereum поверх приватного блокчейна.

Установка Geth

Go Ethereum (или geth) это одна из трёх изначальных реализаций протокола Ethereum (наряду с C++ и Python). Она написана на Go, полностью открыта и лицензирована под GNU LGPL v3. Go Ethereum можно скачать или как отдельный клиент, работающий практически в любой ОС, или как библиотеку для встраивания в проекты Go, Android или iOS.

Для установки geth под Mac OS X мы использовали homebrew. Homebrew устанавливает всё необходимое, о чём не позаботилась Apple. Эта статья предполагает, что homebrew у вас уже установлен. Если нет, следуйте этой инструкции. После установки homebrew следующие команды установят geth.

brew tap ethereum/ethereum
brew install ethereum

Установить geth на Ubuntu довольно просто, достаточно запустить следующие команды apt-get.

sudo apt-get install software-properties-common
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo apt-get update
sudo apt-get install ethereum

Для Windows соответствующий инсталлятор лежит здесь. В случае каких-либо сложностей обращайтесь к инструкции.

Создание аккаунта майнера

Сначала нужно создать аккаунт для майнинга Ethereum. Так мы сгенерируем пару приватного и публичного ключей с паролем для защиты. Не потеряйте свой пароль, иначе никогда не сможете восстановить ключи. По умолчанию, ключи хранятся внутри: /keystore. Всё, что сохраняет geth, хранится внутри datadir (кроме PoW Ethash DAG). Расположение директории по умолчанию зависит от ОС. Всегда лучше изменить стандартные настройки и задать свой собственный путь для приватного блокчейна.

/.ethereum

Windows: %APPDATA%\Ethereum

Ethash DAG хранится в

/.ethash (Mac/Linux) или %APPDATA%\Ethash (Windows), так что его могут использовать все клиенты.

Следующая команда показывает, как создать аккаунт с произвольным путём для директории данных. Эта команда выдаст ваш адрес Ethereum.

geth account new —datadir

geth account new —datadir /path/to/data/dir

Создание первичного блока (genesis block)

Блокчейны Ethereum отличаются друг от друга первичными блоками. Каждый блокчейн начинается с такого блока, а всё остальное строится поверх него, где каждый следующий блок ссылается на предыдущий. В публичном блокчейне Ethereum первичный блок был создан 20 июля 2015 года. Для нашей собственной цепочки нужно создать собственный первичный блок. Инициализация приватного блокчейна с заданным первичным блоком осуществляется следующей командой:

geth -datadir /path/to/data/dir init /path/to/genesis.json

• datadir: директория для баз данных и хранилища ключей.
• init: начальная загрузка и инициализация нового первичного блока — с соответствующим файлом json.

Ниже показан наш первичный блок, который используется в приватном блокчейне — нужно сохранить его под именем genesis.json и указать в приведённой выше команде.

• chainid: обеспечивает способ совершения транзакций в Ethereum без использования ETC (Ethereum Classic) или тестовой сети Morden. EIP 155 предусматривает следующие значения chainid для разных сетей: основная сеть Ethereum (1), основная сеть Morden / Expanse (2), Ropsten (3), Rinkeby (4), основная сеть Rootstock(30), тестовая сеть Rootstock (31), Kovan (42), основная сеть Ethereum Classic (61), тестовая сеть Ethereum Classic (62), приватные цепочки geth (1337 по умолчанию). В нашем примере мы указали идентификатор 15, который не используется ни одной из существующих цепей.
• homesteadBlock: значение 0 указывает на использование релиза Ethereum Homestead. Это второй из основных релизов Ethereum — а недавно, 16 октября 2017 года, Ethereum форкнулся на релиз Byzantium.
• eip155Block: значение 0 указывает, что этот блок поддерживает EIP (Ethereum improvement proposal, предложение об улучшении Ethereum) номер 155. Предложения EIP описывают стандарты для платформы Ethereum, в том числе ключевые спецификации протокола, клиентские API и стандарты контрактов.
• eip158Block: значение 0 указывает, что этот блок поддерживает EIP 158.
• difficulty: значение соответствует уровню сложности, которое применяется для поиска случайного значения nonce к этому блоку. В этой статье подробно объясняется, как рассчитывается уровень сложности в Ethereum.
• gasLimit: газ — это внутренняя единица оплаты для проведения транзакции или контракта в Ethereum. Каждая инструкция, которая отправляется в виртуальную машину Ethereum Virtual Machine (EVM) для обработки транзакции или смарт-контракта стоит определённое количество газа. Если транзакция не получает нужного количества газа, то она не пройдёт. При совершении каждой транзакции в Ethereum вы указываете лимит газа — максимальное количество, которое могут использовать все сопутствующие операции для этой транзакции. Параметр gasLimit в блоке определяет общий лимит всех транзакций в блоке.
• alloc: параметр для предварительного распределения Эфира из первичного блока на один или несколько аккаунтов. В вышеприведённом примере первичного блока весь Эфир поступает на аккаунт, созданный с самого начала.

Начинаем майнинг

Всё готово! Теперь можно начать майнинг через geth с помощью следующей команды. Здесь параметр networkid выделяет эту сеть Ethereum среди других. Все майнеры, желающие подключиться к этой сети, должны использовать тот же идентификатор networkid с тем же первичным блоком.

geth —mine —rpc —networkid —datadir

geth —mine —rpc —networkid 1999 —datadir /path/to/data/dir

• networkid: сетевой идентификатор этой сети Ethereum. Выбираете любое значение. Например, Olympic (0), Frontier (1), Morden (2), Ropsten (3).
• mine: включает майнинг.
• rpc: включает сервер HTTP-RPC. Приложения кошельков могут подключаться по http к этому узлу майнинга.
• rpcaddr: указывает интерфейс для прослушивания на сервере HTTP-RPC (по умолчанию: “localhost”)
• rpcport: указывает порт для прослушивания на сервере HTTP-RPC (по умолчанию: 8545)
• rpcapi: указывает API, доступные по интерфейсу HTTP-RPC (по умолчанию: “eth,net,web3”)
• rpccorsdomain: активирует CORS, указывая разделённый запятыми список сторонних доменов, с которых можно принимать запросы (cross-origin). Полезная опция при использовании для размещения смарт-контрактов браузерных редакторов Solidity (Remix) или браузерных кошельков. Например, такой параметр позволит принимать CORS с любого домена.

—rpccorsdomain «*»

nodiscover: отключает механизм поиска пиров. Ваш узел не смогут найти никакие другие узлы в сети. Если намерены использовать блокчейн в локальной сети совместно с другими, не применяйте этот параметр.

console: этой командой мы можем запустить узел майнинга с интерактивным окружением JavaScript. В следующем разделе подробнее рассмотрим эту тему.

geth —mine —rpc —networkid 1999 —datadir /path/to/data/dir console

Подключаем консоль Geth

Можно или начать майнинг как console , или запустить console отдельно — и подключить её к узлу майнинга командой attach. Сейчас покажу, как это делается, и проверьте, что вы указали параметры в том же порядке.

geth —datadir /path/to/data/dir attach ipc:/path/to/data/dir /geth.ipc

Консоль подключается к узлу майнинга по IPC. IPC (межпрорцессное взаимодействие) работает на локальном компьютере. В этом случае geth создаёт конвейер Geth (который представлен файлом

/geth.ipc) в файловой системе локального компьютера — а консоль подключается к этому узлу по IPC.

Просмотр всех аккаунтов

Как только вы подключились к консоли geth, можно попробовать запустить следующую команду для отображения всех доступных аккаунтов.
> eth.accounts
[«0x7a69b359e86893efa3d9732e4c65ced51567edd0»]

Просмотр баланса аккаунта

Следующая команда позволяет просмотреть баланс заданного аккаунта из консоли geth.

Подключение кошелька MetaMask Ethereum

MetaMask — это кошелёк Ethereum, работающий как расширение Chrome. Он внедряет Ethereum Web3 API в каждый контекст JavaScript на сайте, так что все эти приложения способны получать информацию из блокчейна. MetaMask также позволяет создавать собственные идентификаторы (identities) и управлять ими, так что когда приложение хочет совершить транзакцию и записать данные в блокчейн, у пользователя есть безопасный интерфейс для просмотра транзакции, прежде чем одобрить или отклонить её.

Для подключения MetaMask к приватному блокчейну Ethereum нужно выбрать правильные имя хоста и порт. Web3 API — это программные интерфейсы JavaScript для Ethereum, реализованные в web3.js. Чтобы JavaScript-приложение обменивалось данными с узлом Ethereum, MetaMask использует библиотеку web3.js с удобным интерфейсом для методов rpc. Она обменивается с локальным узлом вызовами rpc. Библиотека web3.js работает с любым узлом Ethereum, у которого есть слой rpc. Вы могли заметить выше, что при запуске узла майнинга можно передать параметр rpcapi и указать, какие интерфейсы мы хотим использовать на этом узле. По умолчанию, если ничего не указать, будут использоваться интерфейсы eth,net,web3 .

Передача Эфира

MetaMask создаст аккаунт Ethereum — секретный ключ и адрес Ethereum. Дальше разберёмся, как передавать Эфир с первого аккаунта, созданного в самом начале, на аккаунт MetaMask из консоли geth. Для передачи средств аккаунта нужно использовать для подписи секретный ключ этого аккаунта. Чтобы его использовать, нужно его сначала разблокировать, как показано ниже.

personal — это управляющие программные интерфейсы в geth. Кроме personal, geth также предоставляет следующие управляющие API: admin, debug, miner и txpool. Как только мы разблокировали аккаунт, мы можем определить в консоли три переменные: для sender, receiver и amount, то есть получателя, отправителя и количества передаваемых средств. Значение sender — это адрес Ethereum, который мы создали в начале этой статьи, а значение receiver — адрес Ethereum, созданный в MetaMask.

> var sender = «0x7a69b359e86893efa3d9732e4c65ced51567edd0»;
> var receiver = «0xA9f28458eE1170F285440990c196c1592D3a73f5»
> var amount = web3.toWei(1, «ether»)

Следующая команда осуществит передачу средств — она ссылается на переменные, которые мы определили выше.

Просмотр баланса аккаунта в MetaMask

Когда мы завершили передачу средств, следуя вышеуказанным шагам, можно просмотреть баланс аккаунта двумя способами. Первый способ — напрямую из плагина MetaMask, как показано ниже.

Другой способ — через консоль geth, с помощью следующей команды.

Редактор Remix для Solidity

Solidity — самый популярный язык программирования для написания смарт-контрактов Ethereum. Remix — это IDE для Solidity со встроенным отладчиком и средой тестирования. Онлайновый редактор remix можно найти здесь. Remix подключается к любой сети Ethereum. Для подключения к нашему локальному блокчейну убедитесь, что вы запустили узел майнинга следующей командой, как показано ниже. О параметре —rpccorsdomain «*» мы уже говорили. Вместо звёздочки (максимальная открытость) в качестве значения этого параметра можно указать “https://remix.ethereum.org”.

geth —mine —rpc —rpccorsdomain «*» —networkid —datadir

Для подключения remix к нашей закрытой сети нужно изменить Environment на Web3 Provider, это делается на вкладке Run. При этом изменении remix попросит указать Web3 Provider Endpoint — установите значение http://localhost:8545 . Пока вы явно не изменили порт, по умолчанию узел для майнинга стартует на порту 8545.

Создание смарт-контракта

Теперь всё готово для написания самого первого смарт-контракта, который мы запустим в сети Ethereum. Скопируйте следующий код и вставьте его в онлайновый редактор remix. Это очень простой смарт-контракт — я даже не хочу объяснять его построчно. В следующей статье подробно рассмотрим язык программирования Solidity.

Если вы не меняли настройки по умолчанию в remix, то они установлены на автоматическую компиляцию. Если нет, то надо скомпилировать код.

После компиляции при нажатии кнопки Details вы увидите расчётное количество газа, необходимое для создания этого смарт-контракта.

Внедрение смарт-контракта

Теперь можем внедрить смарт-контракт в наш приватный блокчейн. На вкладке Run убедитесь, что у вас выбран правильный аккаунт Ethereum и правильный лимит газа. Значения gas price и value можно указать нулевыми.

Здесь транзакция Ethereum, подписанная с выбранного выше аккаунта для создания смарт-контракта в блокчейне. Для подписи сначала нужно разблокировать аккаунт через консоль geth.

Теперь можете нажать кнопку Create, чтобы создать смарт-контракт. У нас в нём конструктор, принимающий строковый параметр, вот почему remix показывает поле ввода вместе с кнопкой Create. Сюда можно ввести какое-нибудь значение (в кавычках, например, “Hi”) — или просто оставить пустым. В консоли geth при создании смарт-контракта появится следующее сообщение. Также обратите внимание, что если не установлен корректный gas limit, то такая команда приведёт к ошибке.

INFO [10-19|07:31:08] Submitted contract creation fullhash=0xf5511bb9d088672ac0d3896b8590b9a3e25484300f02deecdd739c3a549ed33a contract=0x42b7E903Fb42e191a7D623cbb4b7b4330D329d78

Вызов смарт-контракта

После создания смарт-контракта интерфейс remix немного изменится — как показано ниже, на вкладке Run.

Здесь можно установить некое значение для метода setGreeting — и нажать на него для вызова смарт-контракта. Опять же следует убедиться, что аккаунт разблокирован, потому что при вызове смарт-контракта мы использует транзакции Ethereum и требуется подпись инициатора. Проделав операцию с setGreeting, можно вызвать и другие методы.

Ethereum Block Explorer

Возможно, вы знакомы с сервисом etherscan для сканирования публичного блокчейна Ethereum. Но его нельзя направить на наш локальный блокчейн. Хотя Ethereum Block Explorer даже близко не сравнится по функциональности с etherscan, он вполне подходит для изучения того, что происходит в нашем локальном блокчейне.

Для установки программы сначала возьмём исходники со следующего репозитория.

git clone https://github.com/carsenk/explorer

Затем запустим команду установки из директории Ethereum Block Explorer.

По окончании установки запустите Ethereum Block Explorer следующей командой — и получите доступ к веб-консоли через http://localhost:8000 .

Перед подключением Ethereum Block Explorer к локальному блокчейну убедитесь, что запустили узел майнинга следующей командой с параметром —rpccorsdomain «*» — его значение мы обсуждали ранее.

geth —mine —rpc —rpccorsdomain «*» —networkid —datadir

Обновление: Обсуждение этой статьи на Hacker News см. здесь. Не стесняйтесь присоединяться.

Источник

Читайте также:  Asus sabertooth z77 майнинг