<center><h2>HIVE Creator v2.0</h2><em>Make Money Creating Accounts</em><br><sup>[Github](https://github.com/fbslo/creator)</sup><h2>Visit website: [HIVE Creator](https://creator.fbslo.net/)</h2><sup>[API](https://creator.fbslo.net)</sup></center>


<center>![creator.jpeg](https://images.hive.blog/DQmPnYEU5pindKEGnwGrntbUQqh9msUPKaDPbSjNixmKfvR/creator.jpeg)<br></center>

It's been some time since v1.0 and I was busy working on new features for Account Creator. 

***What is HIVE Creator?*** It's an open source app that allows anyone to host account creation service (like [Blocktrades.us](https://blocktrades.us/en/create-hive-account))

***What's new?***
* Private API for account creation
* Blacklist
* Whitelist
* Better refunds

---

***Private API***

Private API allows big stakeholders with thousands of claimed pending accounts to work with dApps and other platforms that may need to create accounts for new users. Big account (creator) can run this service without frontend and only allows other apps/users (that have your authorization) to send POST requests to your API and your account will create new account for them. Owner can remove authorization at any time.

Read details how to set up this service below. *Private API is optional*

---

***Blacklist & Whitelist***

You can now use @themarkymark's blacklist and block all blacklisted users  (over 70,000 blacklisted users at the time of writing). If user is on any blacklist, all funds will be refunded. 

There is also option to whitelist users, so even if they are blacklisted, they will still be able to buy new accounts.
Add new users to whitelist.txt (one account without @ per line).

*Blacklist is optional*

---

***Refunds***

Extra funds will be refunded (All transfers are divided by price and than rounded down. If you send 10.3 HIVE and price is 0.500 HIVE, you will get 20 codes and 0.3 HIVE will be refunded.)

---

***Installation***

For basic instructions how to install this app, read [HIVE Creator - Make Money Creating Accounts](https://hive.blog.com/hive-139531/@fbslo/hive-creator-make-money-creating-accounts) and [README.md](https://github.com/fbslo/creator/blob/master/readme.md)

If you have previous version of this app, update config.json:

```
{
  "account": "youraccount",
  "key": "thisisyouractivekey",
  "create_account_frontend": "true", //do you want to allow users to use front-end or just API
  "create_account_api": "true", //do you want to enable private API
  "accept_payment": "true", //do you want to accept payments
  "price": "0.5 HIVE",
  "claim": "false",
  "tip": "0.1", //tip for @fbslo, 0.1 is 10%, set to 0 to disable
  "blacklist": "true", //do you want to use blacklist
  "rpc": "https://api.hive.blog", 
  "database_ip": "localhost",
  "database_user": "root",
  "database_password": "database_password",
  "database_port": "3306",
  "database": "creator",
  "env": "dev"
}
```

---

***Set up Private API***

Create new tables in MySQL database `creator`: 

`create table apitokens(token TEXT, user TEXT);`

`token` is random string used as authorization secret, `user` is name of API user (e.g dApp).

Insert random tokens to the database.

`INSERT INTO apitokens (token, user) VALUES ('QWhMUw3KK5PZ6T9EcN4H5c8M_random_key', 'dApp or user');`

`create table logs(status TEXT, name TEXT, user TEXT, time TEXT);`

`status` is true or false (if account was created or not), `name` is username of created account, `user` is name of API customer (e.g dApp) (user from `apitokens` table), so you can keep track of created account.

Give the `token` from `apitokens` to the person who will request creation of accounts (dApp...). `token` should be long random secure string. 

To create new account, send POST request to /api/createAccount with header `authority: yourapitoken` and body: `name` (name of new account) and `key` (password for new account).

Here is example of jQuery example:

```
$.ajax({
    type: 'POST',
    headers: { 'authority': 'your_api_token' },
    url: 'https://domain_or_ip/api/createAccount',
    data: { 
        'name': 'new_username', 
        'key': 'key_for_new_account_should_be_at_lest_32_chars' 
    },
    success: function(msg){
        alert(msg)
    }
});
```

If request is successful,  you will get JSON response `{ created: true/false, name: 'new_account_name', key: 'key_of_new_account'}`

---

Please report any bugs. 
If you have any questions, need help installing or using this service, please contact me.
Feel free to fork this project and add more features :)

---

<center><b>@fbslo</b><br><sup>[fbslo.net](https://fbslo.net)</sup><br>https://github.com/fbslo/creator<br>Discord: fbslo#8470</center>

---

***This SOFTWARE PRODUCT is provided by THE PROVIDER "as is" and "with all faults." THE PROVIDER makes no representations or warranties of any kind concerning the safety, suitability, lack of viruses, inaccuracies, typographical errors, or other harmful components of this SOFTWARE PRODUCT. There are inherent dangers in the use of any software, and you are solely responsible for determining whether this SOFTWARE PRODUCT is compatible with your equipment and other software installed on your equipment. You are also solely responsible for the protection of your equipment and backup of your data, and THE PROVIDER will not be liable for any damages you may suffer in connection with using, modifying, or distributing this SOFTWARE PRODUCT.***