endojs/exo

A Personal Ledger for managing ERights and Object Capabilities (ocaps)

Agoric's Pledger - Pluggable, Personal, Promise-based Ledger

NOTE: Experimental and certainly not ready for production!

This is a graphical desktop app that manages the Agoric client, on Linux, MacOS, or Windows.

Documentation for the Electron Forge system that Pledger currently uses is at https://electronforge.io

Running on your platform

You can try out the current UI by running:

yarn install
yarn build
cd packages/app-electron
yarn start

Packaging the application for your platform

yarn package

Creating installers for your platform

Note that the installers for MacOS and Windows currently depend on application signing keys that only exist on my (@michaelfig) build machine. Changing this dependencies is possible in the packages/app-electron/package.json.

To create the installers from the previous packaging, run:

export SNAPCRAFT_BUILD_ENVIRONMENT=host # Needed under Linux VMs that can't nest VMs
yarn make --skip-package

Omit --skip-package if you want to package and create the installers in the same step.

Publishing installers for this platform

In order to do a release, you should bump the packages/app-electron/package.json version. Then do the following and test the installers in the packages/app-electron/out/ directory.

# Create a publishing bundle
yarn publish:electron --dry-run

After you're content with the installers for each platform, you should publish to Github. The next step currently needs the $GITHUB_TOKEN for https://github.com/agoric-labs/Pledger in order to create release artifacts.

# Push the bundle to the publishers
yarn publish:electron --from-dry-run

Publishing Snaps

NOTE: For now, you will have to manually do:

snapcraft upload --release=beta out/make/pledger-*.snap

We'd like to use the following:

{
  "name": "@electron-forge/publisher-snapcraft",
  "config": {
    "release": "beta"
  }
}

but first we need a solution to: https://github.com/davidwinter/electron-forge-maker-snap/issues/38

exo's Issues

Port to Windows (non-WSL)

Obvious button to launch agoric open

Start Agoric ag-solo by default

Confusing on first launch

I downloaded the .dmg to my mac and double clicked on it. IIRC, the first time I did not see a window appear and the additional icon in the upper right of my mac toolbar (which I now know to call the "system tray") was too subtle for me to notice. The second time I did see a window that looked like the following screenshot:

When I clicked on the AGORIC icon in the upper left corner it took me to the agoric.com home page rendered in this window but without any way to get back that I could find. I then closed the window and relaunched the app, still not having noticed the icon in the system tray.

Without reading it, the text shown on that screenshot has the look of debug output for a developer to read, not for a user to read, so I didn't read it until @michaelfig verbally suggested I should.

It suggests a URL to use to go the the right channel within Discord. However the link text is not clickable. Trying to select-copy it was somewhat frustrating because it was still scrolling while I was trying to select.

Finally copying the URL and pasting it into my browser, Discord complained about an invalid invitation. Finally @michaelfig verbally instructed me to go to the Agoric discord faucet channel and paste the text that my pledger window suggested I paste into discord. Being right there, @michaelfig approved it promptly and everything since then worked beautifully.

If @michaelfig had not been there and the approval process had taken awhile, I don't know if I would have understood that I'm waiting for human action rather than the software being stuck.

Create installation instructions

The zip file probably only works on Ubuntu 20.04 and later. Please use the snap version instead.

We need documentation for how to install on each platform. I'll make an issue.

Originally posted by @michaelfig in #8 (comment)

System tray icon needs more contrast

Screenshot of my Mac systems tray. The barely visible icon on the far left is pledger

I suggest that some of the background be white rather than transparent.

GLIBC_2.28 not found on Ubuntu linux 18.04.5 LTS

I grabbed the current release for linux, unzipped it, ran ./pledger... the systray icon comes up, but when I choose "Pledger Dashboard..." I get:

/home/connolly/Desktop/Pledger-linux-x64/resources/app/node_modules/@pledger/plugin-agoric-app/node_modules/node-lmdb/index.js:1
Error: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.28' not found (required by /home/connolly/Desktop/Pledger-linux-x64/resources/app/node_modules/@pledger/plugin-agoric-app/node_modules/node-lmdb/build/Release/node-lmdb.node)
    at process.func [as dlopen] (electron/js2c/asar_bundle.js:5:1812)
    at Object.Module._extensions..node (internal/modules/cjs/loader.js:1203:18)
    at Object.func [as .node] (electron/js2c/asar_bundle.js:5:1812) 
Exited 1

when I choose "Open Agoric Wallet" I get ERR_CONNECTION_REFUSED.

Release 18.04.5 LTS (Bionic Beaver) 64-bit

$ uname -a
Linux jambox 4.15.0-135-generic #139-Ubuntu SMP Mon Jan 18 17:38:24 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux

Redirect ag-solo output to logs