@opendatalabs/vana-sdk 0.1.0-alpha.eebb656 → 0.1.0-alpha.ef15099

package/dist/contracts/contractController.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Provides type-safe contract interaction utilities for the Vana protocol.
+ *
+ * @remarks
+ * This module enables strongly-typed smart contract interactions with automatic
+ * ABI loading, address resolution, and instance caching. It follows viem's patterns
+ * for contract typing while providing Vana-specific conveniences.
+ *
+ * @category Contracts
+ * @module contractController
+ */
 import type { Abi } from "abitype";
 import { type GetContractReturnType, type PublicClient, type WalletClient } from "viem";
 import { type ContractAbis, type VanaContract } from "../generated/abi";
@@ -8,12 +19,19 @@ export declare const contractCacheForTesting: Map<string, {
     abi: Abi;
 }>;
 /**
- * Gets a typed contract instance for the specified contract name with full type inference.
- * This function provides complete type safety following viem's patterns.
+ * Gets a typed contract instance for the specified contract name.
+ *
+ * @remarks
+ * Provides complete type safety following viem's patterns with automatic
+ * ABI loading and address resolution. Contract instances are cached per
+ * chain for performance. Use const assertion for full type inference.
  *
- * @param contract - Name of the contract to instantiate (must be a const assertion for full typing)
- * @param client - Optional viem client instance
+ * @param contract - Name of the contract to instantiate.
+ *   Use const assertion for full typing: `"DataRegistry" as const`
+ * @param client - Optional viem client instance.
+ *   Defaults to auto-configured client. Obtain via `createClient()` or viem.
  * @returns A fully typed contract instance with methods corresponding to the contract's ABI
+ *
  * @example
  * ```typescript
  * // Full type inference with const assertion
@@ -22,27 +40,65 @@ export declare const contractCacheForTesting: Map<string, {
  * // Now dataRegistry has full type inference for all methods
  * const result = await dataRegistry.read.getFileCount(); // Type: bigint
  * await dataRegistry.write.addFile([url, proof]); // Typed parameters
+ *
+ * // Auto-configured client
+ * const permissions = getContractController("DataPortabilityPermissions" as const);
+ * const granted = await permissions.read.hasPermission([grantor, grantee]);
  * ```
+ *
+ * @category Contracts
  */
 export declare function getContractController<T extends VanaContract>(contract: T, client?: PublicClient | WalletClient | ReturnType<typeof createClient>): GetContractReturnType<ContractAbis[T]>;
 /**
- * Gets contract information (address and ABI) without creating a contract instance.
- * Useful for cases where you need contract details but don't want to create a client connection.
+ * Gets contract information without creating a contract instance.
  *
- * @param contract - Name of the contract
- * @param chainId - Chain ID (defaults to Vana mainnet)
+ * @remarks
+ * Returns contract address and ABI for manual contract interaction or
+ * custom client configuration. Useful when you need contract details
+ * but don't want to create a client connection.
+ *
+ * @param contract - Name of the contract.
+ *   Use const assertion for typed ABI.
+ * @param chainId - Chain ID to get contract info for.
+ *   Defaults to Vana mainnet (1480).
  * @returns Contract information with typed ABI
+ *
  * @example
  * ```typescript
  * const info = getContractInfo("DataRegistry" as const, 14800);
  * console.log(info.address); // Typed as Address
  * console.log(info.abi); // Fully typed ABI
+ *
+ * // Use with custom viem client
+ * const contract = getContract({
+ *   ...info,
+ *   client: customClient
+ * });
  * ```
+ *
+ * @category Contracts
  */
 export declare function getContractInfo<T extends VanaContract>(contract: T, chainId?: VanaChainId): ContractInfo<ContractAbis[T]>;
 /**
- * Type-safe contract factory that creates contract instances with full type inference.
- * This provides an alternative API that's more explicit about typing.
+ * Provides type-safe contract factory for creating multiple contract instances.
+ *
+ * @remarks
+ * Alternative API for applications that need to create multiple contracts
+ * with the same client. The factory pattern reduces boilerplate and ensures
+ * consistent client configuration across contracts.
+ *
+ * @example
+ * ```typescript
+ * const factory = new ContractFactory(client);
+ *
+ * const dataRegistry = factory.create("DataRegistry" as const);
+ * const permissions = factory.create("DataPortabilityPermissions" as const);
+ *
+ * // List available contracts
+ * const contracts = factory.getAvailableContracts();
+ * ```
+ *
+ * @category Contracts
  */
 export declare class ContractFactory {
     private readonly client;

package/dist/contracts/contractController.js

@@ -2,7 +2,7 @@ import {
   getContract
 } from "viem";
 import { getAbi } from "../generated/abi";
-import { getContractAddress, CONTRACT_ADDRESSES } from "../config/addresses";
+import { getContractAddress, CONTRACT_ADDRESSES } from "../generated/addresses";
 import { createClient } from "../core/client";
 import { vanaMainnet } from "../config/chains";
 const contractCache = /* @__PURE__ */ new Map();

package/dist/contracts/contractController.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/contracts/contractController.ts"],"sourcesContent":["import type { Abi } from \"abitype\";\nimport {\n  getContract,\n  type GetContractReturnType,\n  type PublicClient,\n  type WalletClient,\n} from \"viem\";\nimport { type ContractAbis, getAbi, type VanaContract } from \"../generated/abi\";\nimport type { VanaChainId, ContractInfo } from \"../types/index\";\nimport { getContractAddress, CONTRACT_ADDRESSES } from \"../config/addresses\";\nimport { createClient } from \"../core/client\";\nimport { vanaMainnet } from \"../config/chains\";\n\n// Cache for contract instances - keyed by contract name and chain ID\nconst contractCache = new Map<string, GetContractReturnType<Abi>>();\n\n// Export cache for testing\nexport const contractCacheForTesting = contractCache;\n\n/**\n * Creates a cache key for contract instances\n *\n * @param contract - The contract name to create a cache key for\n * @param chainId - The chain ID to include in the cache key\n * @returns A string cache key combining contract name and chain ID\n */\nfunction createCacheKey(contract: VanaContract, chainId: number): string {\n  return `${contract}:${chainId}`;\n}\n\n/**\n * Gets a typed contract instance for the specified contract name with full type inference.\n * This function provides complete type safety following viem's patterns.\n *\n * @param contract - Name of the contract to instantiate (must be a const assertion for full typing)\n * @param client - Optional viem client instance\n * @returns A fully typed contract instance with methods corresponding to the contract's ABI\n * @example\n * ```typescript\n * // Full type inference with const assertion\n * const dataRegistry = getContractController(\"DataRegistry\" as const, client);\n *\n * // Now dataRegistry has full type inference for all methods\n * const result = await dataRegistry.read.getFileCount(); // Type: bigint\n * await dataRegistry.write.addFile([url, proof]); // Typed parameters\n * ```\n */\nexport function getContractController<T extends VanaContract>(\n  contract: T,\n  client:\n    | PublicClient\n    | WalletClient\n    | ReturnType<typeof createClient> = createClient(),\n): GetContractReturnType<ContractAbis[T]> {\n  const chainId = client.chain?.id ?? vanaMainnet.id;\n  const cacheKey = createCacheKey(contract, chainId);\n\n  let controller = contractCache.get(cacheKey);\n\n  if (!controller) {\n    controller = getContract({\n      address: getContractAddress(chainId, contract),\n      abi: getAbi(contract),\n      client,\n    }) as GetContractReturnType<ContractAbis[T]>;\n\n    contractCache.set(cacheKey, controller);\n  }\n\n  return controller as GetContractReturnType<ContractAbis[T]>;\n}\n\n/**\n * Gets contract information (address and ABI) without creating a contract instance.\n * Useful for cases where you need contract details but don't want to create a client connection.\n *\n * @param contract - Name of the contract\n * @param chainId - Chain ID (defaults to Vana mainnet)\n * @returns Contract information with typed ABI\n * @example\n * ```typescript\n * const info = getContractInfo(\"DataRegistry\" as const, 14800);\n * console.log(info.address); // Typed as Address\n * console.log(info.abi); // Fully typed ABI\n * ```\n */\nexport function getContractInfo<T extends VanaContract>(\n  contract: T,\n  chainId: VanaChainId = vanaMainnet.id as VanaChainId,\n): ContractInfo<ContractAbis[T]> {\n  return {\n    address: getContractAddress(chainId, contract),\n    abi: getAbi(contract),\n  };\n}\n\n/**\n * Type-safe contract factory that creates contract instances with full type inference.\n * This provides an alternative API that's more explicit about typing.\n */\nexport class ContractFactory {\n  private readonly client:\n    | PublicClient\n    | WalletClient\n    | ReturnType<typeof createClient>;\n  private readonly chainId: number;\n\n  constructor(\n    client: PublicClient | WalletClient | ReturnType<typeof createClient>,\n  ) {\n    this.client = client;\n    try {\n      this.chainId = client.chain?.id ?? vanaMainnet.id;\n    } catch {\n      this.chainId = vanaMainnet.id;\n    }\n  }\n\n  /**\n   * Creates a typed contract instance\n   *\n   * @param contract - Contract name (use const assertion for full typing)\n   * @returns Fully typed contract instance\n   */\n  create<T extends VanaContract>(\n    contract: T,\n  ): GetContractReturnType<ContractAbis[T]> {\n    return getContractController(contract, this.client);\n  }\n\n  /**\n   * Gets contract information without creating an instance\n   *\n   * @param contract - Contract name\n   * @returns Contract information with typed ABI\n   */\n  getInfo<T extends VanaContract>(contract: T): ContractInfo<ContractAbis[T]> {\n    return getContractInfo(contract, this.chainId as VanaChainId);\n  }\n\n  /**\n   * Lists all available contracts for the current chain\n   *\n   * @returns Array of contract names available on this chain\n   */\n  getAvailableContracts(): VanaContract[] {\n    // Return all contract names that have addresses on this chain\n    const chainAddresses = CONTRACT_ADDRESSES[this.chainId];\n    if (!chainAddresses) return [];\n\n    return Object.keys(chainAddresses) as VanaContract[];\n  }\n}\n\n/**\n * Clears the contract cache. Useful for testing or when chain configurations change.\n *\n * @param contract - Optional specific contract to clear, or clear all if not provided\n * @param chainId - Optional specific chain to clear, or clear all if not provided\n */\nexport function clearContractCache(\n  contract?: VanaContract,\n  chainId?: number,\n): void {\n  if (contract && chainId) {\n    const cacheKey = createCacheKey(contract, chainId);\n    contractCache.delete(cacheKey);\n  } else if (contract) {\n    // Clear all instances of this contract across all chains\n    for (const key of contractCache.keys()) {\n      if (key.startsWith(`${contract}:`)) {\n        contractCache.delete(key);\n      }\n    }\n  } else if (chainId) {\n    // Clear all contracts for this chain\n    for (const key of contractCache.keys()) {\n      if (key.endsWith(`:${chainId}`)) {\n        contractCache.delete(key);\n      }\n    }\n  } else {\n    // Clear entire cache\n    contractCache.clear();\n  }\n}\n\n// Function is already exported above, no need for redundant export\n\n// Type-only exports for enhanced type safety\nexport type { GetContractReturnType } from \"viem\";\n"],"mappings":"AACA;AAAA,EACE;AAAA,OAIK;AACP,SAA4B,cAAiC;AAE7D,SAAS,oBAAoB,0BAA0B;AACvD,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAG5B,MAAM,gBAAgB,oBAAI,IAAwC;AAG3D,MAAM,0BAA0B;AASvC,SAAS,eAAe,UAAwB,SAAyB;AACvE,SAAO,GAAG,QAAQ,IAAI,OAAO;AAC/B;AAmBO,SAAS,sBACd,UACA,SAGsC,aAAa,GACX;AACxC,QAAM,UAAU,OAAO,OAAO,MAAM,YAAY;AAChD,QAAM,WAAW,eAAe,UAAU,OAAO;AAEjD,MAAI,aAAa,cAAc,IAAI,QAAQ;AAE3C,MAAI,CAAC,YAAY;AACf,iBAAa,YAAY;AAAA,MACvB,SAAS,mBAAmB,SAAS,QAAQ;AAAA,MAC7C,KAAK,OAAO,QAAQ;AAAA,MACpB;AAAA,IACF,CAAC;AAED,kBAAc,IAAI,UAAU,UAAU;AAAA,EACxC;AAEA,SAAO;AACT;AAgBO,SAAS,gBACd,UACA,UAAuB,YAAY,IACJ;AAC/B,SAAO;AAAA,IACL,SAAS,mBAAmB,SAAS,QAAQ;AAAA,IAC7C,KAAK,OAAO,QAAQ;AAAA,EACtB;AACF;AAMO,MAAM,gBAAgB;AAAA,EACV;AAAA,EAIA;AAAA,EAEjB,YACE,QACA;AACA,SAAK,SAAS;AACd,QAAI;AACF,WAAK,UAAU,OAAO,OAAO,MAAM,YAAY;AAAA,IACjD,QAAQ;AACN,WAAK,UAAU,YAAY;AAAA,IAC7B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OACE,UACwC;AACxC,WAAO,sBAAsB,UAAU,KAAK,MAAM;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QAAgC,UAA4C;AAC1E,WAAO,gBAAgB,UAAU,KAAK,OAAsB;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,wBAAwC;AAEtC,UAAM,iBAAiB,mBAAmB,KAAK,OAAO;AACtD,QAAI,CAAC,eAAgB,QAAO,CAAC;AAE7B,WAAO,OAAO,KAAK,cAAc;AAAA,EACnC;AACF;AAQO,SAAS,mBACd,UACA,SACM;AACN,MAAI,YAAY,SAAS;AACvB,UAAM,WAAW,eAAe,UAAU,OAAO;AACjD,kBAAc,OAAO,QAAQ;AAAA,EAC/B,WAAW,UAAU;AAEnB,eAAW,OAAO,cAAc,KAAK,GAAG;AACtC,UAAI,IAAI,WAAW,GAAG,QAAQ,GAAG,GAAG;AAClC,sBAAc,OAAO,GAAG;AAAA,MAC1B;AAAA,IACF;AAAA,EACF,WAAW,SAAS;AAElB,eAAW,OAAO,cAAc,KAAK,GAAG;AACtC,UAAI,IAAI,SAAS,IAAI,OAAO,EAAE,GAAG;AAC/B,sBAAc,OAAO,GAAG;AAAA,MAC1B;AAAA,IACF;AAAA,EACF,OAAO;AAEL,kBAAc,MAAM;AAAA,EACtB;AACF;","names":[]}
+{"version":3,"sources":["../../src/contracts/contractController.ts"],"sourcesContent":["/**\n * Provides type-safe contract interaction utilities for the Vana protocol.\n *\n * @remarks\n * This module enables strongly-typed smart contract interactions with automatic\n * ABI loading, address resolution, and instance caching. It follows viem's patterns\n * for contract typing while providing Vana-specific conveniences.\n *\n * @category Contracts\n * @module contractController\n */\n\nimport type { Abi } from \"abitype\";\nimport {\n  getContract,\n  type GetContractReturnType,\n  type PublicClient,\n  type WalletClient,\n} from \"viem\";\nimport { type ContractAbis, getAbi, type VanaContract } from \"../generated/abi\";\nimport type { VanaChainId, ContractInfo } from \"../types/index\";\nimport { getContractAddress, CONTRACT_ADDRESSES } from \"../generated/addresses\";\nimport { createClient } from \"../core/client\";\nimport { vanaMainnet } from \"../config/chains\";\n\n// Cache for contract instances - keyed by contract name and chain ID\nconst contractCache = new Map<string, GetContractReturnType<Abi>>();\n\n// Export cache for testing\nexport const contractCacheForTesting = contractCache;\n\n/**\n * Creates a cache key for contract instances.\n *\n * @remarks\n * Generates unique keys for caching contract instances per chain to prevent\n * cross-chain contamination and improve performance.\n *\n * @param contract - The contract name to create a cache key for\n * @param chainId - The chain ID to include in the cache key\n * @returns A string cache key combining contract name and chain ID\n *\n * @internal\n */\nfunction createCacheKey(contract: VanaContract, chainId: number): string {\n  return `${contract}:${chainId}`;\n}\n\n/**\n * Gets a typed contract instance for the specified contract name.\n *\n * @remarks\n * Provides complete type safety following viem's patterns with automatic\n * ABI loading and address resolution. Contract instances are cached per\n * chain for performance. Use const assertion for full type inference.\n *\n * @param contract - Name of the contract to instantiate.\n *   Use const assertion for full typing: `\"DataRegistry\" as const`\n * @param client - Optional viem client instance.\n *   Defaults to auto-configured client. Obtain via `createClient()` or viem.\n * @returns A fully typed contract instance with methods corresponding to the contract's ABI\n *\n * @example\n * ```typescript\n * // Full type inference with const assertion\n * const dataRegistry = getContractController(\"DataRegistry\" as const, client);\n *\n * // Now dataRegistry has full type inference for all methods\n * const result = await dataRegistry.read.getFileCount(); // Type: bigint\n * await dataRegistry.write.addFile([url, proof]); // Typed parameters\n *\n * // Auto-configured client\n * const permissions = getContractController(\"DataPortabilityPermissions\" as const);\n * const granted = await permissions.read.hasPermission([grantor, grantee]);\n * ```\n *\n * @category Contracts\n */\nexport function getContractController<T extends VanaContract>(\n  contract: T,\n  client:\n    | PublicClient\n    | WalletClient\n    | ReturnType<typeof createClient> = createClient(),\n): GetContractReturnType<ContractAbis[T]> {\n  const chainId = client.chain?.id ?? vanaMainnet.id;\n  const cacheKey = createCacheKey(contract, chainId);\n\n  let controller = contractCache.get(cacheKey);\n\n  if (!controller) {\n    controller = getContract({\n      address: getContractAddress(chainId, contract),\n      abi: getAbi(contract),\n      client,\n    }) as GetContractReturnType<ContractAbis[T]>;\n\n    contractCache.set(cacheKey, controller);\n  }\n\n  return controller as GetContractReturnType<ContractAbis[T]>;\n}\n\n/**\n * Gets contract information without creating a contract instance.\n *\n * @remarks\n * Returns contract address and ABI for manual contract interaction or\n * custom client configuration. Useful when you need contract details\n * but don't want to create a client connection.\n *\n * @param contract - Name of the contract.\n *   Use const assertion for typed ABI.\n * @param chainId - Chain ID to get contract info for.\n *   Defaults to Vana mainnet (1480).\n * @returns Contract information with typed ABI\n *\n * @example\n * ```typescript\n * const info = getContractInfo(\"DataRegistry\" as const, 14800);\n * console.log(info.address); // Typed as Address\n * console.log(info.abi); // Fully typed ABI\n *\n * // Use with custom viem client\n * const contract = getContract({\n *   ...info,\n *   client: customClient\n * });\n * ```\n *\n * @category Contracts\n */\nexport function getContractInfo<T extends VanaContract>(\n  contract: T,\n  chainId: VanaChainId = vanaMainnet.id as VanaChainId,\n): ContractInfo<ContractAbis[T]> {\n  return {\n    address: getContractAddress(chainId, contract),\n    abi: getAbi(contract),\n  };\n}\n\n/**\n * Provides type-safe contract factory for creating multiple contract instances.\n *\n * @remarks\n * Alternative API for applications that need to create multiple contracts\n * with the same client. The factory pattern reduces boilerplate and ensures\n * consistent client configuration across contracts.\n *\n * @example\n * ```typescript\n * const factory = new ContractFactory(client);\n *\n * const dataRegistry = factory.create(\"DataRegistry\" as const);\n * const permissions = factory.create(\"DataPortabilityPermissions\" as const);\n *\n * // List available contracts\n * const contracts = factory.getAvailableContracts();\n * ```\n *\n * @category Contracts\n */\nexport class ContractFactory {\n  private readonly client:\n    | PublicClient\n    | WalletClient\n    | ReturnType<typeof createClient>;\n  private readonly chainId: number;\n\n  constructor(\n    client: PublicClient | WalletClient | ReturnType<typeof createClient>,\n  ) {\n    this.client = client;\n    try {\n      this.chainId = client.chain?.id ?? vanaMainnet.id;\n    } catch {\n      this.chainId = vanaMainnet.id;\n    }\n  }\n\n  /**\n   * Creates a typed contract instance\n   *\n   * @param contract - Contract name (use const assertion for full typing)\n   * @returns Fully typed contract instance\n   */\n  create<T extends VanaContract>(\n    contract: T,\n  ): GetContractReturnType<ContractAbis[T]> {\n    return getContractController(contract, this.client);\n  }\n\n  /**\n   * Gets contract information without creating an instance\n   *\n   * @param contract - Contract name\n   * @returns Contract information with typed ABI\n   */\n  getInfo<T extends VanaContract>(contract: T): ContractInfo<ContractAbis[T]> {\n    return getContractInfo(contract, this.chainId as VanaChainId);\n  }\n\n  /**\n   * Lists all available contracts for the current chain\n   *\n   * @returns Array of contract names available on this chain\n   */\n  getAvailableContracts(): VanaContract[] {\n    // Return all contract names that have addresses on this chain\n    const chainAddresses = CONTRACT_ADDRESSES[this.chainId];\n    if (!chainAddresses) return [];\n\n    return Object.keys(chainAddresses) as VanaContract[];\n  }\n}\n\n/**\n * Clears the contract cache. Useful for testing or when chain configurations change.\n *\n * @param contract - Optional specific contract to clear, or clear all if not provided\n * @param chainId - Optional specific chain to clear, or clear all if not provided\n */\nexport function clearContractCache(\n  contract?: VanaContract,\n  chainId?: number,\n): void {\n  if (contract && chainId) {\n    const cacheKey = createCacheKey(contract, chainId);\n    contractCache.delete(cacheKey);\n  } else if (contract) {\n    // Clear all instances of this contract across all chains\n    for (const key of contractCache.keys()) {\n      if (key.startsWith(`${contract}:`)) {\n        contractCache.delete(key);\n      }\n    }\n  } else if (chainId) {\n    // Clear all contracts for this chain\n    for (const key of contractCache.keys()) {\n      if (key.endsWith(`:${chainId}`)) {\n        contractCache.delete(key);\n      }\n    }\n  } else {\n    // Clear entire cache\n    contractCache.clear();\n  }\n}\n\n// Function is already exported above, no need for redundant export\n\n// Type-only exports for enhanced type safety\nexport type { GetContractReturnType } from \"viem\";\n"],"mappings":"AAaA;AAAA,EACE;AAAA,OAIK;AACP,SAA4B,cAAiC;AAE7D,SAAS,oBAAoB,0BAA0B;AACvD,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAG5B,MAAM,gBAAgB,oBAAI,IAAwC;AAG3D,MAAM,0BAA0B;AAevC,SAAS,eAAe,UAAwB,SAAyB;AACvE,SAAO,GAAG,QAAQ,IAAI,OAAO;AAC/B;AAgCO,SAAS,sBACd,UACA,SAGsC,aAAa,GACX;AACxC,QAAM,UAAU,OAAO,OAAO,MAAM,YAAY;AAChD,QAAM,WAAW,eAAe,UAAU,OAAO;AAEjD,MAAI,aAAa,cAAc,IAAI,QAAQ;AAE3C,MAAI,CAAC,YAAY;AACf,iBAAa,YAAY;AAAA,MACvB,SAAS,mBAAmB,SAAS,QAAQ;AAAA,MAC7C,KAAK,OAAO,QAAQ;AAAA,MACpB;AAAA,IACF,CAAC;AAED,kBAAc,IAAI,UAAU,UAAU;AAAA,EACxC;AAEA,SAAO;AACT;AA+BO,SAAS,gBACd,UACA,UAAuB,YAAY,IACJ;AAC/B,SAAO;AAAA,IACL,SAAS,mBAAmB,SAAS,QAAQ;AAAA,IAC7C,KAAK,OAAO,QAAQ;AAAA,EACtB;AACF;AAuBO,MAAM,gBAAgB;AAAA,EACV;AAAA,EAIA;AAAA,EAEjB,YACE,QACA;AACA,SAAK,SAAS;AACd,QAAI;AACF,WAAK,UAAU,OAAO,OAAO,MAAM,YAAY;AAAA,IACjD,QAAQ;AACN,WAAK,UAAU,YAAY;AAAA,IAC7B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OACE,UACwC;AACxC,WAAO,sBAAsB,UAAU,KAAK,MAAM;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QAAgC,UAA4C;AAC1E,WAAO,gBAAgB,UAAU,KAAK,OAAsB;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,wBAAwC;AAEtC,UAAM,iBAAiB,mBAAmB,KAAK,OAAO;AACtD,QAAI,CAAC,eAAgB,QAAO,CAAC;AAE7B,WAAO,OAAO,KAAK,cAAc;AAAA,EACnC;AACF;AAQO,SAAS,mBACd,UACA,SACM;AACN,MAAI,YAAY,SAAS;AACvB,UAAM,WAAW,eAAe,UAAU,OAAO;AACjD,kBAAc,OAAO,QAAQ;AAAA,EAC/B,WAAW,UAAU;AAEnB,eAAW,OAAO,cAAc,KAAK,GAAG;AACtC,UAAI,IAAI,WAAW,GAAG,QAAQ,GAAG,GAAG;AAClC,sBAAc,OAAO,GAAG;AAAA,MAC1B;AAAA,IACF;AAAA,EACF,WAAW,SAAS;AAElB,eAAW,OAAO,cAAc,KAAK,GAAG;AACtC,UAAI,IAAI,SAAS,IAAI,OAAO,EAAE,GAAG;AAC/B,sBAAc,OAAO,GAAG;AAAA,MAC1B;AAAA,IACF;AAAA,EACF,OAAO;AAEL,kBAAc,MAAM;AAAA,EACtB;AACF;","names":[]}

package/dist/controllers/__tests__/data-consistency-integration.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file Integration tests for data consistency features
+ *
+ * These tests verify the consistency options work correctly
+ * without loading the full DataController implementation
+ */
+export {};

package/dist/controllers/__tests__/operations.processQueue.test.d.ts

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

package/dist/controllers/accessSettlement.cjs

@@ -0,0 +1,289 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var accessSettlement_exports = {};
+__export(accessSettlement_exports, {
+  AccessSettlementController: () => AccessSettlementController
+});
+module.exports = __toCommonJS(accessSettlement_exports);
+var import_viem = require("viem");
+var import_base = require("./base");
+var import_errors = require("../errors");
+var import_addresses = require("../generated/addresses");
+var import_abi = require("../generated/abi");
+class AccessSettlementController extends import_base.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 = (0, import_addresses.getContractAddress)(chainId, "AccessSettlement");
+      const abi = (0, import_abi.getAbi)("AccessSettlement");
+      const contract = (0, import_viem.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 import_errors.BlockchainError(
+          `Failed to get operation invoice: ${error.message}`,
+          error
+        );
+      }
+      throw new import_errors.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 = (0, import_addresses.getContractAddress)(chainId, "AccessSettlement");
+      const abi = (0, import_abi.getAbi)("AccessSettlement");
+      const contract = (0, import_viem.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 import_errors.BlockchainError(
+          `Failed to check settlement status: ${error.message}`,
+          error
+        );
+      }
+      throw new import_errors.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 = (0, import_addresses.getContractAddress)(chainId, "AccessSettlement");
+      const abi = (0, import_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 import_errors.BlockchainError(
+          `Failed to settle payment with native VANA: ${error.message}`,
+          error
+        );
+      }
+      throw new import_errors.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 = (0, import_addresses.getContractAddress)(chainId, "AccessSettlement");
+      const abi = (0, import_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 import_errors.BlockchainError(
+          `Failed to settle payment with token: ${error.message}`,
+          error
+        );
+      }
+      throw new import_errors.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}`;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AccessSettlementController
+});
+//# sourceMappingURL=accessSettlement.cjs.map

package/dist/controllers/accessSettlement.cjs.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.d.ts

@@ -0,0 +1,157 @@
+import { BaseController } from "./base";
+import type { OperationInvoice, PaymentSettlementResult } from "../types/accessSettlement";
+/**
+ * Controller for AccessSettlement contract
+ *
+ * @remarks
+ * Manages payment settlement for runtime operations. Allows data consumers
+ * to pay for completed operations using native VANA or ERC20 tokens.
+ *
+ * The AccessSettlement contract acts as an escrow system:
+ * 1. Runtime completes an operation and logs the final price
+ * 2. Consumer calls settlePaymentWithNative() or settlePaymentWithToken()
+ * 3. Funds are transferred to the issuer (dataset owner)
+ * 4. Runtime unlocks the operation artifacts for download
+ *
+ * @category Controllers
+ * @example
+ * ```typescript
+ * // Consumer pays for a completed operation
+ * const invoice = await sdk.accessSettlement.getOperationInvoice("op_123");
+ *
+ * if (!invoice.isSettled) {
+ *   const result = await sdk.accessSettlement.settlePaymentWithNative(
+ *     "op_123",
+ *     invoice.price
+ *   );
+ *   console.log(`Payment settled: ${result.hash}`);
+ * }
+ * ```
+ */
+export declare 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`);
+     * ```
+     */
+    getOperationInvoice(operationId: string): Promise<OperationInvoice>;
+    /**
+     * 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");
+     * }
+     * ```
+     */
+    isOperationSettled(operationId: string): Promise<boolean>;
+    /**
+     * 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");
+     * ```
+     */
+    settlePaymentWithNative(operationId: string, value: bigint): Promise<PaymentSettlementResult>;
+    /**
+     * 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);
+     * ```
+     */
+    settlePaymentWithToken(operationId: string, tokenAddress: `0x${string}`): Promise<PaymentSettlementResult>;
+    /**
+     * Helper method to convert operation ID string to bytes
+     * @internal
+     */
+    private stringToBytes;
+}