README
¶
Frontier
Frontier is the client facing API server for the DigitalBits ecosystem. It acts as the interface between digitalbits-core and applications that want to access the DigitalBits network. It allows you to submit transactions to the network, check the status of accounts, subscribe to event streams, etc. See an overview of the DigitalBits ecosystem for more details.
Downloading the server
Prebuilt binaries of frontier are available on the releases page.
See the old releases page for prior releases
| Platform | Binary file name |
|---|---|
| Mac OSX 64 bit | frontier-darwin-amd64 |
| Linux 64 bit | frontier-linux-amd64 |
| Windows 64 bit | frontier-windows-amd64.exe |
Alternatively, you can build the binary yourself.
Dependencies
Frontier requires go 1.6 or higher to build. See (https://golang.org/doc/install) for installation instructions.
Building
glide is used for building frontier.
Given you have a running golang installation, you can install this with:
curl https://glide.sh/get | sh
Next, you must download the source for packages that frontier depends upon. From within the project directory, run:
glide install
Then, simply run go install github.com/digitalbitsorg/go/services/frontier. After successful
completion, you should find frontier is present in your $GOPATH/bin directory.
More detailed intructions and admin guide.
Developing Frontier
Contributing
Please see the CONTRIBUTING.md for details on how to contribute to this project.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
actions
Package actions provides the infrastructure for defining and executing actions (code that is triggered in response to an client request) on frontier.
|
Package actions provides the infrastructure for defining and executing actions (code that is triggered in response to an client request) on frontier. |
|
assets
Package assets is a simple helper package to help convert to/from xdr.AssetType values
|
Package assets is a simple helper package to help convert to/from xdr.AssetType values |
|
codes
Package codes is a helper package to help convert to transaction and operation result codes to strings used in frontier.
|
Package codes is a helper package to help convert to transaction and operation result codes to strings used in frontier. |
|
context/requestid
Package requestid provides functions to support embedded and retrieving a request id from a go context tree
|
Package requestid provides functions to support embedded and retrieving a request id from a go context tree |
|
db2
Package db2 is the replacement for db.
|
Package db2 is the replacement for db. |
|
db2/core
Package core contains database record definitions useable for reading rows from a digitalbits Core db
|
Package core contains database record definitions useable for reading rows from a digitalbits Core db |
|
db2/history
Package history contains database record definitions useable for reading rows from a the history portion of frontier's database
|
Package history contains database record definitions useable for reading rows from a the history portion of frontier's database |
|
db2/sqx
Package sqx contains utilities and extensions for the squirrel package which is used by frontier to generate sql statements.
|
Package sqx contains utilities and extensions for the squirrel package which is used by frontier to generate sql statements. |
|
ingest
Package ingest contains the ingestion system for frontier.
|
Package ingest contains the ingestion system for frontier. |
|
ingest/participants
Package participants contains functions to derive a set of "participant" addresses for various data structures in the DigitalBits network's ledger.
|
Package participants contains functions to derive a set of "participant" addresses for various data structures in the DigitalBits network's ledger. |
|
ledger
Package ledger provides useful utilities concerning ledgers within digitalbits, specifically as a central location to store a cached snapshot of the state of both frontier's and digitalbits-core's views of the ledger.
|
Package ledger provides useful utilities concerning ledgers within digitalbits, specifically as a central location to store a cached snapshot of the state of both frontier's and digitalbits-core's views of the ledger. |
|
log
Package log provides the logging facilities used for frontier.
|
Package log provides the logging facilities used for frontier. |
|
paths
Package paths provides utilities and facilities for payment paths as needed by frontier.
|
Package paths provides utilities and facilities for payment paths as needed by frontier. |
|
reap
Package reap contains the history reaping subsystem for frontier.
|
Package reap contains the history reaping subsystem for frontier. |
|
render/sse
This package contains the Server Sent Events implementation used by frontier.
|
This package contains the Server Sent Events implementation used by frontier. |
|
resource
Package resource contains the type definitions for all of frontier response resources.
|
Package resource contains the type definitions for all of frontier response resources. |
|
simplepath
Package simplepath provides an implementation of paths.Finder that performs a breadth first search for paths against a digitalbits-core's database
|
Package simplepath provides an implementation of paths.Finder that performs a breadth first search for paths against a digitalbits-core's database |
|
test
Package test contains simple test helpers that should not have any dependencies on frontier's packages.
|
Package test contains simple test helpers that should not have any dependencies on frontier's packages. |
|
test/db
Package db provides helpers to connect to test databases.
|
Package db provides helpers to connect to test databases. |
|
test/trades
Common infrastructure for testing Trades
|
Common infrastructure for testing Trades |
|
txsub
Package txsub provides the machinery that frontier uses to submit transactions to the digitalbits network and track their progress.
|
Package txsub provides the machinery that frontier uses to submit transactions to the digitalbits network and track their progress. |
|
txsub/results/db
Package results provides an implementation of the txsub.ResultProvider interface backed using the SQL databases used by both digitalbits core and frontier
|
Package results provides an implementation of the txsub.ResultProvider interface backed using the SQL databases used by both digitalbits core and frontier |
|
txsub/sequence
Package sequence providers helpers to manage sequence numbers on behalf of frontier clients.
|
Package sequence providers helpers to manage sequence numbers on behalf of frontier clients. |
|
utf8
Package utf8 contains utilities for working with utf8 data.
|
Package utf8 contains utilities for working with utf8 data. |
Click to show internal directories.
Click to hide internal directories.