xrpl-ruby 0.9.1 → 0.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a1c55dbc3009b560835b548bc4d9438ba6db78522bba892df27f55da5062e38
-  data.tar.gz: beace0bdd4432bb8066c85bf7c9f08ff1c3f9620b561f89c07eed4303d0dc123
+  metadata.gz: ee2463ebb26de37ec88b1c796591a4088f97452dd59bd50bd8d813f431ec45cf
+  data.tar.gz: b52c8745a69f90af16f2ac61bf8693e165d5dfccbae5ace43262835a030e4440
 SHA512:
-  metadata.gz: e60d54f4c8f1dd7022a171541dac1c851dc990f82c527458f495335f3f64132c93cf794748da215b4cbb154868853b1302245c6f1e38becf62df0c18d4a256c7
-  data.tar.gz: 4092bb66dc708147a33f1c4a84a599e358948efac34c18838463efc50eace671a118c74f6af827ffca79ce71e09d693aa4d66aec292aebc2c85cca7deaf9b8e6
+  metadata.gz: 1a534a34eb4a9d1ae3ad38e3c2c12051b99f515cbfeaff4b14d217b7a200594fb6b611c617bc9815f50d78ce86378ea717558329f3682da36215a0b9fe0fac8a
+  data.tar.gz: 13e6f490edfec2457e31aa305d6c2ce890cde6f774c5fa9eec331e35f16bc8021762037b6bf9d9f0c46e000b282a7ff6e7222563ce114bd323069f7b196c388a

data/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.2] - 2026-11-09
+
+A patch release with one codec fix: an account field of length zero now keeps
+its bytes through decoding and encoding, as in rippled. The README's advice on
+`PaymentBurn` is updated too. Codec fixtures 39/39 and 263/263, both ways; all
+10 Testnet specs pass on the release commit.
+
+### Changed
+
+- **`PaymentBurn` delegation.** The README no longer advises against it on
+  Mainnet and Testnet, where `fixCleanup3_4_0` is now enabled. On a network
+  without the amendment the warning still applies.
+
+### Fixed
+
+- **An unset account field.** An account field of length zero, as in a pseudo
+  transaction, decoded as the zero account and encoded back as 20 zero bytes,
+  which changes the bytes and the hash. Both directions now follow rippled's
+  `STAccount`: an empty field reads as `''`, and `''` writes an empty field.
+  The zero account `rrrrrrrrrrrrrrrrrrrrrhoLvTp` and accounts in fixed-width
+  positions (an issuer, a path step) are unchanged. If you passed `''` to mean
+  the zero account, pass `rrrrrrrrrrrrrrrrrrrrrhoLvTp` instead.
+
 ## [0.9.1] - 2026-11-02
 
 A patch release with one fix: codec types now produce valid JSON inside

data/README.md

@@ -218,12 +218,11 @@ permissions. A permission is either a transaction type, such as `"Payment"`,
 or one of the granular permissions, such as `"TrustlineAuthorize"` or
 `"PaymentMint"`. The codec translates both names.
 
-> **Do not delegate `"PaymentBurn"` until the `fixCleanup3_4_0` amendment is
-> enabled on the target network.** Before that fix, a delegate holding
-> `PaymentBurn` can in certain circumstances also mint fungible tokens
-> (trust line tokens or MPTs). The `feature` method of a node reports
-> whether it is enabled there; [Known Amendments](https://xrpl.org/resources/known-amendments)
-> has the Mainnet status. Source:
+> **`"PaymentBurn"` is safe to delegate only where the `fixCleanup3_4_0`
+> amendment is enabled.** It is on Mainnet and Testnet. On a network without
+> it, a delegate holding `PaymentBurn` can in certain circumstances also mint
+> fungible tokens (trust line tokens or MPTs). The `feature` method of a node
+> reports whether it is enabled there. Source:
 > [Permission Values](https://xrpl.org/docs/references/protocol/data-types/permission-values).
 
 ```ruby

data/lib/binary-codec/serdes/binary_serializer.rb

@@ -73,8 +73,9 @@ module BinaryCodec
     def write_length_encoded(value, is_unl_modify_workaround = false)
       bytes = BytesList.new
 
-      unless is_unl_modify_workaround
-        # This part doesn't happen for the Account field in a UNLModify transaction
+      # An unset account field and the Account field in a UNLModify transaction
+      # have no bytes.
+      unless is_unl_modify_workaround || (value.is_a?(AccountId) && value.unset?)
         value.to_byte_sink(bytes)
       end
 

data/lib/binary-codec/types/account_id.rb

@@ -1,11 +1,40 @@
 # frozen_string_literal: true
 
 module BinaryCodec
+    # An account field can be unset, which is not the zero account: empty on the
+    # wire instead of 20 zero bytes, and '' in JSON instead of
+    # rrrrrrrrrrrrrrrrrrrrrhoLvTp. This follows STAccount in rippled, which keeps
+    # 20 zero bytes and a flag, so a value in a fixed width position, such as the
+    # issuer of an Amount, stays 20 bytes long.
     class AccountId < Hash160
         @width = 20
 
-        def initialize(bytes = nil)
+        def initialize(bytes = nil, unset: false)
             super(bytes)
+            @unset = unset
+        end
+
+        # Creates an unset account field.
+        # @return [AccountId] The created instance.
+        def self.unset
+            new(unset: true)
+        end
+
+        # Creates an AccountId from a parser.
+        # @param parser [BinaryParser] The parser to read from.
+        # @param hint [Integer, nil] The length of the field, nil at a fixed width position.
+        # @return [AccountId] The created instance.
+        def self.from_parser(parser, hint = nil)
+            return unset if hint == 0
+
+            super
+        end
+
+        # Whether this is an unset field rather than an account, the zero account
+        # included. The serializer writes such a field with length zero.
+        # @return [Boolean]
+        def unset?
+            @unset
         end
 
         # Creates a new AccountId instance from a value.
@@ -15,7 +44,7 @@ module BinaryCodec
             return value if value.is_a?(AccountId)
 
             if value.is_a?(String)
-                return new if value.empty?
+                return unset if value.empty?
 
                 if valid_hex?(value)
                     return new(hex_to_bytes(value))
@@ -46,7 +75,7 @@ module BinaryCodec
         end
 
         def to_json(_definitions = nil, _field_name = nil)
-            to_base58
+            unset? ? '' : to_base58
         end
 
         # Returns the base58 representation of the account ID.

data/lib/xrpl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module XRPL
-  VERSION = '0.9.1'
+  VERSION = '0.9.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: xrpl-ruby
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.2
 platform: ruby
 authors:
 - Alexander Busse
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-02 00:00:00.000000000 Z
+date: 2026-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler