ethereumjs/ethereumjs-icap
https://github.com/ethereumjs/ethereumjs-icap
ethereumjs-icap
安装:
npm install ethereumjs-icap --save
Utilities for handling ICAP addresses.
It works in Node.js as well as in the browser via browserify
. When minified for a browser, it should be less than 4K in size.
使用browserify
使其能够使用在浏览器中,大小少于4K
API(详细实现看下面的index.js)
fromAddress(address, print, nonstd)
- try encoding an address into an IBAN 将address编码成IBANfromAsset(asset, print)
- try encoding an asset description into an IBAN 将资产描述编码成IBANtoAddress(iban)
- try decoding an IBAN into an address 把IBAN解码成一个地址toAsset(iban)
- try decoding an IBAN into an asset description 把IBAN解码成资产描述encode(address/asset)
- encode an address or asset description into an IBAN 将address或资产描述编码成IBANdecode(iban)
- decode an IBAN into an address or asset description 将IBAN 解码成address或资产描述encodeBBAN(address/asset)
- encode an address or asset description into a BBAN 将address或资产描述编码成BBANdecodeBBAN(bban)
- decode a BBAN into an address or asset description 将BBAN解码成address或资产描述isICAP(iban)
- return true if input is a valid ICAP, otherwise falseisAddress(iban)
- return true if the input is a valid ICAP with an address, otherwise falseisAsset(iban)
- return true if the input is a valid ICAP with an asset description, otherwise false
All of the above methods will throw exceptions on invalid inputs. The to*
and from*
method will also check for the expected inputs and outputs.以上所有方法都将对无效输入抛出异常。to*和from*方法还将检查预期的输入和输出
The print
parameter above, when set to true, will create an IBAN in the print format, which is space delimited groups of four characters:
上面的print参数设置为true时,将以打印格式创建一个IBAN,它是由四个字符组成的空格分隔的组
XE73 38O0 73KY GTWW ZN0F 2WZ0 R8PX 5ZPP ZS
The address
parameter only supports 0x
prefixed input and will include that in the output.
地址参数只支持0x前缀输入,并将其包含在输出中
The nonstd
parameter of fromAddress
, when set to true, will turn on support for the basic ICAP format generating an invalid IBAN, but encoding the entire 160 bits of an Ethereum address.
fromAddress的nonstd参数设置为true时,将启用对生成无效的IBAN的基本ICAP格式的支持,但将对Ethereum地址的全部160位进行编码。
代码实现:
ethereumjs-icap/index.js
var hex = require('convert-hex') // For simplicity we redefine it, as the default uses lowercase var BASE36_ALPHABET = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ' var bs36 = require('base-x')(BASE36_ALPHABET)//36进制 var ICAP = {} //decode a BBAN into an address or asset description ICAP.decodeBBAN = function (bban) { var length = bban.length if (length === 30 || length === 31) {//即BBAN的direct或basic类型 var tmp = hex.bytesToHex(bs36.decode(bban))//将其转成16进制 // FIXME: horrible padding code while (tmp.length < 40) {//如果小于40,将在前面添0 tmp = '0' + tmp } // NOTE: certain tools include an extra leading 0, drop that if ((tmp.length === 42) && (tmp[0] === '0') && (tmp[1] === '0')) {//如果刚好为42且前两个都为0,就将前两个0去掉 tmp = tmp.slice(2) } return '0x' + tmp //最后加上0x前缀,就得到的address } else if (length === 16) { //即BBAN的的indirect类型 return { //将其分成相应的三个字段,得到的是asset description asset: bban.slice(0, 3), institution: bban.slice(3, 7), client: bban.slice(7, 16) } } else { throw new Error('Not a valid Ethereum BBAN') } } //encode an address or asset description into a BBAN ICAP.encodeBBAN = function (bban) {//bban为address或asset description if (typeof bban === 'object') {//即为asset description时 if (bban.asset.length !== 3 || bban.institution.length !== 4 || bban.client.length !== 9) { throw new Error('Invalid \'indirect\' Ethereum BBAN') //先判断传进来的asset description是否正确 } return [ bban.asset, bban.institution, bban.client ].join('').toUpperCase() //正确则将他们合并在一起即可 } else if ((bban.length === 42) && (bban[0] === '0') && (bban[1] === 'x')) { //即为address时 // Workaround for base-x, see https://github.com/cryptocoinjs/base-x/issues/18 if ((bban[2] === '0') && (bban[3] === '0')) {//去掉第三、四的0 bban = '0x' + bban.slice(4) } return bs36.encode(hex.hexToBytes(bban)) //然后将其编码成36进制 } else { throw new Error('Not a valid input for Ethereum BBAN') } } // ISO13616 reordering and letter translation // NOTE: we assume input is uppercase only // based off code from iban.js function prepare (iban) { // move front to the back,将前4位移到后面,如XE00 iban = iban.slice(4) + iban.slice(0, 4) // translate letters to numbers return iban.split('').map(function (n) { var code = n.charCodeAt(0) //将字母转成对应的ASCII数字 // 65 == A, 90 == Z in ASCII if (code >= 65 && code <= 90) { // A = 10, B = 11, ... Z = 35 return code - 65 + 10 //将其转成类似16进制的数字表示形式 } else {//不是A-Z字母的就不变 return n } }).join('')//最后将这些十进制数字连在一起 } // Calculate ISO7064 mod 97-10 // NOTE: assumes all numeric input string function mod9710 (input) {//执行计算模97再减10 var m = 0 for (var i = 0; i < input.length; i++) { m *= 10 m += input.charCodeAt(i) - 48 // parseInt() m %= 97 } return m } //encode an address or asset description into an IBAN ICAP.encode = function (bban, print) { bban = ICAP.encodeBBAN(bban) //第一步,得到36进制的bban var checksum = 98 - mod9710(prepare('XE00' + bban)) //第二步:将XE00移到36进制的bban后,然后将其转成10进制,再对10进制的值计算模97再减10得到校验码 // format into 2 digits checksum = ('0' + checksum).slice(-2)//第三步:将其转成字符串形式,并只去后两位值 var iban = 'XE' + checksum + bban //第四步: 然后将他们连起来形成iban if (print === true) { //print为true,则以打印格式,即四个字符组成的空格分隔的组将iban的结果输出 // split a group of 4 chars with spaces iban = iban.replace(/(.{4})/g, '$1 ') } return iban } //decode an IBAN into an address or asset description ICAP.decode = function (iban, novalidity) { // change from 'print format' to 'electronic format', e.g. remove spaces iban = iban.replace(/\ /g, '')//第一步:首先将打印格式的空格删除并连接在一起 // check for validity if (!novalidity) {//novalidity为false即不支持无效的IBAN的格式 if (iban.slice(0, 2) !== 'XE') {//即如果不以XE开头,则报错 throw new Error('Not in ICAP format') } if (mod9710(prepare(iban)) !== 1) {//如果校验码不对,则报错 throw new Error('Invalid checksum in IBAN') } } return ICAP.decodeBBAN(iban.slice(4, 35))//然后对剩下的部分进行解码 } /* * Convert Ethereum address to ICAP * @method fromAddress * @param {String} address Address as a hex string. * @param {bool} nonstd Accept address which will result in non-standard IBAN * @returns {String} */ ICAP.fromAddress = function (address, print, nonstd) { var ret = ICAP.encode(address, print)//返回打印格式的IBAN if ((ret.replace(' ', '').length !== 34) && (nonstd !== true)) {//去掉打印格式后长度为34,且不支持无效的IBAN的格式 throw new Error('Supplied address will result in invalid an IBAN') //则说明将返回一个有效的IBAN } return ret } /* * Convert asset into ICAP * @method fromAsset * @param {Object} asset Asset object, must contain the fields asset, institution and client * @returns {String} */ ICAP.fromAsset = function (asset, print) { return ICAP.encode(asset, print) } /* * Convert an ICAP into an address * @method toAddress * @param {String} iban IBAN/ICAP, must have an address encoded * @returns {String} */ ICAP.toAddress = function (iban) { var address = ICAP.decode(iban) if (typeof address !== 'string') { throw new Error('Not an address-encoded ICAP') } return address } /* * Convert an ICAP into an asset * @method toAsset * @param {String} iban IBAN/ICAP, must have an asset encoded * @returns {Object} */ ICAP.toAsset = function (iban) { var asset = ICAP.decode(iban) if (typeof asset !== 'object') { throw new Error('Not an asset-encoded ICAP') } return asset } ICAP.isICAP = function (iban) { try { ICAP.decode(iban) return true } catch (e) { return false } } ICAP.isAddress = function (iban) { try { ICAP.toAddress(iban) return true } catch (e) { return false } } ICAP.isAsset = function (iban) { try { ICAP.toAsset(iban) return true } catch (e) { return false } } module.exports = ICAP
Examples
var ICAP = require("ethereumjs-icap") console.log( ICAP.fromAsset({ asset: 'ETH', institution: 'XREG', client: 'GAVOFYORK' }) ) // returns 'XE81ETHXREGGAVOFYORK' console.log(ICAP.fromAddress('0x00c5496aee77c1ba1f0854206a26dda82a81d6d8')) // returns 'XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS' console.log(ICAP.toAsset('XE81ETHXREGGAVOFYORK')) // returns { // asset: 'ETH', // institution: 'XREG', // client: 'GAVOFYORK' // } console.log(ICAP.toAddress('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS')) // returns '0x00c5496aee77c1ba1f0854206a26dda82a81d6d8' console.log(ICAP.decodeBBAN('38O073KYGTWWZN0F2WZ0R8PX5ZPPZS'))//direct,0x00c5496aee77c1ba1f0854206a26dda82a81d6d8 console.log(ICAP.decodeBBAN('038O073KYGTWWZN0F2WZ0R8PX5ZPPZS'))//basic,0x00c5496aee77c1ba1f0854206a26dda82a81d6d8 console.log(ICAP.decodeBBAN('ETHXREGGAVOFYORK'))//indirect,{ asset: 'ETH', institution: 'XREG', client: 'GAVOFYORK' } try{ console.log(ICAP.decodeBBAN('TOOSHORT'))//nothing,wrong: Error: Not a valid Ethereum BBAN }catch(e){ console.log(e) } console.log(ICAP.encodeBBAN('0x00c5496aee77c1ba1f0854206a26dda82a81d6d8'))//direct,38O073KYGTWWZN0F2WZ0R8PX5ZPPZS console.log(ICAP.encodeBBAN('0x42c5496aee77c1ba1f0854206a26dda82a81d6d8'))//basic,7SS84LEE90PIULMR3DYBGOVBNJN5N14 console.log( ICAP.encodeBBAN({ asset: 'ETH', institution: 'XREG', client: 'GAVOFYORK' }) )//indirect,ETHXREGGAVOFYORK try{ console.log(ICAP.encodeBBAN('0xc5496aee77c1ba1f08542'))//non-standard hex input,wrong: Error: Not a valid input for Ethereum BBAN }catch(e){ console.log(e) } console.log(ICAP.decode('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS'))//direct,0x00c5496aee77c1ba1f0854206a26dda82a81d6d8 console.log(ICAP.decode('XE73038O073KYGTWWZN0F2WZ0R8PX5ZPPZS'))//basic,0x00c5496aee77c1ba1f0854206a26dda82a81d6d8 console.log(ICAP.decode('XE81ETHXREGGAVOFYORK'))//indirect,{ asset: 'ETH', institution: 'XREG', client: 'GAVOFYORK' } console.log(ICAP.decode('XE73 38O0 73KY GTWW ZN0F 2WZ0 R8PX 5ZPP ZS'))//'direct' in print format,0x00c5496aee77c1ba1f0854206a26dda82a81d6d8 console.log(ICAP.encode('0x088f924eeceeda7fe92e1f5b0fffffffffffffff'))//direct,XE43ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ console.log(ICAP.encode('0x42c5496aee77c1ba1f0854206a26dda82a81d6d8'))//basic,XE657SS84LEE90PIULMR3DYBGOVBNJN5N14 console.log(//indirect,XE81ETHXREGGAVOFYORK ICAP.encode({ asset: 'ETH', institution: 'XREG', client: 'GAVOFYORK' }) ) try{ console.log(ICAP.encode('c5496aee77c1ba1f08542'))//non-standard hex input,wrong: Error: Not a valid input for Ethereum BBAN }catch(e){ console.log(e) } console.log(ICAP.isICAP('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS'))//true console.log(ICAP.isICAP('XE73 Invalid'))//false console.log(ICAP.isAddress('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS'))//true console.log(ICAP.isAddress('XE81ETHXREGGAVOFYORK'))//false console.log(ICAP.isAsset('XE81ETHXREGGAVOFYORK'))//true console.log(ICAP.isAsset('XE7338O073KYGTWWZN0F2WZ0R8PX5ZPPZS'))//false
Direct address generation
A direct address ICAP is an address less than 155 bits of length and therefore it safely fits into the length restrictions of IBAN (and the checksum method used). That upper limit is 0x03ffffffffffffffffffffffffffffffffffffff
or XE91GTJRJEU5043IEF993XWE21DBF0BVGF
.
直接地址ICAP是长度小于155位的地址,因此它完全符合IBAN的长度限制(以及使用的校验和方法)。最大限制是0x03ffffffffffffffffffffffffffffffffffffff
或XE91GTJRJEU5043IEF993XWE21DBF0BVGF
The following simple bruteforce code can be used to generate such addresses:
使用蛮力方法生成address
const ethUtil = require('ethereumjs-util') function generateDirectAddress () { while(true) { var privateKey = crypto.randomBytes(32) // or your favourite other random method if (ethUtil.privateToAddress(privateKey)[0] <= 3) { return privateKey } } }
Alternatively ethereumjs-wallet
can be used to generate compatible addresses.
另外,可以使用ethereumjs-wallet生成兼容的地址