Block.io

image-20240508-161321.png

The BLOCK.IO Hot Wallet API is no longer supported by GENERAL BYTES.

This article is retained for reference purposes only and will be archived shortly without warning.


The Block.io Hot Wallet is a commonly used Hot Wallet option for CAS.

The Free plan from Block.io will not work with CAS.

  • You must subscribe to a paid tier for API access with CAS.

Block.io requires that you whitelist the server with API access.

  • the IP is the public IP of your CAS server.

Your Secret PIN cannot be tested, and (if wrong) will result in transaction failures.

  • Be sure to verify that the Secret PIN is correct if you experience transaction failures.


1. Login to: https://Block.io


2. Navigate to API Keys:


3. Copy your applicable API Key.

  • The API Key is a component of the parameters required for CAS.


4. Whitelist your CAS IP.

Navigate to: https://block.io/dashboard/settings

  • Grant CAS permission to access your account by adding the CAS IPV4 address of your CAS server.


5. Note your Secret PIN.

Your Secret PIN is a required CAS parameter for Block.io. It’s the same Secret PIN you would enter at this screen:

  • Your Secret PIN is not your login password.

  • Your Secret PIN is required for signing transactions.


6. Assemble the required Block.io parameters:

These are the possible Block.io parameters.

Spaces are inserted below for clarity of viewing only.

  • Do not use spaces in your parameter string (around the colons).

apikey : pin : priority : fromLabel

apikey: (required) is located in Step 3.

pin: (required) is the Secret PIN identified in Step 5.

priority: (optional) low/medium/high - these are the mining fees (& corresponding confirmation priority) that will be submitted with each transaction. “low” is the default (if unspecified).

  • Options low, medium, high will (respectively) offer 1x, 2x, and 3x the typical mining fees.

fromLabel: (optional) - use the specified wallet (instead of the default).

  • this is an example “fromLabel” wallet (not recommended for modern use).

This is an example parameter string:

c5bc-58ec-2987-c8ac:MySecretPIN:low:Demo "fromLabel" Wallet

7. Enter the assembled Hot Wallet parameters in Crypto Settings:

  • The “no forward” Block.io option listed is only relevant to SELL transactions (eliminates the normal, temporary wallet used by CAS for monitoring incoming coin submissions).


8. Save the Crypto Setting!


9. Test it.

Test your settings before deploying them.

  1. Save your setting first,

  2. return to the same Crypto Setting,

  3. run the test(s).

See: https://generalbytes.atlassian.net/l/cp/9Zdit1KP

If the test(s) finish successfully, you've configured the Block.io Hot Wallet properly!

  • the final test is at the BATM. Failing transactions may indicate you’ve entered an incorrect Secret PIN. Be sure to verify the Secret PIN is correct.

Copyright © 2020-2024 General Bytes USA LLC