https://github.com/edgeapp/edge-referral-manager
https://github.com/edgeapp/edge-referral-manager
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/edgeapp/edge-referral-manager
- Owner: EdgeApp
- Created: 2020-02-28T20:55:39.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-10-10T22:28:36.000Z (over 2 years ago)
- Last Synced: 2025-02-14T14:55:05.545Z (over 1 year ago)
- Language: TypeScript
- Size: 969 KB
- Stars: 1
- Watchers: 12
- Forks: 0
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# edge-referral-manager
> A REST API for storing & sending money, powered by Edge
This repository implements a simple API for storing and sending money to a wallet on a web server. This can be useful for automated payouts, promotions, e-commerce, and various similar things.
We make this code available for free, but it does require an Edge SDK API key. We recommend closing external ports for security to prevent outside access and should only be used on your local server. Please copy `config.sample.json` to `config.json` and add your API key in there.
## Install production
Install Node
```sh
sudo apt update -y
sudo apt install curl -y
curl -sL https://deb.nodesource.com/setup_10.x | sudo bash -
sudo apt install -y nodejs
```
Install Yarn
```sh
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update && sudo apt-get install yarn
```
Clone Repo
```sh
git clone https://github.com/EdgeApp/edge-referral-manager.git
```
## Manage server using forever-service
You can then use `forever-service` or similar tools to install the software on your server machine.
```sh
# install:
sudo forever-service install edgeRest --script lib/index.js --start
# manage:
sudo service edgeRest restart
sudo service edgeRest stop
# uninstall:
sudo forever-service delete edgeRest
```
## Manual Testing
`curl http://localhost:80/`
## API Docs
## Send cryptocurrency from a wallet to a public address
```sh
# nativeAmount is in satoshi so this will need to be multiplied by 100,000,000, see example for reference
$.post('http://localhost:$PORT/spend/?type=$TYPE', ({ spendTargets: [{ nativeAmount, publicAddress }])
# spend .000011 bitcoin to address 3JVeTHattdtGBAzWskiLzjeuojTb4Rjuui
await fetch('http://localhost:8008/spend/?type=bitcoin', {
body: JSON.stringify({ spendTargets: [{ "1100", "3JVeTHattdtGBAzWskiLzjeuojTb4Rjuui" }] }),
headers: {
'Content-Type': 'application/json'
},
method: 'POST'
})
# spend result
> {
> "ourReceiveAddresses": [
> "qqrzxway5u26205mzz5hk5mqerer9dxf8v0jqum5vf"
> ],
> "currencyCode": "BCH",
> "txid": "2eea81e5bd42ad8ee5fde9a2923d3e8ec60914ae974071187aa197d4a45af341",
> "date": 1583270341.543,
> "blockHeight": 0,
> "nativeAmount": "-11908",
> "networkFee": "908",
> "signedTx": "01000000011152fb90c4eeee7d97a7e4ec58647f0300c0d2a085e4cdfa291ae75865cebfd2010000006b48304502210099d8df18063a8ff865c7638bef8109e83067c8420cf06066bd6c93524392f01602202dc4e57174d3667b421afc3ae4ef1b1eaf12c23c3df74464f4ff3dbd18f118d04121020df58681fe35241fb04863933f47a148f72fab6040255d8059500968e1f5cb3cffffffff02f82a0000000000001976a9143a92370920c0a20f126a6778d1700eb9e970695b88ac355b1c00000000001976a91406233ba4a715a53e9b10a97b5360c8f232b4c93b88ac00000000"
>}
```
## REST API and Front-End App
To launch the REST API and the front-end application, just type `yarn start`.
You can also build the server code by running `yarn build`, which puts its output in the `lib` folder.