Download & How-To

Share

bob-the-cat-in-mining-tube-2

5/21/17. MANDATORY WALLET UPDATE below!  fixes problem with CryptoNote that was revealed by Monero. We scanned our blockchain, no extra coins were issued.

How to pool mine BipCoin, and links to our new pools.


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.


 

Compiled Linux CLI with the critical update 29.1 MB (30,595,998 bytes)
MD5: 43fe2d30d6ce526aeb92d3ea3491d560 (if you’re updating from previous version, info here.)

Download Windows CLI wallet and daemon v.0004 with critical update 13.8 megs. MD5:8c2f89a8a87279fc5aae639c236912d0

(Here is info on how to update the CLI wallets if you had a previous version of the BipCoin CLI wallets on either Windows or Linux.)

Download Windows GUI wallet v0004 16 megs. MD5: 7612510cc70ffccd90c7509d9a989da5   (UPDATE COMING)

(Here is the fix for the “MSVCP120.dll is missing” error when installing BipCoin GUI wallet on 32-bit Windows.)

Build Linux GUI wallet Info HERE.


While the CLI and GUI wallets may be able to run on the same computer at the same time, we don’t recommend it, as it can cause problems. It’s fine to run both on the same computer at different times.

Directions for backing up the CLI wallets are further down the page. To back up the GUI wallets, go to File / Backup in the wallet.

OUR SOURCE CODE if you want to compile yourself:
https://github.com/BEASTLICK-INTERNET-POLICY-COMMISSION/bipcoin

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)


How to Set up a node.


USING THE WINDOWS and LINUX CLI INTERFACES OF THE BipCoin WALLET.

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.

to open

Wait for the blockchain to sync,

synched

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

synced 2

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.)

simplewallet:
[O]pen existing wallet, [G]enerate new wallet file or [E]xit.

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.

2-HElp-in-both-CMD-windows

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,

right-click

Select Properties.

select-properties

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

Check-both-boxes

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

both-boxes-checked

These options may be here on older computers:

Win-7

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.

Sometimes when pasting from outside CMD to inside CMD, the normal Windows paste command CTRL + V will work. Sometimes. Sometimes right clicking will paste. Sometimes.

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

payments             payments <payment_id_1> [<payment_id_2> … <payment_id_N>] – Show payments <payment_id_1>, … <payment_id_N>

reset                Discard cache data and start synchronizing from the start
save                 Save wallet synchronized data
set_log              set_log <level> – Change current log level, <level> is a number 0-4
start_mining         start_mining [<number_of_threads>] – Start mining in daemon
stop_mining          Stop mining in daemon

transfer             transfer <mixin_count> <addr_1> <amount_1> [<addr_2> <amount_2> … <addr_N> <amount_N>] [-p payment_id] [-f fee] – Transfer <amount_1>,… <amount_N> to <address_1>,… <address_N>, respectively. <mixin_count> is the number of transactions yours is indistinguishable from (from 0 to maximum available)

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.

balance

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.


HELP Commands in bipcoind:
bipcoin v0.0.0.1()
Commands:
exit            Shutdown the daemon
help            Show this help
hide_hr         Stop showing hash rate
print_bc        Print blockchain info in a given blocks range, print_bc <begin_height> [<end_height>]
print_block     Print block, print_block <block_hash> | <block_height>
print_cn        Print connections
print_pl        Print peer list
print_pool      Print transaction pool (long format)
print_pool_sh   Print transaction pool (short format)
print_tx        Print transaction, print_tx <transaction_hash>
set_log         set_log <level> – Change current log level, <level> is a number 0-4
show_hr         Start showing hash rate
start_mining    Start mining for specified address, start_mining <addr> [threads=1]
stop_mining     Stop mining

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.


POOL MINING

Our really cool and solid new mining pool, here.

Tutorial for that pool, and mining in general, is here.

Our other pool on Democats, here.


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 miner with fan

20160823_155512_resized
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.

Desktop miner with central AC floor vent fan

Desktop miner with central AC floor vent fan

Aftermarket additional fan added inside computer to keep it all cool.

Aftermarket additional fan added inside computer to keep it all cool. Mounted on the bottom with Hook & Loop Sticky Back Tape Fabric Fastener.

 

To stop mining, don’t just close your wallet. Instead, type

stop_mining

in simplewallet.

And whether you’re mining or not, when you exit your CLI wallet ALWAYS type

save

in simplewallet, then

exit

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.

transfer 1 bip1ZT7AY9dAE3KYrXcFeoVtFe43WZvGBAA2NFVXXbn4Yxw15gYgekQc7VUFJFHM7DMNsZKRDZAeTe81P8yke37z4JVJupJF1j 11.0

(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.

transfer 3 bip1ZT7AY9dAE3KYrXcFeoVtFe43WZvGBAA2NFVXXbn4Yxw15gYgekQc7VUFJFHM7DMNsZKRDZAeTe81P8yke37z4JVJupJF1j 11.0

You can also speed up the transfer by adding a fee (this is adding a payment fee of .003 BipCoin):

transfer 3 bip1ZT7AY9dAE3KYrXcFeoVtFe43WZvGBAA2NFVXXbn4Yxw15gYgekQc7VUFJFHM7DMNsZKRDZAeTe81P8yke37z4JVJupJF1j 11.0 -f .003

Typing

print_cn

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.

Mining Pool info here.


BACKING UP YOUR WALLET

Copy (to another drive) these files from your BipCoin folder:
(your wallet name).address
(your wallet name).wallet

To another computer or hard drive or USB thumb drive.

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

Carol backup

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.


Please consider running a BipCoin node. It’s simple and cheap or free. How to Set up a node.


More CLI commands and more overall info here: http://cryptonote-coin.org/

If you wanna get really deep and techy, here’s the CryptoNote White Paper.

 

Manspread-deluxe

FoundABlock

bipcat-and-friends2

11 Comments

  1. Kevin Sandefur

    Hi, I am having trouble opening my wallet. I am using the linux cli wallet and running on an Interserver.net VPS. I have been mining on the cryptonote pool site for a few days but wanted to check my balance through the wallet. The wallet loads and says it opens, but never proceeds beyond the use “help” to see a list of commands line. It just flashes a green block for the cursor below that line and locks up there without ever showing the first few characters of the wallet address in yellow. Any help would be appreciated. I have mined just a few coins, but would hate to have to set up a new wallet and lose those. I have tried deleting and restoring a backup file, but with the same result. I am also using the new wallet version 0.0.0.4. I actually started with that.

    Thanks,

    Kevin

    Reply
    1. CatBot (Post author)

      Kevin,

      Sorry you’re having this issue. It’s not a known or common issue. But Computers are an interesting mix of science and voodoo. So:

      Maybe first try without the VPN? I’ve mined over a VPN, but the one you use might have some port blocking or something. The error you describe is the error I got once when my Internet was down, I didn’t notice and I tried to open the Windows CLI wallet.

      If that doesn’t work, I’d recommend you backup your wallet files, delete your blockchain files, re-compile and start again. Directions here.
      https://bipcoin.org/?p=1568

      Please let me know if either works.

      Also, we usually do tech support here, FYI:
      https://bitcointalk.org/index.php?topic=1662140

      More people than just the Devs can help you there.

      MWD

      Reply
  2. Tom

    This image is too funny! reminds me of my cat Shadow, also a jet black feline. https://bipcoin.org/wp-content/uploads/2016/08/Manspread-deluxe-1-240×300.jpg

    Reply
  3. Fisher

    How can I export private key using the GUI wallet?

    Reply
    1. CatBot (Post author)

      File / Backup wallet.

      Reply
      1. Fisher

        So if I understand it well, the PK is the contents of the wallet file and it’s not possible to get some 50 char string like in case of BTC?

        Reply
        1. Fisher

          One more thing, please. Sometimes when I back the wallet up, it has 2.6M, another times 244B. Which size is correct?

          Reply
    2. CatBot (Post author)

      But since I’m extra careful, I’d also save the 3 files mentioned in the second line here:
      https://bipcoin.org/?p=1568

      Reply
  4. CatBot (Post author)

    Fisher,

    Your first question was actually answered on this page, search
    “To back up the GUI wallets, go to File / Backup in the wallet.”

    Since you’re asking questions now that haven’t been asked here, ask the question please here:
    https://bitcointalk.org/index.php?topic=1720595.new
    (you’ll need to set up a free account there to post.)

    That way more than one person can help and more than one person will see the answer, so we don’t have to type the same things over and over.

    Thank you.

    Reply
  5. victorc

    how do i save the block chain. its keeps downloading again and agian? thanks noob here.

    Reply
    1. CatBot (Post author)

      Ask the question please here:
      https://bitcointalk.org/index.php?topic=1720595.new
      (you’ll need to set up a free account there to post.)

      That way more than one person can help and more than one person will see the answer, so we don’t have to type the same things over and over.

      Reply

Leave a Comment

Your email address will not be published. Required fields are marked *