@opendatalabs/vana-sdk 0.1.0-alpha.9b6ddbc → 0.1.0-alpha.9bbda27

package/dist/controllers/accessSettlement.js

@@ -0,0 +1,265 @@
+import { getContract } from "viem";
+import { BaseController } from "./base";
+import { BlockchainError } from "../errors";
+import { getContractAddress } from "../generated/addresses";
+import { getAbi } from "../generated/abi";
+class AccessSettlementController extends BaseController {
+  /**
+   * Get invoice details for an operation
+   *
+   * @remarks
+   * Retrieves the payment invoice created by the runtime after an operation completes.
+   * The invoice contains the final price, payment token, and settlement status.
+   *
+   * @param operationId - Operation identifier (from runtime API)
+   * @returns Invoice details including price and settlement status
+   * @throws {BlockchainError} When invoice retrieval fails
+   *
+   * @example
+   * ```typescript
+   * const invoice = await sdk.accessSettlement.getOperationInvoice("op_abc123");
+   * console.log(`Price: ${invoice.price} wei`);
+   * console.log(`Issuer: ${invoice.issuer}`);
+   * console.log(`Settled: ${invoice.isSettled}`);
+   *
+   * // Convert price to VANA for display
+   * const priceInVana = Number(invoice.price) / 10**18;
+   * console.log(`Price: ${priceInVana} VANA`);
+   * ```
+   */
+  async getOperationInvoice(operationId) {
+    try {
+      const chainId = await this.context.publicClient.getChainId();
+      const contractAddress = getContractAddress(chainId, "AccessSettlement");
+      const abi = getAbi("AccessSettlement");
+      const contract = getContract({
+        address: contractAddress,
+        abi,
+        client: this.context.publicClient
+      });
+      const operationIdBytes = this.stringToBytes(operationId);
+      const result = await contract.read.getOperationInvoice([
+        operationIdBytes
+      ]);
+      const invoice = result;
+      return {
+        issuer: invoice.issuer ?? invoice[0],
+        grantee: invoice.grantee ?? invoice[1],
+        price: invoice.price ?? invoice[2],
+        tokenAddress: invoice.tokenAddress ?? invoice[3],
+        isSettled: invoice.isSettled !== void 0 ? invoice.isSettled : invoice[4]
+      };
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new BlockchainError(
+          `Failed to get operation invoice: ${error.message}`,
+          error
+        );
+      }
+      throw new BlockchainError(
+        "Failed to get operation invoice with unknown error"
+      );
+    }
+  }
+  /**
+   * Check if an operation's payment has been settled
+   *
+   * @remarks
+   * Quick check to determine if payment has been completed for an operation.
+   * Returns true if settlePaymentWithNative() or settlePaymentWithToken() was called.
+   *
+   * @param operationId - Operation identifier
+   * @returns Whether the payment has been settled
+   *
+   * @example
+   * ```typescript
+   * const isSettled = await sdk.accessSettlement.isOperationSettled("op_123");
+   * if (isSettled) {
+   *   console.log("Payment already settled, artifacts should be available");
+   * } else {
+   *   console.log("Payment pending");
+   * }
+   * ```
+   */
+  async isOperationSettled(operationId) {
+    try {
+      const chainId = await this.context.publicClient.getChainId();
+      const contractAddress = getContractAddress(chainId, "AccessSettlement");
+      const abi = getAbi("AccessSettlement");
+      const contract = getContract({
+        address: contractAddress,
+        abi,
+        client: this.context.publicClient
+      });
+      const operationIdBytes = this.stringToBytes(operationId);
+      return await contract.read.isOperationSettled([
+        operationIdBytes
+      ]);
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new BlockchainError(
+          `Failed to check settlement status: ${error.message}`,
+          error
+        );
+      }
+      throw new BlockchainError(
+        "Failed to check settlement status with unknown error"
+      );
+    }
+  }
+  /**
+   * Settle payment for an operation using native VANA
+   *
+   * @remarks
+   * Pays for a completed operation using native VANA tokens. The amount must match
+   * the invoice price exactly. Upon successful payment:
+   * - Funds are transferred to the issuer (dataset owner)
+   * - PaymentSettled event is emitted
+   * - Runtime unlocks operation artifacts for download
+   *
+   * IMPORTANT: You must send the exact value specified in the invoice.
+   * Check the invoice first using getOperationInvoice().
+   *
+   * @param operationId - Operation identifier to settle payment for
+   * @param value - Amount to pay in wei (must match invoice.price)
+   * @returns Transaction hash and operation ID
+   * @throws {BlockchainError} When payment settlement fails
+   * @throws {Error} When wallet is not configured (read-only mode)
+   *
+   * @example
+   * ```typescript
+   * // Get invoice to find the exact price
+   * const invoice = await sdk.accessSettlement.getOperationInvoice("op_123");
+   *
+   * // Settle with native VANA
+   * const result = await sdk.accessSettlement.settlePaymentWithNative(
+   *   "op_123",
+   *   invoice.price  // Must match exactly
+   * );
+   *
+   * // Wait for confirmation
+   * await sdk.waitForTransactionReceipt(result.hash);
+   * console.log("Payment confirmed, artifacts now available");
+   * ```
+   */
+  async settlePaymentWithNative(operationId, value) {
+    this.assertWallet();
+    try {
+      const chainId = await this.context.publicClient.getChainId();
+      const contractAddress = getContractAddress(chainId, "AccessSettlement");
+      const abi = getAbi("AccessSettlement");
+      const operationIdBytes = this.stringToBytes(operationId);
+      const account = this.context.walletClient?.account ?? this.context.userAddress;
+      const hash = await this.context.walletClient.writeContract({
+        address: contractAddress,
+        abi,
+        functionName: "settlePaymentWithNative",
+        args: [operationIdBytes],
+        value,
+        account,
+        chain: this.context.walletClient?.chain ?? null
+      });
+      return {
+        hash,
+        operationId
+      };
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new BlockchainError(
+          `Failed to settle payment with native VANA: ${error.message}`,
+          error
+        );
+      }
+      throw new BlockchainError(
+        "Failed to settle payment with native VANA with unknown error"
+      );
+    }
+  }
+  /**
+   * Settle payment for an operation using an ERC20 token
+   *
+   * @remarks
+   * Pays for a completed operation using an ERC20 token. Before calling this method:
+   * 1. Check the invoice to get tokenAddress and price
+   * 2. Approve the AccessSettlement contract to spend the token amount
+   * 3. Call this method to complete the payment
+   *
+   * The token address and amount must match the invoice exactly.
+   *
+   * @param operationId - Operation identifier to settle payment for
+   * @param tokenAddress - ERC20 token contract address (must match invoice)
+   * @returns Transaction hash and operation ID
+   * @throws {BlockchainError} When payment settlement fails
+   * @throws {Error} When wallet is not configured (read-only mode)
+   *
+   * @example
+   * ```typescript
+   * // Get invoice
+   * const invoice = await sdk.accessSettlement.getOperationInvoice("op_123");
+   *
+   * // Approve token spending (if not already approved)
+   * const tokenContract = sdk.protocol.createContract("ERC20" as const);
+   * await tokenContract.write.approve([
+   *   accessSettlementAddress,
+   *   invoice.price
+   * ]);
+   *
+   * // Settle with token
+   * const result = await sdk.accessSettlement.settlePaymentWithToken(
+   *   "op_123",
+   *   invoice.tokenAddress
+   * );
+   *
+   * await sdk.waitForTransactionReceipt(result.hash);
+   * ```
+   */
+  async settlePaymentWithToken(operationId, tokenAddress) {
+    this.assertWallet();
+    try {
+      const chainId = await this.context.publicClient.getChainId();
+      const contractAddress = getContractAddress(chainId, "AccessSettlement");
+      const abi = getAbi("AccessSettlement");
+      const operationIdBytes = this.stringToBytes(operationId);
+      const account = this.context.walletClient?.account ?? this.context.userAddress;
+      const hash = await this.context.walletClient.writeContract({
+        address: contractAddress,
+        abi,
+        functionName: "settlePaymentWithToken",
+        args: [operationIdBytes, tokenAddress],
+        account,
+        chain: this.context.walletClient?.chain ?? null
+      });
+      return {
+        hash,
+        operationId
+      };
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new BlockchainError(
+          `Failed to settle payment with token: ${error.message}`,
+          error
+        );
+      }
+      throw new BlockchainError(
+        "Failed to settle payment with token with unknown error"
+      );
+    }
+  }
+  /**
+   * Helper method to convert operation ID string to bytes
+   * @internal
+   */
+  stringToBytes(str) {
+    if (str.startsWith("0x")) {
+      return str;
+    }
+    const encoder = new TextEncoder();
+    const bytes = encoder.encode(str);
+    const hexString = Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
+    return `0x${hexString}`;
+  }
+}
+export {
+  AccessSettlementController
+};
+//# sourceMappingURL=accessSettlement.js.map

package/dist/controllers/accessSettlement.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/accessSettlement.ts"],"sourcesContent":["import { getContract } from \"viem\";\nimport { BaseController } from \"./base\";\nimport type {\n  OperationInvoice,\n  PaymentSettlementResult,\n} from \"../types/accessSettlement\";\nimport { BlockchainError } from \"../errors\";\nimport { getContractAddress } from \"../generated/addresses\";\nimport { getAbi } from \"../generated/abi\";\n\n/**\n * Controller for AccessSettlement contract\n *\n * @remarks\n * Manages payment settlement for runtime operations. Allows data consumers\n * to pay for completed operations using native VANA or ERC20 tokens.\n *\n * The AccessSettlement contract acts as an escrow system:\n * 1. Runtime completes an operation and logs the final price\n * 2. Consumer calls settlePaymentWithNative() or settlePaymentWithToken()\n * 3. Funds are transferred to the issuer (dataset owner)\n * 4. Runtime unlocks the operation artifacts for download\n *\n * @category Controllers\n * @example\n * ```typescript\n * // Consumer pays for a completed operation\n * const invoice = await sdk.accessSettlement.getOperationInvoice(\"op_123\");\n *\n * if (!invoice.isSettled) {\n *   const result = await sdk.accessSettlement.settlePaymentWithNative(\n *     \"op_123\",\n *     invoice.price\n *   );\n *   console.log(`Payment settled: ${result.hash}`);\n * }\n * ```\n */\nexport class AccessSettlementController extends BaseController {\n  /**\n   * Get invoice details for an operation\n   *\n   * @remarks\n   * Retrieves the payment invoice created by the runtime after an operation completes.\n   * The invoice contains the final price, payment token, and settlement status.\n   *\n   * @param operationId - Operation identifier (from runtime API)\n   * @returns Invoice details including price and settlement status\n   * @throws {BlockchainError} When invoice retrieval fails\n   *\n   * @example\n   * ```typescript\n   * const invoice = await sdk.accessSettlement.getOperationInvoice(\"op_abc123\");\n   * console.log(`Price: ${invoice.price} wei`);\n   * console.log(`Issuer: ${invoice.issuer}`);\n   * console.log(`Settled: ${invoice.isSettled}`);\n   *\n   * // Convert price to VANA for display\n   * const priceInVana = Number(invoice.price) / 10**18;\n   * console.log(`Price: ${priceInVana} VANA`);\n   * ```\n   */\n  async getOperationInvoice(operationId: string): Promise<OperationInvoice> {\n    try {\n      const chainId = await this.context.publicClient.getChainId();\n      const contractAddress = getContractAddress(chainId, \"AccessSettlement\");\n      const abi = getAbi(\"AccessSettlement\");\n\n      const contract = getContract({\n        address: contractAddress,\n        abi,\n        client: this.context.publicClient,\n      });\n\n      // Convert operationId string to bytes\n      const operationIdBytes = this.stringToBytes(operationId);\n\n      const result = await contract.read.getOperationInvoice([\n        operationIdBytes,\n      ]);\n\n      // Parse tuple result into OperationInvoice object\n      // The contract returns a struct which viem converts to an array-like object\n      const invoice = result as any;\n      return {\n        issuer: invoice.issuer ?? invoice[0],\n        grantee: invoice.grantee ?? invoice[1],\n        price: invoice.price ?? invoice[2],\n        tokenAddress: invoice.tokenAddress ?? invoice[3],\n        isSettled:\n          invoice.isSettled !== undefined ? invoice.isSettled : invoice[4],\n      } as OperationInvoice;\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new BlockchainError(\n          `Failed to get operation invoice: ${error.message}`,\n          error,\n        );\n      }\n      throw new BlockchainError(\n        \"Failed to get operation invoice with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Check if an operation's payment has been settled\n   *\n   * @remarks\n   * Quick check to determine if payment has been completed for an operation.\n   * Returns true if settlePaymentWithNative() or settlePaymentWithToken() was called.\n   *\n   * @param operationId - Operation identifier\n   * @returns Whether the payment has been settled\n   *\n   * @example\n   * ```typescript\n   * const isSettled = await sdk.accessSettlement.isOperationSettled(\"op_123\");\n   * if (isSettled) {\n   *   console.log(\"Payment already settled, artifacts should be available\");\n   * } else {\n   *   console.log(\"Payment pending\");\n   * }\n   * ```\n   */\n  async isOperationSettled(operationId: string): Promise<boolean> {\n    try {\n      const chainId = await this.context.publicClient.getChainId();\n      const contractAddress = getContractAddress(chainId, \"AccessSettlement\");\n      const abi = getAbi(\"AccessSettlement\");\n\n      const contract = getContract({\n        address: contractAddress,\n        abi,\n        client: this.context.publicClient,\n      });\n\n      const operationIdBytes = this.stringToBytes(operationId);\n\n      return (await contract.read.isOperationSettled([\n        operationIdBytes,\n      ])) as boolean;\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new BlockchainError(\n          `Failed to check settlement status: ${error.message}`,\n          error,\n        );\n      }\n      throw new BlockchainError(\n        \"Failed to check settlement status with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Settle payment for an operation using native VANA\n   *\n   * @remarks\n   * Pays for a completed operation using native VANA tokens. The amount must match\n   * the invoice price exactly. Upon successful payment:\n   * - Funds are transferred to the issuer (dataset owner)\n   * - PaymentSettled event is emitted\n   * - Runtime unlocks operation artifacts for download\n   *\n   * IMPORTANT: You must send the exact value specified in the invoice.\n   * Check the invoice first using getOperationInvoice().\n   *\n   * @param operationId - Operation identifier to settle payment for\n   * @param value - Amount to pay in wei (must match invoice.price)\n   * @returns Transaction hash and operation ID\n   * @throws {BlockchainError} When payment settlement fails\n   * @throws {Error} When wallet is not configured (read-only mode)\n   *\n   * @example\n   * ```typescript\n   * // Get invoice to find the exact price\n   * const invoice = await sdk.accessSettlement.getOperationInvoice(\"op_123\");\n   *\n   * // Settle with native VANA\n   * const result = await sdk.accessSettlement.settlePaymentWithNative(\n   *   \"op_123\",\n   *   invoice.price  // Must match exactly\n   * );\n   *\n   * // Wait for confirmation\n   * await sdk.waitForTransactionReceipt(result.hash);\n   * console.log(\"Payment confirmed, artifacts now available\");\n   * ```\n   */\n  async settlePaymentWithNative(\n    operationId: string,\n    value: bigint,\n  ): Promise<PaymentSettlementResult> {\n    this.assertWallet();\n\n    try {\n      const chainId = await this.context.publicClient.getChainId();\n      const contractAddress = getContractAddress(chainId, \"AccessSettlement\");\n      const abi = getAbi(\"AccessSettlement\");\n\n      const operationIdBytes = this.stringToBytes(operationId);\n\n      const account =\n        this.context.walletClient?.account ?? this.context.userAddress;\n\n      const hash = await this.context.walletClient.writeContract({\n        address: contractAddress,\n        abi,\n        functionName: \"settlePaymentWithNative\",\n        args: [operationIdBytes],\n        value,\n        account,\n        chain: this.context.walletClient?.chain ?? null,\n      });\n\n      return {\n        hash,\n        operationId,\n      };\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new BlockchainError(\n          `Failed to settle payment with native VANA: ${error.message}`,\n          error,\n        );\n      }\n      throw new BlockchainError(\n        \"Failed to settle payment with native VANA with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Settle payment for an operation using an ERC20 token\n   *\n   * @remarks\n   * Pays for a completed operation using an ERC20 token. Before calling this method:\n   * 1. Check the invoice to get tokenAddress and price\n   * 2. Approve the AccessSettlement contract to spend the token amount\n   * 3. Call this method to complete the payment\n   *\n   * The token address and amount must match the invoice exactly.\n   *\n   * @param operationId - Operation identifier to settle payment for\n   * @param tokenAddress - ERC20 token contract address (must match invoice)\n   * @returns Transaction hash and operation ID\n   * @throws {BlockchainError} When payment settlement fails\n   * @throws {Error} When wallet is not configured (read-only mode)\n   *\n   * @example\n   * ```typescript\n   * // Get invoice\n   * const invoice = await sdk.accessSettlement.getOperationInvoice(\"op_123\");\n   *\n   * // Approve token spending (if not already approved)\n   * const tokenContract = sdk.protocol.createContract(\"ERC20\" as const);\n   * await tokenContract.write.approve([\n   *   accessSettlementAddress,\n   *   invoice.price\n   * ]);\n   *\n   * // Settle with token\n   * const result = await sdk.accessSettlement.settlePaymentWithToken(\n   *   \"op_123\",\n   *   invoice.tokenAddress\n   * );\n   *\n   * await sdk.waitForTransactionReceipt(result.hash);\n   * ```\n   */\n  async settlePaymentWithToken(\n    operationId: string,\n    tokenAddress: `0x${string}`,\n  ): Promise<PaymentSettlementResult> {\n    this.assertWallet();\n\n    try {\n      const chainId = await this.context.publicClient.getChainId();\n      const contractAddress = getContractAddress(chainId, \"AccessSettlement\");\n      const abi = getAbi(\"AccessSettlement\");\n\n      const operationIdBytes = this.stringToBytes(operationId);\n\n      const account =\n        this.context.walletClient?.account ?? this.context.userAddress;\n\n      const hash = await this.context.walletClient.writeContract({\n        address: contractAddress,\n        abi,\n        functionName: \"settlePaymentWithToken\",\n        args: [operationIdBytes, tokenAddress],\n        account,\n        chain: this.context.walletClient?.chain ?? null,\n      });\n\n      return {\n        hash,\n        operationId,\n      };\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new BlockchainError(\n          `Failed to settle payment with token: ${error.message}`,\n          error,\n        );\n      }\n      throw new BlockchainError(\n        \"Failed to settle payment with token with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Helper method to convert operation ID string to bytes\n   * @internal\n   */\n  private stringToBytes(str: string): `0x${string}` {\n    // If already hex string, return as-is\n    if (str.startsWith(\"0x\")) {\n      return str as `0x${string}`;\n    }\n\n    // Convert string to hex bytes\n    const encoder = new TextEncoder();\n    const bytes = encoder.encode(str);\n    const hexString = Array.from(bytes)\n      .map((b) => b.toString(16).padStart(2, \"0\"))\n      .join(\"\");\n\n    return `0x${hexString}` as `0x${string}`;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/controllers/accessSettlement.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/controllers/base.cjs

@@ -75,6 +75,39 @@ class BaseController {
       );
     }
   }
+  /**
+   * Helper to safely spread transaction options for viem compatibility.
+   * Handles EIP-1559 vs legacy gas pricing correctly.
+   *
+   * @param options - Transaction options to spread
+   * @returns Properly formatted options for viem
+   * @internal
+   */
+  spreadTransactionOptions(options) {
+    if (!options) return {};
+    const baseOptions = {
+      ...options.nonce !== void 0 && { nonce: options.nonce },
+      ...options.gas !== void 0 && { gas: options.gas }
+    };
+    if (options.maxFeePerGas !== void 0 || options.maxPriorityFeePerGas !== void 0) {
+      return {
+        ...baseOptions,
+        ...options.maxFeePerGas !== void 0 && {
+          maxFeePerGas: options.maxFeePerGas
+        },
+        ...options.maxPriorityFeePerGas !== void 0 && {
+          maxPriorityFeePerGas: options.maxPriorityFeePerGas
+        }
+      };
+    }
+    if (options.gasPrice !== void 0) {
+      return {
+        ...baseOptions,
+        gasPrice: options.gasPrice
+      };
+    }
+    return baseOptions;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/controllers/base.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/base.ts"],"sourcesContent":["/**\n * Base controller class providing common functionality for all controllers.\n *\n * @remarks\n * This abstract class establishes the foundation for all Vana SDK controllers,\n * providing shared utilities like wallet validation and context management.\n * All controllers should extend this base class to ensure consistency and\n * shared behavior across the SDK.\n *\n * The class follows the Single Responsibility Principle by handling only\n * the core controller concerns while leaving specific functionality to\n * implementing classes.\n *\n * @category Controllers\n */\n\nimport type { WalletClient } from \"viem\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport { ReadOnlyError } from \"../errors\";\n\n/**\n * Abstract base controller that all Vana SDK controllers extend.\n *\n * @remarks\n * Provides common functionality and patterns used across all controllers,\n * including wallet validation and context management. This ensures\n * consistency and reduces code duplication throughout the SDK.\n *\n * Key features:\n * - Wallet client validation with TypeScript assertion signatures\n * - Consistent error handling for read-only scenarios\n * - Shared context management patterns\n * - Type-safe wallet operations\n *\n * @example\n * ```typescript\n * class MyController extends BaseController {\n *   async performWalletOperation() {\n *     this.assertWallet(); // Ensures wallet is available\n *     // Now this.context.walletClient is guaranteed to be available\n *     const address = await this.context.walletClient.getAddresses();\n *     return address[0];\n *   }\n * }\n * ```\n */\nexport abstract class BaseController {\n  /**\n   * Creates a new controller instance with the provided context.\n   *\n   * @param context - The controller context containing clients and configuration\n   */\n  constructor(protected readonly context: ControllerContext) {}\n\n  /**\n   * Asserts that a wallet client with an account is available for operations requiring signing.\n   *\n   * @remarks\n   * This method uses TypeScript assertion signatures to narrow the type of\n   * `this.context` to guarantee that `walletClient` with an account is available\n   * after the call succeeds. This provides compile-time safety for wallet operations\n   * while enabling clear error messages for read-only scenarios.\n   *\n   * The assertion signature ensures that after calling this method,\n   * TypeScript knows that `this.context.walletClient` is definitely available\n   * with a configured account.\n   *\n   * @throws {ReadOnlyError} When no wallet client is configured\n   * @throws {Error} When wallet client exists but no account is configured\n   *\n   * @example\n   * ```typescript\n   * async performWalletOperation() {\n   *   this.assertWallet(); // Type assertion + runtime check\n   *\n   *   // TypeScript now knows walletClient and account are available\n   *   const account = this.context.walletClient.account;\n   *   const address = typeof account === 'string' ? account : account.address;\n   * }\n   * ```\n   */\n  protected assertWallet(): asserts this is {\n    context: ControllerContext & { walletClient: WalletClient };\n  } {\n    if (!this.context.walletClient) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new ReadOnlyError(\n        callingMethod,\n        \"Initialize the SDK with a walletClient to perform this operation\",\n      );\n    }\n\n    if (!this.context.walletClient.account) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new Error(\n        `No wallet account connected. Cannot perform ${callingMethod} without an account.`,\n      );\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBA,oBAA8B;AA4BvB,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,YAA+B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BlD,eAER;AACA,QAAI,CAAC,KAAK,QAAQ,cAAc;AAE9B,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AAEtC,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/controllers/base.ts"],"sourcesContent":["/**\n * Base controller class providing common functionality for all controllers.\n *\n * @remarks\n * This abstract class establishes the foundation for all Vana SDK controllers,\n * providing shared utilities like wallet validation and context management.\n * All controllers should extend this base class to ensure consistency and\n * shared behavior across the SDK.\n *\n * The class follows the Single Responsibility Principle by handling only\n * the core controller concerns while leaving specific functionality to\n * implementing classes.\n *\n * @category Controllers\n */\n\nimport type { WalletClient } from \"viem\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport type { TransactionOptions } from \"../types/operations\";\nimport { ReadOnlyError } from \"../errors\";\n\n/**\n * Abstract base controller that all Vana SDK controllers extend.\n *\n * @remarks\n * Provides common functionality and patterns used across all controllers,\n * including wallet validation and context management. This ensures\n * consistency and reduces code duplication throughout the SDK.\n *\n * Key features:\n * - Wallet client validation with TypeScript assertion signatures\n * - Consistent error handling for read-only scenarios\n * - Shared context management patterns\n * - Type-safe wallet operations\n *\n * @example\n * ```typescript\n * class MyController extends BaseController {\n *   async performWalletOperation() {\n *     this.assertWallet(); // Ensures wallet is available\n *     // Now this.context.walletClient is guaranteed to be available\n *     const address = await this.context.walletClient.getAddresses();\n *     return address[0];\n *   }\n * }\n * ```\n */\nexport abstract class BaseController {\n  /**\n   * Creates a new controller instance with the provided context.\n   *\n   * @param context - The controller context containing clients and configuration\n   */\n  constructor(protected readonly context: ControllerContext) {}\n\n  /**\n   * Asserts that a wallet client with an account is available for operations requiring signing.\n   *\n   * @remarks\n   * This method uses TypeScript assertion signatures to narrow the type of\n   * `this.context` to guarantee that `walletClient` with an account is available\n   * after the call succeeds. This provides compile-time safety for wallet operations\n   * while enabling clear error messages for read-only scenarios.\n   *\n   * The assertion signature ensures that after calling this method,\n   * TypeScript knows that `this.context.walletClient` is definitely available\n   * with a configured account.\n   *\n   * @throws {ReadOnlyError} When no wallet client is configured\n   * @throws {Error} When wallet client exists but no account is configured\n   *\n   * @example\n   * ```typescript\n   * async performWalletOperation() {\n   *   this.assertWallet(); // Type assertion + runtime check\n   *\n   *   // TypeScript now knows walletClient and account are available\n   *   const account = this.context.walletClient.account;\n   *   const address = typeof account === 'string' ? account : account.address;\n   * }\n   * ```\n   */\n  protected assertWallet(): asserts this is {\n    context: ControllerContext & { walletClient: WalletClient };\n  } {\n    if (!this.context.walletClient) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new ReadOnlyError(\n        callingMethod,\n        \"Initialize the SDK with a walletClient to perform this operation\",\n      );\n    }\n\n    if (!this.context.walletClient.account) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new Error(\n        `No wallet account connected. Cannot perform ${callingMethod} without an account.`,\n      );\n    }\n  }\n\n  /**\n   * Helper to safely spread transaction options for viem compatibility.\n   * Handles EIP-1559 vs legacy gas pricing correctly.\n   *\n   * @param options - Transaction options to spread\n   * @returns Properly formatted options for viem\n   * @internal\n   */\n  protected spreadTransactionOptions(options?: TransactionOptions) {\n    if (!options) return {};\n\n    const baseOptions: any = {\n      ...(options.nonce !== undefined && { nonce: options.nonce }),\n      ...(options.gas !== undefined && { gas: options.gas }),\n    };\n\n    // EIP-1559 and legacy gasPrice are mutually exclusive in viem\n    // If EIP-1559 params are provided, use them and exclude gasPrice\n    if (\n      options.maxFeePerGas !== undefined ||\n      options.maxPriorityFeePerGas !== undefined\n    ) {\n      return {\n        ...baseOptions,\n        ...(options.maxFeePerGas !== undefined && {\n          maxFeePerGas: options.maxFeePerGas,\n        }),\n        ...(options.maxPriorityFeePerGas !== undefined && {\n          maxPriorityFeePerGas: options.maxPriorityFeePerGas,\n        }),\n      };\n    }\n\n    // Otherwise, use legacy gasPrice if provided\n    if (options.gasPrice !== undefined) {\n      return {\n        ...baseOptions,\n        gasPrice: options.gasPrice,\n      };\n    }\n\n    return baseOptions;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAmBA,oBAA8B;AA4BvB,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,YAA+B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BlD,eAER;AACA,QAAI,CAAC,KAAK,QAAQ,cAAc;AAE9B,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AAEtC,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUU,yBAAyB,SAA8B;AAC/D,QAAI,CAAC,QAAS,QAAO,CAAC;AAEtB,UAAM,cAAmB;AAAA,MACvB,GAAI,QAAQ,UAAU,UAAa,EAAE,OAAO,QAAQ,MAAM;AAAA,MAC1D,GAAI,QAAQ,QAAQ,UAAa,EAAE,KAAK,QAAQ,IAAI;AAAA,IACtD;AAIA,QACE,QAAQ,iBAAiB,UACzB,QAAQ,yBAAyB,QACjC;AACA,aAAO;AAAA,QACL,GAAG;AAAA,QACH,GAAI,QAAQ,iBAAiB,UAAa;AAAA,UACxC,cAAc,QAAQ;AAAA,QACxB;AAAA,QACA,GAAI,QAAQ,yBAAyB,UAAa;AAAA,UAChD,sBAAsB,QAAQ;AAAA,QAChC;AAAA,MACF;AAAA,IACF;AAGA,QAAI,QAAQ,aAAa,QAAW;AAClC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,UAAU,QAAQ;AAAA,MACpB;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/controllers/base.d.ts

@@ -15,6 +15,7 @@
  */
 import type { WalletClient } from "viem";
 import type { ControllerContext } from "../types/controller-context";
+import type { TransactionOptions } from "../types/operations";
 /**
  * Abstract base controller that all Vana SDK controllers extend.
  *
@@ -81,4 +82,13 @@ export declare abstract class BaseController {
             walletClient: WalletClient;
         };
     };
+    /**
+     * Helper to safely spread transaction options for viem compatibility.
+     * Handles EIP-1559 vs legacy gas pricing correctly.
+     *
+     * @param options - Transaction options to spread
+     * @returns Properly formatted options for viem
+     * @internal
+     */
+    protected spreadTransactionOptions(options?: TransactionOptions): any;
 }

package/dist/controllers/base.js

@@ -52,6 +52,39 @@ class BaseController {
       );
     }
   }
+  /**
+   * Helper to safely spread transaction options for viem compatibility.
+   * Handles EIP-1559 vs legacy gas pricing correctly.
+   *
+   * @param options - Transaction options to spread
+   * @returns Properly formatted options for viem
+   * @internal
+   */
+  spreadTransactionOptions(options) {
+    if (!options) return {};
+    const baseOptions = {
+      ...options.nonce !== void 0 && { nonce: options.nonce },
+      ...options.gas !== void 0 && { gas: options.gas }
+    };
+    if (options.maxFeePerGas !== void 0 || options.maxPriorityFeePerGas !== void 0) {
+      return {
+        ...baseOptions,
+        ...options.maxFeePerGas !== void 0 && {
+          maxFeePerGas: options.maxFeePerGas
+        },
+        ...options.maxPriorityFeePerGas !== void 0 && {
+          maxPriorityFeePerGas: options.maxPriorityFeePerGas
+        }
+      };
+    }
+    if (options.gasPrice !== void 0) {
+      return {
+        ...baseOptions,
+        gasPrice: options.gasPrice
+      };
+    }
+    return baseOptions;
+  }
 }
 export {
   BaseController

package/dist/controllers/base.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/base.ts"],"sourcesContent":["/**\n * Base controller class providing common functionality for all controllers.\n *\n * @remarks\n * This abstract class establishes the foundation for all Vana SDK controllers,\n * providing shared utilities like wallet validation and context management.\n * All controllers should extend this base class to ensure consistency and\n * shared behavior across the SDK.\n *\n * The class follows the Single Responsibility Principle by handling only\n * the core controller concerns while leaving specific functionality to\n * implementing classes.\n *\n * @category Controllers\n */\n\nimport type { WalletClient } from \"viem\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport { ReadOnlyError } from \"../errors\";\n\n/**\n * Abstract base controller that all Vana SDK controllers extend.\n *\n * @remarks\n * Provides common functionality and patterns used across all controllers,\n * including wallet validation and context management. This ensures\n * consistency and reduces code duplication throughout the SDK.\n *\n * Key features:\n * - Wallet client validation with TypeScript assertion signatures\n * - Consistent error handling for read-only scenarios\n * - Shared context management patterns\n * - Type-safe wallet operations\n *\n * @example\n * ```typescript\n * class MyController extends BaseController {\n *   async performWalletOperation() {\n *     this.assertWallet(); // Ensures wallet is available\n *     // Now this.context.walletClient is guaranteed to be available\n *     const address = await this.context.walletClient.getAddresses();\n *     return address[0];\n *   }\n * }\n * ```\n */\nexport abstract class BaseController {\n  /**\n   * Creates a new controller instance with the provided context.\n   *\n   * @param context - The controller context containing clients and configuration\n   */\n  constructor(protected readonly context: ControllerContext) {}\n\n  /**\n   * Asserts that a wallet client with an account is available for operations requiring signing.\n   *\n   * @remarks\n   * This method uses TypeScript assertion signatures to narrow the type of\n   * `this.context` to guarantee that `walletClient` with an account is available\n   * after the call succeeds. This provides compile-time safety for wallet operations\n   * while enabling clear error messages for read-only scenarios.\n   *\n   * The assertion signature ensures that after calling this method,\n   * TypeScript knows that `this.context.walletClient` is definitely available\n   * with a configured account.\n   *\n   * @throws {ReadOnlyError} When no wallet client is configured\n   * @throws {Error} When wallet client exists but no account is configured\n   *\n   * @example\n   * ```typescript\n   * async performWalletOperation() {\n   *   this.assertWallet(); // Type assertion + runtime check\n   *\n   *   // TypeScript now knows walletClient and account are available\n   *   const account = this.context.walletClient.account;\n   *   const address = typeof account === 'string' ? account : account.address;\n   * }\n   * ```\n   */\n  protected assertWallet(): asserts this is {\n    context: ControllerContext & { walletClient: WalletClient };\n  } {\n    if (!this.context.walletClient) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new ReadOnlyError(\n        callingMethod,\n        \"Initialize the SDK with a walletClient to perform this operation\",\n      );\n    }\n\n    if (!this.context.walletClient.account) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new Error(\n        `No wallet account connected. Cannot perform ${callingMethod} without an account.`,\n      );\n    }\n  }\n}\n"],"mappings":"AAkBA,SAAS,qBAAqB;AA4BvB,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,YAA+B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BlD,eAER;AACA,QAAI,CAAC,KAAK,QAAQ,cAAc;AAE9B,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AAEtC,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/controllers/base.ts"],"sourcesContent":["/**\n * Base controller class providing common functionality for all controllers.\n *\n * @remarks\n * This abstract class establishes the foundation for all Vana SDK controllers,\n * providing shared utilities like wallet validation and context management.\n * All controllers should extend this base class to ensure consistency and\n * shared behavior across the SDK.\n *\n * The class follows the Single Responsibility Principle by handling only\n * the core controller concerns while leaving specific functionality to\n * implementing classes.\n *\n * @category Controllers\n */\n\nimport type { WalletClient } from \"viem\";\nimport type { ControllerContext } from \"../types/controller-context\";\nimport type { TransactionOptions } from \"../types/operations\";\nimport { ReadOnlyError } from \"../errors\";\n\n/**\n * Abstract base controller that all Vana SDK controllers extend.\n *\n * @remarks\n * Provides common functionality and patterns used across all controllers,\n * including wallet validation and context management. This ensures\n * consistency and reduces code duplication throughout the SDK.\n *\n * Key features:\n * - Wallet client validation with TypeScript assertion signatures\n * - Consistent error handling for read-only scenarios\n * - Shared context management patterns\n * - Type-safe wallet operations\n *\n * @example\n * ```typescript\n * class MyController extends BaseController {\n *   async performWalletOperation() {\n *     this.assertWallet(); // Ensures wallet is available\n *     // Now this.context.walletClient is guaranteed to be available\n *     const address = await this.context.walletClient.getAddresses();\n *     return address[0];\n *   }\n * }\n * ```\n */\nexport abstract class BaseController {\n  /**\n   * Creates a new controller instance with the provided context.\n   *\n   * @param context - The controller context containing clients and configuration\n   */\n  constructor(protected readonly context: ControllerContext) {}\n\n  /**\n   * Asserts that a wallet client with an account is available for operations requiring signing.\n   *\n   * @remarks\n   * This method uses TypeScript assertion signatures to narrow the type of\n   * `this.context` to guarantee that `walletClient` with an account is available\n   * after the call succeeds. This provides compile-time safety for wallet operations\n   * while enabling clear error messages for read-only scenarios.\n   *\n   * The assertion signature ensures that after calling this method,\n   * TypeScript knows that `this.context.walletClient` is definitely available\n   * with a configured account.\n   *\n   * @throws {ReadOnlyError} When no wallet client is configured\n   * @throws {Error} When wallet client exists but no account is configured\n   *\n   * @example\n   * ```typescript\n   * async performWalletOperation() {\n   *   this.assertWallet(); // Type assertion + runtime check\n   *\n   *   // TypeScript now knows walletClient and account are available\n   *   const account = this.context.walletClient.account;\n   *   const address = typeof account === 'string' ? account : account.address;\n   * }\n   * ```\n   */\n  protected assertWallet(): asserts this is {\n    context: ControllerContext & { walletClient: WalletClient };\n  } {\n    if (!this.context.walletClient) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new ReadOnlyError(\n        callingMethod,\n        \"Initialize the SDK with a walletClient to perform this operation\",\n      );\n    }\n\n    if (!this.context.walletClient.account) {\n      // Get the calling method name from the stack trace for better error messages\n      const stack = new Error().stack;\n      const callingMethod =\n        stack?.split(\"\\n\")[2]?.match(/at \\w+\\.(\\w+)/)?.[1] ?? \"this operation\";\n\n      throw new Error(\n        `No wallet account connected. Cannot perform ${callingMethod} without an account.`,\n      );\n    }\n  }\n\n  /**\n   * Helper to safely spread transaction options for viem compatibility.\n   * Handles EIP-1559 vs legacy gas pricing correctly.\n   *\n   * @param options - Transaction options to spread\n   * @returns Properly formatted options for viem\n   * @internal\n   */\n  protected spreadTransactionOptions(options?: TransactionOptions) {\n    if (!options) return {};\n\n    const baseOptions: any = {\n      ...(options.nonce !== undefined && { nonce: options.nonce }),\n      ...(options.gas !== undefined && { gas: options.gas }),\n    };\n\n    // EIP-1559 and legacy gasPrice are mutually exclusive in viem\n    // If EIP-1559 params are provided, use them and exclude gasPrice\n    if (\n      options.maxFeePerGas !== undefined ||\n      options.maxPriorityFeePerGas !== undefined\n    ) {\n      return {\n        ...baseOptions,\n        ...(options.maxFeePerGas !== undefined && {\n          maxFeePerGas: options.maxFeePerGas,\n        }),\n        ...(options.maxPriorityFeePerGas !== undefined && {\n          maxPriorityFeePerGas: options.maxPriorityFeePerGas,\n        }),\n      };\n    }\n\n    // Otherwise, use legacy gasPrice if provided\n    if (options.gasPrice !== undefined) {\n      return {\n        ...baseOptions,\n        gasPrice: options.gasPrice,\n      };\n    }\n\n    return baseOptions;\n  }\n}\n"],"mappings":"AAmBA,SAAS,qBAAqB;AA4BvB,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMnC,YAA+B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EA6BlD,eAER;AACA,QAAI,CAAC,KAAK,QAAQ,cAAc;AAE9B,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AAEtC,YAAM,QAAQ,IAAI,MAAM,EAAE;AAC1B,YAAM,gBACJ,OAAO,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,eAAe,IAAI,CAAC,KAAK;AAExD,YAAM,IAAI;AAAA,QACR,+CAA+C,aAAa;AAAA,MAC9D;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUU,yBAAyB,SAA8B;AAC/D,QAAI,CAAC,QAAS,QAAO,CAAC;AAEtB,UAAM,cAAmB;AAAA,MACvB,GAAI,QAAQ,UAAU,UAAa,EAAE,OAAO,QAAQ,MAAM;AAAA,MAC1D,GAAI,QAAQ,QAAQ,UAAa,EAAE,KAAK,QAAQ,IAAI;AAAA,IACtD;AAIA,QACE,QAAQ,iBAAiB,UACzB,QAAQ,yBAAyB,QACjC;AACA,aAAO;AAAA,QACL,GAAG;AAAA,QACH,GAAI,QAAQ,iBAAiB,UAAa;AAAA,UACxC,cAAc,QAAQ;AAAA,QACxB;AAAA,QACA,GAAI,QAAQ,yBAAyB,UAAa;AAAA,UAChD,sBAAsB,QAAQ;AAAA,QAChC;AAAA,MACF;AAAA,IACF;AAGA,QAAI,QAAQ,aAAa,QAAW;AAClC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,UAAU,QAAQ;AAAA,MACpB;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}