@cartridge/controller-wasm 0.7.14-0df5a4c → 0.7.14-3b036eb

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cartridge/controller-wasm",
-  "version": "0.7.14-0df5a4c",
+  "version": "0.7.14-3b036eb",
   "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,25 +1,11 @@
 /* tslint:disable */
 /* eslint-disable */
-export interface JsCall {
-    contractAddress: JsFelt;
-    entrypoint: string;
-    calldata: JsFelt[];
-}
-
-export type JsPriceUnit = "WEI" | "FRI";
-
-export interface JsEstimateFeeDetails {
-    nonce: JsFelt;
-}
-
-export interface JsFeeEstimate {
-    l1_gas_consumed: number;
-    l1_gas_price: number;
-    l2_gas_consumed: number;
-    l2_gas_price: number;
-    l1_data_gas_consumed: number;
-    l1_data_gas_price: number;
-    overall_fee: number;
+/**
+ * Result type for signExecuteFromOutside containing both the OutsideExecution and signature
+ */
+export interface JsSignedOutsideExecution {
+    outside_execution: JsOutsideExecutionV3;
+    signature: JsFelt[];
 }
 
 /**
@@ -33,12 +19,16 @@ export interface JsOutsideExecutionV3 {
     nonce: [JsFelt, JsFelt];
 }
 
-/**
- * Result type for signExecuteFromOutside containing both the OutsideExecution and signature
- */
-export interface JsSignedOutsideExecution {
-    outside_execution: JsOutsideExecutionV3;
-    signature: JsFelt[];
+export type Felts = JsFelt[];
+
+export type JsFelt = Felt;
+
+export type JsFeeSource = "PAYMASTER" | "CREDITS";
+
+export interface JsCall {
+    contractAddress: JsFelt;
+    entrypoint: string;
+    calldata: JsFelt[];
 }
 
 export interface Owner {
@@ -46,10 +36,12 @@ export interface Owner {
     account?: JsFelt;
 }
 
-export interface CallPolicy {
+export type Policy = CallPolicy | TypedDataPolicy | ApprovalPolicy;
+
+export interface ApprovalPolicy {
     target: JsFelt;
-    method: JsFelt;
-    authorized?: boolean;
+    spender: JsFelt;
+    amount: JsFelt;
 }
 
 export interface TypedDataPolicy {
@@ -57,28 +49,18 @@ export interface TypedDataPolicy {
     authorized?: boolean;
 }
 
-export interface ApprovalPolicy {
+export interface CallPolicy {
     target: JsFelt;
-    spender: JsFelt;
-    amount: JsFelt;
-}
-
-export type Policy = CallPolicy | TypedDataPolicy | ApprovalPolicy;
-
-export type JsRegister = RegisterInput;
-
-export type JsRegisterResponse = ResponseData;
-
-export interface WebauthnSigner {
-    rpId: string;
-    credentialId: string;
-    publicKey: string;
+    method: JsFelt;
+    authorized?: boolean;
 }
 
 export interface StarknetSigner {
     privateKey: JsFelt;
 }
 
+export type JsAddSignerInput = SignerInput;
+
 export interface Eip191Signer {
     address: string;
 }
@@ -90,20 +72,14 @@ export interface Signer {
     eip191?: Eip191Signer;
 }
 
-export type JsAddSignerInput = SignerInput;
+export interface WebauthnSigner {
+    rpId: string;
+    credentialId: string;
+    publicKey: string;
+}
 
 export type JsRemoveSignerInput = SignerInput;
 
-export type JsFelt = Felt;
-
-export type Felts = JsFelt[];
-
-export type JsFeeSource = "PAYMASTER" | "CREDITS";
-
-export type JsSubscribeSessionResult = SubscribeCreateSessionSubscribeCreateSession;
-
-export type JsRevokableSession = RevokableSession;
-
 export interface AuthorizedSession {
     session: Session;
     authorization: JsFelt[] | null;
@@ -115,6 +91,10 @@ export interface AuthorizedSession {
     guardianKeyGuid: JsFelt;
 }
 
+export type JsSubscribeSessionResult = SubscribeCreateSessionSubscribeCreateSession;
+
+export type JsRevokableSession = RevokableSession;
+
 export interface Session {
     policies: Policy[];
     expiresAt: number;
@@ -128,21 +108,34 @@ export interface Credentials {
     privateKey: JsFelt;
 }
 
+export interface JsEstimateFeeDetails {
+    nonce: JsFelt;
+}
+
+export interface JsFeeEstimate {
+    l1_gas_consumed: number;
+    l1_gas_price: number;
+    l2_gas_consumed: number;
+    l2_gas_price: number;
+    l1_data_gas_consumed: number;
+    l1_data_gas_price: number;
+    overall_fee: number;
+}
+
+export type JsPriceUnit = "WEI" | "FRI";
+
+export type JsRegisterResponse = ResponseData;
+
+export type JsRegister = RegisterInput;
+
 
 export class CartridgeAccount {
   private constructor();
   free(): void;
   [Symbol.dispose](): void;
-  /**
-   * Creates a new `CartridgeAccount` instance.
-   *
-   * # Parameters
-   * - `rpc_url`: The URL of the JSON-RPC endpoint.
-   * - `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(class_hash: JsFelt, rpc_url: string, address: JsFelt, username: string, owner: Owner, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
+  disconnect(): Promise<void>;
+  deploySelf(max_fee?: JsFeeEstimate | null): Promise<any>;
+  static fromStorage(cartridge_api_url: string): Promise<CartridgeAccountWithMeta | undefined>;
   /**
    * Creates a new `CartridgeAccount` instance with a randomly generated Starknet signer.
    * The controller address is computed internally based on the generated signer.
@@ -152,32 +145,31 @@ export class CartridgeAccount {
    * - `username`: Username associated with the account.
    */
   static newHeadless(class_hash: JsFelt, rpc_url: string, username: string, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
-  static fromStorage(cartridge_api_url: string): Promise<CartridgeAccountWithMeta | undefined>;
-  disconnect(): Promise<void>;
-  registerSession(app_id: string, 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>;
-  upgrade(new_class_hash: JsFelt): Promise<JsCall>;
-  register(register: JsRegister): Promise<JsRegisterResponse>;
-  createSession(app_id: string, policies: Policy[], expires_at: bigint, authorize_user_execution?: boolean | null): Promise<AuthorizedSession | undefined>;
-  skipSession(app_id: string, policies: Policy[]): Promise<void>;
-  addOwner(owner?: Signer | null, signer_input?: JsAddSignerInput | null, rp_id?: string | null): Promise<void>;
   removeOwner(signer: JsRemoveSignerInput): Promise<void>;
-  createPasskeySigner(rp_id: string): Promise<JsAddSignerInput>;
-  estimateInvokeFee(calls: JsCall[]): Promise<JsFeeEstimate>;
-  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(app_id: string, calls: JsCall[], fee_source?: JsFeeSource | null): Promise<any>;
-  isRegisteredSessionAuthorized(policies: Policy[], public_key?: JsFelt | null): Promise<AuthorizedSession | undefined>;
-  hasRequestedSession(app_id: string, policies: Policy[]): Promise<boolean>;
+  signMessage(typed_data: string): Promise<Felts>;
+  skipSession(app_id: string, policies: Policy[]): Promise<void>;
+  createSession(app_id: string, policies: Policy[], expires_at: bigint, authorize_user_execution?: boolean | null): Promise<AuthorizedSession | undefined>;
   revokeSession(session: JsRevokableSession): Promise<void>;
   revokeSessions(sessions: JsRevokableSession[]): Promise<void>;
-  signMessage(typed_data: string): Promise<Felts>;
-  getNonce(): Promise<any>;
-  deploySelf(max_fee?: JsFeeEstimate | null): Promise<any>;
   delegateAccount(): Promise<JsFelt>;
-  hasAuthorizedPoliciesForCalls(app_id: string, calls: JsCall[]): Promise<boolean>;
-  hasAuthorizedPoliciesForMessage(app_id: string, typed_data: string): Promise<boolean>;
+  registerSession(app_id: string, policies: Policy[], expires_at: bigint, public_key: JsFelt, max_fee?: JsFeeEstimate | null): Promise<any>;
+  estimateInvokeFee(calls: JsCall[]): Promise<JsFeeEstimate>;
+  trySessionExecute(app_id: string, calls: JsCall[], fee_source?: JsFeeSource | null): Promise<any>;
+  createPasskeySigner(rp_id: string): Promise<JsAddSignerInput>;
+  hasRequestedSession(app_id: string, policies: Policy[]): Promise<boolean>;
+  executeFromOutsideV2(calls: JsCall[], fee_source?: JsFeeSource | null): Promise<any>;
+  executeFromOutsideV3(calls: JsCall[], fee_source?: JsFeeSource | null): Promise<any>;
+  /**
+   * Checks if there are stored policies for a given app_id.
+   *
+   * # Parameters
+   * - `app_id`: The application identifier to check for stored policies
+   *
+   * # Returns
+   * `true` if policies exist for the given app_id, `false` otherwise
+   */
+  hasPoliciesForAppId(app_id: string): Promise<boolean>;
+  registerSessionCalldata(policies: Policy[], expires_at: bigint, public_key: JsFelt): Promise<any>;
   /**
    * Signs an OutsideExecution V3 transaction and returns both the OutsideExecution object and its signature.
    *
@@ -188,37 +180,45 @@ export class CartridgeAccount {
    * A `JsSignedOutsideExecution` containing the OutsideExecution V3 object and its signature
    */
   signExecuteFromOutside(calls: JsCall[]): Promise<JsSignedOutsideExecution>;
+  isRegisteredSessionAuthorized(policies: Policy[], public_key?: JsFelt | null): Promise<AuthorizedSession | undefined>;
+  hasAuthorizedPoliciesForCalls(app_id: string, calls: JsCall[]): Promise<boolean>;
+  hasAuthorizedPoliciesForMessage(app_id: string, typed_data: string): Promise<boolean>;
   /**
-   * Checks if there are stored policies for a given app_id.
+   * Creates a new `CartridgeAccount` instance.
    *
    * # Parameters
-   * - `app_id`: The application identifier to check for stored policies
-   *
-   * # Returns
-   * `true` if policies exist for the given app_id, `false` otherwise
+   * - `rpc_url`: The URL of the JSON-RPC endpoint.
+   * - `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.
    */
-  hasPoliciesForAppId(app_id: string): Promise<boolean>;
+  static new(class_hash: JsFelt, rpc_url: string, address: JsFelt, username: string, owner: Owner, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
+  execute(calls: JsCall[], max_fee?: JsFeeEstimate | null, fee_source?: JsFeeSource | null): Promise<any>;
+  upgrade(new_class_hash: JsFelt): Promise<JsCall>;
+  register(register: JsRegister): Promise<JsRegisterResponse>;
+  addOwner(owner?: Signer | null, signer_input?: JsAddSignerInput | null, rp_id?: string | null): Promise<void>;
+  getNonce(): Promise<any>;
 }
 
 export class CartridgeAccountMeta {
   private constructor();
   free(): void;
   [Symbol.dispose](): void;
-  username(): string;
-  address(): string;
   classHash(): string;
+  ownerGuid(): JsFelt;
+  owner(): Owner;
+  address(): string;
   rpcUrl(): string;
   chainId(): string;
-  owner(): Owner;
-  ownerGuid(): JsFelt;
+  username(): string;
 }
 
 export class CartridgeAccountWithMeta {
   private constructor();
   free(): void;
   [Symbol.dispose](): void;
-  meta(): CartridgeAccountMeta;
   intoAccount(): CartridgeAccount;
+  meta(): CartridgeAccountMeta;
 }
 
 export class ControllerFactory {
@@ -342,9 +342,9 @@ export class JsChainConfig {
   [Symbol.dispose](): void;
   constructor(class_hash: JsFelt, rpc_url: string, owner: Owner, address?: JsFelt | null);
   readonly class_hash: JsFelt;
-  readonly rpc_url: string;
   readonly owner: Owner;
   readonly address: JsFelt | undefined;
+  readonly rpc_url: string;
 }
 
 export class JsControllerError {
@@ -369,33 +369,33 @@ export class MultiChainAccount {
   free(): void;
   [Symbol.dispose](): void;
   /**
-   * Creates a new MultiChainAccount with multiple chain configurations
+   * Gets an account instance for a specific chain
    */
-  static create(username: string, chain_configs: JsChainConfig[], cartridge_api_url: string): Promise<MultiChainAccount>;
+  controller(chain_id: JsFelt): Promise<CartridgeAccount>;
   /**
    * Loads a MultiChainAccount from storage
    */
   static fromStorage(cartridge_api_url: string): Promise<MultiChainAccount | undefined>;
-  /**
-   * Adds a new chain configuration
-   */
-  addChain(config: JsChainConfig): Promise<void>;
   /**
    * Removes a chain configuration
    */
   removeChain(chain_id: JsFelt): Promise<void>;
   /**
-   * Gets an account instance for a specific chain
+   * Creates a new MultiChainAccount with multiple chain configurations
    */
-  controller(chain_id: JsFelt): Promise<CartridgeAccount>;
+  static create(username: string, chain_configs: JsChainConfig[], cartridge_api_url: string): Promise<MultiChainAccount>;
+  /**
+   * Adds a new chain configuration
+   */
+  addChain(config: JsChainConfig): Promise<void>;
 }
 
 export class MultiChainAccountMeta {
   private constructor();
   free(): void;
   [Symbol.dispose](): void;
-  readonly username: string;
   readonly chains: JsFelt[];
+  readonly username: string;
 }
 
 /**