https://github.com/morion4000/webdollar-transactions-script

Nodejs script for programmatic WebDollar transactions (Experimental)
https://github.com/morion4000/webdollar-transactions-script

Last synced: 29 days ago
JSON representation

Nodejs script for programmatic WebDollar transactions (Experimental)

• Host: GitHub
• URL: https://github.com/morion4000/webdollar-transactions-script
• Owner: morion4000
• Created: 2018-08-17T12:10:12.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-10-14T13:22:05.000Z (about 4 years ago)
• Last Synced: 2023-04-03T13:45:18.680Z (almost 2 years ago)
• Language: Dockerfile
• Homepage: https://webdollar.io
• Size: 17.6 KB
• Stars: 0
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# webdollar-transactions-script

Nodejs script for programmatic WebDollar transactions (Experimental). The scripts are making HTTP requests to full nodes in order to push transactions in the WebDollar network.

**Important**: Full nodes have to be started with the `WALLET_SECRET_URL` environment variable (set to at least 30 characters). The private API is not going to be accessible otherwise.

# Scripts

Several scripts were developed to exemplify how to call the private API endpoints from Nodejs:

- [import_wallet.js](https://github.com/morion4000/webdollar-transactions-script/blob/master/examples/import_wallet.js)

- [create_transaction.js](https://github.com/morion4000/webdollar-transactions-script/blob/master/examples/create_transaction.js)

# Workflow

The wallet from which transactions are sent must first be imported on the full node. After the wallet is imported, funds can be sent from the wallet.

**IMPORT_WALLET** -> **CREATE_TRANSACTION**

**Notice**: It is recommended to wait a few seconds between API calls.

# API Endpoints

The scripts rely on WebDollar's private API endpoints.

### Global parameters:

- `API_URL`: The url of the deployed full node (port included), _example: https://wd.hoste.ro:40000_

- `WALLET_SECRET_URL`: The 30 characters string set to the `WALLET_SECRET_URL` environment variable, _example: 7f55a0ed8b021080de00960cc73768fb_

## Import a wallet

**URL: `API_URL`/`WALLET_SECRET_URL`/wallets/import/`ADDRESS`/`PUBLIC_KEY`/`PRIVATE_KEY`**

Example: https://wd.hoste.ro:40000/7f55a0ed8b021080de00960cc73768fb/wallets/import/WEBD$gD1Km74GiVeTX3NqeY31iJ49FfdCAFCB0P$/063373759855cd4ac52fae078e9f36dfdba420191beb9e3a1dbc5b7205e66292/80cd858e76bd2b253b634d71bd2c8ea97314154020f63ab4baf2e4d605630529c7063373759855cd4ac52fae078e9f36dfdba420191beb9e3a1dbc5b7205e66292e8d1ce62

#### Parameters:

They can be found in the exported wallet file:

`{ "version":"0.1",

  "address":"WEBD$gD1Km74GiVeTX3NqeY31iJ49FfdCAFCB0P$",

  "publicKey":"063373759855cd4ac52fae078e9f36dfdba420191beb9e3a1dbc5b7205e66292",

  "privateKey":"80cd858e76bd2b253b634d71bd2c8ea97314154020f63ab4baf2e4d605630529c7063373759855cd4ac52fae078e9f36dfdba420191beb9e3a1dbc5b7205e66292e8d1ce62" }`

- `ADDRESS`: The wallet's public address (might have to be encoded)

- `PUBLIC_KEY`: The wallet's public key

- `PRIVATE_KEY`: The wallet's private key

## Create a transaction

**URL: `API_URL`/`WALLET_SECRET_URL`/wallets/create-transaction/`FROM_ADDRESS`/`TO_ADDRESS`/`AMOUNT`/`FEE`**

Example: https://wd.hoste.ro:40000/7f55a0ed8b021080de00960cc73768fb/wallets/create-transaction/WEBD$gD1Km74GiVeTX3NqeY31iJ49FfdCAFCB0P$/WEBD$gD1Km74GiVeTX3NqeY31iJ49FfdCAFCB0P$/1/1

#### Parameters:

- `FROM_ADDRESS`: The WEBD address to send the funds from (must be imported first, might have to be encoded)

- `TO_ADDRESS`: The WEBD address to send the funds to (might have to be encoded)

- `AMOUNT`: Number expressed in WEBD

- `FEE`: Number expressed in WEBD

# Disclaimer

The methods described are experimental and although they work, they are be vulnerable to attacks. No security practices have been implemented.