JavaScript Miner

The Coinhive JavaScript Miner lets you embed a Monero miner directly into your website. The miner itself does not come with a User Interface – it's your responsibility to tell your users what's going on and to provide stats on mined hashes.

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

While it's possible to run the miner without informing your users, we strongly advise against it. You know this. Long term goodwill of your users is much more important than any short term profits.

You can credit found hashes to a user name or let it run anonymously. The 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.

See the HTTP API documentation on how to get the balance for a user name (the number of hashes accepted) and withdraw hashes, and how to verify a token.

Synopsis

Load the Coinhive Miner and start Mining with the recommended settings - 70% CPU usage, disabled on mobile:

<script src="https://authedmine.com/lib/authedmine.min.js"></script>
<script>
	var miner = new CoinHive.Anonymous('YOUR_SITE_KEY', {throttle: 0.3});

	// Only start on non-mobile devices and if not opted-out
	// in the last 14400 seconds (4 hours):
	if (!miner.isMobile() && !miner.didOptOut(14400)) {
		miner.start();
	}
</script>

Note that the Miner is loaded from a different domain (authedmine.com) that enforces an opt-in as soon as miner.start() is called.

You may load the miner from https://coinhive.com/lib/coinhive.min.js instead if you don't want to show the opt-in screen. See our AuthedMine documentation for the details.

Optionally you can 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>

API Reference

Constructors

• CoinHive.Anonymous(siteKey [, options])
• CoinHive.User(siteKey, userName [, options])
• CoinHive.Token(siteKey, targetHashes [, options])

Instance Methods

• .start([mode])
• .stop()
• .isRunning()
• .isMobile()
• .didOptOut(seconds)
• .on(event, callback)
• .hasWASMSupport()
• .getNumThreads()
• .setNumThreads(numThreads)
• .getThrottle()
• .setThrottle(throttle)
• .getToken()
• .getHashesPerSecond()
• .getTotalHashes([interpolate])
• .getAcceptedHashes()

new CoinHive.Anonymous(siteKey [, options])

Create a new miner that is not attached to a token or user name.

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

Parameters

new CoinHive.User(siteKey, userName [, options])

Create a new miner and credit all hashes to the specified user name. You can check a user's balance and withdraw hashes for a user with our HTTP API.

Common use-cases include granting in-game currency or other incentives to a user account on your website in turn for running the miner.

Please only use the CoinHive.User miner if you later intend to retreive the number of hashes using the HTTP API. Don't use it to store random session names that you never read back.

Parameters

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

Create a new miner and stop once the specified number of hashes (targetHashes) was found. Tokens can be verified with our HTTP API. Tokens remain valid for 1 hour after they have reached the target.

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 Coinhive captcha and shortlinks.

Parameters

Constructor Options

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

Full example, using the CoinHive.User miner:

var miner = new CoinHive.User('YOUR_SITE_KEY', 'john-doe', {
	threads: 4,
	throttle: 0.8,
	forceASMJS: false,
	theme: 'dark',
	language: 'auto'
});

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

When loaded through authedmine.com our JavaScript API will ask the user for consent as soon as .start() is called. See our AuthedMine documentation for the details.

Mode

Example

miner.start(CoinHive.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.

.isMobile( )

Returns true|false whether the user is using a phone or tablet device. You can use this to only start the miner on laptops and PCs.

Example

// Only start on non-mobile devices
if (!miner.isMobile()) {
	miner.start();
}

.didOptOut( [seconds] )

Returns true|false whether the user has clicked the "Cancel" button in the opt-in screen in the last seconds seconds. The seconds parameter is optional and defaults to 14400 (4 hours).

You can use this function to only show the opt-in screen again after a certain time, if the user has canceled the previous opt-in.

Example

// Only attempt to start and show the opt-in screen every 4 hours:
if (!miner.didOptOut(60 * 60 * 4)) {
	miner.start();
}

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

Specify a callback for an event.

Parameters

Event Types

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);
	}
});

miner.on('optin', function(params) {
	if (params.status === 'accepted') {
		console.log('User accepted opt-in');
	}
	else {
		console.log('User canceled opt-in');
	}
});

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

.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 CoinHive.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 Coinhive's start page.

.getAcceptedHashes( )

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

For the CoinHive.User miner, this includes all hashes ever accepted for the current user name.