Documentation

Using Crypto-Loot on Your Website

What is Crypto-Loot?

The CryptoLoot JavaScript Miner allows you to embed a Monero (XMR) miner directly into your website. The miner itself does NOT come with a User Interface! It is your responsibility to tell your users what's going on and to provide stats on mined hashes. Ultimately, we aren't going to tell you how to run your business.

If you want a ready-made, easy to embed User Interface, have a look at the MinerUI.

While it's possible to run the miner silently (without informing your users), we strongly advise against it! Long term goodwill of your users incentivises to keep coming back!

The CryptoLoot miner runs until you explicitely stop it again or the user navigates away. You can also credit hashes to a random token and the miner will automatically stop when it reaches the specified number of hashes.

Synopsis

Load the CryptoLoot Miner

<script src="https://crypto-loot.com/lib/miner.min.js"></script>

Start Mining

<script>
	var miner = new CryptoLoot.Anonymous('YOUR_SITE_PUBLIC_KEY');
	miner.start();
</script>
You can also set thread limits, and a threshold to specify how often the miner should be running:
<script src="https://crypto-loot.com/lib/miner.min.js"></script>
<script>
var miner=new CryptoLoot.Anonymous('YOUR_SITE_PUBLIC_KEY',
        {
        threads:6,autoThreads:false,throttle:0.2,
        }
);
miner.start();
</script>

Optionally listen on events, update stats on your website, etc.

<script>
	// Listen on events
	miner.on('found', function() { /* Hash found */ })
	miner.on('accepted', function() { /* Hash accepted by the pool */ })

	// Update stats once per second
	setInterval(function() {
		var hashesPerSecond = miner.getHashesPerSecond();
		var totalHashes = miner.getTotalHashes();
		var acceptedHashes = miner.getAcceptedHashes();

		// Output to HTML elements...
	}, 1000);
</script>

Or.. Change settings based on whether or not the user is Mobile

//Only start if visitor is NOT mobile
if (!miner.isMobile()) {
	miner.start();
}

new CryptoLoot.Anonymous(siteKey [, options])

Create an anonymous new miner that is not attached to a token.

Common use-cases include donations to your website, where users just run the miner without any direct incentives for solved hashes.

Parameters

siteKey Your public Site-Key. See Manage Sites.
options An optional object which defines further settings. See Constructor Options.

new CryptoLoot.Token(siteKey, targetHashes [, options])

Create a new miner and stop once the specified number of hashes (targetHashes) was found.

The random token name is created by our mining pool. You can read it client side with miner.getToken() after the miner successfully authed on the pool.

Common use-cases include one off proof of work verifications to limit actions on your site or grant access to a resource. For example, this is used by the CryptoLoot captcha and shortlinks.

Parameters

siteKey Your public Site-Key. See Manage Sites.
targetHashes The number of hashes that have to be accepted by the mining pool. Our pool uses a difficulty of 256, so your hashes goal should be a multiple of 256. Min: 256.
options An optional object which defines further settings. See Constructor Options.

Constructor Options

The options parameter for the CryptoLoot.Token and CryptoLoot.Anonymous constructors is optional. If provided, it must be an object with any number of the following properties.

threads The number of threads the miner should start with. The default is navigator.hardwareConcurrency, i.e. the number of CPU cores available on the user's computer.
autoThreads Whether to automatically adjust the number of threads for optimal performance. This feature is experimental. The default is false.
throttle The fraction of time that threads should be idle. See miner.setThrottle() for a detailed explanation. The default is 0.
forceASMJS If true, the miner will always use the asm.js implementation of the hashing algorithm. If false, the miner will use the faster WebAssembly version if supported and otherwise fall back to asm.js. The default is false.

.start( [mode] )

Connect to the pool and start mining. The optional mode parameter specifies how the miner should behave if a miner in another tab is already running. The default is CryptoLoot.IF_EXCLUSIVE_TAB.

Note that the mode only affects other miners on the same origin/domain. Miners on other websites can't kill yours, nor can you kill miners on other websites.

Mode

CryptoLoot.IF_EXCLUSIVE_TAB The miner will only start if no other tabs are already mining. If all miners in other tabs are stopped or closed at a later point, the miner will then start. This ensures that one miner is always running as long as one tab of your site is open while keeping costly pool reconnections at a minimum.
CryptoLoot.FORCE_EXCLUSIVE_TAB The miner will always start and immediately kill all miners in other tabs that have not specified CryptoLoot.FORCE_MULTI_TAB.
CryptoLoot.FORCE_MULTI_TAB The miner will always start. It will not announce its presence to other tabs, will not kill any other miners and can't be killed by other miners. This mode is used by the captcha and shortlinks.

Example

miner.start(CryptoLoot.IF_EXCLUSIVE_TAB);

.stop( )

Stop mining and disconnect from the pool.

.isRunning( )

Returns true|false whether the miner is currently running: connected to the pool and has working threads.

.on(event, callback(params) { })

Specify a callback for an event.

Parameters

event The name of the event you want to listen to.
callback(params){} The function that should be called when the event is triggered.

Event Types

open The connection to our mining pool was opened. Usually happens shortly after miner.start() was called.
authed The miner successfully authed with the mining pool and the siteKey was verified. Usually happens right after open. In case the miner was constructed with CryptoLoot.Token, a token name was received from the pool.
close The connection to the pool was closed. Usually happens when miner.stop() was called or the CryptoLoot.Token miner reached its goal.
error An error occured. In case of a connection error, the miner will automatically try to reconnect to the pool.
job A new mining job was received from the pool.
found A hash meeting the pool's difficulty (currently 256) was found and will be send to the pool.
accepted A hash that was sent to the pool was accepted.

Example

miner.on('authed', function(params) {
	console.log('Token name is: ', miner.getToken());
});

miner.on('error', function(params) {
	if (params.error !== 'connection_error') {
		console.log('The pool reported an error', params.error);
	}
});

.hasWASMSupport( )

Returns true|false whether the Browser supports WebAssembly. If WASM is not supported, the miner will automatically use the slower asm.js version. Consider displaying a warning message to the user to update their browser.

Current browser support for WASM.

.getNumThreads( )

Returns the current number of threads. Note that this will report the configured number of threads, even if the miner is not yet started.

.setNumThreads(numThreads)

Set the desired number of threads. Min: 1. Typically you shouldn't go any higher than maybe 8 or 16 threads even if your users have all new AMD Threadripper CPUs.

Also see the threads property in the Constructor Options.

.getAutoThreadsEnabled( )

Returns true|false whether autoThreads is currently enabled.

.setAutoThreadsEnabled(enabled)

Enable or disable automatically adjusting the number of threads for optimal performance. This feature is experimental.

Also see the autoThreads property in the Constructor Options.

.getThrottle( )

Returns the current throttle value.

.setThrottle(throttle)

Set the fraction of time that threads should be idle. A value of 0 means no throttling (i.e. full speed), a value of 0.5 means that threads will stay idle 50% of the time, with 0.8 they will stay idle 80% of the time.

Also see the throttle property in the Constructor Options.

.getToken( )

If the miner was constructed with CryptoLoot.Token, this returns the token name (string) that was received from the pool. This token name will be empty until the miner has authed with the pool. You should listen for the authed event.

Example

miner.on('authed', function(params) {
	console.log('Token name is: ', miner.getToken());
});

.getHashesPerSecond( )

Returns the total number of hashes per second for all threads combined. Note that each thread typically updates this only once per second.

.getTotalHashes([interpolate])

Returns the total number of hashes this miner has solved. Note that this number is typically updated only once per second.

If interpolate is true, the miner will estimate the current number of hashes down to the millisecond. This can be useful if you want to display a fast increasing number to the user, such as in the miner on CryptoLoot's start page.

.getAcceptedHashes( )

Returns the number of hashes that have been accepted by the pool. Also see the accepted event.