https://github.com/rule110-io/surge

Surge is a p2p filesharing app designed to utilize blockchain technologies to enable 100% anonymous file transfers. Surge is end-to-end encrypted, decentralized and open source.
https://github.com/rule110-io/surge

anonymity decentralized file-sharing nkn p2p privacy

Last synced: about 2 months ago
JSON representation

Surge is a p2p filesharing app designed to utilize blockchain technologies to enable 100% anonymous file transfers. Surge is end-to-end encrypted, decentralized and open source.

• Host: GitHub
• URL: https://github.com/rule110-io/surge
• Owner: rule110-io
• License: apache-2.0
• Created: 2020-07-08T18:38:27.000Z (about 4 years ago)
• Default Branch: development
• Last Pushed: 2023-06-15T13:35:04.000Z (over 1 year ago)
• Last Synced: 2024-06-18T18:42:25.895Z (3 months ago)
• Topics: anonymity, decentralized, file-sharing, nkn, p2p, privacy
• Language: Go
• Homepage: https://getsurge.io
• Size: 34.6 MB
• Stars: 413
• Watchers: 14
• Forks: 48
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

![](https://github.com/rule110-io/surge/blob/development/documentation/img/surge_color.png?raw=true) 

# Surge - P2P on steroids (...and NKN)

## About

This is the code of [Surge](https://getsurge.io). Surge is a 100% decentralized and secure P2P file sharing client. It utilizes the [NKN blockchain network](https://nkn.org) to send, publish and receive files.  

## Anonymous P2P? Are you kidding me?!

No, we are not :) 

By completely bypassing current internet technologies and using the NKN network each client is identified by an ID and nothing more. Here are some skribbles to show you how it all works: 

![When sending a file through the NKN network the sender just needs to contact one NKN node and tell him to what client the file should be delivered to. To communicate the IP is still needed but instantly dropped by the entry node.](https://github.com/rule110-io/surge/blob/development/documentation/img/surge1.png?raw=true)

![NKN now routes the file through its network using the optimal an fastest route to the client. If there is a client who is connected to the recipient it delivers the file to it.](https://github.com/rule110-io/surge/blob/development/documentation/img/surge2.png?raw=true)

## Where to download?

Find the current version for your operation system [here](https://github.com/rule110-io/surge/releases)

## Wanna build Surge on your own?

Besides using our pre-built executables you can build surge by your own.

Prerequisites:

- A running Golang environment

- A running [WailsV2](https://wails.io/docs/gettingstarted/installation/) environment

- Node.JS > 19.4

1. clone this repository in your go projects

2. Build the frontend

    1. ``cd frontend/``

    2. ``npm install``

    3. ``npm run build``

2. Build the app in the root directory of the repository: ``wails build`` (for cross-build instructions refer to the wails doc)

3. check the ``build`` directory

Other helpful commands

``` bash

# start surge backend

$ wails serve

# start surge frontend

$ cd frontend

$ npm run serve

```

For detailed explanation on how things work, checkout [Wails docs](https://wails.app/gettingstarted/).

## Contribute

Surge is an open source project so everyone is invited and welcome to help. If you want to get in contact with us just jump into the [NKN Discord](https://discord.gg/hAxzRUV7DN)