Agoric Tutorials, 14 Nov 2020

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Prepare Your Agoric Environment

Description

Michael FIG, Software Engineer at Agoric, walks through how to set up the Agoric environment for your first dapp and get to Hello World.

Resources:
https://agoric.com/documentation/getting-started/
https://github.com/Agoric/agoric-sdk

ABOUT
Build Fast, Earn Fast - Agoric enables developers to rapidly deploy dapps and DeFi markets on-chain using composable JavaScript smart contracts. Safely get your project from vision to global market.

LINKS
https://agoric.com
https://agoric.com/twitter
https://agoric.com/discord
https://agoric.com/telegram
https://agoric.com/newsletter

Click the 'SUBSCRIBE' button to follow our Youtube channel!

A

Actually get a negork environment started up. We won't go into too much details in terms of code, but we will get into the logistics of how to start things with your software.

A

So, as a roland said, we'll be taking. Questions on youtube, live on discord and he'll surface them to me in the presentation. If you want to ask during the presentation we're going to start with walking through the before using a quark documentation, this is on the getting started guide on the website. The dot com, documentation website, uh we're going to start a new client and the chain.

A

uh So this is just the simulated environment which allows you to do rapid development without having to actually fire up chain nodes and run a billion different processes and finally, we'll do a kind of hello world of how to interact from the agora client to the chain.

A

First you're going to need a unix-like environment, so we then have to install node.js and finally yarn one um for unix-like environment. We usually use mac os. Linux is also good uh there. There are just a couple minor details about which node.js packages you can use and for windows. We currently only work with weasel the windows subsystem for linux, so um we hope to support windows fully at some point. But currently you need to install that we know subsystem.

A

I don't have instructions for how to do that right now, but if you google, for it, you should be able to find how to do it. So with node.js, we want to start with version. 12, 14, 1 or higher and 14x also works. Well, 13 doesn't for us, it won't work with the test. Suites we use.

A

um Also, you should use the official distribution. If you can um it. uh The one you install from the nodejs.org website is uh is the one that works best for your platform in general. um If you don't want to install it that way, that's okay!

A

So the one trick with the linux side. Is you don't want to install the node.js snap because it can't build add-ons which we currently rely on, so installing yarn one? uh Yes, we want yarn one. Usually this is a bundle with the node.js package that you use and some things work with yarn too, but not every dapp works with yarn too. So it's best to just stick with yarn one.

A

So I'm just going to show you here the versions that I have installed. uh I have 12 18, 3 and yarn. One.

B

A

Something that's all good for installing the agora sdk. We want to open up a shell, like I've already shown um clone the egorc sdk from git and update the sdk with the latest version. So a shell prompt. You basically need something like bash or z. Shell should also work, and you want to look for your system's terminal app just like I have open here.

A

So this is bash that I'm currently running um and you can basically use any directory as your starting point for where to download the code in to install things. So we'll start with cloning, the work sdk.

A

You uh want to run it if you haven't already done it, otherwise you can just skip to the next step. So let's look at what that looks like um so I'm going to make a code directory and then change into it and finally do the git clone.

A

So this will take a little bit of time, I'll just fast forward here.

A

And cd into the other gorg sdk directory, we just created and finally check out the hackathon branch.

A

That's the step here where we're basically going to check out the hackathon branch. um You will need to update this hackathon branch if you're advised by the work team that we need to roll out an upgrade or if you have an older, garc sdk before this is done.

A

um So the last step you want to do is a git pull after you've checked out the branch, that's the update, step and we're up to date.

A

So next thing we want is to install a gork cli with yarn, install yarn, build and then uh yarn install just installs the libraries that we need and after you've upgraded or pulled the get the git repository, then you want to run a yarn install just to pick up any of the latest dependencies.

A

This can take a little while so I'm going to fast forward it quite a bit, notably building the the native packages takes a while.

A

So I'm just fast forwarding it, but this actually does take 65 seconds, as it said, um so. The yarn build step is just to compile some of the javascript files that we have we're trying to eliminate this. So it doesn't take a build anymore, but some packages still need that in the accord sdk.

A

So this is what it looks like um yarn, build.

A

I'll just fast forward this one as.

A

Well and finally, uh after after you do the yarn install, you only really need to do the iron build again without installing is uh after an upgrade or if you change zoe's contract facet or the wallet ui you'll know, if you do this, because it's a more advanced thing and that's the only time when you actually need to re-run the yarn build to get the effect of the changes and installing the work cli we're going to do this with sudo to install it in the user, local bin directory.

A

So link cli, and this just creates a script for us and populates it, so you can install it in other directories, besides user local bin, if you're a more advanced user, it's just a matter of putting it somewhere where it's on your path.

A

Finally, we can start to create a dot project with a simulated chain and play with some javascript in the reply.

A

This is what a dot project is started with. Now that we've created that decor cli, we can run agork init, hello,.

A

uh This is how it goes we'll go back to our code directory, uh because the corkscrew is in the path we can be in any directory. When we do this, the garcinite hello will create a subdirectory containing the data.

A

um So that's just a couple things, uh and when we go into the hello directory we can do an install, and this builds the dependencies and links to the existing negorky sdk.

A

So I'm just going to fast forward past. Here too, it's going to build some more it's going to build some packages.

A

And install the link packages- okay, that's all good! uh Finally, we want, after the igork install we wanted to move on to start a simulated chain. So this is the part that I don't have on. Recording I'll, just show it to you live. So if we run the gork start um I'll do a reset. Just because I want to have a fresh light, and this basically starts up the orc, vm and it'll. Tell you when it started to run I'm just going to put this in the background and say: agorak open.

A

The gorick open rebel.

A

So when we open the replay that actually starts our web browser up with an access to the redeval print loop, this is the interactive command line that allows us to interact with the chain. So up above here we see the gork wallet, and this is all connected. It says test testnet currency, but is currently connected to the simulator chain. Only now in the quark cli we can essentially run javascript commands.

A

So let's take a look at a couple things we can do.

A

There's a regular console log and it's just displaying in the little rapple down here we can look at the home object which contains a bunch of stuff. uh This is json formatted output, except for these presences presences are things like remote objects that you can access through the the cli so from home. We see that let's look at the echoic object, which is a subset of those services.

B

Hey michael, uh so we did get one request. I don't know if it's possible to increase font size on any of your windows here, but if possible, do you mind zooming in.

A

B

Can do that here great. Thank you very much.

A

Okay, um so the gork on chain services, an interesting thing here- is that we have a price authority.

A

So if we look at the gorick.price authority, we see that it's a presence and we can run a till dot, which is this remote invocation form of the dot operator.

A

So I can, uh let's run the nonexistent, help, object and it'll. Tell us: oh price authority doesn't have a method hope help. It has these different methods that we'll introduce later on with how the chain-link integration fits together. But then we can do something like actually get a.

A

A

Oh, of course, I didn't do that right anyway. The point is, you can wander around these little objects and use them as you would. um This is essentially a javascript environment, except it's a bit different in that it only has deterministic things. So if I try doing a math.random I'll just get sorry, it's not a function.

A

If I try doing.

A

A

It doesn't return anything, but you can still use most of the apis that are there. These ones have just been removed because they're non-deterministic and we can't have that on the chain.

A

So this is the wallet we'll give you a tour of that in a later presentation. um I can now go back and answer any questions that there are. uh This was the quick way of setting up the quark environment.

A

um So that's the last bit of the repo just a basic introduction uh and finally, we have a hackathon documentation and the actual code for the sdk.

A

So I recommend working through the getting started guide. It'll tell you how to do all these things and.