@astrox/agent 0.0.24 → 0.0.30

package/lib/esm/agent/http/index.js

@@ -0,0 +1,328 @@
+import { getKraken } from '@astrox/agent';
+import { Principal } from '@astrox/principal';
+import { AnonymousIdentity } from '../../auth';
+import * as cbor from '../../cbor';
+import { requestIdOf } from '../../request_id';
+import { fromHex, toHex } from '../../utils/buffer';
+import { Expiry } from './transforms';
+import { SubmitRequestType, } from './types';
+export * from './transforms';
+export { makeNonce } from './types';
+export var RequestStatusResponseStatus;
+(function (RequestStatusResponseStatus) {
+    RequestStatusResponseStatus["Received"] = "received";
+    RequestStatusResponseStatus["Processing"] = "processing";
+    RequestStatusResponseStatus["Replied"] = "replied";
+    RequestStatusResponseStatus["Rejected"] = "rejected";
+    RequestStatusResponseStatus["Unknown"] = "unknown";
+    RequestStatusResponseStatus["Done"] = "done";
+})(RequestStatusResponseStatus || (RequestStatusResponseStatus = {}));
+// Default delta for ingress expiry is 5 minutes.
+const DEFAULT_INGRESS_EXPIRY_DELTA_IN_MSECS = 5 * 60 * 1000;
+// Root public key for the IC, encoded as hex
+const IC_ROOT_KEY = '308182301d060d2b0601040182dc7c0503010201060c2b0601040182dc7c05030201036100814' +
+    'c0e6ec71fab583b08bd81373c255c3c371b2e84863c98a4f1e08b74235d14fb5d9c0cd546d968' +
+    '5f913a0c0b2cc5341583bf4b4392e467db96d65b9bb4cb717112f8472e0d5a4d14505ffd7484' +
+    'b01291091c5f87b98883463f98091a0baaae';
+function getDefaultFetch() {
+    const result = typeof window === 'undefined'
+        ? typeof global === 'undefined'
+            ? typeof self === 'undefined'
+                ? undefined
+                : self.fetch.bind(self)
+            : global.fetch.bind(global)
+        : window.fetch.bind(window);
+    if (!result) {
+        throw new Error('Could not find default `fetch` implementation.');
+    }
+    return result;
+}
+function getKrakenFetch() {
+    if (getKraken()) {
+        const result = typeof window === 'undefined'
+            ? typeof global === 'undefined'
+                ? typeof self === 'undefined'
+                    ? undefined
+                    : self.fetchAgent.bind(self)
+                : global.fetchAgent.bind(global)
+            : window.fetchAgent.bind(window);
+        if (!result) {
+            throw new Error('Could not find default `fetch` implementation.');
+        }
+        return result;
+    }
+    else {
+        return getDefaultFetch();
+    }
+}
+// A HTTP agent allows users to interact with a client of the internet computer
+// using the available methods. It exposes an API that closely follows the
+// public view of the internet computer, and is not intended to be exposed
+// directly to the majority of users due to its low-level interface.
+//
+// There is a pipeline to apply transformations to the request before sending
+// it to the client. This is to decouple signature, nonce generation and
+// other computations so that this class can stay as simple as possible while
+// allowing extensions.
+export class HttpAgent {
+    constructor(options = {}) {
+        this.rootKey = fromHex(IC_ROOT_KEY);
+        this._pipeline = [];
+        this._rootKeyFetched = false;
+        if (options.source) {
+            if (!(options.source instanceof HttpAgent)) {
+                throw new Error("An Agent's source can only be another HttpAgent");
+            }
+            this._pipeline = [...options.source._pipeline];
+            this._identity = options.source._identity;
+            this._fetch = options.source._fetch;
+            this._fetchAgent = options.source._fetchAgent;
+            this._host = options.source._host;
+            this._credentials = options.source._credentials;
+        }
+        else {
+            this._fetch = options.fetch || getDefaultFetch() || fetch.bind(global);
+            this._fetchAgent = options.fetchAgent || getKrakenFetch() || fetch.bind(global);
+        }
+        if (options.host !== undefined) {
+            if (!options.host.match(/^[a-z]+:/) && typeof window !== 'undefined') {
+                this._host = new URL(window.location.protocol + '//' + options.host);
+            }
+            else {
+                this._host = new URL(options.host);
+            }
+        }
+        else if (options.source !== undefined) {
+            // Safe to ignore here.
+            this._host = options.source._host;
+        }
+        else {
+            const location = typeof window !== 'undefined' ? window.location : undefined;
+            if (!location) {
+                throw new Error('Must specify a host to connect to.');
+            }
+            this._host = new URL(location + '');
+        }
+        if (options.credentials) {
+            const { name, password } = options.credentials;
+            this._credentials = `${name}${password ? ':' + password : ''}`;
+        }
+        this._identity = Promise.resolve(options.identity || new AnonymousIdentity());
+    }
+    addTransform(fn, priority = fn.priority || 0) {
+        // Keep the pipeline sorted at all time, by priority.
+        const i = this._pipeline.findIndex(x => (x.priority || 0) < priority);
+        this._pipeline.splice(i >= 0 ? i : this._pipeline.length, 0, Object.assign(fn, { priority }));
+    }
+    async getPrincipal() {
+        return (await this._identity).getPrincipal();
+    }
+    async call(canisterId, options, identity) {
+        const id = (await (identity !== undefined ? await identity : await this._identity));
+        const canister = Principal.from(canisterId);
+        const ecid = options.effectiveCanisterId
+            ? Principal.from(options.effectiveCanisterId)
+            : canister;
+        const sender = id.getPrincipal() || Principal.anonymous();
+        const submit = {
+            request_type: SubmitRequestType.Call,
+            canister_id: canister,
+            method_name: options.methodName,
+            arg: options.arg,
+            sender,
+            ingress_expiry: new Expiry(DEFAULT_INGRESS_EXPIRY_DELTA_IN_MSECS),
+        };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let transformedRequest = (await this._transform({
+            request: {
+                body: null,
+                method: 'POST',
+                headers: Object.assign({ 'Content-Type': 'application/cbor' }, (this._credentials ? { Authorization: 'Basic ' + btoa(this._credentials) } : {})),
+            },
+            endpoint: "call" /* Call */,
+            body: submit,
+        }));
+        // Apply transform for identity.
+        transformedRequest = await id.transformRequest(transformedRequest);
+        const body = cbor.encode(transformedRequest.body);
+        const kraken = getKraken();
+        if (!kraken) {
+            // Run both in parallel. The fetch is quite expensive, so we have plenty of time to
+            // calculate the requestId locally.
+            const [response, requestId] = await Promise.all([
+                this._fetch('' + new URL(`/api/v2/canister/${ecid.toText()}/call`, this._host), Object.assign(Object.assign({}, transformedRequest.request), { body })),
+                requestIdOf(submit),
+            ]);
+            console.log('astorx call');
+            if (!response.ok) {
+                throw new Error(`Server returned an error:\n` +
+                    `  Code: ${response.status} (${response.statusText})\n` +
+                    `  Body: ${await response.text()}\n`);
+            }
+            return {
+                requestId,
+                response: {
+                    ok: response.ok,
+                    status: response.status,
+                    statusText: response.statusText,
+                },
+            };
+        }
+        else {
+            const [response, requestId] = await Promise.all([
+                this._fetchAgent('' + new URL(`/api/v2/canister/${ecid.toText()}/call`, this._host), Object.assign(Object.assign({}, transformedRequest.request), { body: toHex(body) })),
+                requestIdOf(submit),
+            ]);
+            if (!response.ok) {
+                throw new Error(`Server returned an error:\n` +
+                    `  Code: ${response.status} (${response.statusText})\n` +
+                    `  Body: ${response.body}\n`);
+            }
+            return {
+                requestId,
+                response: {
+                    ok: response.ok,
+                    status: response.status,
+                    statusText: response.statusText,
+                },
+            };
+        }
+    }
+    async query(canisterId, fields, identity) {
+        const id = await (identity !== undefined ? await identity : await this._identity);
+        const canister = typeof canisterId === 'string' ? Principal.fromText(canisterId) : canisterId;
+        const sender = (id === null || id === void 0 ? void 0 : id.getPrincipal()) || Principal.anonymous();
+        const request = {
+            request_type: "query" /* Query */,
+            canister_id: canister,
+            method_name: fields.methodName,
+            arg: fields.arg,
+            sender,
+            ingress_expiry: new Expiry(DEFAULT_INGRESS_EXPIRY_DELTA_IN_MSECS),
+        };
+        // TODO: remove this any. This can be a Signed or UnSigned request.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let transformedRequest = await this._transform({
+            request: {
+                method: 'POST',
+                headers: Object.assign({ 'Content-Type': 'application/cbor' }, (this._credentials ? { Authorization: 'Basic ' + btoa(this._credentials) } : {})),
+            },
+            endpoint: "read" /* Query */,
+            body: request,
+        });
+        // Apply transform for identity.
+        transformedRequest = await id.transformRequest(transformedRequest);
+        const body = cbor.encode(transformedRequest.body);
+        const kraken = getKraken();
+        if (!kraken) {
+            const response = await this._fetch('' + new URL(`/api/v2/canister/${canister.toText()}/query`, this._host), Object.assign(Object.assign({}, transformedRequest.request), { body }));
+            console.log('astorx query');
+            if (!response.ok) {
+                throw new Error(`Server returned an error:\n` +
+                    `  Code: ${response.status} (${response.statusText})\n` +
+                    `  Body: ${await response.text()}\n`);
+            }
+            return cbor.decode(await response.arrayBuffer());
+        }
+        else {
+            const response = await this._fetchAgent('' + new URL(`/api/v2/canister/${canister.toText()}/query`, this._host), Object.assign(Object.assign({}, transformedRequest.request), { body: toHex(body) }));
+            console.log('astrox query');
+            if (!response.ok) {
+                throw new Error(`Server returned an error:\n` +
+                    `  Code: ${response.status} (${response.statusText})\n` +
+                    `  Body: ${response.body}\n`);
+            }
+            return cbor.decode(fromHex(response.body));
+        }
+    }
+    async readState(canisterId, fields, identity) {
+        const canister = typeof canisterId === 'string' ? Principal.fromText(canisterId) : canisterId;
+        const id = await (identity !== undefined ? await identity : await this._identity);
+        const sender = (id === null || id === void 0 ? void 0 : id.getPrincipal()) || Principal.anonymous();
+        // TODO: remove this any. This can be a Signed or UnSigned request.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let transformedRequest = await this._transform({
+            request: {
+                method: 'POST',
+                headers: Object.assign({ 'Content-Type': 'application/cbor' }, (this._credentials ? { Authorization: 'Basic ' + btoa(this._credentials) } : {})),
+            },
+            endpoint: "read_state" /* ReadState */,
+            body: {
+                request_type: "read_state" /* ReadState */,
+                paths: fields.paths,
+                sender,
+                ingress_expiry: new Expiry(DEFAULT_INGRESS_EXPIRY_DELTA_IN_MSECS),
+            },
+        });
+        // Apply transform for identity.
+        transformedRequest = await id.transformRequest(transformedRequest);
+        const body = cbor.encode(transformedRequest.body);
+        const kraken = getKraken();
+        if (!kraken) {
+            const response = await this._fetch('' + new URL(`/api/v2/canister/${canister}/read_state`, this._host), Object.assign(Object.assign({}, transformedRequest.request), { body }));
+            console.log('astorx read_state');
+            if (!response.ok) {
+                throw new Error(`Server returned an error:\n` +
+                    `  Code: ${response.status} (${response.statusText})\n` +
+                    `  Body: ${await response.text()}\n`);
+            }
+            return cbor.decode(await response.arrayBuffer());
+        }
+        else {
+            const response = await this._fetchAgent('' + new URL(`/api/v2/canister/${canister}/read_state`, this._host), Object.assign(Object.assign({}, transformedRequest.request), { body: toHex(body) }));
+            console.log('astorx read_state');
+            if (!response.ok) {
+                throw new Error(`Server returned an error:\n` +
+                    `  Code: ${response.status} (${response.statusText})\n` +
+                    `  Body: ${response.body}\n`);
+            }
+            return cbor.decode(fromHex(response.body));
+        }
+    }
+    async status() {
+        const headers = this._credentials
+            ? {
+                Authorization: 'Basic ' + btoa(this._credentials),
+            }
+            : {};
+        const kraken = getKraken();
+        if (!kraken) {
+            const response = await this._fetch('' + new URL(`/api/v2/status`, this._host), { headers });
+            console.log('astorx status');
+            if (!response.ok) {
+                throw new Error(`Server returned an error:\n` +
+                    `  Code: ${response.status} (${response.statusText})\n` +
+                    `  Body: ${await response.text()}\n`);
+            }
+            return cbor.decode(await response.arrayBuffer());
+        }
+        else {
+            const response = await this._fetchAgent('' + new URL(`/api/v2/status`, this._host), {
+                headers,
+            });
+            console.log('astrox status');
+            if (!response.ok) {
+                throw new Error(`Server returned an error:\n` +
+                    `  Code: ${response.status} (${response.statusText})\n` +
+                    `  Body: ${response.body}\n`);
+            }
+            return cbor.decode(fromHex(response.body));
+        }
+    }
+    async fetchRootKey() {
+        if (!this._rootKeyFetched) {
+            // Hex-encoded version of the replica root key
+            this.rootKey = (await this.status()).root_key;
+            this._rootKeyFetched = true;
+        }
+        return this.rootKey;
+    }
+    _transform(request) {
+        let p = Promise.resolve(request);
+        for (const fn of this._pipeline) {
+            p = p.then(r => fn(r).then(r2 => r2 || r));
+        }
+        return p;
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/esm/agent/http/index.js.map

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

package/lib/esm/agent/http/transforms.d.ts

@@ -0,0 +1,20 @@
+import * as cbor from 'simple-cbor';
+import { HttpAgentRequestTransformFn, Nonce } from './types';
+export declare class Expiry {
+    private readonly _value;
+    constructor(deltaInMSec: number);
+    toCBOR(): cbor.CborValue;
+    toHash(): ArrayBuffer;
+}
+/**
+ * Create a Nonce transform, which takes a function that returns a Buffer, and adds it
+ * as the nonce to every call requests.
+ * @param nonceFn A function that returns a buffer. By default uses a semi-random method.
+ */
+export declare function makeNonceTransform(nonceFn?: () => Nonce): HttpAgentRequestTransformFn;
+/**
+ * Create a transform that adds a delay (by default 5 minutes) to the expiry.
+ *
+ * @param delayInMilliseconds The delay to add to the call time, in milliseconds.
+ */
+export declare function makeExpiryTransform(delayInMilliseconds: number): HttpAgentRequestTransformFn;

package/lib/esm/agent/http/transforms.js

@@ -0,0 +1,45 @@
+import { lebEncode } from '@astrox/candid';
+import * as cbor from 'simple-cbor';
+import { makeNonce } from './types';
+const NANOSECONDS_PER_MILLISECONDS = BigInt(1000000);
+const REPLICA_PERMITTED_DRIFT_MILLISECONDS = BigInt(60 * 1000);
+export class Expiry {
+    constructor(deltaInMSec) {
+        // Use bigint because it can overflow the maximum number allowed in a double float.
+        this._value =
+            (BigInt(Date.now()) + BigInt(deltaInMSec) - REPLICA_PERMITTED_DRIFT_MILLISECONDS) *
+                NANOSECONDS_PER_MILLISECONDS;
+    }
+    toCBOR() {
+        // TODO: change this to take the minimum amount of space (it always takes 8 bytes now).
+        return cbor.value.u64(this._value.toString(16), 16);
+    }
+    toHash() {
+        return lebEncode(this._value);
+    }
+}
+/**
+ * Create a Nonce transform, which takes a function that returns a Buffer, and adds it
+ * as the nonce to every call requests.
+ * @param nonceFn A function that returns a buffer. By default uses a semi-random method.
+ */
+export function makeNonceTransform(nonceFn = makeNonce) {
+    return async (request) => {
+        // Nonce are only useful for async calls, to prevent replay attacks. Other types of
+        // calls don't need Nonce so we just skip creating one.
+        if (request.endpoint === "call" /* Call */) {
+            request.body.nonce = nonceFn();
+        }
+    };
+}
+/**
+ * Create a transform that adds a delay (by default 5 minutes) to the expiry.
+ *
+ * @param delayInMilliseconds The delay to add to the call time, in milliseconds.
+ */
+export function makeExpiryTransform(delayInMilliseconds) {
+    return async (request) => {
+        request.body.ingress_expiry = new Expiry(delayInMilliseconds);
+    };
+}
+//# sourceMappingURL=transforms.js.map

package/lib/esm/agent/http/transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.js","sourceRoot":"","sources":["../../../../src/agent/http/transforms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAA2D,SAAS,EAAS,MAAM,SAAS,CAAC;AAEpG,MAAM,4BAA4B,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAErD,MAAM,oCAAoC,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAE/D,MAAM,OAAO,MAAM;IAGjB,YAAY,WAAmB;QAC7B,mFAAmF;QACnF,IAAI,CAAC,MAAM;YACT,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,oCAAoC,CAAC;gBACjF,4BAA4B,CAAC;IACjC,CAAC;IAEM,MAAM;QACX,uFAAuF;QACvF,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IAEM,MAAM;QACX,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAuB,SAAS;IACjE,OAAO,KAAK,EAAE,OAAyB,EAAE,EAAE;QACzC,mFAAmF;QACnF,uDAAuD;QACvD,IAAI,OAAO,CAAC,QAAQ,sBAAkB,EAAE;YACtC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,CAAC;SAChC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,mBAA2B;IAC7D,OAAO,KAAK,EAAE,OAAyB,EAAE,EAAE;QACzC,OAAO,CAAC,IAAI,CAAC,cAAc,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAChE,CAAC,CAAC;AACJ,CAAC"}

package/lib/esm/agent/http/types.d.ts

@@ -0,0 +1,77 @@
+import type { Principal } from '@astrox/principal';
+import { Expiry } from './transforms';
+/**
+ * @internal
+ */
+export declare const enum Endpoint {
+    Query = "read",
+    ReadState = "read_state",
+    Call = "call"
+}
+export declare type HttpAgentRequest = HttpAgentQueryRequest | HttpAgentSubmitRequest | HttpAgentReadStateRequest;
+export interface HttpAgentBaseRequest {
+    readonly endpoint: Endpoint;
+    request: RequestInit;
+}
+export interface HttpAgentSubmitRequest extends HttpAgentBaseRequest {
+    readonly endpoint: Endpoint.Call;
+    body: CallRequest;
+}
+export interface HttpAgentQueryRequest extends HttpAgentBaseRequest {
+    readonly endpoint: Endpoint.Query;
+    body: ReadRequest;
+}
+export interface HttpAgentReadStateRequest extends HttpAgentBaseRequest {
+    readonly endpoint: Endpoint.ReadState;
+    body: ReadRequest;
+}
+export interface Signed<T> {
+    content: T;
+    sender_pubkey: ArrayBuffer;
+    sender_sig: ArrayBuffer;
+}
+export interface UnSigned<T> {
+    content: T;
+}
+export declare type Envelope<T> = Signed<T> | UnSigned<T>;
+export interface HttpAgentRequestTransformFn {
+    (args: HttpAgentRequest): Promise<HttpAgentRequest | undefined | void>;
+    priority?: number;
+}
+export interface CallRequest extends Record<string, any> {
+    request_type: SubmitRequestType.Call;
+    canister_id: Principal;
+    method_name: string;
+    arg: ArrayBuffer;
+    sender: Uint8Array | Principal;
+    ingress_expiry: Expiry;
+}
+export declare enum SubmitRequestType {
+    Call = "call"
+}
+export declare const enum ReadRequestType {
+    Query = "query",
+    ReadState = "read_state"
+}
+export interface QueryRequest extends Record<string, any> {
+    request_type: ReadRequestType.Query;
+    canister_id: Principal;
+    method_name: string;
+    arg: ArrayBuffer;
+    sender: Uint8Array | Principal;
+    ingress_expiry: Expiry;
+}
+export interface ReadStateRequest extends Record<string, any> {
+    request_type: ReadRequestType.ReadState;
+    paths: ArrayBuffer[][];
+    ingress_expiry: Expiry;
+    sender: Uint8Array | Principal;
+}
+export declare type ReadRequest = QueryRequest | ReadStateRequest;
+export declare type Nonce = Uint8Array & {
+    __nonce__: void;
+};
+/**
+ * Create a random Nonce, based on date and a random suffix.
+ */
+export declare function makeNonce(): Nonce;

package/lib/esm/agent/http/types.js

@@ -0,0 +1,20 @@
+// tslint:enable:camel-case
+// The types of values allowed in the `request_type` field for submit requests.
+export var SubmitRequestType;
+(function (SubmitRequestType) {
+    SubmitRequestType["Call"] = "call";
+})(SubmitRequestType || (SubmitRequestType = {}));
+/**
+ * Create a random Nonce, based on date and a random suffix.
+ */
+export function makeNonce() {
+    // Encode 128 bits.
+    const buffer = new ArrayBuffer(16);
+    const view = new DataView(buffer);
+    const value = BigInt(+Date.now()) * BigInt(100000) + BigInt(Math.floor(Math.random() * 100000));
+    view.setBigUint64(0, value);
+    // tslint:disable-next-line:no-bitwise
+    view.setBigUint64(1, value >> BigInt(64));
+    return buffer;
+}
+//# sourceMappingURL=types.js.map

package/lib/esm/agent/http/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/agent/http/types.ts"],"names":[],"mappings":"AAmEA,2BAA2B;AAE3B,+EAA+E;AAC/E,MAAM,CAAN,IAAY,iBAEX;AAFD,WAAY,iBAAiB;IAC3B,kCAAa,CAAA;AACf,CAAC,EAFW,iBAAiB,KAAjB,iBAAiB,QAE5B;AA8BD;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,mBAAmB;IACnB,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IAChG,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5B,sCAAsC;IACtC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE1C,OAAO,MAAe,CAAC;AACzB,CAAC"}

package/lib/esm/agent/index.d.ts

@@ -0,0 +1,7 @@
+import { Kraken } from '../index';
+import { Agent } from './api';
+export * from './api';
+export * from './http';
+export * from './proxy';
+export declare function getDefaultAgent(): Agent;
+export declare function getKraken(): Kraken | undefined;

package/lib/esm/agent/index.js

@@ -0,0 +1,27 @@
+export * from './api';
+export * from './http';
+export * from './proxy';
+export function getDefaultAgent() {
+    const 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;
+}
+export function getKraken() {
+    const kraken = typeof window === 'undefined'
+        ? typeof global === 'undefined'
+            ? typeof self === 'undefined'
+                ? undefined
+                : self.kraken
+            : global.kraken
+        : window.kraken;
+    return kraken;
+}
+//# sourceMappingURL=index.js.map

package/lib/esm/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/index.ts"],"names":[],"mappings":"AAGA,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AAMxB,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GACT,OAAO,MAAM,KAAK,WAAW;QAC3B,CAAC,CAAC,OAAO,MAAM,KAAK,WAAW;YAC7B,CAAC,CAAC,OAAO,IAAI,KAAK,WAAW;gBAC3B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK;YACjB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK;QACnB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC;IAEtB,IAAI,CAAC,KAAK,EAAE;QACV,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;KAC7C;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,WAAW;QAC3B,CAAC,CAAC,OAAO,MAAM,KAAK,WAAW;YAC7B,CAAC,CAAC,OAAO,IAAI,KAAK,WAAW;gBAC3B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,IAAI,CAAC,MAAM;YACf,CAAC,CAAC,MAAM,CAAC,MAAM;QACjB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;IAEpB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/esm/agent/proxy.d.ts

@@ -0,0 +1,85 @@
+import { CallOptions, QueryFields, QueryResponse, ReadStateOptions, ReadStateResponse, SubmitResponse } from '..';
+import { JsonObject } from '@astrox/candid';
+import { Agent } from './api';
+import { Principal } from '@astrox/principal';
+export declare enum ProxyMessageKind {
+    Error = "err",
+    GetPrincipal = "gp",
+    GetPrincipalResponse = "gpr",
+    Query = "q",
+    QueryResponse = "qr",
+    Call = "c",
+    CallResponse = "cr",
+    ReadState = "rs",
+    ReadStateResponse = "rsr",
+    Status = "s",
+    StatusResponse = "sr"
+}
+export interface ProxyMessageBase {
+    id: number;
+    type: ProxyMessageKind;
+}
+export interface ProxyMessageError extends ProxyMessageBase {
+    type: ProxyMessageKind.Error;
+    error: any;
+}
+export interface ProxyMessageGetPrincipal extends ProxyMessageBase {
+    type: ProxyMessageKind.GetPrincipal;
+}
+export interface ProxyMessageGetPrincipalResponse extends ProxyMessageBase {
+    type: ProxyMessageKind.GetPrincipalResponse;
+    response: string;
+}
+export interface ProxyMessageQuery extends ProxyMessageBase {
+    type: ProxyMessageKind.Query;
+    args: [string, QueryFields];
+}
+export interface ProxyMessageQueryResponse extends ProxyMessageBase {
+    type: ProxyMessageKind.QueryResponse;
+    response: QueryResponse;
+}
+export interface ProxyMessageCall extends ProxyMessageBase {
+    type: ProxyMessageKind.Call;
+    args: [string, CallOptions];
+}
+export interface ProxyMessageCallResponse extends ProxyMessageBase {
+    type: ProxyMessageKind.CallResponse;
+    response: SubmitResponse;
+}
+export interface ProxyMessageReadState extends ProxyMessageBase {
+    type: ProxyMessageKind.ReadState;
+    args: [string, ReadStateOptions];
+}
+export interface ProxyMessageReadStateResponse extends ProxyMessageBase {
+    type: ProxyMessageKind.ReadStateResponse;
+    response: ReadStateResponse;
+}
+export interface ProxyMessageStatus extends ProxyMessageBase {
+    type: ProxyMessageKind.Status;
+}
+export interface ProxyMessageStatusResponse extends ProxyMessageBase {
+    type: ProxyMessageKind.StatusResponse;
+    response: JsonObject;
+}
+export declare type ProxyMessage = ProxyMessageError | ProxyMessageGetPrincipal | ProxyMessageGetPrincipalResponse | ProxyMessageQuery | ProxyMessageQueryResponse | ProxyMessageCall | ProxyMessageReadState | ProxyMessageReadStateResponse | ProxyMessageCallResponse | ProxyMessageStatus | ProxyMessageStatusResponse;
+export declare class ProxyStubAgent {
+    private _frontend;
+    private _agent;
+    constructor(_frontend: (msg: ProxyMessage) => void, _agent: Agent);
+    onmessage(msg: ProxyMessage): void;
+}
+export declare class ProxyAgent implements Agent {
+    private _backend;
+    private _nextId;
+    private _pendingCalls;
+    rootKey: null;
+    constructor(_backend: (msg: ProxyMessage) => void);
+    onmessage(msg: ProxyMessage): void;
+    getPrincipal(): Promise<Principal>;
+    readState(canisterId: Principal | string, fields: ReadStateOptions): Promise<ReadStateResponse>;
+    call(canisterId: Principal | string, fields: CallOptions): Promise<SubmitResponse>;
+    status(): Promise<JsonObject>;
+    query(canisterId: Principal | string, fields: QueryFields): Promise<QueryResponse>;
+    private _sendAndWait;
+    fetchRootKey(): Promise<ArrayBuffer>;
+}