https://github.com/numtel/nano-webgl-pow
WebGL2 Nano Currency Proof of Work Generation
https://github.com/numtel/nano-webgl-pow
Last synced: about 1 year ago
JSON representation
WebGL2 Nano Currency Proof of Work Generation
- Host: GitHub
- URL: https://github.com/numtel/nano-webgl-pow
- Owner: numtel
- License: mit
- Created: 2018-02-20T20:39:39.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2020-10-24T15:09:07.000Z (over 5 years ago)
- Last Synced: 2025-03-18T13:56:16.440Z (about 1 year ago)
- Language: JavaScript
- Homepage: https://numtel.github.io/nano-webgl-pow/
- Size: 81.1 KB
- Stars: 26
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WebGL2 Nano Currency Proof of Work Generation
Javascript module to generate the proof of work value for [Nano currency](https://nano.org) transactions with the GPU by using a WebGL2 fragment shader that calculates a Blake2B hash.
See the [demo for a working implementation](https://numtel.github.io/nano-webgl-pow/).
WebGL 2 provides bitwise operators unavailable in WebGL 1. These are required for the Blake2B calculation. As of time of writing, WebGL2 is supported in Chrome and Firefox, on desktop and Android. See the [WebGL2 compatibility table](https://caniuse.com/#feat=webgl2) for more information.
## Installation
Download the source code from the repository or with NPM.
```
npm install nano-webgl-pow
```
## Implements
`window.NanoWebglPow(hashHex, callback, progressCallback, threshold);`
Due to using `window.requestAnimationFrame()` to prevent blocking the main thread during generation, the browser tab must remain open during generation.
* `hashHex` `` Previous Block Hash as Hex String
* `callback` `` Called when work value found. Arguments: `work` work value as hex string, `n` number of frames calculated
* `progressCallback` `` Optional. Receives single argument: n, number of frames so far. Return `true` to abort.
* `threshold` `|` Optional work difficulty as 32bit (default if ommited is `0xFFFFFFF8`). Original up to v20 = `0xFFFFFFC0`, v21 Send,Change = `0xFFFFFFF8`, v21 Receive = `0xFFFFFE00`. Max is 64x from original which is `0xFFFFFFFF`.
[More on how to calculate threshold values](https://docs.nano.org/integration-guides/the-basics/#calculating-work)
`window.NanoWebglPow.width, window.NanoWebglPow.height`
Width, height properties for rendered frames during generation. Larger values will load the graphics card more.
Values must be multiples of 256 but do not need to be the same. (i.e. 512x768 is ok, 510x768 is not)
Default: 512x512
## Acknowledgements
* [jaimehgb/RaiBlocksWebAssemblyPoW](https://github.com/jaimehgb/RaiBlocksWebAssemblyPoW) WASM implementation of proof of work generation
* [dcposch/blakejs](https://github.com/dcposch/blakejs) Javascript blake2b as template
## License
MIT