Skip to content

Update Truffle ABS Quickstart/Tutorial Docs #36160

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Jak-MS merged 4 commits into from
Jul 31, 2019
Merged

Update Truffle ABS Quickstart/Tutorial Docs #36160

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
bc9e341
update quick-start to use truffle console
CruzMolina Jul 30, 2019
6021dbe
update send-transaction to use truffle console
CruzMolina Jul 30, 2019
44d19b6
quorum nodes on ABS use byzantium
CruzMolina Jul 30, 2019
89c2b7d
punctuation
Jak-MS Jul 31, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
57 changes: 36 additions & 21 deletions articles/blockchain/service/connect-truffle.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@ Truffle is a blockchain development environment you can use to connect to an Azu
* [Create an Azure Blockchain member](create-member.md)
* Install [Truffle](https://github.com/trufflesuite/truffle). Truffle requires several tools to be installed including [Node.js](https://nodejs.org), [Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git).
* Install [Python 2.7.15](https://www.python.org/downloads/release/python-2715/). Python is needed for Web3.
* Install [Visual Studio Code](https://code.visualstudio.com/download).
* Install [Visual Studio Code Solidity extension](https://marketplace.visualstudio.com/items?itemName=JuanBlanco.solidity).

## Create Truffle project

Expand All @@ -49,39 +51,52 @@ Truffle is a blockchain development environment you can use to connect to an Azu
```

You may receive npm warnings during installation.

## Configure Truffle project

1. Launch Truffle's interactive development console.
To configure the Truffle project, you need some transaction node information from the Azure portal.

``` bash
truffle develop
```
### Transaction node endpoint addresses

Truffle creates a local development blockchain and provides an interactive console.
1. In the Azure portal, navigate to each transaction node and select **Transaction nodes > Connection strings**.
1. Copy and save the endpoint URL from **HTTPS (Access key 1)** for each transaction node. You need the endpoint addresses for the smart contract configuration file later in the tutorial.

## Connect to transaction node
![Transaction endpoint address](./media/send-transaction/endpoint.png)

Use *Web3* to connect to the transaction node. You can get the *Web3* connection string from the Azure portal.
### Edit configuration file

1. Sign in to the [Azure portal](https://portal.azure.com).
1. Navigate to your Azure Blockchain Service member. Select **Transaction nodes** and the default transaction node link.
1. Launch Visual Studio Code and open the Truffle project directory folder using the **File > Open Folder** menu.
1. Open the Truffle configuration file `truffle-config.js`.
1. Replace the contents of the file with the following configuration information. Add a variable containing the endpoint address. Replace the angle bracket with values you collected from previous sections.

![Select default transaction node](./media/connect-truffle/transaction-nodes.png)
``` javascript
var defaultnode = "<default transaction node connection string>";
var Web3 = require("web3");

module.exports = {
networks: {
defaultnode: {
provider: new Web3.providers.HttpProvider(defaultnode),
network_id: "*"
}
}
}
```

1. Select **Sample Code > Web3**.
1. Copy the JavaScript from **HTTPS (Access key 1)**. You need the code for Truffle's interactive development console.
1. Save the changes to `truffle-config.js`.

![Web3 code](./media/connect-truffle/web3-code.png)
## Connect to transaction node

1. Paste the JavaScript code from the previous step into the Truffle interactive development console. The code creates a web3 object that is connected to your Azure Blockchain Service transaction node.
Use *Web3* to connect to the transaction node.

Example output:
1. Use the Truffle console to connect to the default transaction node.

```bash
truffle(develop)> var Web3 = require("Web3");
truffle(develop)> var provider = new Web3.providers.HttpProvider("https://myblockchainmember.blockchain.azure.com:3200/hy5FMu5TaPR0Zg8GxiPwned");
truffle(develop)> var web3 = new Web3(provider);
``` bash
truffle console --network defaultnode
```

Truffle connects to the default transaction node and provides an interactive console.

You can call methods on the **web3** object to interact with your transaction node.

1. Call the **getBlockNumber** method to return the current block number.
Expand All @@ -93,7 +108,7 @@ Use *Web3* to connect to the transaction node. You can get the *Web3* connection
Example output:

```bash
truffle(develop)> web3.eth.getBlockNumber();
truffle(defaultnode)> web3.eth.getBlockNumber();
18567
```
1. Exit the Truffle development console.
Expand All @@ -109,4 +124,4 @@ In this quickstart, you created a Truffle project to connect to your Azure Block
Try the next tutorial to use Truffle to send a transaction to your consortium blockchain network.

> [!div class="nextstepaction"]
> [Send a transaction](send-transaction.md)
> [Send a transaction](send-transaction.md)
32 changes: 9 additions & 23 deletions articles/blockchain/service/send-transaction.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,31 +68,17 @@ You can continue with the tutorial while the nodes are being provisioned. When p
cd truffledemo
```

1. Launch Truffle's interactive development console.
1. Use the Truffle console to connect to the default transaction node.

``` bash
truffle develop
truffle console --network defaultnode
```

Truffle creates a local development blockchain and provides an interactive console.
Truffle connects to the default transaction node and provides an interactive console.

## Create Ethereum account

Use Web3 to connect to the default transaction node and create an Ethereum account. You can get the Web3 connection string from the Azure portal.

1. In the Azure portal, navigate to the default transaction node and select **Transaction nodes > Sample code > Web3**.
1. Copy the JavaScript from **HTTPS (Access key 1)**
![Web3 sample code](./media/send-transaction/web3-code.png)

1. Paste the Web3 JavaScript code for the default transaction node into the Truffle interactive development console. The code creates a Web3 object that is connected to your Azure Blockchain Service transaction node.

```bash
truffle(develop)> var Web3 = require("Web3");
truffle(develop)> var provider = new Web3.providers.HttpProvider("https://myblockchainmember.blockchain.azure.com:3200/hy5FMu5TaPR0Zg8GxiPwned");
truffle(develop)> var web3 = new Web3(provider);
```

You can call methods on the Web3 object to interact with your transaction node.
Use Web3 to connect to the default transaction node and create an Ethereum account. You can call methods on the Web3 object to interact with your transaction node.

1. Create a new account on the default transaction node. Replace the password parameter with your own strong password.

Expand Down Expand Up @@ -156,21 +142,21 @@ You can get the public key from the transaction node list. Copy the public key f
})(),

network_id: "*",
gas: 0,
gasPrice: 0,
from: myAccount
},
alpha: {
provider: new Web3.providers.HttpProvider(alpha),
network_id: "*",
gas: 0,
gasPrice: 0
},
beta: {
provider: new Web3.providers.HttpProvider(beta),
network_id: "*",
gas: 0,
gasPrice: 0
}
},
compilers: {
solc: {
evmVersion: "byzantium"
}
}
}
Expand Down