@swarmvault/sdk 0.1.0

package/dist/index.cjs

@@ -0,0 +1,372 @@
+'use strict';
+
+// src/types.ts
+var SwarmVaultError = class extends Error {
+  errorCode;
+  statusCode;
+  details;
+  constructor(message, options) {
+    super(message);
+    this.name = "SwarmVaultError";
+    this.errorCode = options?.errorCode;
+    this.statusCode = options?.statusCode;
+    this.details = options?.details;
+  }
+};
+var NATIVE_ETH_ADDRESS = "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE";
+var BASE_MAINNET_TOKENS = {
+  ETH: NATIVE_ETH_ADDRESS,
+  WETH: "0x4200000000000000000000000000000000000006",
+  USDC: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+  DAI: "0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb",
+  USDbC: "0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA",
+  cbETH: "0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22"
+};
+var BASE_SEPOLIA_TOKENS = {
+  ETH: NATIVE_ETH_ADDRESS,
+  WETH: "0x4200000000000000000000000000000000000006",
+  USDC: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.swarmvault.xyz";
+var DEFAULT_TIMEOUT_MS = 3e5;
+var DEFAULT_POLL_INTERVAL_MS = 3e3;
+var SwarmVaultClient = class {
+  baseUrl;
+  apiKey;
+  jwt;
+  fetchFn;
+  /**
+   * Create a new Swarm Vault client.
+   *
+   * @param options - Client configuration options
+   * @param options.baseUrl - Base URL of the API (default: https://api.swarmvault.xyz)
+   * @param options.apiKey - API key for authentication (recommended)
+   * @param options.jwt - JWT token for authentication (alternative to API key)
+   */
+  constructor(options = {}) {
+    this.baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.jwt = options.jwt;
+    this.fetchFn = options.fetch || globalThis.fetch;
+    if (!this.fetchFn) {
+      throw new SwarmVaultError(
+        "fetch is not available. Please provide a fetch implementation or use Node.js 18+."
+      );
+    }
+  }
+  // ===========================================================================
+  // Authentication
+  // ===========================================================================
+  /**
+   * Set the API key for authentication.
+   * API keys start with 'svk_' and can be generated in the Swarm Vault settings.
+   *
+   * @param apiKey - The API key
+   */
+  setApiKey(apiKey) {
+    this.apiKey = apiKey;
+    this.jwt = void 0;
+  }
+  /**
+   * Set the JWT token for authentication.
+   * JWTs are obtained through the SIWE login flow.
+   *
+   * @param jwt - The JWT token
+   */
+  setJwt(jwt) {
+    this.jwt = jwt;
+    this.apiKey = void 0;
+  }
+  /**
+   * Get the currently authenticated user.
+   *
+   * @returns The authenticated user
+   * @throws {SwarmVaultError} If not authenticated or request fails
+   */
+  async getMe() {
+    return this.request("GET", "/api/auth/me");
+  }
+  // ===========================================================================
+  // Swarms
+  // ===========================================================================
+  /**
+   * List all swarms. Returns public swarms for unauthenticated requests,
+   * or includes management status for authenticated requests.
+   *
+   * @returns Array of swarms
+   */
+  async listSwarms() {
+    return this.request("GET", "/api/swarms");
+  }
+  /**
+   * Get details of a specific swarm.
+   *
+   * @param swarmId - The swarm ID
+   * @returns Swarm details
+   * @throws {SwarmVaultError} If swarm not found
+   */
+  async getSwarm(swarmId) {
+    return this.request("GET", `/api/swarms/${swarmId}`);
+  }
+  /**
+   * Get members of a swarm.
+   * **Manager only** - requires authentication as a swarm manager.
+   *
+   * @param swarmId - The swarm ID
+   * @returns Array of swarm members
+   * @throws {SwarmVaultError} If not authorized or swarm not found
+   */
+  async getSwarmMembers(swarmId) {
+    return this.request("GET", `/api/swarms/${swarmId}/members`);
+  }
+  /**
+   * Get aggregate token holdings across all swarm members.
+   * **Manager only** - requires authentication as a swarm manager.
+   *
+   * @param swarmId - The swarm ID
+   * @returns Aggregated holdings with ETH balance, token balances, and common tokens
+   * @throws {SwarmVaultError} If not authorized or swarm not found
+   */
+  async getSwarmHoldings(swarmId) {
+    return this.request("GET", `/api/swarms/${swarmId}/holdings`);
+  }
+  // ===========================================================================
+  // Swaps
+  // ===========================================================================
+  /**
+   * Preview a swap for all swarm members without executing it.
+   * **Manager only** - requires authentication as a swarm manager.
+   *
+   * Use this to see expected amounts before executing a swap.
+   *
+   * @param swarmId - The swarm ID
+   * @param params - Swap parameters
+   * @param params.sellToken - Token address to sell (use NATIVE_ETH_ADDRESS for ETH)
+   * @param params.buyToken - Token address to buy
+   * @param params.sellPercentage - Percentage of balance to sell (1-100, default 100)
+   * @param params.slippagePercentage - Slippage tolerance (default 1%)
+   * @returns Preview with per-member amounts and totals
+   *
+   * @example
+   * ```typescript
+   * const preview = await client.previewSwap('swarm-id', {
+   *   sellToken: BASE_MAINNET_TOKENS.USDC,
+   *   buyToken: BASE_MAINNET_TOKENS.WETH,
+   *   sellPercentage: 50,
+   *   slippagePercentage: 1,
+   * });
+   *
+   * console.log(`Total sell: ${preview.totalSellAmount}`);
+   * console.log(`Expected buy: ${preview.totalBuyAmount}`);
+   * console.log(`Success: ${preview.successCount}, Errors: ${preview.errorCount}`);
+   * ```
+   */
+  async previewSwap(swarmId, params) {
+    return this.request("POST", `/api/swarms/${swarmId}/swap/preview`, {
+      sellToken: params.sellToken,
+      buyToken: params.buyToken,
+      sellPercentage: params.sellPercentage ?? 100,
+      slippagePercentage: params.slippagePercentage ?? 1
+    });
+  }
+  /**
+   * Execute a swap for all swarm members.
+   * **Manager only** - requires authentication as a swarm manager.
+   *
+   * The swap is executed asynchronously. Use `waitForTransaction` to wait for completion.
+   *
+   * A platform fee (default 0.5%) is deducted from the buy token amount.
+   *
+   * @param swarmId - The swarm ID
+   * @param params - Swap parameters
+   * @param params.sellToken - Token address to sell
+   * @param params.buyToken - Token address to buy
+   * @param params.sellPercentage - Percentage of balance to sell (1-100, default 100)
+   * @param params.slippagePercentage - Slippage tolerance (default 1%)
+   * @returns Transaction ID and status
+   *
+   * @example
+   * ```typescript
+   * // Execute swap
+   * const result = await client.executeSwap('swarm-id', {
+   *   sellToken: BASE_MAINNET_TOKENS.USDC,
+   *   buyToken: BASE_MAINNET_TOKENS.WETH,
+   *   sellPercentage: 50,
+   * });
+   *
+   * console.log(`Transaction started: ${result.transactionId}`);
+   *
+   * // Wait for completion
+   * const tx = await client.waitForTransaction(result.transactionId, {
+   *   onPoll: (t) => console.log(`Status: ${t.status}`),
+   * });
+   *
+   * console.log(`Transaction ${tx.status}`);
+   * ```
+   */
+  async executeSwap(swarmId, params) {
+    return this.request("POST", `/api/swarms/${swarmId}/swap/execute`, {
+      sellToken: params.sellToken,
+      buyToken: params.buyToken,
+      sellPercentage: params.sellPercentage ?? 100,
+      slippagePercentage: params.slippagePercentage ?? 1
+    });
+  }
+  // ===========================================================================
+  // Transactions
+  // ===========================================================================
+  /**
+   * Execute a raw transaction template for all swarm members.
+   * **Manager only** - requires authentication as a swarm manager.
+   *
+   * This is an advanced method for custom transactions. For swaps, prefer `executeSwap`.
+   *
+   * @param swarmId - The swarm ID
+   * @param template - Transaction template (ABI mode or raw calldata mode)
+   * @returns Transaction ID and status
+   *
+   * @example
+   * ```typescript
+   * // ABI mode example - transfer tokens
+   * const result = await client.executeTransaction('swarm-id', {
+   *   mode: 'abi',
+   *   contractAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+   *   abi: [{
+   *     name: 'transfer',
+   *     type: 'function',
+   *     inputs: [
+   *       { name: 'to', type: 'address' },
+   *       { name: 'amount', type: 'uint256' },
+   *     ],
+   *     outputs: [{ type: 'bool' }],
+   *   }],
+   *   functionName: 'transfer',
+   *   args: ['0xRecipient', '{{percentage:tokenBalance:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913:50}}'],
+   *   value: '0',
+   * });
+   * ```
+   */
+  async executeTransaction(swarmId, template) {
+    return this.request(
+      "POST",
+      `/api/swarms/${swarmId}/transactions`,
+      template
+    );
+  }
+  /**
+   * List transactions for a swarm.
+   *
+   * @param swarmId - The swarm ID
+   * @returns Array of transactions
+   */
+  async listTransactions(swarmId) {
+    return this.request("GET", `/api/swarms/${swarmId}/transactions`);
+  }
+  /**
+   * Get details of a specific transaction, including per-member status.
+   *
+   * @param transactionId - The transaction ID
+   * @returns Transaction details with targets
+   */
+  async getTransaction(transactionId) {
+    return this.request("GET", `/api/transactions/${transactionId}`);
+  }
+  /**
+   * Wait for a transaction to complete.
+   *
+   * Polls the transaction status until it reaches COMPLETED or FAILED,
+   * or until the timeout is reached.
+   *
+   * @param transactionId - The transaction ID
+   * @param options - Wait options
+   * @param options.timeoutMs - Maximum wait time (default 5 minutes)
+   * @param options.pollIntervalMs - Polling interval (default 3 seconds)
+   * @param options.onPoll - Callback called on each poll
+   * @returns The completed transaction
+   * @throws {SwarmVaultError} If timeout is reached or transaction fails
+   *
+   * @example
+   * ```typescript
+   * const tx = await client.waitForTransaction(transactionId, {
+   *   timeoutMs: 60000, // 1 minute
+   *   pollIntervalMs: 2000, // 2 seconds
+   *   onPoll: (t) => {
+   *     const confirmed = t.targets?.filter(t => t.status === 'CONFIRMED').length ?? 0;
+   *     const total = t.targets?.length ?? 0;
+   *     console.log(`Progress: ${confirmed}/${total}`);
+   *   },
+   * });
+   * ```
+   */
+  async waitForTransaction(transactionId, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const startTime = Date.now();
+    while (true) {
+      const transaction = await this.getTransaction(transactionId);
+      if (options.onPoll) {
+        options.onPoll(transaction);
+      }
+      if (transaction.status === "COMPLETED") {
+        return transaction;
+      }
+      if (transaction.status === "FAILED") {
+        throw new SwarmVaultError(`Transaction failed: ${transactionId}`, {
+          errorCode: "TX_FAILED",
+          details: transaction.targets?.filter((t) => t.error)
+        });
+      }
+      if (Date.now() - startTime > timeoutMs) {
+        throw new SwarmVaultError(
+          `Transaction timeout: ${transactionId} did not complete within ${timeoutMs}ms`,
+          {
+            errorCode: "TX_TIMEOUT",
+            details: { lastStatus: transaction.status }
+          }
+        );
+      }
+      await this.sleep(pollIntervalMs);
+    }
+  }
+  // ===========================================================================
+  // Private Methods
+  // ===========================================================================
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.apiKey) {
+      headers["Authorization"] = `Bearer ${this.apiKey}`;
+    } else if (this.jwt) {
+      headers["Authorization"] = `Bearer ${this.jwt}`;
+    }
+    const response = await this.fetchFn(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    const data = await response.json();
+    if (!response.ok || !data.success) {
+      throw new SwarmVaultError(data.error || `Request failed with status ${response.status}`, {
+        errorCode: data.errorCode,
+        statusCode: response.status,
+        details: data.details
+      });
+    }
+    return data.data;
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+exports.BASE_MAINNET_TOKENS = BASE_MAINNET_TOKENS;
+exports.BASE_SEPOLIA_TOKENS = BASE_SEPOLIA_TOKENS;
+exports.NATIVE_ETH_ADDRESS = NATIVE_ETH_ADDRESS;
+exports.SwarmVaultClient = SwarmVaultClient;
+exports.SwarmVaultError = SwarmVaultError;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Swarm Vault SDK Types\n */\n\n// ============================================================================\n// Core Types\n// ============================================================================\n\nexport interface User {\n  id: string;\n  walletAddress: string;\n  twitterId: string | null;\n  twitterUsername: string | null;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface Swarm {\n  id: string;\n  name: string;\n  description: string;\n  createdAt: string;\n  updatedAt: string;\n  manager?: {\n    id: string;\n    walletAddress: string;\n    twitterUsername: string | null;\n  };\n  memberCount?: number;\n  isManager?: boolean;\n}\n\nexport interface SwarmMember {\n  id: string;\n  swarmId: string;\n  userId: string;\n  agentWalletAddress: string;\n  status: \"ACTIVE\" | \"LEFT\";\n  joinedAt: string;\n  user?: {\n    id: string;\n    walletAddress: string;\n  };\n}\n\n// ============================================================================\n// Transaction Types\n// ============================================================================\n\nexport type TransactionStatus = \"PENDING\" | \"PROCESSING\" | \"COMPLETED\" | \"FAILED\";\nexport type TransactionTargetStatus = \"PENDING\" | \"SUBMITTED\" | \"CONFIRMED\" | \"FAILED\";\n\nexport interface Transaction {\n  id: string;\n  swarmId: string;\n  status: TransactionStatus;\n  template: TransactionTemplate;\n  createdAt: string;\n  updatedAt: string;\n  targets?: TransactionTarget[];\n}\n\nexport interface TransactionTarget {\n  id: string;\n  transactionId: string;\n  membershipId: string;\n  userOpHash: string | null;\n  txHash: string | null;\n  status: TransactionTargetStatus;\n  error: string | null;\n  createdAt: string;\n  updatedAt: string;\n  membership?: {\n    agentWalletAddress: string;\n    user?: {\n      walletAddress: string;\n    };\n  };\n}\n\nexport interface ABITransactionTemplate {\n  mode: \"abi\";\n  contractAddress: string;\n  abi: unknown[];\n  functionName: string;\n  args: unknown[];\n  value: string;\n}\n\nexport interface RawTransactionTemplate {\n  mode: \"raw\";\n  contractAddress: string;\n  data: string;\n  value: string;\n}\n\nexport type TransactionTemplate = ABITransactionTemplate | RawTransactionTemplate;\n\n// ============================================================================\n// Swap Types\n// ============================================================================\n\nexport interface SwapPreviewParams {\n  /** Token address to sell (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH) */\n  sellToken: string;\n  /** Token address to buy */\n  buyToken: string;\n  /** Percentage of token balance to sell (1-100, default 100) */\n  sellPercentage?: number;\n  /** Slippage tolerance percentage (default 1) */\n  slippagePercentage?: number;\n}\n\nexport interface SwapExecuteParams extends SwapPreviewParams {}\n\nexport interface SwapMemberPreview {\n  membershipId: string;\n  userId: string;\n  userWalletAddress: string;\n  agentWalletAddress: string;\n  sellAmount: string;\n  buyAmount: string;\n  feeAmount?: string;\n  estimatedPriceImpact?: number;\n  sources?: string[];\n  error?: string;\n}\n\nexport interface SwapFeeInfo {\n  bps: number;\n  percentage: string;\n  recipientAddress: string;\n}\n\nexport interface SwapPreviewResult {\n  sellToken: string;\n  buyToken: string;\n  sellPercentage: number;\n  slippagePercentage: number;\n  members: SwapMemberPreview[];\n  totalSellAmount: string;\n  totalBuyAmount: string;\n  totalFeeAmount?: string;\n  successCount: number;\n  errorCount: number;\n  fee: SwapFeeInfo | null;\n}\n\nexport interface SwapExecuteResult {\n  transactionId: string;\n  status: \"PENDING\";\n  memberCount: number;\n  message: string;\n  fee: SwapFeeInfo | null;\n}\n\n// ============================================================================\n// Holdings Types\n// ============================================================================\n\nexport interface TokenInfo {\n  address: string;\n  symbol: string;\n  name: string;\n  decimals: number;\n  logoUrl?: string;\n}\n\nexport interface TokenHolding extends TokenInfo {\n  totalBalance: string;\n  holderCount: number;\n}\n\nexport interface SwarmHoldings {\n  ethBalance: string;\n  tokens: TokenHolding[];\n  memberCount: number;\n  commonTokens: TokenInfo[];\n}\n\n// ============================================================================\n// API Response Types\n// ============================================================================\n\nexport interface ApiResponse<T> {\n  success: boolean;\n  data?: T;\n  error?: string;\n  errorCode?: string;\n  details?: unknown;\n}\n\n// ============================================================================\n// Client Options\n// ============================================================================\n\nexport interface SwarmVaultClientOptions {\n  /** Base URL of the Swarm Vault API (default: https://api.swarmvault.xyz) */\n  baseUrl?: string;\n  /** API key for authentication (starts with 'svk_') */\n  apiKey?: string;\n  /** JWT token for authentication (alternative to API key) */\n  jwt?: string;\n  /** Custom fetch function (for testing or custom implementations) */\n  fetch?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;\n}\n\nexport interface WaitForTransactionOptions {\n  /** Maximum time to wait in milliseconds (default: 300000 = 5 minutes) */\n  timeoutMs?: number;\n  /** Polling interval in milliseconds (default: 3000 = 3 seconds) */\n  pollIntervalMs?: number;\n  /** Callback called on each poll with current status */\n  onPoll?: (transaction: Transaction) => void;\n}\n\n// ============================================================================\n// Error Types\n// ============================================================================\n\nexport class SwarmVaultError extends Error {\n  public readonly errorCode?: string;\n  public readonly statusCode?: number;\n  public readonly details?: unknown;\n\n  constructor(\n    message: string,\n    options?: {\n      errorCode?: string;\n      statusCode?: number;\n      details?: unknown;\n    }\n  ) {\n    super(message);\n    this.name = \"SwarmVaultError\";\n    this.errorCode = options?.errorCode;\n    this.statusCode = options?.statusCode;\n    this.details = options?.details;\n  }\n}\n\n// ============================================================================\n// Common Token Addresses\n// ============================================================================\n\n/** Native ETH address used in swap APIs */\nexport const NATIVE_ETH_ADDRESS = \"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE\";\n\n/** Common token addresses on Base Mainnet */\nexport const BASE_MAINNET_TOKENS = {\n  ETH: NATIVE_ETH_ADDRESS,\n  WETH: \"0x4200000000000000000000000000000000000006\",\n  USDC: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n  DAI: \"0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb\",\n  USDbC: \"0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA\",\n  cbETH: \"0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22\",\n} as const;\n\n/** Common token addresses on Base Sepolia (testnet) */\nexport const BASE_SEPOLIA_TOKENS = {\n  ETH: NATIVE_ETH_ADDRESS,\n  WETH: \"0x4200000000000000000000000000000000000006\",\n  USDC: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\",\n} as const;\n","/**\n * Swarm Vault SDK Client\n *\n * A TypeScript client for the Swarm Vault API, enabling managers to execute\n * swaps and transactions on behalf of their swarm members.\n *\n * @example\n * ```typescript\n * import { SwarmVaultClient } from '@swarmvault/sdk';\n *\n * const client = new SwarmVaultClient({\n *   apiKey: 'svk_your_api_key_here',\n * });\n *\n * // Get swarm holdings\n * const holdings = await client.getSwarmHoldings('swarm-id');\n *\n * // Execute a swap\n * const result = await client.executeSwap('swarm-id', {\n *   sellToken: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC\n *   buyToken: '0x4200000000000000000000000000000000000006',   // WETH\n *   sellPercentage: 50,\n * });\n *\n * // Wait for completion\n * const tx = await client.waitForTransaction(result.transactionId);\n * ```\n */\n\nimport type {\n  ApiResponse,\n  Swarm,\n  SwarmMember,\n  SwarmHoldings,\n  SwapPreviewParams,\n  SwapPreviewResult,\n  SwapExecuteParams,\n  SwapExecuteResult,\n  Transaction,\n  TransactionTemplate,\n  User,\n  SwarmVaultClientOptions,\n  WaitForTransactionOptions,\n} from \"./types.js\";\nimport { SwarmVaultError } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.swarmvault.xyz\";\nconst DEFAULT_TIMEOUT_MS = 300000; // 5 minutes\nconst DEFAULT_POLL_INTERVAL_MS = 3000; // 3 seconds\n\ntype FetchFn = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;\n\nexport class SwarmVaultClient {\n  private baseUrl: string;\n  private apiKey?: string;\n  private jwt?: string;\n  private fetchFn: FetchFn;\n\n  /**\n   * Create a new Swarm Vault client.\n   *\n   * @param options - Client configuration options\n   * @param options.baseUrl - Base URL of the API (default: https://api.swarmvault.xyz)\n   * @param options.apiKey - API key for authentication (recommended)\n   * @param options.jwt - JWT token for authentication (alternative to API key)\n   */\n  constructor(options: SwarmVaultClientOptions = {}) {\n    this.baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\\/$/, \"\");\n    this.apiKey = options.apiKey;\n    this.jwt = options.jwt;\n    this.fetchFn = options.fetch || (globalThis.fetch as FetchFn);\n\n    if (!this.fetchFn) {\n      throw new SwarmVaultError(\n        \"fetch is not available. Please provide a fetch implementation or use Node.js 18+.\"\n      );\n    }\n  }\n\n  // ===========================================================================\n  // Authentication\n  // ===========================================================================\n\n  /**\n   * Set the API key for authentication.\n   * API keys start with 'svk_' and can be generated in the Swarm Vault settings.\n   *\n   * @param apiKey - The API key\n   */\n  setApiKey(apiKey: string): void {\n    this.apiKey = apiKey;\n    this.jwt = undefined;\n  }\n\n  /**\n   * Set the JWT token for authentication.\n   * JWTs are obtained through the SIWE login flow.\n   *\n   * @param jwt - The JWT token\n   */\n  setJwt(jwt: string): void {\n    this.jwt = jwt;\n    this.apiKey = undefined;\n  }\n\n  /**\n   * Get the currently authenticated user.\n   *\n   * @returns The authenticated user\n   * @throws {SwarmVaultError} If not authenticated or request fails\n   */\n  async getMe(): Promise<User> {\n    return this.request<User>(\"GET\", \"/api/auth/me\");\n  }\n\n  // ===========================================================================\n  // Swarms\n  // ===========================================================================\n\n  /**\n   * List all swarms. Returns public swarms for unauthenticated requests,\n   * or includes management status for authenticated requests.\n   *\n   * @returns Array of swarms\n   */\n  async listSwarms(): Promise<Swarm[]> {\n    return this.request<Swarm[]>(\"GET\", \"/api/swarms\");\n  }\n\n  /**\n   * Get details of a specific swarm.\n   *\n   * @param swarmId - The swarm ID\n   * @returns Swarm details\n   * @throws {SwarmVaultError} If swarm not found\n   */\n  async getSwarm(swarmId: string): Promise<Swarm> {\n    return this.request<Swarm>(\"GET\", `/api/swarms/${swarmId}`);\n  }\n\n  /**\n   * Get members of a swarm.\n   * **Manager only** - requires authentication as a swarm manager.\n   *\n   * @param swarmId - The swarm ID\n   * @returns Array of swarm members\n   * @throws {SwarmVaultError} If not authorized or swarm not found\n   */\n  async getSwarmMembers(swarmId: string): Promise<SwarmMember[]> {\n    return this.request<SwarmMember[]>(\"GET\", `/api/swarms/${swarmId}/members`);\n  }\n\n  /**\n   * Get aggregate token holdings across all swarm members.\n   * **Manager only** - requires authentication as a swarm manager.\n   *\n   * @param swarmId - The swarm ID\n   * @returns Aggregated holdings with ETH balance, token balances, and common tokens\n   * @throws {SwarmVaultError} If not authorized or swarm not found\n   */\n  async getSwarmHoldings(swarmId: string): Promise<SwarmHoldings> {\n    return this.request<SwarmHoldings>(\"GET\", `/api/swarms/${swarmId}/holdings`);\n  }\n\n  // ===========================================================================\n  // Swaps\n  // ===========================================================================\n\n  /**\n   * Preview a swap for all swarm members without executing it.\n   * **Manager only** - requires authentication as a swarm manager.\n   *\n   * Use this to see expected amounts before executing a swap.\n   *\n   * @param swarmId - The swarm ID\n   * @param params - Swap parameters\n   * @param params.sellToken - Token address to sell (use NATIVE_ETH_ADDRESS for ETH)\n   * @param params.buyToken - Token address to buy\n   * @param params.sellPercentage - Percentage of balance to sell (1-100, default 100)\n   * @param params.slippagePercentage - Slippage tolerance (default 1%)\n   * @returns Preview with per-member amounts and totals\n   *\n   * @example\n   * ```typescript\n   * const preview = await client.previewSwap('swarm-id', {\n   *   sellToken: BASE_MAINNET_TOKENS.USDC,\n   *   buyToken: BASE_MAINNET_TOKENS.WETH,\n   *   sellPercentage: 50,\n   *   slippagePercentage: 1,\n   * });\n   *\n   * console.log(`Total sell: ${preview.totalSellAmount}`);\n   * console.log(`Expected buy: ${preview.totalBuyAmount}`);\n   * console.log(`Success: ${preview.successCount}, Errors: ${preview.errorCount}`);\n   * ```\n   */\n  async previewSwap(swarmId: string, params: SwapPreviewParams): Promise<SwapPreviewResult> {\n    return this.request<SwapPreviewResult>(\"POST\", `/api/swarms/${swarmId}/swap/preview`, {\n      sellToken: params.sellToken,\n      buyToken: params.buyToken,\n      sellPercentage: params.sellPercentage ?? 100,\n      slippagePercentage: params.slippagePercentage ?? 1,\n    });\n  }\n\n  /**\n   * Execute a swap for all swarm members.\n   * **Manager only** - requires authentication as a swarm manager.\n   *\n   * The swap is executed asynchronously. Use `waitForTransaction` to wait for completion.\n   *\n   * A platform fee (default 0.5%) is deducted from the buy token amount.\n   *\n   * @param swarmId - The swarm ID\n   * @param params - Swap parameters\n   * @param params.sellToken - Token address to sell\n   * @param params.buyToken - Token address to buy\n   * @param params.sellPercentage - Percentage of balance to sell (1-100, default 100)\n   * @param params.slippagePercentage - Slippage tolerance (default 1%)\n   * @returns Transaction ID and status\n   *\n   * @example\n   * ```typescript\n   * // Execute swap\n   * const result = await client.executeSwap('swarm-id', {\n   *   sellToken: BASE_MAINNET_TOKENS.USDC,\n   *   buyToken: BASE_MAINNET_TOKENS.WETH,\n   *   sellPercentage: 50,\n   * });\n   *\n   * console.log(`Transaction started: ${result.transactionId}`);\n   *\n   * // Wait for completion\n   * const tx = await client.waitForTransaction(result.transactionId, {\n   *   onPoll: (t) => console.log(`Status: ${t.status}`),\n   * });\n   *\n   * console.log(`Transaction ${tx.status}`);\n   * ```\n   */\n  async executeSwap(swarmId: string, params: SwapExecuteParams): Promise<SwapExecuteResult> {\n    return this.request<SwapExecuteResult>(\"POST\", `/api/swarms/${swarmId}/swap/execute`, {\n      sellToken: params.sellToken,\n      buyToken: params.buyToken,\n      sellPercentage: params.sellPercentage ?? 100,\n      slippagePercentage: params.slippagePercentage ?? 1,\n    });\n  }\n\n  // ===========================================================================\n  // Transactions\n  // ===========================================================================\n\n  /**\n   * Execute a raw transaction template for all swarm members.\n   * **Manager only** - requires authentication as a swarm manager.\n   *\n   * This is an advanced method for custom transactions. For swaps, prefer `executeSwap`.\n   *\n   * @param swarmId - The swarm ID\n   * @param template - Transaction template (ABI mode or raw calldata mode)\n   * @returns Transaction ID and status\n   *\n   * @example\n   * ```typescript\n   * // ABI mode example - transfer tokens\n   * const result = await client.executeTransaction('swarm-id', {\n   *   mode: 'abi',\n   *   contractAddress: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n   *   abi: [{\n   *     name: 'transfer',\n   *     type: 'function',\n   *     inputs: [\n   *       { name: 'to', type: 'address' },\n   *       { name: 'amount', type: 'uint256' },\n   *     ],\n   *     outputs: [{ type: 'bool' }],\n   *   }],\n   *   functionName: 'transfer',\n   *   args: ['0xRecipient', '{{percentage:tokenBalance:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913:50}}'],\n   *   value: '0',\n   * });\n   * ```\n   */\n  async executeTransaction(\n    swarmId: string,\n    template: TransactionTemplate\n  ): Promise<{ transactionId: string; status: string }> {\n    return this.request<{ transactionId: string; status: string }>(\n      \"POST\",\n      `/api/swarms/${swarmId}/transactions`,\n      template\n    );\n  }\n\n  /**\n   * List transactions for a swarm.\n   *\n   * @param swarmId - The swarm ID\n   * @returns Array of transactions\n   */\n  async listTransactions(swarmId: string): Promise<Transaction[]> {\n    return this.request<Transaction[]>(\"GET\", `/api/swarms/${swarmId}/transactions`);\n  }\n\n  /**\n   * Get details of a specific transaction, including per-member status.\n   *\n   * @param transactionId - The transaction ID\n   * @returns Transaction details with targets\n   */\n  async getTransaction(transactionId: string): Promise<Transaction> {\n    return this.request<Transaction>(\"GET\", `/api/transactions/${transactionId}`);\n  }\n\n  /**\n   * Wait for a transaction to complete.\n   *\n   * Polls the transaction status until it reaches COMPLETED or FAILED,\n   * or until the timeout is reached.\n   *\n   * @param transactionId - The transaction ID\n   * @param options - Wait options\n   * @param options.timeoutMs - Maximum wait time (default 5 minutes)\n   * @param options.pollIntervalMs - Polling interval (default 3 seconds)\n   * @param options.onPoll - Callback called on each poll\n   * @returns The completed transaction\n   * @throws {SwarmVaultError} If timeout is reached or transaction fails\n   *\n   * @example\n   * ```typescript\n   * const tx = await client.waitForTransaction(transactionId, {\n   *   timeoutMs: 60000, // 1 minute\n   *   pollIntervalMs: 2000, // 2 seconds\n   *   onPoll: (t) => {\n   *     const confirmed = t.targets?.filter(t => t.status === 'CONFIRMED').length ?? 0;\n   *     const total = t.targets?.length ?? 0;\n   *     console.log(`Progress: ${confirmed}/${total}`);\n   *   },\n   * });\n   * ```\n   */\n  async waitForTransaction(\n    transactionId: string,\n    options: WaitForTransactionOptions = {}\n  ): Promise<Transaction> {\n    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    const startTime = Date.now();\n\n    while (true) {\n      const transaction = await this.getTransaction(transactionId);\n\n      if (options.onPoll) {\n        options.onPoll(transaction);\n      }\n\n      if (transaction.status === \"COMPLETED\") {\n        return transaction;\n      }\n\n      if (transaction.status === \"FAILED\") {\n        throw new SwarmVaultError(`Transaction failed: ${transactionId}`, {\n          errorCode: \"TX_FAILED\",\n          details: transaction.targets?.filter((t) => t.error),\n        });\n      }\n\n      if (Date.now() - startTime > timeoutMs) {\n        throw new SwarmVaultError(\n          `Transaction timeout: ${transactionId} did not complete within ${timeoutMs}ms`,\n          {\n            errorCode: \"TX_TIMEOUT\",\n            details: { lastStatus: transaction.status },\n          }\n        );\n      }\n\n      await this.sleep(pollIntervalMs);\n    }\n  }\n\n  // ===========================================================================\n  // Private Methods\n  // ===========================================================================\n\n  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n    };\n\n    // Add authorization header\n    if (this.apiKey) {\n      headers[\"Authorization\"] = `Bearer ${this.apiKey}`;\n    } else if (this.jwt) {\n      headers[\"Authorization\"] = `Bearer ${this.jwt}`;\n    }\n\n    const response = await this.fetchFn(url, {\n      method,\n      headers,\n      body: body ? JSON.stringify(body) : undefined,\n    });\n\n    const data = (await response.json()) as ApiResponse<T>;\n\n    if (!response.ok || !data.success) {\n      throw new SwarmVaultError(data.error || `Request failed with status ${response.status}`, {\n        errorCode: data.errorCode,\n        statusCode: response.status,\n        details: data.details,\n      });\n    }\n\n    return data.data as T;\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"]}