ls-grid 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a70fe359eedafb694fea932b0caf61d78164a2f5b787501ea14b9b541bb8d281
+  data.tar.gz: d1c08c405350c5ffa25b7f1b13bad454a1eb7575a9eb02693e4586eda383bd7d
+SHA512:
+  metadata.gz: 338b20fe1fdfb5d2410d4f422d123217ed443f603549911987ae7cc1ee192e32df3046ae947dc69810699e2fa3a2c9ad7e9bf3c17613fc6b6320f8989f76680f
+  data.tar.gz: 4412671c450972068867acb02015b6d8a74378c0cf4d05b9eaadba8b77d25ec86b64ccebce972df74efb27498a9f462417641018147fd9afa71423c47981af96

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-11-19
+
+- Initial release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Kang-Kyu Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,288 @@
+# Grid API Ruby Client
+
+A Ruby client library for the [Lightspark Grid API](https://github.com/lightsparkdev/grid-api), enabling modern financial institutions to easily send and receive global payments.
+
+## Features
+
+- HTTP Basic Authentication
+- Support for all Grid API endpoints
+- Uses only Ruby's standard `net/http` library (no external HTTP dependencies)
+- Support for fiat, stablecoins, and Bitcoin transactions
+- Real-time settlement capabilities
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ls-grid'
+```
+
+Or install it directly:
+
+```bash
+gem install ls-grid
+```
+
+## Configuration
+
+Configure the Grid client with your API credentials:
+
+```ruby
+require 'ls/grid'
+
+Lightspark::Grid.configure do |config|
+  config.api_token_id = 'your_api_token_id'
+  config.api_client_secret = 'your_api_client_secret'
+  # Optional: override base URL (defaults to production)
+  # config.base_url = 'https://api.lightspark.com/grid/2025-10-13'
+end
+
+# Access the configured client
+client = Lightspark::Grid.client
+```
+
+Alternatively, create a client instance directly:
+
+```ruby
+client = Lightspark::Grid::Client.new(
+  api_token_id: 'your_api_token_id',
+  api_client_secret: 'your_api_client_secret'
+)
+```
+
+## Usage
+
+### Platform Configuration
+
+```ruby
+# Get platform configuration
+config = client.config.get
+
+# Update platform configuration
+client.config.update({
+  webhookUrl: 'https://your-domain.com/webhooks'
+})
+```
+
+### Customer Management
+
+```ruby
+# Create a customer
+customer = client.customers.create({
+  type: 'INDIVIDUAL',
+  firstName: 'John',
+  lastName: 'Doe',
+  email: 'john@example.com'
+})
+
+# List customers
+customers = client.customers.list(limit: 20)
+
+# Get a specific customer
+customer = client.customers.get('customer_id')
+
+# Update a customer
+client.customers.update('customer_id', {
+  email: 'newemail@example.com'
+})
+
+# Delete a customer
+client.customers.delete('customer_id')
+
+# Generate KYC link
+kyc = client.customers.kyc_link(
+  customer_id: 'customer_id',
+  redirect_url: 'https://your-app.com/kyc-complete'
+)
+
+# Bulk create customers via CSV
+job = client.customers.bulk_create_csv(csv_content)
+
+# Check bulk import job status
+status = client.customers.bulk_job_status(job['id'])
+```
+
+### Account Management
+
+```ruby
+# List customer internal accounts
+accounts = client.accounts.list_customer_internal_accounts(
+  customer_id: 'customer_id'
+)
+
+# List platform internal accounts
+accounts = client.accounts.list_platform_internal_accounts
+
+# List customer external accounts
+accounts = client.accounts.list_customer_external_accounts(
+  customer_id: 'customer_id'
+)
+
+# Create customer external account
+account = client.accounts.create_customer_external_account({
+  customerId: 'customer_id',
+  accountNumber: '123456789',
+  routingNumber: '987654321'
+})
+
+# Plaid integration
+link_token = client.accounts.create_plaid_link_token(
+  customer_id: 'customer_id'
+)
+
+# Submit Plaid authentication
+client.accounts.plaid_callback(
+  'plaid_link_token',
+  public_token: 'plaid_public_token'
+)
+```
+
+### Cross-Currency Transfers (Quotes)
+
+```ruby
+# Look up UMA receiver
+receiver = client.quotes.lookup_uma_receiver(
+  '$alice@example.com',
+  user_id: 'user_id'
+)
+
+# Look up external account
+account_info = client.quotes.lookup_external_account('account_id')
+
+# Create a quote
+quote = client.quotes.create({
+  sourceCurrency: 'USD',
+  destinationCurrency: 'BTC',
+  amount: '100.00',
+  receiverId: 'receiver_id'
+})
+
+# List quotes
+quotes = client.quotes.list(limit: 20)
+
+# Get quote details
+quote = client.quotes.get('quote_id')
+
+# Execute a quote
+result = client.quotes.execute('quote_id')
+
+# Retry a failed quote
+client.quotes.retry('quote_id')
+```
+
+### Transaction Management
+
+```ruby
+# List transactions
+transactions = client.transactions.list(
+  limit: 20,
+  created_after: '2024-01-01T00:00:00Z'
+)
+
+# Get transaction details
+transaction = client.transactions.get('transaction_id')
+
+# Approve pending incoming payment
+client.transactions.approve('transaction_id')
+
+# Reject pending incoming payment
+client.transactions.reject('transaction_id', reason: 'Duplicate payment')
+```
+
+### Same-Currency Transfers
+
+```ruby
+# Transfer from external to internal account
+transfer = client.transfers.transfer_in({
+  fromAccountId: 'external_account_id',
+  toAccountId: 'internal_account_id',
+  amount: '100.00',
+  currency: 'USD'
+})
+
+# Transfer from internal to external account
+transfer = client.transfers.transfer_out({
+  fromAccountId: 'internal_account_id',
+  toAccountId: 'external_account_id',
+  amount: '50.00',
+  currency: 'USD'
+})
+```
+
+### Pagination
+
+Many list endpoints support pagination using cursors:
+
+```ruby
+# First page
+response = client.customers.list(limit: 20)
+customers = response['data']
+
+# Next page
+if response['hasMore']
+  next_response = client.customers.list(
+    limit: 20,
+    cursor: response['nextCursor']
+  )
+end
+```
+
+### Error Handling
+
+The client raises specific exceptions for different error types:
+
+```ruby
+begin
+  customer = client.customers.get('invalid_id')
+rescue Lightspark::Grid::NotFoundError => e
+  puts "Customer not found: #{e.message}"
+rescue Lightspark::Grid::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+rescue Lightspark::Grid::BadRequestError => e
+  puts "Bad request: #{e.message}"
+rescue Lightspark::Grid::ServerError => e
+  puts "Server error: #{e.message}"
+rescue Lightspark::Grid::Error => e
+  puts "API error: #{e.message}"
+end
+```
+
+Available exception classes:
+- `Lightspark::Grid::Error` - Base error class
+- `Lightspark::Grid::AuthenticationError` - Invalid API credentials (401)
+- `Lightspark::Grid::BadRequestError` - Invalid request parameters (400)
+- `Lightspark::Grid::NotFoundError` - Resource not found (404)
+- `Lightspark::Grid::ConflictError` - Resource conflict (409)
+- `Lightspark::Grid::ServerError` - Internal server error (500, 501)
+
+## API Coverage
+
+This client supports all Grid API endpoints:
+
+- **Platform Configuration**: Get/update platform settings
+- **Customers**: Create, list, get, update, delete, KYC links, bulk CSV import
+- **Accounts**: Internal/external account management, Plaid integration
+- **Quotes**: UMA lookup, quote creation, execution, retry
+- **Transactions**: List, get, approve, reject
+- **Transfers**: Same-currency transfers (in/out)
+
+## Base URL
+
+The default base URL is `https://api.lightspark.com/grid/2025-10-13`. You can override this during configuration if needed (e.g., for sandbox testing).
+
+## Authentication
+
+All requests use HTTP Basic Authentication. The client automatically encodes your API token ID and client secret and includes them in the `Authorization` header.
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub.
+
+## License
+
+The gem is available as open source under the terms of the MIT License.

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/examples/grid_example.rb

@@ -0,0 +1,90 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'ls/grid'
+
+# Configure the Lightspark::Grid client
+Lightspark::Grid.configure do |config|
+  config.api_token_id = ENV['LIGHTSPARK_API_TOKEN_CLIENT_ID']
+  config.api_client_secret = ENV['LIGHTSPARK_API_TOKEN_CLIENT_SECRET']
+end
+
+client = Lightspark::Grid.client
+
+begin
+  # Get platform configuration
+  puts "Fetching platform configuration..."
+  config = client.config.get
+  puts "Platform config: #{config}"
+  puts
+
+  # Create a customer
+  puts "Creating a new customer..."
+  customer = client.customers.create({
+    type: 'INDIVIDUAL',
+    firstName: 'John',
+    lastName: 'Doe',
+    email: 'john.doe@example.com',
+    dateOfBirth: '1990-01-01',
+    address: {
+      street: '123 Main St',
+      city: 'San Francisco',
+      state: 'CA',
+      postalCode: '94102',
+      country: 'US'
+    }
+  })
+  puts "Created customer: #{customer['id']}"
+  puts
+
+  # List customers
+  puts "Listing customers..."
+  customers = client.customers.list(limit: 10)
+  puts "Found #{customers['totalCount']} customers"
+  puts
+
+  # Get customer details
+  puts "Getting customer details..."
+  customer_details = client.customers.get(customer['id'])
+  puts "Customer: #{customer_details['firstName']} #{customer_details['lastName']}"
+  puts
+
+  # List customer internal accounts
+  puts "Listing customer internal accounts..."
+  accounts = client.accounts.list_customer_internal_accounts(
+    customer_id: customer['id']
+  )
+  puts "Found #{accounts['data'].length} internal accounts"
+  puts
+
+  # Create a quote (example)
+  puts "Creating a quote..."
+  quote = client.quotes.create({
+    sourceCurrency: 'USD',
+    destinationCurrency: 'BTC',
+    sourceAmount: '100.00',
+    sendingAccountId: 'sending_account_id',
+    receiverUmaAddress: '$alice@example.com'
+  })
+  puts "Created quote: #{quote['id']}"
+  puts
+
+  # List transactions
+  puts "Listing recent transactions..."
+  transactions = client.transactions.list(limit: 5)
+  puts "Found #{transactions['totalCount']} transactions"
+  transactions['data'].each do |tx|
+    puts "  - #{tx['id']}: #{tx['status']}"
+  end
+  puts
+
+rescue Lightspark::Grid::AuthenticationError => e
+  puts "Authentication failed: #{e.message}"
+  puts "Please check your API credentials"
+rescue Lightspark::Grid::BadRequestError => e
+  puts "Bad request: #{e.message}"
+rescue Lightspark::Grid::NotFoundError => e
+  puts "Resource not found: #{e.message}"
+rescue Lightspark::Grid::Error => e
+  puts "API error: #{e.message}"
+end

data/lib/ls/grid/account.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Account
+      def initialize(client)
+        @client = client
+      end
+
+      # GET /customers/internal-accounts - List customer internal accounts
+      def list_customer_internal_accounts(customer_id:, limit: 20, cursor: nil)
+        params = { customerId: customer_id, limit: limit }
+        params[:cursor] = cursor if cursor
+
+        @client.get("/customers/internal-accounts", params: params)
+      end
+
+      # GET /platform/internal-accounts - List platform internal accounts
+      def list_platform_internal_accounts(limit: 20, cursor: nil)
+        params = { limit: limit }
+        params[:cursor] = cursor if cursor
+
+        @client.get("/platform/internal-accounts", params: params)
+      end
+
+      # GET /customers/external-accounts - List customer external accounts
+      def list_customer_external_accounts(customer_id:, limit: 20, cursor: nil)
+        params = { customerId: customer_id, limit: limit }
+        params[:cursor] = cursor if cursor
+
+        @client.get("/customers/external-accounts", params: params)
+      end
+
+      # POST /customers/external-accounts - Add customer external account
+      def create_customer_external_account(attributes)
+        @client.post("/customers/external-accounts", body: attributes)
+      end
+
+      # GET /platform/external-accounts - List platform external accounts
+      def list_platform_external_accounts(limit: 20, cursor: nil)
+        params = { limit: limit }
+        params[:cursor] = cursor if cursor
+
+        @client.get("/platform/external-accounts", params: params)
+      end
+
+      # POST /platform/external-accounts - Add platform external account
+      def create_platform_external_account(attributes)
+        @client.post("/platform/external-accounts", body: attributes)
+      end
+
+      # POST /plaid/link-tokens - Create Plaid Link token
+      def create_plaid_link_token(customer_id:)
+        @client.post("/plaid/link-tokens", body: { customerId: customer_id })
+      end
+
+      # POST /plaid/callback/{plaid_link_token} - Submit Plaid authentication token
+      def plaid_callback(plaid_link_token, public_token:)
+        @client.post("/plaid/callback/#{plaid_link_token}", body: { publicToken: public_token })
+      end
+    end
+  end
+end

data/lib/ls/grid/client.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Client
+      attr_reader :api_token_id, :api_client_secret, :base_url
+
+      def initialize(api_token_id:, api_client_secret:, base_url: nil)
+        @api_token_id = api_token_id
+        @api_client_secret = api_client_secret
+        @base_url = base_url || Grid.base_url
+      end
+
+      # Resource accessors
+      def config
+        @config ||= Config.new(self)
+      end
+
+      def customers
+        @customers ||= Customer.new(self)
+      end
+
+      def accounts
+        @accounts ||= Account.new(self)
+      end
+
+      def quotes
+        @quotes ||= Quote.new(self)
+      end
+
+      def transactions
+        @transactions ||= Transaction.new(self)
+      end
+
+      def transfers
+        @transfers ||= Transfer.new(self)
+      end
+
+      def invitations
+        @invitations ||= Invitation.new(self)
+      end
+
+      def webhooks
+        @webhooks ||= Webhook.new(self)
+      end
+
+      def sandbox
+        @sandbox ||= Sandbox.new(self)
+      end
+
+      def get(path, params: {})
+        request(:get, path, params: params)
+      end
+
+      def post(path, body: nil, params: {})
+        request(:post, path, body: body, params: params)
+      end
+
+      def patch(path, body: nil, params: {})
+        request(:patch, path, body: body, params: params)
+      end
+
+      def delete(path, params: {})
+        request(:delete, path, params: params)
+      end
+
+      private
+
+      def request(method, path, body: nil, params: {})
+        uri = build_uri(path, params)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+
+        request = build_request(method, uri, body)
+        response = http.request(request)
+
+        handle_response(response)
+      end
+
+      def build_uri(path, params)
+        uri = URI.join(base_url, path)
+        unless params.empty?
+          uri.query = URI.encode_www_form(params)
+        end
+        uri
+      end
+
+      def build_request(method, uri, body)
+        request_class = case method
+        when :get then Net::HTTP::Get
+        when :post then Net::HTTP::Post
+        when :patch then Net::HTTP::Patch
+        when :delete then Net::HTTP::Delete
+        else
+          raise ArgumentError, "Unsupported HTTP method: #{method}"
+        end
+
+        request = request_class.new(uri)
+
+        # Set Basic Auth
+        credentials = Base64.strict_encode64("#{api_token_id}:#{api_client_secret}")
+        request["Authorization"] = "Basic #{credentials}"
+
+        # Set headers
+        request["Accept"] = "application/json"
+
+        if body
+          request["Content-Type"] = "application/json"
+          request.body = JSON.generate(body)
+        end
+
+        request
+      end
+
+      def handle_response(response)
+        case response
+        when Net::HTTPSuccess, Net::HTTPCreated, Net::HTTPAccepted
+          response.body.empty? ? {} : JSON.parse(response.body)
+        when Net::HTTPBadRequest
+          raise BadRequestError, parse_error_message(response)
+        when Net::HTTPUnauthorized
+          raise AuthenticationError, "Invalid API credentials"
+        when Net::HTTPNotFound
+          raise NotFoundError, "Resource not found"
+        when Net::HTTPConflict
+          raise ConflictError, parse_error_message(response)
+        when Net::HTTPServerError, Net::HTTPNotImplemented
+          raise ServerError, parse_error_message(response)
+        else
+          raise Error, "HTTP #{response.code}: #{response.message}"
+        end
+      end
+
+      def parse_error_message(response)
+        return response.message if response.body.nil? || response.body.empty?
+
+        begin
+          error_data = JSON.parse(response.body)
+          error_data["message"] || error_data["error"] || response.message
+        rescue JSON::ParserError
+          response.message
+        end
+      end
+    end
+  end
+end

data/lib/ls/grid/config.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Config
+      def initialize(client)
+        @client = client
+      end
+
+      # GET /config - Retrieve platform settings
+      def get
+        @client.get("/config")
+      end
+
+      # PATCH /config - Update platform configuration
+      def update(attributes)
+        @client.patch("/config", body: attributes)
+      end
+    end
+  end
+end

data/lib/ls/grid/customer.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Customer
+      def initialize(client)
+        @client = client
+      end
+
+      # POST /customers - Create individual or business customer
+      def create(attributes)
+        @client.post("/customers", body: attributes)
+      end
+
+      # GET /customers - List customers with filters
+      def list(limit: 20, cursor: nil, created_after: nil, created_before: nil)
+        params = { limit: limit }
+        params[:cursor] = cursor if cursor
+        params[:createdAfter] = created_after if created_after
+        params[:createdBefore] = created_before if created_before
+
+        @client.get("/customers", params: params)
+      end
+
+      # GET /customers/{customerId} - Get customer details
+      def get(customer_id)
+        @client.get("/customers/#{customer_id}")
+      end
+
+      # PATCH /customers/{customerId} - Update customer info
+      def update(customer_id, attributes)
+        @client.patch("/customers/#{customer_id}", body: attributes)
+      end
+
+      # DELETE /customers/{customerId} - Delete customer
+      def delete(customer_id)
+        @client.delete("/customers/#{customer_id}")
+      end
+
+      # GET /customers/kyc-link - Generate KYC onboarding URL
+      def kyc_link(customer_id:, redirect_url: nil)
+        params = { customerId: customer_id }
+        params[:redirectUrl] = redirect_url if redirect_url
+
+        @client.get("/customers/kyc-link", params: params)
+      end
+
+      # POST /customers/bulk/csv - Upload customers via CSV file
+      def bulk_create_csv(csv_content)
+        @client.post("/customers/bulk/csv", body: { csv: csv_content })
+      end
+
+      # GET /customers/bulk/jobs/{jobId} - Check bulk import job status
+      def bulk_job_status(job_id)
+        @client.get("/customers/bulk/jobs/#{job_id}")
+      end
+    end
+  end
+end

data/lib/ls/grid/invitation.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Invitation
+      def initialize(client)
+        @client = client
+      end
+
+      # POST /invitations - Create UMA invitation
+      def create(attributes)
+        @client.post("/invitations", body: attributes)
+      end
+
+      # GET /invitations/{invitationCode} - Get invitation details
+      def get(invitation_code)
+        @client.get("/invitations/#{invitation_code}")
+      end
+
+      # POST /invitations/{invitationCode}/claim - Claim invitation
+      def claim(invitation_code, attributes = {})
+        @client.post("/invitations/#{invitation_code}/claim", body: attributes)
+      end
+
+      # POST /invitations/{invitationCode}/cancel - Cancel invitation
+      def cancel(invitation_code)
+        @client.post("/invitations/#{invitation_code}/cancel")
+      end
+    end
+  end
+end

data/lib/ls/grid/quote.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Quote
+      def initialize(client)
+        @client = client
+      end
+
+      # GET /receiver/uma/{receiverUmaAddress} - Look up UMA address for payment
+      def lookup_uma_receiver(receiver_uma_address, user_id:)
+        params = { userId: user_id }
+        @client.get("/receiver/uma/#{receiver_uma_address}", params: params)
+      end
+
+      # GET /receiver/external-account/{accountId} - Look up external account details
+      def lookup_external_account(account_id)
+        @client.get("/receiver/external-account/#{account_id}")
+      end
+
+      # POST /quotes - Create transfer quote
+      def create(attributes)
+        @client.post("/quotes", body: attributes)
+      end
+
+      # GET /quotes - List quotes with filters
+      def list(limit: 20, cursor: nil, created_after: nil, created_before: nil)
+        params = { limit: limit }
+        params[:cursor] = cursor if cursor
+        params[:createdAfter] = created_after if created_after
+        params[:createdBefore] = created_before if created_before
+
+        @client.get("/quotes", params: params)
+      end
+
+      # GET /quotes/{quoteId} - Retrieve quote details
+      def get(quote_id)
+        @client.get("/quotes/#{quote_id}")
+      end
+
+      # POST /quotes/{quoteId}/execute - Execute confirmed quote
+      def execute(quote_id, attributes = {})
+        @client.post("/quotes/#{quote_id}/execute", body: attributes)
+      end
+
+      # POST /quotes/{quoteId}/retry - Retry incomplete payment
+      def retry(quote_id)
+        @client.post("/quotes/#{quote_id}/retry")
+      end
+    end
+  end
+end

data/lib/ls/grid/sandbox.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Sandbox
+      def initialize(client)
+        @client = client
+      end
+
+      # POST /sandbox/send - Simulate sending funds (sandbox only)
+      def send(attributes)
+        @client.post("/sandbox/send", body: attributes)
+      end
+
+      # POST /sandbox/receive - Simulate receiving funds (sandbox only)
+      def receive(attributes)
+        @client.post("/sandbox/receive", body: attributes)
+      end
+    end
+  end
+end

data/lib/ls/grid/transaction.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Transaction
+      def initialize(client)
+        @client = client
+      end
+
+      # GET /transactions - List transactions with filters
+      def list(limit: 20, cursor: nil, created_after: nil, created_before: nil)
+        params = { limit: limit }
+        params[:cursor] = cursor if cursor
+        params[:createdAfter] = created_after if created_after
+        params[:createdBefore] = created_before if created_before
+
+        @client.get("/transactions", params: params)
+      end
+
+      # GET /transactions/{transactionId} - Get transaction details
+      def get(transaction_id)
+        @client.get("/transactions/#{transaction_id}")
+      end
+
+      # POST /transactions/{transactionId}/approve - Approve pending incoming payment
+      def approve(transaction_id, attributes = {})
+        @client.post("/transactions/#{transaction_id}/approve", body: attributes)
+      end
+
+      # POST /transactions/{transactionId}/reject - Reject pending incoming payment
+      def reject(transaction_id, reason: nil)
+        body = reason ? { reason: reason } : {}
+        @client.post("/transactions/#{transaction_id}/reject", body: body)
+      end
+    end
+  end
+end

data/lib/ls/grid/transfer.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Transfer
+      def initialize(client)
+        @client = client
+      end
+
+      # POST /transfer-in - Transfer from external to internal account
+      def transfer_in(attributes)
+        @client.post("/transfer-in", body: attributes)
+      end
+
+      # POST /transfer-out - Transfer from internal to external account
+      def transfer_out(attributes)
+        @client.post("/transfer-out", body: attributes)
+      end
+    end
+  end
+end

data/lib/ls/grid/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    VERSION = "0.1.0"
+  end
+end

data/lib/ls/grid/webhook.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Lightspark
+  module Grid
+    class Webhook
+      def initialize(client)
+        @client = client
+      end
+
+      # POST /webhooks/test - Send test webhook
+      def test(event_type:)
+        @client.post("/webhooks/test", body: { eventType: event_type })
+      end
+    end
+  end
+end

data/lib/ls/grid.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+require "base64"
+
+require_relative "grid/version"
+require_relative "grid/client"
+require_relative "grid/config"
+require_relative "grid/customer"
+require_relative "grid/account"
+require_relative "grid/quote"
+require_relative "grid/transaction"
+require_relative "grid/transfer"
+require_relative "grid/invitation"
+require_relative "grid/webhook"
+require_relative "grid/sandbox"
+
+module Lightspark
+  module Grid
+    class Error < StandardError; end
+    class AuthenticationError < Error; end
+    class NotFoundError < Error; end
+    class BadRequestError < Error; end
+    class ConflictError < Error; end
+    class ServerError < Error; end
+
+    class << self
+      attr_accessor :api_token_id, :api_client_secret, :base_url
+
+      def configure
+        yield self
+      end
+
+      def client
+        @client ||= Client.new(
+          api_token_id: api_token_id,
+          api_client_secret: api_client_secret,
+          base_url: base_url
+        )
+      end
+    end
+
+    # Default base URL
+    self.base_url = "https://api.lightspark.com/grid/2025-10-13"
+  end
+end

data/sig/ls/grid.rbs

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

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: ls-grid
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Kang-Kyu Lee
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.0
+description: Use Lightspark Grid API for money moving with ls-grid gem
+email:
+- kangkyu1111@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- examples/grid_example.rb
+- lib/ls/.DS_Store
+- lib/ls/grid.rb
+- lib/ls/grid/account.rb
+- lib/ls/grid/client.rb
+- lib/ls/grid/config.rb
+- lib/ls/grid/customer.rb
+- lib/ls/grid/invitation.rb
+- lib/ls/grid/quote.rb
+- lib/ls/grid/sandbox.rb
+- lib/ls/grid/transaction.rb
+- lib/ls/grid/transfer.rb
+- lib/ls/grid/version.rb
+- lib/ls/grid/webhook.rb
+- sig/ls/grid.rbs
+homepage: https://github.com/kangkyu/lightspark-grid
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/kangkyu/lightspark-grid
+  changelog_uri: https://github.com/kangkyu/lightspark-grid/blob/master/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.7.2
+specification_version: 4
+summary: Lightspark Grid API Ruby client
+test_files: []