adequate_crypto_address 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1b6ee057501d6aee79d635204e6171784b6628e48663a74b0961ca837ebcf3c
-  data.tar.gz: c85732ee34eee9d27ac63ee4fe4a22079278011acda4fe1aeadfa215b8d5f85f
+  metadata.gz: df433b807d749cf8b119f5518093375a5634c1c1669ca7414ddb55085bc1f08b
+  data.tar.gz: 3dc0e213e7fcbc06b82cb0062af5c80caa3d56466ac67e8689c20fa48f01a952
 SHA512:
-  metadata.gz: 535343adea99012947178355228daf705b9f01bd97b550ee8e01e0d3e71077df9f3b1b7aab26f249b8972ea1c4ccf82b276ef1c5ca054bdd398126f4aad8f5de
-  data.tar.gz: 4602af0c018876b2d3ad041253fd97de6c8d3c7709097ca68ddf5a95c09d983cd1623d6c38aa272fb07fd7503cf04ed5f8b4bfa99fecde28e55bd7b19e3c8781
+  metadata.gz: 358d49195d75675e1364617c1053795fc31e817534701e0758f2086653ef2e6aa11fc6198f596216fe5228dae1d73a73fd4b02c18b9d96ecdc4a14cb415230c2
+  data.tar.gz: 36a5d580408b7063de6765f031aaaeb2e9d3f2f98dcf8296bbdf314a8d4c37deadaacf271ffb458ba5edebfb8cebc270e1f030565e11682d704b7ed1125dd265

data/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-09-02
+
+### Added
+
+- **TRON (TRX)** validation — Base58Check with the `0x41` version byte and
+  double-SHA256 checksum. Currency names: `trx`, `tron`. Type: `:prod`.
+- **Tezos (XTZ)** validation — Base58Check with `tz1`/`tz2`/`tz3` implicit and
+  `KT1` originated (contract) prefixes. Currency names: `xtz`, `tezos`.
+  Types: `:implicit`, `:originated`.
+- **Cosmos (ATOM)** validation — Bech32 with the `cosmos` human-readable part and
+  a 20-byte payload. Currency names: `atom`, `cosmos`. Type: `:prod`.
+- **BNB Smart Chain (BSC)** validation — Ethereum-format addresses with the
+  EIP-55 checksum. Currency names: `bsc`, `binancesmartchain`. Type: `:bsc`.
+
+[0.3.0]: https://github.com/vtm9/adequate_crypto_address/releases/tag/v0.3.0
+
 ## [0.2.0] - 2026-09-02
 
 This release hardens the validators against malformed input found in the

data/README.md

@@ -4,7 +4,6 @@ AdequateCryptoAddress
 
 [![Gem Version][gem-version-svg]][gem-version-link]
 [![Build Status][build-status-svg]][build-status-link]
-[![Code Climate][codeclimate-status-svg]][codeclimate-status-link]
 [![Coverage Status][coverage-status-svg]][coverage-status-link]
 [![Downloads][downloads-svg]][downloads-link]
 [![Docs][docs-rubydoc-svg]][docs-rubydoc-link]
@@ -132,6 +131,10 @@ AdequateCryptoAddress.address_type('not a real address', :btc)
 * Stellar/XLM, `'stellar'` or `'XLM'` types: `:account :muxed`
 * Toncoin/TON, `'TON'` or `'Toncoin'` types: `:ton_mainnet :ton_testnet`
 * Monero/XMR, `'monero'` or `'XMR'` types: `:standard :integrated :subaddress` (`.network` reports `:mainnet`/`:testnet`/`:stagenet`)
+* TRON/TRX, `'tron'` or `'TRX'` type: `:prod`
+* Tezos/XTZ, `'tezos'` or `'XTZ'` types: `:implicit :originated`
+* Cosmos/ATOM, `'cosmos'` or `'ATOM'` type: `:prod`
+* BNB Smart Chain/BSC, `'bsc'` or `'binancesmartchain'` type: `:bsc` (Ethereum-format address)
 
 ### Format coverage
 
@@ -264,16 +267,14 @@ Individual tasks are available as `mise run test`, `mise run lint`, and `mise ru
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/vtm9/adequate_crypto_address/issues
 
-[gem-version-svg]: https://badge.fury.io/rb/adequate_crypto_address.svg
+[gem-version-svg]: https://img.shields.io/gem/v/adequate_crypto_address.svg
 [gem-version-link]: https://rubygems.org/gems/adequate_crypto_address
-[downloads-svg]: http://ruby-gem-downloads-badge.herokuapp.com/adequate_crypto_address
+[downloads-svg]: https://img.shields.io/gem/dt/adequate_crypto_address.svg
 [downloads-link]: https://rubygems.org/gems/adequate_crypto_address
 [build-status-svg]: https://github.com/vtm9/adequate_crypto_address/actions/workflows/ci.yml/badge.svg?branch=master
 [build-status-link]: https://github.com/vtm9/adequate_crypto_address/actions/workflows/ci.yml
 [coverage-status-svg]: https://coveralls.io/repos/vtm9/adequate_crypto_address/badge.svg?branch=master
 [coverage-status-link]: https://coveralls.io/r/vtm9/adequate_crypto_address?branch=master
-[codeclimate-status-svg]: https://codeclimate.com/github/vtm9/adequate_crypto_address.svg
-[codeclimate-status-link]: https://codeclimate.com/github/vtm9/adequate_crypto_address
 [docs-rubydoc-svg]: https://img.shields.io/badge/docs-rubydoc-blue.svg
 [docs-rubydoc-link]: http://www.rubydoc.info/gems/adequate_crypto_address/
 [license-svg]: https://img.shields.io/badge/license-MIT-blue.svg

data/lib/adequate_crypto_address/atom.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module AdequateCryptoAddress
+  # Cosmos Hub (ATOM) account addresses are Bech32 (not Bech32m) with the
+  # `cosmos` human-readable part and a 20-byte address payload.
+  # https://docs.cosmos.network/main/build/spec/addresses/bech32
+  class Atom
+    HRP = 'cosmos'
+    PAYLOAD_BYTES = 20
+    MAX_LENGTH = 90
+
+    attr_reader :address, :type
+
+    def initialize(address)
+      @address = address
+      @type = detect_type
+    end
+
+    def valid?(validated_type = nil)
+      return !type.nil? unless validated_type
+
+      type == validated_type.to_sym
+    end
+
+    # :prod when the address is a valid cosmos account address, otherwise nil.
+    def address_type
+      type
+    end
+
+    private
+
+    def detect_type
+      return nil if address.to_s.length > MAX_LENGTH
+
+      :prod if valid_bech32?
+    end
+
+    def valid_bech32?
+      decoded = Utils::Bech32.decode(address, include_encoding: true)
+      return false unless decoded
+
+      hrp, data, encoding = decoded
+      return false unless hrp == HRP && encoding == :bech32
+
+      bytes = Utils::Bech32.convert_bits(data, from_bits: 5, to_bits: 8, pad: false)
+      bytes&.length == PAYLOAD_BYTES
+    rescue StandardError
+      false
+    end
+  end
+
+  Cosmos = Atom
+end

data/lib/adequate_crypto_address/eth.rb

@@ -81,4 +81,13 @@ module AdequateCryptoAddress
     end
   end
   Ethereum = Eth
+
+  # BNB Smart Chain uses the same address format and EIP-55 checksum as Ethereum.
+  class Bsc < Eth
+    def address_type
+      valid? ? :bsc : nil
+    end
+  end
+
+  Binancesmartchain = Bsc
 end

data/lib/adequate_crypto_address/trx.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module AdequateCryptoAddress
+  # TRON mainnet addresses are Base58Check with the 0x41 version byte and a
+  # four-byte double-SHA256 checksum (25 bytes total, rendered as a 34-character
+  # string starting with "T"). https://developers.tron.network/docs/account
+  class Trx < Altcoin
+    ADDRESS_TYPES = { prod: %w[41] }.freeze
+  end
+
+  Tron = Trx
+end

data/lib/adequate_crypto_address/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AdequateCryptoAddress
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 end

data/lib/adequate_crypto_address/xtz.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module AdequateCryptoAddress
+  # Tezos addresses are Base58Check with a four-byte double-SHA256 checksum and
+  # multi-byte version prefixes: tz1/tz2/tz3 implicit accounts and KT1 originated
+  # (contract) accounts, each wrapping a 20-byte hash (27 bytes total).
+  # https://tezos.gitlab.io/user/key-management.html
+  class Xtz < Altcoin
+    EXPECTED_LENGTH = 54 # 27 bytes rendered as hex
+
+    ADDRESS_TYPES = {
+      implicit: %w[06a19f 06a1a1 06a1a4], # tz1, tz2, tz3
+      originated: %w[025a79] # KT1
+    }.freeze
+  end
+
+  Tezos = Xtz
+end

data/lib/adequate_crypto_address.rb

@@ -19,6 +19,9 @@ require 'adequate_crypto_address/doge'
 require 'adequate_crypto_address/sol'
 require 'adequate_crypto_address/xlm'
 require 'adequate_crypto_address/ada'
+require 'adequate_crypto_address/trx'
+require 'adequate_crypto_address/xtz'
+require 'adequate_crypto_address/atom'
 
 module AdequateCryptoAddress
   class UnknownCurrency < StandardError; end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: adequate_crypto_address
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - vtm
@@ -50,6 +50,7 @@ files:
 - lib/adequate_crypto_address.rb
 - lib/adequate_crypto_address/ada.rb
 - lib/adequate_crypto_address/altcoin.rb
+- lib/adequate_crypto_address/atom.rb
 - lib/adequate_crypto_address/bch.rb
 - lib/adequate_crypto_address/btc.rb
 - lib/adequate_crypto_address/dash.rb
@@ -58,6 +59,7 @@ files:
 - lib/adequate_crypto_address/ltc.rb
 - lib/adequate_crypto_address/sol.rb
 - lib/adequate_crypto_address/ton.rb
+- lib/adequate_crypto_address/trx.rb
 - lib/adequate_crypto_address/utils/bch.rb
 - lib/adequate_crypto_address/utils/bech32.rb
 - lib/adequate_crypto_address/utils/monero_base58.rb
@@ -66,6 +68,7 @@ files:
 - lib/adequate_crypto_address/xlm.rb
 - lib/adequate_crypto_address/xmr.rb
 - lib/adequate_crypto_address/xrp.rb
+- lib/adequate_crypto_address/xtz.rb
 - lib/adequate_crypto_address/zec.rb
 homepage: https://github.com/vtm9/adequate_crypto_address
 licenses: