circom/src/utils.js
src/utils.jsRaw
1const fnv = require("fnv-plus");
2const bigInt = require("big-integer");
3
4module.exports.ident =ident;
5
6module.exports.extractSizes =extractSizes;
7module.exports.flatArray = flatArray;
8module.exports.csArr = csArr;
9module.exports.subArray = subArray;
10module.exports.accSizes = accSizes;
11module.exports.fnvHash = fnvHash;
12module.exports.stringifyBigInts = stringifyBigInts;
13module.exports.unstringifyBigInts = unstringifyBigInts;
14module.exports.sameSizes = sameSizes;
15module.exports.isDefined = isDefined;
16
17function ident(text) {
18 let lines = text.split("\n");
19 for (let i=0; i<lines.length; i++) {
20 if (lines[i]) lines[i] = " "+lines[i];
21 }
22 return lines.join("\n");
23}
24
25function extractSizes (o) {
26 if (! Array.isArray(o)) return [];
27 return [o.length, ...extractSizes(o[0])];
28}
29
30function flatArray(a) {
31 var res = [];
32 fillArray(res, a);
33 return res;
34
35 function fillArray(res, a) {
36 if (Array.isArray(a)) {
37 for (let i=0; i<a.length; i++) {
38 fillArray(res, a[i]);
39 }
40 } else {
41 res.push(a);
42 }
43 }
44}
45
46// Input [1,2,3]
47// Returns " ,1 ,2, 3"
48function csArr(_arr) {
49 let S = "";
50 const arr = _arr || [];
51 for (let i=0; i<arr.length; i++) {
52 S = " ,"+arr[i];
53 }
54 return S;
55}
56
57function subArray(value, sels) {
58 if ((!sels) || (sels.length == 0)) return value;
59
60 return subArray(value[sels[0]], sels.slice(1));
61}
62
63function accSizes(_sizes) {
64 const sizes = _sizes || [];
65 const accSizes = [1, 0];
66 for (let i=sizes.length-1; i>=0; i--) {
67 accSizes.unshift(accSizes[0]*sizes[i]);
68 }
69 return accSizes;
70}
71
72function fnvHash(str) {
73 return fnv.hash(str, 64).hex();
74}
75
76
77
78function stringifyBigInts(o) {
79 if ((typeof(o) == "bigint") || o.isZero !== undefined) {
80 return o.toString(10);
81 } else if (Array.isArray(o)) {
82 return o.map(stringifyBigInts);
83 } else if (typeof o == "object") {
84 const res = {};
85 for (let k in o) {
86 res[k] = stringifyBigInts(o[k]);
87 }
88 return res;
89 } else {
90 return o;
91 }
92}
93
94function unstringifyBigInts(o) {
95 if ((typeof(o) == "string") && (/^[0-9]+$/.test(o) )) {
96 return bigInt(o);
97 } else if (Array.isArray(o)) {
98 return o.map(unstringifyBigInts);
99 } else if (typeof o == "object") {
100 const res = {};
101 for (let k in o) {
102 res[k] = unstringifyBigInts(o[k]);
103 }
104 return res;
105 } else {
106 return o;
107 }
108}
109
110function sameSizes(s1, s2) {
111 if (!Array.isArray(s1)) return false;
112 if (!Array.isArray(s2)) return false;
113 if (s1.length != s2.length) return false;
114 for (let i=0; i<s1.length; i++) {
115 if (s1[i] != s2[i]) return false;
116 }
117 return true;
118}
119
120function isDefined(v) {
121 return ((typeof(v) != "undefined")&&(v != null));
122}
123
124
125