Hyperledger Foundation Hyperledger Global Forum 2021, 11 Jun 2021

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: PyDentity: A Jupyter Notebook Based Playground for Education and... - Will Abramson & Lohan Spies

Description

PyDentity: A Jupyter Notebook Based Playground for Education and Experimentation with ACA-Py - Will Abramson, Edinburgh Napier University / OpenMined & Lohan Spies, YOMA

In this demonstration, we will walk through a Jupyter Notebook based playground for interacting with ACA-Py instances using a custom pip installable packaged OpenMined has been developing called the aries-basic-controller. We have found this to be an intuitive and fast prototyping environment to learn and learn experiment with the Hyperledger Verifiable Information Exchange platform. By the end of this session, we hope to have participants running their own ACA-Py instances, interacting with each other using custom business logic code they themselves have written. As well as potentially any other Aries agent instances being demoed throughout the conference. It will be accessible to anyone with a reasonable understanding of Python and should be a lot of fun.

Sessions Details & Slides (if available)- https://sched.co/j3f1

----
Hyperledger – Open Source Blockchain Technologies

Hyperledger is an open source community focused on developing a suite of stable frameworks, tools and libraries for enterprise-grade blockchain deployments.
It serves as a neutral home for various distributed ledger frameworks including Hyperledger Besu, Fabric, Sawtooth, Indy, as well as tools like Hyperledger Avalon, Cactus and libraries like Hyperledger Aries, Ursa. Learn more about Hyperledger projects: https://www.hyperledger.org/use

Case Studies: https://www.hyperledger.org/learn/case-studies
Training & Certification: https://www.hyperledger.org/learn/training
Tutorials: https://www.hyperledger.org/use/tutorials
Webinars: https://www.hyperledger.org/learn/webinars
Events: https://www.hyperledger.org/events
Vendor Directory: https://www.hyperledger.org/use/vendor-directory

Subscribe to the Hyperledger Newsletter: https://www.hyperledger.org/newsletter

Follow-us on Twitter @Hyperledger

Learn about Hyperledger Membership: https://www.hyperledger.org/about/join

#Hyperledger #HyperledgerGlobalForum2021 #Blockchain

A

So welcome everybody I'm going to be really fast through this, because I don't have very long, but basically me or a few others within open, mind and other than that I've been. You know, messing around for a while with occupy and really trying to find out. You know how we can get to a place where we're experimenting with it without having to go through all this messy configuration, and you know we want to build things.

A

We don't want to have to worry about like setting up the system, and you know debugging loads of weird errors, so we created a notebook playground.

A

Essentially um what it allows you to do is you know, spin up any amount of actors within a system and design business business logic to develop how they to how they interact right so like here we have alice and bob typical, but you could, you know, create any number of actors specific to a domain and then write business logic that you know designs a set of issuers verifiers all that kind of stuff right, um I'm just going to whiz through this.

A

Basically, but you know, there's this code base here, which is really uh abstraction, there's just a simple: you know you can clone it and then you have this playground, which is what we call it. uh So I'm gonna stop sharing this screen now and try to share the actual.

A

Code, so this is, you know the repo cloned downloaded um and essentially, what we have here right is the basic structure of this. Is you have a docker compose file and a managed script, and the manuscript is how you start the docker compose.

A

So it defines the containers that you want to start and obviously these containers need to be defined in your docker compose file and then in your docker compose file, you can specify a bunch of services which, for each actor, so each actor will typically have three or four services. So we have a wallet we use postgres, uh they have ngrok, which will expose your agent to the public network.

A

uh They have the actual agent which just uses a dockerfile from the high college of aries for occupy folks and then business logic and the business logic is the bit that spins up a playground for you like a notebook service section um and that's essentially it and then you have this playground folder right and the playground. Folder is where you actually write your business logic or well, where your business logic is persisted right, so each actor will have a folder and within that folder there'll be an environment file, and this is really cool right.

A

This is where you can specify all the config for your agent, so you know like any ports that you need to define any sort of like variables. You want to define, like you label, um so like this just identifies your agent. You know like any sieve that you want to set. Basically everything that you can pass into occupy. You can specify it in here.

A

um It's really cool really easy to configure, and then you have this notebox folder, which is actually where you write your business logic. So now we're quickly going to go into that, so, basically to spin up this thing, you clone it. You have to do some config we're not going to go over that now, but there is a video that you can just watch. So, if you're interested in getting this film up, uh you should be able to do it in less than 20 minutes.

A

um So I've already got this running locally.

A

um You know, there's there's two services. I can just type docker ps it'll show all these services that are running on my machine and then what you want to do is to get the actual urls just type scripts get urls. This is going to spit out a couple of urls to some basically jupiter notebooks, right with a token to actually access that notebook.

A

um So I'm going to go into that. Stop sharing again start sharing.

A

A

Just to say like what we want to get you to today, hopefully or at least to get you close, and you know motivated to continue doing this is. We would hope that you get to this stage right where you have an agent running on some public ip uh that is accessible on the internet, so that we can connect together right and we can maybe start sending messages.

A

We can write some custom code and you know we can see what happens when people have agents and start to interact, but for now I'm going to show you these two agents which I'm running on my local machine right. So there's one agent here, which is for the hyperledger global forum and we're going to initialize this agent on the sovereign staging network.

A

So I should say: we've written this code ourselves, the aries agent controller. All it's basically doing is providing an interface for us to send swagger requests to the occupy interface and receive web books from them. So you know we're basically saying: okay, we're going to post our api request to this endpoint here. um You know it has an api key um and then we're just going to hit run some functions and you can actually have a look like if you want to uh see what the code is, you can go help.

A

It just put puts out like what the methods you can access basically, uh and so what we're going to do in this notebook here is we're creating a public did and we're going to actually write it to the sovereign staging network. I mean, I feel a bit bad. We've been spamming, the southern station network a little bit, but I think it's okay and it's quite nice to have it on the staging nets exposed to a public network.

A

I should say it's very easy to configure this uh playground to use a local network.

A

It's just setting some config in the uh environment variables we're going to use this scheme, which I've already written to the ledger, I'm going to write a credential definition right. So this is our public key that we can use to sign statements as this agent that we've just spun up issuing these schemas and then what we do here is we like just print out these these identifiers and then we copy them across to like a new notebook where we're actually going to issue them, and the reason for that is because this is docker right.

A

So if we do dot, slash, manage stop we're going to stop these services, but we actually persist the state. It's been quite a while.

A

um Yeah, maybe I should do this before.

A

Okay, I don't know why this is taking so long. Oh no, there we go just generating the key. You know takes long, that's why we've got to move to bbs, plus, I suppose, okay, um oh and then so. The other thing that you need to do so, every one of these notebook instances you'll have to terminate the controllers just so it's not like taking up the port and like creating a client session. I think so here we're actually gonna.

A

uh You know, use the agent control we spin up a web hook server, we paste in our new identifiers uh and I'm gonna create a multi-use invitation. If anybody has a um wallet, a mobile wallet that points to the subject staging network feel free to. You know, scan this qr code, I'm going to print out in a second, and this is basically the logic right.

A

So these connection handlers, the agent receives a message uh sends it through the web book to our agent controller and we just register some listeners and handlers for those events that we're interested in you know performing functionality on so basically, what's going to happen is when this connection goes to active. We're going to offer you a credential, very simple, so yeah, we register these listeners okay, so like what typically would happen right. If I want to do this with myself, you know and I'm trying to design a flow.

A

I can just copy this invitation across to like my uh demo participant agent right, and I could paste it in into this. This thing you know it down here we go somewhere down here and we just paste in the invitation, but we can also display his qr code. Now I have tried this and I hope it's going to work. Has anyone got a mobile phone? It's a shame!

A

I can't hear you because it would be nice, but if people scan this we'll be able to see the interaction right, I should print out some stuff I'll also do it in case. Nobody has one.

A

Okay, cool yeah, and so basically it's just some output that we print right, like you know as many people as you want we're, just you know, receiving webhooks and then we're doing some functionality and what we're doing is we're offering you a credential uh and your participant name is going to be the name of uh yeah. Your phone's like this is logan's iphone cool.

A

I guess just low-handed it. uh This should be like scannable by anybody. So you know we'll leave that for a few more minutes, um if anybody's interested and then so, we've got five minutes. Okay, that's not too bad, uh and then the next thing that I really want to get on to is looking at how you would use this yourself right. So, like I, I've been using this for a while.

A

Now and every time I use it kind of get a bit bit better at using it and, and what typically was happening is I was just copying and pasting code all over the place. So what I've created is here is like some recipes right and you can just you know, say you want to design a flow. You want to issue and verify. So you typically go to the issue credential protocol, you know and like as the issuer, I copy these two templates right.

A

We have the initialization and then the issuance, you can just copy them and I wouldn't put them in the recipes folder. If you come back to your root folder. This is like your agent's code. Right, like your testing out, you can paste them in here and then you've got two easy templates. You can just easily, you know, go down customize whatever you want right, like you want to define some schema. You want to set some attributes. You know it's designed in a way that, oh, you know anything in these brackets. You need to change.

A

It's really simple. To get up and running and, like you know, design a complicated system right, don't do that and then so yeah there's loads of recipes definitely worth checking out, because it's just like here's easy. How do I get started? How do I do stuff?

A

Like so, we have issuance it's creating connection, we have mediation and present proof and well sometimes we'll move uh multi-tenancy in here, but it's just been like a process of refactoring at the moment and then the thing that's cool that we want to do today, which would be great, if you guys can uh you know, get set up with one of these and have them accessible on the public network, because I've created a couple of like libraries. I call them.

A

I mean they're, very rough and ready pieces of code right, but uh essentially these are like things that you can import into your notebook and you know do a bit more complicated functionality without needing to implement uh it all in notebook cells. So you know we have this thing called a messaging service which is going to allow you to you know you pass in your agent controller and then we can make connections using the messaging service and we can, you know, just send messages to each other.

A

We can print out our inbox all that kind of stuff. So I think me and lohan already created a message. So I'll just show you that first.

A

So yeah I mean there's just some code right like so we create an invitation.

A

um So this is like well hands connection identifier and then I'm just saying: okay, like let's see what messages were on somebody, uh you know- and it's it's like that. I mean it's very much a gimmick, but the idea is because we're all working in notebooks right like if anybody here is motivated to like write their own service or you know like extend the service in any way write their own code.

A

Definitely it's 100 possible right. um So there's that right, it would be good to like I can send lohan another message.

A

Oh lord hans just sent me a message, so you know it's cool because we're not on the same machine anymore, right, I'm on some machine on some ip somewhere right and I've actually not used ngrok anymore, we're exposing the agent's http port to the public network, and you know we're interacting together. So another cool thing that we've done is this thing called the authentication service. So, like again, like I just implemented this, I'm just going to terminate the controller.

A

Oh so there's this as well like, because because because this is just in local, you know it's just in local storage, uh it's not going to save, because I'm going to try this you know so. We've now saved this to a file so in future like if I wanted to get back my contacts and like come back into this notebook, I'd have to load from file and just get all these messages back um my thing, yeah in the authentication service.

A

The idea is, you know it's a similar process, we're just importing some class that I've written and what we're going to do is we define a presentation, request and we're creating an invitation right and we're saying okay, for this invite I'm going to challenge them once they accept my invitation to present this proof. Right and again, you know we can display this as a qr code and lohan. I guess you got your credentials, so maybe you could scan this qr code too, and you can present.

A

You know like past the authentication service and you can imagine putting this on a website or basically the idea of this playground is. Is it's really simple to start experimenting with what's possible so that, eventually you know when you get a bit more comfortable? Firstly, you can try out some cool ideas which, wouldn't you know like, would take you a lot longer to do.

A

If, if you were did not work well,.

A

Okay, yeah cool yeah, so it would take you a lot longer to do this. You know if you had them just start from scratch and you were trying to find a front end for all this stuff. You know it gets complicated and you know we're better to like. First, do all the flows kind of get like okay what's going on here and then you can just pick like one actor and say: okay right, I want to divide through a front end for the actor right. uh You know.

A

I want to take this messaging service that I've created right and I want to spin up the front end, so we can actually see messages in a nice interface right. It's just it's kind of like slicing the pie a little bit nicer so that I don't think you've responded to me. You didn't pass the authentication service.

A

No! No! I didn't! We have one minute by the way. Okay, one minute: that's fine did you did you respond because yeah so there's one minute right like and I don't want to go into this anymore- like definitely I'll, be around all confidence.

A

So if you're interested in this, it's totally worth uh having a look, the main thing that I would say is you know: if people don't want to spin this up, we could send you some urls, and you know you could actually just play around with this yourself um and then the other thing that is definitely I recommend, is watching this youtube video which just takes you through the process by which you can um you can set up one of these agents right and like go. It takes like.

A

I think it's like 15 minutes long, so it's a bit little time, not massive right and, and you can hopefully you know if you send it up and we have a channel on the hyperledger global forums like on the rocket channel hashtag aries playground. So if you put in a connection invitation in there we'll definitely at least you know, make a connection with you and send you a message, and I think it's quite cool just to see it you know.

A

So I think that's it right. It was a bit fast and it was hard to get through. Hopefully, uh that's interesting.

A

Yeah, you can do a proof of number of occasions cool thanks a lot.