'use strict'; import assert from 'assert'; import { ethers } from "ethers"; import { loadTests } from "@ethersproject/testcases"; import * as utils from './utils'; function equals(a, b) { if (Array.isArray(a)) { if (!Array.isArray(b) || a.length !== b.length) { return false; } for (let i = 0; i < a.length; i++) { if (!equals(a[i], b[i])) { return false; } } return true; } return a === b; } describe('Test Contract Address Generation', function () { // @TODO: Mine a large collection of these from the blockchain let getContractAddress = ethers.utils.getContractAddress; let Tests = [ // Transaction: 0x939aa17985bc2a52a0c1cba9497ef09e092355a805a8150e30e24b753bac6864 { address: '0x3474627D4F63A678266BC17171D87f8570936622', name: 'tx-0x939aa179 (number)', tx: { from: '0xb2682160c482eb985ec9f3e364eec0a904c44c23', nonce: 10, } }, { address: '0x3474627D4F63A678266BC17171D87f8570936622', name: 'tx-0x939aa179 (odd-zero-hex)', tx: { from: '0xb2682160c482eb985ec9f3e364eec0a904c44c23', nonce: "0xa", } }, { address: '0x3474627D4F63A678266BC17171D87f8570936622', name: 'tx-0x939aa179 (even-zero-hex)', tx: { from: '0xb2682160c482eb985ec9f3e364eec0a904c44c23', nonce: "0x0a", } }, // Ropsten: https://etherscan.io/tx/0x78d17f8ab31fb6ad688340634a9a29d8726feb6d588338a9b9b21a44159bc916 { address: '0x271300790813f82638A8A6A8a86d65df6dF33c17', name: 'tx-0x78d17f8a (odd-long-hex)', tx: { from: '0x8ba1f109551bd432803012645ac136ddd64dba72', nonce: "0x200", } }, { address: '0x271300790813f82638A8A6A8a86d65df6dF33c17', name: 'tx-0x78d17f8a (even-long-hex)', tx: { from: '0x8ba1f109551bd432803012645ac136ddd64dba72', nonce: "0x0200", } }, // https://ropsten.etherscan.io/tx/0x444ea8ae9890ac0ee5fd249512726abf9d23f44a378d5f45f727b65dc1b899c2 { address: '0x995C25706C407a1F1E84b3777775e3e619764933', name: 'tx-0x444ea8ae (even-long-hex)', tx: { from: '0x8ba1f109551bd432803012645ac136ddd64dba72', nonce: "0x1d", } }, { address: '0x995C25706C407a1F1E84b3777775e3e619764933', name: 'tx-0x444ea8ae (padded-long-hex)', tx: { from: '0x8ba1f109551bd432803012645ac136ddd64dba72', nonce: "0x001d", } }, { address: '0x995C25706C407a1F1E84b3777775e3e619764933', name: 'tx-0x444ea8ae (number)', tx: { from: '0x8ba1f109551bd432803012645ac136ddd64dba72', nonce: 29, } }, // Ropsten: 0x5bdfd14fcc917abc2f02a30721d152a6f147f09e8cbaad4e0d5405d646c5c3e1 { address: '0x0CcCC7507aEDf9FEaF8C8D731421746e16b4d39D', name: 'zero-nonce', tx: { from: '0xc6af6e1a78a6752c7f8cd63877eb789a2adb776c', nonce: 0 } }, ]; Tests.forEach(function (test) { it(('Computes the transaction address - ' + test.name), function () { this.timeout(120000); assert.equal(getContractAddress(test.tx), test.address, 'computes the transaction address'); }); }); }); describe('Test RLP Coder', function () { const tests = loadTests('rlp-coder'); tests.forEach(function (test) { it(('RLP coder encoded - ' + test.name), function () { this.timeout(120000); assert.equal(ethers.utils.RLP.encode(test.decoded), test.encoded, 'RLP encoded - ' + test.name); }); }); tests.forEach((test) => { it(('RLP coder decoded - ' + test.name), function () { this.timeout(120000); assert.ok(equals(ethers.utils.RLP.decode(test.encoded), test.decoded), 'RLP decoded - ' + test.name); }); }); }); describe('Test Unit Conversion', function () { const tests = loadTests('units'); tests.forEach((test) => { let wei = ethers.BigNumber.from(test.wei); it(('parses ' + test.ether + ' ether'), function () { assert.ok(ethers.utils.parseEther(test.ether.replace(/,/g, '')).eq(wei), 'parsing ether failed - ' + test.name); }); it(('formats ' + wei.toString() + ' wei to ether'), function () { let actual = ethers.utils.formatEther(wei); assert.equal(actual, test.ether_format, 'formatting wei failed - ' + test.name); }); }); tests.forEach((test) => { let wei = ethers.BigNumber.from(test.wei); ['kwei', 'mwei', 'gwei', 'szabo', 'finney', 'satoshi'].forEach((name) => { let unitName = name; if (name === 'satoshi') { unitName = 8; } if (test[name]) { it(('parses ' + test[name] + ' ' + name), function () { this.timeout(120000); assert.ok(ethers.utils.parseUnits(test[name].replace(/,/g, ''), unitName).eq(wei), ('parsing ' + name + ' failed - ' + test.name)); }); } let expectedKey = (name + '_format'); if (test[expectedKey]) { it(('formats ' + wei.toString() + ' wei to ' + name + ')'), function () { let actual = ethers.utils.formatUnits(wei, unitName); let expected = test[expectedKey]; assert.equal(actual, expected, ('formats ' + name + ' - ' + test.name)); }); } }); }); }); describe('Test Namehash', function () { const tests = loadTests('namehash'); tests.forEach((test) => { it(('computes namehash - "' + test.name + '"'), function () { this.timeout(120000); assert.equal(ethers.utils.namehash(test.name), test.expected, 'computes namehash(' + test.name + ')'); }); }); }); describe('Test ID Hash Functione', function () { const tests = [ { name: 'setAddr signature hash', text: 'setAddr(bytes32,address)', expected: '0xd5fa2b00b0756613052388dd576d941ba16904757996b8bb03a737ef4fd1f9ce' } ]; tests.forEach((test) => { it(('computes id - ' + test.name), function () { this.timeout(120000); let actual = ethers.utils.id(test.text); assert.equal(actual, test.expected, 'computes id(' + test.text + ')'); }); }); }); describe('Test Solidity Hash Functions', function () { const tests = loadTests('solidity-hashes'); function test(funcName, testKey) { it(('computes ' + funcName + ' correctly'), function () { this.timeout(120000); tests.forEach((test, index) => { let actual = (ethers.utils)['solidity' + funcName](test.types, test.values); let expected = test[testKey]; assert.equal(actual, expected, ('computes solidity-' + funcName + '(' + JSON.stringify(test.values) + ') - ' + test.types)); }); }); } test('Keccak256', 'keccak256'); test('Sha256', 'sha256'); }); describe('Test Hash Functions', function () { const tests = loadTests('hashes'); it('computes keccak256 correctly', function () { this.timeout(120000); tests.forEach(function (test) { assert.equal(ethers.utils.keccak256(test.data), test.keccak256, ('Keccak256 - ' + test.data)); }); }); it('computes sha2566 correctly', function () { this.timeout(120000); tests.forEach(function (test) { assert.equal(ethers.utils.sha256(test.data), test.sha256, ('SHA256 - ' + test.data)); }); }); }); describe('Test Solidity splitSignature', function () { it('splits a canonical signature', function () { this.timeout(120000); let r = '0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef'; let s = '0xcafe1a7ecafe1a7ecafe1a7ecafe1a7ecafe1a7ecafe1a7ecafe1a7ecafe1a7e'; for (let v = 27; v <= 28; v++) { let signature = ethers.utils.concat([r, s, [v]]); let sig = ethers.utils.splitSignature(signature); assert.equal(sig.r, r, 'split r correctly'); assert.equal(sig.s, s, 'split s correctly'); assert.equal(sig.v, v, 'split v correctly'); } }); it('splits a legacy signature', function () { this.timeout(120000); let r = '0xdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeefdeadbeef'; let s = '0xcafe1a7ecafe1a7ecafe1a7ecafe1a7ecafe1a7ecafe1a7ecafe1a7ecafe1a7e'; for (let v = 27; v <= 28; v++) { let signature = ethers.utils.concat([r, s, [v - 27]]); let sig = ethers.utils.splitSignature(signature); assert.equal(sig.r, r, 'split r correctly'); assert.equal(sig.s, s, 'split s correctly'); assert.equal(sig.v, v, 'split v correctly'); } }); }); describe('Test Base64 coder', function () { // https://en.wikipedia.org/wiki/Base64#Examples it('encodes and decodes the example from wikipedia', function () { this.timeout(120000); let decodedText = 'Man is distinguished, not only by his reason, but by this singular passion from other animals, which is a lust of the mind, that by a perseverance of delight in the continued and indefatigable generation of knowledge, exceeds the short vehemence of any carnal pleasure.'; let decoded = ethers.utils.toUtf8Bytes(decodedText); let encoded = 'TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb24sIGJ1dCBieSB0aGlzIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbmltYWxzLCB3aGljaCBpcyBhIGx1c3Qgb2YgdGhlIG1pbmQsIHRoYXQgYnkgYSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY29udGludWVkIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLCBleGNlZWRzIHRoZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hbCBwbGVhc3VyZS4='; assert.equal(ethers.utils.base64.encode(decoded), encoded, 'encodes to base64 string'); assert.equal(ethers.utils.toUtf8String(ethers.utils.base64.decode(encoded)), decodedText, 'decodes from base64 sstring'); }); }); describe('Test UTF-8 coder', function () { let BadUTF = [ // See: https://en.wikipedia.org/wiki/UTF-8#Overlong_encodings { bytes: [0xF0, 0x82, 0x82, 0xAC], reason: 'overlong', name: 'wikipedia overlong encoded Euro sign' }, { bytes: [0xc0, 0x80], reason: 'overlong', name: '2-byte overlong - 0xc080' }, { bytes: [0xc0, 0xbf], reason: 'overlong', name: '2-byte overlong - 0xc0bf' }, { bytes: [0xc1, 0x80], reason: 'overlong', name: '2-byte overlong - 0xc180' }, { bytes: [0xc1, 0xbf], reason: 'overlong', name: '2-byte overlong - 0xc1bf' }, // Reserved UTF-16 Surrogate halves { bytes: [0xed, 0xa0, 0x80], reason: 'utf-16 surrogate', name: 'utf-16 surrogate - U+d800' }, { bytes: [0xed, 0xbf, 0xbf], reason: 'utf-16 surrogate', name: 'utf-16 surrogate - U+dfff' }, // a leading byte not followed by enough continuation bytes { bytes: [0xdf], reason: 'too short', name: 'too short - 2-bytes - 0x00' }, { bytes: [0xe0], reason: 'too short', name: 'too short - 3-bytes' }, { bytes: [0xe0, 0x80], reason: 'too short', name: 'too short - 3-bytes with 1' }, { bytes: [0x80], reason: 'unexpected continuation byte', name: 'unexpected continuation byte' }, { bytes: [0xc2, 0x00], reason: 'invalid continuation byte', name: 'invalid continuation byte - 0xc200' }, { bytes: [0xc2, 0x40], reason: 'invalid continuation byte', name: 'invalid continuation byte - 0xc240' }, { bytes: [0xc2, 0xc0], reason: 'invalid continuation byte', name: 'invalid continuation byte - 0xc2c0' }, // Out of range { bytes: [0xf4, 0x90, 0x80, 0x80], reason: 'out-of-range', name: 'out of range' }, ]; BadUTF.forEach(function (test) { it('toUtf8String - ' + test.name, function () { assert.throws(function () { let result = ethers.utils.toUtf8String(test.bytes); console.log('Result', result); }, function (error) { return (error.message.split(';').pop().trim() === test.reason); }, test.name); }); }); it('toUtf8String - random conversions', function () { this.timeout(200000); function randomChar(seed) { switch (utils.randomNumber(seed + '-range', 0, 4)) { case 0: return String.fromCharCode(utils.randomNumber(seed + '-value', 0, 0x100)); case 1: return String.fromCharCode(utils.randomNumber(seed + '-value', 0, 0xd800)); case 2: return String.fromCharCode(utils.randomNumber(seed + '-value', 0xdfff + 1, 0xffff)); case 3: let left = utils.randomNumber(seed + '-value', 0xd800, 0xdbff + 1); let right = utils.randomNumber(seed + '-value', 0xdc00, 0xdfff + 1); return String.fromCharCode(left, right); } throw new Error('this should not happen'); } function randomString(seed) { let length = utils.randomNumber(seed + '-length', 1, 5); let str = ''; for (let i = 0; i < length; i++) { str += randomChar(seed + '-char-' + i); } return str; } for (let i = 0; i < 100000; i++) { let seed = 'test-' + String(i); let str = randomString(seed); let bytes = ethers.utils.toUtf8Bytes(str); let str2 = ethers.utils.toUtf8String(bytes); let escaped = JSON.parse(ethers.utils._toEscapedUtf8String(bytes)); assert.ok(Buffer.from(str).equals(Buffer.from(bytes)), 'bytes not generated correctly - ' + bytes); assert.equal(str2, str, 'conversion not reflexive - ' + bytes); assert.equal(escaped, str, 'conversion not reflexive - ' + bytes); } }); }); describe('Test Bytes32String coder', function () { // @TODO: a LOT more test cases; generated from Solidity it("encodes an ens name", function () { let str = "ricmoo.firefly.eth"; let bytes32 = ethers.utils.formatBytes32String(str); let str2 = ethers.utils.parseBytes32String(bytes32); assert.equal(bytes32, '0x7269636d6f6f2e66697265666c792e6574680000000000000000000000000000', 'formatted correctly'); assert.equal(str2, str, "parsed correctly"); }); }); describe('Test BigNumber', function () { it("computes absoltue values", function () { function testAbs(test) { let value = ethers.BigNumber.from(test.value); let expected = ethers.BigNumber.from(test.expected); assert.ok(value.abs().eq(expected), 'BigNumber.abs - ' + test.value); } [ { value: "0x0", expected: "0x0" }, { value: "-0x0", expected: "0x0" }, { value: "0x5", expected: "0x5" }, { value: "-0x5", expected: "0x5" }, { value: "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff", expected: "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff" }, { value: "-0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff", expected: "0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff" }, { value: "0xfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff", expected: "0xfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff" }, { value: "-0xfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff", expected: "0xfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff" }, ].forEach(testAbs); }); }); function getHex(value) { return "0x" + Buffer.from(value).toString("hex"); } describe("Test nameprep", function () { const Tests = loadTests("nameprep"); Tests.forEach((test) => { // No RTL support yet... These will always fail if ([ "Surrogate code U+DF42", "Left-to-right mark U+200E", "Deprecated U+202A", "Language tagging character U+E0001", "Bidi: RandALCat character U+05BE and LCat characters", "Bidi: RandALCat character U+FD50 and LCat characters", "Bidi: RandALCat without trailing RandALCat U+0627 U+0031" ].indexOf(test.comment) >= 0) { return; } it(test.comment, function () { let input = ethers.utils.toUtf8String(test.input); if (test.output) { let expected = ethers.utils.toUtf8String(test.output); let actual = ethers.utils.nameprep(input); assert.equal(actual, expected, `actual("${getHex(actual)}") !== expected("${getHex(expected)}")`); } else { let ok = true; let reason = ""; try { let actual = ethers.utils.nameprep(input); console.log(actual); reason = `should has thrown ${test.rc} - actual("${getHex(actual)}")`; ok = false; } catch (error) { } assert.ok(ok, reason); } }); }); }); describe("Test Signature Manipulation", function () { const tests = loadTests("transactions"); tests.forEach((test) => { it("autofills partial signatures - " + test.name, function () { const address = ethers.utils.getAddress(test.accountAddress); const hash = ethers.utils.keccak256(test.unsignedTransaction); const data = ethers.utils.RLP.decode(test.signedTransaction); const s = data.pop(), r = data.pop(), v = parseInt(data.pop().substring(2), 16); const sig = ethers.utils.splitSignature({ r: r, s: s, v: v }); { const addr = ethers.utils.recoverAddress(hash, { r: r, s: s, v: v }); assert.equal(addr, address, "Using r, s and v"); } { const addr = ethers.utils.recoverAddress(hash, { r: sig.r, _vs: sig._vs }); assert.equal(addr, address, "Using r, _vs"); } { const addr = ethers.utils.recoverAddress(hash, { r: sig.r, s: sig.s, recoveryParam: sig.recoveryParam }); assert.equal(addr, address, "Using r, s and recoveryParam"); } }); }); });