@airgap/icp 0.13.11-beta.1 → 0.13.11-beta.11

package/v1/utils/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../../../src/v1/utils/buffer.ts"],"names":[],"mappings":"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"}

package/v1/utils/cbor.d.ts

@@ -0,0 +1,9 @@
+export declare enum CborTag {
+    Uint64LittleEndian = 71,
+    Semantic = 55799
+}
+/**
+ * Encode a JavaScript value into CBOR.
+ */
+export declare function encode(value: any): ArrayBuffer;
+export declare function decode<T>(input: ArrayBuffer): T;

package/v1/utils/cbor.js

@@ -0,0 +1,178 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decode = exports.encode = exports.CborTag = void 0;
+// tslint:disable:max-classes-per-file
+// This file is based on:
+// tslint:disable-next-line: max-line-length
+// https://github.com/dfinity-lab/dfinity/blob/9bca65f8edd65701ea6bdb00e0752f9186bbc893/docs/spec/public/index.adoc#cbor-encoding-of-requests-and-responses
+var borc_1 = require("borc");
+var cbor = __importStar(require("simple-cbor"));
+var simple_cbor_1 = require("simple-cbor");
+var buffer_1 = require("./buffer");
+// We are using hansl/simple-cbor for CBOR serialization, to avoid issues with
+// encoding the uint64 values that the HTTP handler of the client expects for
+// canister IDs. However, simple-cbor does not yet provide deserialization so
+// we are using `Uint8Array` so that we can use the dignifiedquire/borc CBOR
+// decoder.
+var PrincipalEncoder = /** @class */ (function () {
+    function PrincipalEncoder() {
+    }
+    Object.defineProperty(PrincipalEncoder.prototype, "name", {
+        get: function () {
+            return 'Principal';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(PrincipalEncoder.prototype, "priority", {
+        get: function () {
+            return 0;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    PrincipalEncoder.prototype.match = function (value) {
+        return value && value._isPrincipal === true;
+    };
+    PrincipalEncoder.prototype.encode = function (v) {
+        return cbor.value.bytes(v.toUint8Array());
+    };
+    return PrincipalEncoder;
+}());
+var BufferEncoder = /** @class */ (function () {
+    function BufferEncoder() {
+    }
+    Object.defineProperty(BufferEncoder.prototype, "name", {
+        get: function () {
+            return 'Buffer';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(BufferEncoder.prototype, "priority", {
+        get: function () {
+            return 1;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    BufferEncoder.prototype.match = function (value) {
+        return value instanceof ArrayBuffer || ArrayBuffer.isView(value);
+    };
+    BufferEncoder.prototype.encode = function (v) {
+        return cbor.value.bytes(new Uint8Array(v));
+    };
+    return BufferEncoder;
+}());
+var BigIntEncoder = /** @class */ (function () {
+    function BigIntEncoder() {
+    }
+    Object.defineProperty(BigIntEncoder.prototype, "name", {
+        get: function () {
+            return 'BigInt';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(BigIntEncoder.prototype, "priority", {
+        get: function () {
+            return 1;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    BigIntEncoder.prototype.match = function (value) {
+        return typeof value === "bigint";
+    };
+    BigIntEncoder.prototype.encode = function (v) {
+        // Always use a bigint encoding.
+        if (v > BigInt(0)) {
+            return cbor.value.tagged(2, cbor.value.bytes((0, buffer_1.fromHex)(v.toString(16))));
+        }
+        else {
+            return cbor.value.tagged(3, cbor.value.bytes((0, buffer_1.fromHex)((BigInt('-1') * v).toString(16))));
+        }
+    };
+    return BigIntEncoder;
+}());
+var serializer = simple_cbor_1.SelfDescribeCborSerializer.withDefaultEncoders(true);
+serializer.addEncoder(new PrincipalEncoder());
+serializer.addEncoder(new BufferEncoder());
+serializer.addEncoder(new BigIntEncoder());
+var CborTag;
+(function (CborTag) {
+    CborTag[CborTag["Uint64LittleEndian"] = 71] = "Uint64LittleEndian";
+    CborTag[CborTag["Semantic"] = 55799] = "Semantic";
+})(CborTag = exports.CborTag || (exports.CborTag = {}));
+/**
+ * Encode a JavaScript value into CBOR.
+ */
+function encode(value) {
+    return serializer.serialize(value);
+}
+exports.encode = encode;
+function decodePositiveBigInt(buf) {
+    var len = buf.byteLength;
+    var res = BigInt(0);
+    for (var i = 0; i < len; i++) {
+        // tslint:disable-next-line:no-bitwise
+        res = res * BigInt(0x100) + BigInt(buf[i]);
+    }
+    return res;
+}
+// A BORC subclass that decodes byte strings to ArrayBuffer instead of the Buffer class.
+// class Uint8ArrayDecoder extends Decoder {
+//   constructor(params: any) {
+//     super(params)
+//   }
+//   public createByteString(raw: ArrayBuffer[]): ArrayBuffer {
+//     return concat(...raw)
+//   }
+//   public createByteStringFromHeap(start: number, end: number): ArrayBuffer {
+//     if (start === end) {
+//       return new ArrayBuffer(0)
+//     }
+//     return new Uint8Array((this as any)._heap.slice(start, end))
+//   }
+// }
+function decode(input) {
+    var _a;
+    var buffer = new Uint8Array(input);
+    var decoder = new borc_1.Decoder({
+        size: buffer.byteLength,
+        tags: (_a = {
+                // Override tags 2 and 3 for BigInt support (borc supports only BigNumber).
+                2: function (val) { return decodePositiveBigInt(val); },
+                3: function (val) { return -decodePositiveBigInt(val); }
+            },
+            _a[CborTag.Semantic] = function (value) { return value; },
+            _a)
+    });
+    //@ts-ignore
+    return decoder.decodeFirst(buffer);
+}
+exports.decode = decode;
+//# sourceMappingURL=cbor.js.map

package/v1/utils/cbor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbor.js","sourceRoot":"","sources":["../../../src/v1/utils/cbor.ts"],"names":[],"mappings":"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"}

package/v1/utils/certificate.d.ts

@@ -0,0 +1,74 @@
+import { Principal } from './principal';
+import { AgentError } from './errors';
+/**
+ * A certificate may fail verification with respect to the provided public key
+ */
+export declare class CertificateVerificationError extends AgentError {
+    constructor(reason: string);
+}
+declare const enum NodeId {
+    Empty = 0,
+    Fork = 1,
+    Labeled = 2,
+    Leaf = 3,
+    Pruned = 4
+}
+export declare type HashTree = [NodeId.Empty] | [NodeId.Fork, HashTree, HashTree] | [NodeId.Labeled, ArrayBuffer, HashTree] | [NodeId.Leaf, ArrayBuffer] | [NodeId.Pruned, ArrayBuffer];
+/**
+ * Make a human readable string out of a hash tree.
+ * @param tree
+ */
+export declare function hashTreeToString(tree: HashTree): string;
+declare type VerifyFunc = (pk: Uint8Array, sig: Uint8Array, msg: Uint8Array) => Promise<boolean>;
+export interface CreateCertificateOptions {
+    /**
+     * The bytes encoding the certificate to be verified
+     */
+    certificate: ArrayBuffer;
+    /**
+     * The root key against which to verify the certificate
+     * (normally, the root key of the IC main network)
+     */
+    rootKey: ArrayBuffer;
+    /**
+     * The effective canister ID of the request when verifying a response, or
+     * the signing canister ID when verifying a certified variable.
+     */
+    canisterId: Principal;
+    /**
+     * BLS Verification strategy. Default strategy uses wasm for performance, but that may not be available in all contexts.
+     */
+    blsVerify?: VerifyFunc;
+}
+export declare class Certificate {
+    private _rootKey;
+    private _canisterId;
+    private _blsVerify;
+    private readonly cert;
+    /**
+     * Create a new instance of a certificate, automatically verifying it. Throws a
+     * CertificateVerificationError if the certificate cannot be verified.
+     * @constructs {@link AuthClient}
+     * @param {CreateCertificateOptions} options
+     * @see {@link CreateCertificateOptions}
+     * @param {ArrayBuffer} options.certificate The bytes of the certificate
+     * @param {ArrayBuffer} options.rootKey The root key to verify against
+     * @param {Principal} options.canisterId The effective or signing canister ID
+     * @throws {CertificateVerificationError}
+     */
+    static create(options: CreateCertificateOptions): Promise<Certificate>;
+    private constructor();
+    lookup(path: Array<ArrayBuffer | string>): ArrayBuffer | undefined;
+    private verify;
+    private _checkDelegationAndGetKey;
+}
+/**
+ * @param t
+ */
+export declare function reconstruct(t: HashTree): Promise<ArrayBuffer>;
+/**
+ * @param path
+ * @param tree
+ */
+export declare function lookup_path(path: Array<ArrayBuffer | string>, tree: HashTree): ArrayBuffer | undefined;
+export {};

package/v1/utils/certificate.js

@@ -0,0 +1,396 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookup_path = exports.reconstruct = exports.Certificate = exports.hashTreeToString = exports.CertificateVerificationError = void 0;
+var auth_1 = require("./auth");
+var buffer_1 = require("./buffer");
+var principal_1 = require("./principal");
+var cbor = __importStar(require("./cbor"));
+var bls_1 = require("./bls");
+var errors_1 = require("./errors");
+/**
+ * A certificate may fail verification with respect to the provided public key
+ */
+var CertificateVerificationError = /** @class */ (function (_super) {
+    __extends(CertificateVerificationError, _super);
+    function CertificateVerificationError(reason) {
+        return _super.call(this, "Invalid certificate: ".concat(reason)) || this;
+    }
+    return CertificateVerificationError;
+}(errors_1.AgentError));
+exports.CertificateVerificationError = CertificateVerificationError;
+/**
+ * Make a human readable string out of a hash tree.
+ * @param tree
+ */
+function hashTreeToString(tree) {
+    var indent = function (s) {
+        return s
+            .split('\n')
+            .map(function (x) { return '  ' + x; })
+            .join('\n');
+    };
+    function labelToString(label) {
+        var decoder = new TextDecoder(undefined, { fatal: true });
+        try {
+            return JSON.stringify(decoder.decode(label));
+        }
+        catch (e) {
+            return "data(...".concat(label.byteLength, " bytes)");
+        }
+    }
+    switch (tree[0]) {
+        case 0 /* NodeId.Empty */:
+            return '()';
+        case 1 /* NodeId.Fork */: {
+            var left = hashTreeToString(tree[1]);
+            var right = hashTreeToString(tree[2]);
+            return "sub(\n left:\n".concat(indent(left), "\n---\n right:\n").concat(indent(right), "\n)");
+        }
+        case 2 /* NodeId.Labeled */: {
+            var label = labelToString(tree[1]);
+            var sub = hashTreeToString(tree[2]);
+            return "label(\n label:\n".concat(indent(label), "\n sub:\n").concat(indent(sub), "\n)");
+        }
+        case 3 /* NodeId.Leaf */: {
+            return "leaf(...".concat(tree[1].byteLength, " bytes)");
+        }
+        case 4 /* NodeId.Pruned */: {
+            return "pruned(".concat((0, buffer_1.toHex)(new Uint8Array(tree[1])));
+        }
+        default: {
+            return "unknown(".concat(JSON.stringify(tree[0]), ")");
+        }
+    }
+}
+exports.hashTreeToString = hashTreeToString;
+function isBufferEqual(a, b) {
+    if (a.byteLength !== b.byteLength) {
+        return false;
+    }
+    var a8 = new Uint8Array(a);
+    var b8 = new Uint8Array(b);
+    for (var i = 0; i < a8.length; i++) {
+        if (a8[i] !== b8[i]) {
+            return false;
+        }
+    }
+    return true;
+}
+var Certificate = /** @class */ (function () {
+    function Certificate(certificate, _rootKey, _canisterId, _blsVerify) {
+        this._rootKey = _rootKey;
+        this._canisterId = _canisterId;
+        this._blsVerify = _blsVerify;
+        this.cert = cbor.decode(new Uint8Array(certificate));
+    }
+    /**
+     * Create a new instance of a certificate, automatically verifying it. Throws a
+     * CertificateVerificationError if the certificate cannot be verified.
+     * @constructs {@link AuthClient}
+     * @param {CreateCertificateOptions} options
+     * @see {@link CreateCertificateOptions}
+     * @param {ArrayBuffer} options.certificate The bytes of the certificate
+     * @param {ArrayBuffer} options.rootKey The root key to verify against
+     * @param {Principal} options.canisterId The effective or signing canister ID
+     * @throws {CertificateVerificationError}
+     */
+    Certificate.create = function (options) {
+        return __awaiter(this, void 0, void 0, function () {
+            var blsVerify, cert;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        blsVerify = options.blsVerify;
+                        if (!blsVerify) {
+                            blsVerify = bls_1.blsVerify;
+                        }
+                        cert = new Certificate(options.certificate, options.rootKey, options.canisterId, blsVerify);
+                        return [4 /*yield*/, cert.verify()];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/, cert];
+                }
+            });
+        });
+    };
+    Certificate.prototype.lookup = function (path) {
+        return lookup_path(path, this.cert.tree);
+    };
+    Certificate.prototype.verify = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var rootHash, derKey, sig, key, msg, sigVer, err_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, reconstruct(this.cert.tree)];
+                    case 1:
+                        rootHash = _a.sent();
+                        return [4 /*yield*/, this._checkDelegationAndGetKey(this.cert.delegation)];
+                    case 2:
+                        derKey = _a.sent();
+                        sig = this.cert.signature;
+                        key = extractDER(derKey);
+                        msg = (0, buffer_1.concat)(domain_sep('ic-state-root'), rootHash);
+                        sigVer = false;
+                        _a.label = 3;
+                    case 3:
+                        _a.trys.push([3, 5, , 6]);
+                        return [4 /*yield*/, this._blsVerify(new Uint8Array(key), new Uint8Array(sig), new Uint8Array(msg))];
+                    case 4:
+                        sigVer = _a.sent();
+                        return [3 /*break*/, 6];
+                    case 5:
+                        err_1 = _a.sent();
+                        sigVer = false;
+                        return [3 /*break*/, 6];
+                    case 6:
+                        if (!sigVer) {
+                            throw new CertificateVerificationError('Signature verification failed');
+                        }
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    Certificate.prototype._checkDelegationAndGetKey = function (d) {
+        return __awaiter(this, void 0, void 0, function () {
+            var cert, rangeLookup, ranges_arr, ranges, canisterInRange, publicKeyLookup;
+            var _this = this;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!d) {
+                            return [2 /*return*/, this._rootKey];
+                        }
+                        return [4 /*yield*/, Certificate.create({
+                                certificate: d.certificate,
+                                rootKey: this._rootKey,
+                                canisterId: this._canisterId
+                            })];
+                    case 1:
+                        cert = _a.sent();
+                        rangeLookup = cert.lookup(['subnet', d.subnet_id, 'canister_ranges']);
+                        if (!rangeLookup) {
+                            throw new CertificateVerificationError("Could not find canister ranges for subnet 0x".concat((0, buffer_1.toHex)(d.subnet_id)));
+                        }
+                        ranges_arr = cbor.decode(rangeLookup);
+                        ranges = ranges_arr.map(function (v) { return [principal_1.Principal.fromUint8Array(v[0]), principal_1.Principal.fromUint8Array(v[1])]; });
+                        canisterInRange = ranges.some(function (r) { return r[0].ltEq(_this._canisterId) && r[1].gtEq(_this._canisterId); });
+                        if (!canisterInRange) {
+                            throw new CertificateVerificationError("Canister ".concat(this._canisterId, " not in range of delegations for subnet 0x").concat((0, buffer_1.toHex)(d.subnet_id)));
+                        }
+                        publicKeyLookup = cert.lookup(['subnet', d.subnet_id, 'public_key']);
+                        if (!publicKeyLookup) {
+                            throw new Error("Could not find subnet key for subnet 0x".concat((0, buffer_1.toHex)(d.subnet_id)));
+                        }
+                        return [2 /*return*/, publicKeyLookup];
+                }
+            });
+        });
+    };
+    return Certificate;
+}());
+exports.Certificate = Certificate;
+var DER_PREFIX = (0, buffer_1.fromHex)('308182301d060d2b0601040182dc7c0503010201060c2b0601040182dc7c05030201036100');
+var KEY_LENGTH = 96;
+function extractDER(buf) {
+    var expectedLength = DER_PREFIX.byteLength + KEY_LENGTH;
+    if (buf.byteLength !== expectedLength) {
+        throw new TypeError("BLS DER-encoded public key must be ".concat(expectedLength, " bytes long"));
+    }
+    var prefix = buf.slice(0, DER_PREFIX.byteLength);
+    if (!isBufferEqual(prefix, DER_PREFIX)) {
+        throw new TypeError("BLS DER-encoded public key is invalid. Expect the following prefix: ".concat(DER_PREFIX, ", but get ").concat(prefix));
+    }
+    return buf.slice(DER_PREFIX.byteLength);
+}
+/**
+ * @param t
+ */
+function reconstruct(t) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _a, _b, _c, _d, _e, _f, _g;
+        return __generator(this, function (_h) {
+            switch (_h.label) {
+                case 0:
+                    _a = t[0];
+                    switch (_a) {
+                        case 0 /* NodeId.Empty */: return [3 /*break*/, 1];
+                        case 4 /* NodeId.Pruned */: return [3 /*break*/, 2];
+                        case 3 /* NodeId.Leaf */: return [3 /*break*/, 3];
+                        case 2 /* NodeId.Labeled */: return [3 /*break*/, 4];
+                        case 1 /* NodeId.Fork */: return [3 /*break*/, 6];
+                    }
+                    return [3 /*break*/, 9];
+                case 1: return [2 /*return*/, (0, auth_1.hash)(domain_sep('ic-hashtree-empty'))];
+                case 2: return [2 /*return*/, t[1]];
+                case 3: return [2 /*return*/, (0, auth_1.hash)((0, buffer_1.concat)(domain_sep('ic-hashtree-leaf'), t[1]))];
+                case 4:
+                    _b = auth_1.hash;
+                    _c = buffer_1.concat;
+                    _d = [domain_sep('ic-hashtree-labeled'), t[1]];
+                    return [4 /*yield*/, reconstruct(t[2])];
+                case 5: return [2 /*return*/, _b.apply(void 0, [_c.apply(void 0, _d.concat([_h.sent()]))])];
+                case 6:
+                    _e = auth_1.hash;
+                    _f = buffer_1.concat;
+                    _g = [domain_sep('ic-hashtree-fork')];
+                    return [4 /*yield*/, reconstruct(t[1])];
+                case 7:
+                    _g = _g.concat([_h.sent()]);
+                    return [4 /*yield*/, reconstruct(t[2])];
+                case 8: return [2 /*return*/, _e.apply(void 0, [_f.apply(void 0, _g.concat([_h.sent()]))])];
+                case 9: throw new Error('unreachable');
+            }
+        });
+    });
+}
+exports.reconstruct = reconstruct;
+function domain_sep(s) {
+    var len = new Uint8Array([s.length]);
+    var str = new TextEncoder().encode(s);
+    return (0, buffer_1.concat)(len, str);
+}
+/**
+ * @param path
+ * @param tree
+ */
+function lookup_path(path, tree) {
+    if (path.length === 0) {
+        switch (tree[0]) {
+            case 3 /* NodeId.Leaf */: {
+                return new Uint8Array(tree[1]).buffer;
+            }
+            default: {
+                return undefined;
+            }
+        }
+    }
+    var label = typeof path[0] === 'string' ? new TextEncoder().encode(path[0]) : path[0];
+    var t = find_label(label, flatten_forks(tree));
+    if (t) {
+        return lookup_path(path.slice(1), t);
+    }
+    return undefined;
+}
+exports.lookup_path = lookup_path;
+function flatten_forks(t) {
+    switch (t[0]) {
+        case 0 /* NodeId.Empty */:
+            return [];
+        case 1 /* NodeId.Fork */:
+            return flatten_forks(t[1]).concat(flatten_forks(t[2]));
+        default:
+            return [t];
+    }
+}
+function find_label(l, trees) {
+    var e_1, _a;
+    if (trees.length === 0) {
+        return undefined;
+    }
+    try {
+        for (var trees_1 = __values(trees), trees_1_1 = trees_1.next(); !trees_1_1.done; trees_1_1 = trees_1.next()) {
+            var t = trees_1_1.value;
+            if (t[0] === 2 /* NodeId.Labeled */) {
+                var p = t[1];
+                if (isBufferEqual(l, p)) {
+                    return t[2];
+                }
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (trees_1_1 && !trees_1_1.done && (_a = trees_1.return)) _a.call(trees_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return undefined;
+}
+//# sourceMappingURL=certificate.js.map