module IcAgent::Utils - RDoc Documentation

decode_blob(blob_bytes) click to toggle source

Decodes a binary blob into a string.

Parameters:

blob_bytes: The binary blob to decode.

Returns: The decoded string.

# File lib/ic_agent/utils.rb, line 99
def self.decode_blob(blob_bytes)
  blob_bytes.pack('C*')
end

encode_list(l) click to toggle source

Encodes a list of items into a binary string.

Parameters:

l: The list of items to encode.

Returns: The binary string representation of the encoded list.

# File lib/ic_agent/utils.rb, line 12
def self.encode_list(l)
  ret = ''
  l.each do |item|
    v = item
    if item.is_a?(Array)
      v = encode_list(item)
    end
    if item.is_a?(Integer)
      v = LEB128.encode_signed(v)
    end
    if item.is_a?(String)
      v = item
    end
    ret += Digest::SHA256.digest(v)
  end
  ret
end

idl_hash(s) click to toggle source

Computes a hash value for an IDL string.

Parameters:

s: The IDL string to hash.

Returns: The computed hash value.

# File lib/ic_agent/utils.rb, line 61
def self.idl_hash(s)
  h = 0
  s.bytes.each do |c|
    h = (h * 223 + c) % 2**32
  end
  h
end

label_hash(s) click to toggle source

Computes a hash value for sorting records by key.

Parameters:

s: The key to hash.

Returns: The computed hash value.

# File lib/ic_agent/utils.rb, line 36
def self.label_hash(s)
  if s =~ /(^_\d+_$)|(^_0x[0-9a-fA-F]+_$)/
    num = s[1..-2]
    begin
      if num.start_with?("0x")
        num = num.to_i(16)
      else
        num = num.to_i
      end
    rescue
      # fallback
    end
    if num.is_a?(Integer) && num >= 0 && num < 2**32
      return num
    end
  end
  idl_hash(s)
end

to_request_id(d) click to toggle source

Converts a data structure into a request ID.

Parameters:

d: The data structure to convert.

Returns: The request ID as a binary string.

# File lib/ic_agent/utils.rb, line 75
def self.to_request_id(d)
  return nil unless d.is_a?(Hash)

  vec = []

  d.each do |k, v|
    v = encode_list(v) if v.is_a?(Array)
    v = LEB128.encode_signed(v).string if v.is_a?(Integer)
    k = k.hex unless k.is_a?(String)
    v = v.str2hex unless v.is_a?(String)
    h_k = Digest::SHA256.digest(k)
    h_v = Digest::SHA256.digest(v)
    vec << h_k + h_v
  end
  s = vec.sort.join
  Digest::SHA256.digest(s)
end