evrblk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9924f424ed8bba173f553b935b33bc1d257a8e8c03723e548cda6d805b5d1f2d
+  data.tar.gz: 44770bfbd52e3a904a77fcc1405281d4627680248817f5c645b52051f897a7af
+SHA512:
+  metadata.gz: e0242e58cdde7851fd715020d01cd825777e57adf2f15ef7d9d759a108941e26df879339ae1bd7ceab823bea8e1204a55c1c26c02b5203e9a1c0c50bfff86da4
+  data.tar.gz: d5546338df65de54a9018f4382cf840da2b1506ddeb42248e20a12a8c8e6f688f89d7a6cecb5d36bd332914c65b61ad72aaf8b3926d043c32d4182b3fd293e14

data/Gemfile

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+gem "grpc"
+gem "base64"
+
+group :development do
+  gem "rake"
+  gem "grpc-tools"
+  gem "test-unit"
+
+  # Rubocop changes pretty quickly: new cops get added and old cops change
+  # names or go into new namespaces. This is a library and we don't have
+  # `Gemfile.lock` checked in, so to prevent good builds from suddenly going
+  # bad, pin to a specific version number here. Try to keep this relatively
+  # up-to-date, but it's not the end of the world if it's not.
+  #
+  # The latest version of rubocop is only compatible with Ruby 2.7+
+  gem "rubocop", "1.57.2" if RUBY_VERSION >= "2.7"
+end

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 EVRBLK
+
+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,41 @@
+# Everblack Ruby SDK
+
+## Installing
+
+```
+gem install evrblk
+```
+
+## Example
+
+```ruby
+require "evrblk"
+
+api_key_id = "key_alfa_z141pKeFzfmGGyYlUyPsbF"
+api_key_secret = <<-END
+-----BEGIN EC PRIVATE KEY-----
+MHcCAQEEIN33cCNGxsuxwMaJ2jWvWcgxBSVr8HV7WUUSKGc71/BtoAoGCCqGSM49
+AwEHoUQDQgAE0m8+ZVijytLp01dsupG7QF8ZpjX5UmP20wj/sluPdoHW3BgiiyCn
+/pMwYptUs0yJUtUZ/0wzEyp8PgAWWhxglw==
+-----END EC PRIVATE KEY-----
+END
+
+signer = Evrblk::AuthN::RequestSigner.new(api_key_id, api_key_secret)
+grackle_client = Evrblk::Grackle::Preview::Client.new(signer, "localhost:8000")
+
+grackle_client.create_namespace(
+    name: "mynamespace"
+)
+
+now = Time.now
+grackle_client.acquire_lock(
+    namespace_name: "mynamespace",
+    lock_name: "lock1",
+    process_id: "process1",
+    expires_at: (now.to_i + 60*5) * (10 ** 9) + now.nsec # expires in 5 min
+)
+```
+
+## License
+
+Everblack Ruby SDK is released under the [MIT License](https://opensource.org/licenses/MIT).

data/evrblk.gemspec

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), "lib"))
+
+require "evrblk/version"
+
+Gem::Specification.new do |s|
+  s.name = "evrblk"
+  s.version = Evrblk::VERSION
+  s.required_ruby_version = ">= 2.3.0"
+  s.summary = "Ruby bindings for the Everblack API"
+  s.description = "Build simple, secure, scalable systems with Everblack. " \
+                  "See https://everblack.dev for details."
+  s.authors = ["Stanislav Spiridonov", "Everblack"]
+  s.email = "stanislav@spiridonov.pro"
+  s.homepage = "https://everblack.dev"
+  s.license = "MIT"
+
+  s.metadata = {
+    "bug_tracker_uri" => "https://github.com/evrblk/evrblk-ruby/issues",
+    # "changelog_uri" =>
+    #   "https://github.com/evrblk/evrblk-ruby/blob/master/CHANGELOG.md",
+    "documentation_uri" => "https://everblack.dev/docs",
+    "github_repo" => "ssh://github.com/evrblk/evrblk-ruby",
+    "homepage_uri" => "https://everblack.dev",
+    "source_code_uri" => "https://github.com/evrblk/evrblk-ruby",
+    "rubygems_mfa_required" => "false",
+  }
+
+  ignored = Regexp.union(
+    /\A\.editorconfig/,
+    /\A\.git/,
+    /\A\.rubocop/,
+    /\A\.travis.yml/,
+    /\A\.vscode/,
+    /\A\.cursor/,
+    /\Abin/,
+    /\Atest/
+  )
+  s.files = `git ls-files`.split("\n").grep_v(ignored)
+  s.require_paths = ["lib"]
+end

data/lib/evrblk/authn/alfa.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'openssl'
+require 'base64'
+
+module Evrblk
+  module AuthN
+    class Alfa < Base
+      def initialize(private_key_pem)
+        # Parse the PEM-encoded private key
+        @private_key = OpenSSL::PKey::EC.new(private_key_pem)
+
+        # Verify that the private key is using the correct curve
+        unless @private_key.group.curve_name == 'prime256v1'
+          raise "Invalid key: Expected secp256r1 (prime256v1) but got #{@private_key.group.curve_name}"
+        end
+      end
+
+      def sign(request, timestamp)
+        # Serialize timestamp and request body
+        data = serialize_int64(timestamp) + marshal_protobuf(request)
+
+        # Sign a digest using SHA-256 with the private key
+        signature = @private_key.sign(OpenSSL::Digest::SHA256.new, data)
+
+        # Convert the signature to Base64
+        signature_base64 = Base64.strict_encode64(signature)
+
+        return signature_base64
+      end
+    end
+  end
+end

data/lib/evrblk/authn/base.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Evrblk
+  module AuthN
+    class Base
+      def sign(request, timestamp)
+        raise "Implement me"
+      end
+
+      private
+
+      # Serializes an Int64 value into an 8-byte big-endian
+      def serialize_int64(value)
+        # Ensure the value is within the 64-bit integer range
+        if value < -9223372036854775808 || value > 9223372036854775807
+          raise ArgumentError, "Value is outside the Int64 range"
+        end
+
+        # Pack the integer into 8 bytes with big-endian byte order
+        bytes = [value].pack('q>')
+
+        return bytes
+      end
+
+      # Marshals a protobuf object into a byte array with deterministic serialization.
+      # The deterministic option ensures consistent byte representation regardless of system.
+      def marshal_protobuf(obj)
+        # Ensure the object is a valid protobuf message
+        unless obj.is_a?(Google::Protobuf::MessageExts)
+          raise ArgumentError, "Object must be a Google::Protobuf message"
+        end
+
+        # Marshal the protobuf object with deterministic serialization option
+        options = { deterministic: true }
+
+        # Encode the protobuf message to bytes
+        bytes = obj.to_proto(options)
+
+        return bytes
+      end
+    end
+  end
+end

data/lib/evrblk/authn/bravo.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'base64'
+
+module Evrblk
+  module AuthN
+    class Bravo < Base
+      def initialize(secret_base64)
+
+      end
+
+      def sign(request, timestamp)
+        # Serialize timestamp and request body
+        data = serialize_int64(timestamp) + marshal_protobuf(request)
+
+        # Sign a digest using SHA-256 with the private key
+        signature = @private_key.sign(OpenSSL::Digest::SHA256.new, data)
+
+        # Convert the signature to Base64
+        signature_base64 = Base64.strict_encode64(signature)
+
+        return signature_base64
+      end
+    end
+  end
+end

data/lib/evrblk/authn/request_signer.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Evrblk
+  module AuthN
+    class RequestSigner
+      def initialize(api_key_id, api_key_secret)
+        if !api_key_id.match?(/key_(alfa|bravo)_[0-9a-zA-Z]+/)
+          raise ArgumentError, "Invalid API Key ID #{api_key_id}"
+        end
+        @api_key_id = api_key_id
+
+        if api_key_id.start_with?("key_alfa")
+          @signer = Evrblk::AuthN::Alfa.new(api_key_secret)
+        else
+          @signer = Evrblk::AuthN::Bravo.new(api_key_secret)
+        end
+      end
+
+      def sign(request)
+        # Take current time
+        timestamp = Time.now.to_i
+
+        # Sign the request body with the timestamp
+        signature = @signer.sign(request, timestamp)
+
+        # Return gRPC headers for authentication
+        return {
+	        "evrblk-signature": signature,
+          "evrblk-api-key-id": @api_key_id,
+	        "evrblk-timestamp": timestamp.to_s,
+        }
+      end
+    end
+
+    class NoOpSigner
+      def initialize()
+      end
+
+      def sign(request)
+        return {}
+      end
+    end
+  end
+end

data/lib/evrblk/grackle/preview/api_pb.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: grackle/preview/api.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x19grackle/preview/api.proto\x12\x1a\x63om.evrblk.grackle.preview\";\n\x16\x43reateNamespaceRequest\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\"S\n\x17\x43reateNamespaceResponse\x12\x38\n\tnamespace\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.Namespace\"@\n\x15ListNamespacesRequest\x12\x18\n\x10pagination_token\x18\x01 \x01(\t\x12\r\n\x05limit\x18\x02 \x01(\x05\"\x95\x01\n\x16ListNamespacesResponse\x12\x39\n\nnamespaces\x18\x01 \x03(\x0b\x32%.com.evrblk.grackle.preview.Namespace\x12\x1d\n\x15next_pagination_token\x18\x02 \x01(\t\x12!\n\x19previous_pagination_token\x18\x03 \x01(\t\"-\n\x13GetNamespaceRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\"P\n\x14GetNamespaceResponse\x12\x38\n\tnamespace\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.Namespace\"0\n\x16\x44\x65leteNamespaceRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\"\x19\n\x17\x44\x65leteNamespaceResponse\"E\n\x16UpdateNamespaceRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\"S\n\x17UpdateNamespaceResponse\x12\x38\n\tnamespace\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.Namespace\"n\n\x16\x43reateSemaphoreRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x16\n\x0esemaphore_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x0f\n\x07permits\x18\x04 \x01(\x04\"S\n\x17\x43reateSemaphoreResponse\x12\x38\n\tsemaphore\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.Semaphore\"X\n\x15ListSemaphoresRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x18\n\x10pagination_token\x18\x02 \x01(\t\x12\r\n\x05limit\x18\x03 \x01(\x05\"\x95\x01\n\x16ListSemaphoresResponse\x12\x39\n\nsemaphores\x18\x01 \x03(\x0b\x32%.com.evrblk.grackle.preview.Semaphore\x12\x1d\n\x15next_pagination_token\x18\x02 \x01(\t\x12!\n\x19previous_pagination_token\x18\x03 \x01(\t\"E\n\x13GetSemaphoreRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x16\n\x0esemaphore_name\x18\x02 \x01(\t\"P\n\x14GetSemaphoreResponse\x12\x38\n\tsemaphore\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.Semaphore\"q\n\x17\x41\x63quireSemaphoreRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x16\n\x0esemaphore_name\x18\x02 \x01(\t\x12\x12\n\nprocess_id\x18\x03 \x01(\t\x12\x12\n\nexpires_at\x18\x04 \x01(\x03\"e\n\x18\x41\x63quireSemaphoreResponse\x12\x38\n\tsemaphore\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.Semaphore\x12\x0f\n\x07success\x18\x02 \x01(\x08\"]\n\x17ReleaseSemaphoreRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x16\n\x0esemaphore_name\x18\x02 \x01(\t\x12\x12\n\nprocess_id\x18\x03 \x01(\t\"T\n\x18ReleaseSemaphoreResponse\x12\x38\n\tsemaphore\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.Semaphore\"n\n\x16UpdateSemaphoreRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x16\n\x0esemaphore_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x0f\n\x07permits\x18\x04 \x01(\x04\"S\n\x17UpdateSemaphoreResponse\x12\x38\n\tsemaphore\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.Semaphore\"H\n\x16\x44\x65leteSemaphoreRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x16\n\x0esemaphore_name\x18\x02 \x01(\t\"\x19\n\x17\x44\x65leteSemaphoreResponse\"\xaf\x01\n\tSemaphore\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x12\n\ncreated_at\x18\x03 \x01(\x03\x12\x12\n\nupdated_at\x18\x04 \x01(\x03\x12\x0f\n\x07permits\x18\x05 \x01(\x04\x12\x46\n\x11semaphore_holders\x18\x06 \x03(\x0b\x32+.com.evrblk.grackle.preview.SemaphoreHolder\"L\n\x0fSemaphoreHolder\x12\x12\n\nprocess_id\x18\x01 \x01(\t\x12\x11\n\tlocked_at\x18\x02 \x01(\x03\x12\x12\n\nexpires_at\x18\x03 \x01(\x03\"\x83\x01\n\x16\x43reateWaitGroupRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x17\n\x0fwait_group_name\x18\x02 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\x12\x0f\n\x07\x63ounter\x18\x04 \x01(\x04\x12\x12\n\nexpires_at\x18\x05 \x01(\x03\"T\n\x17\x43reateWaitGroupResponse\x12\x39\n\nwait_group\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.WaitGroup\"X\n\x15ListWaitGroupsRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x18\n\x10pagination_token\x18\x02 \x01(\t\x12\r\n\x05limit\x18\x03 \x01(\x05\"\x96\x01\n\x16ListWaitGroupsResponse\x12:\n\x0bwait_groups\x18\x01 \x03(\x0b\x32%.com.evrblk.grackle.preview.WaitGroup\x12\x1d\n\x15next_pagination_token\x18\x02 \x01(\t\x12!\n\x19previous_pagination_token\x18\x03 \x01(\t\"F\n\x13GetWaitGroupRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x17\n\x0fwait_group_name\x18\x02 \x01(\t\"Q\n\x14GetWaitGroupResponse\x12\x39\n\nwait_group\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.WaitGroup\"I\n\x16\x44\x65leteWaitGroupRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x17\n\x0fwait_group_name\x18\x02 \x01(\t\"\x19\n\x17\x44\x65leteWaitGroupResponse\"]\n\x19\x41\x64\x64JobsToWaitGroupRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x17\n\x0fwait_group_name\x18\x02 \x01(\t\x12\x0f\n\x07\x63ounter\x18\x03 \x01(\x04\"W\n\x1a\x41\x64\x64JobsToWaitGroupResponse\x12\x39\n\nwait_group\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.WaitGroup\"h\n CompleteJobsFromWaitGroupRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x17\n\x0fwait_group_name\x18\x02 \x01(\t\x12\x13\n\x0bprocess_ids\x18\x03 \x03(\t\"^\n!CompleteJobsFromWaitGroupResponse\x12\x39\n\nwait_group\x18\x01 \x01(\x0b\x32%.com.evrblk.grackle.preview.WaitGroup\"\x8e\x01\n\tWaitGroup\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x12\n\ncreated_at\x18\x03 \x01(\x03\x12\x12\n\nupdated_at\x18\x04 \x01(\x03\x12\x12\n\nexpires_at\x18\x05 \x01(\x03\x12\x0f\n\x07\x63ounter\x18\x06 \x01(\x04\x12\x11\n\tcompleted\x18\x07 \x01(\x04\"{\n\x12\x41\x63quireLockRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x11\n\tlock_name\x18\x02 \x01(\t\x12\x12\n\nprocess_id\x18\x03 \x01(\t\x12\x12\n\nwrite_lock\x18\x04 \x01(\x08\x12\x12\n\nexpires_at\x18\x05 \x01(\x03\"V\n\x13\x41\x63quireLockResponse\x12.\n\x04lock\x18\x01 \x01(\x0b\x32 .com.evrblk.grackle.preview.Lock\x12\x0f\n\x07success\x18\x02 \x01(\x08\"S\n\x12ReleaseLockRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x11\n\tlock_name\x18\x02 \x01(\t\x12\x12\n\nprocess_id\x18\x03 \x01(\t\"E\n\x13ReleaseLockResponse\x12.\n\x04lock\x18\x01 \x01(\x0b\x32 .com.evrblk.grackle.preview.Lock\";\n\x0eGetLockRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x11\n\tlock_name\x18\x02 \x01(\t\"A\n\x0fGetLockResponse\x12.\n\x04lock\x18\x01 \x01(\x0b\x32 .com.evrblk.grackle.preview.Lock\">\n\x11\x44\x65leteLockRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x11\n\tlock_name\x18\x02 \x01(\t\"\x14\n\x12\x44\x65leteLockResponse\"S\n\x10ListLocksRequest\x12\x16\n\x0enamespace_name\x18\x01 \x01(\t\x12\x18\n\x10pagination_token\x18\x02 \x01(\t\x12\r\n\x05limit\x18\x03 \x01(\x05\"\x86\x01\n\x11ListLocksResponse\x12/\n\x05locks\x18\x01 \x03(\x0b\x32 .com.evrblk.grackle.preview.Lock\x12\x1d\n\x15next_pagination_token\x18\x02 \x01(\t\x12!\n\x19previous_pagination_token\x18\x03 \x01(\t\"\xe3\x01\n\x04Lock\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x34\n\x05state\x18\x02 \x01(\x0e\x32%.com.evrblk.grackle.preview.LockState\x12\x11\n\tlocked_at\x18\x03 \x01(\x03\x12\x41\n\x11write_lock_holder\x18\x04 \x01(\x0b\x32&.com.evrblk.grackle.preview.LockHolder\x12\x41\n\x11read_lock_holders\x18\x05 \x03(\x0b\x32&.com.evrblk.grackle.preview.LockHolder\"G\n\nLockHolder\x12\x12\n\nprocess_id\x18\x01 \x01(\t\x12\x11\n\tlocked_at\x18\x02 \x01(\x03\x12\x12\n\nexpires_at\x18\x03 \x01(\x03\"V\n\tNamespace\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x12\n\ncreated_at\x18\x03 \x01(\x03\x12\x12\n\nupdated_at\x18\x04 \x01(\x03*<\n\tLockState\x12\x0c\n\x08UNLOCKED\x10\x00\x12\x0f\n\x0bREAD_LOCKED\x10\x01\x12\x10\n\x0cWRITE_LOCKED\x10\x02\x32\x9f\x16\n\x11GracklePreviewApi\x12|\n\x0f\x43reateNamespace\x12\x32.com.evrblk.grackle.preview.CreateNamespaceRequest\x1a\x33.com.evrblk.grackle.preview.CreateNamespaceResponse\"\x00\x12y\n\x0eListNamespaces\x12\x31.com.evrblk.grackle.preview.ListNamespacesRequest\x1a\x32.com.evrblk.grackle.preview.ListNamespacesResponse\"\x00\x12s\n\x0cGetNamespace\x12/.com.evrblk.grackle.preview.GetNamespaceRequest\x1a\x30.com.evrblk.grackle.preview.GetNamespaceResponse\"\x00\x12|\n\x0f\x44\x65leteNamespace\x12\x32.com.evrblk.grackle.preview.DeleteNamespaceRequest\x1a\x33.com.evrblk.grackle.preview.DeleteNamespaceResponse\"\x00\x12|\n\x0fUpdateNamespace\x12\x32.com.evrblk.grackle.preview.UpdateNamespaceRequest\x1a\x33.com.evrblk.grackle.preview.UpdateNamespaceResponse\"\x00\x12|\n\x0f\x43reateSemaphore\x12\x32.com.evrblk.grackle.preview.CreateSemaphoreRequest\x1a\x33.com.evrblk.grackle.preview.CreateSemaphoreResponse\"\x00\x12y\n\x0eListSemaphores\x12\x31.com.evrblk.grackle.preview.ListSemaphoresRequest\x1a\x32.com.evrblk.grackle.preview.ListSemaphoresResponse\"\x00\x12s\n\x0cGetSemaphore\x12/.com.evrblk.grackle.preview.GetSemaphoreRequest\x1a\x30.com.evrblk.grackle.preview.GetSemaphoreResponse\"\x00\x12\x7f\n\x10\x41\x63quireSemaphore\x12\x33.com.evrblk.grackle.preview.AcquireSemaphoreRequest\x1a\x34.com.evrblk.grackle.preview.AcquireSemaphoreResponse\"\x00\x12\x7f\n\x10ReleaseSemaphore\x12\x33.com.evrblk.grackle.preview.ReleaseSemaphoreRequest\x1a\x34.com.evrblk.grackle.preview.ReleaseSemaphoreResponse\"\x00\x12|\n\x0fUpdateSemaphore\x12\x32.com.evrblk.grackle.preview.UpdateSemaphoreRequest\x1a\x33.com.evrblk.grackle.preview.UpdateSemaphoreResponse\"\x00\x12|\n\x0f\x44\x65leteSemaphore\x12\x32.com.evrblk.grackle.preview.DeleteSemaphoreRequest\x1a\x33.com.evrblk.grackle.preview.DeleteSemaphoreResponse\"\x00\x12|\n\x0f\x43reateWaitGroup\x12\x32.com.evrblk.grackle.preview.CreateWaitGroupRequest\x1a\x33.com.evrblk.grackle.preview.CreateWaitGroupResponse\"\x00\x12y\n\x0eListWaitGroups\x12\x31.com.evrblk.grackle.preview.ListWaitGroupsRequest\x1a\x32.com.evrblk.grackle.preview.ListWaitGroupsResponse\"\x00\x12s\n\x0cGetWaitGroup\x12/.com.evrblk.grackle.preview.GetWaitGroupRequest\x1a\x30.com.evrblk.grackle.preview.GetWaitGroupResponse\"\x00\x12|\n\x0f\x44\x65leteWaitGroup\x12\x32.com.evrblk.grackle.preview.DeleteWaitGroupRequest\x1a\x33.com.evrblk.grackle.preview.DeleteWaitGroupResponse\"\x00\x12\x85\x01\n\x12\x41\x64\x64JobsToWaitGroup\x12\x35.com.evrblk.grackle.preview.AddJobsToWaitGroupRequest\x1a\x36.com.evrblk.grackle.preview.AddJobsToWaitGroupResponse\"\x00\x12\x9a\x01\n\x19\x43ompleteJobsFromWaitGroup\x12<.com.evrblk.grackle.preview.CompleteJobsFromWaitGroupRequest\x1a=.com.evrblk.grackle.preview.CompleteJobsFromWaitGroupResponse\"\x00\x12p\n\x0b\x41\x63quireLock\x12..com.evrblk.grackle.preview.AcquireLockRequest\x1a/.com.evrblk.grackle.preview.AcquireLockResponse\"\x00\x12p\n\x0bReleaseLock\x12..com.evrblk.grackle.preview.ReleaseLockRequest\x1a/.com.evrblk.grackle.preview.ReleaseLockResponse\"\x00\x12\x64\n\x07GetLock\x12*.com.evrblk.grackle.preview.GetLockRequest\x1a+.com.evrblk.grackle.preview.GetLockResponse\"\x00\x12m\n\nDeleteLock\x12-.com.evrblk.grackle.preview.DeleteLockRequest\x1a..com.evrblk.grackle.preview.DeleteLockResponse\"\x00\x12j\n\tListLocks\x12,.com.evrblk.grackle.preview.ListLocksRequest\x1a-.com.evrblk.grackle.preview.ListLocksResponse\"\x00\x42PZ3github.com/evrblk/evrblk-go/grackle/preview;grackle\xea\x02\x18\x45vrblk::Grackle::Previewb\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Evrblk
+  module Grackle
+    module Preview
+      CreateNamespaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.CreateNamespaceRequest").msgclass
+      CreateNamespaceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.CreateNamespaceResponse").msgclass
+      ListNamespacesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ListNamespacesRequest").msgclass
+      ListNamespacesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ListNamespacesResponse").msgclass
+      GetNamespaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.GetNamespaceRequest").msgclass
+      GetNamespaceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.GetNamespaceResponse").msgclass
+      DeleteNamespaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.DeleteNamespaceRequest").msgclass
+      DeleteNamespaceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.DeleteNamespaceResponse").msgclass
+      UpdateNamespaceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.UpdateNamespaceRequest").msgclass
+      UpdateNamespaceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.UpdateNamespaceResponse").msgclass
+      CreateSemaphoreRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.CreateSemaphoreRequest").msgclass
+      CreateSemaphoreResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.CreateSemaphoreResponse").msgclass
+      ListSemaphoresRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ListSemaphoresRequest").msgclass
+      ListSemaphoresResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ListSemaphoresResponse").msgclass
+      GetSemaphoreRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.GetSemaphoreRequest").msgclass
+      GetSemaphoreResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.GetSemaphoreResponse").msgclass
+      AcquireSemaphoreRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.AcquireSemaphoreRequest").msgclass
+      AcquireSemaphoreResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.AcquireSemaphoreResponse").msgclass
+      ReleaseSemaphoreRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ReleaseSemaphoreRequest").msgclass
+      ReleaseSemaphoreResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ReleaseSemaphoreResponse").msgclass
+      UpdateSemaphoreRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.UpdateSemaphoreRequest").msgclass
+      UpdateSemaphoreResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.UpdateSemaphoreResponse").msgclass
+      DeleteSemaphoreRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.DeleteSemaphoreRequest").msgclass
+      DeleteSemaphoreResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.DeleteSemaphoreResponse").msgclass
+      Semaphore = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.Semaphore").msgclass
+      SemaphoreHolder = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.SemaphoreHolder").msgclass
+      CreateWaitGroupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.CreateWaitGroupRequest").msgclass
+      CreateWaitGroupResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.CreateWaitGroupResponse").msgclass
+      ListWaitGroupsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ListWaitGroupsRequest").msgclass
+      ListWaitGroupsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ListWaitGroupsResponse").msgclass
+      GetWaitGroupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.GetWaitGroupRequest").msgclass
+      GetWaitGroupResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.GetWaitGroupResponse").msgclass
+      DeleteWaitGroupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.DeleteWaitGroupRequest").msgclass
+      DeleteWaitGroupResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.DeleteWaitGroupResponse").msgclass
+      AddJobsToWaitGroupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.AddJobsToWaitGroupRequest").msgclass
+      AddJobsToWaitGroupResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.AddJobsToWaitGroupResponse").msgclass
+      CompleteJobsFromWaitGroupRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.CompleteJobsFromWaitGroupRequest").msgclass
+      CompleteJobsFromWaitGroupResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.CompleteJobsFromWaitGroupResponse").msgclass
+      WaitGroup = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.WaitGroup").msgclass
+      AcquireLockRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.AcquireLockRequest").msgclass
+      AcquireLockResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.AcquireLockResponse").msgclass
+      ReleaseLockRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ReleaseLockRequest").msgclass
+      ReleaseLockResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ReleaseLockResponse").msgclass
+      GetLockRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.GetLockRequest").msgclass
+      GetLockResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.GetLockResponse").msgclass
+      DeleteLockRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.DeleteLockRequest").msgclass
+      DeleteLockResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.DeleteLockResponse").msgclass
+      ListLocksRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ListLocksRequest").msgclass
+      ListLocksResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.ListLocksResponse").msgclass
+      Lock = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.Lock").msgclass
+      LockHolder = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.LockHolder").msgclass
+      Namespace = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.Namespace").msgclass
+      LockState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("com.evrblk.grackle.preview.LockState").enummodule
+    end
+  end
+end

data/lib/evrblk/grackle/preview/api_services_pb.rb

@@ -0,0 +1,48 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: grackle/preview/api.proto for package 'Evrblk.Grackle.Preview'
+
+require 'grpc'
+require 'evrblk/grackle/preview/api_pb'
+
+module Evrblk
+  module Grackle
+    module Preview
+      module GracklePreviewApi
+        class Service
+
+          include ::GRPC::GenericService
+
+          self.marshal_class_method = :encode
+          self.unmarshal_class_method = :decode
+          self.service_name = 'com.evrblk.grackle.preview.GracklePreviewApi'
+
+          rpc :CreateNamespace, ::Evrblk::Grackle::Preview::CreateNamespaceRequest, ::Evrblk::Grackle::Preview::CreateNamespaceResponse
+          rpc :ListNamespaces, ::Evrblk::Grackle::Preview::ListNamespacesRequest, ::Evrblk::Grackle::Preview::ListNamespacesResponse
+          rpc :GetNamespace, ::Evrblk::Grackle::Preview::GetNamespaceRequest, ::Evrblk::Grackle::Preview::GetNamespaceResponse
+          rpc :DeleteNamespace, ::Evrblk::Grackle::Preview::DeleteNamespaceRequest, ::Evrblk::Grackle::Preview::DeleteNamespaceResponse
+          rpc :UpdateNamespace, ::Evrblk::Grackle::Preview::UpdateNamespaceRequest, ::Evrblk::Grackle::Preview::UpdateNamespaceResponse
+          rpc :CreateSemaphore, ::Evrblk::Grackle::Preview::CreateSemaphoreRequest, ::Evrblk::Grackle::Preview::CreateSemaphoreResponse
+          rpc :ListSemaphores, ::Evrblk::Grackle::Preview::ListSemaphoresRequest, ::Evrblk::Grackle::Preview::ListSemaphoresResponse
+          rpc :GetSemaphore, ::Evrblk::Grackle::Preview::GetSemaphoreRequest, ::Evrblk::Grackle::Preview::GetSemaphoreResponse
+          rpc :AcquireSemaphore, ::Evrblk::Grackle::Preview::AcquireSemaphoreRequest, ::Evrblk::Grackle::Preview::AcquireSemaphoreResponse
+          rpc :ReleaseSemaphore, ::Evrblk::Grackle::Preview::ReleaseSemaphoreRequest, ::Evrblk::Grackle::Preview::ReleaseSemaphoreResponse
+          rpc :UpdateSemaphore, ::Evrblk::Grackle::Preview::UpdateSemaphoreRequest, ::Evrblk::Grackle::Preview::UpdateSemaphoreResponse
+          rpc :DeleteSemaphore, ::Evrblk::Grackle::Preview::DeleteSemaphoreRequest, ::Evrblk::Grackle::Preview::DeleteSemaphoreResponse
+          rpc :CreateWaitGroup, ::Evrblk::Grackle::Preview::CreateWaitGroupRequest, ::Evrblk::Grackle::Preview::CreateWaitGroupResponse
+          rpc :ListWaitGroups, ::Evrblk::Grackle::Preview::ListWaitGroupsRequest, ::Evrblk::Grackle::Preview::ListWaitGroupsResponse
+          rpc :GetWaitGroup, ::Evrblk::Grackle::Preview::GetWaitGroupRequest, ::Evrblk::Grackle::Preview::GetWaitGroupResponse
+          rpc :DeleteWaitGroup, ::Evrblk::Grackle::Preview::DeleteWaitGroupRequest, ::Evrblk::Grackle::Preview::DeleteWaitGroupResponse
+          rpc :AddJobsToWaitGroup, ::Evrblk::Grackle::Preview::AddJobsToWaitGroupRequest, ::Evrblk::Grackle::Preview::AddJobsToWaitGroupResponse
+          rpc :CompleteJobsFromWaitGroup, ::Evrblk::Grackle::Preview::CompleteJobsFromWaitGroupRequest, ::Evrblk::Grackle::Preview::CompleteJobsFromWaitGroupResponse
+          rpc :AcquireLock, ::Evrblk::Grackle::Preview::AcquireLockRequest, ::Evrblk::Grackle::Preview::AcquireLockResponse
+          rpc :ReleaseLock, ::Evrblk::Grackle::Preview::ReleaseLockRequest, ::Evrblk::Grackle::Preview::ReleaseLockResponse
+          rpc :GetLock, ::Evrblk::Grackle::Preview::GetLockRequest, ::Evrblk::Grackle::Preview::GetLockResponse
+          rpc :DeleteLock, ::Evrblk::Grackle::Preview::DeleteLockRequest, ::Evrblk::Grackle::Preview::DeleteLockResponse
+          rpc :ListLocks, ::Evrblk::Grackle::Preview::ListLocksRequest, ::Evrblk::Grackle::Preview::ListLocksResponse
+        end
+
+        Stub = Service.rpc_stub_class
+      end
+    end
+  end
+end

data/lib/evrblk/grackle/preview/client.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+module Evrblk::Grackle::Preview
+    class Client
+      def initialize(request_signer, endpoint)
+        @grpc = Evrblk::Grackle::Preview::GracklePreviewApi::Stub.new(endpoint, :this_channel_is_insecure)
+        @request_signer = request_signer
+      end
+    
+      def create_namespace(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::CreateNamespaceRequest)
+        @grpc.create_namespace(request, metadata: @request_signer.sign(request))
+      end
+
+      def list_namespaces(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::ListNamespacesRequest)
+        @grpc.list_namespaces(request, metadata: @request_signer.sign(request))
+      end
+
+      def get_namespace(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::GetNamespaceRequest)
+        @grpc.get_namespace(request, metadata: @request_signer.sign(request))
+      end
+
+      def delete_namespace(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::DeleteNamespaceRequest)
+        @grpc.delete_namespace(request, metadata: @request_signer.sign(request))
+      end
+
+      def update_namespace(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::UpdateNamespaceRequest)
+        @grpc.update_namespace(request, metadata: @request_signer.sign(request))
+      end
+
+      def create_semaphore(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::CreateSemaphoreRequest)
+        @grpc.create_semaphore(request, metadata: @request_signer.sign(request))
+      end
+
+      def list_semaphores(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::ListSemaphoresRequest)
+        @grpc.list_semaphores(request, metadata: @request_signer.sign(request))
+      end
+
+      def get_semaphore(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::GetSemaphoreRequest)
+        @grpc.get_semaphore(request, metadata: @request_signer.sign(request))
+      end
+
+      def acquire_semaphore(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::AcquireSemaphoreRequest)
+        @grpc.acquire_semaphore(request, metadata: @request_signer.sign(request))
+      end
+
+      def release_semaphore(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::ReleaseSemaphoreRequest)
+        @grpc.release_semaphore(request, metadata: @request_signer.sign(request))
+      end
+
+      def update_semaphore(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::UpdateSemaphoreRequest)
+        @grpc.update_semaphore(request, metadata: @request_signer.sign(request))
+      end
+
+      def delete_semaphore(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::DeleteSemaphoreRequest)
+        @grpc.delete_semaphore(request, metadata: @request_signer.sign(request))
+      end
+
+      def create_wait_group(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::CreateWaitGroupRequest)
+        @grpc.create_wait_group(request, metadata: @request_signer.sign(request))
+      end
+
+      def list_wait_groups(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::ListWaitGroupsRequest)
+        @grpc.list_wait_groups(request, metadata: @request_signer.sign(request))
+      end
+
+      def get_wait_group(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::GetWaitGroupRequest)
+        @grpc.get_wait_group(request, metadata: @request_signer.sign(request))
+      end
+
+      def delete_wait_group(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::DeleteWaitGroupRequest)
+        @grpc.delete_wait_group(request, metadata: @request_signer.sign(request))
+      end
+
+      def add_jobs_to_wait_group(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::AddJobsToWaitGroupRequest)
+        @grpc.add_jobs_to_wait_group(request, metadata: @request_signer.sign(request))
+      end
+
+      def complete_jobs_from_wait_group(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::CompleteJobsFromWaitGroupRequest)
+        @grpc.complete_jobs_from_wait_group(request, metadata: @request_signer.sign(request))
+      end
+
+      def acquire_lock(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::AcquireLockRequest)
+        @grpc.acquire_lock(request, metadata: @request_signer.sign(request))
+      end
+
+      def release_lock(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::ReleaseLockRequest)
+        @grpc.release_lock(request, metadata: @request_signer.sign(request))
+      end
+
+      def get_lock(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::GetLockRequest)
+        @grpc.get_lock(request, metadata: @request_signer.sign(request))
+      end
+
+      def delete_lock(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::DeleteLockRequest)
+        @grpc.delete_lock(request, metadata: @request_signer.sign(request))
+      end
+
+      def list_locks(request_hash)
+        request = Evrblk::HashConverter.hash_to_grpc_message(request_hash, Evrblk::Grackle::Preview::ListLocksRequest)
+        @grpc.list_locks(request, metadata: @request_signer.sign(request))
+      end  
+    end
+  end
+  

data/lib/evrblk/hash_converter.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Evrblk
+  class HashConverter
+    def self.hash_to_grpc_message(source_hash, message_class)
+      serialize_with_descriptor(message_class.descriptor, source_hash.dup)
+    end
+
+    private
+
+    def self.serialize_with_descriptor(descriptor_class, hash_value)
+      return hash_value if descriptor_class.nil?
+
+      new_hash = {}
+      available_keys = hash_value.keys
+      descriptor_class.entries.each do |entry|
+        is_key_present = available_keys.include?(entry.name.to_sym)
+        value = serialize_with_field_descriptor(entry, hash_value[entry.name.to_sym], is_key_present: is_key_present)
+        unless value.nil?
+          new_hash[entry.name] = value
+        end
+      end
+
+      descriptor_class.msgclass.new(new_hash)
+    end
+
+    def self.serialize_with_field_descriptor(field_descriptor, value, is_key_present: true)
+      return value if field_descriptor.nil?
+
+      if field_descriptor.label == :repeated
+        return serialize_with_repeated_field(field_descriptor, value)
+      end
+      if field_descriptor.type == :message
+        if field_descriptor.subtype.is_a?(Google::Protobuf::Descriptor)
+          return serialize_with_descriptor(field_descriptor.subtype, value) unless value.nil?
+        end
+
+        return field_descriptor.subtype.msgclass.new(value) unless value.nil?
+
+      end
+      value
+    end
+
+    def self.serialize_with_repeated_field(field_descriptor, value)
+      if field_descriptor.label == :repeated
+        if field_descriptor.subtype && field_descriptor.subtype.lookup("key")
+          if field_descriptor.subtype.lookup("value")
+            value_dup = ({})
+            org_value = value || {}
+            org_value.keys.each do |k|
+              value_dup[k.to_s] = (serialize_with_field_descriptor(field_descriptor.subtype.lookup("value"), org_value[k]))
+            end
+            return value_dup
+          else
+            return value
+          end
+        end
+        return (value || []).map  { |v| serialize_with_descriptor(field_descriptor.subtype, v) }
+      end
+    end
+  end
+end