Help Topics for DappRunner.com
Contents

DappRunner Directory
Overview
MetaMask
Running a Dapp
Searching and Sorting
Show our User Interfaces on Your Website
Add Your Dapp to the Directory
Disable or Enable Your Dapp

Event Log Explorer
Overview
Selecting Event Logs
Searching, Sorting, and Summing
Show Distinct Entries (for Sort Field)
Select Initial Dapp
Save Parameters to Short URL
Search Ether Transactions

DappRunner Directory
Overview

DappRunner is an open-source protocol which allows any Dapp to be displayed in a customized user interface. The DappRunner Directory contains a collection of Dapps that have been submitted to the DappRunner Ethereum Contract.

Here are a few reasons that it is easier to run a Dapp from DappRunner, as compared to Etherscan or Solidity:
  • See which function to run: Instead of displaying a list of functions with cryptic names, each DappRunner Entry shows just one function, with a customized description.
  • See how to enter the function's parameters: Each input parameter may contain a Customized Caption and Default Value, so you know the type of data that should be entered.
  • See a list of links that pertain to the Dapp: Each entry may contain up to four links, which may show the current contents of the Dapp's contract.
  • See the transaction fee: The Dapp's Gas Limit and the current Gas Price are used to display the approximate fee, before you send the transaction.

You may easily display the DappRunner Directory on your own website, and add Entries by completing a short form here.


MetaMask

The MetaMask Chrome Extension must be installed and enabled, and you must have an Ether balance in the Network that a Dapp is configured for (Main, Ropsten, or Rinkeby). Ropsten and Rinkeby are "test-nets", which have "faucets" that allow you to receive free tokens.


Running a Dapp

The Selected Dapp is displayed beneath the Directory. You may select a Dapp by clicking a Dapp Title in the first column of the Directory.

If MetaMask is not set to the Network shown for the selected Dapp, a message will indicate that you must use MetaMask to change the Network.

Otherwise, the Selected Dapp will be shown. To run the Dapp, complete the entry fields (on the left side of the page), and click [Send Transaction]. If your entries are accepted by the Dapp's Ethereum contract, the MetaMask Notification popup will be shown, allowing you to review the information before submitting the transaction.


Searching and Sorting

You may Filter the list of entries that are displayed in the Directory, by selecting Filter Field #1 and/or Filter Field #2 from the dropdown boxes, and entering Filter Criteria into the textbox to the right of each Filter Field dropdown box. You can select just one Filter, or both.

The Filter Criteria does not have to contain all the characters in the selected Filter Field. For example, if you entered 'mid' as the Filter Criteria, entries containing 'mid' anywhere in the selected Filter Field would be retrieved.

You may begin a search by clicking [Apply Filters], or by pressing [Enter] when the cursor is in either Filter Criteria textbox.

Sort: You may Sort the entries that are shown on the grid, by selecting a Sort Field from the dropdown box, and indicating Ascending or Descending in the Sort Order dropdown box.


Show our User Interfaces on Your Website

Our User Interfaces are open-source. The following instructions will allow you to display our User Interfaces on your website:
  1. Right-click on the lower portion of the website, and select [View frame source].
  2. When the Source Code is displayed, right-click it, select [Save as...], and save the file with an .htm extension.
  3. In the .htm file that you just saved, replace the characters after .infura.io/v3/ with your Infura Project ID.
  4. Right-click each of the three .js files that are shown at the top of the source code, click [Save link as...], and save each file with the same .js name that is shown.
  5. Upload the four files that you saved (the .htm file, and the three .js files) to your website.

Add Your Dapp to the Directory

IMPORTANT: Your MetaMask Network must be set to Main, to perform the following instructions.

The following webpage will allow you to add your Dapp to the DappRunner Directory:
https://www.DappRunner.com/add.php

That webpage will guide you through 3 Steps to add your Dapp to the Directory. These are the only required fields:
  • Network (select Main, Ropsten, or Rinkeby from a dropdown box)
  • Contract Address
  • Dapp Title
  • Description
  • Action Function (select from a dropdown box)
  • Test Values (which will allow a simulated transaction to successfully complete)

Although the following fields are optional, it is recommended that you complete some of them, because it will make your Dapp's User Interface easier to use:
  • Variables Function
  • Custom Captions
  • Default Values
  • URL Links

Disable or Enable Your Dapp

IMPORTANT: Your MetaMask Network must be set to Main, to perform the following instructions.

If you added a Dapp to the Directory (i.e. if your Ethereum address is the Creator address), then a button labeled [Disable] will be displayed in the Creator column.

Clicking the [Disable] button will display a MetaMask Notification popup, allowing you to confirm the transaction.

When your Dapp has been Disabled, it will not be displayed in the Directory to anyone but you. When you display your Disabled Dapp in the Directory, an [Enable] button will be displayed in the Creator column. Clicking the [Enable] button will reverse the [Disable] action, so your Dapp will then be displayed in the Directory to all users.

Event Log Explorer
Overview

This feature can be displayed by clicking the Event Log Explorer link on the upper-right corner of the home page, or by clicking this link: Event Log Explorer

This webpage retrieves data from Event Logs in the Ethereum Blockchain. The 30 most active Dapps are shown in a dropdown box, or you can enter any other Dapp Contract Address.

The data is displayed in a grid that can be Sorted by an field, and Searched by any two fields. You may also enter a Time Span, from 'One Hour' to 'All Days'.

Display the Sum of any field. For example, calculate the total deposits for any ether address.

Save the parameter settings to a short URL, so you can easily reload the same settings.


Selecting Event Logs

The 30 most Active Dapps are shown in the Dapp dropdown box. When a Dapp is selected, the Event dropdown box contains the Events that are exported by the selected Dapp.

To see Events for Dapps that are not shown in the Dapp dropdown box, enter an Address in the New Dapp Contract Address textbox, and press [Enter] (or click [Display New Dapp]). You must then select an Event from the Event dropdown box, before Event Logs will be displayed.

Time Span: The Time Span dropdown box allows you to select the earliest date/time that Event Logs are retrieved.

A maximum of 1,000 Event Logs are displayed for each search, so if you select a large Time Span, all the Event Logs may not be displayed. If you select a small Time Span, then sometimes no Event Logs will be displayed. For example, if you select 1 Hour, then no Event Logs will be shown unless they occurred in the past hour.


Searching, Sorting, and Summing

You may Filter the list of Event Logs that are displayed, by selecting Filter Field #1 and/or Filter Field #2 from the dropdown boxes, and entering Filter Criteria into the textbox to the right of each Filter Field dropdown box. You can select just one Filter, or both.

The Filter Criteria does not have to contain all the characters in the selected Filter Field. For example, if you entered '834' as the Filter Criteria, Event Logs containing '834236762' or '000834' in the selected Filter Field would be retrieved.

You may begin a search by clicking [Apply Filters], or by pressing [Enter] when the cursor is in either Filter Criteria textbox.

Range of Dates: The Filter Criteria #1 textbox may contain a Range of Dates, separated by a hyphen. For example, "01/10/19-01/15/19" will retrieve Event Logs that are Dated on or after 01/10/19, and on or before 01/15/19.

Sort Event Logs: You may Sort the Event Logs that are shown on the grid, by selecting a Sort Field from the dropdown box, and indicating Ascending or Descending in the Sort Order dropdown box.

Show the Sum of any Field: You may Sum the Event Logs that are shown on the grid, by selecting a Sum Field from the dropdown box. The Total of all numeric values in the selected field will be shown to the right of the Sum Field dropdown box.


Show Distinct Entries (for Sort Field)

Clicking this button will display an overlay frame which lists the Distinct Entries for the field selected in the [Sort Field] dropdown box, and a Count for each entry.

For example, if a field named 'account' is selected in the [Sort Field] dropdown box, then you will see how many Event Logs Entries each user created. This feature allows you to see which users are performing the majority of a Dapp's actions.

If the [Sort Field] dropdown box is set to 'Date/Time', then the Distinct Entries will show you how many Event Logs occurred on each Date.


Select Initial Dapp

You may select the Dapp that is initially used by this website, by adding one of the following two parameters to the website's URL:

Save Parameters to Short URL

You may save the settings of all parameters to a short URL, so you can easily reload the same settings.

Click the [Save] button (on the upper-right portion of the page), and an overlay frame will display the short URL. Click in that textbox, and you can copy the short URL to the clipboard (by pressing [Ctrl+C]).


Search Ether Transactions

These features can be displayed by clicking this link: Search Ether Transactions

When the Search Ether Transactions home page is displayed, enter an Ether Address and click [Search Transactions].

This module has the same Sort, Filter, Sum, and Save features as the Event Logs module, which were previously described in this Help file.

Micro Token: Most Tokens use the Wei numeric system, which is: 1000000000000000000 units = 1 Token.
However, some Tokens use the Micro numeric system, which is: 1000000 units = 1 Token.

The Sum Field dropdown box allows you to select between these two numeric systems.

If the [Token Value] column contains all zeroes, then select Micro Token in the Sum Field dropdown box.