Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vtm9/adequate_crypto_address
A Ruby Library for dealing with validation cryptocurrency addresses
https://github.com/vtm9/adequate_crypto_address
bitcoin bitcoincash dash ethereum ltc ripple ruby zcash
Last synced: about 1 month ago
JSON representation
A Ruby Library for dealing with validation cryptocurrency addresses
- Host: GitHub
- URL: https://github.com/vtm9/adequate_crypto_address
- Owner: vtm9
- License: mit
- Created: 2018-09-14T12:07:21.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2022-09-14T16:22:59.000Z (about 2 years ago)
- Last Synced: 2024-09-29T04:03:50.018Z (about 2 months ago)
- Topics: bitcoin, bitcoincash, dash, ethereum, ltc, ripple, ruby, zcash
- Language: Ruby
- Homepage:
- Size: 48.8 KB
- Stars: 21
- Watchers: 2
- Forks: 13
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
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]
[![License][license-svg]][license-link]
Simple wallet address validator and normalizer for cryptocurrencies addresses in Ruby.
Inspired by [ognus/wallet-address-validator](https://github.com/ognus/wallet-address-validator).
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'adequate_crypto_address'
```
Or install it yourself as:
```bash
gem install adequate_crypto_address
```
## Main API
##### .valid? (address, currency [, type = :prod])
###### Parameters
* address - Wallet address to validate.
* currency - Currency name string or symbol in any case, `:bitcoin` or `'BTC'` or `:btc` or `'BitCoin'`
* type - Optional. You can enforce validation with specific type. Not all currencies support types.
> Returns true if the address (string) is a valid wallet address for the crypto currency specified, see below for supported currencies.
### Supported crypto currencies
* Bitcoin/BTC, `'bitcoin'` or `'BTC'` types: `:segwit_v0_keyhash :segwit_v0_scripthash :hash160 :p2sh`
* BitcoinCash/BCH, `'bitcoincash'` or `'BCH'` types: `:p2sh :p2pkh :p2pkhtest :p2shtest`
* Dash, `'dash'` or `'DASH'` types: `:prod :test`
* Zcash/ZEC, `'zcash'` or `'ZEC'` types: `:prod :test`
* Ethereum/ETH, `'ethereum'` or `'ETH'`
* Ripple/XRP, `'ripple'` or `'XRP'`
* Toncoin, `'TON'`
* Monero/XRM, `'monero'`
## Usage
### Validation
``` ruby
require 'adequate_crypto_address'
# BTC
AdequateCryptoAddress.valid?('12QeMLzSrB8XH8FvEzPMVoRxVAzTr5XM2y', 'BTC') #=> true
AdequateCryptoAddress.valid?('3NJZLcZEEYBpxYEUGewU4knsQRn1WM5Fkt', :bitcoin, :p2sh) #=> true
# BCH
AdequateCryptoAddress.valid?('bitcoincash:qrtj3rd8524cndt2eew3s6wljqggmne00sgh4kfypk', :bch) #=> true
AdequateCryptoAddress.valid?('mmRH4e9WW4ekZUP5HvBScfUyaSUjfQRyvD', :BCH, :p2pkhtest) #=> true
# ETH
AdequateCryptoAddress.valid?('0xde709f2102306220921060314715629080e2fb77', :ETH) #=> true
AdequateCryptoAddress.valid?('de709f2102306220921060314715629080e2fb77', :ethereum) #=> true
```
### Normalization
###### *Not all currencies support this feature.
``` ruby
require 'adequate_crypto_address'
# BCH
AdequateCryptoAddress.address('mmRH4e9WW4ekZUP5HvBScfUyaSUjfQRyvD', 'bch').cash_address #=> "bchtest:qpqtmmfpw79thzq5z7s0spcd87uhn6d34uqqem83hf"
AdequateCryptoAddress.address('bitcoincash:qrtj3rd8524cndt2eew3s6wljqggmne00sgh4kfypk', 'bch').legacy_address #=> "1LcerwTc1oPsMtByDCNUXFxReZpN1EXHoe"
address_string = 'qrtj3rd8524cndt2eew3s6wljqggmne00sgh4kfypk'
addr = AdequateCryptoAddress.address(address_string, 'bch')
addr.prefix #=> "bitcoincash"
addr.type #=> :p2pkh
addr.address #=> "bitcoincash:qrtj3rd8524cndt2eew3s6wljqggmne00sgh4kfypk"
# ETH
AdequateCryptoAddress.address('D1220A0cf47c7B9Be7A2E6BA89F429762e7b9aDb', 'eth').address #=> "0xD1220A0cf47c7B9Be7A2E6BA89F429762e7b9aDb"
```
### ActiveRecord validation example
``` ruby
class Model < ActiveRecord::Base
attribute :address, :string
attribute :dest_tag, :string
attribute :currency, :string
validate :validate_address_type
validate :validate_destination_tag
def validate_address_type
errors.add(:address, 'invalid address') unless AdequateCryptoAddress.valid?(address, currency)
end
# for Ripple
def validate_destination_tag
errors.add(:dest_tag, 'invalid destination tag') if dest_tag.present? && !(dest_tag =~ /\A\d{1,10}\z/)
end
end
```
### Add your currnecy
``` ruby
# frozen_string_literal: true
# for Rails /config/initializers/adequate_crypto_address.rb
module AdequateCryptoAddress
class Coin
attr_reader :address
def initialize(address_sring)
@address = address_sring
end
def valid?(_type)
address.present?
end
end
end
AdequateCryptoAddress.valid?('addr', :coin) #=> true
```
## Development
Run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
## Contributing
1. Fork [the repo](https://github.com/vtm9/adequate_crypto_address)
2. Grab dependencies: `bundle install`
3. Make sure everything is working: `bundle exec rake spec`
4. Make your changes
5. Test your changes
5. Create a Pull Request
6. Celebrate!!!!!
## Notes
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-link]: https://rubygems.org/gems/adequate_crypto_address
[downloads-svg]: http://ruby-gem-downloads-badge.herokuapp.com/adequate_crypto_address
[downloads-link]: https://rubygems.org/gems/adequate_crypto_address
[build-status-svg]: https://travis-ci.org/vtm9/adequate_crypto_address.svg?branch=master
[build-status-link]:https://travis-ci.org/vtm9/adequate_crypto_address
[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
[license-link]: https://github.com/vtm9/adequate_crypto_address/blob/master/LICENSE.txt