fabric-gateway 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84dbcb3d572350e328ca48178859e0edfc7f57bbc331980612c4c5f537701b12
-  data.tar.gz: 9aaeed65be8ea7b5296e4e4fb12d8027583581cca24c96ccdf4f7a3afb781758
+  metadata.gz: a5f0568b7e6de9981790fc25887fb4b063d2a2b4b4013b3762f0ae5cb5255aaf
+  data.tar.gz: 88c6ba3db543a3c1bc0a138e7e40325a1cdfd680bd6bcb39c907ba7aa848f6b1
 SHA512:
-  metadata.gz: a931d1e6fff596991560afedd817f3091e0c393c4b6aefa9eed5f3dfee19f37db8b1f744c9ea9b4375d661bdf1c0b4c72402eb9048225be7d028569520fb8d23
-  data.tar.gz: 553c329d4dbb5b9b7729e5c1226f2c680901e40e27f630ce1f577fd9f4c33eb648b06a8ab92630873c8ded4be7ba4870b82fbef236a0520d848371b09d5de848
+  metadata.gz: a51e59cdc705fd1891221933f0ee146f685d64602fe75ef0ae71a125eb14023b927f5b86990225369b115bf3f96fc5d9d2aa851c52492dc4a7211a7f6f3cba88
+  data.tar.gz: 926eafcb4b4c5047099cffca1d4ca9d1d2ea2a761e352e8300b08ae7c01f7c7340940b613096562e77f1448e7599c87a5f84ea55dad5779eded99c374dfd7246

data/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,71 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '25 10 * * 6'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'ruby' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v1
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v1
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v1
+

data/.github/workflows/rubocop.yml

@@ -3,7 +3,7 @@ name: RuboCop
 on: [push, pull_request]
 
 jobs:
-  build:
+  lint:
     runs-on: ubuntu-latest
 
     steps:

data/.github/workflows/todo.yml

@@ -0,0 +1,10 @@
+name: "TODO to Github Issues"
+on: ["pull_request"]
+jobs:
+  build:
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: "actions/checkout@master"
+      - name: "TODO to Issue"
+        uses: "alstr/todo-to-issue-action@v4.5"
+        id: "todo"

data/.github/workflows/yardoc.yml

@@ -0,0 +1,28 @@
+name: Yardoc Documentation Coverage
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby 2.7
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 2.7
+    - name: Cache gems
+      uses: actions/cache@v1
+      with:
+        path: vendor/bundle
+        key: ${{ runner.os }}-yardoc-${{ hashFiles('**/Gemfile.lock') }}
+        restore-keys: |
+          ${{ runner.os }}-yardoc-
+    - name: Install gems
+      run: |
+        bundle config path vendor/bundle
+        bundle config set without 'default doc job cable storage ujs test db'
+        bundle install --jobs 4 --retry 3
+    - name: Run yard stats
+      run: bundle exec yard stats --list-undoc --no-cache --fail-on-warning

data/.yardopts

@@ -1,2 +1,8 @@
+--exclude lib/gateway
+--exclude lib/msp
+--exclude lib/gossip
+--exclude lib/orderer
+--exclude lib/peer
+--exclude lib/common
 --markup-provider=redcarpet
 --markup=markdown

data/README.md

@@ -4,7 +4,7 @@
 
 
 
-Hyperledger Fabric Gateway gRPC SDK generated directly from protos found at: https://github.com/hyperledger/fabric-protos.
+[Hyperledger Fabric Gateway SDK](https://hyperledger-fabric.readthedocs.io/en/latest/gateway.html) ported to idiomatic ruby.
 
 ## Installation
 
@@ -32,7 +32,7 @@ Will update to new version of grpc when fix is released.
 
 ## Usage
 
-This is an alpha stage library suitable for early adopters. The basic evaluate and submit gateway functions are implemented. Chaincode events monitoring is not yet implemented.
+This is a beta stage library with all the main hyperledger gateway calls implemented. Although this library has good unit test coverage, it is fairly new and has not yet been run in production environments. The library will be updated to 1.0.0 when the library has proven to be stable.
 
 ```ruby
 $ bin/console
@@ -86,8 +86,32 @@ puts contract.evaluate_transaction('GetAllAssets')
 puts contract.submit_transaction('CreateAsset', ['asset13', 'yellow', '5', 'Tom', '1300'])
 puts contract.submit_transaction('UpdateAsset', %w[asset999 yellow 5 Tom 5555])
 
-# Chaincode Events - Not Yet Implemented!
+# Chaincode Events - simple (blocking until deadline is reached or connection closed)
+contract.chaincode_events do |event|
+  puts event
+end
+
+# Chaincode Events - advanced
+# chaincode events are blocking and run indefinitely, so this is probably the more typical use case to give 
+# more control over the connection
+
+last_processed_block = nil # store this in something persistent 
+
+op = contract.chaincode_events(start_block: last_processed_block, call_options: { return_op: true }) do |event|
+  last_processed_block = event.block_number # update the last_processed_block so we can resume from this point
+  puts event
+end
+
+t = Thread.new do
+  call = op.execute
+rescue GRPC::Cancelled => e
+  puts 'We cancelled the operation outside of this thread.'
+end
 
+sleep 1 
+op.status
+op.cancelled?
+op.cancel
 ```
 
 Please refer to the [full reference documentation](https://rubydoc.info/github/EthicalIdentity/fabric-gateway-ruby) for complete usage information.
@@ -135,7 +159,7 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/ethica
 - [x] Implement, Document & Test Endorse
 - [x] Implement, Document & Test Submit
 - [x] Implement, Document & Test CommitStatus
-- [ ] Implement, Document & Test ChaincodeEvents
+- [x] Implement, Document & Test ChaincodeEvents
 - [ ] Support Submit Async (currently blocks waiting for the transaction to be committed)
 - [ ] Consider adding error handling, invalid transaction proposals will result in random GRPC::FailedPrecondition type errors
 - [ ] Consider adding transaction_id information to Fabric::Errors that are raised; would help a lot for debugging.

data/Rakefile

@@ -7,4 +7,3 @@ require 'rake/notes/rake_task'
 RSpec::Core::RakeTask.new(:spec)
 
 task default: :spec
-

data/fabric-gateway.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Jonathan Chan']
   spec.email         = ['jonathan.chan@ethicalidentity.com']
 
-  spec.summary       = 'Hyperledger Fabric Gateway gRPC SDK'
-  spec.description   = 'Hyperledger Fabric Gateway gRPC SDK generated directly from protos found at: https://github.com/hyperledger/fabric-protos.'
+  spec.summary       = 'Hyperledger Fabric Gateway SDK'
+  spec.description   = 'Ruby port of the Hyperledger Fabric Gateway SDK'
   spec.homepage      = 'https://github.com/ethicalidentity/fabric-gateway-ruby'
   spec.license       = 'MIT'
   spec.required_ruby_version = Gem::Requirement.new('>= 2.6.0')
@@ -38,6 +38,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency('rubocop-rspec', '~> 2.6.0')
   spec.add_development_dependency('simplecov', '~> 0.21.2')
   spec.add_development_dependency('timecop', '~> 0.9.4')
+  spec.add_development_dependency('yard', '~> 0.9.27')
   spec.metadata = {
     'rubygems_mfa_required' => 'true'
   }

data/lib/fabric/client.rb

@@ -53,8 +53,9 @@ module Fabric
     #
     # Submits an evaluate_request to the gateway to be evaluted.
     #
+    # @see https://www.rubydoc.info/gems/grpc/GRPC%2FClientStub:request_response Call options for options parameter
     # @param [Gateway::EvaluateRequest] evaluate_request
-    # @param [Hash] options gRPC call options (merged with default options) @see https://www.rubydoc.info/gems/grpc/GRPC%2FClientStub:request_response
+    # @param [Hash] options gRPC call options (merged with default_call_options from initializer)
     #
     # @return [Gateway::EvaluateResponse] evaluate_response
     #
@@ -92,6 +93,7 @@ module Fabric
     # @param [Gateway::CommitStatusRequest] commit_status_request
     # @param [Hash] options gRPC call options (merged with default options) @see https://www.rubydoc.info/gems/grpc/GRPC%2FClientStub:request_response
     #
+    # Returns an enum or if you pass a block, use the block.
     # @return [Gateway::CommitStatusResponse] commit_status_response
     #
     def commit_status(commit_status_request, options = {})
@@ -101,13 +103,64 @@ module Fabric
     #
     # Subscribe to chaincode events
     #
-    # @note This function has never been utilized or tested. This function is probably wrong, missing a block.
-    # @todo add testing!
-    #
-    # @param [Gateway::ChaincodeEventsRequest] chaincode_events_request
-    # @param [Hash] options gRPC call options (merged with default options) @see https://www.rubydoc.info/gems/grpc/GRPC%2FClientStub:server_streamer
-    #
-    # @return [Gateway::ChaincodeEventsResponse] commit_status_response (probably wrong, this is a stream.)
+    # @see https://www.rubydoc.info/gems/grpc/GRPC%2FClientStub:server_streamer GRPC::ClientStub#server_streamer
+    #   - gRPC Underlying Call Reference
+    #
+    #
+    # @overload chaincode_events(chaincode_events_request)
+    #   @example Utilizing Blocking Enumerator
+    #     call = client.chaincode_events(chaincode_events_request)
+    #     call.each do |event|
+    #       pp event
+    #     end
+    #   @param [Gateway::ChaincodeEventsRequest] chaincode_events_request
+    #   @param [Hash] options gRPC call options (merged with default options)
+    #   @return [Enumerator] enumerator with Gateway::ChaincodeEventsResponse objects
+    # @overload chaincode_events(chaincode_events_request)
+    #   @example Utilizing a blocking block
+    #     client.chaincode_events(chaincode_events_request) do |event|
+    #       pp event
+    #     end
+    #   @param [Gateway::ChaincodeEventsRequest] chaincode_events_request
+    #   @param [Hash] options gRPC call options (merged with default options)
+    #   @yield [event] Blocking call that yields Gateway::ChaincodeEventsResponse objects when received from the server
+    #   @yieldparam event [Gateway::ChaincodeEventsResponse] chaincode event
+    #   @return [nil]
+    # @overload chaincode_events(chaincode_events_request, {return_op: true})
+    #   @example Utilizing an operation control object and a enumerator
+    #     op = client.chaincode_events(chaincode_events_request, {return_op: true})
+    #
+    #     t = Thread.new do
+    #       call = op.execute
+    #       call.each do |event|
+    #         pp event
+    #       end
+    #     end
+    #
+    #     op.status
+    #     op.cancelled?
+    #     op.cancel
+    #   @param [Gateway::ChaincodeEventsRequest] chaincode_events_request
+    #   @param [Hash] options gRPC call options (merged with default options)
+    #   @return [GRPC::ActiveCall::Operation]
+    # @overload chaincode_events(chaincode_events_request, {return_op: true})
+    #   @example Utilizing an operation control object and a block
+    #     op = client.chaincode_events(chaincode_events_request, {return_op: true}) do |event|
+    #       pp event
+    #     end
+    #
+    #     t = Thread.new do
+    #       call = op.execute
+    #     end
+    #
+    #     op.status
+    #     op.cancelled?
+    #     op.cancel
+    #   @param [Gateway::ChaincodeEventsRequest] chaincode_events_request
+    #   @param [Hash] options gRPC call options (merged with default options)
+    #   @yield [event] Blocking call that yields Gateway::ChaincodeEventsResponse objects when received from the server
+    #   @yieldparam event [Gateway::ChaincodeEventsResponse] chaincode event
+    #   @return [GRPC::ActiveCall::Operation]
     #
     def chaincode_events(chaincode_events_request, options = {}, &block)
       @grpc_client.chaincode_events(chaincode_events_request,

data/lib/fabric/contract.rb

@@ -117,6 +117,30 @@ module Fabric
       raise NotYetImplemented
     end
 
+    #
+    # Get chaincode events emitted by transaction functions of the chaincode.
+    #
+    # @see Fabric::Client#chaincode_events Fabric::Client#chaincode_events - explanation of the different return types
+    #   and example usage.
+    # @see https://www.rubydoc.info/gems/grpc/GRPC%2FClientStub:server_streamer Call options for options parameter
+    #
+    # @param [Integer] start_block Block number at which to start reading chaincode events.
+    # @param [Hash] call_options gRPC call options (merged with default_call_options from initializer)
+    # @yield [chaincode_event] loops through the chaincode events
+    # @yieldparam [Gateway::ChaincodeEventsResponse] chaincode_event the chaincode event
+    #
+    # @return [Enumerator|GRPC::ActiveCall::Operation|nil] Dependent on parameters passed;
+    #   please see Fabric::Client#get_chaincode_events
+    #
+    def chaincode_events(start_block: nil, call_options: {}, &block)
+      network.chaincode_events(
+        self,
+        start_block: start_block,
+        call_options: call_options,
+        &block
+      )
+    end
+
     #
     # Creates a transaction proposal that can be evaluated or endorsed. Supports off-line signing flow.
     #

data/lib/fabric/entities/chaincode_events_requests.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+module Fabric
+  #
+  # Encapsulates a Chaincode Events Request protobuf message
+  #
+  class ChaincodeEventsRequest
+    attr_reader :contract,
+                :start_block
+
+    # @!parse include Fabric::Accessors::Network
+    # @!parse include Fabric::Accessors::Gateway
+    include Fabric::Accessors::Contract
+
+    #
+    # Creates a new ChaincodeEventsRequest
+    #
+    # @param [Fabric::Contract] contract an instance of a contract
+    # @param [Integer] start_block Block number at which to start reading chaincode events.
+    #
+    def initialize(contract, start_block: nil)
+      @contract = contract
+      @start_block = start_block
+    end
+
+    #
+    # Returns the signed request
+    #
+    # @return [Gateway::SignedChaincodeEventsRequest] generated signed request
+    #
+    def signed_request
+      @signed_request ||= ::Gateway::SignedChaincodeEventsRequest.new(request: chaincode_events_request.to_proto)
+    end
+
+    #
+    # Returns the chaincode events request
+    #
+    # @return [Gateway::ChaincodeEventsRequest] chaincode events request - controls what events are returned
+    #   from a chaincode events request
+    #
+    def chaincode_events_request
+      @chaincode_events_request ||= new_chaincode_events_request
+    end
+
+    #
+    # Get the serialized chaincode events request protobuffer message.
+    #
+    # @return [String] protobuffer serialized chaincode events request
+    #
+    def request_bytes
+      signed_request.request
+    end
+
+    #
+    # Get the digest of the chaincode events request. This is used to generate a digital signature.
+    #
+    # @return [String] chaincode events request digest
+    #
+    def request_digest
+      Fabric.crypto_suite.digest(request_bytes)
+    end
+
+    #
+    # Sets the signed request signature.
+    #
+    # @param [String] signature
+    #
+    # @return [void]
+    #
+    def signature=(signature)
+      signed_request.signature = signature
+    end
+
+    #
+    # Returns the signed_request signature
+    #
+    # @return [String] Raw byte string signature
+    #
+    def signature
+      signed_request.signature
+    end
+
+    #
+    # Sign the chaincode events request; Noop if request already signed.
+    #
+    # @return [void]
+    #
+    def sign
+      return if signed?
+
+      self.signature = signer.sign(request_bytes)
+    end
+
+    #
+    # Checks if the signed chaincode events has been signed.
+    #
+    # @return [Boolean] true if the signed chaincode events has been signed; otherwise false.
+    #
+    def signed?
+      !signed_request.signature.empty?
+    end
+
+    #
+    # Get chaincode events emitted by transaction functions of a specific chaincode.
+    #
+    # @see Fabric::Client#chaincode_events Fabric::Client#chaincode_events - explanation of the different return types
+    #   and example usage.
+    # @see https://www.rubydoc.info/gems/grpc/GRPC%2FClientStub:server_streamer Call options for options parameter
+    #
+    # @param [Hash] options gRPC call options (merged with default_call_options from initializer)
+    # @yield [chaincode_event] loops through the chaincode events
+    # @yieldparam [Gateway::ChaincodeEventsResponse] chaincode_event the chaincode event
+    #
+    # @return [Enumerator|GRPC::ActiveCall::Operation|nil] Dependent on parameters passed;
+    #   please see Fabric::Client#get_chaincode_events
+    #
+    def get_events(options = {}, &block)
+      sign
+
+      client.chaincode_events(signed_request, options, &block)
+    end
+
+    private
+
+    #
+    # Generates a new chaincode events request
+    #
+    # @return [Gateway::ChaincodeEventsRequest] chaincode events request - controls what events are returned
+    #
+    def new_chaincode_events_request
+      ::Gateway::ChaincodeEventsRequest.new(
+        channel_id: network_name,
+        chaincode_id: chaincode_name,
+        identity: signer.to_proto,
+        start_position: start_position
+      )
+    end
+
+    #
+    # Generates the start_position for the chaincode events request or returns the cached start_position
+    #
+    # @return [Orderer::SeekPosition] start position for the chaincode events request
+    #
+    def start_position
+      @start_position ||= new_start_position
+    end
+
+    #
+    # Generates the start position for the chaincode events request; if no start_block is specified,
+    # generates a seek next commit start position, otherwise generates a start_position to the start_block
+    #
+    # @return [Orderer::SeekPosition] start position for the chaincode events request
+    #
+    def new_start_position
+      specified = nil
+      next_commit = nil
+
+      if start_block
+        specified = ::Orderer::SeekSpecified.new(number: start_block)
+      else
+        next_commit = ::Orderer::SeekNextCommit.new
+      end
+      Orderer::SeekPosition.new(specified: specified, next_commit: next_commit)
+    end
+  end
+end

data/lib/fabric/entities/envelope.rb

@@ -49,12 +49,17 @@ module Fabric
     #
     # @param [String] signature
     #
-    # @return [Void]
+    # @return [void]
     #
     def signature=(signature)
       envelope.signature = signature
     end
 
+    #
+    # Returns the results from the transaction result payload.
+    #
+    # @return [Payload] transaction result payload
+    #
     def result
       @result ||= parse_result_from_payload
     end
@@ -113,7 +118,7 @@ module Fabric
     private
 
     #
-    # Parse the transaction actinos from the payload looking for the transaction result payload.
+    # Parse the transaction actions from the payload looking for the transaction result payload.
     #
     # @return [String] result payload
     # @raise [Fabric::Error] if the transaction result payload is not found

data/lib/fabric/network.rb

@@ -32,25 +32,39 @@ module Fabric
     end
 
     #
-    # @todo original SDK has getChaincodeEvents and newChaincodeEventsRequest methods
-    # @see https://github.com/hyperledger/fabric-gateway/blob/08118cf0a792898925d0b2710b0a9e7c5ec23228/node/src/network.ts
-    # @see https://github.com/hyperledger/fabric-gateway/blob/main/pkg/client/network.go
+    # Get chaincode events emitted by transaction functions of a specific chaincode.
     #
-    # @return [?] ?
+    # @see Fabric::Client#chaincode_events Fabric::Client#chaincode_events - explanation of the different return types
+    #   and example usage.
+    # @see https://www.rubydoc.info/gems/grpc/GRPC%2FClientStub:server_streamer Call options for options parameter
     #
-    def new_chaincode_events
-      raise NotYetImplemented
+    # @param [Fabric::Contract] contract the chaincode to listen for events on
+    # @param [Integer] start_block Block number at which to start reading chaincode events.
+    # @param [Hash] call_options gRPC call options (merged with default_call_options from initializer)
+    # @yield [chaincode_event] loops through the chaincode events
+    # @yieldparam chaincode_event [Gateway::ChaincodeEventsResponse] the chaincode event
+    #
+    # @return [Enumerator|GRPC::ActiveCall::Operation|nil] Dependent on parameters passed;
+    #   please see Fabric::Client#get_chaincode_events
+    #
+    def chaincode_events(contract, start_block: nil, call_options: {}, &block)
+      new_chaincode_events_request(contract, start_block: start_block).get_events(call_options, &block)
     end
 
     #
-    # @todo original SDK has getChaincodeEvents and newChaincodeEventsRequest methods
-    # @see https://github.com/hyperledger/fabric-gateway/blob/08118cf0a792898925d0b2710b0a9e7c5ec23228/node/src/network.ts
-    # @see https://github.com/hyperledger/fabric-gateway/blob/main/pkg/client/network.go
+    # Create a request to receive chaincode events emitted by transaction functions of a specific chaincode. Supports
+    # off-line signing flow.
+    #
+    # @note I'm lying. I just copy and pasted the description from the node SDK. Offline signing should work, but it has
+    #   not been explicitly tested.
+    # @todo Test off-line signing flow.
     #
-    # @return [?] ?
+    # @param [Fabric::Contract] contract the chaincode to listen for events on
+    # @param [Integer] start_block Block number at which to start reading chaincode events.
+    # @return [Fabric::ChaincodeEventsRequest] Encapsulated ChaincodeEventsRequest
     #
-    def new_chaincode_events_request
-      raise NotImplementedError
+    def new_chaincode_events_request(contract, start_block: nil)
+      ChaincodeEventsRequest.new(contract, start_block: start_block)
     end
   end
 end

data/lib/fabric/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fabric
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

data/lib/fabric.rb

@@ -13,6 +13,7 @@ require 'fabric/entities/proposal'
 require 'fabric/entities/proposed_transaction'
 require 'fabric/entities/status'
 require 'fabric/entities/transaction'
+require 'fabric/entities/chaincode_events_requests'
 
 require 'fabric/constants'
 require 'fabric/contract'
@@ -33,6 +34,7 @@ module Fabric
   #
   # CommitError
   #
+  # TODO: Add RSpec Tests for CommitError
   # @todo TEST ME!
   #
   class CommitError < Error

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fabric-gateway
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Jonathan Chan
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-01-04 00:00:00.000000000 Z
+date: 2022-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-protobuf
@@ -150,8 +150,21 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.9.4
-description: 'Hyperledger Fabric Gateway gRPC SDK generated directly from protos found
-  at: https://github.com/hyperledger/fabric-protos.'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.27
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.27
+description: Ruby port of the Hyperledger Fabric Gateway SDK
 email:
 - jonathan.chan@ethicalidentity.com
 executables: []
@@ -159,8 +172,11 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".editorconfig"
+- ".github/workflows/codeql-analysis.yml"
 - ".github/workflows/rspec.yml"
 - ".github/workflows/rubocop.yml"
+- ".github/workflows/todo.yml"
+- ".github/workflows/yardoc.yml"
 - ".gitignore"
 - ".gitmodules"
 - ".rspec"
@@ -193,6 +209,7 @@ files:
 - lib/fabric/constants.rb
 - lib/fabric/contract.rb
 - lib/fabric/ec_crypto_suite.rb
+- lib/fabric/entities/chaincode_events_requests.rb
 - lib/fabric/entities/envelope.rb
 - lib/fabric/entities/identity.rb
 - lib/fabric/entities/proposal.rb
@@ -238,5 +255,5 @@ requirements: []
 rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
-summary: Hyperledger Fabric Gateway gRPC SDK
+summary: Hyperledger Fabric Gateway SDK
 test_files: []