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

package/v1/utils/actor.js

@@ -0,0 +1,458 @@
+"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 __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+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 __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+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.");
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Actor = exports.CanisterInstallMode = exports.UpdateCallRejectedError = exports.QueryCallRejectedError = exports.ActorCallError = exports.getManagementCanister = exports.getDefaultAgent = void 0;
+var buffer_1 = require("buffer/");
+var buffer_2 = require("./buffer");
+var http_1 = require("./http");
+var principal_1 = require("./principal");
+var IDL = __importStar(require("./idl"));
+var polling_1 = require("./polling");
+var management_idl_1 = __importDefault(require("../types/management_idl"));
+var errors_1 = require("./errors");
+function getDefaultAgent() {
+    var agent = typeof window === 'undefined'
+        ? typeof global === 'undefined'
+            ? typeof self === 'undefined'
+                ? undefined
+                : self.ic.agent
+            : global.ic.agent
+        : window.ic.agent;
+    if (!agent) {
+        throw new Error('No Agent could be found.');
+    }
+    return agent;
+}
+exports.getDefaultAgent = getDefaultAgent;
+function getManagementCanister(config) {
+    function transform(_methodName, args, _callConfig) {
+        var first = args[0];
+        var effectiveCanisterId = principal_1.Principal.fromHex('');
+        if (first && typeof first === 'object' && first.canister_id) {
+            effectiveCanisterId = principal_1.Principal.from(first.canister_id);
+        }
+        return { effectiveCanisterId: effectiveCanisterId };
+    }
+    return Actor.createActor(management_idl_1.default, __assign(__assign(__assign({}, config), { canisterId: principal_1.Principal.fromHex('') }), {
+        callTransform: transform,
+        queryTransform: transform
+    }));
+}
+exports.getManagementCanister = getManagementCanister;
+var ActorCallError = /** @class */ (function (_super) {
+    __extends(ActorCallError, _super);
+    function ActorCallError(canisterId, methodName, type, props) {
+        var _this = _super.call(this, __spreadArray([
+            "Call failed:",
+            "  Canister: ".concat(canisterId.toText()),
+            "  Method: ".concat(methodName, " (").concat(type, ")")
+        ], __read(Object.getOwnPropertyNames(props).map(function (n) { return "  \"".concat(n, "\": ").concat(JSON.stringify(props[n])); })), false).join('\n')) || this;
+        _this.canisterId = canisterId;
+        _this.methodName = methodName;
+        _this.type = type;
+        _this.props = props;
+        return _this;
+    }
+    return ActorCallError;
+}(errors_1.AgentError));
+exports.ActorCallError = ActorCallError;
+var QueryCallRejectedError = /** @class */ (function (_super) {
+    __extends(QueryCallRejectedError, _super);
+    function QueryCallRejectedError(canisterId, methodName, result) {
+        var _this = this;
+        var _a;
+        _this = _super.call(this, canisterId, methodName, 'query', {
+            Status: result.status,
+            Code: (_a = http_1.ReplicaRejectCode[result.reject_code]) !== null && _a !== void 0 ? _a : "Unknown Code \"".concat(result.reject_code, "\""),
+            Message: result.reject_message
+        }) || this;
+        _this.result = result;
+        return _this;
+    }
+    return QueryCallRejectedError;
+}(ActorCallError));
+exports.QueryCallRejectedError = QueryCallRejectedError;
+var UpdateCallRejectedError = /** @class */ (function (_super) {
+    __extends(UpdateCallRejectedError, _super);
+    function UpdateCallRejectedError(canisterId, methodName, requestId, response) {
+        var _this = _super.call(this, canisterId, methodName, 'update', {
+            'Request ID': (0, buffer_2.toHex)(requestId),
+            'HTTP status code': response.status.toString(),
+            'HTTP status text': response.statusText
+        }) || this;
+        _this.requestId = requestId;
+        _this.response = response;
+        return _this;
+    }
+    return UpdateCallRejectedError;
+}(ActorCallError));
+exports.UpdateCallRejectedError = UpdateCallRejectedError;
+/**
+ * The mode used when installing a canister.
+ */
+var CanisterInstallMode;
+(function (CanisterInstallMode) {
+    CanisterInstallMode["Install"] = "install";
+    CanisterInstallMode["Reinstall"] = "reinstall";
+    CanisterInstallMode["Upgrade"] = "upgrade";
+})(CanisterInstallMode = exports.CanisterInstallMode || (exports.CanisterInstallMode = {}));
+var metadataSymbol = Symbol.for('ic-agent-metadata');
+/**
+ * An actor base class. An actor is an object containing only functions that will
+ * return a promise. These functions are derived from the IDL definition.
+ */
+var Actor = /** @class */ (function () {
+    function Actor(metadata) {
+        this[metadataSymbol] = Object.freeze(metadata);
+    }
+    /**
+     * Get the Agent class this Actor would call, or undefined if the Actor would use
+     * the default agent (global.ic.agent).
+     * @param actor The actor to get the agent of.
+     */
+    Actor.agentOf = function (actor) {
+        return actor[metadataSymbol].config.agent;
+    };
+    /**
+     * Get the interface of an actor, in the form of an instance of a Service.
+     * @param actor The actor to get the interface of.
+     */
+    Actor.interfaceOf = function (actor) {
+        return actor[metadataSymbol].service;
+    };
+    Actor.canisterIdOf = function (actor) {
+        return principal_1.Principal.from(actor[metadataSymbol].config.canisterId);
+    };
+    Actor.install = function (fields, config) {
+        return __awaiter(this, void 0, void 0, function () {
+            var mode, arg, wasmModule, canisterId;
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        mode = fields.mode === undefined ? CanisterInstallMode.Install : fields.mode;
+                        arg = fields.arg ? __spreadArray([], __read(new Uint8Array(fields.arg)), false) : [];
+                        wasmModule = __spreadArray([], __read(new Uint8Array(fields.module)), false);
+                        canisterId = typeof config.canisterId === 'string' ? principal_1.Principal.fromText(config.canisterId) : config.canisterId;
+                        return [4 /*yield*/, getManagementCanister(config).install_code({
+                                mode: (_a = {}, _a[mode] = null, _a),
+                                arg: arg,
+                                wasm_module: wasmModule,
+                                canister_id: canisterId
+                            })];
+                    case 1:
+                        _b.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    Actor.createCanister = function (config) {
+        return __awaiter(this, void 0, void 0, function () {
+            var canisterId;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, getManagementCanister(config || {}).provisional_create_canister_with_cycles({
+                            amount: [],
+                            settings: []
+                        })];
+                    case 1:
+                        canisterId = (_a.sent()).canister_id;
+                        return [2 /*return*/, canisterId];
+                }
+            });
+        });
+    };
+    Actor.createAndInstallCanister = function (interfaceFactory, fields, config) {
+        return __awaiter(this, void 0, void 0, function () {
+            var canisterId;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.createCanister(config)];
+                    case 1:
+                        canisterId = _a.sent();
+                        return [4 /*yield*/, this.install(__assign({}, fields), __assign(__assign({}, config), { canisterId: canisterId }))];
+                    case 2:
+                        _a.sent();
+                        return [2 /*return*/, this.createActor(interfaceFactory, __assign(__assign({}, config), { canisterId: canisterId }))];
+                }
+            });
+        });
+    };
+    Actor.createActorClass = function (interfaceFactory) {
+        var service = interfaceFactory({ IDL: IDL });
+        var CanisterActor = /** @class */ (function (_super) {
+            __extends(CanisterActor, _super);
+            function CanisterActor(config) {
+                var e_1, _a;
+                var _this = this;
+                var canisterId = typeof config.canisterId === 'string' ? principal_1.Principal.fromText(config.canisterId) : config.canisterId;
+                _this = _super.call(this, {
+                    config: __assign(__assign(__assign({}, DEFAULT_ACTOR_CONFIG), config), { canisterId: canisterId }),
+                    service: service
+                }) || this;
+                try {
+                    for (var _b = __values(service._fields), _c = _b.next(); !_c.done; _c = _b.next()) {
+                        var _d = __read(_c.value, 2), methodName = _d[0], func = _d[1];
+                        _this[methodName] = _createActorMethod(_this, methodName, func, config.blsVerify);
+                    }
+                }
+                catch (e_1_1) { e_1 = { error: e_1_1 }; }
+                finally {
+                    try {
+                        if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                    }
+                    finally { if (e_1) throw e_1.error; }
+                }
+                return _this;
+            }
+            return CanisterActor;
+        }(Actor));
+        return CanisterActor;
+    };
+    Actor.createActor = function (interfaceFactory, configuration) {
+        return new (this.createActorClass(interfaceFactory))(configuration);
+    };
+    return Actor;
+}());
+exports.Actor = Actor;
+// IDL functions can have multiple return values, so decoding always
+// produces an array. Ensure that functions with single or zero return
+// values behave as expected.
+function decodeReturnValue(types, msg) {
+    var returnValues = IDL.decode(types, buffer_1.Buffer.from(msg));
+    switch (returnValues.length) {
+        case 0:
+            return undefined;
+        case 1:
+            return returnValues[0];
+        default:
+            return returnValues;
+    }
+}
+var DEFAULT_ACTOR_CONFIG = {
+    pollingStrategyFactory: polling_1.defaultStrategy
+};
+function _createActorMethod(actor, methodName, func, blsVerify) {
+    var _this = this;
+    var caller;
+    if (func.annotations.includes('query')) {
+        caller = function (options) {
+            var args = [];
+            for (var _i = 1; _i < arguments.length; _i++) {
+                args[_i - 1] = arguments[_i];
+            }
+            return __awaiter(_this, void 0, void 0, function () {
+                var agent, cid, arg, result;
+                var _a, _b;
+                return __generator(this, function (_c) {
+                    switch (_c.label) {
+                        case 0:
+                            // First, if there's a config transformation, call it.
+                            options = __assign(__assign({}, options), (_b = (_a = actor[metadataSymbol].config).queryTransform) === null || _b === void 0 ? void 0 : _b.call(_a, methodName, args, __assign(__assign({}, actor[metadataSymbol].config), options)));
+                            agent = options.agent || actor[metadataSymbol].config.agent || getDefaultAgent();
+                            cid = principal_1.Principal.from(options.canisterId || actor[metadataSymbol].config.canisterId);
+                            arg = IDL.encode(func.argTypes, args);
+                            return [4 /*yield*/, agent.query(cid, { methodName: methodName, arg: arg })];
+                        case 1:
+                            result = _c.sent();
+                            switch (result.status) {
+                                case "rejected" /* QueryResponseStatus.Rejected */:
+                                    throw new QueryCallRejectedError(cid, methodName, result);
+                                case "replied" /* QueryResponseStatus.Replied */:
+                                    return [2 /*return*/, decodeReturnValue(func.retTypes, result.reply.arg)];
+                            }
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        };
+    }
+    else {
+        caller = function (options) {
+            var args = [];
+            for (var _i = 1; _i < arguments.length; _i++) {
+                args[_i - 1] = arguments[_i];
+            }
+            return __awaiter(_this, void 0, void 0, function () {
+                var agent, _a, canisterId, effectiveCanisterId, pollingStrategyFactory, cid, ecid, arg, _b, requestId, response, pollStrategy, responseBytes;
+                var _c, _d;
+                return __generator(this, function (_e) {
+                    switch (_e.label) {
+                        case 0:
+                            // First, if there's a config transformation, call it.
+                            options = __assign(__assign({}, options), (_d = (_c = actor[metadataSymbol].config).callTransform) === null || _d === void 0 ? void 0 : _d.call(_c, methodName, args, __assign(__assign({}, actor[metadataSymbol].config), options)));
+                            agent = options.agent || actor[metadataSymbol].config.agent || getDefaultAgent();
+                            _a = __assign(__assign(__assign({}, DEFAULT_ACTOR_CONFIG), actor[metadataSymbol].config), options), canisterId = _a.canisterId, effectiveCanisterId = _a.effectiveCanisterId, pollingStrategyFactory = _a.pollingStrategyFactory;
+                            cid = principal_1.Principal.from(canisterId);
+                            ecid = effectiveCanisterId !== undefined ? principal_1.Principal.from(effectiveCanisterId) : cid;
+                            arg = IDL.encode(func.argTypes, args);
+                            return [4 /*yield*/, agent.call(cid, {
+                                    methodName: methodName,
+                                    arg: arg,
+                                    effectiveCanisterId: ecid
+                                })];
+                        case 1:
+                            _b = _e.sent(), requestId = _b.requestId, response = _b.response;
+                            if (!response.ok) {
+                                throw new UpdateCallRejectedError(cid, methodName, requestId, response);
+                            }
+                            pollStrategy = pollingStrategyFactory();
+                            return [4 /*yield*/, (0, polling_1.pollForResponse)(agent, ecid, requestId, pollStrategy, blsVerify)];
+                        case 2:
+                            responseBytes = _e.sent();
+                            if (responseBytes !== undefined) {
+                                return [2 /*return*/, decodeReturnValue(func.retTypes, responseBytes)];
+                            }
+                            else if (func.retTypes.length === 0) {
+                                return [2 /*return*/, undefined];
+                            }
+                            else {
+                                throw new Error("Call was returned undefined, but type [".concat(func.retTypes.join(','), "]."));
+                            }
+                            return [2 /*return*/];
+                    }
+                });
+            });
+        };
+    }
+    var handler = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return caller.apply(void 0, __spreadArray([{}], __read(args), false));
+    };
+    handler.withOptions = function (options) { return function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return caller.apply(void 0, __spreadArray([options], __read(args), false));
+    }; };
+    return handler;
+}
+//# sourceMappingURL=actor.js.map

package/v1/utils/actor.js.map

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

package/v1/utils/agent.d.ts

@@ -0,0 +1,156 @@
+import { Identity, RequestId } from './auth';
+import { JsonObject } from './idl';
+import { Principal } from './principal';
+/**
+ * Codes used by the replica for rejecting a message.
+ * See {@link https://sdk.dfinity.org/docs/interface-spec/#reject-codes | the interface spec}.
+ */
+export declare enum ReplicaRejectCode {
+    SysFatal = 1,
+    SysTransient = 2,
+    DestinationInvalid = 3,
+    CanisterReject = 4,
+    CanisterError = 5
+}
+/**
+ * Options when doing a {@link Agent.readState} call.
+ */
+export interface ReadStateOptions {
+    /**
+     * A list of paths to read the state of.
+     */
+    paths: ArrayBuffer[][];
+}
+/**
+ *
+ */
+export declare type QueryResponse = QueryResponseReplied | QueryResponseRejected;
+export declare const enum QueryResponseStatus {
+    Replied = "replied",
+    Rejected = "rejected"
+}
+export interface QueryResponseBase {
+    status: QueryResponseStatus;
+}
+export interface QueryResponseReplied extends QueryResponseBase {
+    status: QueryResponseStatus.Replied;
+    reply: {
+        arg: ArrayBuffer;
+    };
+}
+export interface QueryResponseRejected extends QueryResponseBase {
+    status: QueryResponseStatus.Rejected;
+    reject_code: ReplicaRejectCode;
+    reject_message: string;
+}
+/**
+ * Options when doing a {@link Agent.query} call.
+ */
+export interface QueryFields {
+    /**
+     * The method name to call.
+     */
+    methodName: string;
+    /**
+     * A binary encoded argument. This is already encoded and will be sent as is.
+     */
+    arg: ArrayBuffer;
+}
+/**
+ * Options when doing a {@link Agent.call} call.
+ */
+export interface CallOptions {
+    /**
+     * The method name to call.
+     */
+    methodName: string;
+    /**
+     * A binary encoded argument. This is already encoded and will be sent as is.
+     */
+    arg: ArrayBuffer;
+    /**
+     * An effective canister ID, used for routing. This should only be mentioned if
+     * it's different from the canister ID.
+     */
+    effectiveCanisterId: Principal | string;
+}
+export interface ReadStateResponse {
+    certificate: ArrayBuffer;
+}
+export interface SubmitResponse {
+    requestId: RequestId;
+    response: {
+        ok: boolean;
+        status: number;
+        statusText: string;
+    };
+}
+/**
+ * An Agent able to make calls and queries to a Replica.
+ */
+export interface Agent {
+    readonly rootKey: ArrayBuffer | null;
+    /**
+     * Returns the principal ID associated with this agent (by default). It only shows
+     * the principal of the default identity in the agent, which is the principal used
+     * when calls don't specify it.
+     */
+    getPrincipal(): Promise<Principal>;
+    /**
+     * Send a read state query to the replica. This includes a list of paths to return,
+     * and will return a Certificate. This will only reject on communication errors,
+     * but the certificate might contain less information than requested.
+     * @param effectiveCanisterId A Canister ID related to this call.
+     * @param options The options for this call.
+     */
+    readState(effectiveCanisterId: Principal | string, options: ReadStateOptions): Promise<ReadStateResponse>;
+    call(canisterId: Principal | string, fields: CallOptions): Promise<SubmitResponse>;
+    /**
+     * Query the status endpoint of the replica. This normally has a few fields that
+     * corresponds to the version of the replica, its root public key, and any other
+     * information made public.
+     * @returns A JsonObject that is essentially a record of fields from the status
+     *     endpoint.
+     */
+    status(): Promise<JsonObject>;
+    /**
+     * Send a query call to a canister. See
+     * {@link https://sdk.dfinity.org/docs/interface-spec/#http-query | the interface spec}.
+     * @param canisterId The Principal of the Canister to send the query to. Sending a query to
+     *     the management canister is not supported (as it has no meaning from an agent).
+     * @param options Options to use to create and send the query.
+     * @returns The response from the replica. The Promise will only reject when the communication
+     *     failed. If the query itself failed but no protocol errors happened, the response will
+     *     be of type QueryResponseRejected.
+     */
+    query(canisterId: Principal | string, options: QueryFields): Promise<QueryResponse>;
+    /**
+     * By default, the agent is configured to talk to the main Internet Computer,
+     * and verifies responses using a hard-coded public key.
+     *
+     * This function will instruct the agent to ask the endpoint for its public
+     * key, and use that instead. This is required when talking to a local test
+     * instance, for example.
+     *
+     * Only use this when you are  _not_ talking to the main Internet Computer,
+     * otherwise you are prone to man-in-the-middle attacks! Do not call this
+     * function by default.
+     */
+    fetchRootKey(): Promise<ArrayBuffer>;
+    /**
+     * If an application needs to invalidate an identity under certain conditions, an `Agent` may expose an `invalidateIdentity` method.
+     * Invoking this method will set the inner identity used by the `Agent` to `null`.
+     *
+     * A use case for this would be - after a certain period of inactivity, a secure application chooses to invalidate the identity of any `HttpAgent` instances. An invalid identity can be replaced by `Agent.replaceIdentity`
+     */
+    invalidateIdentity?(): void;
+    /**
+     * If an application needs to replace an identity under certain conditions, an `Agent` may expose a `replaceIdentity` method.
+     * Invoking this method will set the inner identity used by the `Agent` to a newly provided identity.
+     *
+     * A use case for this would be - after authenticating using `@dfinity/auth-client`, you can replace the `AnonymousIdentity` of your `Actor` with a `DelegationIdentity`.
+     *
+     * ```Actor.agentOf(defaultActor).replaceIdentity(await authClient.getIdentity());```
+     */
+    replaceIdentity?(identity: Identity): void;
+}

package/v1/utils/agent.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReplicaRejectCode = void 0;
+/**
+ * Codes used by the replica for rejecting a message.
+ * See {@link https://sdk.dfinity.org/docs/interface-spec/#reject-codes | the interface spec}.
+ */
+var ReplicaRejectCode;
+(function (ReplicaRejectCode) {
+    ReplicaRejectCode[ReplicaRejectCode["SysFatal"] = 1] = "SysFatal";
+    ReplicaRejectCode[ReplicaRejectCode["SysTransient"] = 2] = "SysTransient";
+    ReplicaRejectCode[ReplicaRejectCode["DestinationInvalid"] = 3] = "DestinationInvalid";
+    ReplicaRejectCode[ReplicaRejectCode["CanisterReject"] = 4] = "CanisterReject";
+    ReplicaRejectCode[ReplicaRejectCode["CanisterError"] = 5] = "CanisterError";
+})(ReplicaRejectCode = exports.ReplicaRejectCode || (exports.ReplicaRejectCode = {}));
+//# sourceMappingURL=agent.js.map

package/v1/utils/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/v1/utils/agent.ts"],"names":[],"mappings":";;;AAIA;;;GAGG;AACH,IAAY,iBAMX;AAND,WAAY,iBAAiB;IAC3B,iEAAY,CAAA;IACZ,yEAAgB,CAAA;IAChB,qFAAsB,CAAA;IACtB,6EAAkB,CAAA;IAClB,2EAAiB,CAAA;AACnB,CAAC,EANW,iBAAiB,GAAjB,yBAAiB,KAAjB,yBAAiB,QAM5B"}