@cartridge/controller-wasm 0.3.5 → 0.3.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cartridge/controller-wasm",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "Wasm bindings for Cartridge Controller and Session Account",
   "type": "module",
   "main": "./pkg-controller/account_wasm.js",

package/pkg-controller/account_wasm.d.ts

@@ -1,6 +1,5 @@
 /* tslint:disable */
 /* eslint-disable */
-export function signerToGuid(signer: Signer): JsFelt;
 /**
  * Computes the Starknet contract address for a controller account without needing a full instance.
  *
@@ -15,6 +14,13 @@ export function signerToGuid(signer: Signer): JsFelt;
  * The computed Starknet contract address as a `JsFelt`.
  */
 export function computeAccountAddress(class_hash: JsFelt, owner: Owner, salt: JsFelt): JsFelt;
+/**
+ * Subscribes to the creation of a session for a given controller, session_key_guid and cartridge api url.
+ * The goal of this function is to know from any place when the register session flow has been completed, and to
+ * get the authorization.
+ */
+export function subscribeCreateSession(session_key_guid: JsFelt, cartridge_api_url: string): Promise<JsSubscribeSessionResult>;
+export function signerToGuid(signer: Signer): JsFelt;
 export enum ErrorCode {
   StarknetFailedToReceiveTransaction = 1,
   StarknetContractNotFound = 20,
@@ -84,6 +90,8 @@ export enum ErrorCode {
   TransactionTimeout = 139,
   ConversionError = 140,
   InvalidChainId = 141,
+  SessionRefreshRequired = 142,
+  ManualExecutionRequired = 143,
 }
 export interface JsCall {
     contractAddress: JsFelt;
@@ -179,7 +187,7 @@ export type Felts = JsFelt[];
 
 export type JsFeeSource = "PAYMASTER" | "CREDITS";
 
-export type JsSubscribeSessionResult = ResponseData;
+export type JsSubscribeSessionResult = SubscribeCreateSessionSubscribeCreateSession;
 
 export type JsRevokableSession = RevokableSession;
 
@@ -210,18 +218,18 @@ export interface Credentials {
 export class CartridgeAccount {
   private constructor();
   free(): void;
+  [Symbol.dispose](): void;
   /**
    * Creates a new `CartridgeAccount` instance.
    *
    * # Parameters
    * - `app_id`: Application identifier.
    * - `rpc_url`: The URL of the JSON-RPC endpoint.
-   * - `chain_id`: Identifier of the blockchain network to interact with.
    * - `address`: The blockchain address associated with the account.
    * - `username`: Username associated with the account.
    * - `owner`: A Owner struct containing the owner signer and associated data.
    */
-  static new(app_id: string, class_hash: JsFelt, rpc_url: string, chain_id: JsFelt, address: JsFelt, username: string, owner: Owner, cartridge_api_url: string): CartridgeAccountWithMeta;
+  static new(app_id: string, class_hash: JsFelt, rpc_url: string, address: JsFelt, username: string, owner: Owner, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
   /**
    * Creates a new `CartridgeAccount` instance with a randomly generated Starknet signer.
    * The controller address is computed internally based on the generated signer.
@@ -229,11 +237,10 @@ export class CartridgeAccount {
    * # Parameters
    * - `app_id`: Application identifier.
    * - `rpc_url`: The URL of the JSON-RPC endpoint.
-   * - `chain_id`: Identifier of the blockchain network to interact with.
    * - `username`: Username associated with the account.
    */
-  static newHeadless(app_id: string, class_hash: JsFelt, rpc_url: string, chain_id: JsFelt, username: string, cartridge_api_url: string): CartridgeAccountWithMeta;
-  static fromStorage(app_id: string, cartridge_api_url: string): CartridgeAccountWithMeta | undefined;
+  static newHeadless(app_id: string, class_hash: JsFelt, rpc_url: string, username: string, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
+  static fromStorage(app_id: string, cartridge_api_url: string): Promise<CartridgeAccountWithMeta | undefined>;
   disconnect(): Promise<void>;
   registerSession(policies: Policy[], expires_at: bigint, public_key: JsFelt, max_fee?: JsFeeEstimate | null): Promise<any>;
   registerSessionCalldata(policies: Policy[], expires_at: bigint, public_key: JsFelt): Promise<any>;
@@ -248,6 +255,7 @@ export class CartridgeAccount {
   execute(calls: JsCall[], max_fee?: JsFeeEstimate | null, fee_source?: JsFeeSource | null): Promise<any>;
   executeFromOutsideV2(calls: JsCall[], fee_source?: JsFeeSource | null): Promise<any>;
   executeFromOutsideV3(calls: JsCall[], fee_source?: JsFeeSource | null): Promise<any>;
+  trySessionExecute(calls: JsCall[], fee_source?: JsFeeSource | null): Promise<any>;
   isRegisteredSessionAuthorized(policies: Policy[], public_key?: JsFelt | null): Promise<AuthorizedSession | undefined>;
   hasRequestedSession(policies: Policy[]): Promise<boolean>;
   revokeSession(session: JsRevokableSession): Promise<void>;
@@ -258,7 +266,6 @@ export class CartridgeAccount {
   delegateAccount(): Promise<JsFelt>;
   hasAuthorizedPoliciesForCalls(calls: JsCall[]): Promise<boolean>;
   hasAuthorizedPoliciesForMessage(typed_data: string): Promise<boolean>;
-  subscribeCreateSession(controller_id: string, session_key_guid: JsFelt): Promise<JsSubscribeSessionResult>;
   /**
    * Signs an OutsideExecution V3 transaction and returns both the OutsideExecution object and its signature.
    *
@@ -286,6 +293,7 @@ export class CartridgeAccount {
 export class CartridgeAccountMeta {
   private constructor();
   free(): void;
+  [Symbol.dispose](): void;
   appId(): string;
   username(): string;
   address(): string;
@@ -305,22 +313,25 @@ export class CartridgeAccountMeta {
 export class CartridgeAccountWithMeta {
   private constructor();
   free(): void;
+  [Symbol.dispose](): void;
   meta(): CartridgeAccountMeta;
   intoAccount(): CartridgeAccount;
 }
 export class ControllerFactory {
   private constructor();
   free(): void;
-  static fromStorage(app_id: string, cartridge_api_url: string): CartridgeAccountWithMeta | undefined;
-  static login(app_id: string, username: string, class_hash: JsFelt, rpc_url: string, chain_id: JsFelt, address: JsFelt, owner: Owner, cartridge_api_url: string, session_expires_at_s: bigint, is_controller_registered?: boolean | null): Promise<LoginResult>;
+  [Symbol.dispose](): void;
+  static fromStorage(app_id: string, cartridge_api_url: string): Promise<CartridgeAccountWithMeta | undefined>;
+  static login(app_id: string, username: string, class_hash: JsFelt, rpc_url: string, address: JsFelt, owner: Owner, cartridge_api_url: string, session_expires_at_s: bigint, is_controller_registered?: boolean | null): Promise<LoginResult>;
   /**
    * This should only be used with webauthn signers
    */
-  static apiLogin(app_id: string, username: string, class_hash: JsFelt, rpc_url: string, chain_id: JsFelt, address: JsFelt, owner: Owner, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
+  static apiLogin(app_id: string, username: string, class_hash: JsFelt, rpc_url: string, address: JsFelt, owner: Owner, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
 }
 export class JsControllerError {
   private constructor();
   free(): void;
+  [Symbol.dispose](): void;
   code: ErrorCode;
   message: string;
   get data(): string | undefined;
@@ -329,5 +340,6 @@ export class JsControllerError {
 export class LoginResult {
   private constructor();
   free(): void;
+  [Symbol.dispose](): void;
   intoValues(): Array<any>;
 }