Introduction Launching a dapp may not be as hard as launching a rocket… but it’s no moonwalk, either. A dapp, portmanteau of “decentralized app,” is any app that runs on decentralized infrastructure, like on Ethereum. For your coding pleasure, our team is happy to present Muttniks, a friendly Ethereum space doggo “kernel” (or kennel) that you can build from the comfort of your spacecraft. Muttniks is an open source sample dapp, built to guide you through our exciting journey with Astro Ledger. Like the real stars and planets featured on , you can securely adopt, name, and trade Ethereum space doggos with Muttniks (and then donate your testnet ETH to build more monuments). The following is a step-by-step technical exploration of the inner workings of Astro Ledger, which you can recreate on your local machine with Muttniks. astroledger.org Laika Muttniks was the “pet” project of Astro Ledger CWM (Chief Wow Muttniks) . Thanks Tony! Tony This star’s Henry Draper catalog number is HD137052. ’. It has been named ‘Tlon Keeping Track of Stars & Muttniks In order to assign names to actual stars, we needed a way to uniquely identify them. For this we used the Henry Draper Catalog of the brightest stars in the sky, with meta-information provided by the from The Astronomy Nexus. HYG database Our specially selected Muttniks have no such prior catalog so we pseudo-randomly assigned each Muttnik a number, 1–6. The meta-information about each Muttnik (name and image) is loaded into the database in this . Our Astro Ledger creative content (spearheaded by Chief Chocolate Dehydrator ) and image links are similarly loaded into the database, with SQL code created by offline Python scripts that load data from HYG and other sources. Flyway migrations file Aleeza When a Muttnik is added to a database, we use a to add the same Muttnik to the contract, putting it up for adoption. For Astro Ledger stars, those same offline Python scripts create corresponding Truffle migration scripts to create stars and put them up for space-grant-supporting-auctions at the price of about a dollar. Truffle migration script Contract & Events: Creating and Adopting The Muttniks are stored in a where each pet has an address variable for the adopter, initialized to address(0), and a boolean variable exists to distinguish this pet from one that hasn’t been created yet. “pets” mapping The function createAdoptee is used by the owners to create each Muttnik in the contract. This is typically done in batch with a , but could be called by any function. Adoption happens via the adopt function, which checks to see that the Muttnik hasn’t already been adopted before assigning the Muttnik’s address to the adopter. Adoption events are emitted so the browser can inform the astronaut/cosmonaut of the adoption when the blockchain confirms it. Muttnik Kernel Truffle migration script Contract & Events: Naming Muttniks The obvious solution to handling Muttnik (and star) names was to store the name as a variable in the contract. To find the name, folks could call a view function (for zero gas) that would return the name. However, storing data in an Ethereum contract is never a cheap operation. Because Astro Ledger’s goal is to allow anyone to be able to assign meaningful names to stars, we implemented the assignName function using instead. Names are forever stored on the blockchain as 32 bytes of data on a log of the event, but because they aren’t accessible to the Ethereum Virtual Machine (EVM), the gas cost to assign a name is almost negligible. This philosophically-motivated decision allowed us the exhilarating discovery that much of the existing software for Ethereum does not fully support event-logs, but we went to the edges of the universe to achieve a solution for pulling up the names quickly, as described later. events The owner of is well aware that changing a star’s name is not to be taken lightly… HD162004 Web Stack While Chief Rubber Taster worked on the contract and the star database, Tony began building the Astro Ledger web stack using Play! for a web framework ( ), and Postgres for the database (ol’ ). At first, Tony chose to generate HTML pages of available stars. He quickly learned that the majority of the anticipated Astro Ledger user base had settled on a browser plugin called MetaMask to talk to Ethereum blockchains, and so began sneaking in some JavaScript (including a popular library called ) into the webpages to support this. The code to generate web pages soon became a funny mix of Scala, HTML, and ES5, where all of the blockchain interactions were executed using web3js. This worked, and was fast enough in our test environment. Jonathan ol’ reliable good enough for everything Twirl web3js Though it’s probably still fair to call the main Ethereum network itself a “test environment,” deploying our app to it in our first production alpha revealed one that was far slower than even Tony’s 2014 Macbook Air. This was particularly true for the for-loops we used in our contract to search for a user’s star cards, which were executed individually in the user’s web browser whenever they went to our page (note that, to guard against this performance hit, the uses no for-loops). To prevent expensive, redundant contract calls, we decided to move some of these queries to the Scala side of things, where they’d execute once on our Heroku instance every few minutes, and then be accessible to a user’s web browser without it having to call any contract code itself. Muttniks Solidity code isn’t for sale, but it’s hot enough to melt your heart. Jellybean This was great for querying a user’s star cards, but things became interesting when we needed to query the names that they assigned to stars. As mentioned earlier, rather than put these names in contract storage as we did with auctions and card ownership, we chose to keep a record of star names using Ethereum events: this was intended as a . So why not cache on our server? As we soon discovered, (a library similar to web3js that we used for querying the blockchain in Scala) on Infura, the free client we used for accessing the main Ethereum network. Web3js support querying events in the user’s browser, but this had even worse performance effects on the browser than querying ownership, because it would poll the blockchain every second or so to get event information (web3js 1.0 ). less expensive form of storage these web3j did not support filters did has since addressed this To get a better handle on things, we decided to go closer to the source. In earlier investigations, Tony had coded up some Clojure code to talk directly to Infura’s RPC endpoints. With it running on our server, we could essentially do the same thing as web3js would in someone’s browser, but in one place (for $7/month) and at a longer poll interval. So, we decided to turn it into a full blown service. Coupled with Redis, this gave us our own centralized names cache, which, as with auctions and card ownership, could be accessed in someone’s browser much more quickly than if it were to query the blockchain directly itself. Single-Page In the meantime, Chief Rubber Taster Jonathan was tasting the rubber over in Tel Aviv when he met the team developing , a browser based smart-contract enabled wallet. Portis would allow folks to use Ethereum on a vanilla web browser (i.e. without MetaMask installed), including iOS or Android. However, , our initial approach of rendering web pages server-side (where clicking a link would open a brand new page) would oblige users to log in over and over again whenever they navigated anywhere on our site. The solution was to migrate to a that could be downloaded all at once in a user’s web browser, to provide full functionality without a user ever having to refresh the page or log in again. Portis since the Portis library only stored user credentials in browser memory single page application Easily accessing astroledger.org with Portis, so we can add to our star collection. Libre To accomplish this, we settled on , since it afforded us the ability to easily use another popular library, to interoperate with web3js in a singly-paged way. However, The Drizzle library itself relied on web3js 1.0, which at the time . We eventually abandoned Drizzle, but continued on with React. React Drizzle-React was not fully compatible with MetaMask Muttniks! Muttniks is a pared down version of the Astro Ledger app, available here: https://github.com/tlazenka/muttniks To get started with Muttniks, head over to the ! The overall structure can be gleaned from the , and by drilling down into each service’s individual list of dependencies (note that some dependencies aren’t relevant to Muttniks, but were used by Astro Ledger). is a convenient tool that lets you package up all these fun little services so you can easily launch them together. cheat sheet docker compose file Docker compose Docker Compose Services app The main Scala app that sits atop Postgres. When the app is started, it runs the database migrations if needed with , and then from the resulting schema. A periodic task is scheduled with to query the blockchain with web3j and update the Postgres database. Flyway Slick generates the case classes Akka db/redis The Postgres/Redis databases. jobs The Clojure service that sits atop Redis. When started, it schedules a task with to periodically query the local Ethereum blockchain, and caches the results in Redis using . Quartzite Carmine sbt/lein Centos images that map sbt/ivy2/m2 directories to your local machine to speed up dependency downloads. truffle A Truffle service for compiling the Ethereum contract and running the tests. ganache A Ganache service used here for a local development blockchain. react The React version of the website. web3j A web3j image that includes the for generating code from the Truffle JSON artifacts. command line tools firefox A service with a Firefox browser plus MetaMask that you can access using VNC, you don’t want to install MetaMask in your own browser. Wrap-Up In case you are struggling for a reason why Muttniks needs to be on any blockchain… you are not alone in the universe. However, let’s suspend disbelief and say that the gray area of “ownership over the naming privileges of non-existing Soviet dogs long gone to the happy hunting ground in the sky” needs to be codified in some way… This vegetating llama could be vegetating on blockchain… Photo by Cheryl Strahl You can put literally anything countable on blockchain! is just one of needing a name… HD16620 many awesome stars We are really happy with how the framework runs and would love to hear about how Muttniks has helped you to put vegetating llamas on blockchain, or maybe adopt every single Amur Leopard on blockchain, or perhaps slam slowly slaloming snails… yes, on blockchain!!! If you are having any difficulty with your implementations, just radio for help. The would be happy to work with you — shoot an email to . Astro Ledger team groundcontrol@astroledger.org And if you just can’t get enough Muttniks, don’t forget to beam over to and try naming some blockchain stars! astroledger.org
