Webserver
This is a webserver using node and express, in order to start it you need to run the following commands in the terminal:
    npm install
    node index.js
We assume that it will run in port 3000 but feel free to change it. Don't forget to update the scritps accordingly though.

Endpoints

The general architecture of the API is the following
    Endpoints that receive signed transactions as inputs and they will complete the required transactions. This allow you to sign the transactions of the front end and it is safe to use on a production server because the private key is never sent to the endpoints. To sign the transactions you can see the examples in the scripts folder of this repo.
    You can make and end-to-end swap using the /swap endpoints. But this is a multi-step process that will fail if one of the single steps fails. It uses Harmony's Horizon Bridge and Viper DEX, so for example, the bridging part can work but if there is no liquidity in the pool so the who transaction will fail. Therefore use this enpoint only if you are sure that Viper's LPs have enough liquidity.
    If you prefer to do it setp-by-step, you should use the following end-points in the specified order:
      /swap/bridge-in - Bridges BUSD in ethereum to Harmony's BUSD
      /swap/viper/ - Swaps Harmony's BUSD to bscBUSD (Both are bridged assets in the Harmony network)
      /swap/bridge-out - Bridges bscBUSD into Binance's BUSD
Right now the following endpoints are enabled, but we will keep adding more reguarly, so remember to pull once in a while.

POST /swap

This endpoint will swap balances between Ethereum BUSD and Binance BUSD, the body for this request should look like this:
Request
Response
1
{
2
"amount" : amount,
3
"oneAddress" : oneAddress,
4
"ethAddress" : ethAddress
5
"lockApproveTxnHash" : approveTxnHash
6
"lockTxnHash" : lockTxnHash
7
"burnApproveTxnHash" : approveTxnHash
8
"depositTxnHash" : depositTxnHash
9
"burnTxnHash" : burnTxnHash
10
"routerContract" : routerContract
11
"fromTokenContract" : fromTokenContract
12
}
Copied!
1
{
2
trx: "swap",
3
success: bool,
4
error_message: message,
5
error_body: body
6
}
Copied!
    amount: this is a string with the amount in decimals (e.g. "10.50") that you want to swap
    oneAddress: this is a string with the address of the wallet owned by the private key in the Harmony wallet format i.e. oneaxxxxxxxx
    ethAddress: this is a string with the address of the wallet owned by the private key in the Ethereum wallet format i.e. Oxaxxxxxxxx
    lockApproveTxnHash : this is a string with the hash of the contract manager's approval for the lock transaction
    lockTxnHash : this is a string with the hash of the lock transaction
    burnApproveTxnHash : this is a string with the hash of the contract manager's approval for the burn transaction
    depositTxnHash : this is a string with the hash of the deposit transaction
    burnTxnHash : this is a string with the hash of the burn transaction
    routerContract : This is a string with the writing approval for Viper's swap router contract
    fromTokenContract : This is a string with the transaction approval for the account swapping in Viper

POST /swap/bridge-in

This enpoint will bridges BUSD in ethereum to Harmony's BUSD, it is the first step of the step-by-step swap, the body for this request should look like this:
Request
Response
1
{
2
"amount" : amount,
3
"oneAddress" : oneAddress,
4
"ethAddress" : ethAddress,
5
"lockApproveTxnHash" : approveTxnHash,
6
"lockTxnHash" : lockTxnHash
7
}
Copied!
1
{
2
trx: "bridge",
3
success: bool,
4
error_message: message,
5
error_body: body
6
}
Copied!
    amount: this is a string with amount in decimals (e.g. "10.50") that you want to swap
    oneAddress: the address of the wallet owned by the private key in the Harmony wallet format i.e. oneaxxxxxxxx
    ethAddress: the address of the wallet owned by the private key in the Ethereum wallet format i.e. Oxaxxxxxxxx
    lockApproveTxnHash : this is a string with the hash of the contract manager's approval for the lock transaction
    lockTxnHash : this is a string with the hash of the lock transaction
You can see an example of this call in the bridge_eth_to_one.js file in the scripts folder of the repo

POST /swap/viper

This enpoint will swap Harmony's BUSD to bscBUSD (Both are bridged assets in the Harmony network), it is the second step of the step-by-step swap, the body for this request should look like this:
Request
Response
1
{
2
"amount" : amount,
3
"oneAddress" : oneAddress,
4
"ethAddress" : ethAddress
5
"routerContract" : routerContract
6
"fromTokenContract" : fromTokenContract
7
}
Copied!
1
{
2
trx: "viper",
3
success: bool,
4
error_message: message,
5
error_body: body
6
}
Copied!
    amount: this is a string with amount in decimals (e.g. "10.50") that you want to swap
    wallet: this is the private key of the wallets with the funds, please use an .env or equivalent to store this key, never put it in your code
    oneAddress: the address of the wallet owned by the private key in the Harmony wallet format i.e. oneaxxxxxxxx
    routerContract : This is a string with the writing approval for Viper's swap router contract
    fromTokenContract : This is a string with the transaction approval for the account swapping in Viper
You can see an example of this call in the viper_swap.js file in the scripts folder of the repo

POST /swap/bridge-out

Request
Response
1
{
2
"amount" : amount,
3
"oneAddress" : oneAddress,
4
"ethAddress" : ethAddress,
5
"burnApproveTxnHash" : approveTxnHash,
6
"depositTxnHash" : depositTxnHash,
7
"burnTxnHash" : burnTxnHash
8
}
Copied!
1
{
2
trx: "bridge",
3
success: bool,
4
error_message: message,
5
error_body: body
6
}
Copied!
    amount: this is a string with amount in decimals (e.g. "10.50") that you want to swap
    oneAddress: the address of the wallet owned by the private key in the Harmony wallet format i.e. oneaxxxxxxxx
    ethAddress: the address of the wallet owned by the private key in the Ethereum wallet format i.e. Oxaxxxxxxxx
    burnApproveTxnHash : this is a string with the hash of the contract manager's approval for the burn transaction
    depositTxnHash : this is a string with the hash of the deposit transaction
    burnTxnHash : this is a string with the hash of the burn transaction
You can see an example of this call in the bridge_one_to_bsc.js file in the scripts folder of the repo

Local Endpoints

POST /local/swap

This enpoint will swap balances between Ethereum BUSD and Binance BUSD, the body for this request should look like this:
Request
Response
1
{
2
"amount" : amount,
3
"wallet" : wallet,
4
"oneAddress" : oneAddress,
5
"ethAddress" : ethAddress
6
}
Copied!
1
{
2
trx: "swap",
3
success: bool,
4
error_message: message,
5
error_body: body
6
}
Copied!
    amount: this is a string with amount in decimals (e.g. "10.50") that you want to swap
    wallet: this is the private key of the wallets with the funds, please use an .env or equivalent to store this key, never put it in your code
    oneAddress: the address of the wallet owned by the private key in the Harmony wallet format i.e. oneaxxxxxxxx
    ethAddress: the address of the wallet owned by the private key in the Ethereum wallet format i.e. Oxaxxxxxxxx
You can see an example of this call in the swap.js file in the testing folder of the repo

POST /local/swap/bridge-in

This enpoint will bridges BUSD in ethereum to Harmony's BUSD, it is the first step of the step-by-step swap, the body for this request should look like this:
Request
Response
1
{
2
"amount" : amount,
3
"wallet" : wallet,
4
"oneAddress" : oneAddress,
5
"ethAddress" : ethAddress
6
}
Copied!
1
{
2
trx: "bridge",
3
success: bool,
4
error_message: message,
5
error_body: body
6
}
Copied!
    amount: this is a string with amount in decimals (e.g. "10.50") that you want to swap
    wallet: this is the private key of the wallets with the funds, please use an .env or equivalent to store this key, never put it in your code
    oneAddress: the address of the wallet owned by the private key in the Harmony wallet format i.e. oneaxxxxxxxx
    ethAddress: the address of the wallet owned by the private key in the Ethereum wallet format i.e. Oxaxxxxxxxx
You can see an example of this call in the bridge-lock.js file in the testing folder of the repo

POST /local/swap/viper

This enpoint will swap Harmony's BUSD to bscBUSD (Both are bridged assets in the Harmony network), it is the second step of the step-by-step swap, the body for this request should look like this:
Request
Response
1
{
2
"amount" : amount,
3
"wallet" : wallet,
4
"oneAddress" : oneAddress,
5
}
Copied!
1
{
2
trx: "viper",
3
success: bool,
4
error_message: message,
5
error_body: body
6
}
Copied!
    amount: this is a string with amount in decimals (e.g. "10.50") that you want to swap
    wallet: this is the private key of the wallets with the funds, please use an .env or equivalent to store this key, never put it in your code
    oneAddress: the address of the wallet owned by the private key in the Harmony wallet format i.e. oneaxxxxxxxx
You can see an example of this call in the viper.js file in the testing folder of this repo

POST /local/swap/bridge-out

This enpoint will bridges bscBUSD into Binance's BUSD, it is the third step of the step-by-step swap, the body for this request should look like this:
Request
Response
1
{
2
"amount" : amount,
3
"wallet" : wallet,
4
"oneAddress" : oneAddress,
5
"ethAddress" : ethAddress
6
}
Copied!
1
{
2
trx: "bridge",
3
success: bool,
4
error_message: message,
5
error_body: body
6
}
Copied!
    amount: this is a string with amount in decimals (e.g. "10.50") that you want to swap
    wallet: this is the private key of the wallets with the funds, please use an .env or equivalent to store this key, never put it in your code
    oneAddress: the address of the wallet owned by the private key in the Harmony wallet format i.e. oneaxxxxxxxx
    ethAddress: the address of the wallet owned by the private key in the Ethereum wallet format i.e. Oxaxxxxxxxx
You can see an example of this call in the bridge-burn.js file in the testing folder of this repo
Last modified 1mo ago