yolodice-validator 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8a2160b0ead0ebe22d92886f3df4a16e9573508e
+  data.tar.gz: d7ff434b6b0abd5c95261d3326049c49bc8c27f9
+SHA512:
+  metadata.gz: eda200e0a3523860383c5e36615195d85858eeea5bcc2f69fb23b41e7a32cad591a7bac3cf902f7a7a2f986bb1e7ee3d78fd304dd815908c848e68bd8561dc9e
+  data.tar.gz: b9b0f506d8dda7fd26f0351f759e2219828f009ac546ea3d9cdfc32be2ac2f5ed905e6552640270d314fda4f807120871f3565196dd5a22917e9cbe42b17321b

data/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright (c) 2016 Ethan White (YOLOdice.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,63 @@
+YOLOdice bet validator
+======================
+
+[YOLOdice](https://yolodice.com) is a simple online Bitcoin game you can play against the house. In heart of it lies a pseudorandom number generator that returns bet results used to determine if bets placed by players win or lose. Players can independently verify if the bets are "fair".
+
+This Ruby utility let's you validate the following:
+
+* if the seed hash matches the seed,
+* if your bets on YOLOdice have been generated according to the *Provably fair* algorithm,
+* if the profit for each bet has been calculated properly.
+
+For more information about the algorithms used in YOLOdice, check out our [Frequently Asked Questions](https://yolodice.dev/#faq/provably-fair).
+
+## Installation
+
+The validator does not depend on any gems. It's only necessare to get the validator's code to use it. Alternatively you can install it as a gem. It will then install it's own executable, `yolodice-validator` in the system.
+
+### Using a gem from RubyGems
+
+    gem install yolodice-validator
+
+### By cloning the git repo
+
+    git clone https://github.com/ethan-nx/yolodice-validator.git
+
+This will clone the whole repo.
+
+### Download the ZIP archive and unpack it
+
+Github provides a ZIP archive of the most current revision of the code. Find it here: https://github.com/ethan-nx/yolodice-validator/archive/master.zip
+
+
+## Usage
+
+If you installed the utility as a gem in order to run the code simply type:
+
+    yolodice_validator DUMP_FILE
+
+If you cloned the git repo or downloaded the source, try this:
+
+    ruby lib/yolodice-validator.rb DUMP_FILE
+
+You can get the `DUMP_FILE` by visiting your YOLOdice account and entering the [Seeds panel](https://yolodice.com/#seeds). Then click on any archived seed, a pop-up will appear. Click "Verify bets" button and download the generated dump. That's the file you need.
+
+Example usage:
+
+
+    $ yolodice_validator ~/Downloads/seed_dump_2.csv
+    Seed seems OK, validating individual bets
+    .................................................
+    All bets verified OK
+
+Example check of a seed that contains invalid data:
+
+    $ yolodice_validator ~/Downloads/seed_dump_2.csv
+    MISMATCH: secret_hashed_hex, in file: e93e86fd421942a319403738e7dcdbe1f1bf3371ae43d26ff6768d97c2c948d0, calculated: e93e86fd421942a319409738e7dcdbe1f1bf3371ae43d26ff6768d97c2c948d0
+    Seed data is not valid, checking bets anyway.
+    MISMATCH: bet 6 result, in file: 723763, calculated: 729763
+    MISMATCH: bet 7 result, in file: 899308, calculated: 499308
+    MISMATCH: bet 7 profit, in file: 2, calculated: 0
+    .................................................
+    4 errors found.
+

data/bin/yolodice-validator

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'yolodice_validator'
+
+options = YolodiceValidator.parse_opts ARGV
+YolodiceValidator.run options

data/bin/yolodice-validator~

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+require 'yolodice_validator'
+
+if __FILE__ == $0
+  options = YolodiceValidator.parse_opts ARGV
+  YolodiceValidator.run options
+end

data/lib/yolodice_validator.rb

@@ -0,0 +1,153 @@
+# Copyright (c) 2016 Ethan White (YOLOdice.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a
+# copy of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in 
+# all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+# DEALINGS IN THE SOFTWARE.
+
+require 'openssl'
+require 'csv'
+
+class YolodiceGenerator
+
+  def initialize server_key_hex, client_phrase
+    @server_key = [server_key_hex].pack("H*")
+    @client_phrase = client_phrase
+  end
+
+  def server_key_hex
+    @server_key.unpack('H*')[0]
+  end
+
+  def server_key_hash_hex
+    # OpenSSL::Digest::SHA256.hexdigest server_key_hex
+    OpenSSL::Digest::SHA256.hexdigest server_key_hex
+  end
+
+  # Runs the algorithm that returns bet result.
+  def roll nonce
+    hash = OpenSSL::HMAC.hexdigest 'sha512', @server_key, "#{@client_phrase}.#{nonce}"
+    out = nil
+    while !out || out >= 1_000_000
+      out = hash.slice!(0,5).to_i 16
+    end
+    out
+  end
+
+  # When given bet result and bet input parameters the function returns a Hash
+  # that include bet profit.
+  def generate_bet nonce, amount, target, range
+    result = roll nonce
+    profit = (amount * (1_000_000.to_f / target * (1 - 0.01) - 1)).floor
+    win = case range
+          when 'lo'
+            result < target
+          when 'hi'
+            result > 999_999 - target
+          end
+    profit = -amount unless win
+    {
+      result: result,
+      profit: profit,
+      win: win
+    }
+  end
+
+end
+
+class YolodiceValidator
+
+  def initialize input_file
+    @input_file = input_file
+    @mismatch_count = 0
+  end
+
+  def run
+    CSV.open @input_file do |file|
+      # parse first line
+      seed_id0, secret_hashed_hex0, secret_hex0, client_phrase0, seed_created_at0 = file.shift
+      @generator = YolodiceGenerator.new secret_hex0, client_phrase0
+      assume 'secret_hashed_hex', secret_hashed_hex0, @generator.server_key_hash_hex
+      if @mismatch_count == 0
+        puts "Seed seems OK, validating individual bets."
+      else
+        puts "Seed data is not valid, checking bets anyway."
+      end
+      print '.'
+      @last_dot = true
+      # read the rest of lines, verify individual bets
+      while bet_data = file.shift do
+        bet_id0, nonce0, rolled0, target0, range0, amount0, profit0 = bet_data
+        bet_id0 = bet_id0.to_i
+        nonce0 = nonce0.to_i
+        rolled0 = rolled0.to_i
+        target0 = target0.to_i
+        amount0 = amount0.to_i
+        profit0 = profit0.to_i
+
+        bet = @generator.generate_bet nonce0, amount0, target0, range0
+        assume "bet #{bet_id0} result", rolled0.to_i, bet[:result]
+        assume "bet #{bet_id0} profit", profit0.to_i, bet[:profit]
+        if nonce0 % 1000 == 0
+          print '.' 
+          @last_dot = true
+        end
+      end
+      print "\n"
+      if @mismatch_count == 0
+        puts "All bets verified OK"
+      else
+        puts "#{@mismatch_count} errors found."
+      end
+
+    end
+  end
+
+  private
+  def assume label, v0, v1
+    unless v0 == v1
+      print "\n" if @last_dot
+      puts "MISMATCH: #{label}, in file: #{v0}, calculated: #{v1}"
+      @mismatch_count += 1
+      @last_dot = false
+    end
+
+  end
+
+  class << self
+    
+    def parse_opts argv
+      # There is only one option - pass a file containing a CSV dump
+      usage = "Usage: yolodice_validator DUMP_FILE"
+      unless argv.length == 1
+        puts usage
+        exit
+      end
+      return { input_file: argv[0] }
+    end
+
+    def run opts
+      yv = YolodiceValidator.new opts[:input_file]
+      yv.run
+    end
+
+  end
+end
+
+if __FILE__ == $0
+  options = YolodiceValidator.parse_opts ARGV
+  YolodiceValidator.run options
+end

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: yolodice-validator
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ethan_nx
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-24 00:00:00.000000000 Z
+dependencies: []
+description: A utility that lets you verify your bets and seeds from the Bitcoin game
+  YOLOdice.com.
+email: 
+executables:
+- yolodice-validator
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- bin/yolodice-validator
+- bin/yolodice-validator~
+- lib/yolodice_validator.rb
+homepage: https://github.com/ethan-nx/yolodice-validator
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Bet validator for YOLOdice.com
+test_files: []