domeapi 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0bb3f5617684761d7e6fb686bcca3b1a0c9939f61a1733cae6c376b96a58b804
+  data.tar.gz: 4326df296496387d1d583b314359e1b606b8aee5b8da39220e4500fa526c98ad
+SHA512:
+  metadata.gz: 3e4c20f7d94cc986c42fc3e145b34420d5838b72d00a17f5c78f54122767a3cdbb717b1da303f1e4408e8f4dc652552e39672e6a3a9748392396094f0ac9aa2b
+  data.tar.gz: a9e4c2d25576d31dcc36c813d404be8b9d87de1e940c1d9b05c3759da787030c495e3a3f2794b3a79dc81962b8c950e6d562370a260c3fc81b121d7b2dd9df39

data/.release-please-config.json

@@ -0,0 +1,28 @@
+{
+  "packages": {
+    ".": {
+      "changelog-path": "CHANGELOG.md",
+      "release-type": "simple",
+      "bump-minor-pre-major": true,
+      "bump-patch-for-minor-pre-major": true,
+      "draft": false,
+      "prerelease": false,
+      "version-file": ".version.txt",
+      "extra-files": [
+        {
+          "type": "generic",
+          "path": "lib/domeapi/version.rb"
+        }
+      ],
+      "exclude-paths": [
+        ".release-please-manifest.json",
+        ".version.txt",
+        "lib/domeapi/version.rb",
+        ".rubocop.yml",
+        ".overcommit.yml",
+        "coverage/coverage.json"
+      ]
+    }
+  },
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json"
+}

data/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.0.1"
+}

data/AGENTS.md

@@ -0,0 +1,99 @@
+# Coding Standards for Agents
+
+---
+This file describes the desired coding standards and for the domeapi ruby project.
+
+## Project Context
+
+**Language:** Ruby ~> 4
+**Framework:** [trailblazer](https://trailblazer.to/)
+**Testing:** [minitest](https://docs.seattlerb.org/minitest/) following [BetterSpecs](https://evenbetterspecs.github.io/) guidelines
+
+---
+
+## Purpose & Scope
+
+Focused guidance for Ruby style, tests, performance, and tone.
+
+---
+
+## 1. Style Guides
+
+> ⚠️ **Be constructive:** Frame style feedback as suggestions (e.g., “Consider using…”).
+
+All standard rules follow the [Shopify Ruby Style Guide](https://ruby-style-guide.shopify.dev/), with the following specific emphases:
+- Indentation and line length enforced by RuboCop.
+- Use guard clauses, and explicit receivers.
+- Prefer Railway Oriented Programming (ROP) for error handling and flow. The trailblazer framework encourages this style.
+- Keep methods short. 1 line is fine. 5 is a lot. At 7, you should consider extracting a method.
+
+---
+
+## 2. Tone and Delivery (For code reviews)
+
+> 🤝 **Be collaborative:** Lead with positives and offer improvements respectfully.
+
+- Open with a brief positive comment on well‑written code.
+- Use phrasing like “Consider extracting…” or “You might simplify…” rather than absolutes.
+- Keep comments concise—2–3 sentences max.
+- Focus on actionable suggestions.
+- Avoid overwhelming with too many minor issues; prioritize key improvements.
+
+---
+
+## 3. Conventions & Readability
+
+> ✨ **Keep it clear:** Propose naming and structure that clarify intent.
+
+- **SOLID principles:** Single responsibility; inject dependencies via initializers.
+- **Descriptive names:** Recommend clear class, method, and variable names.
+- **DRY:** Suggest extracting duplicate logic into modules or service objects.
+    - Encourage use of Trailblazer operations for business logic encapsulation.     
+    - Promote use of Cells for view components to enhance reusability and maintainability.
+    - Encourage use of Contracts for validation to keep models clean and focused.
+    - Utilize Dry Container for dependency management to improve testability and modularity.
+- **Method size:** Keep them short, in reviews suggest extractions when exceeding ~7 lines.
+- Structs are our friend for grouping related data without behavior.
+- Favor composition over inheritance; prefer modules and mixins.
+- Ensure files have EOF newline.
+- No trailing white space in code and comments.
+
+---
+
+## 4. Testing and Coverage
+
+> 🧪 **Be thorough:** Highlight gaps in meaningful test coverage.
+
+- Flag or fix missing or outdated specs for changed behaviors (unit, integration, request).
+- Suggest tests for edge cases: error conditions, invalid inputs, boundary values, and potential `nil` handling or pointer exceptions. Follow best practices from the [BetterSpecs style guide](https://evenbetterspecs.github.io/).
+- Encourage descriptive `context` blocks and example names per [BetterSpecs](https://evenbetterspecs.github.io/).
+- Flag missing specs when logic is updated but no tests were added or modified
+- No less than 100% branch coverage. Full stop.
+---
+
+## 5. Performance and Security
+
+> 🚀 **Guard quality:** Call out patterns that may hurt performance or security.
+
+- Detect potential N+1 queries; suggest `includes` or batching.
+- Attempt to identify O(n^2) or O(n log n) algorithms; recommend more efficient alternatives.
+- Flag raw SQL, unsanitized interpolation, or other patterns that could introduce potential SQL injection vulnerabilities; recommend parameter binding and Sequel-based alternatives. Build these into a model, avoid raw SQL unless absolutely necessary.
+- Identify unescaped user input in any i/o context (cli, api, file writes, logs); suggest proper escaping or sanitization.
+
+---
+
+## 6. Documentation and Comments
+
+> 📚 **Clarify intent:** Advocate for clear, concise documentation.
+
+- All methods should have yarddoc annotations in the format:
+  ```ruby
+  # Short description of the method.
+  #
+  # @param [Type] param_name Description of the parameter.
+  #
+  # @return [Type] Description of the return value.
+  ```
+- Explain the "why" behind code choices, not the "what."
+- Add comments only for complex logic or non-obvious decisions.
+- Comments become tech-debt if they are not maintained; use them judiciously.

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'minitest/test_task'
+
+Minitest::TestTask.create
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
+
+task default: %i[rubocop test]

data/Readme.adoc

@@ -0,0 +1,107 @@
+= Domeapi
+:toc: macro
+
+Ruby client for the Domeapi API.
+
+== Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+[source,bash]
+----
+bundle add domeapi
+----
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+[source,bash]
+----
+gem install domeapi
+----
+
+== Usage
+
+=== Configuration
+
+Configure the gem with your API key. You can set it via the `DOMEAPI_API_KEY` environment variable or configure it explicitly:
+
+[source,ruby]
+----
+Rubyists::Domeapi.configure do |config|
+  config.api_key = 'your_api_key'
+end
+----
+
+=== Client
+
+Initialize the client:
+
+[source,ruby]
+----
+client = Rubyists::Domeapi.client
+----
+
+=== Polymarket
+
+Access Polymarket endpoints via the `polymarket` namespace.
+
+==== Markets
+
+List markets with optional filtering:
+
+[source,ruby]
+----
+# List markets with default filter
+markets = client.polymarket.markets.list
+
+# List markets with custom filter
+filter = Rubyists::Domeapi::Polymarket::MarketFilter.new(
+  Rubyists::Domeapi::Polymarket::MarketFilter::Properties.new(
+    limit: 10,
+    offset: 0,
+    status: 'open'
+  )
+)
+markets = client.polymarket.markets.list(filter)
+----
+
+Get market price:
+
+[source,ruby]
+----
+price = client.polymarket.markets.price(token_id: 'token_id')
+----
+
+Get candlesticks:
+
+[source,ruby]
+----
+candlesticks = client.polymarket.markets.candlesticks(
+  condition_id: 'condition_id',
+  start_time: 1625097600,
+  end_time: 1625184000,
+  interval: 60
+)
+----
+
+==== Orders
+
+List orders:
+
+[source,ruby]
+----
+orders = client.polymarket.orders.list(
+  market_slug: 'market_slug',
+  limit: 10
+)
+----
+
+== Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+== Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/rubyists/domeapi.

data/ci/build_image.sh

@@ -0,0 +1,248 @@
+#!/usr/bin/env bash
+
+if readlink -f . >/dev/null 2>&1 # {{{ makes readlink work on mac
+then
+    readlink=readlink
+else
+    if greadlink -f . >/dev/null 2>&1
+    then
+        readlink=greadlink
+    else
+        printf "You must install greadlink to use this (brew install coreutils)\n" >&2
+    fi
+fi # }}}
+
+# Set here to the full path to this script
+me=${BASH_SOURCE[0]}
+[ -L "$me" ] && me=$($readlink -f "$me")
+here=$(cd "$(dirname "$me")" && pwd)
+just_me=$(basename "$me")
+
+repo_top=$(git rev-parse --show-toplevel)
+cd "$repo_top" || {
+    printf "Could not cd to %s\n" "$repo_top" >&2
+    exit 1
+}
+
+base_dir=$(basename "$(pwd)")
+: "${BUILD_CONTEXT:=$(pwd)}"
+: "${IMAGE_NAME:=$base_dir}"
+: "${LICENSE:=MIT}"
+: "${APP_VERSION:=$(< "$here"/../.version.txt)}"
+: "${REGISTRY:=ghcr.io}"
+: "${REGISTRY_TOKEN:=$GITHUB_TOKEN}"
+
+usage() { # {{{
+    cat <<-EOT
+    Build an image, optionally pushing it to the registry
+
+    Usage: $0 <options> <image_tag>
+        Options:
+            -c CONTAINERFILE  Path to the containerfile (default: ./oci/Containerfile)
+            -C CONTEXT        Build context (default: $BUILD_CONTEXT)
+            -i NAME           Name of the image (default: $IMAGE_NAME)
+            -l LICENSE        License of the image (default: $LICENSE)
+            -r REGISTRY       Registry to push the image to when -p is given (default: $REGISTRY)
+            -p                Push the image to the registry
+            -h                Show help / usage
+EOT
+} # }}}
+
+die() { # {{{
+    local -i code
+    code=$1
+    shift
+    error "$*"
+    printf "\n" >&2
+    usage >&2
+    # shellcheck disable=SC2086
+    exit $code
+} # }}}
+
+## Logging functions # {{{
+log() { # {{{
+    printf "%s [%s] <%s> %s\n" "$(date '+%Y-%m-%d %H:%M:%S.%6N')" "$$" "${just_me:-$0}" "$*"
+} # }}}
+
+debug() { # {{{
+    [ $verbose -lt 2 ] && return 0
+    # shellcheck disable=SC2059
+    log_line=$(printf "$@")
+    log "[DEBUG] $log_line" >&2
+} # }}}
+
+warn() { # {{{
+    # shellcheck disable=SC2059
+    log_line=$(printf "$@")
+    log "[WARN] $log_line" >&2
+} # }}}
+
+error() { # {{{
+    # shellcheck disable=SC2059
+    log_line=$(printf "$@")
+    log "[ERROR] $log_line" >&2
+} # }}}
+
+info() { # {{{
+    [ $verbose -lt 1 ] && return 0
+    # shellcheck disable=SC2059
+    log_line=$(printf "$@")
+    log "[INFO] $log_line" >&2
+} # }}}
+# }}}
+
+push=0
+verbose=0
+while getopts :hpvc:C:i:l:r: opt # {{{
+do
+    case $opt in
+        c)
+            CONTAINERFILE=$OPTARG
+            ;;
+        C)
+            BUILD_CONTEXT=$OPTARG
+            ;;
+        i)
+            IMAGE_NAME=$OPTARG
+            ;;
+        l)
+            LICENSE=$OPTARG
+            ;;
+        r)
+            REGISTRY=$OPTARG
+            ;;
+        p)
+            push=1
+            ;;
+        v)
+            verbose=$((verbose + 1))
+            ;;
+        h)
+            usage
+            exit
+            ;;
+        :)
+            printf "Option %s requires an argument\n" "$OPTARG" >&2
+            usage >&2
+            exit 28
+            ;;
+        ?)
+            printf "Invalid option '%s'\n" "$OPTARG" >&2
+            usage >&2
+            exit 27
+            ;;
+    esac
+done # }}}
+shift $((OPTIND-1))
+
+tag=$1
+[ -z "$tag" ] && die 1 "Missing image tag"
+shift
+
+# Check for extra argument
+if [ $# -gt 0 ]; then
+    # If we have the special argument '--' we shift it away, otherwise we die
+    [ "$1" != '--' ] && die 2 "Too many arguments"
+    # Once this is shifted away, the rest of the arguments are passed to the build command, below
+    shift
+fi
+
+if [ -z "$CONTAINERFILE" ]; then
+    printf "No containerfile specified, looking for default locations\n"
+    for containerfile in Containerfile Dockerfile
+    do
+        if [ -f ./oci/"$containerfile" ]; then
+            debug "Found ./oci/%s\n" "$containerfile"
+            containerfile=./oci/"$containerfile"
+            break
+        fi
+        if [ -f "$containerfile" ]; then
+            debug "Found %s\n" "$containerfile"
+            break
+        fi
+    done
+else
+    [ -f "$CONTAINERFILE" ] || die 3 "Containerfile '$CONTAINERFILE' not found"
+    debug "Using containerfile %s\n" "$CONTAINERFILE"
+    containerfile=$CONTAINERFILE
+fi
+
+[ -f "$containerfile" ] || die 4 "No containerfile found"
+
+[ -d "$BUILD_CONTEXT" ] || die 5 "Build context '$BUILD_CONTEXT' not found"
+
+debug 'Building image from %s in in %s\n' "$containerfile" "$here"
+# Build the image
+if command -v podman 2>/dev/null
+then
+    runtime=podman
+elif command -v docker 2>/dev/null
+then
+    runtime=docker
+else
+    die 6 "No container runtime found"
+fi
+
+revision=$(git rev-parse HEAD)
+shortref=$(git rev-parse --short "$revision")
+repo_url=$(git remote get-url origin)
+if [ -z "$repo_url" ]
+then
+    die 7 "No remote found"
+fi
+if [[ $repo_url == *github.com/* ]]
+then
+    owner_and_repo=${repo_url#*github.com/}
+else
+    owner_and_repo=${repo_url##*:}
+fi
+# Get rid of the trailing .git
+service=$(basename "$owner_and_repo" .git)
+owner=$(dirname "$owner_and_repo")
+
+full_tag=$IMAGE_NAME:$tag
+created=$(date --utc --iso-8601=seconds 2>/dev/null || gdate --utc --iso-8601=seconds)
+# Pass any extra arguments to the build command ("$@" contains the rest of the arguments)
+$runtime build --tag "$full_tag" "$@" \
+               --label org.opencontainers.image.created="$created" \
+               --label org.opencontainers.image.description="Image for $service" \
+               --label org.opencontainers.image.licenses="$LICENSE" \
+               --label org.opencontainers.image.revision="$revision" \
+               --label org.opencontainers.image.url="$repo_url" \
+               --label org.opencontainers.image.title="$IMAGE_NAME" \
+               --label org.opencontainers.image.source="Generated by ruby-automation's build_image.sh ($USER@$HOSTNAME)" \
+               --label org.opencontainers.image.version="$full_tag" \
+               --label shortref="$shortref" \
+               --build-arg APP_VERSION="$APP_VERSION" \
+               -f "$containerfile" "$BUILD_CONTEXT" || die 8 "Failed to build image"
+
+[ $push -eq 1 ] || exit 0
+if ! $runtime login --get-login "$REGISTRY" >/dev/null 2>/dev/null
+then
+    printf "Not logged in to '%s', trying to login\n" "$REGISTRY" >&2
+    [ -z "$REGISTRY_TOKEN" ] && die 9 "No REGISTRY_TOKEN (nor GITHUB_TOKEN) set, cannot login"
+    printf "%s" "$REGISTRY_TOKEN" | $runtime login -u "$REGISTRY_TOKEN" --password-stdin "$REGISTRY" || die 10 "Failed to login to $REGISTRY"
+fi
+
+# Split 1.2.3 into 1.2.3, 1.2, 1. We want to tag our image with all 3 of these
+mapfile -t tags < <(echo "$tag" | awk -F'.' 'NF==3{print; print $1"."$2; print $1; next} NF==2{print; print $1; next} {print}')
+for t in "${tags[@]}"
+do
+    new_tag=$IMAGE_NAME:$t
+    registry_image_name="$REGISTRY/$owner/$new_tag"
+    if [ "$runtime" = "podman" ]
+    then
+        if [ "$full_tag" != "$new_tag" ]
+        then
+            debug "Tagging %s as %s\n" "$full_tag" "$new_tag"
+            podman tag "$full_tag" "$new_tag" || die 11 "Failed to tag image $full_tag as $new_tag"
+        fi
+        podman push "$new_tag" "$registry_image_name" || die 12 "Failed to push image $new_tag to $registry_image_name"
+    else
+        debug "Tagging %s as %s\n" "$full_tag" "$registry_image_name"
+        docker tag "$full_tag" "$registry_image_name" || die 13 "Failed to tag image $full_tag as $registry_image_name"
+        docker push "$registry_image_name" || die 14 "Failed to push image $new_tag to $registry_image_name"
+    fi
+done
+
+# vim: set foldmethod=marker et ts=4 sts=4 sw=4 ft=bash :

data/ci/publish-gem.sh

@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+
+if readlink -f . >/dev/null 2>&1 # {{{ makes readlink work on mac
+then
+    readlink=readlink
+else
+    if greadlink -f . >/dev/null 2>&1
+    then
+        readlink=greadlink
+    else
+        printf "You must install greadlink to use this (brew install coreutils)\n" >&2
+    fi
+fi # }}}
+
+# Set here to the full path to this script
+me=${BASH_SOURCE[0]}
+[ -L "$me" ] && me=$($readlink -f "$me")
+here=$(cd "$(dirname "$me")" && pwd)
+root=$(cd "$here/.." && pwd)
+just_me=$(basename "$me")
+
+: "${GEM_NAME:=domeapi}"
+: "${GIT_ORG:=rubyists}"
+
+GEM_HOST=$1
+: "${GEM_HOST:=rubygems}"
+
+case "$GEM_HOST" in
+    rubygems)
+        gem_key='rubygems'
+        gem_host='https://rubygems.org'
+        ;;
+    github)
+        gem_key='github'
+        gem_host="https://rubygems.pkg.github.com/$GIT_ORG"
+        # Replace the gem host in the gemspec, so it allows pushing to the GitHub package registry
+        sed --in-place=.bak -e "s|https://rubygems.org|https://rubygems.pkg.github.com/$GIT_ORG|" "$here/../$GEM_NAME".gemspec
+        # Restore the original gemspec after the script finishes
+        trap 'mv -v "$here/../$GEM_NAME".gemspec.bak "$here/../$GEM_NAME".gemspec' EXIT
+        ;;
+    *)
+        printf 'Unknown GEM_HOST: %s\n' "$GEM_HOST" >&2
+        exit 1
+        ;;
+esac
+
+# We only want this part running in CI, with no ~/.gem dir
+# For local testing, you should have a ~/.gem/credentials file with
+# the keys you need to push to rubygems or github
+if [ ! -d ~/.gem ]
+then
+    if [ -z "$GEM_TOKEN" ]
+    then
+        printf 'No GEM_TOKEN provided, cannot publish\n' >&2
+        exit 1
+    fi
+    mkdir -p ~/.gem
+    printf '%s\n:%s: %s\n' '---' "$gem_key" "$GEM_TOKEN" > ~/.gem/credentials
+    chmod 600 ~/.gem/credentials
+fi
+
+bundle exec gem build
+
+if [ -f "$here"/../.version.txt ]
+then
+    version=$(<"$here"/../.version.txt)
+else
+    version=$(git describe --tags --abbrev=0 | sed -e 's/^v//')
+fi
+
+if [ -z "$version" ]
+then
+    gem="$(ls "$root"/"$GEM_NAME"-*.gem | tail -1)"
+else
+    gem="$(printf '%s/%s-%s.gem' "$root" "$GEM_NAME" "$version")"
+fi
+
+if [ ! -f "$gem" ]
+then
+    printf 'No gem file found: %s\n' "$gem" >&2
+    exit 1
+fi
+
+if [[ "${TRACE:-false}" == true || "${ACTIONS_STEP_DEBUG:-false}" == true ]]
+then
+    printf "DEBUG: [%s] Building And Publishing %s to %s\n" "$just_me" "$gem" "$gem_host" >&2
+fi
+
+bundle exec gem push -k "$gem_key" --host "$gem_host" "$(basename "$gem")"
+
+# vim: set foldmethod=marker et ts=4 sts=4 sw=4 ft=bash :

data/exe/domeapi

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'domeapi'

data/lib/domeapi/client.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require 'httpx'
+require 'json'
+
+module Rubyists
+  module Domeapi
+    # HTTP Client for Domeapi API
+    class Client
+      include SemanticLogger::Loggable
+
+      attr_reader :http, :base_url
+      attr_accessor :prefix
+
+      def initialize(api_key: Domeapi.config.api_key, base_url: Domeapi.config.base_url)
+        @base_url = base_url
+        @http = HTTPX.plugin(:persistent)
+                     .plugin(:rate_limiter)
+                     .with(origin: base_url, headers: { 'Authorization' => "Bearer #{api_key}" })
+      end
+
+      def get(path, params: {})
+        response = @http.get(full_url(path), params:)
+        handle_response(response)
+      end
+
+      def polymarket
+        @polymarket ||= Polymarket::Client.new(self)
+      end
+
+      private
+
+      def full_url(path)
+        File.join(*[base_url, prefix, path].compact)
+      end
+
+      def handle_response(response)
+        response.raise_for_status
+        JSON.parse(response.body.to_s, symbolize_names: true)
+      rescue HTTPX::HTTPError => e
+        logger.error('API Error', e)
+        raise Error, "API Error: #{e.response.status} - #{e.response.body}"
+      end
+    end
+  end
+end

data/lib/domeapi/contract.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'reform'
+require 'reform/form/dry'
+
+module Rubyists
+  module Domeapi
+    # Base Contract class for Trailblazer/Reform forms
+    class Contract < Reform::Form
+      feature Reform::Form::Dry
+
+      def self.custom_definitions = instance_variable_get(:@definitions)&.keys&.map(&:to_sym) || []
+
+      def to_h
+        to_nested_hash.compact
+      end
+    end
+  end
+end

data/lib/domeapi/polymarket/client.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Domeapi
+    module Polymarket
+      # Polymarket API Client
+      class Client
+        attr_reader :client
+
+        def initialize(client = Rubyists::Domeapi::Client.new)
+          @client = client
+          client.prefix = 'polymarket'
+        end
+
+        def get(...)
+          client.get(...)
+        end
+
+        def markets
+          @markets ||= Markets.new(client)
+        end
+
+        def orders
+          @orders ||= Orders.new(client)
+        end
+      end
+    end
+  end
+end

data/lib/domeapi/polymarket/market_filter.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Domeapi
+    module Polymarket
+      # Filter for Polymarket markets
+      class MarketFilter < Contract
+        Properties = Struct.new(
+          *custom_definitions,
+          :market_slug,
+          :event_slug,
+          :condition_id,
+          :tags,
+          :status,
+          :min_volume,
+          :limit,
+          :offset,
+          :start_time,
+          :end_time,
+          keyword_init: true
+        )
+
+        # Define properties with custom populator to skip optional params with nil values
+        (Properties.members - custom_definitions).each do |member|
+          property member, populator: ->(value:, **) { value || skip! }
+        end
+
+        validation do
+          params do
+            optional(:status).maybe(:string, included_in?: %w[open closed])
+            optional(:offset).maybe(:integer, gteq?: 0, lteq?: 100)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/domeapi/polymarket/markets.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Domeapi
+    module Polymarket
+      # Markets API endpoints
+      class Markets
+        attr_reader :client
+
+        class << self
+          # @see #list
+          def list(...)
+            new.list(...)
+          end
+        end
+
+        # @param client [Rubyists::Domeapi::Polymarket::Client]
+        #
+        # @return [void]
+        def initialize(client = Rubyists::Domeapi::Polymarket::Client.new)
+          @client = client
+        end
+
+        # List markets
+        # @param filter [MarketFilter] Filter options
+        #
+        # @return [Array<Polymarket::Market>] list of markets
+        def list(filter = MarketFilter.new(MarketFilter::Properties.new))
+          raise ArgumentError, filter.errors.full_messages.join(', ') unless filter.validate({})
+
+          client.get('markets', params: filter.to_h)
+        end
+
+        # Fetch current or historical price for a market
+        #
+        # @param token_id [String]
+        # @param at_time [Integer] optional timestamp
+        #
+        # @return [Hash] market price data
+        def price(token_id:, at_time: nil)
+          params = { token_id: token_id }
+          params[:at_time] = at_time if at_time
+          client.get('markets/get_market_price', params: params)
+        end
+
+        # Get OHLC candlesticks
+        #
+        # @param condition_id [String]
+        # @param start_time [Integer]
+        # @param end_time [Integer]
+        # @param interval [Integer]
+        #
+        # @return [Hash] candlestick data
+        def candlesticks(condition_id:, start_time:, end_time:, interval:)
+          params = {
+            condition_id: condition_id,
+            start_time: start_time,
+            end_time: end_time,
+            interval: interval
+          }
+          client.get('markets/get_candlesticks', params: params)
+        end
+      end
+    end
+  end
+end

data/lib/domeapi/polymarket/orders.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Domeapi
+    module Polymarket
+      # Orders API endpoints
+      class Orders
+        attr_reader :client
+
+        def initialize(client)
+          @client = client
+        end
+
+        # Query orders with filtering options
+        # @param market_slug [String]
+        # @param start_time [Integer]
+        # @param end_time [Integer]
+        # @param limit [Integer]
+        def list(market_slug: nil, start_time: nil, end_time: nil, limit: nil)
+          params = {
+            market_slug:,
+            start_time:,
+            end_time:,
+            limit:
+          }.compact
+
+          client.get('orders/get_orders', params: params)
+        end
+      end
+    end
+  end
+end

data/lib/domeapi/polymarket.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Rubyists
+  module Domeapi
+    # Namespace for Polymarket-related functionality
+    module Polymarket
+    end
+  end
+end

data/lib/domeapi/version.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Rubyists
+  # Domeapi module
+  module Domeapi
+    # x-release-please-start-version
+    VERSION = '0.0.1'
+    # x-release-please-end
+  end
+end

data/lib/domeapi.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require 'semantic_logger'
+require 'zeitwerk'
+require 'dry-configurable'
+require_relative 'domeapi/version'
+
+module Rubyists
+  # Domeapi module
+  module Domeapi
+    extend Dry::Configurable
+
+    setting :api_key, default: ENV.fetch('DOMEAPI_API_KEY', nil)
+    setting :base_url, default: 'https://api.domeapi.io/v1'
+
+    include SemanticLogger::Loggable
+
+    class Error < StandardError; end
+
+    # Operation submodule, for Trailblazer operations
+    module Operation; end
+
+    def self.client
+      @client ||= Client.new
+    end
+  end
+end
+
+loader = Zeitwerk::Loader.new
+loader.tag = 'rubyists-domeapi'
+loader.push_dir("#{__dir__}/domeapi", namespace: Rubyists::Domeapi)
+loader.push_dir("#{__dir__}/domeapi/operations", namespace: Rubyists::Domeapi::Operation)
+loader.ignore("#{__dir__}/domeapi/version.rb")
+loader.setup

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "4"

data/sig/domeapi.rbs

@@ -0,0 +1,4 @@
+module Domeapi
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,202 @@
+--- !ruby/object:Gem::Specification
+name: domeapi
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Tj (bougyman) Vanderpoel
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-configurable
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-container
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-validation
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httpx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: reform
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: semantic_logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: trailblazer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+email:
+- bougyman@users.noreply.github.com
+executables:
+- domeapi
+extensions: []
+extra_rdoc_files: []
+files:
+- ".release-please-config.json"
+- ".release-please-manifest.json"
+- AGENTS.md
+- Rakefile
+- Readme.adoc
+- ci/build_image.sh
+- ci/publish-gem.sh
+- exe/domeapi
+- lib/domeapi.rb
+- lib/domeapi/client.rb
+- lib/domeapi/contract.rb
+- lib/domeapi/polymarket.rb
+- lib/domeapi/polymarket/client.rb
+- lib/domeapi/polymarket/market_filter.rb
+- lib/domeapi/polymarket/markets.rb
+- lib/domeapi/polymarket/orders.rb
+- lib/domeapi/version.rb
+- mise.toml
+- sig/domeapi.rbs
+homepage: https://github.com/rubyists/domeapi
+licenses: []
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/rubyists/domeapi
+  source_code_uri: https://github.com/rubyists/domeapi
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: Ruby SDK for domeapi.io (unofficial).
+test_files: []