[ICO] [BOUNTY] ICO Dev. Kit: Develop and run an ICO or Ad Campaign automatically

[Quark101]

Campaign Details: Statistics: Signatures
As Signature Scanner performs its daily scans, statistics is being collected. Click this tab to expand a table with daily statistics.



Campaign Details: Participants
Participants for bitcointalk.org Signature Campaign is a list of people that have registered to participate in your Bounty campaign.

Member Id: an id on Bitcointalk forum. In addition to a user name that is usually displayed for every one to see, Bitcointalk uses a unique id of a forum member.

Ethereum address: an address that you will use to send rewards to. Note that our Toolkit has features implemented or planned to make assignment easier for you.

Points: number of points a participant has. Assigned by Signature Scanner, based on number of posts found and "weight" of a signature (see the screenshot of a signatures above).

Approved: As our sample campaign does not require approval, all participants are approved by default. Nevertheless, you can disapprove any one by removing the corresponding check mark; for example, you can do it is posts of that person are inappropriate.

[Quark101]

ICO Generator is an online service that generates Solidity scripts for ICO Campaigns. Very often, a developer faces a situation when a client wants to launch an ICO, and requirements are changing "as we go". Or maybe you just want the job to be done FAST.

The idea behind ICO Generator tool is to allow the user to select features required for a particular campaign, like minimum and maximum goals, token name and so on. Then the Solidity contract is genegated automatically, and all that is left to do is to copy it and deploy.

On the following screenshot you see a typical view of an ICO Generator: the user set an "ICO" checkmark and specified campaign min. and max target as well as number of "shares" to issue (explained below).



Note that the "+" signs used to expand / collapse code fragments are there for reader's convenience only. When you believe that all features are specified, right before copying the code, you have to expand all collapsed sections.

[Quark101]

ICO Generator Features
Let's walk through the features ICO Generator provides. First of all, some sections of the code are not possible to remove, as they are always required, no mater what features you select.

Safe Math
A small helper class, taking care of arithmetic overflow errors. Let's say you have a balance variable, and it is equal to 10. Then you (accidentally) subtract 20 from it. As Solidity does not have negative numbers, an overflow happens, and now the "balance" holde a REALLY large number. Which can create a disaster, as we are talking about money. SafeMath makes this situation impossible.

ERC20Interface
Think of an interface as of a reminder: here are functions you have to implement. By deriving our token (below) from ERC20Interface, we make sure that it is compatible with ERC20 standard.

ERC20Token
The interface does not have any implementation of functions, only the declarations. To implement them, we derive an ERC20Token class ("contract" in Solidity is the same as "class" in less financially oriented languages) from it and fill functions with the real code.

Ownable
Another standard class, used almost everywhere. It allows us to automatically set a contract owner to be the same person that created a class. The ownership can then be verified, so that sertain functions could be called only by the class owner.

The ownership can be transfered, but again, only by the current owner of a class.

Mintable
There are two major approaches to issuing tokens during the Crowd Funding. First, we initially generate maximum possible amount of tokens, and distribute whatever we can during the crowd sale. When crowd sale ends, we "burn" undistributed tokens.

The second approach, one used in ICO Generator tool, is to have no tokens at the beginning of a fund rising event, and to generate (or MINT) tokens as they are purchased. It means that at the end we don't have to "burn" nything.

Both methods work equally well, so it is a mater of personal preferences.

MyToken
"MyToken" is a default name for the token you create. To change it, enter another name in the "Token Name" edit box. The name you entered will replace the "MyToken" everywhere in the code.

Token (its parent class) has a "decimals" field specifying the number of decimal points to show to the user. For example, if you make coins (like Ethereum itself) you may want to allow it to have 18 digits after the decimal "dot" (like Ethereum does). While if you are selling movie tickets, the decimals should be zero, as there is no such thing as 1.235 movie tickets.

Decimals are used by online exchanges to display data properly: it is FOR HUMANS only, for our convenience.

ICO
As you can see, you don't have to have "ICO" checkbox selected: in that case you will only get the code for a token. Checking an "ICO" check box brings up options you can modify in your ICO contract, also it brings up the ICO code as well (initially collapsed).

Can pause Crowdsale

As your crowdsale goes, you might bump into some unexpected situations. Say, your web site is down or hacked. Anything. Then you can pause crowd sale, and resume it later. While paused, tokens can not be bought.

This feature works well with the next one, called "Can extend Crowdsale time" - if you lost some time due to site being down, why not to extend the Crowd Sale?

[portgas313]

Hi sir,
If you need a translator into Indonesian, you can contact me
this is my portfolio


WHITEPAPER

CIT TOKEN     ORIGAMI NETWORK    LOCAL FLOW    REPU    GILGAMESH    OS.UNIVERSITY    SELFLLERY


WEBSITE

LOCAL FLOW  


ANN and BOUNTY 

SELFLLERY BOUNTY     SELFLLERY ANN     GILGAMESH ANN     REPU ANN & BOUNTY     GOA COIN ANN     TRAKINVEST     ORIGAMI ANN     CIT TOKEN ANN     THE BLACK HAND ANN     SHEKEL ANN      WINDCOIN ANN  



BLOG MEDIA TRANSLATE 

NETWORK UNIT     WYSKER     ORIGAMI     SHEKEL     NETWORK UNIT     SHEKEL

[Quark101]

ICO Generator

Can extend Crowdsale time

As was mentioned above, this option allows you to extend the duration of a crowd sale. To understand better the way it works, let's look at the Crowd Sale stages.

In the middle column of ICO Generator screen, you see the editable multiline text area containing a bracketed list:

{
   "status":"WAIT_PRESALE",
   "timeEnd":"27 Nov 2018",
   "tokenPrice":"1 finney",
    "tradingAllowed":"false"
},
{
   "status":"PRESALE",
   "timeEnd":"27 Dec 2018",
   "tokenPrice":"1 finney",
    "tradingAllowed":"true"
},
{
   "status":"WAIT_SALE",
   "timeEnd":"27 Jan 2019",
   "tokenPrice":"1 finney",
    "tradingAllowed":"false"
},
{
   "status":"SALE",
   "timeEnd":"27 Feb 2019",
   "tokenPrice":"1 finney",
    "tradingAllowed":"true"
},
{
   "status":"FINALIZING",
   "timeEnd":"27 Mar 2019",
   "tokenPrice":"1 finney",
    "tradingAllowed":"false"
}
This is the list of stages of your ICO. As a minimum, you have to set correct dates there. Also keep attention on proper formatting, a missing quotation mark will stop the generator half way, yeilding the improper code.

Note, that some stages are allowed to do trading (selling tokens), while some are not. Also, you can set the price of a token on each stage (it will be ignored if trading is prohibited, but you still need to have this field).

Edit the text in an edit box, and press "Update ICO Prices & Timing" button. The changes will be reflected in the text.

[SnowCron]

How do I know that the code was generated without errors?

To find out if there were errors, at least in Windows - Chrome, press F12. It will open a Chrome's debug window (to hide it, press F12 again). If you see a red number in the corner, then there were errors.



After the "Update ICO Prices & Timing" button is pressed, the Solidity code is updated:

function ICO() public
{
    m_token = new MyToken();
   m_saleOptions.push(SaleOptions("WAIT_PRESALE",1543266000,1000000000000000,0,0,false));,
    m_saleOptions.push(SaleOptions("PRESALE",1545858000,1000000000000000,0,0,true));,
    m_saleOptions.push(SaleOptions("WAIT_SALE",1548536400,1000000000000000,0,0,false));,
    m_saleOptions.push(SaleOptions("SALE",1551214800,1000000000000000,0,0,true));,
    m_saleOptions.push(SaleOptions("FINALIZING",1553634000,1000000000000000,0,0,false));
}
Note that in Solidity, dates are represented as seconds and mpney as wei (1 ether equals 10^18 wei).

[Quark101]

"Has Bonus Tokens" Option

Often, Crowd Sale owner wants to issue some tokens free of charge to some people as a reward. For example, they have participated in beta testing, or advertizing campaign, or something else that deserves gratitude.

When you set a "Has Bonus Tokens" checkmark, the "ICO" class generated by an ICO Generator gets a "distributeTokens(address beneficiary, uint256 nNumOfTokens, string strDistributionReason)" function. It assigns the specified number of tokens to a specified address, free of charge. It is important that you specify a meaningful and consistent reason for token distribution, as it is being saved to the log and can then be used in reports.

[Quark101]

Bounty Campaign Participant's Guide
List of ICOs
All ICOs registered in our system and made "public" by their owners are listed in this list. To see it, navigate to List of ICOs using "ICO Toolkit" section of the left hand menu.



Let's take a look at the columns of the table:

Name: name of a campaign and (when clicked) a URL provided by people running that campaign.

Start/End Dates: Dates when Campaign officially begins and ends. Note that you do not have to wait for a campaign to begin in order to register for it: it is a CAMPAIGN's dates, not dates of an associated bounty campaign..

Description: Usually, contains a summary of what the campaign is about, to see more, click the campaign name.

Approval is an important flag, specifying if you need to be "whitelisted" by an owner of a campaign. Some campaigns collect user information (so called KYC, "Know Your Customer"), some check to make sure you are from a particular country and so on. Some don't.

[Quark101]

List of ICOs: Participate

Click "Participate" if you want to take part in a bounty campaign of this particular ICO.

As you can see, for a campaign that does not require approval, all you need to provide is your Bitcointalk Id and an address to send reward tokens to.

If a campaign does insist on approval, you have to follow an additional link, fill a KYC form on a campaign's site and wait for an approval.

[Quark101]

List of ICOs: Signatures for bitcointalk.org

Click on the "Signatures for bitcointalk.org" title to expand it. You see a list of signatures for different Bitcointalk user ranks. Each signature has a weight, which is a multiplier. For example, if a weight for a Newbie member is 1 and weight for a Legend member is 7, the Legend will earn 7 times larger bonus for one post than a Newbie.



Note that Signature Scanner performs an EXACT match, so when adding signature to your bitcointalk profile, you have to use copy-paste, with no editing whatsoever.

[Quark101]

List of ICOs: Statistics: Signatures
As Signature Scanner performs its daily scans, statistics is being collected. Click this tab to expand a table with daily statistics. It is not clear if this information is important, as choosing an active campaign means both higher chances for success and more people to share the reward with.

[Quark101]

List of ICOs: Participants

Participants for bitcointalk.org Signature Campaign is a list of people that have registered to participate in current Bounty campaign.

Member Id: an id on Bitcointalk forum. In addition to a user name that is usually displayed for every one to see, Bitcointalk uses a unique id of a forum member.

Ethereum address: an address that will be used to receive rewards. It is not clear if a final version will display addresses or not: we are going to use clients' feedback.

Points: number of points a participant has. Assigned by Signature Scanner, based on number of posts found and "weight" of a signature (see the screenshot of a signatures above).

Approved: As our sample campaign does not require approval, all participants are approved by default. If an approval is required, use this field to find out if you were approved or not.

[Quark101]

How to invest in ERC20
There are countless tutorials explaining how to buy tokens. What makes this one different?

The theory. We are going to explain not just what to do, but also what is going on when you do it. Hopefully, it will take away all the unnecessary confusion. Nevertheless, it is always a good idea to read FEW tutorials before sending your money somewhere.

[Quark101]

Private and Public Keys
When you say "Ethereum wallet" or (same thing) "Account", it means that you have pair of keys. A key is a meaningless string of numbers and characters; public key is used to send money to you, private key - to send money FROM you, in other words, to access your money.

As the result, private key should be kept, well, private, while a public key can be shown to third parties: it can not be used to cause you any financial damage.

To send money to someone, you need his public key. You send money using your private key and his public key. The thing is, your private and public keys are related, so when he receives your money, he knows your public address (but he'll never know private one, unless you do something stupid).

[Quark101]

Two types of addresses
In a "real" world, when it comes to business, there are two types of acting entities: a person (physical entity) and a company (a legal entity). Mostly, though not always, they can do same things.

In an Ethereum world, same thing. An address can belong to a person, in this case it is a "physical" entity, or to a contract, which acts similar to a legal entity in business. A contract (just like a company) has some rules according to which it performs financial transactions.

Now to tokens. A token contract maintains the list of public addresses it received money from and tokens those money bought. It is like an electronic accounting book. Saying that you own 10 tokens of, say, VIB, means that VIB contract has a corresponding record, that's all.

Most of the time (if a contract is written properly) you can just send money to it, and that's all: a contract takes money and you are listed in its database. To make sure a transaction happened you can go to etherscan.io and enter your (public!) address. You will see that money moved to contract's address.

[Quark101]

Contracts and functions
Of course, if there is a way to make things complicated, people will make it complicated. A contract can have functions. What it means? Think of a "real life" company: a supermarket. You go there with your money, you pay... and that's not enough. You have to tell them what you are paying for. Sounds reasonable - for a supermarket. Strangelly, sometimes an ICO contract, that (unlike a supermarket) sells only one product (a token) does not "just take money", it wants you to send them to one of contract's functions.

That is not a big deal, but some wallets programs do not know how to do it and some require special knowleges. Lucky us, it does not happen very often, most ICO contracts can receive money, no questions asked.

To put is simple: if an ICO's "how to invest" page says "send money to an address", then you can use any wallet. If it says "use MyEtherWallet of Mist"... Well, your options are limited to these (very good but not entry level) wallet programs.

[Quark101]

Investing in our ICO
We are going to explain investing using two programs: MetaMask and MyEtherWallet. First is very easy to use, second is a professional tool. We'll also explain investing using a Web site.

Investing with MetaMask
Download and install MetaMask. MetaMask is a plugin for Chrome browser, and it takes about a minute to install it.

After the installation is complete, a fox icon appears on the upper-right side of a browser window. Click it and follow instructions. You will be asked to provide a password, so that your wallet (one you are about to create) can be encrypted. Make it reasonably strong.

Log in with a newly created password and find in a (very strangely organized) menus a "Create Account" item. By account (see above) they mean a pair of keys: private and public. Find (it is easier to find then to explain how to do it) the private key in MetaMask's menu and copy it to clipboard.

Now you need some ether. This tutorial is not about buying crypto currency, you can find plenty of "how to" guides online. One interesting option is an exchange that is built in a MetaMask itself.

When our ICO goes live, an address to send ether to will be published at ICO page. After money is transfered, go to MetaMask's "Tokens" tab and enter contract address, name (any, it is for you to see, but better to make it meaningful) and 0 as number of digits (anything from 0 to 18 will do, it is too, only for you to see).

Now you should be able to see your tokens, just give it some time as Ethereum transactions are far from being instant.

However...

Our ICO provides tokens AND shares. Tokens are visible in MetaMask. Shares are only visible on our Web site (if you are a guru, you can extract this info from block chain as well). That is ok, just keep in mind that you have an extra bonus that isn't visible in MetaMask. We are going to talk about Web site later on this page.



As you can see, for a campaign that does not require approval, all you need to provide is your Bitcointalk Id and an address to send reward tokens to.

If a campaign does insist on approval, you have to follow an additional link, fill a KYC form on a campaign's site and wait for an approval.

[Quark101]

Investing with MEW
MyEtherWallet is a professional tool, it has some very advanced features, and it is not an entry level program. However, most of ICOs recommend it, for an unknown reason.

Open MEW in your browser or download it from GIT (if you know how) and use locally. It has more than one way of storing data, I strongly suggest using "Keystore", which is essentially same Metamask does. Create a wallet, make sure your password is strong enough. Log in in "Send/Receive ether" section. You will see a form to send ether to an address...

After transfer is complete, click "tokens" and add token you just paid for: it is not "adding to wallet", it is just adding to the watch list.

[Quark101]

Share Holder

ShareHolder contract works as a cumulative account: you send money to it, it distributes that profit among share holders. Shares therefore accumulate profit, so price of a share can only go up. Cumulative.

If your business if 100% in a block chain, you can even attach your profit-bringing contract to ShareHolder contract, so your clients can be sure: whatever profit your contract gets, it will distribute it to share holders (cheating made impossible).

There are many possible use cases for this functionality.

First, you can sell shares to clients and divert certain percent of your busines' profit into it. It looks like someone gives away the profit of a company. For free. However, it is not quite so: a shareholder gets as much profit as an attached contract brings. Therefore, we expect a share holder to actively bring new people into our business; in other words, we pay our share holders for an advertizing campaign.

Second. It is possible to reward developers team with shares of your company. Unlike ICO tokens, shares are not subject to market price fluctuation nor they require an exchange: a ShareHolder contract will buy shares back if someone is willing to sell them.

Third, shares can be used instead of (or together with) ICO tokens, you will find details in the ShareHolder Tutorial and the ICO Generator Guide.

[Quark101]

0xeBfB3A7B50bF0154371fB83D76B6102F2d90Cfb7