@frontiertower/frontier-sdk 0.3.3 → 0.5.0

package/README.md

@@ -51,6 +51,10 @@ Your app must declare required permissions in the Frontier app registry:
 - `wallet:transferNative` - Transfer native currency (ETH)
 - `wallet:transferFrontierDollar` - Transfer Frontier Dollars
 - `wallet:executeCall` - Execute arbitrary contract calls
+- `wallet:executeBatchCall` - Execute multiple contract calls atomically
+- `wallet:getSupportedTokens` - Get list of supported tokens for swaps
+- `wallet:swap` - Execute token swaps (same-chain or cross-chain)
+- `wallet:quoteSwap` - Get quotes for token swaps
 
 ### Storage Permissions
 - `storage:get` - Read from storage
@@ -65,6 +69,15 @@ Your app must declare required permissions in the Frontier app registry:
 - `user:getReferralDetails` - Access detailed referral information
 - `user:addUserContact` - Add user contact information
 
+### Partnerships Permissions
+- `partnerships:listSponsors` - List sponsors you manage (paginated)
+- `partnerships:getSponsor` - Retrieve a Sponsor by ID
+- `partnerships:createSponsorPass` - Create a SponsorPass
+- `partnerships:listActiveSponsorPasses` - List active SponsorPasses (paginated)
+- `partnerships:listAllSponsorPasses` - List all SponsorPasses (paginated)
+- `partnerships:getSponsorPass` - Retrieve a SponsorPass by ID
+- `partnerships:revokeSponsorPass` - Revoke a SponsorPass by ID
+
 ### Chain Permissions
 - `chain:getCurrentNetwork` - Get current network name
 - `chain:getAvailableNetworks` - Get list of available networks

package/dist/index.d.mts

@@ -54,6 +54,60 @@ interface ExecuteCall {
     /** Calldata */
     data: string;
 }
+/**
+ * Swap parameters for token swaps
+ */
+interface SwapParams {
+    /** Symbol of the token to swap from (e.g., 'USDC') */
+    sourceToken: string;
+    /** Symbol of the token to swap to (e.g., 'WETH') */
+    targetToken: string;
+    /** Network identifier for source chain (e.g., 'base') */
+    sourceNetwork: string;
+    /** Network identifier for target chain (e.g., 'ethereum') */
+    targetNetwork: string;
+    /** Amount to swap in human-readable format (e.g., '100.5') */
+    amount: string;
+}
+/**
+ * Swap result status
+ */
+declare enum SwapResultStatus {
+    COMPLETED = "COMPLETED",
+    SUBMITTED = "SUBMITTED"
+}
+/**
+ * Result of a swap operation
+ */
+interface SwapResult {
+    /** Source chain configuration */
+    sourceChain: object;
+    /** Target chain configuration */
+    targetChain: object;
+    /** Source token configuration */
+    sourceToken: object;
+    /** Target token configuration */
+    targetToken: object;
+    /** Status of the swap */
+    status: SwapResultStatus;
+}
+/**
+ * Quote for a swap operation
+ */
+interface SwapQuote {
+    /** Source chain configuration */
+    sourceChain: object;
+    /** Target chain configuration */
+    targetChain: object;
+    /** Source token configuration */
+    sourceToken: object;
+    /** Target token configuration */
+    targetToken: object;
+    /** Expected output amount in human-readable format */
+    expectedAmountOut: string;
+    /** Minimum output amount in human-readable format */
+    minAmountOut: string;
+}
 /**
  * Wallet access class for interacting with the user's wallet
  *
@@ -256,6 +310,103 @@ declare class WalletAccess {
      * ```
      */
     transferFrontierDollar(to: string, amount: string, overrides?: GasOverrides): Promise<UserOperationReceipt>;
+    /**
+     * Execute multiple calls atomically with a single signature
+     *
+     * Executes multiple contract interactions in a single transaction.
+     * All calls are executed atomically - if one fails, all fail.
+     *
+     * @param calls - Array of execute call parameters
+     * @param overrides - Optional gas overrides
+     * @returns User operation receipt with transaction details
+     * @throws {Error} If any transaction fails
+     *
+     * @example
+     * ```typescript
+     * import { encodeFunctionData } from 'viem';
+     *
+     * const receipt = await sdk.getWallet().executeBatchCall([
+     *   {
+     *     to: '0xToken1',
+     *     value: 0n,
+     *     data: encodeFunctionData({ abi: erc20Abi, functionName: 'approve', args: [...] })
+     *   },
+     *   {
+     *     to: '0xProtocol',
+     *     value: 0n,
+     *     data: encodeFunctionData({ abi: protocolAbi, functionName: 'deposit', args: [...] })
+     *   }
+     * ]);
+     * ```
+     */
+    executeBatchCall(calls: ExecuteCall[], overrides?: GasOverrides): Promise<UserOperationReceipt>;
+    /**
+     * Get list of supported token symbols for the current chain
+     *
+     * Returns an array of token symbols that are supported for swaps
+     * and other operations on the current network.
+     *
+     * @returns Array of token symbols (e.g., ['FTD', 'USDC', 'WETH'])
+     *
+     * @example
+     * ```typescript
+     * const tokens = await sdk.getWallet().getSupportedTokens();
+     * console.log('Supported tokens:', tokens); // ['FTD', 'USDC', 'WETH']
+     * ```
+     */
+    getSupportedTokens(): Promise<string[]>;
+    /**
+     * Execute a token swap
+     *
+     * @param sourceToken - Symbol of the token to swap from (e.g., 'USDC')
+     * @param targetToken - Symbol of the token to swap to (e.g., 'WETH')
+     * @param sourceNetwork - Network identifier for source chain (e.g., 'base')
+     * @param targetNetwork - Network identifier for target chain (e.g., 'ethereum')
+     * @param amount - Amount to swap in human-readable format (e.g., '100.5')
+     * @returns Swap result with status and transaction details
+     * @throws {Error} If swap fails or tokens/networks are not supported
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.getWallet().swap(
+     *   'USDC',
+     *   'WETH',
+     *   'base',
+     *   'ethereum',
+     *   '100.5'
+     * );
+     * console.log('Swap status:', result.status);
+     * ```
+     */
+    swap(sourceToken: string, targetToken: string, sourceNetwork: string, targetNetwork: string, amount: string): Promise<SwapResult>;
+    /**
+     * Get a quote for a token swap without executing it
+     *
+     * Returns the expected output amount for a given swap.
+     * Useful for displaying swap previews to users before confirmation.
+     *
+     * @param sourceToken - Symbol of the token to swap from (e.g., 'USDC')
+     * @param targetToken - Symbol of the token to swap to (e.g., 'WETH')
+     * @param sourceNetwork - Network identifier for source chain (e.g., 'base')
+     * @param targetNetwork - Network identifier for target chain (e.g., 'ethereum')
+     * @param amount - Amount to swap in human-readable format (e.g., '100.5')
+     * @returns Quote with expected and minimum output amounts
+     * @throws {Error} If tokens/networks are not supported
+     *
+     * @example
+     * ```typescript
+     * const quote = await sdk.getWallet().quoteSwap(
+     *   'USDC',
+     *   'WETH',
+     *   'base',
+     *   'ethereum',
+     *   '100.5'
+     * );
+     * console.log('Expected output:', quote.expectedAmountOut);
+     * console.log('Minimum output:', quote.minAmountOut);
+     * ```
+     */
+    quoteSwap(sourceToken: string, targetToken: string, sourceNetwork: string, targetNetwork: string, amount: string): Promise<SwapQuote>;
 }
 
 /**
@@ -497,16 +648,16 @@ interface ReferralOverview {
  * Detailed referral information
  */
 interface ReferralDetails {
-    /** Referral ID */
-    id: number;
-    /** Referred user email */
+    /** Name of the referred user */
+    name: string;
+    /** Email of the referred user */
     email: string;
-    /** First name */
-    firstName: string;
-    /** Last name */
-    lastName: string;
-    /** Date user joined */
-    dateJoined: string;
+    /** Date when the referral was made */
+    referralDate: string;
+    /** Reward information (if any) */
+    reward: string;
+    /** Status of the referral */
+    status: string;
 }
 /**
  * Single contact entry
@@ -636,6 +787,152 @@ declare class UserAccess {
     addUserContact(data: UserContactPayload): Promise<void>;
 }
 
+/**
+ * Sponsor passes API
+ *
+ * Sponsor pass creation and management
+ */
+type SponsorPassStatus = 'active' | 'revoked';
+interface SponsorPass {
+    id: number;
+    sponsor: number;
+    sponsorName: string;
+    firstName: string;
+    lastName: string;
+    email: string;
+    status: SponsorPassStatus;
+    expiresAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    revokedAt: string | null;
+}
+/**
+ * Payload for creating a SponsorPass.
+ */
+interface CreateSponsorPassRequest {
+    sponsor: number;
+    firstName: string;
+    lastName: string;
+    email: string;
+    expiresAt?: string;
+}
+interface ListSponsorPassesParams {
+    limit?: number;
+    offset?: number;
+}
+interface ListAllSponsorPassesParams extends ListSponsorPassesParams {
+    includeRevoked?: boolean;
+}
+interface Sponsor {
+    id: number;
+    name: string;
+    dailyRate: string;
+    notes: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ListSponsorsParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Partnerships access class for interacting with partnership-related features.
+ *
+ * This class provides methods to:
+ * - Create SponsorPasses
+ * - List active SponsorPasses
+ * - List all SponsorPasses (optionally including revoked)
+ * - Retrieve and revoke SponsorPasses
+ */
+declare class PartnershipsAccess {
+    private sdk;
+    constructor(sdk: FrontierSDK);
+    /**
+     * Create a SponsorPass
+     * Requires permission: `partnerships:createSponsorPass` or `partnerships:*`
+     *
+     * @param payload - SponsorPass creation payload
+     * @returns Created SponsorPass
+     *
+     * @example
+     * ```typescript
+     * const pass = await sdk.getPartnerships().createSponsorPass({
+     *   sponsor: 123,
+     *   firstName: 'Ada',
+     *   lastName: 'Lovelace',
+     *   email: 'ada@example.com',
+     * });
+     * console.log('Created SponsorPass:', pass.id);
+     * ```
+     */
+    createSponsorPass(payload: CreateSponsorPassRequest): Promise<SponsorPass>;
+    /**
+     * List active SponsorPasses (paginated)
+     * Requires permission: `partnerships:listActiveSponsorPasses` or `partnerships:*`
+     *
+     * @param payload.limit - Maximum number of results to return
+     * @param payload.offset - Offset into the result set
+     * @returns Paginated response of active SponsorPasses
+     *
+     * @example
+     * ```typescript
+     * const active = await sdk.getPartnerships().listActiveSponsorPasses({ limit: 20, offset: 0 });
+     * console.log('Active count:', active.count);
+     * ```
+     */
+    listActiveSponsorPasses(payload?: ListSponsorPassesParams): Promise<PaginatedResponse<SponsorPass>>;
+    /**
+     * List all SponsorPasses (paginated)
+     * Requires permission: `partnerships:listAllSponsorPasses` or `partnerships:*`
+     *
+     * @param payload.includeRevoked - When true, include revoked passes
+     * @returns Paginated response of SponsorPasses
+     *
+     * @example
+     * ```typescript
+     * const all = await sdk.getPartnerships().listAllSponsorPasses({ includeRevoked: true, limit: 50, offset: 0 });
+     * console.log('Total passes:', all.count);
+     * ```
+     */
+    listAllSponsorPasses(payload?: ListAllSponsorPassesParams): Promise<PaginatedResponse<SponsorPass>>;
+    listSponsors(payload?: ListSponsorsParams): Promise<PaginatedResponse<Sponsor>>;
+    getSponsor(payload: {
+        id: number;
+    }): Promise<Sponsor>;
+    /**
+     * Retrieve a specific SponsorPass by ID
+     * Requires permission: `partnerships:getSponsorPass` or `partnerships:*`
+     *
+     * @param payload.id - SponsorPass ID
+     * @returns SponsorPass
+     *
+     * @example
+     * ```typescript
+     * const pass = await sdk.getPartnerships().getSponsorPass({ id: 123 });
+     * console.log('SponsorPass:', pass);
+     * ```
+     */
+    getSponsorPass(payload: {
+        id: number;
+    }): Promise<SponsorPass>;
+    /**
+     * Revoke a SponsorPass by ID
+     * Requires permission: `partnerships:revokeSponsorPass` or `partnerships:*`
+     *
+     * Note: backend revokes (does not delete).
+     *
+     * @param payload.id - SponsorPass ID
+     *
+     * @example
+     * ```typescript
+     * await sdk.getPartnerships().revokeSponsorPass({ id: 123 });
+     * ```
+     */
+    revokeSponsorPass(payload: {
+        id: number;
+    }): Promise<void>;
+}
+
 declare class FrontierSDK {
     private requestId;
     private pendingRequests;
@@ -643,6 +940,7 @@ declare class FrontierSDK {
     private storage;
     private chain;
     private user;
+    private partnerships;
     constructor();
     private handleMessage;
     /**
@@ -667,6 +965,10 @@ declare class FrontierSDK {
      * Get user access instance
      */
     getUser(): UserAccess;
+    /**
+     * Get partnerships access instance
+     */
+    getPartnerships(): PartnershipsAccess;
     /**
      * Cleanup: Remove event listeners
      * Call this when your app is being destroyed
@@ -686,4 +988,4 @@ interface SDKResponse {
     error?: string;
 }
 
-export { ChainAccess, type ChainConfig, type ExecuteCall, FrontierSDK, type GasOverrides, type PaginatedResponse, type ReferralDetails, type ReferralOverview, type SDKRequest, type SDKResponse, type SmartAccount, StorageAccess, type User, UserAccess, type UserContact, type UserContactPayload, type UserOperationReceipt, type UserProfile, WalletAccess };
+export { ChainAccess, type ChainConfig, type CreateSponsorPassRequest, type ExecuteCall, FrontierSDK, type GasOverrides, type ListSponsorsParams, type PaginatedResponse, PartnershipsAccess, type ReferralDetails, type ReferralOverview, type SDKRequest, type SDKResponse, type SmartAccount, type Sponsor, type SponsorPass, StorageAccess, type SwapParams, type SwapQuote, type SwapResult, SwapResultStatus, type User, UserAccess, type UserContact, type UserContactPayload, type UserOperationReceipt, type UserProfile, WalletAccess };

package/dist/index.d.ts

@@ -54,6 +54,60 @@ interface ExecuteCall {
     /** Calldata */
     data: string;
 }
+/**
+ * Swap parameters for token swaps
+ */
+interface SwapParams {
+    /** Symbol of the token to swap from (e.g., 'USDC') */
+    sourceToken: string;
+    /** Symbol of the token to swap to (e.g., 'WETH') */
+    targetToken: string;
+    /** Network identifier for source chain (e.g., 'base') */
+    sourceNetwork: string;
+    /** Network identifier for target chain (e.g., 'ethereum') */
+    targetNetwork: string;
+    /** Amount to swap in human-readable format (e.g., '100.5') */
+    amount: string;
+}
+/**
+ * Swap result status
+ */
+declare enum SwapResultStatus {
+    COMPLETED = "COMPLETED",
+    SUBMITTED = "SUBMITTED"
+}
+/**
+ * Result of a swap operation
+ */
+interface SwapResult {
+    /** Source chain configuration */
+    sourceChain: object;
+    /** Target chain configuration */
+    targetChain: object;
+    /** Source token configuration */
+    sourceToken: object;
+    /** Target token configuration */
+    targetToken: object;
+    /** Status of the swap */
+    status: SwapResultStatus;
+}
+/**
+ * Quote for a swap operation
+ */
+interface SwapQuote {
+    /** Source chain configuration */
+    sourceChain: object;
+    /** Target chain configuration */
+    targetChain: object;
+    /** Source token configuration */
+    sourceToken: object;
+    /** Target token configuration */
+    targetToken: object;
+    /** Expected output amount in human-readable format */
+    expectedAmountOut: string;
+    /** Minimum output amount in human-readable format */
+    minAmountOut: string;
+}
 /**
  * Wallet access class for interacting with the user's wallet
  *
@@ -256,6 +310,103 @@ declare class WalletAccess {
      * ```
      */
     transferFrontierDollar(to: string, amount: string, overrides?: GasOverrides): Promise<UserOperationReceipt>;
+    /**
+     * Execute multiple calls atomically with a single signature
+     *
+     * Executes multiple contract interactions in a single transaction.
+     * All calls are executed atomically - if one fails, all fail.
+     *
+     * @param calls - Array of execute call parameters
+     * @param overrides - Optional gas overrides
+     * @returns User operation receipt with transaction details
+     * @throws {Error} If any transaction fails
+     *
+     * @example
+     * ```typescript
+     * import { encodeFunctionData } from 'viem';
+     *
+     * const receipt = await sdk.getWallet().executeBatchCall([
+     *   {
+     *     to: '0xToken1',
+     *     value: 0n,
+     *     data: encodeFunctionData({ abi: erc20Abi, functionName: 'approve', args: [...] })
+     *   },
+     *   {
+     *     to: '0xProtocol',
+     *     value: 0n,
+     *     data: encodeFunctionData({ abi: protocolAbi, functionName: 'deposit', args: [...] })
+     *   }
+     * ]);
+     * ```
+     */
+    executeBatchCall(calls: ExecuteCall[], overrides?: GasOverrides): Promise<UserOperationReceipt>;
+    /**
+     * Get list of supported token symbols for the current chain
+     *
+     * Returns an array of token symbols that are supported for swaps
+     * and other operations on the current network.
+     *
+     * @returns Array of token symbols (e.g., ['FTD', 'USDC', 'WETH'])
+     *
+     * @example
+     * ```typescript
+     * const tokens = await sdk.getWallet().getSupportedTokens();
+     * console.log('Supported tokens:', tokens); // ['FTD', 'USDC', 'WETH']
+     * ```
+     */
+    getSupportedTokens(): Promise<string[]>;
+    /**
+     * Execute a token swap
+     *
+     * @param sourceToken - Symbol of the token to swap from (e.g., 'USDC')
+     * @param targetToken - Symbol of the token to swap to (e.g., 'WETH')
+     * @param sourceNetwork - Network identifier for source chain (e.g., 'base')
+     * @param targetNetwork - Network identifier for target chain (e.g., 'ethereum')
+     * @param amount - Amount to swap in human-readable format (e.g., '100.5')
+     * @returns Swap result with status and transaction details
+     * @throws {Error} If swap fails or tokens/networks are not supported
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.getWallet().swap(
+     *   'USDC',
+     *   'WETH',
+     *   'base',
+     *   'ethereum',
+     *   '100.5'
+     * );
+     * console.log('Swap status:', result.status);
+     * ```
+     */
+    swap(sourceToken: string, targetToken: string, sourceNetwork: string, targetNetwork: string, amount: string): Promise<SwapResult>;
+    /**
+     * Get a quote for a token swap without executing it
+     *
+     * Returns the expected output amount for a given swap.
+     * Useful for displaying swap previews to users before confirmation.
+     *
+     * @param sourceToken - Symbol of the token to swap from (e.g., 'USDC')
+     * @param targetToken - Symbol of the token to swap to (e.g., 'WETH')
+     * @param sourceNetwork - Network identifier for source chain (e.g., 'base')
+     * @param targetNetwork - Network identifier for target chain (e.g., 'ethereum')
+     * @param amount - Amount to swap in human-readable format (e.g., '100.5')
+     * @returns Quote with expected and minimum output amounts
+     * @throws {Error} If tokens/networks are not supported
+     *
+     * @example
+     * ```typescript
+     * const quote = await sdk.getWallet().quoteSwap(
+     *   'USDC',
+     *   'WETH',
+     *   'base',
+     *   'ethereum',
+     *   '100.5'
+     * );
+     * console.log('Expected output:', quote.expectedAmountOut);
+     * console.log('Minimum output:', quote.minAmountOut);
+     * ```
+     */
+    quoteSwap(sourceToken: string, targetToken: string, sourceNetwork: string, targetNetwork: string, amount: string): Promise<SwapQuote>;
 }
 
 /**
@@ -497,16 +648,16 @@ interface ReferralOverview {
  * Detailed referral information
  */
 interface ReferralDetails {
-    /** Referral ID */
-    id: number;
-    /** Referred user email */
+    /** Name of the referred user */
+    name: string;
+    /** Email of the referred user */
     email: string;
-    /** First name */
-    firstName: string;
-    /** Last name */
-    lastName: string;
-    /** Date user joined */
-    dateJoined: string;
+    /** Date when the referral was made */
+    referralDate: string;
+    /** Reward information (if any) */
+    reward: string;
+    /** Status of the referral */
+    status: string;
 }
 /**
  * Single contact entry
@@ -636,6 +787,152 @@ declare class UserAccess {
     addUserContact(data: UserContactPayload): Promise<void>;
 }
 
+/**
+ * Sponsor passes API
+ *
+ * Sponsor pass creation and management
+ */
+type SponsorPassStatus = 'active' | 'revoked';
+interface SponsorPass {
+    id: number;
+    sponsor: number;
+    sponsorName: string;
+    firstName: string;
+    lastName: string;
+    email: string;
+    status: SponsorPassStatus;
+    expiresAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    revokedAt: string | null;
+}
+/**
+ * Payload for creating a SponsorPass.
+ */
+interface CreateSponsorPassRequest {
+    sponsor: number;
+    firstName: string;
+    lastName: string;
+    email: string;
+    expiresAt?: string;
+}
+interface ListSponsorPassesParams {
+    limit?: number;
+    offset?: number;
+}
+interface ListAllSponsorPassesParams extends ListSponsorPassesParams {
+    includeRevoked?: boolean;
+}
+interface Sponsor {
+    id: number;
+    name: string;
+    dailyRate: string;
+    notes: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ListSponsorsParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Partnerships access class for interacting with partnership-related features.
+ *
+ * This class provides methods to:
+ * - Create SponsorPasses
+ * - List active SponsorPasses
+ * - List all SponsorPasses (optionally including revoked)
+ * - Retrieve and revoke SponsorPasses
+ */
+declare class PartnershipsAccess {
+    private sdk;
+    constructor(sdk: FrontierSDK);
+    /**
+     * Create a SponsorPass
+     * Requires permission: `partnerships:createSponsorPass` or `partnerships:*`
+     *
+     * @param payload - SponsorPass creation payload
+     * @returns Created SponsorPass
+     *
+     * @example
+     * ```typescript
+     * const pass = await sdk.getPartnerships().createSponsorPass({
+     *   sponsor: 123,
+     *   firstName: 'Ada',
+     *   lastName: 'Lovelace',
+     *   email: 'ada@example.com',
+     * });
+     * console.log('Created SponsorPass:', pass.id);
+     * ```
+     */
+    createSponsorPass(payload: CreateSponsorPassRequest): Promise<SponsorPass>;
+    /**
+     * List active SponsorPasses (paginated)
+     * Requires permission: `partnerships:listActiveSponsorPasses` or `partnerships:*`
+     *
+     * @param payload.limit - Maximum number of results to return
+     * @param payload.offset - Offset into the result set
+     * @returns Paginated response of active SponsorPasses
+     *
+     * @example
+     * ```typescript
+     * const active = await sdk.getPartnerships().listActiveSponsorPasses({ limit: 20, offset: 0 });
+     * console.log('Active count:', active.count);
+     * ```
+     */
+    listActiveSponsorPasses(payload?: ListSponsorPassesParams): Promise<PaginatedResponse<SponsorPass>>;
+    /**
+     * List all SponsorPasses (paginated)
+     * Requires permission: `partnerships:listAllSponsorPasses` or `partnerships:*`
+     *
+     * @param payload.includeRevoked - When true, include revoked passes
+     * @returns Paginated response of SponsorPasses
+     *
+     * @example
+     * ```typescript
+     * const all = await sdk.getPartnerships().listAllSponsorPasses({ includeRevoked: true, limit: 50, offset: 0 });
+     * console.log('Total passes:', all.count);
+     * ```
+     */
+    listAllSponsorPasses(payload?: ListAllSponsorPassesParams): Promise<PaginatedResponse<SponsorPass>>;
+    listSponsors(payload?: ListSponsorsParams): Promise<PaginatedResponse<Sponsor>>;
+    getSponsor(payload: {
+        id: number;
+    }): Promise<Sponsor>;
+    /**
+     * Retrieve a specific SponsorPass by ID
+     * Requires permission: `partnerships:getSponsorPass` or `partnerships:*`
+     *
+     * @param payload.id - SponsorPass ID
+     * @returns SponsorPass
+     *
+     * @example
+     * ```typescript
+     * const pass = await sdk.getPartnerships().getSponsorPass({ id: 123 });
+     * console.log('SponsorPass:', pass);
+     * ```
+     */
+    getSponsorPass(payload: {
+        id: number;
+    }): Promise<SponsorPass>;
+    /**
+     * Revoke a SponsorPass by ID
+     * Requires permission: `partnerships:revokeSponsorPass` or `partnerships:*`
+     *
+     * Note: backend revokes (does not delete).
+     *
+     * @param payload.id - SponsorPass ID
+     *
+     * @example
+     * ```typescript
+     * await sdk.getPartnerships().revokeSponsorPass({ id: 123 });
+     * ```
+     */
+    revokeSponsorPass(payload: {
+        id: number;
+    }): Promise<void>;
+}
+
 declare class FrontierSDK {
     private requestId;
     private pendingRequests;
@@ -643,6 +940,7 @@ declare class FrontierSDK {
     private storage;
     private chain;
     private user;
+    private partnerships;
     constructor();
     private handleMessage;
     /**
@@ -667,6 +965,10 @@ declare class FrontierSDK {
      * Get user access instance
      */
     getUser(): UserAccess;
+    /**
+     * Get partnerships access instance
+     */
+    getPartnerships(): PartnershipsAccess;
     /**
      * Cleanup: Remove event listeners
      * Call this when your app is being destroyed
@@ -686,4 +988,4 @@ interface SDKResponse {
     error?: string;
 }
 
-export { ChainAccess, type ChainConfig, type ExecuteCall, FrontierSDK, type GasOverrides, type PaginatedResponse, type ReferralDetails, type ReferralOverview, type SDKRequest, type SDKResponse, type SmartAccount, StorageAccess, type User, UserAccess, type UserContact, type UserContactPayload, type UserOperationReceipt, type UserProfile, WalletAccess };
+export { ChainAccess, type ChainConfig, type CreateSponsorPassRequest, type ExecuteCall, FrontierSDK, type GasOverrides, type ListSponsorsParams, type PaginatedResponse, PartnershipsAccess, type ReferralDetails, type ReferralOverview, type SDKRequest, type SDKResponse, type SmartAccount, type Sponsor, type SponsorPass, StorageAccess, type SwapParams, type SwapQuote, type SwapResult, SwapResultStatus, type User, UserAccess, type UserContact, type UserContactPayload, type UserOperationReceipt, type UserProfile, WalletAccess };

package/dist/index.js

@@ -22,7 +22,9 @@ var index_exports = {};
 __export(index_exports, {
   ChainAccess: () => ChainAccess,
   FrontierSDK: () => FrontierSDK,
+  PartnershipsAccess: () => PartnershipsAccess,
   StorageAccess: () => StorageAccess,
+  SwapResultStatus: () => SwapResultStatus,
   UserAccess: () => UserAccess,
   WalletAccess: () => WalletAccess,
   createStandaloneHTML: () => createStandaloneHTML,
@@ -33,6 +35,11 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/access/wallet.ts
+var SwapResultStatus = /* @__PURE__ */ ((SwapResultStatus2) => {
+  SwapResultStatus2["COMPLETED"] = "COMPLETED";
+  SwapResultStatus2["SUBMITTED"] = "SUBMITTED";
+  return SwapResultStatus2;
+})(SwapResultStatus || {});
 var WalletAccess = class {
   constructor(sdk) {
     this.sdk = sdk;
@@ -263,6 +270,126 @@ var WalletAccess = class {
       overrides
     });
   }
+  /**
+   * Execute multiple calls atomically with a single signature
+   * 
+   * Executes multiple contract interactions in a single transaction.
+   * All calls are executed atomically - if one fails, all fail.
+   * 
+   * @param calls - Array of execute call parameters
+   * @param overrides - Optional gas overrides
+   * @returns User operation receipt with transaction details
+   * @throws {Error} If any transaction fails
+   * 
+   * @example
+   * ```typescript
+   * import { encodeFunctionData } from 'viem';
+   * 
+   * const receipt = await sdk.getWallet().executeBatchCall([
+   *   {
+   *     to: '0xToken1',
+   *     value: 0n,
+   *     data: encodeFunctionData({ abi: erc20Abi, functionName: 'approve', args: [...] })
+   *   },
+   *   {
+   *     to: '0xProtocol',
+   *     value: 0n,
+   *     data: encodeFunctionData({ abi: protocolAbi, functionName: 'deposit', args: [...] })
+   *   }
+   * ]);
+   * ```
+   */
+  async executeBatchCall(calls, overrides) {
+    return this.sdk.request("wallet:executeBatchCall", {
+      calls,
+      overrides
+    });
+  }
+  /**
+   * Get list of supported token symbols for the current chain
+   * 
+   * Returns an array of token symbols that are supported for swaps
+   * and other operations on the current network.
+   * 
+   * @returns Array of token symbols (e.g., ['FTD', 'USDC', 'WETH'])
+   * 
+   * @example
+   * ```typescript
+   * const tokens = await sdk.getWallet().getSupportedTokens();
+   * console.log('Supported tokens:', tokens); // ['FTD', 'USDC', 'WETH']
+   * ```
+   */
+  async getSupportedTokens() {
+    return this.sdk.request("wallet:getSupportedTokens");
+  }
+  /**
+   * Execute a token swap
+   *
+   * @param sourceToken - Symbol of the token to swap from (e.g., 'USDC')
+   * @param targetToken - Symbol of the token to swap to (e.g., 'WETH')
+   * @param sourceNetwork - Network identifier for source chain (e.g., 'base')
+   * @param targetNetwork - Network identifier for target chain (e.g., 'ethereum')
+   * @param amount - Amount to swap in human-readable format (e.g., '100.5')
+   * @returns Swap result with status and transaction details
+   * @throws {Error} If swap fails or tokens/networks are not supported
+   * 
+   * @example
+   * ```typescript
+   * const result = await sdk.getWallet().swap(
+   *   'USDC',
+   *   'WETH',
+   *   'base',
+   *   'ethereum',
+   *   '100.5'
+   * );
+   * console.log('Swap status:', result.status);
+   * ```
+   */
+  async swap(sourceToken, targetToken, sourceNetwork, targetNetwork, amount) {
+    return this.sdk.request("wallet:swap", {
+      sourceToken,
+      targetToken,
+      sourceNetwork,
+      targetNetwork,
+      amount
+    });
+  }
+  /**
+   * Get a quote for a token swap without executing it
+   * 
+   * Returns the expected output amount for a given swap.
+   * Useful for displaying swap previews to users before confirmation.
+   * 
+   * @param sourceToken - Symbol of the token to swap from (e.g., 'USDC')
+   * @param targetToken - Symbol of the token to swap to (e.g., 'WETH')
+   * @param sourceNetwork - Network identifier for source chain (e.g., 'base')
+   * @param targetNetwork - Network identifier for target chain (e.g., 'ethereum')
+   * @param amount - Amount to swap in human-readable format (e.g., '100.5')
+   * @returns Quote with expected and minimum output amounts
+   * @throws {Error} If tokens/networks are not supported
+   * 
+   * @example
+   * ```typescript
+   * const quote = await sdk.getWallet().quoteSwap(
+   *   'USDC',
+   *   'WETH',
+   *   'base',
+   *   'ethereum',
+   *   '100.5'
+   * );
+   * console.log('Expected output:', quote.expectedAmountOut);
+   * console.log('Minimum output:', quote.minAmountOut);
+   * ```
+   */
+  async quoteSwap(sourceToken, targetToken, sourceNetwork, targetNetwork, amount) {
+    return this.sdk.request("wallet:quoteSwap", {
+      sourceToken,
+      targetToken,
+      sourceNetwork,
+      targetNetwork,
+      amount
+    });
+  }
 };
 
 // src/access/storage.ts
@@ -487,6 +614,105 @@ var UserAccess = class {
   }
 };
 
+// src/access/partnerships.ts
+var PartnershipsAccess = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  /**
+   * Create a SponsorPass
+   * Requires permission: `partnerships:createSponsorPass` or `partnerships:*`
+   *
+   * @param payload - SponsorPass creation payload
+   * @returns Created SponsorPass
+   *
+   * @example
+   * ```typescript
+   * const pass = await sdk.getPartnerships().createSponsorPass({
+   *   sponsor: 123,
+   *   firstName: 'Ada',
+   *   lastName: 'Lovelace',
+   *   email: 'ada@example.com',
+   * });
+   * console.log('Created SponsorPass:', pass.id);
+   * ```
+   */
+  async createSponsorPass(payload) {
+    return this.sdk.request("partnerships:createSponsorPass", payload);
+  }
+  /**
+   * List active SponsorPasses (paginated)
+   * Requires permission: `partnerships:listActiveSponsorPasses` or `partnerships:*`
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @returns Paginated response of active SponsorPasses
+   *
+   * @example
+   * ```typescript
+   * const active = await sdk.getPartnerships().listActiveSponsorPasses({ limit: 20, offset: 0 });
+   * console.log('Active count:', active.count);
+   * ```
+   */
+  async listActiveSponsorPasses(payload) {
+    return this.sdk.request("partnerships:listActiveSponsorPasses", payload);
+  }
+  /**
+   * List all SponsorPasses (paginated)
+   * Requires permission: `partnerships:listAllSponsorPasses` or `partnerships:*`
+   *
+   * @param payload.includeRevoked - When true, include revoked passes
+   * @returns Paginated response of SponsorPasses
+   *
+   * @example
+   * ```typescript
+   * const all = await sdk.getPartnerships().listAllSponsorPasses({ includeRevoked: true, limit: 50, offset: 0 });
+   * console.log('Total passes:', all.count);
+   * ```
+   */
+  async listAllSponsorPasses(payload) {
+    return this.sdk.request("partnerships:listAllSponsorPasses", payload);
+  }
+  async listSponsors(payload) {
+    return this.sdk.request("partnerships:listSponsors", payload);
+  }
+  async getSponsor(payload) {
+    return this.sdk.request("partnerships:getSponsor", payload);
+  }
+  /**
+   * Retrieve a specific SponsorPass by ID
+   * Requires permission: `partnerships:getSponsorPass` or `partnerships:*`
+   *
+   * @param payload.id - SponsorPass ID
+   * @returns SponsorPass
+   *
+   * @example
+   * ```typescript
+   * const pass = await sdk.getPartnerships().getSponsorPass({ id: 123 });
+   * console.log('SponsorPass:', pass);
+   * ```
+   */
+  async getSponsorPass(payload) {
+    return this.sdk.request("partnerships:getSponsorPass", payload);
+  }
+  /**
+   * Revoke a SponsorPass by ID
+   * Requires permission: `partnerships:revokeSponsorPass` or `partnerships:*`
+   *
+   * Note: backend revokes (does not delete).
+   *
+   * @param payload.id - SponsorPass ID
+   *
+   * @example
+   * ```typescript
+   * await sdk.getPartnerships().revokeSponsorPass({ id: 123 });
+   * ```
+   */
+  async revokeSponsorPass(payload) {
+    return this.sdk.request("partnerships:revokeSponsorPass", payload);
+  }
+};
+
 // src/sdk.ts
 var FrontierSDK = class {
   constructor() {
@@ -509,6 +735,7 @@ var FrontierSDK = class {
     this.storage = new StorageAccess(this);
     this.chain = new ChainAccess(this);
     this.user = new UserAccess(this);
+    this.partnerships = new PartnershipsAccess(this);
     window.addEventListener("message", this.handleMessage);
     this.notifyReady();
   }
@@ -557,6 +784,12 @@ var FrontierSDK = class {
   getUser() {
     return this.user;
   }
+  /**
+   * Get partnerships access instance
+   */
+  getPartnerships() {
+    return this.partnerships;
+  }
   /**
    * Cleanup: Remove event listeners
    * Call this when your app is being destroyed
@@ -779,7 +1012,9 @@ function createStandaloneHTML(appName = "Frontier App") {
 0 && (module.exports = {
   ChainAccess,
   FrontierSDK,
+  PartnershipsAccess,
   StorageAccess,
+  SwapResultStatus,
   UserAccess,
   WalletAccess,
   createStandaloneHTML,

package/dist/index.mjs

@@ -6,6 +6,11 @@ import {
 } from "./chunk-7VB6TETG.mjs";
 
 // src/access/wallet.ts
+var SwapResultStatus = /* @__PURE__ */ ((SwapResultStatus2) => {
+  SwapResultStatus2["COMPLETED"] = "COMPLETED";
+  SwapResultStatus2["SUBMITTED"] = "SUBMITTED";
+  return SwapResultStatus2;
+})(SwapResultStatus || {});
 var WalletAccess = class {
   constructor(sdk) {
     this.sdk = sdk;
@@ -236,6 +241,126 @@ var WalletAccess = class {
       overrides
     });
   }
+  /**
+   * Execute multiple calls atomically with a single signature
+   * 
+   * Executes multiple contract interactions in a single transaction.
+   * All calls are executed atomically - if one fails, all fail.
+   * 
+   * @param calls - Array of execute call parameters
+   * @param overrides - Optional gas overrides
+   * @returns User operation receipt with transaction details
+   * @throws {Error} If any transaction fails
+   * 
+   * @example
+   * ```typescript
+   * import { encodeFunctionData } from 'viem';
+   * 
+   * const receipt = await sdk.getWallet().executeBatchCall([
+   *   {
+   *     to: '0xToken1',
+   *     value: 0n,
+   *     data: encodeFunctionData({ abi: erc20Abi, functionName: 'approve', args: [...] })
+   *   },
+   *   {
+   *     to: '0xProtocol',
+   *     value: 0n,
+   *     data: encodeFunctionData({ abi: protocolAbi, functionName: 'deposit', args: [...] })
+   *   }
+   * ]);
+   * ```
+   */
+  async executeBatchCall(calls, overrides) {
+    return this.sdk.request("wallet:executeBatchCall", {
+      calls,
+      overrides
+    });
+  }
+  /**
+   * Get list of supported token symbols for the current chain
+   * 
+   * Returns an array of token symbols that are supported for swaps
+   * and other operations on the current network.
+   * 
+   * @returns Array of token symbols (e.g., ['FTD', 'USDC', 'WETH'])
+   * 
+   * @example
+   * ```typescript
+   * const tokens = await sdk.getWallet().getSupportedTokens();
+   * console.log('Supported tokens:', tokens); // ['FTD', 'USDC', 'WETH']
+   * ```
+   */
+  async getSupportedTokens() {
+    return this.sdk.request("wallet:getSupportedTokens");
+  }
+  /**
+   * Execute a token swap
+   *
+   * @param sourceToken - Symbol of the token to swap from (e.g., 'USDC')
+   * @param targetToken - Symbol of the token to swap to (e.g., 'WETH')
+   * @param sourceNetwork - Network identifier for source chain (e.g., 'base')
+   * @param targetNetwork - Network identifier for target chain (e.g., 'ethereum')
+   * @param amount - Amount to swap in human-readable format (e.g., '100.5')
+   * @returns Swap result with status and transaction details
+   * @throws {Error} If swap fails or tokens/networks are not supported
+   * 
+   * @example
+   * ```typescript
+   * const result = await sdk.getWallet().swap(
+   *   'USDC',
+   *   'WETH',
+   *   'base',
+   *   'ethereum',
+   *   '100.5'
+   * );
+   * console.log('Swap status:', result.status);
+   * ```
+   */
+  async swap(sourceToken, targetToken, sourceNetwork, targetNetwork, amount) {
+    return this.sdk.request("wallet:swap", {
+      sourceToken,
+      targetToken,
+      sourceNetwork,
+      targetNetwork,
+      amount
+    });
+  }
+  /**
+   * Get a quote for a token swap without executing it
+   * 
+   * Returns the expected output amount for a given swap.
+   * Useful for displaying swap previews to users before confirmation.
+   * 
+   * @param sourceToken - Symbol of the token to swap from (e.g., 'USDC')
+   * @param targetToken - Symbol of the token to swap to (e.g., 'WETH')
+   * @param sourceNetwork - Network identifier for source chain (e.g., 'base')
+   * @param targetNetwork - Network identifier for target chain (e.g., 'ethereum')
+   * @param amount - Amount to swap in human-readable format (e.g., '100.5')
+   * @returns Quote with expected and minimum output amounts
+   * @throws {Error} If tokens/networks are not supported
+   * 
+   * @example
+   * ```typescript
+   * const quote = await sdk.getWallet().quoteSwap(
+   *   'USDC',
+   *   'WETH',
+   *   'base',
+   *   'ethereum',
+   *   '100.5'
+   * );
+   * console.log('Expected output:', quote.expectedAmountOut);
+   * console.log('Minimum output:', quote.minAmountOut);
+   * ```
+   */
+  async quoteSwap(sourceToken, targetToken, sourceNetwork, targetNetwork, amount) {
+    return this.sdk.request("wallet:quoteSwap", {
+      sourceToken,
+      targetToken,
+      sourceNetwork,
+      targetNetwork,
+      amount
+    });
+  }
 };
 
 // src/access/storage.ts
@@ -460,6 +585,105 @@ var UserAccess = class {
   }
 };
 
+// src/access/partnerships.ts
+var PartnershipsAccess = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  /**
+   * Create a SponsorPass
+   * Requires permission: `partnerships:createSponsorPass` or `partnerships:*`
+   *
+   * @param payload - SponsorPass creation payload
+   * @returns Created SponsorPass
+   *
+   * @example
+   * ```typescript
+   * const pass = await sdk.getPartnerships().createSponsorPass({
+   *   sponsor: 123,
+   *   firstName: 'Ada',
+   *   lastName: 'Lovelace',
+   *   email: 'ada@example.com',
+   * });
+   * console.log('Created SponsorPass:', pass.id);
+   * ```
+   */
+  async createSponsorPass(payload) {
+    return this.sdk.request("partnerships:createSponsorPass", payload);
+  }
+  /**
+   * List active SponsorPasses (paginated)
+   * Requires permission: `partnerships:listActiveSponsorPasses` or `partnerships:*`
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @returns Paginated response of active SponsorPasses
+   *
+   * @example
+   * ```typescript
+   * const active = await sdk.getPartnerships().listActiveSponsorPasses({ limit: 20, offset: 0 });
+   * console.log('Active count:', active.count);
+   * ```
+   */
+  async listActiveSponsorPasses(payload) {
+    return this.sdk.request("partnerships:listActiveSponsorPasses", payload);
+  }
+  /**
+   * List all SponsorPasses (paginated)
+   * Requires permission: `partnerships:listAllSponsorPasses` or `partnerships:*`
+   *
+   * @param payload.includeRevoked - When true, include revoked passes
+   * @returns Paginated response of SponsorPasses
+   *
+   * @example
+   * ```typescript
+   * const all = await sdk.getPartnerships().listAllSponsorPasses({ includeRevoked: true, limit: 50, offset: 0 });
+   * console.log('Total passes:', all.count);
+   * ```
+   */
+  async listAllSponsorPasses(payload) {
+    return this.sdk.request("partnerships:listAllSponsorPasses", payload);
+  }
+  async listSponsors(payload) {
+    return this.sdk.request("partnerships:listSponsors", payload);
+  }
+  async getSponsor(payload) {
+    return this.sdk.request("partnerships:getSponsor", payload);
+  }
+  /**
+   * Retrieve a specific SponsorPass by ID
+   * Requires permission: `partnerships:getSponsorPass` or `partnerships:*`
+   *
+   * @param payload.id - SponsorPass ID
+   * @returns SponsorPass
+   *
+   * @example
+   * ```typescript
+   * const pass = await sdk.getPartnerships().getSponsorPass({ id: 123 });
+   * console.log('SponsorPass:', pass);
+   * ```
+   */
+  async getSponsorPass(payload) {
+    return this.sdk.request("partnerships:getSponsorPass", payload);
+  }
+  /**
+   * Revoke a SponsorPass by ID
+   * Requires permission: `partnerships:revokeSponsorPass` or `partnerships:*`
+   *
+   * Note: backend revokes (does not delete).
+   *
+   * @param payload.id - SponsorPass ID
+   *
+   * @example
+   * ```typescript
+   * await sdk.getPartnerships().revokeSponsorPass({ id: 123 });
+   * ```
+   */
+  async revokeSponsorPass(payload) {
+    return this.sdk.request("partnerships:revokeSponsorPass", payload);
+  }
+};
+
 // src/sdk.ts
 var FrontierSDK = class {
   constructor() {
@@ -482,6 +706,7 @@ var FrontierSDK = class {
     this.storage = new StorageAccess(this);
     this.chain = new ChainAccess(this);
     this.user = new UserAccess(this);
+    this.partnerships = new PartnershipsAccess(this);
     window.addEventListener("message", this.handleMessage);
     this.notifyReady();
   }
@@ -530,6 +755,12 @@ var FrontierSDK = class {
   getUser() {
     return this.user;
   }
+  /**
+   * Get partnerships access instance
+   */
+  getPartnerships() {
+    return this.partnerships;
+  }
   /**
    * Cleanup: Remove event listeners
    * Call this when your app is being destroyed
@@ -542,7 +773,9 @@ var FrontierSDK = class {
 export {
   ChainAccess,
   FrontierSDK,
+  PartnershipsAccess,
   StorageAccess,
+  SwapResultStatus,
   UserAccess,
   WalletAccess,
   createStandaloneHTML,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontiertower/frontier-sdk",
-  "version": "0.3.3",
+  "version": "0.5.0",
   "description": "SDK for building apps on Frontier Wallet",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -47,8 +47,5 @@
     "type": "git",
     "url": "git+https://github.com/BerlinhouseLabs/frontier-sdk.git"
   },
-  "readme": "README.md",
-  "dependencies": {
-    "@frontiertower/frontier-sdk": "^0.3.0"
-  }
+  "readme": "README.md"
 }