Difference between revisions of "Channels/Setup"

From Snowblossom Wiki
Jump to: navigation, search
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
==Windows==
  
==JVM==
+
Download the latest installer from:
  
For windows, you'll need a modern 64-bit Java. It will work with anything greater than 8, however it was only in 10 or 11 that the OS UI scaling was respected so if you have a high resolution display you'll want newer.  64-bit is required.
+
    https://snowblossom.org/msi/index.html
  
For Windows and macOS, java can be downloaded here:
+
Certain cryptographic features only work with OpenJRE rather than Oracle JRE.  The installers above have a built in OpenJRE.
  
[https://www.oracle.com/technetwork/java/javase/downloads/jdk13-downloads-5672538.html JDK13 Download]
+
==Linux/MacOS/Other==
 
 
For linux, you probably want the openjdk from your package manager.
 
 
 
==Download==
 
  
 
The Channels GUI includes all the Snowblossom [[IceLeaf]] client features with additional Channels features.  It can run a full node or act as a light client using other full nodes for blockchain data.  It supports creating wallets, sending and receiving.
 
The Channels GUI includes all the Snowblossom [[IceLeaf]] client features with additional Channels features.  It can run a full node or act as a light client using other full nodes for blockchain data.  It supports creating wallets, sending and receiving.
Line 30: Line 27:
 
The short version is, the ChannelIceLeaf node includes a SOCKS5 proxy, answering by default on port 1080.  That proxy will relay normal connections as you would expect from a proxy.  However, it takes any connections to *.snowblossom.io and directs them to the HTTP port of the ChannelIceLeaf node.
 
The short version is, the ChannelIceLeaf node includes a SOCKS5 proxy, answering by default on port 1080.  That proxy will relay normal connections as you would expect from a proxy.  However, it takes any connections to *.snowblossom.io and directs them to the HTTP port of the ChannelIceLeaf node.
  
[[File:Channels_proxy_firefox.png|upright=0.2|Firefox Network Settings]]
+
Here are the network settings for Firefox:
 +
 
 +
[[File:Channels_proxy_firefox.png|800px|Firefox Network Settings]]
 +
 
 +
Note the "Proxy DNS when using SOCKS v5", that is critical.
 +
 
 +
It is best to use this with a browser you don't use all the time, since these setting will send all of your traffic from that browser through your channel node, which should be fine but it will require you to have your node running for any browsing to work.
 +
 
 +
We are working on a Chrome extention to proxy only *.snowblossom.io, but it isn't don't yet:
 +
 
 +
https://github.com/snowblossomcoin/channels-chrome-extension
 +
 
 +
==Test==
 +
 
 +
http://05ts48m42unzgad437876g57lgtw4ucdav9zvsjp.snowblossom.io/
 +
 
 +
OR
 +
 
 +
http://hello.snowblossom.io/
 +
 
 +
 
 +
You should first see an item not found error as your node syncs the channel.  Then a few seconds later, refresh and see the Success message.
 +
 
 +
Come say hello on the chat server:
 +
 
 +
http://longchat.snowblossom.io/

Latest revision as of 05:32, 15 September 2020

Windows

Download the latest installer from:

   https://snowblossom.org/msi/index.html

Certain cryptographic features only work with OpenJRE rather than Oracle JRE. The installers above have a built in OpenJRE.

Linux/MacOS/Other

The Channels GUI includes all the Snowblossom IceLeaf client features with additional Channels features. It can run a full node or act as a light client using other full nodes for blockchain data. It supports creating wallets, sending and receiving.

Download file from:

   https://snowblossom.org/jars/ChannelIceLeaf_deploy.jar

Run that jar file. In most systems, just click on it until something happens.


Proxy

Why

Your channels node will act as a gateway to whatever channels you access with it. The channels you access will likely be written and maintained by different folks, so in browser terms they are different sites. The browser expects different sites with different permissions to be on different host names. This is how the browser knows that Javascript from one site is not allowed to call API methods on another site. However, as far as the browser is concerned, there is one host for the sites, which is the node you downloaded above. So we need to do something to let the browser understand that each channel is a different site and they do not trust each other.

Settings

The short version is, the ChannelIceLeaf node includes a SOCKS5 proxy, answering by default on port 1080. That proxy will relay normal connections as you would expect from a proxy. However, it takes any connections to *.snowblossom.io and directs them to the HTTP port of the ChannelIceLeaf node.

Here are the network settings for Firefox:

Firefox Network Settings

Note the "Proxy DNS when using SOCKS v5", that is critical.

It is best to use this with a browser you don't use all the time, since these setting will send all of your traffic from that browser through your channel node, which should be fine but it will require you to have your node running for any browsing to work.

We are working on a Chrome extention to proxy only *.snowblossom.io, but it isn't don't yet:

https://github.com/snowblossomcoin/channels-chrome-extension

Test

http://05ts48m42unzgad437876g57lgtw4ucdav9zvsjp.snowblossom.io/

OR

http://hello.snowblossom.io/


You should first see an item not found error as your node syncs the channel. Then a few seconds later, refresh and see the Success message.

Come say hello on the chat server:

http://longchat.snowblossom.io/