joeblackwaslike / coinaddr

Cryptocurrency address inspection/validation library for python

CoinAddr

Maintainer

Joe Black | [email protected] | github

Introduction

A cryptocurrency address inspection/validation library for python.

Supported currencies

• bitcoin
• bitcoin-cash
• litecoin
• ethereum
• ethereum-classic
• ether-zero
• dogecoin
• dashcoin
• neocoin
• ripple

Installation

pip3 install coinaddr

Usage

>>> import coinaddr
>>> coinaddr.validate('btc', b'1BoatSLRHtKNngkdXEeobR76b53LETtpyT')
ValidationResult(name='bitcoin', ticker='btc', address=b'1BoatSLRHtKNngkdXEeobR76b53LETtpyT', valid=True, network='main')

Extending

Currencies

To add a new currency, simply instantiate a new coinaddr.currency.Currency class. It will be automatically registered.

from coinaddr import Currency
Currency('testcoin', ticker='ttc', validator='Base58Check',
         networks=dict(
            main=(0x00, 0x05), test=(0x6f, 0xc4)))

To override a default currency, simply instantiate a new currency with that name.

Validators

To add a new validator, simply create a subclass of coinaddr.validation.ValidatorBase with your own implementation that implements the coinaddr.interfaces.IValidator interface. It will be automatically registered.

from zope.interface import implementer
from coinaddr.interfaces import IValidator
from coinaddr import ValidatorBase


@implementer(IValidator)
class NewValidator(ValidatorBase):
    name = 'New'

    @property
    def networks(self):
        return 'testing'

    def validate(self):
        return True

To override a default validator, simply create a new validator with that name.

Changes

• CHANGELOG

coinaddr's Issues

Exception when wrong network

Hi, thanks for useful library.

One issue, when checking address with wrong currency, we have exception due to strong typing. Here:

    @property
    def network(self):
        """Return network derived from network version bytes."""
        abytes = base58check.b58decode(
            self.request.address, **self.request.extras)

        nbyte = abytes[0]
        for name, networks in self.request.currency.networks.items():
            if nbyte in networks:
                return name

In case of wrong networks you return None, but expecting string. So we have valid=False and exception.

P.S. more currency structures you can find here: https://github.com/ognus/wallet-address-validator/blob/master/src/currencies.js

Coinaddr does not recognize some ETH addresses.

Coinaddr can't validate this address: 0x0783b48c3e64c12b8ed55ccd409e46e9c0399e74

not working

coinaddr.validate('ltc', b'1111')

TypeError: ("'network' must be <class 'str'> (got None that is a <class 'NoneType'>).",

print(coinaddr.validate('eth', '111'))

ValidationResult(name='ethereum', ticker='eth', address=b'111', valid=True, network='both')

Not working on windows 10

Hi , I've tried installing coinaddr on windows 10 and i haven't been able the install it , it just throws an error and it seems i can't fix it . Please help with the problem .

I've tried installing with pip install coinaddr and python pip install coinaddr

I'll attach a photo of the error .

Support EOS and USDT

EOS is the same as ETH and USDT is the same as BTC, so it should be an easy fix to support those two assets.

Coinaddr does not recognize bech32 addresses

Coinaddr incorrectly reports bech32 addresses (starting with bc1) as invalid.