@cartridge/controller 0.4.0 → 0.5.0-alpha.0

package/dist/provider.d.ts

@@ -0,0 +1,18 @@
+import { WalletAccount } from "starknet";
+import { RequestFn, StarknetWindowObject, WalletEventListener, WalletEvents } from "@starknet-io/types-js";
+import { ProviderOptions } from "./types";
+export default abstract class BaseProvider implements StarknetWindowObject {
+    id: string;
+    name: string;
+    version: string;
+    icon: string;
+    rpc: URL;
+    account?: WalletAccount;
+    subscriptions: WalletEvents[];
+    constructor(options: ProviderOptions);
+    request: RequestFn;
+    on: WalletEventListener;
+    off: WalletEventListener;
+    abstract probe(): Promise<WalletAccount | undefined>;
+    abstract connect(): Promise<WalletAccount | undefined>;
+}

package/dist/provider.js

@@ -0,0 +1,128 @@
+import { Permission, } from "@starknet-io/types-js";
+import { icon } from "./icon";
+export default class BaseProvider {
+    constructor(options) {
+        this.id = "controller";
+        this.name = "Controller";
+        this.version = "0.4.0";
+        this.icon = icon;
+        this.subscriptions = [];
+        this.request = async (call) => {
+            switch (call.type) {
+                case "wallet_getPermissions":
+                    await this.probe();
+                    if (this.account) {
+                        return [Permission.ACCOUNTS];
+                    }
+                    return [];
+                case "wallet_requestAccounts": {
+                    if (this.account) {
+                        return [this.account.address];
+                    }
+                    const params = call.params;
+                    if (params?.silent_mode) {
+                        this.account = await this.probe();
+                    }
+                    else {
+                        this.account = await this.connect();
+                    }
+                    if (this.account) {
+                        return [this.account.address];
+                    }
+                    return [];
+                }
+                case "wallet_watchAsset":
+                    throw {
+                        code: 63,
+                        message: "An unexpected error occurred",
+                        data: "wallet_watchAsset not implemented",
+                    };
+                case "wallet_addStarknetChain":
+                    throw {
+                        code: 63,
+                        message: "An unexpected error occurred",
+                        data: "wallet_addStarknetChain not implemented",
+                    };
+                case "wallet_switchStarknetChain":
+                    throw {
+                        code: 63,
+                        message: "An unexpected error occurred",
+                        data: "wallet_switchStarknetChain not implemented",
+                    };
+                case "wallet_requestChainId":
+                    if (!this.account) {
+                        throw {
+                            code: 63,
+                            message: "An unexpected error occurred",
+                            data: "wallet_deploymentData not implemented",
+                        };
+                    }
+                    return await this.account.getChainId();
+                case "wallet_deploymentData":
+                    throw {
+                        code: 63,
+                        message: "An unexpected error occurred",
+                        data: "wallet_deploymentData not implemented",
+                    };
+                case "wallet_addInvokeTransaction":
+                    if (!this.account) {
+                        throw {
+                            code: 63,
+                            message: "An unexpected error occurred",
+                            data: "wallet_deploymentData not implemented",
+                        };
+                    }
+                    let params = call.params;
+                    return await this.account.execute(params.calls.map((call) => ({
+                        contractAddress: call.contract_address,
+                        entrypoint: call.entry_point,
+                        calldata: call.calldata,
+                    })));
+                case "wallet_addDeclareTransaction":
+                    throw {
+                        code: 63,
+                        message: "An unexpected error occurred",
+                        data: "wallet_addDeclareTransaction not implemented",
+                    };
+                case "wallet_signTypedData": {
+                    if (!this.account) {
+                        throw {
+                            code: 63,
+                            message: "An unexpected error occurred",
+                            data: "Account not initialized",
+                        };
+                    }
+                    return await this.account.signMessage(call.params);
+                }
+                case "wallet_supportedSpecs":
+                    return [];
+                case "wallet_supportedWalletApi":
+                    return [];
+                default:
+                    throw {
+                        code: 63,
+                        message: "An unexpected error occurred",
+                        data: `Unknown RPC call type: ${call.type}`,
+                    };
+            }
+        };
+        this.on = (event, handler) => {
+            if (event !== "accountsChanged" && event !== "networkChanged") {
+                throw new Error(`Unknown event: ${event}`);
+            }
+            this.subscriptions.push({ type: event, handler });
+        };
+        this.off = (event, handler) => {
+            if (event !== "accountsChanged" && event !== "networkChanged") {
+                throw new Error(`Unknown event: ${event}`);
+            }
+            const idx = this.subscriptions.findIndex((sub) => sub.type === event && sub.handler === handler);
+            if (idx >= 0) {
+                this.subscriptions.splice(idx, 1);
+            }
+        };
+        const { rpc } = options;
+        this.rpc = new URL(rpc);
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/session/account.d.ts

@@ -0,0 +1,32 @@
+import { Policy } from "@cartridge/account-wasm";
+import { CartridgeSessionAccount } from "@cartridge/account-wasm/session";
+import { Call, InvokeFunctionResponse, WalletAccount } from "starknet";
+import BaseProvider from "../provider";
+export * from "../errors";
+export * from "../types";
+export { defaultPresets } from "../presets";
+export default class SessionAccount extends WalletAccount {
+    controller: CartridgeSessionAccount;
+    constructor(provider: BaseProvider, { rpcUrl, privateKey, address, ownerGuid, chainId, expiresAt, policies, }: {
+        rpcUrl: string;
+        privateKey: string;
+        address: string;
+        ownerGuid: string;
+        chainId: string;
+        expiresAt: number;
+        policies: Policy[];
+    });
+    /**
+     * Invoke execute function in account contract
+     *
+     * @param calls the invocation object or an array of them, containing:
+     * - contractAddress - the address of the contract
+     * - entrypoint - the entrypoint of the contract
+     * - calldata - (defaults to []) the calldata
+     * - signature - (defaults to []) the signature
+     * @param abis (optional) the abi of the contract for better displaying
+     *
+     * @returns response from addTransaction
+     */
+    execute(calls: Call | Call[]): Promise<InvokeFunctionResponse>;
+}

package/dist/session/account.js

@@ -0,0 +1,31 @@
+import { CartridgeSessionAccount } from "@cartridge/account-wasm/session";
+import { WalletAccount } from "starknet";
+import { normalizeCalls } from "../utils";
+export * from "../errors";
+export * from "../types";
+export { defaultPresets } from "../presets";
+export default class SessionAccount extends WalletAccount {
+    constructor(provider, { rpcUrl, privateKey, address, ownerGuid, chainId, expiresAt, policies, }) {
+        super({ nodeUrl: rpcUrl }, provider);
+        this.controller = CartridgeSessionAccount.new_as_registered(rpcUrl, privateKey, address, ownerGuid, chainId, {
+            expiresAt,
+            policies,
+        });
+    }
+    /**
+     * Invoke execute function in account contract
+     *
+     * @param calls the invocation object or an array of them, containing:
+     * - contractAddress - the address of the contract
+     * - entrypoint - the entrypoint of the contract
+     * - calldata - (defaults to []) the calldata
+     * - signature - (defaults to []) the signature
+     * @param abis (optional) the abi of the contract for better displaying
+     *
+     * @returns response from addTransaction
+     */
+    async execute(calls) {
+        return this.controller.execute(normalizeCalls(calls));
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/session/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/session/account.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAgC,aAAa,EAAE,MAAM,UAAU,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,aAAa;IAGvD,YACE,QAAsB,EACtB,EACE,MAAM,EACN,UAAU,EACV,OAAO,EACP,SAAS,EACT,OAAO,EACP,SAAS,EACT,QAAQ,GAST;QAED,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;QAErC,IAAI,CAAC,UAAU,GAAG,uBAAuB,CAAC,iBAAiB,CACzD,MAAM,EACN,UAAU,EACV,OAAO,EACP,SAAS,EACT,OAAO,EACP;YACE,SAAS;YACT,QAAQ;SACT,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,CAAC;CACF"}

package/dist/session/backend.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Represents a unified backend for storage operations and link handling.
+ */
+export interface UnifiedBackend {
+    /**
+     * Retrieves the value associated with the specified key.
+     * @param key - The key to look up in the storage.
+     * @returns A promise that resolves to the stored value as a string, or null if the key doesn't exist.
+     */
+    get: (key: string) => Promise<string | null>;
+    /**
+     * Stores a key-value pair in the storage.
+     * @param key - The key under which to store the value.
+     * @param value - The value to be stored.
+     * @returns A promise that resolves when the value has been successfully stored.
+     */
+    set: (key: string, value: string) => Promise<void>;
+    /**
+     * Removes the key-value pair associated with the specified key from the storage.
+     * @param key - The key of the item to be removed.
+     * @returns A promise that resolves when the item has been successfully removed.
+     */
+    delete: (key: string) => Promise<void>;
+    /**
+     * Opens the specified URL.
+     * @param url - The URL to open.
+     */
+    openLink: (url: string) => void;
+}
+/**
+ * Implements a local storage backend that conforms to the UnifiedBackend interface.
+ */
+export declare class LocalStorageBackend {
+    /**
+     * Retrieves the value associated with the specified key from local storage.
+     * @param key - The key to look up in local storage.
+     * @returns A promise that resolves to the stored value as a string, or null if the key doesn't exist.
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Stores a key-value pair in local storage.
+     * @param key - The key under which to store the value.
+     * @param value - The value to be stored.
+     * @returns A promise that resolves when the value has been successfully stored.
+     */
+    set(key: string, value: string): Promise<void>;
+    /**
+     * Removes the key-value pair associated with the specified key from local storage.
+     * @param key - The key of the item to be removed.
+     * @returns A promise that resolves when the item has been successfully removed.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Opens the specified URL in a new tab or window.
+     * @param url - The URL to open.
+     */
+    openLink(url: string): void;
+}

package/dist/session/backend.js

@@ -0,0 +1,38 @@
+/**
+ * Implements a local storage backend that conforms to the UnifiedBackend interface.
+ */
+export class LocalStorageBackend {
+    /**
+     * Retrieves the value associated with the specified key from local storage.
+     * @param key - The key to look up in local storage.
+     * @returns A promise that resolves to the stored value as a string, or null if the key doesn't exist.
+     */
+    async get(key) {
+        return localStorage.getItem(key);
+    }
+    /**
+     * Stores a key-value pair in local storage.
+     * @param key - The key under which to store the value.
+     * @param value - The value to be stored.
+     * @returns A promise that resolves when the value has been successfully stored.
+     */
+    async set(key, value) {
+        localStorage.setItem(key, value);
+    }
+    /**
+     * Removes the key-value pair associated with the specified key from local storage.
+     * @param key - The key of the item to be removed.
+     * @returns A promise that resolves when the item has been successfully removed.
+     */
+    async delete(key) {
+        localStorage.removeItem(key);
+    }
+    /**
+     * Opens the specified URL in a new tab or window.
+     * @param url - The URL to open.
+     */
+    openLink(url) {
+        window.open(url, "_blank");
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/session/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/session/backend.ts"],"names":[],"mappings":"AAiCA;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,GAAW;QAClB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;CACF"}

package/dist/session/index.d.ts

@@ -0,0 +1,5 @@
+export { default } from "./provider";
+export * from "./provider";
+export * from "../errors";
+export * from "../types";
+export { defaultPresets } from "../presets";

package/dist/session/index.js

@@ -0,0 +1,6 @@
+export { default } from "./provider";
+export * from "./provider";
+export * from "../errors";
+export * from "../types";
+export { defaultPresets } from "../presets";
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/session/provider.d.ts

@@ -0,0 +1,25 @@
+import { Policy } from "@cartridge/controller";
+import { WalletAccount } from "starknet";
+import SessionAccount from "./account";
+import BaseProvider from "../provider";
+export type SessionOptions = {
+    rpc: string;
+    chainId: string;
+    policies: Policy[];
+    redirectUrl: string;
+};
+export default class SessionProvider extends BaseProvider {
+    id: string;
+    name: string;
+    protected _chainId: string;
+    protected _username?: string;
+    protected _redirectUrl: string;
+    protected _policies: Policy[];
+    account?: SessionAccount;
+    constructor({ rpc, chainId, policies, redirectUrl }: SessionOptions);
+    username(): Promise<string | undefined>;
+    probe(): Promise<WalletAccount | undefined>;
+    connect(): Promise<WalletAccount | undefined>;
+    disconnect(): Promise<void>;
+    tryRetrieveFromQueryOrStorage(): Promise<SessionAccount | undefined>;
+}

package/dist/session/provider.js

@@ -0,0 +1,89 @@
+import { ec, stark } from "starknet";
+import SessionAccount from "./account";
+import { KEYCHAIN_URL } from "../constants";
+import BaseProvider from "../provider";
+export default class SessionProvider extends BaseProvider {
+    constructor({ rpc, chainId, policies, redirectUrl }) {
+        super({ rpc });
+        this.id = "controller_session";
+        this.name = "Controller Session";
+        this._chainId = chainId;
+        this._redirectUrl = redirectUrl;
+        this._policies = policies;
+        if (typeof window !== "undefined") {
+            window.starknet_controller_session = this;
+        }
+    }
+    async username() {
+        await this.tryRetrieveFromQueryOrStorage();
+        return this._username;
+    }
+    async probe() {
+        await this.tryRetrieveFromQueryOrStorage();
+        return;
+    }
+    async connect() {
+        await this.tryRetrieveFromQueryOrStorage();
+        if (this.account) {
+            return;
+        }
+        // Generate a random local key pair
+        const pk = stark.randomAddress();
+        const publicKey = ec.starkCurve.getStarkKey(pk);
+        localStorage.setItem("sessionSigner", JSON.stringify({
+            privKey: pk,
+            pubKey: publicKey,
+        }));
+        const url = `${KEYCHAIN_URL}/session?public_key=${publicKey}&redirect_uri=${this._redirectUrl}&redirect_query_name=startapp&policies=${JSON.stringify(this._policies)}&rpc_url=${this.rpc}`;
+        localStorage.setItem("lastUsedConnector", this.id);
+        window.open(url, "_blank");
+        return;
+    }
+    disconnect() {
+        localStorage.removeItem("sessionSigner");
+        localStorage.removeItem("session");
+        this.account = undefined;
+        this._username = undefined;
+        return Promise.resolve();
+    }
+    async tryRetrieveFromQueryOrStorage() {
+        const signerString = localStorage.getItem("sessionSigner");
+        const signer = signerString ? JSON.parse(signerString) : null;
+        let sessionRegistration = null;
+        if (window.location.search.includes("startapp")) {
+            const params = new URLSearchParams(window.location.search);
+            const session = params.get("startapp");
+            if (session) {
+                sessionRegistration = JSON.parse(atob(session));
+                localStorage.setItem("session", JSON.stringify(sessionRegistration));
+                // Remove the session query parameter
+                params.delete("startapp");
+                const newUrl = window.location.pathname +
+                    (params.toString() ? `?${params.toString()}` : "") +
+                    window.location.hash;
+                window.history.replaceState({}, document.title, newUrl);
+            }
+        }
+        if (!sessionRegistration) {
+            const sessionString = localStorage.getItem("session");
+            if (sessionString) {
+                sessionRegistration = JSON.parse(sessionString);
+            }
+        }
+        if (!sessionRegistration || !signer) {
+            return;
+        }
+        this._username = sessionRegistration.username;
+        this.account = new SessionAccount(this, {
+            rpcUrl: this.rpc.toString(),
+            privateKey: signer.privKey,
+            address: sessionRegistration.address,
+            ownerGuid: sessionRegistration.ownerGuid,
+            chainId: this._chainId,
+            expiresAt: parseInt(sessionRegistration.expiresAt),
+            policies: this._policies,
+        });
+        return this.account;
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/session/provider.js.map

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

package/dist/telegram/backend.d.ts

@@ -0,0 +1,30 @@
+import { UnifiedBackend } from "src/session/backend";
+/**
+ * Implements the UnifiedBackend interface for Telegram storage operations.
+ */
+export declare class TelegramBackend implements UnifiedBackend {
+    /**
+     * Retrieves the value associated with the specified key from Telegram cloud storage.
+     * @param key - The key to look up in the storage.
+     * @returns A promise that resolves to the stored value as a string, or null if the key doesn't exist.
+     */
+    get(key: string): Promise<string | null>;
+    /**
+     * Stores a key-value pair in Telegram cloud storage.
+     * @param key - The key under which to store the value.
+     * @param value - The value to be stored.
+     * @returns A promise that resolves when the value has been successfully stored.
+     */
+    set(key: string, value: string): Promise<void>;
+    /**
+     * Removes the key-value pair associated with the specified key from Telegram cloud storage.
+     * @param key - The key of the item to be removed.
+     * @returns A promise that resolves when the item has been successfully removed.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Opens the specified URL using Telegram's openLink function.
+     * @param url - The URL to open.
+     */
+    openLink(url: string): void;
+}

package/dist/telegram/backend.js

@@ -0,0 +1,39 @@
+import { cloudStorage, openLink } from "@telegram-apps/sdk";
+/**
+ * Implements the UnifiedBackend interface for Telegram storage operations.
+ */
+export class TelegramBackend {
+    /**
+     * Retrieves the value associated with the specified key from Telegram cloud storage.
+     * @param key - The key to look up in the storage.
+     * @returns A promise that resolves to the stored value as a string, or null if the key doesn't exist.
+     */
+    async get(key) {
+        return await cloudStorage.getItem(key);
+    }
+    /**
+     * Stores a key-value pair in Telegram cloud storage.
+     * @param key - The key under which to store the value.
+     * @param value - The value to be stored.
+     * @returns A promise that resolves when the value has been successfully stored.
+     */
+    async set(key, value) {
+        await cloudStorage.setItem(key, value);
+    }
+    /**
+     * Removes the key-value pair associated with the specified key from Telegram cloud storage.
+     * @param key - The key of the item to be removed.
+     * @returns A promise that resolves when the item has been successfully removed.
+     */
+    async delete(key) {
+        await cloudStorage.deleteItem(key);
+    }
+    /**
+     * Opens the specified URL using Telegram's openLink function.
+     * @param url - The URL to open.
+     */
+    openLink(url) {
+        openLink(url);
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/telegram/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/telegram/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG5D;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,GAAW;QAClB,QAAQ,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;CACF"}

package/dist/telegram/provider.d.ts

@@ -0,0 +1,19 @@
+import { WalletAccount } from "starknet";
+import { Policy } from "src/types";
+import BaseProvider from "src/provider";
+export default class TelegramProvider extends BaseProvider {
+    private _tmaUrl;
+    protected _chainId: string;
+    protected _username?: string;
+    protected _policies: Policy[];
+    constructor({ rpc, chainId, policies, tmaUrl, }: {
+        rpc: string;
+        chainId: string;
+        policies: Policy[];
+        tmaUrl: string;
+    });
+    probe(): Promise<WalletAccount | undefined>;
+    connect(): Promise<WalletAccount | undefined>;
+    disconnect(): Promise<void>;
+    tryRetrieveFromQueryOrStorage(): Promise<WalletAccount | undefined>;
+}

package/dist/telegram/provider.js

@@ -0,0 +1,78 @@
+import { cloudStorage, miniApp, openLink, retrieveLaunchParams, } from "@telegram-apps/sdk";
+import { ec, stark } from "starknet";
+import { KEYCHAIN_URL } from "src/constants";
+import SessionAccount from "src/session/account";
+import BaseProvider from "src/provider";
+export default class TelegramProvider extends BaseProvider {
+    constructor({ rpc, chainId, policies, tmaUrl, }) {
+        super({
+            rpc,
+        });
+        this._tmaUrl = tmaUrl;
+        this._chainId = chainId;
+        this._policies = policies;
+        if (typeof window !== "undefined") {
+            window.starknet_controller = this;
+        }
+    }
+    async probe() {
+        await this.tryRetrieveFromQueryOrStorage();
+        return;
+    }
+    async connect() {
+        await this.tryRetrieveFromQueryOrStorage();
+        if (this.account) {
+            return;
+        }
+        // Generate a random local key pair
+        const pk = stark.randomAddress();
+        const publicKey = ec.starkCurve.getStarkKey(pk);
+        cloudStorage.setItem("sessionSigner", JSON.stringify({
+            privKey: pk,
+            pubKey: publicKey,
+        }));
+        const url = `${KEYCHAIN_URL}/session?public_key=${publicKey}&redirect_uri=${this._tmaUrl}&redirect_query_name=startapp&policies=${JSON.stringify(this._policies)}&rpc_url=${this.rpc}`;
+        localStorage.setItem("lastUsedConnector", this.id);
+        openLink(url);
+        miniApp.close();
+        return;
+    }
+    disconnect() {
+        cloudStorage.deleteItem("sessionSigner");
+        cloudStorage.deleteItem("session");
+        this.account = undefined;
+        this._username = undefined;
+        return Promise.resolve();
+    }
+    async tryRetrieveFromQueryOrStorage() {
+        const signer = JSON.parse((await cloudStorage.getItem("sessionSigner")));
+        let sessionRegistration = null;
+        const launchParams = retrieveLaunchParams();
+        const session = launchParams.startParam;
+        if (session) {
+            sessionRegistration = JSON.parse(atob(session));
+            cloudStorage.setItem("session", JSON.stringify(sessionRegistration));
+        }
+        if (!sessionRegistration) {
+            const session = await cloudStorage.getItem("session");
+            if (session) {
+                sessionRegistration = JSON.parse(session);
+            }
+        }
+        if (!sessionRegistration) {
+            return;
+        }
+        this._username = sessionRegistration.username;
+        this.account = new SessionAccount(this, {
+            rpcUrl: this.rpc.toString(),
+            privateKey: signer.privKey,
+            address: sessionRegistration.address,
+            ownerGuid: sessionRegistration.ownerGuid,
+            chainId: this._chainId,
+            expiresAt: parseInt(sessionRegistration.expiresAt),
+            policies: this._policies,
+        });
+        return this.account;
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/telegram/provider.js.map

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