Be notified of new releases
Create your free GitHub account today to subscribe to this repository for new releases and build software alongside 40 million developers.Sign up
This release contains only very few changes to Holoscape itself
- CMD+Q on macOS now works without errors
- It shows a pop-up dialog if binaries are missing (which was a common pitfall when running Holoscape from source)
- The instance storage back-end can now be chosen when installing hApps (which is a conductor config setting per instance)
- A memory-leak got fixed
- The instance debug view is much more responsive and displays new available data from the conductor such as the DHT holding queue
There are major improvements to the included Holochain conductor
which is now at version 0.0.40-alpha-1.
- Lots of deadlocks have been fixed and thread-handling in general was revamped
- Several performance optimisations have been implemented
This release is much more stable and uses much less system resources (memory/CPU)!
Updating from an old version
If you ran v0.0.3-alpha before which included an older conductor version, you will probably see this panic in the log when trying to start the new version without clearing the config:
thread 'main' panicked at 'could not load DhtStoreSnapshot from content: SerializationError("missing field `holding_map` at line 1 column 410")', src/libcore/result.rs:1051:5 stack backtrace: 0: 0x55f0b75bf08b - backtrace::backtrace::libunwind::trace::hd4effc5cbc99af65 at /cargo/registry/src/github.com-1ecc6299db9ec823/backtrace-0.3.29/src/backtrace/libunwind.rs:88 1: 0x55f0b75bf08b - backtrace::backtrace::trace_unsynchronized::h389cccb5967fa3c2 at /cargo/registry/src/github.com-1ecc6299db9ec823/backtrace-0.3.29/src/backtrace/mod.rs:66 ....
Despite the error, you can open the Holoscape menu by clicking the system tray icon and then choosing:
Reveal config directory and then delete that old directory and start with a fresh installation.
- Switching between UIs added (used by Peer Chat when switching to Identity Manager UI)
- Reference Sim2h blog post in network configuration dialog
- Update conductor to v0.0.36-alpha1
- Minor UI improvements
This release is a major step in terms of usability of the full Holochain stack. It includes a Holochain conductor v0.0.34-alpha which introduces a fully working sim2h test network implementation. Since Holochain now has two working (test/alpha) network implementations, this Holoscape version introduces a network selection dialog that lets the user choose between sim1h and sim2h (and later lib3h) on first use.
Network selection dialog
Included in this release is a default network configuration which is set to our pre-alpha public test server of sim2h.
This early version of our sim2h switch-board simulation is made available mainly for real-world testing of the network itself. For that purpose, all messages going through this central point are getting logged for debugging and performance analysis.
Though this early test version of our sim2h switch-board simulation comes with no guarantee of up-time, it enables first real-world and full-stack test runs of hApps. With this release we invite every hApp developer to help us test it all by deploying their hApps with Holoscape and engage in real-world, networked Holochain app usage!
Integrated alpha hApp store
This release also introduces an alpha version of a hApp store that is based on our happ-index repository. hApps can easily be published through a pull-request on that repository. Holoscape renders a list of all hApps included in that index and provides an easy and simple way for installing them.
Lots of bug fixes / small improvements
- Install logic makes sure interface ports are not assigned twice
- Several timing issues during boot process fixed that lead to crashes or hidden error messages
- File paths in hApp bundles work in all cases now
- hApp UIs are initialized with path
/index.htmlwhich fixes JS router issues
- Splash screen shows conductor log in the background during boot
- If conductor is not booted after 1 minute, Holoscape opens the log window to enable debugging\
Holoscape pre-alpha 0.0.1
It includes everything needed as an MVP for the automatic install of hApps from bundles with just a few clicks.
But it also includes some pre-alpha bugs and UX quirks. Such as:
- If there is a conductor running already listening on the same ports, the started conductor will bail and Holoscape will wait during splash screen forever. If it doesn't start, make sure there is no old zombie conductor running. If that doesn't help, try starting it from command line so you can see the conductor output.
- If a bundle references resources via HTTP URI, Holoscape will download the file during install. If the network connection is flaky, it won't try again but show an error during install process.
- many more that are still unknown
This first release is for a first test roll-out, mainly targeted at Holochain/Holo teams.
Everybody is welcome to try this and provide feedback through issues, pull-request and all other means!
What to do with it?
Download the app bundle for your platform, unzip it and run the executable in there (double click
Holoscape.app on macOS or run the
Holoscape executable on Linux).
After the splash screen, there will be a Holoscape icon in the system tray.
Download the example hApp bundle
personas-and-chat_bundle.zip, and unzip it.
Choose "Install hApp..." from the Holoscape system tray menu. In the new window click browse and select the file
chat.toml from the unziped
personas-and-chat_bundle.zip. The dialog will now show the contents and immediately starts downloading the two DNAs which are referenced via HTTP link the bundle. Once the download is complete, the green "Install" button at the bottom will get enabled and you can install the bundle by clicking it. If this is your first time installing a DNA and agent, a popup will appear and ask for a passphrase. Remember the passphrase you enter as it will request the same again on next start up in order to unlock the agent keys. The whol install process will take about a 1 minute (mostly because hashing the password and creating and encrypting new keys takes some time).
After the install process is complete, you will find two new hApps in the "hApps" sub-menu of the Holoscape system tray menu:
- Basic Chat
Both items can be clicked to show the according hApp UI.
Debugging with Holoscape
|-> Conductor Run-Time
|-> Debug View
You see a list of all running instances.
- Click one of those names to expand
- Use the hApp while having the debug view opened
- You will see "Core actions" getting populated with little pills representing actions
- Click on one of those actions to see its parameters (like which zome function was called with a SignalZomeFunctionCall)
- Click "Source Chain" to see all the source chain entries of that instance