{"id":13590753,"url":"https://github.com/rule110-io/surge","last_synced_at":"2025-04-08T14:31:38.616Z","repository":{"id":37209077,"uuid":"278167364","full_name":"rule110-io/surge","owner":"rule110-io","description":"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.","archived":false,"fork":false,"pushed_at":"2023-06-15T13:35:04.000Z","size":36315,"stargazers_count":438,"open_issues_count":19,"forks_count":50,"subscribers_count":13,"default_branch":"development","last_synced_at":"2025-04-04T16:51:12.237Z","etag":null,"topics":["anonymity","decentralized","file-sharing","nkn","p2p","privacy"],"latest_commit_sha":null,"homepage":"https://getsurge.io","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rule110-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-07-08T18:38:27.000Z","updated_at":"2025-04-04T16:40:48.000Z","dependencies_parsed_at":"2024-01-14T04:07:56.633Z","dependency_job_id":null,"html_url":"https://github.com/rule110-io/surge","commit_stats":null,"previous_names":["rule110-io/surge-ui"],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rule110-io%2Fsurge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rule110-io%2Fsurge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rule110-io%2Fsurge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rule110-io%2Fsurge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rule110-io","download_url":"https://codeload.github.com/rule110-io/surge/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247860671,"owners_count":21008331,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anonymity","decentralized","file-sharing","nkn","p2p","privacy"],"created_at":"2024-08-01T16:00:50.178Z","updated_at":"2025-04-08T14:31:37.594Z","avatar_url":"https://github.com/rule110-io.png","language":"Go","funding_links":[],"categories":["Go","privacy"],"sub_categories":[],"readme":"\n![](https://github.com/rule110-io/surge/blob/development/documentation/img/surge_color.png?raw=true) \n# Surge - P2P on steroids (...and NKN)\n\n\n## About\nThis 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.  \n\n## Anonymous P2P? Are you kidding me?!\nNo, we are not :) \nBy 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: \n\n![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)\n\n![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)\n\n## Where to download?\nFind the current version for your operation system [here](https://github.com/rule110-io/surge/releases)\n\n\n## Wanna build Surge on your own?\n\nBesides using our pre-built executables you can build surge by your own.\n\nPrerequisites:\n- A running Golang environment\n- A running [WailsV2](https://wails.io/docs/gettingstarted/installation/) environment\n- Node.JS \u003e 19.4\n\n1. clone this repository in your go projects\n2. Build the frontend\n    1. ``cd frontend/``\n    2. ``npm install``\n    3. ``npm run build``\n2. Build the app in the root directory of the repository: ``wails build`` (for cross-build instructions refer to the wails doc)\n3. check the ``build`` directory\n\nOther helpful commands\n\n``` bash\n# start surge backend\n$ wails serve\n\n# start surge frontend\n$ cd frontend\n$ npm run serve\n```\n\nFor detailed explanation on how things work, checkout [Wails docs](https://wails.app/gettingstarted/).\n\n## Contribute\n\nSurge 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)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frule110-io%2Fsurge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frule110-io%2Fsurge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frule110-io%2Fsurge/lists"}