rail0-sdk 1.3.1 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23d06a854473333eb6779af7bcec4ea5d370ab9c24106cef8a1db9809ca29803
-  data.tar.gz: b6a28727e25233378a5c39feceb00f7a638d44590a8f9f01f356e1e6e0d35f91
+  metadata.gz: 5432df0776e08a77c56678e4e977d87c81ddf2be6176fef59a95051e287a6ce9
+  data.tar.gz: 7747a265cc8d84f243a09a8b1ab66e3cba545a3817554bc321dc5aa9eaed34be
 SHA512:
-  metadata.gz: fdb399b1895e43ef062221da06357db402bb59fc746a36d6a21499d9ac82625723db5dc454cb8c46cb1e77e4889d05b00f8497da9d858a0e8f470e286c29f4a4
-  data.tar.gz: 7f329e33476a42b6d3304c3a1978dab10425740a460d2f6a066660ce9f67e24399c81d783372d65172b5247e670362970f82ddbf16e7fb7d5c7a5172e8fb9e8b
+  metadata.gz: 440edc898e25a83ad3c76615777b4074f7daf003904db75129df01c4fcb223aebad7e5a1e425212207842aa334cdab1bccfe79a0023fcf08578d5bc09da8462a
+  data.tar.gz: 7482c21a09309b6dabe1f26c4b19b29890d8b8dfc679d4fc1b15d8b1de76a39b2f5998414e2e28ab3ee840edc2e31e7531ebe3b215c0a308f92068d0754ac46a

data/README.md

@@ -378,6 +378,10 @@ client.payments.create(params, idempotency_key: nil)  # or keyword fields
 # Reusing a key for DIFFERENT terms raises Rail0::ApiError with code
 # "idempotency_key_reused" (422) instead of returning the first payment.
 client.payments.get(id)
+client.payments.update(id, description: "Order #42")  # → the payment, same shape as get
+client.payments.update(id, description: nil)          # nil (or "") clears it
+# The description is the only editable field: off-chain, so any status, settled included.
+# Payer or payee only (a non-participant gets 404); over 255 characters is a 422.
 client.payments.list(status: "authorized", disputed: false, chain_id: 84532, sort: "-created_at")
 client.payments.list(status: %w[authorized expired])  # any of several states → ?status=authorized,expired
 client.payments.list(operation: "refund")            # payments with at least one refund transaction

data/lib/rail0/resources/payments.rb

@@ -102,6 +102,24 @@ module Rail0
         http.get("/payments/#{segment(id)}")
       end
 
+      # Set or clear a payment's description (PATCH /payments/{id}).
+      #
+      # The description is the only field this route edits: it is off-chain metadata, so
+      # it can change at any status, settled payments included. Only a participant (the
+      # payer or the payee) may edit it — a non-participant gets the same 404 as an unknown
+      # id, and a deactivated caller wallet a 403 `wallet_deactivated`.
+      #
+      # +description:+ is required, and is always sent: passing +nil+ sends JSON +null+,
+      # which clears it (as does +""+). Over 255 characters is a 422.
+      # (rail0-gateway#373)
+      #
+      # @param id [String] Payment UUID or rail0_id.
+      # @param description [String, nil] The new description; +nil+ or +""+ clears it.
+      # @return [Hash] The updated payment, the same shape {get} returns.
+      def update(id, description:)
+        http.patch("/payments/#{segment(id)}", { description: description })
+      end
+
       # List on-chain transactions for a payment.
       # @param id [String] Payment UUID or rail0_id.
       # @param operation [String, nil] Filter by operation (see {TRANSACTION_OPERATIONS} —

data/lib/rail0/types.rb

@@ -173,16 +173,6 @@ module Rail0
       keyword_init: true
     )
 
-    # A wallet's token holding, with the wallet, token, and blockchain nested via their own schemas.
-    WalletToken = Struct.new(
-      :default,     # Boolean
-      :active,      # Boolean
-      :wallet,      # Wallet
-      :token,       # Token
-      :blockchain,  # Blockchain
-      keyword_init: true
-    )
-
     # A wallet's token holding as nested under its wallet (GET /accounts/:id/wallets): the token plus
     # this wallet's per-token flags, without re-nesting the wallet.
     WalletTokenHolding = Struct.new(

data/lib/rail0/version.rb

@@ -5,5 +5,5 @@ module Rail0
   # consumed by path from a sibling checkout, where the number bought nothing: no registry
   # ever served a 1.x, no tag was ever cut, and the one consumer resolves the working tree.
   # Publishing from 1.2.0 would have implied two releases nobody can install.
-  VERSION = "1.3.1"
+  VERSION = "1.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rail0-sdk
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.4.0
 platform: ruby
 authors:
 - Commerce Layer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-29 00:00:00.000000000 Z
+date: 2026-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: logger