@cartridge/controller-wasm 0.9.0 → 0.9.2

package/pkg-controller/account_wasm.d.ts

@@ -19,21 +19,21 @@ export interface JsSignedOutsideExecution {
     signature: JsFelt[];
 }
 
-export type JsFeeSource = "PAYMASTER" | "CREDITS";
-
-export type Felts = JsFelt[];
-
-export type JsFelt = Felt;
-
-export interface JsCall {
-    contractAddress: JsFelt;
-    entrypoint: string;
-    calldata: JsFelt[];
+export interface ApprovalPolicy {
+    target: JsFelt;
+    spender: JsFelt;
+    amount: JsFelt;
 }
 
-export interface Owner {
-    signer?: Signer;
-    account?: JsFelt;
+export interface AuthorizedSession {
+    session: Session;
+    authorization: JsFelt[] | null;
+    isRegistered: boolean;
+    expiresAt: number;
+    allowedPoliciesRoot: JsFelt;
+    metadataHash: JsFelt;
+    sessionKeyGuid: JsFelt;
+    guardianKeyGuid: JsFelt;
 }
 
 export interface CallPolicy {
@@ -42,46 +42,40 @@ export interface CallPolicy {
     authorized?: boolean;
 }
 
-export interface TypedDataPolicy {
-    scope_hash: JsFelt;
-    authorized?: boolean;
+export interface Credentials {
+    authorization: JsFelt[];
+    privateKey: JsFelt;
 }
 
-export interface ApprovalPolicy {
-    target: JsFelt;
-    spender: JsFelt;
-    amount: JsFelt;
+export interface Eip191Signer {
+    address: string;
 }
 
-export type Policy = CallPolicy | TypedDataPolicy | ApprovalPolicy;
-
-export type JsAddSignerInput = SignerInput;
-
-export interface WebauthnSigner {
-    rpId: string;
-    credentialId: string;
-    publicKey: string;
+export interface JsCall {
+    contractAddress: JsFelt;
+    entrypoint: string;
+    calldata: JsFelt[];
 }
 
-export interface Signer {
-    webauthns?: WebauthnSigner[];
-    webauthn?: WebauthnSigner;
-    starknet?: StarknetSigner;
-    eip191?: Eip191Signer;
+export interface JsEstimateFeeDetails {
+    nonce: JsFelt;
 }
 
-export type JsRemoveSignerInput = SignerInput;
-
-export interface StarknetSigner {
-    privateKey: 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 interface Eip191Signer {
-    address: string;
+export interface Owner {
+    signer?: Signer;
+    account?: JsFelt;
 }
 
-export type JsRevokableSession = RevokableSession;
-
 export interface Session {
     policies: Policy[];
     expiresAt: number;
@@ -90,312 +84,347 @@ export interface Session {
     guardianKeyGuid: JsFelt;
 }
 
-export interface Credentials {
-    authorization: JsFelt[];
-    privateKey: JsFelt;
+export interface Signer {
+    webauthns?: WebauthnSigner[];
+    webauthn?: WebauthnSigner;
+    starknet?: StarknetSigner;
+    eip191?: Eip191Signer;
 }
 
-export type JsSubscribeSessionResult = SubscribeCreateSessionSubscribeCreateSession;
+export interface StarknetSigner {
+    privateKey: JsFelt;
+}
 
-export interface AuthorizedSession {
-    session: Session;
-    authorization: JsFelt[] | null;
-    isRegistered: boolean;
-    expiresAt: number;
-    allowedPoliciesRoot: JsFelt;
-    metadataHash: JsFelt;
-    sessionKeyGuid: JsFelt;
-    guardianKeyGuid: JsFelt;
+export interface TypedDataPolicy {
+    scope_hash: JsFelt;
+    authorized?: boolean;
 }
 
-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 interface WebauthnSigner {
+    rpId: string;
+    credentialId: string;
+    publicKey: string;
 }
 
-export type JsPriceUnit = "WEI" | "FRI";
+export type Felts = JsFelt[];
 
-export interface JsEstimateFeeDetails {
-    nonce: JsFelt;
-}
+export type JsAddSignerInput = SignerInput;
+
+export type JsFeeSource = "PAYMASTER" | "CREDITS";
+
+export type JsFelt = Felt;
+
+export type JsPriceUnit = "WEI" | "FRI";
 
 export type JsRegister = RegisterInput;
 
 export type JsRegisterResponse = ResponseData;
 
+export type JsRemoveSignerInput = SignerInput;
+
+export type JsRevokableSession = RevokableSession;
+
+export type JsSubscribeSessionResult = SubscribeCreateSessionSubscribeCreateSession;
+
+export type Policy = CallPolicy | TypedDataPolicy | ApprovalPolicy;
+
 
 export class CartridgeAccount {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  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.
-   *
-   * # Parameters
-   * - `rpc_url`: The URL of the JSON-RPC endpoint.
-   * - `username`: Username associated with the account.
-   */
-  static newHeadless(class_hash: JsFelt, rpc_url: string, username: string, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
-  removeOwner(signer: JsRemoveSignerInput): Promise<void>;
-  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>;
-  delegateAccount(): Promise<JsFelt>;
-  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.
-   *
-   * # Parameters
-   * - `calls`: Array of calls to execute from outside
-   *
-   * # Returns
-   * 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>;
-  /**
-   * 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>;
-  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>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    addOwner(owner?: Signer | null, signer_input?: JsAddSignerInput | null, rp_id?: string | null): Promise<void>;
+    createPasskeySigner(rp_id: string): Promise<JsAddSignerInput>;
+    createSession(app_id: string, policies: Policy[], expires_at: bigint, authorize_user_execution?: boolean | null): Promise<AuthorizedSession | undefined>;
+    delegateAccount(): Promise<JsFelt>;
+    deploySelf(max_fee?: JsFeeEstimate | null): Promise<any>;
+    disconnect(): Promise<void>;
+    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>;
+    static fromStorage(cartridge_api_url: string): Promise<CartridgeAccountWithMeta | undefined>;
+    getNonce(): Promise<any>;
+    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.
+     *
+     * # 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>;
+    hasRequestedSession(app_id: string, policies: Policy[]): Promise<boolean>;
+    isRegisteredSessionAuthorized(policies: Policy[], public_key?: JsFelt | null): Promise<AuthorizedSession | undefined>;
+    /**
+     * 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>;
+    /**
+     * Creates a new `CartridgeAccount` instance with a randomly generated Starknet signer.
+     * The controller address is computed internally based on the generated signer.
+     *
+     * # Parameters
+     * - `rpc_url`: The URL of the JSON-RPC endpoint.
+     * - `username`: Username associated with the account.
+     */
+    static newHeadless(class_hash: JsFelt, rpc_url: string, username: string, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
+    register(register: JsRegister): Promise<JsRegisterResponse>;
+    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>;
+    removeOwner(signer: JsRemoveSignerInput): Promise<void>;
+    revokeSession(session: JsRevokableSession): Promise<void>;
+    revokeSessions(sessions: JsRevokableSession[]): Promise<void>;
+    /**
+     * Signs an OutsideExecution V3 transaction and returns both the OutsideExecution object and its signature.
+     *
+     * # Parameters
+     * - `calls`: Array of calls to execute from outside
+     *
+     * # Returns
+     * A `JsSignedOutsideExecution` containing the OutsideExecution V3 object and its signature
+     */
+    signExecuteFromOutside(calls: JsCall[]): Promise<JsSignedOutsideExecution>;
+    signMessage(typed_data: string): Promise<Felts>;
+    skipSession(app_id: string, policies: Policy[]): Promise<void>;
+    trySessionExecute(app_id: string, calls: JsCall[], fee_source?: JsFeeSource | null): Promise<any>;
+    upgrade(new_class_hash: JsFelt): Promise<JsCall>;
 }
 
+/**
+ * A type for accessing fixed attributes of `CartridgeAccount`.
+ *
+ * This type exists as concurrent mutable and immutable calls to `CartridgeAccount` are guarded
+ * with `WasmMutex`, which only operates under an `async` context. If these getters were directly
+ * implemented under `CartridgeAccount`:
+ *
+ * - calls to them would unnecessarily have to be `async` as well;
+ * - there would be excessive locking.
+ *
+ * This type is supposed to only ever be borrowed immutably. So no concurrent access control would
+ * be needed.
+ */
 export class CartridgeAccountMeta {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  classHash(): string;
-  ownerGuid(): JsFelt;
-  owner(): Owner;
-  address(): string;
-  rpcUrl(): string;
-  chainId(): string;
-  username(): string;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    address(): string;
+    chainId(): string;
+    classHash(): string;
+    owner(): Owner;
+    ownerGuid(): JsFelt;
+    rpcUrl(): string;
+    username(): string;
 }
 
+/**
+ * A type used as the return type for constructing `CartridgeAccount` to provide an extra,
+ * separately borrowable `meta` field for synchronously accessing fixed fields.
+ *
+ * This type exists instead of simply having `CartridgeAccount::new()` return a tuple as tuples
+ * don't implement `IntoWasmAbi` which is needed for crossing JS-WASM boundary.
+ */
 export class CartridgeAccountWithMeta {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  intoAccount(): CartridgeAccount;
-  meta(): CartridgeAccountMeta;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    intoAccount(): CartridgeAccount;
+    meta(): CartridgeAccountMeta;
 }
 
 export class ControllerFactory {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  static fromStorage(cartridge_api_url: string): Promise<CartridgeAccountWithMeta | undefined>;
-  /**
-   * Login to an existing controller account.
-   *
-   * # Parameters
-   *
-   * * `create_wildcard_session` - Whether to create a wildcard session on login. Defaults to `true`
-   *   for backward compatibility. Set to `false` when using the `register_session` flow where
-   *   specific policies will be registered instead of using a wildcard session.
-   *
-   * # Returns
-   *
-   * Returns a `LoginResult` containing:
-   * * `account` - The controller account
-   * * `session` - Optional session (Some if `create_wildcard_session` is true, None otherwise)
-   *
-   * # Testing
-   *
-   * The core logic is tested in the SDK layer:
-   * * `account_sdk::tests::session_test::test_wildcard_session_creation` - Tests session creation
-   * * `account_sdk::tests::session_test::test_login_with_wildcard_session_and_execute` - Tests login with session + execution
-   * * `account_sdk::tests::session_test::test_login_without_session_can_still_execute` - Tests login without session + execution
-   *
-   * The WASM layer is a thin wrapper that:
-   * 1. Converts WASM types to SDK types
-   * 2. Calls `Controller::new` and optionally `create_wildcard_session`
-   * 3. Handles WebAuthn signer updates when multiple signers are present
-   * 4. Registers the session with Cartridge API if requested
-   */
-  static login(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, create_wildcard_session?: boolean | null, app_id?: string | null): Promise<LoginResult>;
-  /**
-   * This should only be used with webauthn signers
-   */
-  static apiLogin(username: string, class_hash: JsFelt, rpc_url: string, address: JsFelt, owner: Owner, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * This should only be used with webauthn signers
+     */
+    static apiLogin(username: string, class_hash: JsFelt, rpc_url: string, address: JsFelt, owner: Owner, cartridge_api_url: string): Promise<CartridgeAccountWithMeta>;
+    static fromStorage(cartridge_api_url: string): Promise<CartridgeAccountWithMeta | undefined>;
+    /**
+     * Login to an existing controller account.
+     *
+     * # Parameters
+     *
+     * * `create_wildcard_session` - Whether to create a wildcard session on login. Defaults to `true`
+     *   for backward compatibility. Set to `false` when using the `register_session` flow where
+     *   specific policies will be registered instead of using a wildcard session.
+     *
+     * # Returns
+     *
+     * Returns a `LoginResult` containing:
+     * * `account` - The controller account
+     * * `session` - Optional session (Some if `create_wildcard_session` is true, None otherwise)
+     *
+     * # Testing
+     *
+     * The core logic is tested in the SDK layer:
+     * * `account_sdk::tests::session_test::test_wildcard_session_creation` - Tests session creation
+     * * `account_sdk::tests::session_test::test_login_with_wildcard_session_and_execute` - Tests login with session + execution
+     * * `account_sdk::tests::session_test::test_login_without_session_can_still_execute` - Tests login without session + execution
+     *
+     * The WASM layer is a thin wrapper that:
+     * 1. Converts WASM types to SDK types
+     * 2. Calls `Controller::new` and optionally `create_wildcard_session`
+     * 3. Handles WebAuthn signer updates when multiple signers are present
+     * 4. Registers the session with Cartridge API if requested
+     */
+    static login(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, create_wildcard_session?: boolean | null, app_id?: string | null): Promise<LoginResult>;
 }
 
 export enum ErrorCode {
-  StarknetFailedToReceiveTransaction = 1,
-  StarknetContractNotFound = 20,
-  StarknetBlockNotFound = 24,
-  StarknetInvalidTransactionIndex = 27,
-  StarknetClassHashNotFound = 28,
-  StarknetTransactionHashNotFound = 29,
-  StarknetPageSizeTooBig = 31,
-  StarknetNoBlocks = 32,
-  StarknetInvalidContinuationToken = 33,
-  StarknetTooManyKeysInFilter = 34,
-  StarknetContractError = 40,
-  StarknetTransactionExecutionError = 41,
-  StarknetClassAlreadyDeclared = 51,
-  StarknetInvalidTransactionNonce = 52,
-  StarknetInsufficientMaxFee = 53,
-  StarknetInsufficientAccountBalance = 54,
-  StarknetValidationFailure = 55,
-  StarknetCompilationFailed = 56,
-  StarknetContractClassSizeIsTooLarge = 57,
-  StarknetNonAccount = 58,
-  StarknetDuplicateTx = 59,
-  StarknetCompiledClassHashMismatch = 60,
-  StarknetUnsupportedTxVersion = 61,
-  StarknetUnsupportedContractClassVersion = 62,
-  StarknetUnexpectedError = 63,
-  StarknetNoTraceAvailable = 10,
-  StarknetReplacementTransactionUnderpriced = 64,
-  StarknetFeeBelowMinimum = 65,
-  SignError = 101,
-  StorageError = 102,
-  AccountFactoryError = 103,
-  PaymasterExecutionTimeNotReached = 104,
-  PaymasterExecutionTimePassed = 105,
-  PaymasterInvalidCaller = 106,
-  PaymasterRateLimitExceeded = 107,
-  PaymasterNotSupported = 108,
-  PaymasterHttp = 109,
-  PaymasterExcecution = 110,
-  PaymasterSerialization = 111,
-  CartridgeControllerNotDeployed = 112,
-  InsufficientBalance = 113,
-  OriginError = 114,
-  EncodingError = 115,
-  SerdeWasmBindgenError = 116,
-  CairoSerdeError = 117,
-  CairoShortStringToFeltError = 118,
-  DeviceCreateCredential = 119,
-  DeviceGetAssertion = 120,
-  DeviceBadAssertion = 121,
-  DeviceChannel = 122,
-  DeviceOrigin = 123,
-  AccountSigning = 124,
-  AccountProvider = 125,
-  AccountClassHashCalculation = 126,
-  AccountFeeOutOfRange = 128,
-  ProviderRateLimited = 129,
-  ProviderArrayLengthMismatch = 130,
-  ProviderOther = 131,
-  SessionAlreadyRegistered = 132,
-  UrlParseError = 133,
-  Base64DecodeError = 134,
-  CoseError = 135,
-  PolicyChainIdMismatch = 136,
-  InvalidOwner = 137,
-  GasPriceTooHigh = 138,
-  TransactionTimeout = 139,
-  ConversionError = 140,
-  InvalidChainId = 141,
-  SessionRefreshRequired = 142,
-  ManualExecutionRequired = 143,
-  ForbiddenEntrypoint = 144,
-  GasAmountTooHigh = 145,
-  ApproveExecutionRequired = 146,
+    StarknetFailedToReceiveTransaction = 1,
+    StarknetContractNotFound = 20,
+    StarknetBlockNotFound = 24,
+    StarknetInvalidTransactionIndex = 27,
+    StarknetClassHashNotFound = 28,
+    StarknetTransactionHashNotFound = 29,
+    StarknetPageSizeTooBig = 31,
+    StarknetNoBlocks = 32,
+    StarknetInvalidContinuationToken = 33,
+    StarknetTooManyKeysInFilter = 34,
+    StarknetContractError = 40,
+    StarknetTransactionExecutionError = 41,
+    StarknetClassAlreadyDeclared = 51,
+    StarknetInvalidTransactionNonce = 52,
+    StarknetInsufficientMaxFee = 53,
+    StarknetInsufficientAccountBalance = 54,
+    StarknetValidationFailure = 55,
+    StarknetCompilationFailed = 56,
+    StarknetContractClassSizeIsTooLarge = 57,
+    StarknetNonAccount = 58,
+    StarknetDuplicateTx = 59,
+    StarknetCompiledClassHashMismatch = 60,
+    StarknetUnsupportedTxVersion = 61,
+    StarknetUnsupportedContractClassVersion = 62,
+    StarknetUnexpectedError = 63,
+    StarknetNoTraceAvailable = 10,
+    StarknetReplacementTransactionUnderpriced = 64,
+    StarknetFeeBelowMinimum = 65,
+    SignError = 101,
+    StorageError = 102,
+    AccountFactoryError = 103,
+    PaymasterExecutionTimeNotReached = 104,
+    PaymasterExecutionTimePassed = 105,
+    PaymasterInvalidCaller = 106,
+    PaymasterRateLimitExceeded = 107,
+    PaymasterNotSupported = 108,
+    PaymasterHttp = 109,
+    PaymasterExcecution = 110,
+    PaymasterSerialization = 111,
+    CartridgeControllerNotDeployed = 112,
+    InsufficientBalance = 113,
+    OriginError = 114,
+    EncodingError = 115,
+    SerdeWasmBindgenError = 116,
+    CairoSerdeError = 117,
+    CairoShortStringToFeltError = 118,
+    DeviceCreateCredential = 119,
+    DeviceGetAssertion = 120,
+    DeviceBadAssertion = 121,
+    DeviceChannel = 122,
+    DeviceOrigin = 123,
+    AccountSigning = 124,
+    AccountProvider = 125,
+    AccountClassHashCalculation = 126,
+    AccountFeeOutOfRange = 128,
+    ProviderRateLimited = 129,
+    ProviderArrayLengthMismatch = 130,
+    ProviderOther = 131,
+    SessionAlreadyRegistered = 132,
+    UrlParseError = 133,
+    Base64DecodeError = 134,
+    CoseError = 135,
+    PolicyChainIdMismatch = 136,
+    InvalidOwner = 137,
+    GasPriceTooHigh = 138,
+    TransactionTimeout = 139,
+    ConversionError = 140,
+    InvalidChainId = 141,
+    SessionRefreshRequired = 142,
+    ManualExecutionRequired = 143,
+    ForbiddenEntrypoint = 144,
+    GasAmountTooHigh = 145,
+    ApproveExecutionRequired = 146,
 }
 
+/**
+ * JavaScript-friendly chain configuration
+ */
 export class JsChainConfig {
-  free(): void;
-  [Symbol.dispose](): void;
-  constructor(class_hash: JsFelt, rpc_url: string, owner: Owner, address?: JsFelt | null);
-  readonly class_hash: JsFelt;
-  readonly owner: Owner;
-  readonly address: JsFelt | undefined;
-  readonly rpc_url: string;
+    free(): void;
+    [Symbol.dispose](): void;
+    constructor(class_hash: JsFelt, rpc_url: string, owner: Owner, address?: JsFelt | null);
+    readonly address: JsFelt | undefined;
+    readonly class_hash: JsFelt;
+    readonly owner: Owner;
+    readonly rpc_url: string;
 }
 
 export class JsControllerError {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  code: ErrorCode;
-  message: string;
-  get data(): string | undefined;
-  set data(value: string | null | undefined);
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    code: ErrorCode;
+    get data(): string | undefined;
+    set data(value: string | null | undefined);
+    message: string;
 }
 
 export class LoginResult {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  intoValues(): Array<any>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    intoValues(): Array<any>;
 }
 
+/**
+ * WASM bindings for MultiChainController
+ */
 export class MultiChainAccount {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  /**
-   * Gets an account instance for a specific chain
-   */
-  controller(chain_id: JsFelt): Promise<CartridgeAccount>;
-  /**
-   * Loads a MultiChainAccount from storage
-   */
-  static fromStorage(cartridge_api_url: string): Promise<MultiChainAccount | undefined>;
-  /**
-   * Removes a chain configuration
-   */
-  removeChain(chain_id: JsFelt): Promise<void>;
-  /**
-   * Creates a new MultiChainAccount with multiple chain configurations
-   */
-  static create(username: string, chain_configs: JsChainConfig[], cartridge_api_url: string): Promise<MultiChainAccount>;
-  /**
-   * Adds a new chain configuration
-   */
-  addChain(config: JsChainConfig): Promise<void>;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Adds a new chain configuration
+     */
+    addChain(config: JsChainConfig): Promise<void>;
+    /**
+     * Gets an account instance for a specific chain
+     */
+    controller(chain_id: JsFelt): Promise<CartridgeAccount>;
+    /**
+     * Creates a new MultiChainAccount with multiple chain configurations
+     */
+    static create(username: string, chain_configs: JsChainConfig[], cartridge_api_url: string): Promise<MultiChainAccount>;
+    /**
+     * Loads a MultiChainAccount from storage
+     */
+    static fromStorage(cartridge_api_url: string): Promise<MultiChainAccount | undefined>;
+    /**
+     * Removes a chain configuration
+     */
+    removeChain(chain_id: JsFelt): Promise<void>;
 }
 
+/**
+ * Metadata for displaying multi-chain information
+ */
 export class MultiChainAccountMeta {
-  private constructor();
-  free(): void;
-  [Symbol.dispose](): void;
-  readonly chains: JsFelt[];
-  readonly username: string;
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly chains: JsFelt[];
+    readonly username: string;
 }
 
 /**