@frontiertower/frontier-sdk 0.3.4 → 0.7.0

package/dist/index.js

@@ -22,7 +22,10 @@ var index_exports = {};
 __export(index_exports, {
   ChainAccess: () => ChainAccess,
   FrontierSDK: () => FrontierSDK,
+  PartnershipsAccess: () => PartnershipsAccess,
   StorageAccess: () => StorageAccess,
+  SwapResultStatus: () => SwapResultStatus,
+  ThirdPartyAccess: () => ThirdPartyAccess,
   UserAccess: () => UserAccess,
   WalletAccess: () => WalletAccess,
   createStandaloneHTML: () => createStandaloneHTML,
@@ -33,6 +36,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 +271,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 +615,395 @@ 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/access/third-party.ts
+var ThirdPartyAccess = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  // ===========================================================================
+  // Developer Methods
+  // ===========================================================================
+  /**
+   * List developer accounts (paginated)
+   * Requires permission: `thirdParty:listDevelopers` or `thirdParty:*`
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @returns Paginated response of developers
+   *
+   * @example
+   * ```typescript
+   * const developers = await sdk.getThirdParty().listDevelopers({ limit: 20, offset: 0 });
+   * console.log('Total developers:', developers.count);
+   * ```
+   */
+  async listDevelopers(payload) {
+    return this.sdk.request("thirdParty:listDevelopers", payload);
+  }
+  /**
+   * Get developer details by ID
+   * Requires permission: `thirdParty:getDeveloper` or `thirdParty:*`
+   *
+   * @param payload.id - Developer ID
+   * @returns Developer details
+   *
+   * @example
+   * ```typescript
+   * const developer = await sdk.getThirdParty().getDeveloper({ id: 123 });
+   * console.log('Developer:', developer.name);
+   * ```
+   */
+  async getDeveloper(payload) {
+    return this.sdk.request("thirdParty:getDeveloper", payload);
+  }
+  /**
+   * Update developer information
+   * Requires permission: `thirdParty:updateDeveloper` or `thirdParty:*`
+   *
+   * @param payload.id - Developer ID
+   * @param payload.data - Update data
+   * @returns Updated developer
+   *
+   * @example
+   * ```typescript
+   * const developer = await sdk.getThirdParty().updateDeveloper({
+   *   id: 123,
+   *   data: { name: 'New Name', website: 'https://example.com' }
+   * });
+   * ```
+   */
+  async updateDeveloper(payload) {
+    return this.sdk.request("thirdParty:updateDeveloper", payload);
+  }
+  /**
+   * Rotate developer API key
+   * Requires permission: `thirdParty:rotateDeveloperApiKey` or `thirdParty:*`
+   *
+   * Note: The new API key is only shown once in the response
+   *
+   * @param payload.id - Developer ID
+   * @returns Response containing the new API key
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.getThirdParty().rotateDeveloperApiKey({ id: 123 });
+   * console.log('New API key:', result.apiKey);
+   * // Store this key securely - it won't be shown again!
+   * ```
+   */
+  async rotateDeveloperApiKey(payload) {
+    return this.sdk.request("thirdParty:rotateDeveloperApiKey", payload);
+  }
+  // ===========================================================================
+  // App Methods
+  // ===========================================================================
+  /**
+   * List registered apps (paginated)
+   * Requires permission: `thirdParty:listApps` or `thirdParty:*`
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @param payload.developerId - Filter by developer ID
+   * @returns Paginated response of apps
+   *
+   * @example
+   * ```typescript
+   * const apps = await sdk.getThirdParty().listApps({ limit: 20, offset: 0 });
+   * console.log('Total apps:', apps.count);
+   *
+   * // Filter by developer
+   * const devApps = await sdk.getThirdParty().listApps({ developerId: 123 });
+   * ```
+   */
+  async listApps(payload) {
+    return this.sdk.request("thirdParty:listApps", payload);
+  }
+  /**
+   * Register a new app
+   * Requires permission: `thirdParty:createApp` or `thirdParty:*`
+   *
+   * Note: App name, description, and icon are automatically fetched from the URL's metadata
+   *
+   * @param payload - App creation payload with URL
+   * @returns Created app
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().createApp({
+   *   url: 'https://myapp.example.com'
+   * });
+   * console.log('Created app:', app.id, app.name);
+   * ```
+   */
+  async createApp(payload) {
+    return this.sdk.request("thirdParty:createApp", payload);
+  }
+  /**
+   * Get app details by ID
+   * Requires permission: `thirdParty:getApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   * @returns App details
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().getApp({ id: 123 });
+   * console.log('App:', app.name, app.status);
+   * ```
+   */
+  async getApp(payload) {
+    return this.sdk.request("thirdParty:getApp", payload);
+  }
+  /**
+   * Update an app
+   * Requires permission: `thirdParty:updateApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   * @param payload.data - Update data
+   * @returns Updated app
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().updateApp({
+   *   id: 123,
+   *   data: { name: 'Updated App Name', description: 'New description' }
+   * });
+   * ```
+   */
+  async updateApp(payload) {
+    return this.sdk.request("thirdParty:updateApp", payload);
+  }
+  /**
+   * Request app deactivation
+   * Requires permission: `thirdParty:deleteApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   *
+   * @example
+   * ```typescript
+   * await sdk.getThirdParty().deleteApp({ id: 123 });
+   * ```
+   */
+  async deleteApp(payload) {
+    return this.sdk.request("thirdParty:deleteApp", payload);
+  }
+  // ===========================================================================
+  // Webhook Methods
+  // ===========================================================================
+  /**
+   * List webhooks (paginated)
+   * Requires permission: `thirdParty:listWebhooks` or `thirdParty:*`
+   *
+   * Note: Maximum 3 webhooks per developer account
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @param payload.developerId - Filter by developer ID
+   * @returns Paginated response of webhooks
+   *
+   * @example
+   * ```typescript
+   * const webhooks = await sdk.getThirdParty().listWebhooks({ limit: 10, offset: 0 });
+   * console.log('Total webhooks:', webhooks.count);
+   *
+   * // Filter by developer
+   * const devWebhooks = await sdk.getThirdParty().listWebhooks({ developerId: 123 });
+   * ```
+   */
+  async listWebhooks(payload) {
+    return this.sdk.request("thirdParty:listWebhooks", payload);
+  }
+  /**
+   * Create a new webhook
+   * Requires permission: `thirdParty:createWebhook` or `thirdParty:*`
+   *
+   * Note: New webhooks require admin approval before going live
+   *
+   * @param payload - Webhook creation payload
+   * @returns Created webhook
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().createWebhook({
+   *   url: 'https://myapp.example.com/webhooks',
+   *   events: ['app.approved', 'user.registered']
+   * });
+   * console.log('Created webhook:', webhook.id);
+   * ```
+   */
+  async createWebhook(payload) {
+    return this.sdk.request("thirdParty:createWebhook", payload);
+  }
+  /**
+   * Get webhook details by ID
+   * Requires permission: `thirdParty:getWebhook` or `thirdParty:*`
+   *
+   * @param payload.id - Webhook ID
+   * @returns Webhook details
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().getWebhook({ id: 123 });
+   * console.log('Webhook:', webhook.url, webhook.status);
+   * ```
+   */
+  async getWebhook(payload) {
+    return this.sdk.request("thirdParty:getWebhook", payload);
+  }
+  /**
+   * Update a webhook
+   * Requires permission: `thirdParty:updateWebhook` or `thirdParty:*`
+   *
+   * Note: Config changes require admin approval before going live
+   *
+   * @param payload.id - Webhook ID
+   * @param payload.data - Update data
+   * @returns Updated webhook
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().updateWebhook({
+   *   id: 123,
+   *   data: { url: 'https://newurl.example.com/webhooks' }
+   * });
+   * ```
+   */
+  async updateWebhook(payload) {
+    return this.sdk.request("thirdParty:updateWebhook", payload);
+  }
+  /**
+   * Delete a webhook
+   * Requires permission: `thirdParty:deleteWebhook` or `thirdParty:*`
+   *
+   * @param payload.id - Webhook ID
+   *
+   * @example
+   * ```typescript
+   * await sdk.getThirdParty().deleteWebhook({ id: 123 });
+   * ```
+   */
+  async deleteWebhook(payload) {
+    return this.sdk.request("thirdParty:deleteWebhook", payload);
+  }
+  /**
+   * Rotate webhook signing key
+   * Requires permission: `thirdParty:rotateWebhookSigningKey` or `thirdParty:*`
+   *
+   * Note: The new signing public key is returned in the response
+   *
+   * @param payload.id - Webhook ID
+   * @returns Response containing the new signing public key
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.getThirdParty().rotateWebhookSigningKey({ id: 123 });
+   * console.log('New signing key:', result.signingPublicKey);
+   * ```
+   */
+  async rotateWebhookSigningKey(payload) {
+    return this.sdk.request("thirdParty:rotateWebhookSigningKey", payload);
+  }
+};
+
 // src/sdk.ts
 var FrontierSDK = class {
   constructor() {
@@ -509,6 +1026,8 @@ var FrontierSDK = class {
     this.storage = new StorageAccess(this);
     this.chain = new ChainAccess(this);
     this.user = new UserAccess(this);
+    this.partnerships = new PartnershipsAccess(this);
+    this.thirdParty = new ThirdPartyAccess(this);
     window.addEventListener("message", this.handleMessage);
     this.notifyReady();
   }
@@ -557,6 +1076,18 @@ var FrontierSDK = class {
   getUser() {
     return this.user;
   }
+  /**
+   * Get partnerships access instance
+   */
+  getPartnerships() {
+    return this.partnerships;
+  }
+  /**
+   * Get third-party access instance
+   */
+  getThirdParty() {
+    return this.thirdParty;
+  }
   /**
    * Cleanup: Remove event listeners
    * Call this when your app is being destroyed
@@ -779,7 +1310,10 @@ function createStandaloneHTML(appName = "Frontier App") {
 0 && (module.exports = {
   ChainAccess,
   FrontierSDK,
+  PartnershipsAccess,
   StorageAccess,
+  SwapResultStatus,
+  ThirdPartyAccess,
   UserAccess,
   WalletAccess,
   createStandaloneHTML,