Skip to content
OpenBazaar 2.0 Server Daemon in Go
Go Python Other
Branch: master
Clone or download
placer14 Merge pull request #1682 from ozamiatin/master
Extract GETOrder behavior into unit testable method #1483
Latest commit e225593 Aug 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis Update the dll for Windows builds Jul 14, 2017
Godeps Merge in multiwallet changes Aug 16, 2019
api Extracted method core.GetOrder(), added unit test for it Aug 20, 2019
cmd Merge branch 'master' into resync Aug 9, 2019
core Fix 'exported method OpenBazaarNode.GetOrder should have comment or b… Aug 20, 2019
docs Bump version to v0.13.5 Aug 9, 2019
ipfs [#1626] Fix secio handshake to properly fallback to alt ID generation Jun 21, 2019
mobile Merge branch 'master' into resync Aug 9, 2019
net Merge remote-tracking branch 'origin/master' into mg-resend-order-msg… Aug 9, 2019
pb Merge remote-tracking branch 'origin/master' into mg-resend-order-msg… Aug 9, 2019
qa Remove usage of core.Node global and fix nits Aug 5, 2019
repo Bump version numbers in Migration025 Aug 17, 2019
schema Merge branch 'master' into resync Aug 9, 2019
storage gofmt project Mar 28, 2019
test [#1571] Update chat endpoints to use repo.APITime May 21, 2019
util first pass at separating order payment network message code from eth … Jul 15, 2019
vendor Merge in multiwallet changes Aug 16, 2019
wallet Update unit tests and fix nits Aug 5, 2019
.dockerignore [#1292] Dockerfile.dev: Use bitcoind 0.16.3; Install from requirement… Nov 12, 2018
.gitignore Add multiwallet constructor Aug 20, 2018
.golangci.yml Disable goimports linter Mar 29, 2019
.travis.yml Fix golangci-lint version in travis script Mar 29, 2019
CONTRIBUTING.md [doc] fix slack links Mar 6, 2019
Dockerfile CLEANUP: Tweak Dockerfile a little and add comments to make it clearer. May 3, 2019
Dockerfile.dev Update dev Docker to guarantee v1.2.0 protoc-gen-go Aug 1, 2019
LICENSE update year in license Oct 19, 2018
Makefile Remove arch requirement on make ios_framework task Oct 26, 2018
README.md Add a blurb about min Golang version Apr 11, 2019
build.sh Update project to use golang v1.11 Mar 29, 2019
deploy.sh BUILD: Make deploy.sh use build.sh. Aug 25, 2018
docker-compose.yml Dev Docker: Map service ports externally; Allow forked procs in delve May 1, 2018
openbazaard.go Fix publish lock in openbazaard.go Jul 23, 2019
package.json Bump version to v0.13.5 Aug 9, 2019
test_compile.sh Add multiwallet constructor Aug 20, 2018

README.md

openbazaar-go

banner OpenBazaar Server Daemon in Go

Build Status Coverage Status Go Report Card

This repository contains the OpenBazaar server daemon which handles the heavy lifting for the OpenBazaar desktop application. The server combines several technologies: A modified IPFS node, which itself combines ideas from Git, BitTorrent, and Kademlia. A lightweight wallet for interacting with several cryptocurrency networks. And a JSON API which can be used by a user interface to control the node and browse the network. Find the user interface for the server at github.com/OpenBazaar/openbazaar-desktop.

Table of Contents

Install

A typical install of OpenBazaar contains a bundle of the server daemon and user interface. If this is what you are looking for, you can find an installer at https://openbazaar.org/download. If you are looking to run the server daemon by itself or to contribute to development, see below for instructions.

Install Pre-built Packages

The easiest way to run the server is to download a pre-built binary. You can find binaries of our latest release for each operating system here.

Build from Source

To build from source you will need to have Go installed and properly configured. Detailed instructions for installing Go and openbazaar-go on each operating system can be found in the docs package.

Dependency Management

We use Godeps with vendored third-party packages.

IPFS Dependency

We are using a fork of go-ipfs in the daemon. The primary changes include different protocol strings to segregate the OpenBazaar network from the main IPFS network and an increased TTL on certain types of DHT data. You can find the full diff in the readme of the forked repo. The fork is bundled in the vendor package and will be used automatically when you compile and run the server. Note that you will still see github.com/ipfs/go-ipfs import statements instead of github.com/OpenBazaar/go-ipfs despite the package being a fork. This is done to avoid a major refactor of import statements and make rebasing IPFS much easier.

Updating

You can either pull in remote changes as normal or run go get -u github.com/OpenBazaar/openbazaar-go.

Usage

You can run the server with go run openbazaard.go start. Ensure you are using at least version 1.10 of Golang, otherwise you might get errors while running.

Options

Usage:
  openbazaard [OPTIONS] start [start-OPTIONS]

The start command starts the OpenBazaar-Server

Application Options:
  -v, --version                   Print the version number and exit

Help Options:
  -h, --help                      Show this help message

[start command options]
      -p, --password=             the encryption password if the database is encrypted
      -t, --testnet               use the test network
      -r, --regtest               run in regression test mode
      -l, --loglevel=             set the logging level [debug, info, notice, warning, error, critical]
                                  (default: debug)
      -f, --nologfiles            save logs on disk
      -a, --allowip=              only allow API connections from these IPs
      -s, --stun                  use stun on µTP IPv4
      -d, --datadir=              specify the data directory to be used
      -c, --authcookie=           turn on API authentication and use this specific cookie
      -u, --useragent=            add a custom user-agent field
      -v, --verbose               print openbazaar logs to stdout
          --torpassword=          Set the tor control password. This will override the tor password in
                                  the config.
          --tor                   Automatically configure the daemon to run as a Tor hidden service and
                                  use Tor exclusively. Requires Tor to be running.
          --dualstack             Automatically configure the daemon to run as a Tor hidden service IN
                                  ADDITION to using the clear internet. Requires Tor to be running.
                                  WARNING: this mode is not private
          --disablewallet         disable the wallet functionality of the node
          --disableexchangerates  disable the exchange rate service to prevent api queries
          --storage=              set the outgoing message storage option [self-hosted, dropbox]
                                  (default=self-hosted)
          --bitcoincash           use a Bitcoin Cash wallet in a dedicated data directory
          --zcash=                use a ZCash wallet in a dedicated data directory. To use this you must
                                  pass in the location of the zcashd binary.

Documentation

Documentation of the OpenBazaar protocol has not been formalized yet. If you would like to help, please reach out on Slack or via a new issue on GitHub.

openbazaar-go exposes an HTTP API which permits high-level interactions on the network and the internal wallet. Find the HTTP API documentation at https://api.docs.openbazaar.org.

Contributing

Contributions are definitely welcome! Please read the Contributing Guidelines before starting.

License

MIT.

You can’t perform that action at this time.