For updates and additions to the BipCot software ecosystem, subscribe to our yummy feed.

BY DOWNLOADING AND USING OUR SOFTWARE, YOU AGREE TO THE BipCot NoGov LICENSE.These files below are all 64-bit, except Windows GUI wallet, which will work on 64-bit and 32-bit.
Windows CLI (command line interface) how-tos are below the downloads. If you’re on Linux, you may know how to do a lot of this stuff. If you’re on Linux and you don’t know how to do this stuff but are good with Linux, you’ll do fine. The Linux terminal commands for using this software are the same as the Windows CMD commands.

Most people won’t have to, but if you have to open ports, Peer-to-peer port: 18870. Remote-procedure-call port: 18871. Also open port 7690.

Note the “anonymity level” slider on the GUI wallet is equivalent to the “mixin” in the CLI wallets.

Note: No version of the BipCoin software will run out of the box on a Raspberry Pi. Yup, someone tried the Linux GUI and the CLI. Nope.

Even if you could install the necessary stuff to make it work, it would only really work as a wallet. There’s not much hashing power in one. A very out-of-date used desktop PC for the same price on eBay running Linux would mine better.

Note: There are three extra fun and promo items in each CLI install. Please share and use as you see fit.
–BipCoin-RadioAd-60sec-Stereo-1.mp3 (radio ad)
–StickerArtPurple1000px.png (hi-rez logo)
-___Read_Me_Damn_It.txt (the license and ReadMe file)

NOTE: Using the CLI wallets is more of a learning curve than our GUI wallets, but you can do more with the CLI wallets (including mining!) Also, learning to use command line if you never have before will make you more knowledgeable about BipCoin, CryptoNote, cryptocurrencies, and even computers in general.

SO……Unzip to a folder. Name the folder BipCoin Wallet or something you’ll recognize.
Click to run bipcoind (the application, not the other file with that name) first.

Wait for the blockchain to sync,

Sometimes it’s not in green and just says “You are now synchronized with the network. You may now start simplewallet”:

then run simplewallet (the application, not the other file with that name)
You may get warnings asking if you want to “allow access” for your firewall (and antivirus too), go ahead and allow, including ticking the little box for Home Network, if you get that message.

(The reason you may get an anti-virus warning is that sometimes there ARE Bitcoin mining viruses, and anti-virus programs are overly careful. There are no viruses in our software.)

Type G and hit the “Enter” key to generate a new wallet. Give it a name and set the password. Remember them. (Until we add requiring confirming the password, we STRONGLY recommend that at this point you type Save, Exit, then reopen the wallet and test the password before you actually put some value in it.)

(You will ALWAYS need to hit the Enter key after typing a command in the command line interface versions of simplewallet and bipcoind.)

Later after you [E]xit, then later [O]pen existing wallet, you’ll find that the wallet name is not case-sensitive, though the password is. And if you type the wrong password, it closes the wallet.

Click once in simplewallet to select.

Type
help

and hit the Enter key to get commands. You may need to Hit Enter key to get to new line first. Then type the command you want, then hit the Enter key on your keyboard to execute the command.

You’ll largely be in simplewallet. But you can also click once in bipcoind to select it, then type

help

and enter to get the commands for bipcoind.

To copy and paste wallet addresses etc. Right click icon in upper left corner of CMD window,

Select Properties.

On Options tab, enable (check mark) Quick Edit Mode and Insert Mode,

and hit the OK button. (You can also use the Edit commands from the right click and edit manually).

These options may be here on older computers:

You have to do this for each cmd window (once for simplewallet, once for bipcoind).

Now you can highlight text to copy it from CMD window.

Hold down left mouse key and drag to highlight text. That copies it to the clip board. Hit Enter key to paste it in CMD window.

You can also copy and paste (like wallet addresses) in and out of emails and text documents, use the normal windows commands to copy and paste outside of the CMD window, use the above to copy and paste within the CMD window.

Also, sometimes when copying an address, you have to do one line then the other, paste into a document, and put them together. And check for spaces.

And sometimes when you copy a whole address, it puts a space in the middle. If you give your address to someone and they get a “wrong address” error, this is likely the problem. Mind the gap!

HELP Commands in simplewallet:

address Show current wallet public address
balance Show current wallet balance
bc_height Show blockchain height
exit Close wallet
help Show this help
incoming_transfers Show incoming transfers
list_transfers Show all known transfers

Regarding wallet address: unlike BitCoin, BipCoin has only one address per wallet. But it creates temp addresses for every transaction. With a MixIn of 3 or over, they cannot be traced to your address. 5 or higher, when the network will let you do it, is great.

If you need a different address, you can easily create more than one address on one computer.

To see your balance, select simplewallet, type
balance
and hit Enter.
At the bottom of the CMD window, you will have
available balance
and
locked amount.

Available balance is what you can spend now, locked amount is unconfirmed transactions that should eventually transfer into available balance.

–To see incoming transfers type
incoming_transfers

in simplewallet.

–To see when a locked amount will become unlocked and available:
list_transfers

in simplewallet. The last column (“unlock time”) will be the block number when a particular transfer will be confirmed. Your transaction won’t likely confirm as soon as that block shows, but before the next block. (But the unlock time is usually less than 60 blocks – 2 hours – after the block number at the time of the transaction. It can be minutes sometimes, especially if you add a small fee. (More on that below)

–To see what block number the blockchain is on, type

bc_height
in simplewallet.

The block height goes up one block every two minutes under normal conditions. But the block emission rate will speed up (less than two minutes between blocks) for a little while when the hash rate is rising. And it will slow down (more than two minutes between blocks) for a little while when the hash rate is falling. This is true of most CryptoNote coins.

If you enter a command and hit “Enter”, and text is coming up too quickly for you to type, you can just type over the existing text. It’s confusing if you’re not used to it, but becomes natural very quickly.

SOLO MINING (Edit: though you’re not going to be able to get many bips mining solo at this point.)

Updated info as of 5/24/17 is HERE.
in simplewallet, type start_mining [<number_of_threads>] where the [<number_of_threads>] is the number of processor cores you want to use. To have some left for computer overhead, you should pick a number that’s one or two cores less than your computer has. Like if you have a quad core, try:

start_mining 3

and hit Enter. It will say if it starts mining.

If you get an error, try the number one lower.

You can mine on more than one computer, each running its own wallet. Computers can get hot mining, so if they do, open them up and point a fan into them so they don’t die.

With laptops, if you’re going to have them closed (I do because I have cats who love to walk on keyboards and they sleep on the keyboards of warm laptops – “OH DADDY LEFT ME A KITTY WARMER! MEW!”)…….Go into Control Panel and change the setting on Power to “turn off monitor when closed”, “go into Sleep Mode: never, and “turn off hard drives: never.”

Laptop miner with fan

Laptop is only 32 H/s, but it finds blocks! My desktop is getting 145 H/s. It finds more blocks.

Pro mining rigs will mine more, but cost money. But many people already have them from mining Bitcoin, but they can no longer keep up with Bitcoin. Those are GREAT for mining BipCoin.

before exiting simplewallet, or you may lose your latest update of the blockchain, incoming mining, incoming transactions or outgoing transactions.

Then type

exit

in bipcoind

to exit (don’t just hit the x in the top right corner, or it won’t save).

You don’t need to have the wallet running to receive coins sent to you. They’ll be synced to the wallet next time you open it. And you can send BipCoin and then close your wallet a few seconds later. If it says “Sent”, you’re good.

If you don’t type

save

before closing the wallet, it won’t save the blockchain data, and you’ll have to take longer to re-sync next time. It always only has to update from where you last saved.

Sending BipCoin

This below transfers 11 BipCoin to someone, 1 is MixIn (mixing) amount, can be higher with more miners and once you’re synchronized with the blockchain. When you start the first time, you may not be able to use over 0 for the MixIn. Higher is more anonymous. 3 and higher provides full anonymity and untraceability in your transactions. The top limit is largely based on how many people are transacting.

The number at the end of the transaction, “11.0” is the amount you’re sending. Here is sending 11 BipCoin.

(The address used in all these examples is the actual BipCoin donate address. So if you want to test sending and also donate some of what you’ve mined, you can actually just copy and paste or copy, edit and paste these commands.)

Minimum transaction fee is .001 BipCoin. If you don’t specify more, the sender is charged that much. More can speed up transactions on a busy network. The fees go to the miner(s) that confirm that block.

When starting, even when you have some confirmed BipCoin you might not at first be able to make a transfer with a MixIn any higher than zero. After a while you can go up to 1, later to 3. Above 3 is good. The higher the number, the more anonymous. As you are on the network longer, you can go higher. The higher you go, it can take longer to confirm though.

on bipcoind will show you the IP addresses of the current miners. So if you want no one to know you’re mining, use a VPN while mining. It’s probably not needed for anonymous transactions, but it couldn’t hurt. We like BolehVPN.

Or use TOR. Or TOR and a VPN. Without one of those, people may know THAT you’re transacting with BipCoin. But even without those, with a MixIn of 3 or more, they won’t know WHAT amounts you’re transacting or WHO you’re transacting with.

Sometimes when you send with a higher mixin (and sometimes even with a low one), after the transaction, not only will your Available Balance change, your Locked amount will change. Like if you have

Available balance: 58.071835000000, locked amount: 96.192209298359

If you send someone 1 bip with a mixin of 7, after it goes through, you may have
available balance: 55.828775000000, locked amount: 97.434269298359

but the amount moved from available into locked will eventually go back into the available.

These are the two files you’d back up for a wallet that you named “carol”:

To restore your wallet or move to another computer, install the software on that computer, and drop the two backup files

(your wallet name).address (your wallet name).wallet

into the folder. Open bipcoind and simplewallet, then type

o

to open existing wallet. Type the name and password for the backed up wallet and it will open on the new computer.

When you get more BipCoin than you’d be willing to lose if someone hacks you, move the wallet backups into a clean install computer that doesn’t stay online much and cold store it. Or a USB stick. Or both. Go online with it from time to time just long enough to update the blockchain, then go offline.

You don’t need to back up the blockchain, but you could once it gets big enough to take a long time to sync. Then you wouldn’t have to download ALL of it to backup from an old wallet, just from the date you backed it up. The blockchain files are located on Windows at C:\Users\(ComputerUserName)\AppData\Roaming\bipcoin

On Linux, it’s in ~/.bipcoin

BipCoin addresses are 98 character strings.
Monero and Bytecoin addresses are 95-character strings.
This is fine since we add the “bip” at the beginning as an identifier, and the first 4 characters are trivial, per section 3 of the CryptoNote standard.

You can make and run more than one wallet on the same computer. They just need to have different names.

You can also run the same wallet at different times on different computers. Regardless, if you haven’t let too much time pass or made too many transactions, the wallet should update to the current amount when it’s synced with the blockchain.

So let’s say you have ten BipCoin on a wallet on computer A. You transfer that wallet via backups to computer B. You open that wallet on computer B, and when it syncs, it will have ten BipCoin on computer B.

If you then mine on computer B until you have 18 BipCoin, and close the wallet on computer B. Then if you open that same wallet from what is already on computer A, once it syncs, computer A will have 18 BipCoin.

You can also run the same wallet on two computers at once.

It’s easier to open them each time if you make desktop shortcuts to simplewallet and bipcoind.