ethers.js/packages/bytes/lib/index.js

427 lines
14 KiB
JavaScript
Raw Permalink Normal View History

2019-05-14 18:48:48 -04:00
"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
2021-03-07 18:24:04 -05:00
exports.joinSignature = exports.splitSignature = exports.hexZeroPad = exports.hexStripZeros = exports.hexValue = exports.hexConcat = exports.hexDataSlice = exports.hexDataLength = exports.hexlify = exports.isHexString = exports.zeroPad = exports.stripZeros = exports.concat = exports.arrayify = exports.isBytes = exports.isBytesLike = void 0;
2019-08-02 02:10:58 -04:00
var logger_1 = require("@ethersproject/logger");
var _version_1 = require("./_version");
var logger = new logger_1.Logger(_version_1.version);
2019-05-14 18:48:48 -04:00
///////////////////////////////
function isHexable(value) {
return !!(value.toHexString);
}
function addSlice(array) {
if (array.slice) {
return array;
}
array.slice = function () {
var args = Array.prototype.slice.call(arguments);
return addSlice(new Uint8Array(Array.prototype.slice.apply(array, args)));
};
return array;
}
function isBytesLike(value) {
return ((isHexString(value) && !(value.length % 2)) || isBytes(value));
}
exports.isBytesLike = isBytesLike;
2021-10-16 02:29:27 -04:00
function isInteger(value) {
return (typeof (value) === "number" && value == value && (value % 1) === 0);
}
2019-05-14 18:48:48 -04:00
function isBytes(value) {
if (value == null) {
return false;
}
if (value.constructor === Uint8Array) {
return true;
}
if (typeof (value) === "string") {
return false;
}
2021-10-16 02:29:27 -04:00
if (!isInteger(value.length) || value.length < 0) {
2019-05-14 18:48:48 -04:00
return false;
}
for (var i = 0; i < value.length; i++) {
var v = value[i];
2021-10-16 02:29:27 -04:00
if (!isInteger(v) || v < 0 || v >= 256) {
2019-05-14 18:48:48 -04:00
return false;
}
}
return true;
}
exports.isBytes = isBytes;
function arrayify(value, options) {
if (!options) {
options = {};
}
if (typeof (value) === "number") {
2019-08-02 02:10:58 -04:00
logger.checkSafeUint53(value, "invalid arrayify value");
2019-05-14 18:48:48 -04:00
var result = [];
while (value) {
result.unshift(value & 0xff);
2020-03-21 12:48:22 -04:00
value = parseInt(String(value / 256));
2019-05-14 18:48:48 -04:00
}
if (result.length === 0) {
result.push(0);
}
return addSlice(new Uint8Array(result));
}
if (options.allowMissingPrefix && typeof (value) === "string" && value.substring(0, 2) !== "0x") {
value = "0x" + value;
}
if (isHexable(value)) {
value = value.toHexString();
}
if (isHexString(value)) {
var hex = value.substring(2);
2019-09-28 02:36:19 -04:00
if (hex.length % 2) {
if (options.hexPad === "left") {
2022-03-25 17:56:35 -04:00
hex = "0" + hex;
2019-09-28 02:36:19 -04:00
}
else if (options.hexPad === "right") {
hex += "0";
}
else {
logger.throwArgumentError("hex data is odd-length", "value", value);
}
2019-05-14 18:48:48 -04:00
}
var result = [];
for (var i = 0; i < hex.length; i += 2) {
result.push(parseInt(hex.substring(i, i + 2), 16));
}
return addSlice(new Uint8Array(result));
}
if (isBytes(value)) {
return addSlice(new Uint8Array(value));
}
2019-08-02 02:10:58 -04:00
return logger.throwArgumentError("invalid arrayify value", "value", value);
2019-05-14 18:48:48 -04:00
}
exports.arrayify = arrayify;
function concat(items) {
var objects = items.map(function (item) { return arrayify(item); });
var length = objects.reduce(function (accum, item) { return (accum + item.length); }, 0);
var result = new Uint8Array(length);
objects.reduce(function (offset, object) {
result.set(object, offset);
return offset + object.length;
}, 0);
return addSlice(result);
}
exports.concat = concat;
function stripZeros(value) {
var result = arrayify(value);
if (result.length === 0) {
return result;
}
// Find the first non-zero entry
var start = 0;
while (start < result.length && result[start] === 0) {
start++;
}
// If we started with zeros, strip them
if (start) {
result = result.slice(start);
}
return result;
}
exports.stripZeros = stripZeros;
function zeroPad(value, length) {
value = arrayify(value);
if (value.length > length) {
2019-08-02 02:10:58 -04:00
logger.throwArgumentError("value out of range", "value", arguments[0]);
2019-05-14 18:48:48 -04:00
}
var result = new Uint8Array(length);
result.set(value, length - value.length);
return addSlice(result);
}
exports.zeroPad = zeroPad;
function isHexString(value, length) {
if (typeof (value) !== "string" || !value.match(/^0x[0-9A-Fa-f]*$/)) {
return false;
}
if (length && value.length !== 2 + 2 * length) {
return false;
}
return true;
}
exports.isHexString = isHexString;
var HexCharacters = "0123456789abcdef";
function hexlify(value, options) {
if (!options) {
options = {};
}
if (typeof (value) === "number") {
2019-08-02 02:10:58 -04:00
logger.checkSafeUint53(value, "invalid hexlify value");
2019-05-14 18:48:48 -04:00
var hex = "";
while (value) {
2021-05-17 16:19:36 -04:00
hex = HexCharacters[value & 0xf] + hex;
2019-05-14 18:48:48 -04:00
value = Math.floor(value / 16);
}
if (hex.length) {
if (hex.length % 2) {
hex = "0" + hex;
}
return "0x" + hex;
}
return "0x00";
}
2021-05-17 16:19:36 -04:00
if (typeof (value) === "bigint") {
value = value.toString(16);
if (value.length % 2) {
return ("0x0" + value);
}
return "0x" + value;
}
2019-05-14 18:48:48 -04:00
if (options.allowMissingPrefix && typeof (value) === "string" && value.substring(0, 2) !== "0x") {
value = "0x" + value;
}
if (isHexable(value)) {
return value.toHexString();
}
if (isHexString(value)) {
2019-09-28 02:36:19 -04:00
if (value.length % 2) {
if (options.hexPad === "left") {
value = "0x0" + value.substring(2);
}
else if (options.hexPad === "right") {
value += "0";
}
else {
logger.throwArgumentError("hex data is odd-length", "value", value);
}
2019-05-14 18:48:48 -04:00
}
return value.toLowerCase();
}
if (isBytes(value)) {
var result = "0x";
for (var i = 0; i < value.length; i++) {
var v = value[i];
result += HexCharacters[(v & 0xf0) >> 4] + HexCharacters[v & 0x0f];
}
return result;
}
2019-08-02 02:10:58 -04:00
return logger.throwArgumentError("invalid hexlify value", "value", value);
2019-05-14 18:48:48 -04:00
}
exports.hexlify = hexlify;
/*
function unoddify(value: BytesLike | Hexable | number): BytesLike | Hexable | number {
if (typeof(value) === "string" && value.length % 2 && value.substring(0, 2) === "0x") {
return "0x0" + value.substring(2);
}
return value;
}
*/
function hexDataLength(data) {
if (typeof (data) !== "string") {
data = hexlify(data);
}
else if (!isHexString(data) || (data.length % 2)) {
return null;
}
return (data.length - 2) / 2;
}
exports.hexDataLength = hexDataLength;
function hexDataSlice(data, offset, endOffset) {
if (typeof (data) !== "string") {
data = hexlify(data);
}
else if (!isHexString(data) || (data.length % 2)) {
2019-08-02 02:10:58 -04:00
logger.throwArgumentError("invalid hexData", "value", data);
2019-05-14 18:48:48 -04:00
}
offset = 2 + 2 * offset;
if (endOffset != null) {
return "0x" + data.substring(offset, 2 + 2 * endOffset);
}
return "0x" + data.substring(offset);
}
exports.hexDataSlice = hexDataSlice;
function hexConcat(items) {
var result = "0x";
items.forEach(function (item) {
result += hexlify(item).substring(2);
});
return result;
}
exports.hexConcat = hexConcat;
function hexValue(value) {
2019-09-28 02:36:19 -04:00
var trimmed = hexStripZeros(hexlify(value, { hexPad: "left" }));
2019-05-14 18:48:48 -04:00
if (trimmed === "0x") {
return "0x0";
}
return trimmed;
}
exports.hexValue = hexValue;
function hexStripZeros(value) {
if (typeof (value) !== "string") {
value = hexlify(value);
}
if (!isHexString(value)) {
2019-08-02 02:10:58 -04:00
logger.throwArgumentError("invalid hex string", "value", value);
2019-05-14 18:48:48 -04:00
}
value = value.substring(2);
var offset = 0;
while (offset < value.length && value[offset] === "0") {
offset++;
}
return "0x" + value.substring(offset);
}
exports.hexStripZeros = hexStripZeros;
function hexZeroPad(value, length) {
if (typeof (value) !== "string") {
value = hexlify(value);
}
else if (!isHexString(value)) {
2019-08-02 02:10:58 -04:00
logger.throwArgumentError("invalid hex string", "value", value);
2019-05-14 18:48:48 -04:00
}
if (value.length > 2 * length + 2) {
2019-08-02 02:10:58 -04:00
logger.throwArgumentError("value out of range", "value", arguments[1]);
2019-05-14 18:48:48 -04:00
}
while (value.length < 2 * length + 2) {
value = "0x0" + value.substring(2);
}
return value;
}
exports.hexZeroPad = hexZeroPad;
function splitSignature(signature) {
var result = {
r: "0x",
s: "0x",
_vs: "0x",
recoveryParam: 0,
2022-03-09 02:56:08 -05:00
v: 0,
yParityAndS: "0x",
compact: "0x"
2019-05-14 18:48:48 -04:00
};
if (isBytesLike(signature)) {
var bytes = arrayify(signature);
2020-01-11 04:18:28 -05:00
// Get the r, s and v
2022-03-09 02:56:08 -05:00
if (bytes.length === 64) {
// EIP-2098; pull the v from the top bit of s and clear it
result.v = 27 + (bytes[32] >> 7);
bytes[32] &= 0x7f;
result.r = hexlify(bytes.slice(0, 32));
result.s = hexlify(bytes.slice(32, 64));
}
else if (bytes.length === 65) {
result.r = hexlify(bytes.slice(0, 32));
result.s = hexlify(bytes.slice(32, 64));
result.v = bytes[64];
}
else {
logger.throwArgumentError("invalid signature string", "signature", signature);
}
2020-01-11 04:18:28 -05:00
// Allow a recid to be used as the v
if (result.v < 27) {
if (result.v === 0 || result.v === 1) {
result.v += 27;
}
else {
logger.throwArgumentError("signature invalid v byte", "signature", signature);
}
}
2020-07-07 23:19:00 -04:00
// Compute recoveryParam from v
result.recoveryParam = 1 - (result.v % 2);
2019-05-14 18:48:48 -04:00
// Compute _vs from recoveryParam and s
if (result.recoveryParam) {
bytes[32] |= 0x80;
}
result._vs = hexlify(bytes.slice(32, 64));
}
else {
result.r = signature.r;
result.s = signature.s;
result.v = signature.v;
result.recoveryParam = signature.recoveryParam;
result._vs = signature._vs;
// If the _vs is available, use it to populate missing s, v and recoveryParam
// and verify non-missing s, v and recoveryParam
if (result._vs != null) {
2020-01-11 04:18:28 -05:00
var vs_1 = zeroPad(arrayify(result._vs), 32);
result._vs = hexlify(vs_1);
// Set or check the recid
var recoveryParam = ((vs_1[0] >= 128) ? 1 : 0);
if (result.recoveryParam == null) {
result.recoveryParam = recoveryParam;
2019-05-14 18:48:48 -04:00
}
2020-01-11 04:18:28 -05:00
else if (result.recoveryParam !== recoveryParam) {
logger.throwArgumentError("signature recoveryParam mismatch _vs", "signature", signature);
}
// Set or check the s
vs_1[0] &= 0x7f;
var s = hexlify(vs_1);
2019-05-14 18:48:48 -04:00
if (result.s == null) {
result.s = s;
}
else if (result.s !== s) {
2019-08-02 02:10:58 -04:00
logger.throwArgumentError("signature v mismatch _vs", "signature", signature);
2019-05-14 18:48:48 -04:00
}
2020-01-11 04:18:28 -05:00
}
// Use recid and v to populate each other
if (result.recoveryParam == null) {
2019-05-14 18:48:48 -04:00
if (result.v == null) {
2020-01-11 04:18:28 -05:00
logger.throwArgumentError("signature missing v and recoveryParam", "signature", signature);
2019-05-14 18:48:48 -04:00
}
2021-03-30 15:22:45 -04:00
else if (result.v === 0 || result.v === 1) {
result.recoveryParam = result.v;
}
2020-01-11 04:18:28 -05:00
else {
result.recoveryParam = 1 - (result.v % 2);
2019-05-14 18:48:48 -04:00
}
2020-01-11 04:18:28 -05:00
}
else {
if (result.v == null) {
result.v = 27 + result.recoveryParam;
2019-05-14 18:48:48 -04:00
}
2021-10-17 23:03:30 -04:00
else {
var recId = (result.v === 0 || result.v === 1) ? result.v : (1 - (result.v % 2));
if (result.recoveryParam !== recId) {
logger.throwArgumentError("signature recoveryParam mismatch v", "signature", signature);
}
2019-05-14 18:48:48 -04:00
}
}
2020-01-11 04:18:28 -05:00
if (result.r == null || !isHexString(result.r)) {
logger.throwArgumentError("signature missing or invalid r", "signature", signature);
2019-05-14 18:48:48 -04:00
}
2020-01-11 04:18:28 -05:00
else {
result.r = hexZeroPad(result.r, 32);
2019-05-14 18:48:48 -04:00
}
2020-01-11 04:18:28 -05:00
if (result.s == null || !isHexString(result.s)) {
logger.throwArgumentError("signature missing or invalid s", "signature", signature);
2019-05-14 18:48:48 -04:00
}
2020-01-11 04:18:28 -05:00
else {
result.s = hexZeroPad(result.s, 32);
}
var vs = arrayify(result.s);
if (vs[0] >= 128) {
logger.throwArgumentError("signature s out of range", "signature", signature);
}
if (result.recoveryParam) {
vs[0] |= 0x80;
}
var _vs = hexlify(vs);
if (result._vs) {
if (!isHexString(result._vs)) {
logger.throwArgumentError("signature invalid _vs", "signature", signature);
2019-05-14 18:48:48 -04:00
}
2020-01-11 04:18:28 -05:00
result._vs = hexZeroPad(result._vs, 32);
}
// Set or check the _vs
if (result._vs == null) {
result._vs = _vs;
}
else if (result._vs !== _vs) {
logger.throwArgumentError("signature _vs mismatch v and s", "signature", signature);
2019-05-14 18:48:48 -04:00
}
}
2022-03-09 02:56:08 -05:00
result.yParityAndS = result._vs;
result.compact = result.r + result.yParityAndS.substring(2);
2019-05-14 18:48:48 -04:00
return result;
}
exports.splitSignature = splitSignature;
function joinSignature(signature) {
signature = splitSignature(signature);
return hexlify(concat([
signature.r,
signature.s,
(signature.recoveryParam ? "0x1c" : "0x1b")
]));
}
exports.joinSignature = joinSignature;
2020-07-13 08:03:56 -04:00
//# sourceMappingURL=index.js.map