blockchain0x-x402 0.0.1.alpha.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: be9ad30aa23e7e4d44c0dd712254925bb187f4f0c78567aec39c7ea3d4f98587
+  data.tar.gz: 22a5ab6a9635274a08a72dfe3f6fd0f06ecadbcdaf0b1ef05b849673fe5355df
+SHA512:
+  metadata.gz: 35deca80a3287f50c577ac6935a83be33d39268af3fc008972c3d55154d90041a2e0bcca4082689b13b6e0c1f42e0c8d63c4f5aaba9895afe1ce2fe8fd6694b0
+  data.tar.gz: 385941f182db7f338f0cd26b9a63ab8c90a368535f2323ee869cfc1b7d39acfdaed09e08a2cef83fa95c0712403274b15f7f6cff3e083ddd8acce7bcaa3a6592

data/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a
+      fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your
+      own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend,
+      and hold each Contributor harmless for any liability incurred by,
+      or claims asserted against, such Contributor by reason of your
+      accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Tosh Labs
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied. See the License for the specific language governing
+   permissions and limitations under the License.

data/README.md

@@ -0,0 +1,186 @@
+# blockchain0x-x402 (Ruby)
+
+[![Gem Version](https://badge.fury.io/rb/blockchain0x-x402.svg)](https://rubygems.org/gems/blockchain0x-x402)
+[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+[![Ruby ≥ 3.0](https://img.shields.io/badge/ruby-%E2%89%A53.0-brightgreen.svg)](#install)
+
+\*\*Official Ruby port of [`@blockchain0x/x402`](https://www.npmjs.com/package/@blockchain0x/x402)
+
+- `blockchain0x-x402` (Python) + `blockchain0x-x402-go`.\*\* Ships the
+  wire primitives + a 402-aware HTTP client. Sibling gem to
+  `blockchain0x`; install only when your service either issues
+  x402-aware HTTP calls (a payer) or verifies inbound x402 payments
+  (a recipient).
+
+> Pre-release: `0.0.1.alpha.0` ships the wire primitives + the
+> 402-aware `Client`. Rack middleware + Sinatra / Rails server
+> adapters land in a follow-up row.
+
+## Install
+
+```bash
+gem install blockchain0x-x402 --pre
+```
+
+Or in a `Gemfile`:
+
+```ruby
+gem 'blockchain0x-x402', '~> 0.0.1.alpha'
+```
+
+For the payer path you also need the main SDK:
+
+```ruby
+gem 'blockchain0x', '~> 0.0.1.alpha'
+gem 'blockchain0x-x402', '~> 0.0.1.alpha'
+```
+
+For the recipient/verifier path you only need `blockchain0x-x402`.
+
+## Verify an inbound x402 payment (recipient)
+
+```ruby
+class WebhooksController < ApplicationController
+  skip_before_action :verify_authenticity_token, only: :receive
+
+  def receive
+    payment = Blockchain0xX402::Wire.parse_payment_header(
+      request.headers['X-Payment'],
+    )
+    # payment.payment_request_id, payment.tx_hash, payment.network ...
+  rescue Blockchain0xX402::WireError => e
+    render json: { code: e.code }, status: :bad_request
+  end
+end
+```
+
+The verifier:
+
+- Accepts only `exact-usdc:<base64>` scheme; anything else rejects
+  with `header.unknown_scheme`.
+- Validates `txHash`, `payerAddress`, `amountUsdc`, and `network`
+  shape; any drift rejects with `header.payload_malformed`.
+- Lowercases hex fields so downstream comparisons against on-chain
+  transaction logs are deterministic.
+
+## Issue x402-aware HTTP calls (payer)
+
+```ruby
+require 'blockchain0x'
+require 'blockchain0x_x402'
+
+# Adapter glue: the x402 Client takes any object with .network,
+# .payments_create(args), and .transactions_get(id). Wire the
+# main SDK at your boundary.
+sdk_adapter = Struct.new(:sdk) do
+  def network = sdk.network
+  def payments_create(agent_id:, to:, amount_wei:)
+    sdk.payments.create(agent_id:, to:, amount_wei:)
+  end
+  def transactions_get(id) = sdk.transactions.get(id)
+end
+
+main = Blockchain0x::Client.new(api_key: ENV.fetch('BLOCKCHAIN0X_API_KEY'))
+x402 = Blockchain0xX402::Client.new(sdk: sdk_adapter.new(main), agent_id: 'agt_...')
+response = x402.post('https://service-b.com/llm-query', body: { ... })
+raise unless response.success?
+```
+
+The wrapper handles a 402 response transparently:
+
+1. Parses the 402 body and picks the requirement matching the SDK's network.
+2. Calls `sdk.payments_create(...)` to settle on-chain. The main SDK
+   auto-attaches an `Idempotency-Key` so a flaky retry does not
+   double-spend.
+3. Polls `sdk.transactions_get(payment_id)` every 1s for up to 30s
+   until the transaction confirms.
+4. Rebuilds the request with the `X-Payment` header and re-issues
+   it once. The 200 response is returned to the caller.
+
+Failures surface as `Blockchain0xX402::ClientError` with stable codes:
+
+- `no_matching_requirement`
+- `settlement_timeout`
+- `chain_failed`
+
+## Expose a paid HTTP route (recipient, server-side)
+
+The `RackMiddleware` adapter gates routes against a static pricing
+table. It mounts in front of any Rack app (Sinatra, Rails, plain
+Rack) with the standard `use` directive.
+
+```ruby
+require 'sinatra'
+require 'blockchain0x_x402/server'
+
+server_sdk = ... # an object that responds to payment_requests_settle(...)
+
+use Blockchain0xX402::Server::RackMiddleware,
+  sdk: server_sdk,
+  pricing: {
+    'POST /llm-query' => Blockchain0xX402::Server::PricingEntry.new(
+      amount_usdc: '0.10',
+      pay_to_address: '0xabc...',
+      payment_request_id: 'pr_demo',
+    ),
+  }
+
+post '/llm-query' do
+  payment = request.env['blockchain0x.x402_payment']
+  # payment.payment_request_id, payment.tx_hash, ...
+  json served: true
+end
+```
+
+A miss in the pricing table is a no-op (the route is free). A hit
+with no/invalid `X-Payment` short-circuits the response with HTTP
+402 and the canonical `accepts[]` body. A hit with a valid payment
+calls `sdk.payment_requests_settle(...)` to anchor trust, attaches
+the parsed payment to `env['blockchain0x.x402_payment']`, and
+forwards to the next middleware in the chain.
+
+For Rails, add the same directive to `config/application.rb`:
+
+```ruby
+config.middleware.use Blockchain0xX402::Server::RackMiddleware,
+  sdk: ..., pricing: { ... }
+```
+
+## Wire-format cross-compatibility
+
+`Blockchain0xX402::Wire.build_payment_header` produces the same
+base64 string as the Node, Python, and Go implementations for the
+same input. The canonical JSON shape is:
+
+```json
+{
+  "scheme": "exact-usdc",
+  "version": 1,
+  "paymentRequestId": "...",
+  "txHash": "...",
+  "payerAddress": "...",
+  "amountUsdc": "...",
+  "network": "..."
+}
+```
+
+Keys are emitted in this exact order. Hex fields (`txHash`,
+`payerAddress`) are lowercased before encoding.
+
+## Failure-mode codes
+
+| Code                       | When                                                       |
+| -------------------------- | ---------------------------------------------------------- |
+| `response.not_402`         | A non-402 response was passed to `parse_402_response`.     |
+| `response.body_missing`    | 402 response body was empty.                               |
+| `response.body_malformed`  | 402 body failed JSON parse or shape validation.            |
+| `header.missing`           | X-Payment header was absent.                               |
+| `header.malformed`         | X-Payment header was not `<scheme>:<base64-payload>`.      |
+| `header.unknown_scheme`    | The scheme prefix was not `exact-usdc`.                    |
+| `header.payload_malformed` | The decoded payload failed JSON parse or shape validation. |
+
+Branch on `e.code` (a Blockchain0xX402::WireError instance).
+
+## License
+
+Apache-2.0.

data/lib/blockchain0x_x402/client.rb

@@ -0,0 +1,179 @@
+# Sub-plan 21.3 row C-7 (Ruby x402): the 402-aware HTTP client.
+#
+# Flow on the 402 branch:
+#
+#   1. Wire.parse_402_response(resp) -> X402Response
+#   2. Pick the requirement whose `network` matches the SDK's bound
+#      key mode (sk_test_* -> testnet, sk_live_* -> mainnet). No
+#      match -> ClientError 'no_matching_requirement'.
+#   3. sdk.payments_create(agent_id:, to:, amount_wei:) for the
+#      chosen requirement. The SDK auto-attaches an Idempotency-
+#      Key so a flaky retry does not double-spend.
+#   4. Poll sdk.transactions_get(payment_id) every 1s up to 30s
+#      until status == 'confirmed' AND tx_hash present.
+#      Timeout -> ClientError 'settlement_timeout'.
+#      Failure status -> ClientError 'chain_failed'.
+#   5. Build the X-Payment header with Wire.build_payment_header
+#      and re-issue the original request. Returns the retry's
+#      Faraday::Response.
+#
+# Single retry only - if the second hop also returns 402 the
+# wrapper propagates that response unchanged so the caller can
+# decide whether to loop or surface to the user.
+#
+# The `sdk` is duck-typed: any object responding to
+# `network`, `payments_create(args)`, and `transactions_get(id)`
+# works. Tests mock the surface; production passes a
+# Blockchain0x::Client instance with thin adapters.
+
+# frozen_string_literal: true
+
+require 'faraday'
+require_relative 'errors'
+require_relative 'wire'
+
+module Blockchain0xX402
+  class Client
+    DEFAULT_CONFIRM_TIMEOUT_SECONDS = 30
+    DEFAULT_CONFIRM_POLL_SECONDS    = 1.0
+
+    # @param sdk [#network, #payments_create, #transactions_get]
+    # @param agent_id [String] wallet that funds the on-chain payment
+    # @param confirm_timeout_seconds [Integer]
+    # @param confirm_poll_seconds    [Float]
+    # @param connection [Faraday::Connection, nil] test seam
+    # @param sleep_proc [#call, nil] test seam for the poll loop
+    def initialize(
+      sdk:,
+      agent_id:,
+      confirm_timeout_seconds: DEFAULT_CONFIRM_TIMEOUT_SECONDS,
+      confirm_poll_seconds: DEFAULT_CONFIRM_POLL_SECONDS,
+      connection: nil,
+      sleep_proc: nil
+    )
+      @sdk = sdk
+      @agent_id = agent_id
+      @confirm_timeout = confirm_timeout_seconds
+      @confirm_poll = confirm_poll_seconds
+      @conn = connection || Faraday.new
+      @sleep = sleep_proc || Kernel.method(:sleep)
+    end
+
+    # Perform an HTTP request that handles 402 automatically.
+    # @param method [Symbol] :get, :post, :patch, :delete
+    # @param url    [String]
+    # @param body   [Object, nil] body the request adapter will encode
+    # @param headers [Hash<String, String>]
+    # @return [Faraday::Response] the final response (after the retry on the 402 branch)
+    def request(method, url, body: nil, headers: {})
+      first = perform(method, url, body, headers)
+      return first unless first.status == 402
+
+      spec = Wire.parse_402_response(first)
+      requirement = pick_requirement(spec.accepts)
+      payment = @sdk.payments_create(
+        agent_id: @agent_id,
+        to: requirement.pay_to_address,
+        amount_wei: requirement.amount_wei_usdc,
+      )
+      payment_id = payment.is_a?(Hash) ? (payment['id'] || payment[:id]) : payment.id
+      raise ClientError.new('chain_failed', 'payments_create did not return an id.') if payment_id.nil?
+
+      confirmed = wait_for_confirmation(payment_id)
+
+      header = Wire.build_payment_header(
+        Wire::ExactUsdcPayment.new(
+          scheme: 'exact-usdc',
+          version: 1,
+          payment_request_id: requirement.payment_request_id,
+          tx_hash: tx_field(confirmed, :tx_hash, 'txHash').to_s,
+          payer_address: tx_field(confirmed, :from_address, 'fromAddress').to_s,
+          amount_usdc: wei_to_usdc(requirement.amount_wei_usdc),
+          network: requirement.network,
+        ),
+      )
+      perform(method, url, body, headers.merge('X-Payment' => header))
+    end
+
+    # Sugar: client.get / .post / .patch / .delete delegate to #request.
+    %i[get post patch delete].each do |verb|
+      define_method(verb) do |url, body: nil, headers: {}|
+        request(verb, url, body: body, headers: headers)
+      end
+    end
+
+    private
+
+    def perform(method, url, body, headers)
+      @conn.run_request(method, url, body, headers) do |req|
+        # Faraday adapters serialize the body; leave the existing
+        # block free for caller customisation in a future row.
+      end
+    end
+
+    def pick_requirement(accepts)
+      target = @sdk.network.to_s
+      match = accepts.find { |r| r.network == target }
+      return match if match
+
+      raise ClientError.new(
+        'no_matching_requirement',
+        "402 accepts list has no entry for network=#{target.inspect}.",
+      )
+    end
+
+    def wait_for_confirmation(payment_id)
+      deadline = monotonic_now + @confirm_timeout
+      last = nil
+      while monotonic_now < deadline
+        tx = @sdk.transactions_get(payment_id)
+        last = tx
+        status = tx_field(tx, :status, 'status').to_s
+        tx_hash = tx_field(tx, :tx_hash, 'txHash')
+        return tx if status == 'confirmed' && !tx_hash.to_s.empty?
+        raise ClientError.new('chain_failed', 'payment status flipped to `failed`.') if status == 'failed'
+
+        @sleep.call(@confirm_poll)
+      end
+      raise ClientError.new(
+        'settlement_timeout',
+        "payment #{payment_id} did not confirm within #{@confirm_timeout}s " \
+          "(last status: #{tx_field(last, :status, 'status').inspect}).",
+      )
+    end
+
+    def monotonic_now
+      Process.clock_gettime(Process::CLOCK_MONOTONIC)
+    end
+
+    def tx_field(tx, snake, camel)
+      return nil if tx.nil?
+
+      if tx.is_a?(Hash)
+        tx[snake] || tx[snake.to_s] || tx[camel]
+      elsif tx.respond_to?(snake)
+        tx.public_send(snake)
+      end
+    end
+
+    # USDC has 6 decimals on Base. Convert the wire's amount-wei
+    # integer string to the human-readable decimal form (e.g.
+    # "100000" -> "0.1"). Uses pure string arithmetic so no
+    # digits are lost via float conversion.
+    def wei_to_usdc(amount_wei)
+      raise ClientError.new('chain_failed', "amount_wei is not numeric: #{amount_wei.inspect}") unless amount_wei.match?(/\A[0-9]+\z/)
+
+      if amount_wei.length <= 6
+        padded = amount_wei.rjust(6, '0')
+        frac = padded.sub(/0+\z/, '')
+        return '0' if frac.empty?
+
+        "0.#{frac}"
+      else
+        whole = amount_wei[0...(amount_wei.length - 6)]
+        frac = amount_wei[(amount_wei.length - 6)..].sub(/0+\z/, '')
+        frac.empty? ? whole : "#{whole}.#{frac}"
+      end
+    end
+  end
+end

data/lib/blockchain0x_x402/errors.rb

@@ -0,0 +1,42 @@
+# Sub-plan 21.3 C-7 (Ruby x402): error hierarchy.
+#
+#   Blockchain0xX402::Error              (base)
+#     Blockchain0xX402::WireError        (wire-format parse / build failures)
+#     Blockchain0xX402::ClientError      (402-flow runtime failures)
+#
+# Each carries a stable `code` string matching the Node + Python +
+# Go ports so cross-language consumers branch identically.
+
+# frozen_string_literal: true
+
+module Blockchain0xX402
+  class Error < StandardError
+    attr_reader :code
+
+    def initialize(code, message)
+      super("#{code}: #{message}")
+      @code = code
+    end
+  end
+
+  # Raised on any malformed x402 wire input. Codes:
+  #
+  #   response.not_402
+  #   response.body_missing
+  #   response.body_malformed
+  #   header.missing
+  #   header.malformed
+  #   header.unknown_scheme
+  #   header.payload_malformed
+  class WireError < Error
+  end
+
+  # Raised when the 402-aware client wrapper cannot resolve a
+  # challenge. Codes:
+  #
+  #   no_matching_requirement  - no accepts entry matched the SDK network
+  #   settlement_timeout       - on-chain payment did not confirm in budget
+  #   chain_failed             - payment status flipped to failed
+  class ClientError < Error
+  end
+end

data/lib/blockchain0x_x402/server.rb

@@ -0,0 +1,221 @@
+# x402 Rack middleware (sub-plan 21.3 row C-7 follow-up).
+#
+# Drop in front of any Rack app (Sinatra, Rails, plain Rack) to gate
+# routes against a configured pricing table. Same shape as the
+# Fastify / Express / Starlette / FastAPI / Flask / net-http
+# adapters; the wire format is byte-equivalent so a Ruby server
+# accepts headers from any cross-language payer.
+#
+# Usage (Sinatra / plain Rack):
+#
+#     use Blockchain0xX402::Server::RackMiddleware,
+#       sdk: server_sdk,
+#       pricing: {
+#         'POST /llm-query' => Blockchain0xX402::Server::PricingEntry.new(
+#           amount_usdc: '0.10',
+#           pay_to_address: '0xabc...',
+#           payment_request_id: 'pr_demo',
+#         ),
+#       }
+#
+# Usage (Rails):
+#
+#     # config/application.rb
+#     config.middleware.use Blockchain0xX402::Server::RackMiddleware,
+#       sdk: server_sdk,
+#       pricing: { ... }
+#
+# A miss in the pricing table is a no-op (the route is free). A hit
+# with no/invalid `X-Payment` short-circuits the response with
+# HTTP 402 and the canonical accepts[] body. A hit with a valid
+# payment calls `sdk.payment_requests_settle(...)` to anchor trust,
+# stashes the parsed payment under `env['blockchain0x.x402_payment']`
+# for downstream handlers, and forwards to the next middleware.
+
+# frozen_string_literal: true
+
+require 'json'
+
+require_relative 'errors'
+require_relative 'wire'
+
+module Blockchain0xX402
+  module Server
+    PricingEntry = Struct.new(
+      :amount_usdc,
+      :pay_to_address,
+      :payment_request_id,
+      :network,
+      keyword_init: true,
+    ) do
+      # Optional `network` defaults to nil so the middleware can fall
+      # back to the global DefaultNetwork. Struct's keyword_init
+      # already nils unspecified fields; this initialiser only
+      # exists to enforce the three required ones.
+      def initialize(amount_usdc:, pay_to_address:, payment_request_id:, network: nil)
+        super
+      end
+    end
+
+    CAIP2_BY_NETWORK = {
+      'mainnet' => 'eip155:8453',
+      'testnet' => 'eip155:84532',
+    }.freeze
+
+    PAYMENT_ENV_KEY = 'blockchain0x.x402_payment'
+
+    # Convert a human decimal USDC amount ("0.10") to a 6-decimal
+    # wei integer string ("100000"). Mirrors the equivalent helper
+    # in @blockchain0x/x402's shared.ts.
+    def self.usdc_decimal_to_wei(decimal)
+      whole, frac = decimal.split('.', 2)
+      whole = '0' if whole.nil? || whole.empty?
+      frac ||= ''
+      frac = frac.ljust(6, '0')[0, 6]
+      (whole.to_i * 1_000_000 + frac.to_i).to_s
+    end
+
+    # Build a PaymentRequirement struct from a pricing entry +
+    # network fallback. Exported so alternative adapters (Rails
+    # ActionController::API, Grape) can reuse it.
+    def self.build_requirement(entry, default_network)
+      network = entry.network || default_network || 'mainnet'
+      Wire::PaymentRequirement.new(
+        scheme: 'exact-usdc',
+        network: network,
+        chain_id: CAIP2_BY_NETWORK.fetch(network),
+        pay_to_address: entry.pay_to_address,
+        amount_wei_usdc: usdc_decimal_to_wei(entry.amount_usdc),
+        payment_request_id: entry.payment_request_id,
+        max_age_seconds: nil,
+      )
+    end
+
+    # Render the canonical 402 body. Used internally by the
+    # middleware; exported for alternative adapters.
+    def self.build_402_body(entry:, resource:, default_network:, max_age_seconds:)
+      req = build_requirement(entry, default_network)
+      req.max_age_seconds = max_age_seconds
+      Wire::X402Response.new(version: 1, resource: resource, accepts: [req])
+    end
+
+    def self.x402_response_to_hash(resp)
+      {
+        'version' => resp.version,
+        'resource' => resp.resource,
+        'accepts' => resp.accepts.map do |r|
+          h = {
+            'scheme' => r.scheme,
+            'network' => r.network,
+            'chainId' => r.chain_id,
+            'payToAddress' => r.pay_to_address,
+            'amountWeiUsdc' => r.amount_wei_usdc,
+            'paymentRequestId' => r.payment_request_id,
+          }
+          h['maxAgeSeconds'] = r.max_age_seconds unless r.max_age_seconds.nil?
+          h
+        end,
+      }
+    end
+
+    # Typed verify result. Returns one of:
+    #   { ok: true, payment: ExactUsdcPayment }
+    #   { ok: false, reason: 'header_missing' | 'header_malformed' |
+    #     'requirement_mismatch' | 'settle_rejected', message: String }
+    VerifyOk = Struct.new(:payment) do
+      def ok?; true; end
+    end
+    VerifyFailure = Struct.new(:reason, :message) do
+      def ok?; false; end
+    end
+
+    def self.verify_x_payment(sdk:, header:, entry:)
+      if header.nil? || header.empty?
+        return VerifyFailure.new('header_missing', 'X-Payment header is required.')
+      end
+
+      begin
+        payment = Wire.parse_payment_header(header)
+      rescue WireError => e
+        return VerifyFailure.new('header_malformed', e.message)
+      end
+
+      if payment.payment_request_id != entry.payment_request_id
+        return VerifyFailure.new(
+          'requirement_mismatch',
+          "X-Payment references #{payment.payment_request_id}, " \
+            "route quoted #{entry.payment_request_id}.",
+        )
+      end
+
+      begin
+        sdk.payment_requests_settle(
+          payment_request_id: payment.payment_request_id,
+          body: {
+            'txHash' => payment.tx_hash,
+            'payerAddress' => payment.payer_address,
+            'amountUsdcVerified' => payment.amount_usdc,
+          },
+        )
+      rescue StandardError => e
+        msg = e.message
+        msg = 'settle() rejected the proof.' if msg.nil? || msg.empty?
+        return VerifyFailure.new('settle_rejected', msg)
+      end
+
+      VerifyOk.new(payment)
+    end
+
+    # Rack middleware. Build at process boot, then `use` in front
+    # of the application.
+    class RackMiddleware
+      # @param app [#call] downstream Rack app
+      # @param sdk [#payment_requests_settle] backend settle bridge
+      # @param pricing [Hash{String=>PricingEntry}] keyed by '<METHOD> <PATH>'
+      # @param default_network [String] 'mainnet' (default) or 'testnet'
+      # @param max_age_seconds [Integer] how long a chain confirmation
+      #   may live before the payer's wrapper re-pays
+      def initialize(app, sdk:, pricing:, default_network: 'mainnet', max_age_seconds: 60)
+        @app = app
+        @sdk = sdk
+        @pricing = pricing
+        @default_network = default_network
+        @max_age_seconds = max_age_seconds
+      end
+
+      def call(env)
+        method = env['REQUEST_METHOD'] || 'GET'
+        path = env['PATH_INFO'] || env['REQUEST_PATH'] || ''
+        key = "#{method.upcase} #{path}"
+        entry = @pricing[key]
+        return @app.call(env) if entry.nil?
+
+        header = env['HTTP_X_PAYMENT']
+        outcome = Server.verify_x_payment(sdk: @sdk, header: header, entry: entry)
+
+        if outcome.ok?
+          env[PAYMENT_ENV_KEY] = outcome.payment
+          return @app.call(env)
+        end
+
+        body = Server.build_402_body(
+          entry: entry,
+          resource: "#{method} #{path}",
+          default_network: @default_network,
+          max_age_seconds: @max_age_seconds,
+        )
+        payload = Server.x402_response_to_hash(body)
+        payload['error'] = { 'reason' => outcome.reason, 'message' => outcome.message }
+        raw = JSON.generate(payload)
+        [
+          402,
+          {
+            'Content-Type' => 'application/json',
+            'Content-Length' => raw.bytesize.to_s,
+          },
+          [raw],
+        ]
+      end
+    end
+  end
+end

data/lib/blockchain0x_x402/version.rb

@@ -0,0 +1,9 @@
+# Sub-plan 21.3 C-7 (Ruby x402): gem version constant. Single source
+# of truth for blockchain0x-x402.gemspec and the user-visible
+# Blockchain0xX402::VERSION.
+
+# frozen_string_literal: true
+
+module Blockchain0xX402
+  VERSION = '0.0.1.alpha.0'
+end

data/lib/blockchain0x_x402/wire.rb

@@ -0,0 +1,255 @@
+# Sub-plan 21.3 row C-7 (Ruby x402). Ports the Node + Python + Go
+# wire primitives byte-for-byte.
+#
+# Three exports:
+#
+#   parse_402_response(http_response) -> X402Response
+#   build_payment_header(payment_hash_or_struct) -> "exact-usdc:<base64>"
+#   parse_payment_header(string) -> ExactUsdcPayment
+#
+# Plus the typed error class Blockchain0xX402::WireError with one of
+# 7 stable codes (response.not_402, response.body_missing,
+# response.body_malformed, header.missing, header.malformed,
+# header.unknown_scheme, header.payload_malformed).
+#
+# The wire form follows Coinbase's x402 reference:
+#
+#   X-Payment: <scheme>:<base64(payload)>
+#
+# Wire compatibility: the JSON output of build_payment_header is
+# byte-equivalent with the Node, Python, and Go implementations.
+# The canonical key order (scheme, version, paymentRequestId,
+# txHash, payerAddress, amountUsdc, network) is emitted manually
+# via String#<< so the wire shape does not depend on Ruby Hash
+# insertion-order semantics.
+
+# frozen_string_literal: true
+
+require 'base64'
+require 'json'
+require_relative 'errors'
+
+module Blockchain0xX402
+  module Wire
+    # Failure-code constants mirror the Node + Python + Go ports.
+    RESPONSE_NOT_402         = 'response.not_402'
+    RESPONSE_BODY_MISSING    = 'response.body_missing'
+    RESPONSE_BODY_MALFORMED  = 'response.body_malformed'
+    HEADER_MISSING           = 'header.missing'
+    HEADER_MALFORMED         = 'header.malformed'
+    HEADER_UNKNOWN_SCHEME    = 'header.unknown_scheme'
+    HEADER_PAYLOAD_MALFORMED = 'header.payload_malformed'
+
+    VALID_NETWORKS = %w[mainnet testnet].freeze
+    RE_TX_HASH = /\A0x[0-9a-fA-F]{64}\z/
+    RE_PAYER   = /\A0x[0-9a-fA-F]{40}\z/
+    RE_AMOUNT  = /\A[0-9]+(?:\.[0-9]+)?\z/
+    RE_WEI     = /\A[0-9]+\z/
+
+    # @!attribute [r] scheme @return [String] 'exact-usdc'
+    # @!attribute [r] network @return [String] 'mainnet' | 'testnet'
+    # @!attribute [r] chain_id @return [String] CAIP-2 chain id
+    # @!attribute [r] pay_to_address @return [String]
+    # @!attribute [r] amount_wei_usdc @return [String] integer text
+    # @!attribute [r] payment_request_id @return [String]
+    # @!attribute [r] max_age_seconds @return [Integer, nil]
+    PaymentRequirement = Struct.new(
+      :scheme,
+      :network,
+      :chain_id,
+      :pay_to_address,
+      :amount_wei_usdc,
+      :payment_request_id,
+      :max_age_seconds,
+      keyword_init: true,
+    )
+
+    X402Response = Struct.new(:version, :resource, :accepts, keyword_init: true)
+
+    # Decoded X-Payment header payload (scheme=exact-usdc).
+    ExactUsdcPayment = Struct.new(
+      :scheme,
+      :version,
+      :payment_request_id,
+      :tx_hash,
+      :payer_address,
+      :amount_usdc,
+      :network,
+      keyword_init: true,
+    )
+
+    class << self
+      # @param response [#status, #body, ...] any HTTP response that
+      #   exposes a numeric status and a JSON-parseable body. Faraday
+      #   responses, Net::HTTPResponse via Net::HTTP, and Webmock
+      #   stubs all work; for raw hashes use {parse_402_body} instead.
+      # @return [X402Response]
+      # @raise [WireError] on any shape problem
+      def parse_402_response(response)
+        status = response.respond_to?(:status) ? response.status : response.code.to_i
+        if status != 402
+          raise WireError.new(RESPONSE_NOT_402, "Expected status 402, got #{status}.")
+        end
+
+        body = response.body
+        body = JSON.parse(body) if body.is_a?(String)
+        parse_402_body(body)
+      rescue JSON::ParserError
+        raise WireError.new(RESPONSE_BODY_MALFORMED, '402 response body is not JSON.')
+      end
+
+      def parse_402_body(body)
+        unless body.is_a?(Hash)
+          raise WireError.new(RESPONSE_BODY_MISSING, '402 response body is missing or non-object.')
+        end
+        unless body['version'] == 1
+          raise WireError.new(RESPONSE_BODY_MALFORMED, "Unsupported x402 version: #{body['version'].inspect}.")
+        end
+        unless body['resource'].is_a?(String) && !body['resource'].empty?
+          raise WireError.new(RESPONSE_BODY_MALFORMED, '402 body missing `resource` string.')
+        end
+        accepts_raw = body['accepts']
+        unless accepts_raw.is_a?(Array) && !accepts_raw.empty?
+          raise WireError.new(RESPONSE_BODY_MALFORMED, '402 body missing `accepts` array or empty.')
+        end
+        accepts = accepts_raw.map do |entry|
+          unless valid_requirement?(entry)
+            raise WireError.new(RESPONSE_BODY_MALFORMED, '402 `accepts` entry is not a recognised payment requirement.')
+          end
+          PaymentRequirement.new(
+            scheme: 'exact-usdc',
+            network: entry['network'],
+            chain_id: entry['chainId'],
+            pay_to_address: entry['payToAddress'],
+            amount_wei_usdc: entry['amountWeiUsdc'],
+            payment_request_id: entry['paymentRequestId'],
+            max_age_seconds: entry['maxAgeSeconds'].is_a?(Numeric) ? entry['maxAgeSeconds'].to_i : nil,
+          )
+        end
+        X402Response.new(version: 1, resource: body['resource'], accepts: accepts.freeze)
+      end
+
+      # Encode a payment payload as an X-Payment header value.
+      # Accepts either an ExactUsdcPayment struct OR a Hash with
+      # the same keys (snake_case OR camelCase) for caller
+      # convenience.
+      #
+      # @raise [WireError] on unknown scheme
+      def build_payment_header(payment)
+        scheme, version, payment_request_id, tx_hash, payer_address, amount_usdc, network =
+          coerce_payment(payment)
+
+        if scheme != 'exact-usdc'
+          raise WireError.new(HEADER_UNKNOWN_SCHEME, "build_payment_header: unsupported scheme #{scheme.inspect}.")
+        end
+
+        # Pin the JSON key order explicitly. Ruby >= 1.9 Hashes are
+        # insertion-ordered but writing the JSON manually makes the
+        # wire contract obvious from this file alone.
+        json = String.new
+        json << '{"scheme":"exact-usdc","version":' << version.to_s
+        json << ',"paymentRequestId":' << JSON.generate(payment_request_id)
+        json << ',"txHash":' << JSON.generate(tx_hash.downcase)
+        json << ',"payerAddress":' << JSON.generate(payer_address.downcase)
+        json << ',"amountUsdc":' << JSON.generate(amount_usdc)
+        json << ',"network":' << JSON.generate(network)
+        json << '}'
+
+        "exact-usdc:#{Base64.strict_encode64(json)}"
+      end
+
+      def parse_payment_header(value)
+        if !value.is_a?(String) || value.empty?
+          raise WireError.new(HEADER_MISSING, 'X-Payment header is missing or empty.')
+        end
+        sep = value.index(':')
+        if sep.nil? || sep < 1 || sep == value.length - 1
+          raise WireError.new(HEADER_MALFORMED, 'X-Payment header must be `<scheme>:<base64-payload>`.')
+        end
+        scheme = value[0...sep]
+        if scheme != 'exact-usdc'
+          raise WireError.new(HEADER_UNKNOWN_SCHEME, "Unsupported X-Payment scheme: #{scheme}.")
+        end
+        b64 = value[(sep + 1)..]
+        text = begin
+          Base64.strict_decode64(b64)
+        rescue ArgumentError
+          raise WireError.new(HEADER_PAYLOAD_MALFORMED, 'X-Payment payload is not valid base64.')
+        end
+        parsed = begin
+          JSON.parse(text)
+        rescue JSON::ParserError
+          raise WireError.new(HEADER_PAYLOAD_MALFORMED, 'X-Payment payload is not valid JSON.')
+        end
+        unless parsed.is_a?(Hash)
+          raise WireError.new(HEADER_PAYLOAD_MALFORMED, 'X-Payment payload is not an object.')
+        end
+        unless valid_payload?(parsed)
+          raise WireError.new(HEADER_PAYLOAD_MALFORMED, 'X-Payment payload failed shape validation.')
+        end
+
+        ExactUsdcPayment.new(
+          scheme: 'exact-usdc',
+          version: 1,
+          payment_request_id: parsed['paymentRequestId'],
+          tx_hash: parsed['txHash'].downcase,
+          payer_address: parsed['payerAddress'].downcase,
+          amount_usdc: parsed['amountUsdc'],
+          network: parsed['network'],
+        )
+      end
+
+      private
+
+      def valid_requirement?(entry)
+        entry.is_a?(Hash) &&
+          entry['scheme'] == 'exact-usdc' &&
+          entry['network'].is_a?(String) &&
+          VALID_NETWORKS.include?(entry['network']) &&
+          entry['chainId'].is_a?(String) &&
+          entry['payToAddress'].is_a?(String) &&
+          entry['amountWeiUsdc'].is_a?(String) &&
+          RE_WEI.match?(entry['amountWeiUsdc']) &&
+          entry['paymentRequestId'].is_a?(String)
+      end
+
+      def valid_payload?(p)
+        p['scheme'] == 'exact-usdc' &&
+          p['version'] == 1 &&
+          p['paymentRequestId'].is_a?(String) &&
+          p['txHash'].is_a?(String) && RE_TX_HASH.match?(p['txHash']) &&
+          p['payerAddress'].is_a?(String) && RE_PAYER.match?(p['payerAddress']) &&
+          p['amountUsdc'].is_a?(String) && RE_AMOUNT.match?(p['amountUsdc']) &&
+          p['network'].is_a?(String) && VALID_NETWORKS.include?(p['network'])
+      end
+
+      def coerce_payment(payment)
+        if payment.is_a?(ExactUsdcPayment)
+          [
+            payment.scheme,
+            payment.version,
+            payment.payment_request_id,
+            payment.tx_hash,
+            payment.payer_address,
+            payment.amount_usdc,
+            payment.network,
+          ]
+        elsif payment.is_a?(Hash)
+          # Accept either snake_case or camelCase keys.
+          get = ->(snake, camel = nil) { payment[snake] || payment[snake.to_s] || (camel && (payment[camel] || payment[camel.to_s])) }
+          [
+            get.call(:scheme),
+            get.call(:version) || 1,
+            get.call(:payment_request_id, :paymentRequestId),
+            (get.call(:tx_hash, :txHash) || '').to_s,
+            (get.call(:payer_address, :payerAddress) || '').to_s,
+            get.call(:amount_usdc, :amountUsdc),
+            get.call(:network),
+          ]
+        else
+          raise WireError.new(HEADER_PAYLOAD_MALFORMED, 'build_payment_header expects ExactUsdcPayment or Hash.')
+        end
+      end
+    end
+  end
+end

data/lib/blockchain0x_x402.rb

@@ -0,0 +1,38 @@
+# Sub-plan 21.3 row C-7 (Ruby x402): top-level module.
+#
+# Public surface:
+#   Blockchain0xX402::Wire.parse_402_response / parse_402_body /
+#                          build_payment_header / parse_payment_header
+#   Blockchain0xX402::WireError
+#   Blockchain0xX402::Client (402-aware Faraday wrapper)
+#   Blockchain0xX402::ClientError
+#   Blockchain0xX402::Server::RackMiddleware (Rack / Sinatra / Rails gate)
+#   Blockchain0xX402::Server::PricingEntry
+#   Blockchain0xX402::VERSION
+
+# frozen_string_literal: true
+
+require_relative 'blockchain0x_x402/version'
+require_relative 'blockchain0x_x402/errors'
+require_relative 'blockchain0x_x402/wire'
+# Client + Server are required lazily so verify-only consumers
+# do not pay the Faraday / Rack load cost. Server has no runtime
+# Rack dependency (the middleware obeys the Rack 1.x calling
+# convention purely on the env-hash + tuple shape), so it can be
+# required even in installs that do not have Rack installed.
+
+module Blockchain0xX402
+  # @return [Class] Blockchain0xX402::Client (lazy-loaded)
+  def self.const_missing(name)
+    case name
+    when :Client
+      require_relative 'blockchain0x_x402/client'
+      const_get(:Client)
+    when :Server
+      require_relative 'blockchain0x_x402/server'
+      const_get(:Server)
+    else
+      super
+    end
+  end
+end

metadata

@@ -0,0 +1,92 @@
+--- !ruby/object:Gem::Specification
+name: blockchain0x-x402
+version: !ruby/object:Gem::Version
+  version: 0.0.1.alpha.0
+platform: ruby
+authors:
+- Blockchain0x
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-05-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+description: Sibling gem to `blockchain0x`. Verify inbound x402 payments + issue x402-aware
+  HTTP calls. Wire-format byte-equivalent with the Node, Python, and Go ports.
+email:
+- support@blockchain0x.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/blockchain0x_x402.rb
+- lib/blockchain0x_x402/client.rb
+- lib/blockchain0x_x402/errors.rb
+- lib/blockchain0x_x402/server.rb
+- lib/blockchain0x_x402/version.rb
+- lib/blockchain0x_x402/wire.rb
+homepage: https://blockchain0x.com
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://blockchain0x.com
+  source_code_uri: https://github.com/Tosh-Labs/blockchain0x-app/tree/dev/packages/sdk-ruby-x402
+  bug_tracker_uri: https://github.com/Tosh-Labs/blockchain0x-app/issues
+  documentation_uri: https://docs.blockchain0x.com
+  changelog_uri: https://github.com/Tosh-Labs/blockchain0x-x402-ruby/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Official Ruby port of @blockchain0x/x402 - HTTP 402 wire primitives + client
+test_files: []