mirror of
https://github.com/fullstack-cash/bch-api.git
synced 2026-09-22 17:22:04 -07:00
Merge pull request #55 from Permissionless-Software-Foundation/ct-unstable
Updating README
This commit is contained in:
@@ -1,19 +1,12 @@
|
|||||||
# bch-api
|
# bch-api
|
||||||
|
|
||||||
|
This is a node.js JavaScript REST API server using Express.js. The purpose of this code is to create a REST API server that provides a common interface for working with a Bitcoin Cash full node and various indexers. See [this article](https://troutsblog.com/research/bitcoin-cash/how-to-bch-full-stack-developer) to learn about the 'Cash Stack'. Visit [FullStack.cash](https://fullstack.cash), sign up for a free account, and use this REST API right away with the [bch-js](https://github.com/christroutner/bch-js) JavaScript library.
|
||||||
|
|
||||||
[](https://travis-ci.org/christroutner/bch-api)
|
This repository is intended to be paired with [bch-js](https://github.com/christroutner/bch-js), an npm JavaScript library for building Bitcoin Cash apps.
|
||||||
|
|
||||||
This is a fork and alternative implementation of
|

|
||||||
the [rest.bitcoin.com](https://github.com/Bitcoin-com/rest.bitcoin.com) repository.
|
|
||||||
The purpose of this code is to create a REST API server that provides a common
|
|
||||||
interface for working with a Bitcoin Cash full node and various indexers. See [this article](https://troutsblog.com/research/bitcoin-cash/how-to-bch-full-stack-developer) to learn about the 'Cash Stack'. Visit [FullStack.cash](https://fullstack.cash), sign up for a free account, and use this REST API right away with the [bch-js](https://github.com/christroutner/bch-js) JavaScript library.
|
|
||||||
|
|
||||||
This repository is intended to be paired with [bch-js](https://github.com/christroutner/bch-js),
|
Both bch-api and bch-js are part of the 'Cash Stack' [full stack of BCH software](https://troutsblog.com/research/bitcoin-cash/how-to-bch-full-stack-developer).
|
||||||
an npm JavaScript library, and an alternative implementation
|
|
||||||
of [BITBOX SDK](https://github.com/Bitcoin-com/bitbox-sdk).
|
|
||||||
|
|
||||||
Both bch-api and bch-js are part of the
|
|
||||||
[full stack of BCH software](https://troutsblog.com/research/bitcoin-cash/how-to-bch-full-stack-developer).
|
|
||||||
|
|
||||||
- [API Documentation](https://fullstack.cash/documentation)
|
- [API Documentation](https://fullstack.cash/documentation)
|
||||||
- [Example Code](https://fullstack.cash/examples)
|
- [Example Code](https://fullstack.cash/examples)
|
||||||
@@ -24,32 +17,26 @@ Have questions? Need help? Join our community support:
|
|||||||
## Features
|
## Features
|
||||||
The following features set this repository apart from rest.bitcoin.com:
|
The following features set this repository apart from rest.bitcoin.com:
|
||||||
|
|
||||||
- Address balance and UTXO queries use the [Blockbook](https://github.com/trezor/blockbook)
|
|
||||||
indexer instead of Insight.
|
|
||||||
- Fine grain access is controlled with a JWT token using
|
- Fine grain access is controlled with a JWT token using
|
||||||
[this back end auth server](https://github.com/Permissionless-Software-Foundation/jwt-bch-api) and [this front end](https://github.com/Permissionless-Software-Foundation/jwt-bch-frontend).
|
[this back end auth server](https://github.com/Permissionless-Software-Foundation/jwt-bch-api) and [this front end](https://github.com/Permissionless-Software-Foundation/jwt-bch-frontend). Can be used to monetize access to the REST API.
|
||||||
- Default rate limits are set to 3 RPM for anonymous connections, 10 RPM for [free accounts](https://fullstack.cash/pricing), up to 100 RPM if a full-access JWT token is used.
|
|
||||||
- Typescript removed and ES8 JavaScript used instead.
|
- Typescript removed and ES8 JavaScript used instead.
|
||||||
- npm audit run on all dependencies.
|
- npm audit run on all dependencies.
|
||||||
- [Greenkeeper](https://greenkeeper.io/) implemented for automatic dependency management
|
|
||||||
and security updates.
|
|
||||||
|
|
||||||
## Live Demo
|
## Live Demo
|
||||||
You can test a live demo of the REST API by running the
|
You can test a live demo of the REST API by running the
|
||||||
[bch-js examples](https://github.com/Permissionless-Software-Foundation/bch-js-examples).
|
[bch-js examples](https://github.com/Permissionless-Software-Foundation/bch-js-examples).
|
||||||
Rate limits are 3 requests per minute, but you can increase them to 10 with a [free account](https://fullstack.cash/pricing).
|
Rate limits are 20 requests per minute, but you can increase them to 100 with a [paid account](https://fullstack.cash/pricing).
|
||||||
This is fast enough to try out the examples
|
You can run bootstrap your own REST server by downloading and installing the infrastructure listed on the [CashStrap](https://fullstack.cash/cashstrap).
|
||||||
but these servers are not intended as a freemium service. You can run your own
|
|
||||||
REST server by purchasing the hard drive at [bchjs.cash](https://bchjs.cash).
|
|
||||||
|
|
||||||
- Mainnet REST API server: https://api.fullstack.cash/v3/
|
- BCHN Mainnet REST API server: https://bchn.fullstack.cash/v3/
|
||||||
- Testnet REST API server: https://tapi.fullstack.cash/v3/
|
- ABC Mainnet REST API server: https://abc.fullstack.cash/v3/
|
||||||
|
- Testnet3 REST API server: https://testnet3.fullstack.cash/v3/
|
||||||
- Check server status: https://metrics.fullstack.cash
|
- Check server status: https://metrics.fullstack.cash
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
There are two installation paths, depending if you want a *development* or
|
There are two installation paths, depending if you want a *development* or
|
||||||
*production* environment. You'll also need to set up the underlying infrastructure
|
*production* environment. You'll also need to set up the underlying infrastructure
|
||||||
described [this page](https://troutsblog.com/research/bitcoin-cash/how-to-bch-full-stack-developer).
|
described on [this page](https://troutsblog.com/research/bitcoin-cash/how-to-bch-full-stack-developer).
|
||||||
|
|
||||||
This code targets the Ubuntu 18.04 LTS Linux OS.
|
This code targets the Ubuntu 18.04 LTS Linux OS.
|
||||||
|
|
||||||
|
|||||||
@@ -24,4 +24,10 @@ export REDIS_HOST=172.17.0.1
|
|||||||
# JWT Token Secret
|
# JWT Token Secret
|
||||||
export TOKENSECRET=somelongsecretvalue
|
export TOKENSECRET=somelongsecretvalue
|
||||||
|
|
||||||
|
# So that bch-api can call bch-js locally.
|
||||||
|
export LOCAL_RESTURL=http://127.0.0.1:3000/v3/
|
||||||
|
|
||||||
|
# slp-api alternative SLP validator.
|
||||||
|
export SLP_API_URL=http://10.0.0.5:5001/
|
||||||
|
|
||||||
npm start
|
npm start
|
||||||
|
|||||||
@@ -21,4 +21,10 @@ export REDIS_HOST=172.17.0.1
|
|||||||
# JWT Token Secret
|
# JWT Token Secret
|
||||||
export TOKENSECRET=somelongsecretvalue
|
export TOKENSECRET=somelongsecretvalue
|
||||||
|
|
||||||
|
# So that bch-api can call bch-js locally.
|
||||||
|
export LOCAL_RESTURL=http://127.0.0.1:3000/v3/
|
||||||
|
|
||||||
|
# slp-api alternative SLP validator.
|
||||||
|
export SLP_API_URL=http://10.0.0.5:5001/
|
||||||
|
|
||||||
npm start
|
npm start
|
||||||
|
|||||||
Binary file not shown.
|
After Width: | Height: | Size: 39 KiB |
@@ -20,4 +20,11 @@ export FULCRUM_PORT=50002
|
|||||||
|
|
||||||
export TOKENSECRET=somelongpassword
|
export TOKENSECRET=somelongpassword
|
||||||
|
|
||||||
|
# So that bch-api can call bch-js locally.
|
||||||
|
export LOCAL_RESTURL=http://127.0.0.1:3000/v3/
|
||||||
|
|
||||||
|
# slp-api alternative SLP validator.
|
||||||
|
export SLP_API_URL=http://10.0.0.5:5001/
|
||||||
|
|
||||||
|
|
||||||
npm start
|
npm start
|
||||||
|
|||||||
Reference in New Issue
Block a user