Git Product home page Git Product logo

bridge's Introduction

Storj Bridge

Build Status Coverage Status NPM GitHub license

Access the Storj network via simple REST API.

Running Your Own Bridge

If you're planning to run your own bridge in production, mainnet, there are several issues that need to be addressed before this use case will be better supported. The largest of the issues is that there are several manual processes that will need to be run including running monthly payouts to farmers as well as communicating with farmers to add a new "trusted key" for the bridge. Decentralized bridges is described in the Storj whitepaper (a.k.a Federated Bridges) and is an area of ongoing research. There are also several Storj Improvement Proposals to streamline these processes using Ethereum smart contracts.

Aside from those issues, running a bridge within a private network is currently an option as those will not be issues in that environment. Please see https://github.com/storj/storj-sdk and https://github.com/storj/integration for quick setup of an entire Storj network.

Quick Start

Install MongoDB, Git and Wget:

apt-get install mongodb redis-server git wget

Install NVM, Node.js and NPM:

wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.30.1/install.sh | bash
source ~/.profile
nvm install --lts

Clone the repository, install dependencies:

git clone https://github.com/Storj/bridge.git && cd bridge
npm install && npm link

Start the server (set the NODE_ENV environment variable to specify the config):

NODE_ENV=develop storj-bridge

Note: Storj Bridge cannot communicate with the network on it's own, but instead must communicate with a running Storj Complex instance.

This will use the configuration file located at ~/.storj-bridge/config/develop.json.

Windows

Install utilizing automated script

https://github.com/Storj/storj-automation/archive/master.zip

The default configuration can be modified as needed. It is located at

%USERPROFILE%\.storj-bridge\config

Edit production in notepad/wordpad. For more information, see the documentation.

License

Storj Bridge - Access The Storj Network via REST Interface
Copyright (C) 2017 Storj Labs, Inc

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Terms

This software is released for testing purposes only. We make no guarantees with respect to its function. By using this software you agree that Storj is not liable for any damage to your system. You also agree not to upload illegal content, content that infringes on other's IP, or information that would be protected by HIPAA, FERPA, or any similar standard. Generally speaking, you agree to test the software responsibly. We'd love to hear feedback too.

bridge's People

Contributors

braydonf avatar bookchin avatar bryanchriswhite avatar dylanlott avatar phutchins avatar pgerbes1 avatar cpollard1001 avatar barbaraliau avatar navillasa avatar littleskunk avatar gordonwritescode avatar aleitner avatar super3 avatar niahmiah avatar kaloyan-raev avatar computeronix avatar galumphingcallooh avatar jkawamoto avatar him2him2 avatar nutterzuk avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.