@frontiertower/frontier-sdk 0.10.0 → 0.11.1

package/README.md

@@ -58,6 +58,7 @@ Your app must declare required permissions in the Frontier app registry:
 - `wallet:transferNative` - Transfer native currency (ETH)
 - `wallet:transferFrontierDollar` - Transfer Frontier Dollars
 - `wallet:transferInternalFrontierDollar` - Transfer Internal Frontier Dollars
+- `wallet:transferOverallFrontierDollar` - Transfer Frontier Dollars with iFTD preferred
 - `wallet:executeCall` - Execute arbitrary contract calls
 - `wallet:executeBatchCall` - Execute multiple contract calls atomically
 - `wallet:getSupportedTokens` - Get list of supported tokens for swaps

package/dist/index.d.mts

@@ -354,6 +354,27 @@ declare class WalletAccess {
      * ```
      */
     transferInternalFrontierDollar(to: string, amount: string, overrides?: GasOverrides): Promise<UserOperationReceipt>;
+    /**
+     * Transfer Frontier Dollars with Internal Frontier Dollars (iFTD) preferred
+     *
+     * This method will use Internal Frontier Dollars first, and if insufficient,
+     * it will use regular Frontier Dollars to complete the transfer.
+     *
+     * @param to - Recipient address
+     * @param amount - Amount to send (as string, e.g., '10.5')
+     * @param overrides - Optional gas overrides
+     * @returns User operation receipt with transaction details
+     * @throws {Error} If insufficient total balance or transaction fails
+     *
+     * @example
+     * ```typescript
+     * const receipt = await sdk.getWallet().transferOverallFrontierDollar(
+     *   '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+     *   '10.5'
+     * );
+     * ```
+     */
+    transferOverallFrontierDollar(to: string, amount: string, overrides?: GasOverrides): Promise<UserOperationReceipt>;
     /**
      * Execute multiple calls atomically with a single signature
      *
@@ -481,6 +502,32 @@ declare class StorageAccess {
     clear(): Promise<void>;
 }
 
+/**
+ * Underlying currency type for stablecoins
+ */
+declare enum Underlying {
+    USD = "USD"
+}
+/**
+ * Token information
+ */
+interface Token {
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+    /** Token decimals */
+    decimals: number;
+    /** Token contract address */
+    address: string;
+}
+/**
+ * Stablecoin information extending Token
+ */
+interface StableCoin extends Token {
+    /** Underlying currency type */
+    underlying: Underlying;
+}
 /**
  * Chain configuration information
  */
@@ -491,19 +538,25 @@ interface ChainConfig {
     name: string;
     /** Network identifier */
     network: string;
+    /** Bridge swap router factory address */
+    bridgeSwapRouterFactoryAddress: string;
+    /** Uniswap V3 factory address */
+    uniswapV3FactoryAddress: string;
     /** Native currency information */
     nativeCurrency: {
         name: string;
         symbol: string;
         decimals: number;
     };
-    /** RPC URL */
-    rpcUrl: string;
     /** Block explorer information */
     blockExplorer: {
         name: string;
         url: string;
     };
+    /** Supported stablecoins on this chain */
+    stableCoins: StableCoin[];
+    /** Supported tokens on this chain */
+    supportedTokens: Token[];
     /** Whether this is a testnet */
     testnet: boolean;
 }
@@ -1545,4 +1598,4 @@ interface SDKResponse {
     error?: string;
 }
 
-export { type App, type AppPermission, type AppStatus, ChainAccess, type ChainConfig, type CreateAppRequest, type CreateSponsorPassRequest, type CreateWebhookRequest, type Developer, type ExecuteCall, FrontierSDK, type GasOverrides, type ListParams, type ListSponsorsParams, type PaginatedResponse, PartnershipsAccess, type ReferralDetails, type ReferralOverview, type RotateKeyResponse, type RotateWebhookKeyResponse, type SDKRequest, type SDKResponse, type SmartAccount, type Sponsor, type SponsorPass, StorageAccess, type SwapParams, type SwapQuote, type SwapResult, SwapResultStatus, ThirdPartyAccess, type UpdateAppRequest, type UpdateDeveloperRequest, type UpdateWebhookRequest, type User, UserAccess, type UserContact, type UserContactPayload, type UserOperationReceipt, type UserProfile, WalletAccess, type WalletBalance, type WalletBalanceFormatted, type Webhook, type WebhookConfig, type WebhookEvent, type WebhookScope, type WebhookStatus };
+export { type App, type AppPermission, type AppStatus, ChainAccess, type ChainConfig, type CreateAppRequest, type CreateSponsorPassRequest, type CreateWebhookRequest, type Developer, type ExecuteCall, FrontierSDK, type GasOverrides, type ListParams, type ListSponsorsParams, type PaginatedResponse, PartnershipsAccess, type ReferralDetails, type ReferralOverview, type RotateKeyResponse, type RotateWebhookKeyResponse, type SDKRequest, type SDKResponse, type SmartAccount, type Sponsor, type SponsorPass, type StableCoin, StorageAccess, type SwapParams, type SwapQuote, type SwapResult, SwapResultStatus, ThirdPartyAccess, type Token, Underlying, type UpdateAppRequest, type UpdateDeveloperRequest, type UpdateWebhookRequest, type User, UserAccess, type UserContact, type UserContactPayload, type UserOperationReceipt, type UserProfile, WalletAccess, type WalletBalance, type WalletBalanceFormatted, type Webhook, type WebhookConfig, type WebhookEvent, type WebhookScope, type WebhookStatus };

package/dist/index.d.ts

@@ -354,6 +354,27 @@ declare class WalletAccess {
      * ```
      */
     transferInternalFrontierDollar(to: string, amount: string, overrides?: GasOverrides): Promise<UserOperationReceipt>;
+    /**
+     * Transfer Frontier Dollars with Internal Frontier Dollars (iFTD) preferred
+     *
+     * This method will use Internal Frontier Dollars first, and if insufficient,
+     * it will use regular Frontier Dollars to complete the transfer.
+     *
+     * @param to - Recipient address
+     * @param amount - Amount to send (as string, e.g., '10.5')
+     * @param overrides - Optional gas overrides
+     * @returns User operation receipt with transaction details
+     * @throws {Error} If insufficient total balance or transaction fails
+     *
+     * @example
+     * ```typescript
+     * const receipt = await sdk.getWallet().transferOverallFrontierDollar(
+     *   '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+     *   '10.5'
+     * );
+     * ```
+     */
+    transferOverallFrontierDollar(to: string, amount: string, overrides?: GasOverrides): Promise<UserOperationReceipt>;
     /**
      * Execute multiple calls atomically with a single signature
      *
@@ -481,6 +502,32 @@ declare class StorageAccess {
     clear(): Promise<void>;
 }
 
+/**
+ * Underlying currency type for stablecoins
+ */
+declare enum Underlying {
+    USD = "USD"
+}
+/**
+ * Token information
+ */
+interface Token {
+    /** Token name */
+    name: string;
+    /** Token symbol */
+    symbol: string;
+    /** Token decimals */
+    decimals: number;
+    /** Token contract address */
+    address: string;
+}
+/**
+ * Stablecoin information extending Token
+ */
+interface StableCoin extends Token {
+    /** Underlying currency type */
+    underlying: Underlying;
+}
 /**
  * Chain configuration information
  */
@@ -491,19 +538,25 @@ interface ChainConfig {
     name: string;
     /** Network identifier */
     network: string;
+    /** Bridge swap router factory address */
+    bridgeSwapRouterFactoryAddress: string;
+    /** Uniswap V3 factory address */
+    uniswapV3FactoryAddress: string;
     /** Native currency information */
     nativeCurrency: {
         name: string;
         symbol: string;
         decimals: number;
     };
-    /** RPC URL */
-    rpcUrl: string;
     /** Block explorer information */
     blockExplorer: {
         name: string;
         url: string;
     };
+    /** Supported stablecoins on this chain */
+    stableCoins: StableCoin[];
+    /** Supported tokens on this chain */
+    supportedTokens: Token[];
     /** Whether this is a testnet */
     testnet: boolean;
 }
@@ -1545,4 +1598,4 @@ interface SDKResponse {
     error?: string;
 }
 
-export { type App, type AppPermission, type AppStatus, ChainAccess, type ChainConfig, type CreateAppRequest, type CreateSponsorPassRequest, type CreateWebhookRequest, type Developer, type ExecuteCall, FrontierSDK, type GasOverrides, type ListParams, type ListSponsorsParams, type PaginatedResponse, PartnershipsAccess, type ReferralDetails, type ReferralOverview, type RotateKeyResponse, type RotateWebhookKeyResponse, type SDKRequest, type SDKResponse, type SmartAccount, type Sponsor, type SponsorPass, StorageAccess, type SwapParams, type SwapQuote, type SwapResult, SwapResultStatus, ThirdPartyAccess, type UpdateAppRequest, type UpdateDeveloperRequest, type UpdateWebhookRequest, type User, UserAccess, type UserContact, type UserContactPayload, type UserOperationReceipt, type UserProfile, WalletAccess, type WalletBalance, type WalletBalanceFormatted, type Webhook, type WebhookConfig, type WebhookEvent, type WebhookScope, type WebhookStatus };
+export { type App, type AppPermission, type AppStatus, ChainAccess, type ChainConfig, type CreateAppRequest, type CreateSponsorPassRequest, type CreateWebhookRequest, type Developer, type ExecuteCall, FrontierSDK, type GasOverrides, type ListParams, type ListSponsorsParams, type PaginatedResponse, PartnershipsAccess, type ReferralDetails, type ReferralOverview, type RotateKeyResponse, type RotateWebhookKeyResponse, type SDKRequest, type SDKResponse, type SmartAccount, type Sponsor, type SponsorPass, type StableCoin, StorageAccess, type SwapParams, type SwapQuote, type SwapResult, SwapResultStatus, ThirdPartyAccess, type Token, Underlying, type UpdateAppRequest, type UpdateDeveloperRequest, type UpdateWebhookRequest, type User, UserAccess, type UserContact, type UserContactPayload, type UserOperationReceipt, type UserProfile, WalletAccess, type WalletBalance, type WalletBalanceFormatted, type Webhook, type WebhookConfig, type WebhookEvent, type WebhookScope, type WebhookStatus };

package/dist/index.js

@@ -26,6 +26,7 @@ __export(index_exports, {
   StorageAccess: () => StorageAccess,
   SwapResultStatus: () => SwapResultStatus,
   ThirdPartyAccess: () => ThirdPartyAccess,
+  Underlying: () => Underlying,
   UserAccess: () => UserAccess,
   WalletAccess: () => WalletAccess,
   createStandaloneHTML: () => createStandaloneHTML,
@@ -299,6 +300,33 @@ var WalletAccess = class {
       overrides
     });
   }
+  /**
+   * Transfer Frontier Dollars with Internal Frontier Dollars (iFTD) preferred
+   * 
+   * This method will use Internal Frontier Dollars first, and if insufficient,
+   * it will use regular Frontier Dollars to complete the transfer.
+   * 
+   * @param to - Recipient address
+   * @param amount - Amount to send (as string, e.g., '10.5')
+   * @param overrides - Optional gas overrides
+   * @returns User operation receipt with transaction details
+   * @throws {Error} If insufficient total balance or transaction fails
+   * 
+   * @example
+   * ```typescript
+   * const receipt = await sdk.getWallet().transferOverallFrontierDollar(
+   *   '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+   *   '10.5'
+   * );
+   * ```
+   */
+  async transferOverallFrontierDollar(to, amount, overrides) {
+    return this.sdk.request("wallet:transferOverallFrontierDollar", {
+      to,
+      amount,
+      overrides
+    });
+  }
   /**
    * Execute multiple calls atomically with a single signature
    * 
@@ -457,6 +485,10 @@ var StorageAccess = class {
 };
 
 // src/access/chain.ts
+var Underlying = /* @__PURE__ */ ((Underlying2) => {
+  Underlying2["USD"] = "USD";
+  return Underlying2;
+})(Underlying || {});
 var ChainAccess = class {
   constructor(sdk) {
     this.sdk = sdk;
@@ -1342,6 +1374,7 @@ function createStandaloneHTML(appName = "Frontier App") {
   StorageAccess,
   SwapResultStatus,
   ThirdPartyAccess,
+  Underlying,
   UserAccess,
   WalletAccess,
   createStandaloneHTML,

package/dist/index.mjs

@@ -269,6 +269,33 @@ var WalletAccess = class {
       overrides
     });
   }
+  /**
+   * Transfer Frontier Dollars with Internal Frontier Dollars (iFTD) preferred
+   * 
+   * This method will use Internal Frontier Dollars first, and if insufficient,
+   * it will use regular Frontier Dollars to complete the transfer.
+   * 
+   * @param to - Recipient address
+   * @param amount - Amount to send (as string, e.g., '10.5')
+   * @param overrides - Optional gas overrides
+   * @returns User operation receipt with transaction details
+   * @throws {Error} If insufficient total balance or transaction fails
+   * 
+   * @example
+   * ```typescript
+   * const receipt = await sdk.getWallet().transferOverallFrontierDollar(
+   *   '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+   *   '10.5'
+   * );
+   * ```
+   */
+  async transferOverallFrontierDollar(to, amount, overrides) {
+    return this.sdk.request("wallet:transferOverallFrontierDollar", {
+      to,
+      amount,
+      overrides
+    });
+  }
   /**
    * Execute multiple calls atomically with a single signature
    * 
@@ -427,6 +454,10 @@ var StorageAccess = class {
 };
 
 // src/access/chain.ts
+var Underlying = /* @__PURE__ */ ((Underlying2) => {
+  Underlying2["USD"] = "USD";
+  return Underlying2;
+})(Underlying || {});
 var ChainAccess = class {
   constructor(sdk) {
     this.sdk = sdk;
@@ -1102,6 +1133,7 @@ export {
   StorageAccess,
   SwapResultStatus,
   ThirdPartyAccess,
+  Underlying,
   UserAccess,
   WalletAccess,
   createStandaloneHTML,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontiertower/frontier-sdk",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "SDK for building apps on Frontier Wallet",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",