@opendatalabs/vana-sdk 3.7.0 → 3.7.2

package/dist/config/contracts.config.cjs

@@ -25,6 +25,18 @@ const CONTRACTS = {
   // ========================================
   // DATA PORTABILITY CONTRACTS
   // ========================================
+  DataPortabilityEscrow: {
+    addresses: {
+      14800: "0x07d7769081adc3a3DBe91f5E4B98E9A5a6B292e3",
+      1480: "0x07d7769081adc3a3DBe91f5E4B98E9A5a6B292e3"
+    }
+  },
+  FeeRegistry: {
+    addresses: {
+      14800: "0xb4FA18443E0FA6cdC0280D20b8cCDB2377D13Bf2",
+      1480: "0xb4FA18443E0FA6cdC0280D20b8cCDB2377D13Bf2"
+    }
+  },
   DataPortabilityPermissions: {
     addresses: {
       14800: "0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF",

package/dist/config/contracts.config.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/contracts.config.ts"],"sourcesContent":["// SOURCE CONFIGURATION - Complete contract registry\n// Generated output: src/generated/addresses.ts\n\n/**\n * Complete contract configuration for the Vana protocol.\n *\n * ⚠️ THIS IS A SOURCE FILE - EDIT THIS TO ADD/UPDATE CONTRACTS\n *\n * @remarks\n * This file contains all contract addresses and discovery metadata in one place.\n *\n * **Contract Types:**\n * - Entry Points: Contracts without `discovery` field (must be known externally)\n * - Discoverable: Contracts with `discovery` field (auto-discovered from parent)\n *\n * **Build Process:**\n * 1. Edit this file to add/update contracts\n * 2. Run `npm run discover-addresses` to validate and generate complete registry\n * 3. Run `npm run fetch-abis` to fetch ABIs for all contracts\n *\n * @category Configuration\n * @internal This is a source file - apps should import from src/generated/addresses.ts\n */\n\ninterface DiscoveryMetadata {\n  /** Parent contract to discover this from */\n  parent: string;\n  /** Getter function name on parent contract */\n  getter: string;\n}\n\ninterface ContractConfig {\n  addresses: {\n    14800: string;\n    1480: string;\n  };\n  /** If present, this contract can be auto-discovered from parent */\n  discovery?: DiscoveryMetadata;\n}\n\nexport const CONTRACTS: Record<string, ContractConfig> = {\n  // ========================================\n  // DATA PORTABILITY CONTRACTS\n  // ========================================\n  DataPortabilityPermissions: {\n    addresses: {\n      14800: \"0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF\",\n      1480: \"0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF\",\n    },\n  },\n  DataPortabilityServers: {\n    addresses: {\n      14800: \"0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c\",\n      1480: \"0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c\",\n    },\n  },\n  DataPortabilityGrantees: {\n    addresses: {\n      14800: \"0x8325C0A0948483EdA023A1A2Fd895e62C5131234\",\n      1480: \"0x8325C0A0948483EdA023A1A2Fd895e62C5131234\",\n    },\n  },\n  DataRegistry: {\n    addresses: {\n      14800: \"0x8C8788f98385F6ba1adD4234e551ABba0f82Cb7C\",\n      1480: \"0x8C8788f98385F6ba1adD4234e551ABba0f82Cb7C\",\n    },\n  },\n\n  // ========================================\n  // COMPUTING INFRASTRUCTURE\n  // ========================================\n  ComputeEngine: {\n    addresses: {\n      14800: \"0xb2BFe33FA420c45F1Cf1287542ad81ae935447bd\",\n      1480: \"0xb2BFe33FA420c45F1Cf1287542ad81ae935447bd\",\n    },\n  },\n  ComputeEngineTreasury: {\n    addresses: {\n      14800: \"0xceB33C501B624D984bD1Ed3298f6D1d8F7CE03d1\",\n      1480: \"0xceB33C501B624D984bD1Ed3298f6D1d8F7CE03d1\",\n    },\n    discovery: {\n      parent: \"ComputeEngine\",\n      getter: \"computeEngineTreasury\",\n    },\n  },\n  QueryEngine: {\n    addresses: {\n      14800: \"0xd25Eb66EA2452cf3238A2eC6C1FD1B7F5B320490\",\n      1480: \"0xd25Eb66EA2452cf3238A2eC6C1FD1B7F5B320490\",\n    },\n  },\n  VanaTreasury: {\n    addresses: {\n      14800: \"0x8B32Ef32f22e72cc25D53f6E858f57cAe7E198f9\",\n      1480: \"0x8B32Ef32f22e72cc25D53f6E858f57cAe7E198f9\",\n    },\n    discovery: {\n      parent: \"QueryEngine\",\n      getter: \"queryEngineTreasury\",\n    },\n  },\n  DataRefinerRegistry: {\n    addresses: {\n      14800: \"0x93c3EF89369fDcf08Be159D9DeF0F18AB6Be008c\",\n      1480: \"0x93c3EF89369fDcf08Be159D9DeF0F18AB6Be008c\",\n    },\n  },\n  ComputeInstructionRegistry: {\n    addresses: {\n      14800: \"0x5786B12b4c6Ba2bFAF0e77Ed30Bf6d32805563A5\",\n      1480: \"0x5786B12b4c6Ba2bFAF0e77Ed30Bf6d32805563A5\",\n    },\n  },\n\n  // ========================================\n  // TEE POOLS (Canonical Deployments)\n  // ========================================\n  TeePoolPhala: {\n    addresses: {\n      14800: \"0xE8EC6BD73b23Ad40E6B9a6f4bD343FAc411bD99A\",\n      1480: \"0xE8EC6BD73b23Ad40E6B9a6f4bD343FAc411bD99A\",\n    },\n  },\n  TeePoolEphemeralStandard: {\n    addresses: {\n      14800: \"0xe124bae846D5ec157f75Bd9e68ca87C4d2AB835A\",\n      1480: \"0xe124bae846D5ec157f75Bd9e68ca87C4d2AB835A\",\n    },\n  },\n  TeePoolPersistentStandard: {\n    addresses: {\n      14800: \"0xe8bB8d0629651Cf33e0845d743976Dc1f0971d76\",\n      1480: \"0xe8bB8d0629651Cf33e0845d743976Dc1f0971d76\",\n    },\n  },\n  TeePoolPersistentGpu: {\n    addresses: {\n      14800: \"0x1c346Cd74f8551f8fa13f3F4b6b8dAE22338E6a9\",\n      1480: \"0x1c346Cd74f8551f8fa13f3F4b6b8dAE22338E6a9\",\n    },\n  },\n  TeePoolDedicatedStandard: {\n    addresses: {\n      14800: \"0xf024b7ac5E8417416f53B41ecfa58C8e9396687d\",\n      1480: \"0xf024b7ac5E8417416f53B41ecfa58C8e9396687d\",\n    },\n  },\n  TeePoolDedicatedGpu: {\n    addresses: {\n      14800: \"0xB1686FA9620bBf851714d1cB47b8a4Bf4664644E\",\n      1480: \"0xB1686FA9620bBf851714d1cB47b8a4Bf4664644E\",\n    },\n  },\n\n  // ========================================\n  // VANA EPOCH / DLP REGISTRY\n  // ========================================\n  // Note: DLP rewards-specific contracts (DLPPerformance, DLPRewardDeployer,\n  // DLPRewardDeployerTreasury, DLPRewardSwap, SwapHelper) were removed in the\n  // protocol unification cleanup. VanaEpoch, DLPRegistry, and DLPRegistryTreasury\n  // are kept because they may be referenced beyond the rewards system.\n  VanaEpoch: {\n    addresses: {\n      14800: \"0x2063cFF0609D59bCCc196E20Eb58A8696a6b15A0\",\n      1480: \"0x2063cFF0609D59bCCc196E20Eb58A8696a6b15A0\",\n    },\n  },\n  DLPRegistry: {\n    addresses: {\n      14800: \"0x4D59880a924526d1dD33260552Ff4328b1E18a43\",\n      1480: \"0x4D59880a924526d1dD33260552Ff4328b1E18a43\",\n    },\n  },\n  DLPRegistryTreasury: {\n    addresses: {\n      14800: \"0xb12ce1d27bEeFe39b6F0110b1AB77C21Aa0c9F9a\",\n      1480: \"0xb12ce1d27bEeFe39b6F0110b1AB77C21Aa0c9F9a\",\n    },\n    discovery: {\n      parent: \"DLPRegistry\",\n      getter: \"treasury\",\n    },\n  },\n\n  // ========================================\n  // VANA POOL (STAKING)\n  // ========================================\n  VanaPoolStaking: {\n    addresses: {\n      14800: \"0x641C18E2F286c86f96CE95C8ec1EB9fC0415Ca0e\",\n      1480: \"0x641C18E2F286c86f96CE95C8ec1EB9fC0415Ca0e\",\n    },\n  },\n  VanaPoolTreasury: {\n    addresses: {\n      14800: \"0x143BE72CF2541604A7691933CAccd6D9cC17c003\",\n      1480: \"0x143BE72CF2541604A7691933CAccd6D9cC17c003\",\n    },\n    discovery: {\n      parent: \"VanaPoolStaking\",\n      getter: \"vanaPoolTreasury\",\n    },\n  },\n  VanaPoolEntity: {\n    addresses: {\n      14800: \"0x44f20490A82e1f1F1cC25Dd3BA8647034eDdce30\",\n      1480: \"0x44f20490A82e1f1F1cC25Dd3BA8647034eDdce30\",\n    },\n    discovery: {\n      parent: \"VanaPoolStaking\",\n      getter: \"vanaPoolEntity\",\n    },\n  },\n\n  // ========================================\n  // DLP DEPLOYMENT & TOKEN SYSTEM\n  // ========================================\n  DATFactory: {\n    addresses: {\n      14800: \"0x40f8bccF35a75ecef63BC3B1B3E06ffEB9220644\",\n      1480: \"0x40f8bccF35a75ecef63BC3B1B3E06ffEB9220644\",\n    },\n  },\n  DAT: {\n    addresses: {\n      14800: \"0xA706b93ccED89f13340673889e29F0a5cd84212d\",\n      1480: \"0xA706b93ccED89f13340673889e29F0a5cd84212d\",\n    },\n  },\n  DATPausable: {\n    addresses: {\n      14800: \"0xe69FE86f0B95cC2f8416Fe22815c85DC8887e76e\",\n      1480: \"0xe69FE86f0B95cC2f8416Fe22815c85DC8887e76e\",\n    },\n  },\n  DATVotes: {\n    addresses: {\n      14800: \"0xaE04c8A77E9B27869eb563720524A9aE0baf1831\",\n      1480: \"0xaE04c8A77E9B27869eb563720524A9aE0baf1831\",\n    },\n  },\n\n  // ========================================\n  // EXTERNAL DEPENDENCIES (DeFi)\n  // ========================================\n  WVANA: {\n    addresses: {\n      14800: \"0xbccc4b4c6530F82FE309c5E845E50b5E9C89f2AD\",\n      1480: \"0x00EDdD9621Fb08436d0331c149D1690909a5906d\",\n    },\n  },\n  UniswapV3NonfungiblePositionManager: {\n    addresses: {\n      14800: \"0x48Bd633f4B9128a38Ebb4a48b6975EB3Eaf1931b\",\n      1480: \"0x45a2992e1bFdCF9b9AcE0a84A238f2E56F481816\",\n    },\n  },\n  UniswapV3QuoterV2: {\n    addresses: {\n      14800: \"0x3152246f3CD4dD465292Dd4Ffd792E2Cf602e332\",\n      1480: \"0x1b13728ea3C90863990aC0e05987CfeC1888908c\",\n    },\n  },\n\n  // ========================================\n  // UTILITY CONTRACTS\n  // ========================================\n  Multicall3: {\n    addresses: {\n      14800: \"0xD8d2dFca27E8797fd779F8547166A2d3B29d360E\",\n      1480: \"0xD8d2dFca27E8797fd779F8547166A2d3B29d360E\",\n    },\n  },\n  Multisend: {\n    addresses: {\n      14800: \"0x8807e8BCDFbaA8c2761760f3FBA37F6f7F2C5b2d\",\n      1480: \"0x8807e8BCDFbaA8c2761760f3FBA37F6f7F2C5b2d\",\n    },\n  },\n} as const;\n\n// Legacy DLPRoot* and deprecated TeePool entries were removed in the protocol\n// unification cleanup. They were part of the old DLP rewards system superseded\n// by other contracts.\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/config/contracts.config.ts"],"sourcesContent":["// SOURCE CONFIGURATION - Complete contract registry\n// Generated output: src/generated/addresses.ts\n\n/**\n * Complete contract configuration for the Vana protocol.\n *\n * ⚠️ THIS IS A SOURCE FILE - EDIT THIS TO ADD/UPDATE CONTRACTS\n *\n * @remarks\n * This file contains all contract addresses and discovery metadata in one place.\n *\n * **Contract Types:**\n * - Entry Points: Contracts without `discovery` field (must be known externally)\n * - Discoverable: Contracts with `discovery` field (auto-discovered from parent)\n *\n * **Build Process:**\n * 1. Edit this file to add/update contracts\n * 2. Run `npm run discover-addresses` to validate and generate complete registry\n * 3. Run `npm run fetch-abis` to fetch ABIs for all contracts\n *\n * @category Configuration\n * @internal This is a source file - apps should import from src/generated/addresses.ts\n */\n\ninterface DiscoveryMetadata {\n  /** Parent contract to discover this from */\n  parent: string;\n  /** Getter function name on parent contract */\n  getter: string;\n}\n\ninterface ContractConfig {\n  addresses: {\n    14800: string;\n    1480: string;\n  };\n  /** If present, this contract can be auto-discovered from parent */\n  discovery?: DiscoveryMetadata;\n}\n\nexport const CONTRACTS: Record<string, ContractConfig> = {\n  // ========================================\n  // DATA PORTABILITY CONTRACTS\n  // ========================================\n  DataPortabilityEscrow: {\n    addresses: {\n      14800: \"0x07d7769081adc3a3DBe91f5E4B98E9A5a6B292e3\",\n      1480: \"0x07d7769081adc3a3DBe91f5E4B98E9A5a6B292e3\",\n    },\n  },\n  FeeRegistry: {\n    addresses: {\n      14800: \"0xb4FA18443E0FA6cdC0280D20b8cCDB2377D13Bf2\",\n      1480: \"0xb4FA18443E0FA6cdC0280D20b8cCDB2377D13Bf2\",\n    },\n  },\n  DataPortabilityPermissions: {\n    addresses: {\n      14800: \"0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF\",\n      1480: \"0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF\",\n    },\n  },\n  DataPortabilityServers: {\n    addresses: {\n      14800: \"0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c\",\n      1480: \"0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c\",\n    },\n  },\n  DataPortabilityGrantees: {\n    addresses: {\n      14800: \"0x8325C0A0948483EdA023A1A2Fd895e62C5131234\",\n      1480: \"0x8325C0A0948483EdA023A1A2Fd895e62C5131234\",\n    },\n  },\n  DataRegistry: {\n    addresses: {\n      14800: \"0x8C8788f98385F6ba1adD4234e551ABba0f82Cb7C\",\n      1480: \"0x8C8788f98385F6ba1adD4234e551ABba0f82Cb7C\",\n    },\n  },\n\n  // ========================================\n  // COMPUTING INFRASTRUCTURE\n  // ========================================\n  ComputeEngine: {\n    addresses: {\n      14800: \"0xb2BFe33FA420c45F1Cf1287542ad81ae935447bd\",\n      1480: \"0xb2BFe33FA420c45F1Cf1287542ad81ae935447bd\",\n    },\n  },\n  ComputeEngineTreasury: {\n    addresses: {\n      14800: \"0xceB33C501B624D984bD1Ed3298f6D1d8F7CE03d1\",\n      1480: \"0xceB33C501B624D984bD1Ed3298f6D1d8F7CE03d1\",\n    },\n    discovery: {\n      parent: \"ComputeEngine\",\n      getter: \"computeEngineTreasury\",\n    },\n  },\n  QueryEngine: {\n    addresses: {\n      14800: \"0xd25Eb66EA2452cf3238A2eC6C1FD1B7F5B320490\",\n      1480: \"0xd25Eb66EA2452cf3238A2eC6C1FD1B7F5B320490\",\n    },\n  },\n  VanaTreasury: {\n    addresses: {\n      14800: \"0x8B32Ef32f22e72cc25D53f6E858f57cAe7E198f9\",\n      1480: \"0x8B32Ef32f22e72cc25D53f6E858f57cAe7E198f9\",\n    },\n    discovery: {\n      parent: \"QueryEngine\",\n      getter: \"queryEngineTreasury\",\n    },\n  },\n  DataRefinerRegistry: {\n    addresses: {\n      14800: \"0x93c3EF89369fDcf08Be159D9DeF0F18AB6Be008c\",\n      1480: \"0x93c3EF89369fDcf08Be159D9DeF0F18AB6Be008c\",\n    },\n  },\n  ComputeInstructionRegistry: {\n    addresses: {\n      14800: \"0x5786B12b4c6Ba2bFAF0e77Ed30Bf6d32805563A5\",\n      1480: \"0x5786B12b4c6Ba2bFAF0e77Ed30Bf6d32805563A5\",\n    },\n  },\n\n  // ========================================\n  // TEE POOLS (Canonical Deployments)\n  // ========================================\n  TeePoolPhala: {\n    addresses: {\n      14800: \"0xE8EC6BD73b23Ad40E6B9a6f4bD343FAc411bD99A\",\n      1480: \"0xE8EC6BD73b23Ad40E6B9a6f4bD343FAc411bD99A\",\n    },\n  },\n  TeePoolEphemeralStandard: {\n    addresses: {\n      14800: \"0xe124bae846D5ec157f75Bd9e68ca87C4d2AB835A\",\n      1480: \"0xe124bae846D5ec157f75Bd9e68ca87C4d2AB835A\",\n    },\n  },\n  TeePoolPersistentStandard: {\n    addresses: {\n      14800: \"0xe8bB8d0629651Cf33e0845d743976Dc1f0971d76\",\n      1480: \"0xe8bB8d0629651Cf33e0845d743976Dc1f0971d76\",\n    },\n  },\n  TeePoolPersistentGpu: {\n    addresses: {\n      14800: \"0x1c346Cd74f8551f8fa13f3F4b6b8dAE22338E6a9\",\n      1480: \"0x1c346Cd74f8551f8fa13f3F4b6b8dAE22338E6a9\",\n    },\n  },\n  TeePoolDedicatedStandard: {\n    addresses: {\n      14800: \"0xf024b7ac5E8417416f53B41ecfa58C8e9396687d\",\n      1480: \"0xf024b7ac5E8417416f53B41ecfa58C8e9396687d\",\n    },\n  },\n  TeePoolDedicatedGpu: {\n    addresses: {\n      14800: \"0xB1686FA9620bBf851714d1cB47b8a4Bf4664644E\",\n      1480: \"0xB1686FA9620bBf851714d1cB47b8a4Bf4664644E\",\n    },\n  },\n\n  // ========================================\n  // VANA EPOCH / DLP REGISTRY\n  // ========================================\n  // Note: DLP rewards-specific contracts (DLPPerformance, DLPRewardDeployer,\n  // DLPRewardDeployerTreasury, DLPRewardSwap, SwapHelper) were removed in the\n  // protocol unification cleanup. VanaEpoch, DLPRegistry, and DLPRegistryTreasury\n  // are kept because they may be referenced beyond the rewards system.\n  VanaEpoch: {\n    addresses: {\n      14800: \"0x2063cFF0609D59bCCc196E20Eb58A8696a6b15A0\",\n      1480: \"0x2063cFF0609D59bCCc196E20Eb58A8696a6b15A0\",\n    },\n  },\n  DLPRegistry: {\n    addresses: {\n      14800: \"0x4D59880a924526d1dD33260552Ff4328b1E18a43\",\n      1480: \"0x4D59880a924526d1dD33260552Ff4328b1E18a43\",\n    },\n  },\n  DLPRegistryTreasury: {\n    addresses: {\n      14800: \"0xb12ce1d27bEeFe39b6F0110b1AB77C21Aa0c9F9a\",\n      1480: \"0xb12ce1d27bEeFe39b6F0110b1AB77C21Aa0c9F9a\",\n    },\n    discovery: {\n      parent: \"DLPRegistry\",\n      getter: \"treasury\",\n    },\n  },\n\n  // ========================================\n  // VANA POOL (STAKING)\n  // ========================================\n  VanaPoolStaking: {\n    addresses: {\n      14800: \"0x641C18E2F286c86f96CE95C8ec1EB9fC0415Ca0e\",\n      1480: \"0x641C18E2F286c86f96CE95C8ec1EB9fC0415Ca0e\",\n    },\n  },\n  VanaPoolTreasury: {\n    addresses: {\n      14800: \"0x143BE72CF2541604A7691933CAccd6D9cC17c003\",\n      1480: \"0x143BE72CF2541604A7691933CAccd6D9cC17c003\",\n    },\n    discovery: {\n      parent: \"VanaPoolStaking\",\n      getter: \"vanaPoolTreasury\",\n    },\n  },\n  VanaPoolEntity: {\n    addresses: {\n      14800: \"0x44f20490A82e1f1F1cC25Dd3BA8647034eDdce30\",\n      1480: \"0x44f20490A82e1f1F1cC25Dd3BA8647034eDdce30\",\n    },\n    discovery: {\n      parent: \"VanaPoolStaking\",\n      getter: \"vanaPoolEntity\",\n    },\n  },\n\n  // ========================================\n  // DLP DEPLOYMENT & TOKEN SYSTEM\n  // ========================================\n  DATFactory: {\n    addresses: {\n      14800: \"0x40f8bccF35a75ecef63BC3B1B3E06ffEB9220644\",\n      1480: \"0x40f8bccF35a75ecef63BC3B1B3E06ffEB9220644\",\n    },\n  },\n  DAT: {\n    addresses: {\n      14800: \"0xA706b93ccED89f13340673889e29F0a5cd84212d\",\n      1480: \"0xA706b93ccED89f13340673889e29F0a5cd84212d\",\n    },\n  },\n  DATPausable: {\n    addresses: {\n      14800: \"0xe69FE86f0B95cC2f8416Fe22815c85DC8887e76e\",\n      1480: \"0xe69FE86f0B95cC2f8416Fe22815c85DC8887e76e\",\n    },\n  },\n  DATVotes: {\n    addresses: {\n      14800: \"0xaE04c8A77E9B27869eb563720524A9aE0baf1831\",\n      1480: \"0xaE04c8A77E9B27869eb563720524A9aE0baf1831\",\n    },\n  },\n\n  // ========================================\n  // EXTERNAL DEPENDENCIES (DeFi)\n  // ========================================\n  WVANA: {\n    addresses: {\n      14800: \"0xbccc4b4c6530F82FE309c5E845E50b5E9C89f2AD\",\n      1480: \"0x00EDdD9621Fb08436d0331c149D1690909a5906d\",\n    },\n  },\n  UniswapV3NonfungiblePositionManager: {\n    addresses: {\n      14800: \"0x48Bd633f4B9128a38Ebb4a48b6975EB3Eaf1931b\",\n      1480: \"0x45a2992e1bFdCF9b9AcE0a84A238f2E56F481816\",\n    },\n  },\n  UniswapV3QuoterV2: {\n    addresses: {\n      14800: \"0x3152246f3CD4dD465292Dd4Ffd792E2Cf602e332\",\n      1480: \"0x1b13728ea3C90863990aC0e05987CfeC1888908c\",\n    },\n  },\n\n  // ========================================\n  // UTILITY CONTRACTS\n  // ========================================\n  Multicall3: {\n    addresses: {\n      14800: \"0xD8d2dFca27E8797fd779F8547166A2d3B29d360E\",\n      1480: \"0xD8d2dFca27E8797fd779F8547166A2d3B29d360E\",\n    },\n  },\n  Multisend: {\n    addresses: {\n      14800: \"0x8807e8BCDFbaA8c2761760f3FBA37F6f7F2C5b2d\",\n      1480: \"0x8807e8BCDFbaA8c2761760f3FBA37F6f7F2C5b2d\",\n    },\n  },\n} as const;\n\n// Legacy DLPRoot* and deprecated TeePool entries were removed in the protocol\n// unification cleanup. They were part of the old DLP rewards system superseded\n// by other contracts.\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAwCO,MAAM,YAA4C;AAAA;AAAA;AAAA;AAAA,EAIvD,uBAAuB;AAAA,IACrB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,4BAA4B;AAAA,IAC1B,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,wBAAwB;AAAA,IACtB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,yBAAyB;AAAA,IACvB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,cAAc;AAAA,IACZ,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,eAAe;AAAA,IACb,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,uBAAuB;AAAA,IACrB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,WAAW;AAAA,MACT,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,cAAc;AAAA,IACZ,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,WAAW;AAAA,MACT,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAAA,EACF;AAAA,EACA,qBAAqB;AAAA,IACnB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,4BAA4B;AAAA,IAC1B,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc;AAAA,IACZ,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,0BAA0B;AAAA,IACxB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,2BAA2B;AAAA,IACzB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,sBAAsB;AAAA,IACpB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,0BAA0B;AAAA,IACxB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,qBAAqB;AAAA,IACnB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW;AAAA,IACT,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,qBAAqB;AAAA,IACnB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,WAAW;AAAA,MACT,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,iBAAiB;AAAA,IACf,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,kBAAkB;AAAA,IAChB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,WAAW;AAAA,MACT,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,IACA,WAAW;AAAA,MACT,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY;AAAA,IACV,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,KAAK;AAAA,IACH,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,aAAa;AAAA,IACX,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO;AAAA,IACL,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,qCAAqC;AAAA,IACnC,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,mBAAmB;AAAA,IACjB,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,YAAY;AAAA,IACV,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EACA,WAAW;AAAA,IACT,WAAW;AAAA,MACT,OAAO;AAAA,MACP,MAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}

package/dist/config/contracts.config.js

@@ -2,6 +2,18 @@ const CONTRACTS = {
   // ========================================
   // DATA PORTABILITY CONTRACTS
   // ========================================
+  DataPortabilityEscrow: {
+    addresses: {
+      14800: "0x07d7769081adc3a3DBe91f5E4B98E9A5a6B292e3",
+      1480: "0x07d7769081adc3a3DBe91f5E4B98E9A5a6B292e3"
+    }
+  },
+  FeeRegistry: {
+    addresses: {
+      14800: "0xb4FA18443E0FA6cdC0280D20b8cCDB2377D13Bf2",
+      1480: "0xb4FA18443E0FA6cdC0280D20b8cCDB2377D13Bf2"
+    }
+  },
   DataPortabilityPermissions: {
     addresses: {
       14800: "0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF",

package/dist/config/contracts.config.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config/contracts.config.ts"],"sourcesContent":["// SOURCE CONFIGURATION - Complete contract registry\n// Generated output: src/generated/addresses.ts\n\n/**\n * Complete contract configuration for the Vana protocol.\n *\n * ⚠️ THIS IS A SOURCE FILE - EDIT THIS TO ADD/UPDATE CONTRACTS\n *\n * @remarks\n * This file contains all contract addresses and discovery metadata in one place.\n *\n * **Contract Types:**\n * - Entry Points: Contracts without `discovery` field (must be known externally)\n * - Discoverable: Contracts with `discovery` field (auto-discovered from parent)\n *\n * **Build Process:**\n * 1. Edit this file to add/update contracts\n * 2. Run `npm run discover-addresses` to validate and generate complete registry\n * 3. Run `npm run fetch-abis` to fetch ABIs for all contracts\n *\n * @category Configuration\n * @internal This is a source file - apps should import from src/generated/addresses.ts\n */\n\ninterface DiscoveryMetadata {\n  /** Parent contract to discover this from */\n  parent: string;\n  /** Getter function name on parent contract */\n  getter: string;\n}\n\ninterface ContractConfig {\n  addresses: {\n    14800: string;\n    1480: string;\n  };\n  /** If present, this contract can be auto-discovered from parent */\n  discovery?: DiscoveryMetadata;\n}\n\nexport const CONTRACTS: Record<string, ContractConfig> = {\n  // ========================================\n  // DATA PORTABILITY CONTRACTS\n  // ========================================\n  DataPortabilityPermissions: {\n    addresses: {\n      14800: \"0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF\",\n      1480: \"0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF\",\n    },\n  },\n  DataPortabilityServers: {\n    addresses: {\n      14800: \"0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c\",\n      1480: \"0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c\",\n    },\n  },\n  DataPortabilityGrantees: {\n    addresses: {\n      14800: \"0x8325C0A0948483EdA023A1A2Fd895e62C5131234\",\n      1480: \"0x8325C0A0948483EdA023A1A2Fd895e62C5131234\",\n    },\n  },\n  DataRegistry: {\n    addresses: {\n      14800: \"0x8C8788f98385F6ba1adD4234e551ABba0f82Cb7C\",\n      1480: \"0x8C8788f98385F6ba1adD4234e551ABba0f82Cb7C\",\n    },\n  },\n\n  // ========================================\n  // COMPUTING INFRASTRUCTURE\n  // ========================================\n  ComputeEngine: {\n    addresses: {\n      14800: \"0xb2BFe33FA420c45F1Cf1287542ad81ae935447bd\",\n      1480: \"0xb2BFe33FA420c45F1Cf1287542ad81ae935447bd\",\n    },\n  },\n  ComputeEngineTreasury: {\n    addresses: {\n      14800: \"0xceB33C501B624D984bD1Ed3298f6D1d8F7CE03d1\",\n      1480: \"0xceB33C501B624D984bD1Ed3298f6D1d8F7CE03d1\",\n    },\n    discovery: {\n      parent: \"ComputeEngine\",\n      getter: \"computeEngineTreasury\",\n    },\n  },\n  QueryEngine: {\n    addresses: {\n      14800: \"0xd25Eb66EA2452cf3238A2eC6C1FD1B7F5B320490\",\n      1480: \"0xd25Eb66EA2452cf3238A2eC6C1FD1B7F5B320490\",\n    },\n  },\n  VanaTreasury: {\n    addresses: {\n      14800: \"0x8B32Ef32f22e72cc25D53f6E858f57cAe7E198f9\",\n      1480: \"0x8B32Ef32f22e72cc25D53f6E858f57cAe7E198f9\",\n    },\n    discovery: {\n      parent: \"QueryEngine\",\n      getter: \"queryEngineTreasury\",\n    },\n  },\n  DataRefinerRegistry: {\n    addresses: {\n      14800: \"0x93c3EF89369fDcf08Be159D9DeF0F18AB6Be008c\",\n      1480: \"0x93c3EF89369fDcf08Be159D9DeF0F18AB6Be008c\",\n    },\n  },\n  ComputeInstructionRegistry: {\n    addresses: {\n      14800: \"0x5786B12b4c6Ba2bFAF0e77Ed30Bf6d32805563A5\",\n      1480: \"0x5786B12b4c6Ba2bFAF0e77Ed30Bf6d32805563A5\",\n    },\n  },\n\n  // ========================================\n  // TEE POOLS (Canonical Deployments)\n  // ========================================\n  TeePoolPhala: {\n    addresses: {\n      14800: \"0xE8EC6BD73b23Ad40E6B9a6f4bD343FAc411bD99A\",\n      1480: \"0xE8EC6BD73b23Ad40E6B9a6f4bD343FAc411bD99A\",\n    },\n  },\n  TeePoolEphemeralStandard: {\n    addresses: {\n      14800: \"0xe124bae846D5ec157f75Bd9e68ca87C4d2AB835A\",\n      1480: \"0xe124bae846D5ec157f75Bd9e68ca87C4d2AB835A\",\n    },\n  },\n  TeePoolPersistentStandard: {\n    addresses: {\n      14800: \"0xe8bB8d0629651Cf33e0845d743976Dc1f0971d76\",\n      1480: \"0xe8bB8d0629651Cf33e0845d743976Dc1f0971d76\",\n    },\n  },\n  TeePoolPersistentGpu: {\n    addresses: {\n      14800: \"0x1c346Cd74f8551f8fa13f3F4b6b8dAE22338E6a9\",\n      1480: \"0x1c346Cd74f8551f8fa13f3F4b6b8dAE22338E6a9\",\n    },\n  },\n  TeePoolDedicatedStandard: {\n    addresses: {\n      14800: \"0xf024b7ac5E8417416f53B41ecfa58C8e9396687d\",\n      1480: \"0xf024b7ac5E8417416f53B41ecfa58C8e9396687d\",\n    },\n  },\n  TeePoolDedicatedGpu: {\n    addresses: {\n      14800: \"0xB1686FA9620bBf851714d1cB47b8a4Bf4664644E\",\n      1480: \"0xB1686FA9620bBf851714d1cB47b8a4Bf4664644E\",\n    },\n  },\n\n  // ========================================\n  // VANA EPOCH / DLP REGISTRY\n  // ========================================\n  // Note: DLP rewards-specific contracts (DLPPerformance, DLPRewardDeployer,\n  // DLPRewardDeployerTreasury, DLPRewardSwap, SwapHelper) were removed in the\n  // protocol unification cleanup. VanaEpoch, DLPRegistry, and DLPRegistryTreasury\n  // are kept because they may be referenced beyond the rewards system.\n  VanaEpoch: {\n    addresses: {\n      14800: \"0x2063cFF0609D59bCCc196E20Eb58A8696a6b15A0\",\n      1480: \"0x2063cFF0609D59bCCc196E20Eb58A8696a6b15A0\",\n    },\n  },\n  DLPRegistry: {\n    addresses: {\n      14800: \"0x4D59880a924526d1dD33260552Ff4328b1E18a43\",\n      1480: \"0x4D59880a924526d1dD33260552Ff4328b1E18a43\",\n    },\n  },\n  DLPRegistryTreasury: {\n    addresses: {\n      14800: \"0xb12ce1d27bEeFe39b6F0110b1AB77C21Aa0c9F9a\",\n      1480: \"0xb12ce1d27bEeFe39b6F0110b1AB77C21Aa0c9F9a\",\n    },\n    discovery: {\n      parent: \"DLPRegistry\",\n      getter: \"treasury\",\n    },\n  },\n\n  // ========================================\n  // VANA POOL (STAKING)\n  // ========================================\n  VanaPoolStaking: {\n    addresses: {\n      14800: \"0x641C18E2F286c86f96CE95C8ec1EB9fC0415Ca0e\",\n      1480: \"0x641C18E2F286c86f96CE95C8ec1EB9fC0415Ca0e\",\n    },\n  },\n  VanaPoolTreasury: {\n    addresses: {\n      14800: \"0x143BE72CF2541604A7691933CAccd6D9cC17c003\",\n      1480: \"0x143BE72CF2541604A7691933CAccd6D9cC17c003\",\n    },\n    discovery: {\n      parent: \"VanaPoolStaking\",\n      getter: \"vanaPoolTreasury\",\n    },\n  },\n  VanaPoolEntity: {\n    addresses: {\n      14800: \"0x44f20490A82e1f1F1cC25Dd3BA8647034eDdce30\",\n      1480: \"0x44f20490A82e1f1F1cC25Dd3BA8647034eDdce30\",\n    },\n    discovery: {\n      parent: \"VanaPoolStaking\",\n      getter: \"vanaPoolEntity\",\n    },\n  },\n\n  // ========================================\n  // DLP DEPLOYMENT & TOKEN SYSTEM\n  // ========================================\n  DATFactory: {\n    addresses: {\n      14800: \"0x40f8bccF35a75ecef63BC3B1B3E06ffEB9220644\",\n      1480: \"0x40f8bccF35a75ecef63BC3B1B3E06ffEB9220644\",\n    },\n  },\n  DAT: {\n    addresses: {\n      14800: \"0xA706b93ccED89f13340673889e29F0a5cd84212d\",\n      1480: \"0xA706b93ccED89f13340673889e29F0a5cd84212d\",\n    },\n  },\n  DATPausable: {\n    addresses: {\n      14800: \"0xe69FE86f0B95cC2f8416Fe22815c85DC8887e76e\",\n      1480: \"0xe69FE86f0B95cC2f8416Fe22815c85DC8887e76e\",\n    },\n  },\n  DATVotes: {\n    addresses: {\n      14800: \"0xaE04c8A77E9B27869eb563720524A9aE0baf1831\",\n      1480: \"0xaE04c8A77E9B27869eb563720524A9aE0baf1831\",\n    },\n  },\n\n  // ========================================\n  // EXTERNAL DEPENDENCIES (DeFi)\n  // ========================================\n  WVANA: {\n    addresses: {\n      14800: \"0xbccc4b4c6530F82FE309c5E845E50b5E9C89f2AD\",\n      1480: \"0x00EDdD9621Fb08436d0331c149D1690909a5906d\",\n    },\n  },\n  UniswapV3NonfungiblePositionManager: {\n    addresses: {\n      14800: \"0x48Bd633f4B9128a38Ebb4a48b6975EB3Eaf1931b\",\n      1480: \"0x45a2992e1bFdCF9b9AcE0a84A238f2E56F481816\",\n    },\n  },\n  UniswapV3QuoterV2: {\n    addresses: {\n      14800: \"0x3152246f3CD4dD465292Dd4Ffd792E2Cf602e332\",\n      1480: \"0x1b13728ea3C90863990aC0e05987CfeC1888908c\",\n    },\n  },\n\n  // ========================================\n  // UTILITY CONTRACTS\n  // ========================================\n  Multicall3: {\n    addresses: {\n      14800: \"0xD8d2dFca27E8797fd779F8547166A2d3B29d360E\",\n      1480: \"0xD8d2dFca27E8797fd779F8547166A2d3B29d360E\",\n    },\n  },\n  Multisend: {\n    addresses: {\n      14800: \"0x8807e8BCDFbaA8c2761760f3FBA37F6f7F2C5b2d\",\n      1480: \"0x8807e8BCDFbaA8c2761760f3FBA37F6f7F2C5b2d\",\n    },\n  },\n} as const;\n\n// Legacy DLPRoot* and deprecated TeePool entries were removed in the protocol\n// unification cleanup. They were part of the old DLP rewards system superseded\n// by other contracts.\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/config/contracts.config.ts"],"sourcesContent":["// SOURCE CONFIGURATION - Complete contract registry\n// Generated output: src/generated/addresses.ts\n\n/**\n * Complete contract configuration for the Vana protocol.\n *\n * ⚠️ THIS IS A SOURCE FILE - EDIT THIS TO ADD/UPDATE CONTRACTS\n *\n * @remarks\n * This file contains all contract addresses and discovery metadata in one place.\n *\n * **Contract Types:**\n * - Entry Points: Contracts without `discovery` field (must be known externally)\n * - Discoverable: Contracts with `discovery` field (auto-discovered from parent)\n *\n * **Build Process:**\n * 1. Edit this file to add/update contracts\n * 2. Run `npm run discover-addresses` to validate and generate complete registry\n * 3. Run `npm run fetch-abis` to fetch ABIs for all contracts\n *\n * @category Configuration\n * @internal This is a source file - apps should import from src/generated/addresses.ts\n */\n\ninterface DiscoveryMetadata {\n  /** Parent contract to discover this from */\n  parent: string;\n  /** Getter function name on parent contract */\n  getter: string;\n}\n\ninterface ContractConfig {\n  addresses: {\n    14800: string;\n    1480: string;\n  };\n  /** If present, this contract can be auto-discovered from parent */\n  discovery?: DiscoveryMetadata;\n}\n\nexport const CONTRACTS: Record<string, ContractConfig> = {\n  // ========================================\n  // DATA PORTABILITY CONTRACTS\n  // ========================================\n  DataPortabilityEscrow: {\n    addresses: {\n      14800: \"0x07d7769081adc3a3DBe91f5E4B98E9A5a6B292e3\",\n      1480: \"0x07d7769081adc3a3DBe91f5E4B98E9A5a6B292e3\",\n    },\n  },\n  FeeRegistry: {\n    addresses: {\n      14800: \"0xb4FA18443E0FA6cdC0280D20b8cCDB2377D13Bf2\",\n      1480: \"0xb4FA18443E0FA6cdC0280D20b8cCDB2377D13Bf2\",\n    },\n  },\n  DataPortabilityPermissions: {\n    addresses: {\n      14800: \"0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF\",\n      1480: \"0xD54523048AdD05b4d734aFaE7C68324Ebb7373eF\",\n    },\n  },\n  DataPortabilityServers: {\n    addresses: {\n      14800: \"0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c\",\n      1480: \"0x1483B1F634DBA75AeaE60da7f01A679aabd5ee2c\",\n    },\n  },\n  DataPortabilityGrantees: {\n    addresses: {\n      14800: \"0x8325C0A0948483EdA023A1A2Fd895e62C5131234\",\n      1480: \"0x8325C0A0948483EdA023A1A2Fd895e62C5131234\",\n    },\n  },\n  DataRegistry: {\n    addresses: {\n      14800: \"0x8C8788f98385F6ba1adD4234e551ABba0f82Cb7C\",\n      1480: \"0x8C8788f98385F6ba1adD4234e551ABba0f82Cb7C\",\n    },\n  },\n\n  // ========================================\n  // COMPUTING INFRASTRUCTURE\n  // ========================================\n  ComputeEngine: {\n    addresses: {\n      14800: \"0xb2BFe33FA420c45F1Cf1287542ad81ae935447bd\",\n      1480: \"0xb2BFe33FA420c45F1Cf1287542ad81ae935447bd\",\n    },\n  },\n  ComputeEngineTreasury: {\n    addresses: {\n      14800: \"0xceB33C501B624D984bD1Ed3298f6D1d8F7CE03d1\",\n      1480: \"0xceB33C501B624D984bD1Ed3298f6D1d8F7CE03d1\",\n    },\n    discovery: {\n      parent: \"ComputeEngine\",\n      getter: \"computeEngineTreasury\",\n    },\n  },\n  QueryEngine: {\n    addresses: {\n      14800: \"0xd25Eb66EA2452cf3238A2eC6C1FD1B7F5B320490\",\n      1480: \"0xd25Eb66EA2452cf3238A2eC6C1FD1B7F5B320490\",\n    },\n  },\n  VanaTreasury: {\n    addresses: {\n      14800: \"0x8B32Ef32f22e72cc25D53f6E858f57cAe7E198f9\",\n      1480: \"0x8B32Ef32f22e72cc25D53f6E858f57cAe7E198f9\",\n    },\n    discovery: {\n      parent: \"QueryEngine\",\n      getter: \"queryEngineTreasury\",\n    },\n  },\n  DataRefinerRegistry: {\n    addresses: {\n      14800: \"0x93c3EF89369fDcf08Be159D9DeF0F18AB6Be008c\",\n      1480: \"0x93c3EF89369fDcf08Be159D9DeF0F18AB6Be008c\",\n    },\n  },\n  ComputeInstructionRegistry: {\n    addresses: {\n      14800: \"0x5786B12b4c6Ba2bFAF0e77Ed30Bf6d32805563A5\",\n      1480: \"0x5786B12b4c6Ba2bFAF0e77Ed30Bf6d32805563A5\",\n    },\n  },\n\n  // ========================================\n  // TEE POOLS (Canonical Deployments)\n  // ========================================\n  TeePoolPhala: {\n    addresses: {\n      14800: \"0xE8EC6BD73b23Ad40E6B9a6f4bD343FAc411bD99A\",\n      1480: \"0xE8EC6BD73b23Ad40E6B9a6f4bD343FAc411bD99A\",\n    },\n  },\n  TeePoolEphemeralStandard: {\n    addresses: {\n      14800: \"0xe124bae846D5ec157f75Bd9e68ca87C4d2AB835A\",\n      1480: \"0xe124bae846D5ec157f75Bd9e68ca87C4d2AB835A\",\n    },\n  },\n  TeePoolPersistentStandard: {\n    addresses: {\n      14800: \"0xe8bB8d0629651Cf33e0845d743976Dc1f0971d76\",\n      1480: \"0xe8bB8d0629651Cf33e0845d743976Dc1f0971d76\",\n    },\n  },\n  TeePoolPersistentGpu: {\n    addresses: {\n      14800: \"0x1c346Cd74f8551f8fa13f3F4b6b8dAE22338E6a9\",\n      1480: \"0x1c346Cd74f8551f8fa13f3F4b6b8dAE22338E6a9\",\n    },\n  },\n  TeePoolDedicatedStandard: {\n    addresses: {\n      14800: \"0xf024b7ac5E8417416f53B41ecfa58C8e9396687d\",\n      1480: \"0xf024b7ac5E8417416f53B41ecfa58C8e9396687d\",\n    },\n  },\n  TeePoolDedicatedGpu: {\n    addresses: {\n      14800: \"0xB1686FA9620bBf851714d1cB47b8a4Bf4664644E\",\n      1480: \"0xB1686FA9620bBf851714d1cB47b8a4Bf4664644E\",\n    },\n  },\n\n  // ========================================\n  // VANA EPOCH / DLP REGISTRY\n  // ========================================\n  // Note: DLP rewards-specific contracts (DLPPerformance, DLPRewardDeployer,\n  // DLPRewardDeployerTreasury, DLPRewardSwap, SwapHelper) were removed in the\n  // protocol unification cleanup. VanaEpoch, DLPRegistry, and DLPRegistryTreasury\n  // are kept because they may be referenced beyond the rewards system.\n  VanaEpoch: {\n    addresses: {\n      14800: \"0x2063cFF0609D59bCCc196E20Eb58A8696a6b15A0\",\n      1480: \"0x2063cFF0609D59bCCc196E20Eb58A8696a6b15A0\",\n    },\n  },\n  DLPRegistry: {\n    addresses: {\n      14800: \"0x4D59880a924526d1dD33260552Ff4328b1E18a43\",\n      1480: \"0x4D59880a924526d1dD33260552Ff4328b1E18a43\",\n    },\n  },\n  DLPRegistryTreasury: {\n    addresses: {\n      14800: \"0xb12ce1d27bEeFe39b6F0110b1AB77C21Aa0c9F9a\",\n      1480: \"0xb12ce1d27bEeFe39b6F0110b1AB77C21Aa0c9F9a\",\n    },\n    discovery: {\n      parent: \"DLPRegistry\",\n      getter: \"treasury\",\n    },\n  },\n\n  // ========================================\n  // VANA POOL (STAKING)\n  // ========================================\n  VanaPoolStaking: {\n    addresses: {\n      14800: \"0x641C18E2F286c86f96CE95C8ec1EB9fC0415Ca0e\",\n      1480: \"0x641C18E2F286c86f96CE95C8ec1EB9fC0415Ca0e\",\n    },\n  },\n  VanaPoolTreasury: {\n    addresses: {\n      14800: \"0x143BE72CF2541604A7691933CAccd6D9cC17c003\",\n      1480: \"0x143BE72CF2541604A7691933CAccd6D9cC17c003\",\n    },\n    discovery: {\n      parent: \"VanaPoolStaking\",\n      getter: \"vanaPoolTreasury\",\n    },\n  },\n  VanaPoolEntity: {\n    addresses: {\n      14800: \"0x44f20490A82e1f1F1cC25Dd3BA8647034eDdce30\",\n      1480: \"0x44f20490A82e1f1F1cC25Dd3BA8647034eDdce30\",\n    },\n    discovery: {\n      parent: \"VanaPoolStaking\",\n      getter: \"vanaPoolEntity\",\n    },\n  },\n\n  // ========================================\n  // DLP DEPLOYMENT & TOKEN SYSTEM\n  // ========================================\n  DATFactory: {\n    addresses: {\n      14800: \"0x40f8bccF35a75ecef63BC3B1B3E06ffEB9220644\",\n      1480: \"0x40f8bccF35a75ecef63BC3B1B3E06ffEB9220644\",\n    },\n  },\n  DAT: {\n    addresses: {\n      14800: \"0xA706b93ccED89f13340673889e29F0a5cd84212d\",\n      1480: \"0xA706b93ccED89f13340673889e29F0a5cd84212d\",\n    },\n  },\n  DATPausable: {\n    addresses: {\n      14800: \"0xe69FE86f0B95cC2f8416Fe22815c85DC8887e76e\",\n      1480: \"0xe69FE86f0B95cC2f8416Fe22815c85DC8887e76e\",\n    },\n  },\n  DATVotes: {\n    addresses: {\n      14800: \"0xaE04c8A77E9B27869eb563720524A9aE0baf1831\",\n      1480: \"0xaE04c8A77E9B27869eb563720524A9aE0baf1831\",\n    },\n  },\n\n  // ========================================\n  // EXTERNAL DEPENDENCIES (DeFi)\n  // ========================================\n  WVANA: {\n    addresses: {\n      14800: \"0xbccc4b4c6530F82FE309c5E845E50b5E9C89f2AD\",\n      1480: \"0x00EDdD9621Fb08436d0331c149D1690909a5906d\",\n    },\n  },\n  UniswapV3NonfungiblePositionManager: {\n    addresses: {\n      14800: \"0x48Bd633f4B9128a38Ebb4a48b6975EB3Eaf1931b\",\n      1480: \"0x45a2992e1bFdCF9b9AcE0a84A238f2E56F481816\",\n    },\n  },\n  UniswapV3QuoterV2: {\n    addresses: {\n      14800: \"0x3152246f3CD4dD465292Dd4Ffd792E2Cf602e332\",\n      1480: \"0x1b13728ea3C90863990aC0e05987CfeC1888908c\",\n    },\n  },\n\n  // ========================================\n  // UTILITY CONTRACTS\n  // ========================================\n  Multicall3: {\n    addresses: {\n      14800: \"0xD8d2dFca27E8797fd779F8547166A2d3B29d360E\",\n      1480: \"0xD8d2dFca27E8797fd779F8547166A2d3B29d360E\",\n    },\n  },\n  Multisend: {\n    addresses: {\n      14800: \"0x8807e8BCDFbaA8c2761760f3FBA37F6f7F2C5b2d\",\n      1480: \"0x8807e8BCDFbaA8c2761760f3FBA37F6f7F2C5b2d\",\n    },\n  },\n} as const;\n\n// Legacy DLPRoot* and deprecated TeePool entries were removed in the protocol\n// unification cleanup. They were part of the old DLP rewards system superseded\n// by other contracts.\n"],"mappings":"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","names":[]}

package/dist/contracts/contractController.cjs

@@ -92,7 +92,16 @@ class ContractFactory {
   getAvailableContracts() {
     const chainAddresses = import_addresses.CONTRACT_ADDRESSES[this.chainId];
     if (!chainAddresses) return [];
-    return Object.keys(chainAddresses);
+    return Object.keys(chainAddresses).filter(
+      (contract) => {
+        try {
+          (0, import_abi.getAbi)(contract);
+          return true;
+        } catch {
+          return false;
+        }
+      }
+    );
   }
 }
 function clearContractCache(contract, chainId) {

package/dist/contracts/contractController.cjs.map

@@ -1 +1 @@
-{"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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,kBAKO;AACP,iBAA6D;AAE7D,uBAAuD;AACvD,oBAA6B;AAC7B,oBAA4B;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,aAGsC,4BAAa,GACX;AACxC,QAAM,UAAU,OAAO,OAAO,MAAM,0BAAY;AAChD,QAAM,WAAW,eAAe,UAAU,OAAO;AAEjD,MAAI,aAAa,cAAc,IAAI,QAAQ;AAE3C,MAAI,CAAC,YAAY;AACf,qBAAa,yBAAY;AAAA,MACvB,aAAS,qCAAmB,SAAS,QAAQ;AAAA,MAC7C,SAAK,mBAAO,QAAQ;AAAA,MACpB;AAAA,IACF,CAAC;AAED,kBAAc,IAAI,UAAU,UAAU;AAAA,EACxC;AAEA,SAAO;AACT;AA+BO,SAAS,gBACd,UACA,UAAuB,0BAAY,IACJ;AAC/B,SAAO;AAAA,IACL,aAAS,qCAAmB,SAAS,QAAQ;AAAA,IAC7C,SAAK,mBAAO,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,0BAAY;AAAA,IACjD,QAAQ;AACN,WAAK,UAAU,0BAAY;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,oCAAmB,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 {\n  getContractAddress,\n  CONTRACT_ADDRESSES,\n  type VanaContractAddress,\n} from \"../generated/addresses\";\nimport { createClient } from \"../core/client\";\nimport { vanaMainnet } from \"../config/chains\";\n\ntype AddressedVanaContract = Extract<VanaContract, VanaContractAddress>;\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(\n  contract: AddressedVanaContract,\n  chainId: number,\n): 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 AddressedVanaContract>(\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 AddressedVanaContract>(\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 AddressedVanaContract>(\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 AddressedVanaContract>(\n    contract: T,\n  ): 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(): AddressedVanaContract[] {\n    // Return contract names that have both an address and an ABI on this chain.\n    const chainAddresses = CONTRACT_ADDRESSES[this.chainId];\n    if (!chainAddresses) return [];\n\n    return Object.keys(chainAddresses).filter(\n      (contract): contract is AddressedVanaContract => {\n        try {\n          getAbi(contract as VanaContract);\n          return true;\n        } catch {\n          return false;\n        }\n      },\n    );\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?: AddressedVanaContract,\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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,kBAKO;AACP,iBAA6D;AAE7D,uBAIO;AACP,oBAA6B;AAC7B,oBAA4B;AAK5B,MAAM,gBAAgB,oBAAI,IAAwC;AAG3D,MAAM,0BAA0B;AAevC,SAAS,eACP,UACA,SACQ;AACR,SAAO,GAAG,QAAQ,IAAI,OAAO;AAC/B;AAgCO,SAAS,sBACd,UACA,aAGsC,4BAAa,GACX;AACxC,QAAM,UAAU,OAAO,OAAO,MAAM,0BAAY;AAChD,QAAM,WAAW,eAAe,UAAU,OAAO;AAEjD,MAAI,aAAa,cAAc,IAAI,QAAQ;AAE3C,MAAI,CAAC,YAAY;AACf,qBAAa,yBAAY;AAAA,MACvB,aAAS,qCAAmB,SAAS,QAAQ;AAAA,MAC7C,SAAK,mBAAO,QAAQ;AAAA,MACpB;AAAA,IACF,CAAC;AAED,kBAAc,IAAI,UAAU,UAAU;AAAA,EACxC;AAEA,SAAO;AACT;AA+BO,SAAS,gBACd,UACA,UAAuB,0BAAY,IACJ;AAC/B,SAAO;AAAA,IACL,aAAS,qCAAmB,SAAS,QAAQ;AAAA,IAC7C,SAAK,mBAAO,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,0BAAY;AAAA,IACjD,QAAQ;AACN,WAAK,UAAU,0BAAY;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,QACE,UAC+B;AAC/B,WAAO,gBAAgB,UAAU,KAAK,OAAsB;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,wBAAiD;AAE/C,UAAM,iBAAiB,oCAAmB,KAAK,OAAO;AACtD,QAAI,CAAC,eAAgB,QAAO,CAAC;AAE7B,WAAO,OAAO,KAAK,cAAc,EAAE;AAAA,MACjC,CAAC,aAAgD;AAC/C,YAAI;AACF,iCAAO,QAAwB;AAC/B,iBAAO;AAAA,QACT,QAAQ;AACN,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAAA,EACF;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/contracts/contractController.d.ts

@@ -13,7 +13,9 @@ import type { Abi } from "abitype";
 import { type GetContractReturnType, type PublicClient, type WalletClient } from "viem";
 import { type ContractAbis, type VanaContract } from "../generated/abi";
 import type { VanaChainId, ContractInfo } from "../types/index";
+import { type VanaContractAddress } from "../generated/addresses";
 import { createClient } from "../core/client";
+type AddressedVanaContract = Extract<VanaContract, VanaContractAddress>;
 export declare const contractCacheForTesting: Map<string, {
     address: `0x${string}`;
     abi: Abi;
@@ -48,7 +50,7 @@ export declare const contractCacheForTesting: Map<string, {
  *
  * @category Contracts
  */
-export declare function getContractController<T extends VanaContract>(contract: T, client?: PublicClient | WalletClient | ReturnType<typeof createClient>): GetContractReturnType<ContractAbis[T]>;
+export declare function getContractController<T extends AddressedVanaContract>(contract: T, client?: PublicClient | WalletClient | ReturnType<typeof createClient>): GetContractReturnType<ContractAbis[T]>;
 /**
  * Gets contract information without creating a contract instance.
  *
@@ -78,7 +80,7 @@ export declare function getContractController<T extends VanaContract>(contract:
  *
  * @category Contracts
  */
-export declare function getContractInfo<T extends VanaContract>(contract: T, chainId?: VanaChainId): ContractInfo<ContractAbis[T]>;
+export declare function getContractInfo<T extends AddressedVanaContract>(contract: T, chainId?: VanaChainId): ContractInfo<ContractAbis[T]>;
 /**
  * Provides type-safe contract factory for creating multiple contract instances.
  *
@@ -110,20 +112,20 @@ export declare class ContractFactory {
      * @param contract - Contract name (use const assertion for full typing)
      * @returns Fully typed contract instance
      */
-    create<T extends VanaContract>(contract: T): GetContractReturnType<ContractAbis[T]>;
+    create<T extends AddressedVanaContract>(contract: T): GetContractReturnType<ContractAbis[T]>;
     /**
      * Gets contract information without creating an instance
      *
      * @param contract - Contract name
      * @returns Contract information with typed ABI
      */
-    getInfo<T extends VanaContract>(contract: T): ContractInfo<ContractAbis[T]>;
+    getInfo<T extends AddressedVanaContract>(contract: T): ContractInfo<ContractAbis[T]>;
     /**
      * Lists all available contracts for the current chain
      *
      * @returns Array of contract names available on this chain
      */
-    getAvailableContracts(): VanaContract[];
+    getAvailableContracts(): AddressedVanaContract[];
 }
 /**
  * Clears the contract cache. Useful for testing or when chain configurations change.
@@ -131,5 +133,5 @@ export declare class ContractFactory {
  * @param contract - Optional specific contract to clear, or clear all if not provided
  * @param chainId - Optional specific chain to clear, or clear all if not provided
  */
-export declare function clearContractCache(contract?: VanaContract, chainId?: number): void;
+export declare function clearContractCache(contract?: AddressedVanaContract, chainId?: number): void;
 export type { GetContractReturnType } from "viem";

package/dist/contracts/contractController.js

@@ -2,7 +2,10 @@ import {
   getContract
 } from "viem";
 import { getAbi } from "../generated/abi/index.js";
-import { getContractAddress, CONTRACT_ADDRESSES } from "../generated/addresses.js";
+import {
+  getContractAddress,
+  CONTRACT_ADDRESSES
+} from "../generated/addresses.js";
 import { createClient } from "../core/client.js";
 import { vanaMainnet } from "../config/chains.js";
 const contractCache = /* @__PURE__ */ new Map();
@@ -67,7 +70,16 @@ class ContractFactory {
   getAvailableContracts() {
     const chainAddresses = CONTRACT_ADDRESSES[this.chainId];
     if (!chainAddresses) return [];
-    return Object.keys(chainAddresses);
+    return Object.keys(chainAddresses).filter(
+      (contract) => {
+        try {
+          getAbi(contract);
+          return true;
+        } catch {
+          return false;
+        }
+      }
+    );
   }
 }
 function clearContractCache(contract, chainId) {

package/dist/contracts/contractController.js.map

@@ -1 +1 @@
-{"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":[]}
+{"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 {\n  getContractAddress,\n  CONTRACT_ADDRESSES,\n  type VanaContractAddress,\n} from \"../generated/addresses\";\nimport { createClient } from \"../core/client\";\nimport { vanaMainnet } from \"../config/chains\";\n\ntype AddressedVanaContract = Extract<VanaContract, VanaContractAddress>;\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(\n  contract: AddressedVanaContract,\n  chainId: number,\n): 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 AddressedVanaContract>(\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 AddressedVanaContract>(\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 AddressedVanaContract>(\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 AddressedVanaContract>(\n    contract: T,\n  ): 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(): AddressedVanaContract[] {\n    // Return contract names that have both an address and an ABI on this chain.\n    const chainAddresses = CONTRACT_ADDRESSES[this.chainId];\n    if (!chainAddresses) return [];\n\n    return Object.keys(chainAddresses).filter(\n      (contract): contract is AddressedVanaContract => {\n        try {\n          getAbi(contract as VanaContract);\n          return true;\n        } catch {\n          return false;\n        }\n      },\n    );\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?: AddressedVanaContract,\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;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,oBAAoB;AAC7B,SAAS,mBAAmB;AAK5B,MAAM,gBAAgB,oBAAI,IAAwC;AAG3D,MAAM,0BAA0B;AAevC,SAAS,eACP,UACA,SACQ;AACR,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,QACE,UAC+B;AAC/B,WAAO,gBAAgB,UAAU,KAAK,OAAsB;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,wBAAiD;AAE/C,UAAM,iBAAiB,mBAAmB,KAAK,OAAO;AACtD,QAAI,CAAC,eAAgB,QAAO,CAAC;AAE7B,WAAO,OAAO,KAAK,cAAc,EAAE;AAAA,MACjC,CAAC,aAAgD;AAC/C,YAAI;AACF,iBAAO,QAAwB;AAC/B,iBAAO;AAAA,QACT,QAAQ;AACN,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAAA,EACF;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/direct/controller.cjs

@@ -23,6 +23,8 @@ __export(controller_exports, {
 module.exports = __toCommonJS(controller_exports);
 var import_accounts = require("viem/accounts");
 var import_scopes = require("../protocol/scopes");
+var import_escrow = require("../protocol/escrow");
+var import_addresses = require("../generated/addresses");
 var import_access_request_client = require("./access-request-client");
 var import_endpoints = require("./endpoints");
 var import_errors = require("./errors");
@@ -62,13 +64,20 @@ function createDirectDataController(config) {
     appAddress: account.address,
     signMessage
   });
-  const escrow = config.escrow ? {
-    client: config.escrow.client,
-    escrowContract: config.escrow.escrowContract,
-    chainId: config.escrow.chainId ?? chainId,
-    nonceSource: config.escrow.nonceSource,
+  const escrowChainId = config.escrow?.chainId ?? chainId;
+  const defaultEscrowContract = import_addresses.CONTRACTS.DataPortabilityEscrow.addresses[escrowChainId] ?? void 0;
+  if (!config.escrow?.escrowContract && !defaultEscrowContract) {
+    throw new import_errors.DirectConfigError(
+      `No DataPortabilityEscrow address found in the registry for chainId ${escrowChainId}. Provide an explicit escrow.escrowContract in the controller config.`
+    );
+  }
+  const escrow = {
+    client: config.escrow?.client ?? (0, import_escrow.createEscrowGatewayClient)(endpoints.escrowGatewayUrl),
+    escrowContract: config.escrow?.escrowContract ?? defaultEscrowContract,
+    chainId: escrowChainId,
+    nonceSource: config.escrow?.nonceSource,
     signTypedData
-  } : void 0;
+  };
   return {
     appAddress: account.address,
     getAppAddress() {

package/dist/direct/controller.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/direct/controller.ts"],"sourcesContent":["/**\n * Direct Data Controller — the server-side facade for the two-tab Data\n * Portability flow.\n *\n * @remarks\n * One controller owns an app's private key, source, scopes, app identity, and\n * payment flow. It exposes the three methods the builder guide documents:\n *\n * - {@link DirectDataController.createAccessRequest} — start an approval request.\n * - {@link DirectDataController.getAccessRequestStatus} — poll while the Vana tab is open.\n * - {@link DirectDataController.readApprovedData} — read from the Personal Server,\n *   handling 402 Payment Required.\n *\n * Access requests are created through the Vana Account access-request API; the\n * Personal Server read uses Web3Signed auth; and payment uses the DPv2 escrow\n * surface (`protocol/escrow`) — when a read returns `402`, the controller signs\n * a `GenericPayment` with the app key, settles it through the escrow gateway,\n * and retries.\n *\n * @category Direct\n * @module direct/controller\n */\n\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport type { Hex } from \"viem\";\nimport type { Web3SignedSignFn } from \"../auth/web3-signed-builder\";\nimport { parseScope } from \"../protocol/scopes\";\nimport {\n  createDefaultAccessRequestClient,\n  type FetchLike,\n} from \"./access-request-client\";\nimport {\n  getDirectDefaultNetwork,\n  getDirectEndpoints,\n  getDirectNetworkChainId,\n} from \"./endpoints\";\nimport { AccessNotApprovedError, DirectConfigError } from \"./errors\";\nimport {\n  type EscrowPaymentConfig,\n  type SignTypedDataFn,\n} from \"./escrow-payment\";\nimport {\n  readPersonalServerData,\n  type PersonalServerFetch,\n} from \"./personal-server-read\";\nimport type {\n  AccessRequest,\n  AccessRequestClient,\n  AccessRequestStatus,\n  ApprovedDataResult,\n  AppIdentity,\n  DirectAppConfig,\n  DirectEnv,\n  DirectNetwork,\n  DirectServiceEndpoints,\n} from \"./types\";\n\n/** Configuration for {@link createDirectDataController}. */\nexport interface DirectDataControllerConfig {\n  /** Target environment. Defaults to `\"production\"`. */\n  env?: DirectEnv;\n  /**\n   * Target Vana network for chain-aware defaults. Defaults to the selected\n   * environment's historical network (`mainnet` for production, `moksha` for\n   * dev). Use `network: \"moksha\"` with the default production env for\n   * production app/API URLs on testnet.\n   */\n  network?: DirectNetwork;\n  /**\n   * The app private key (`0x`-prefixed, 32 bytes). Server-side only — this key\n   * is the app's on-chain identity and is never exposed to the browser.\n   */\n  appPrivateKey?: string;\n  /**\n   * @deprecated Use {@link DirectDataControllerConfig.appPrivateKey}. Accepted as\n   * a backwards-compatible alias; if both are set, `appPrivateKey` wins.\n   */\n  builderPrivateKey?: string;\n  /** App identity advertised during approval. */\n  app: DirectAppConfig;\n  /** Data source key (e.g. `\"icloud_notes\"`). */\n  source: string;\n  /** Scopes to request (e.g. `[\"icloud_notes.notes\"]`). At least one required. */\n  scopes: string[];\n  /**\n   * Override the resolved service endpoints (partial). Useful for pointing at a\n   * non-standard deployment.\n   */\n  endpoints?: Partial<DirectServiceEndpoints>;\n  /**\n   * Client for the Vana Account access-request API. Defaults to a client against\n   * the resolved Vana Account endpoints; inject your own to point at a custom\n   * deployment or to supply a test double.\n   */\n  accessRequestClient?: AccessRequestClient;\n  /**\n   * Escrow settlement config used when a Personal Server read returns `402`.\n   *\n   * @remarks\n   * Wires the DPv2 escrow gateway (`protocol/escrow`). The controller supplies\n   * the EIP-712 `signTypedData` from the app key automatically, so you provide\n   * the gateway `client`, the `escrowContract` address, and (optionally) the\n   * `chainId` and a durable `nonceSource`. If omitted, a `402` from the Personal\n   * Server throws {@link PaymentRequiredError} carrying the amount/asset owed.\n   */\n  escrow?: DirectEscrowConfig;\n  /** `fetch` used by the default access-request client. Defaults to `globalThis.fetch`. */\n  fetchFn?: FetchLike;\n  /** `fetch` used for the Personal Server read. Defaults to `globalThis.fetch`. */\n  personalServerFetch?: PersonalServerFetch;\n}\n\n/**\n * Controller-level escrow config — the {@link EscrowPaymentConfig} minus the\n * `signTypedData` and `chainId` the controller injects itself.\n */\nexport interface DirectEscrowConfig extends Omit<\n  EscrowPaymentConfig,\n  \"signTypedData\" | \"chainId\"\n> {\n  /**\n   * Chain id for the EIP-712 domain. Defaults to the controller's environment\n   * (1480 for mainnet, 14800 for moksha).\n   */\n  chainId?: number;\n}\n\n/**\n * Server-side controller for the direct Data Portability flow.\n *\n * @typeParam T - Shape of the data returned by {@link DirectDataController.readApprovedData}.\n */\nexport interface DirectDataController {\n  /** The on-chain address of the app, derived from `appPrivateKey`. */\n  readonly appAddress: string;\n\n  /**\n   * The app's on-chain address — the address to fund and inspect in the Builder\n   * activity report. Equivalent to {@link DirectDataController.appAddress}.\n   *\n   * @returns The app's `0x`-prefixed address.\n   */\n  getAppAddress(): string;\n\n  /**\n   * The app's full identity: its configured id/name/homepage plus the derived\n   * on-chain address. Useful for telling builders which app address to fund or\n   * look up.\n   *\n   * @returns `{ id, name, homepageUrl, address }`.\n   */\n  getAppIdentity(): AppIdentity;\n\n  /**\n   * Create an access request the user can approve.\n   *\n   * @param input - The post-approval return URL.\n   * @returns `{ requestId, approvalUrl, appAddress }`.\n   */\n  createAccessRequest(input: { returnUrl: string }): Promise<AccessRequest>;\n\n  /**\n   * Fetch the current status of an access request.\n   *\n   * @param requestId - The `dcr_*` id from {@link DirectDataController.createAccessRequest}.\n   * @returns `{ status, personalServerUrl?, grantId?, scope? }`.\n   */\n  getAccessRequestStatus(requestId: string): Promise<AccessRequestStatus>;\n\n  /**\n   * Read the approved data from the user's Personal Server.\n   *\n   * @remarks\n   * Resolves the request to its grant + Personal Server and performs a Web3Signed\n   * read. Hides the `402 Payment Required` flow by default: if a read needs\n   * payment and `escrow` is configured, it settles the grant via the escrow\n   * gateway and retries, attaching a {@link DirectPaymentReceipt} under\n   * `payment` so callers can inspect amount/asset/fee breakdown. If `escrow` is\n   * not configured, it throws {@link PaymentRequiredError} carrying the\n   * amount/asset owed.\n   *\n   * @param input - The `dcr_*` request id to read.\n   * @returns `{ scope, data, payment? }`.\n   * @throws {@link AccessNotApprovedError} if the request is not approved.\n   * @throws {@link PaymentRequiredError} if payment is required but unsettled.\n   */\n  readApprovedData<T = unknown>(input: {\n    requestId: string;\n  }): Promise<ApprovedDataResult<T>>;\n}\n\nfunction isHexPrivateKey(value: string): value is Hex {\n  return /^0x[0-9a-fA-F]{64}$/.test(value);\n}\n\n/**\n * Create a {@link DirectDataController}.\n *\n * @param config - Controller configuration (env, key, app identity, source, scopes).\n * @returns A ready-to-use controller.\n * @throws {@link DirectConfigError} when the key or scopes are invalid.\n */\nexport function createDirectDataController(\n  config: DirectDataControllerConfig,\n): DirectDataController {\n  // `appPrivateKey` is the documented field; `builderPrivateKey` is a\n  // deprecated alias kept for backwards compatibility.\n  const privateKey = config.appPrivateKey ?? config.builderPrivateKey;\n  if (!privateKey || !isHexPrivateKey(privateKey)) {\n    throw new DirectConfigError(\n      \"appPrivateKey must be a 0x-prefixed 32-byte hex string\",\n    );\n  }\n  if (!config.scopes || config.scopes.length === 0) {\n    throw new DirectConfigError(\"At least one scope is required\");\n  }\n  // Validate scopes eagerly so misconfiguration fails at construction.\n  for (const scope of config.scopes) {\n    parseScope(scope);\n  }\n\n  const env: DirectEnv = config.env ?? \"production\";\n  const network: DirectNetwork = config.network ?? getDirectDefaultNetwork(env);\n  const defaultEndpoints = getDirectEndpoints(env);\n  const chainId = config.endpoints?.chainId ?? getDirectNetworkChainId(network);\n  const endpoints: DirectServiceEndpoints = {\n    ...defaultEndpoints,\n    ...config.endpoints,\n    chainId,\n  };\n\n  const account = privateKeyToAccount(privateKey as Hex);\n  const signMessage: Web3SignedSignFn = (message: string) =>\n    account.signMessage({ message });\n  // viem's account.signTypedData satisfies the structural SignTypedDataFn used\n  // by the escrow GenericPayment signer.\n  const signTypedData = account.signTypedData as unknown as SignTypedDataFn;\n  const accessRequestClient: AccessRequestClient =\n    config.accessRequestClient ??\n    createDefaultAccessRequestClient({\n      baseUrl: endpoints.accessRequestBaseUrl,\n      approvalBaseUrl: endpoints.approvalAppBaseUrl,\n      fetchFn: config.fetchFn,\n      appAddress: account.address,\n      signMessage,\n    });\n\n  const escrow: EscrowPaymentConfig | undefined = config.escrow\n    ? {\n        client: config.escrow.client,\n        escrowContract: config.escrow.escrowContract,\n        chainId: config.escrow.chainId ?? chainId,\n        nonceSource: config.escrow.nonceSource,\n        signTypedData,\n      }\n    : undefined;\n\n  return {\n    appAddress: account.address,\n\n    getAppAddress(): string {\n      return account.address;\n    },\n\n    getAppIdentity(): AppIdentity {\n      return {\n        id: config.app.id,\n        name: config.app.name,\n        homepageUrl: config.app.homepageUrl,\n        address: account.address,\n      };\n    },\n\n    async createAccessRequest(input): Promise<AccessRequest> {\n      return accessRequestClient.createAccessRequest({\n        appAddress: account.address,\n        app: config.app,\n        source: config.source,\n        scopes: config.scopes,\n        returnUrl: input.returnUrl,\n      });\n    },\n\n    async getAccessRequestStatus(\n      requestId: string,\n    ): Promise<AccessRequestStatus> {\n      return accessRequestClient.getAccessRequestStatus(requestId);\n    },\n\n    async readApprovedData<T = unknown>(input: {\n      requestId: string;\n    }): Promise<ApprovedDataResult<T>> {\n      const status = await accessRequestClient.getAccessRequestStatus(\n        input.requestId,\n      );\n      if (\n        status.status !== \"approved\" ||\n        !status.personalServerUrl ||\n        !status.grantId ||\n        !status.scope\n      ) {\n        throw new AccessNotApprovedError(\n          \"Request is not approved or is missing grantId/scope/personalServerUrl\",\n          {\n            requestId: input.requestId,\n            status: status.status,\n            hasPersonalServerUrl: Boolean(status.personalServerUrl),\n            hasGrantId: Boolean(status.grantId),\n            hasScope: Boolean(status.scope),\n          },\n        );\n      }\n\n      const result = await readPersonalServerData({\n        personalServerUrl: status.personalServerUrl,\n        scope: status.scope,\n        grantId: status.grantId,\n        payerAddress: account.address,\n        signMessage,\n        escrow,\n        fetchFn: config.personalServerFetch,\n      });\n\n      return {\n        scope: status.scope,\n        data: result.data as T,\n        payment: result.payment,\n      };\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/direct/controller.ts"],"sourcesContent":["/**\n * Direct Data Controller — the server-side facade for the two-tab Data\n * Portability flow.\n *\n * @remarks\n * One controller owns an app's private key, source, scopes, app identity, and\n * payment flow. It exposes the three methods the builder guide documents:\n *\n * - {@link DirectDataController.createAccessRequest} — start an approval request.\n * - {@link DirectDataController.getAccessRequestStatus} — poll while the Vana tab is open.\n * - {@link DirectDataController.readApprovedData} — read from the Personal Server,\n *   handling 402 Payment Required.\n *\n * Access requests are created through the Vana Account access-request API; the\n * Personal Server read uses Web3Signed auth; and payment uses the DPv2 escrow\n * surface (`protocol/escrow`) — when a read returns `402`, the controller signs\n * a `GenericPayment` with the app key, settles it through the escrow gateway,\n * and retries.\n *\n * @category Direct\n * @module direct/controller\n */\n\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport type { Hex } from \"viem\";\nimport type { Web3SignedSignFn } from \"../auth/web3-signed-builder\";\nimport { parseScope } from \"../protocol/scopes\";\nimport { createEscrowGatewayClient } from \"../protocol/escrow\";\nimport { CONTRACTS } from \"../generated/addresses\";\nimport {\n  createDefaultAccessRequestClient,\n  type FetchLike,\n} from \"./access-request-client\";\nimport {\n  getDirectDefaultNetwork,\n  getDirectEndpoints,\n  getDirectNetworkChainId,\n} from \"./endpoints\";\nimport { AccessNotApprovedError, DirectConfigError } from \"./errors\";\nimport {\n  type EscrowPaymentConfig,\n  type SignTypedDataFn,\n} from \"./escrow-payment\";\nimport {\n  readPersonalServerData,\n  type PersonalServerFetch,\n} from \"./personal-server-read\";\nimport type {\n  AccessRequest,\n  AccessRequestClient,\n  AccessRequestStatus,\n  ApprovedDataResult,\n  AppIdentity,\n  DirectAppConfig,\n  DirectEnv,\n  DirectNetwork,\n  DirectServiceEndpoints,\n} from \"./types\";\n\n/** Configuration for {@link createDirectDataController}. */\nexport interface DirectDataControllerConfig {\n  /** Target environment. Defaults to `\"production\"`. */\n  env?: DirectEnv;\n  /**\n   * Target Vana network for chain-aware defaults. Defaults to the selected\n   * environment's historical network (`mainnet` for production, `moksha` for\n   * dev). Use `network: \"moksha\"` with the default production env for\n   * production app/API URLs on testnet.\n   */\n  network?: DirectNetwork;\n  /**\n   * The app private key (`0x`-prefixed, 32 bytes). Server-side only — this key\n   * is the app's on-chain identity and is never exposed to the browser.\n   */\n  appPrivateKey?: string;\n  /**\n   * @deprecated Use {@link DirectDataControllerConfig.appPrivateKey}. Accepted as\n   * a backwards-compatible alias; if both are set, `appPrivateKey` wins.\n   */\n  builderPrivateKey?: string;\n  /** App identity advertised during approval. */\n  app: DirectAppConfig;\n  /** Data source key (e.g. `\"icloud_notes\"`). */\n  source: string;\n  /** Scopes to request (e.g. `[\"icloud_notes.notes\"]`). At least one required. */\n  scopes: string[];\n  /**\n   * Override the resolved service endpoints (partial). Useful for pointing at a\n   * non-standard deployment.\n   */\n  endpoints?: Partial<DirectServiceEndpoints>;\n  /**\n   * Client for the Vana Account access-request API. Defaults to a client against\n   * the resolved Vana Account endpoints; inject your own to point at a custom\n   * deployment or to supply a test double.\n   */\n  accessRequestClient?: AccessRequestClient;\n  /**\n   * Escrow settlement config used when a Personal Server read returns `402`.\n   *\n   * @remarks\n   * Wires the DPv2 escrow gateway (`protocol/escrow`). The controller supplies\n   * the EIP-712 `signTypedData` from the app key automatically.\n   *\n   * When omitted (or partially omitted), the SDK derives defaults from the\n   * per-network endpoints table and the contract registry:\n   * - `client` defaults to a gateway client at `endpoints.escrowGatewayUrl`\n   * - `escrowContract` defaults to `CONTRACTS.DataPortabilityEscrow.addresses[chainId]`\n   * - `chainId` defaults to the controller's resolved chain id\n   *\n   * Provide this field only to override a specific default.\n   */\n  escrow?: Partial<DirectEscrowConfig>;\n  /** `fetch` used by the default access-request client. Defaults to `globalThis.fetch`. */\n  fetchFn?: FetchLike;\n  /** `fetch` used for the Personal Server read. Defaults to `globalThis.fetch`. */\n  personalServerFetch?: PersonalServerFetch;\n}\n\n/**\n * Controller-level escrow config — the {@link EscrowPaymentConfig} minus the\n * `signTypedData` and `chainId` the controller injects itself.\n */\nexport interface DirectEscrowConfig extends Omit<\n  EscrowPaymentConfig,\n  \"signTypedData\" | \"chainId\"\n> {\n  /**\n   * Chain id for the EIP-712 domain. Defaults to the controller's environment\n   * (1480 for mainnet, 14800 for moksha).\n   */\n  chainId?: number;\n}\n\n/**\n * Server-side controller for the direct Data Portability flow.\n *\n * @typeParam T - Shape of the data returned by {@link DirectDataController.readApprovedData}.\n */\nexport interface DirectDataController {\n  /** The on-chain address of the app, derived from `appPrivateKey`. */\n  readonly appAddress: string;\n\n  /**\n   * The app's on-chain address — the address to fund and inspect in the Builder\n   * activity report. Equivalent to {@link DirectDataController.appAddress}.\n   *\n   * @returns The app's `0x`-prefixed address.\n   */\n  getAppAddress(): string;\n\n  /**\n   * The app's full identity: its configured id/name/homepage plus the derived\n   * on-chain address. Useful for telling builders which app address to fund or\n   * look up.\n   *\n   * @returns `{ id, name, homepageUrl, address }`.\n   */\n  getAppIdentity(): AppIdentity;\n\n  /**\n   * Create an access request the user can approve.\n   *\n   * @param input - The post-approval return URL.\n   * @returns `{ requestId, approvalUrl, appAddress }`.\n   */\n  createAccessRequest(input: { returnUrl: string }): Promise<AccessRequest>;\n\n  /**\n   * Fetch the current status of an access request.\n   *\n   * @param requestId - The `dcr_*` id from {@link DirectDataController.createAccessRequest}.\n   * @returns `{ status, personalServerUrl?, grantId?, scope? }`.\n   */\n  getAccessRequestStatus(requestId: string): Promise<AccessRequestStatus>;\n\n  /**\n   * Read the approved data from the user's Personal Server.\n   *\n   * @remarks\n   * Resolves the request to its grant + Personal Server and performs a Web3Signed\n   * read. Hides the `402 Payment Required` flow by default: if a read needs\n   * payment, it signs the Personal Server's payment challenge, retries with\n   * `X-PAYMENT`, and attaches a {@link DirectPaymentReceipt} under `payment`\n   * when the Personal Server returns one.\n   *\n   * @param input - The `dcr_*` request id to read.\n   * @returns `{ scope, data, payment? }`.\n   * @throws {@link AccessNotApprovedError} if the request is not approved.\n   * @throws {@link PaymentRequiredError} if payment is required but unsettled.\n   */\n  readApprovedData<T = unknown>(input: {\n    requestId: string;\n  }): Promise<ApprovedDataResult<T>>;\n}\n\nfunction isHexPrivateKey(value: string): value is Hex {\n  return /^0x[0-9a-fA-F]{64}$/.test(value);\n}\n\n/**\n * Create a {@link DirectDataController}.\n *\n * @param config - Controller configuration (env, key, app identity, source, scopes).\n * @returns A ready-to-use controller.\n * @throws {@link DirectConfigError} when the key or scopes are invalid.\n */\nexport function createDirectDataController(\n  config: DirectDataControllerConfig,\n): DirectDataController {\n  // `appPrivateKey` is the documented field; `builderPrivateKey` is a\n  // deprecated alias kept for backwards compatibility.\n  const privateKey = config.appPrivateKey ?? config.builderPrivateKey;\n  if (!privateKey || !isHexPrivateKey(privateKey)) {\n    throw new DirectConfigError(\n      \"appPrivateKey must be a 0x-prefixed 32-byte hex string\",\n    );\n  }\n  if (!config.scopes || config.scopes.length === 0) {\n    throw new DirectConfigError(\"At least one scope is required\");\n  }\n  // Validate scopes eagerly so misconfiguration fails at construction.\n  for (const scope of config.scopes) {\n    parseScope(scope);\n  }\n\n  const env: DirectEnv = config.env ?? \"production\";\n  const network: DirectNetwork = config.network ?? getDirectDefaultNetwork(env);\n  const defaultEndpoints = getDirectEndpoints(env);\n  const chainId = config.endpoints?.chainId ?? getDirectNetworkChainId(network);\n  const endpoints: DirectServiceEndpoints = {\n    ...defaultEndpoints,\n    ...config.endpoints,\n    chainId,\n  };\n\n  const account = privateKeyToAccount(privateKey as Hex);\n  const signMessage: Web3SignedSignFn = (message: string) =>\n    account.signMessage({ message });\n  // viem's account.signTypedData satisfies the structural SignTypedDataFn used\n  // by the escrow GenericPayment signer.\n  const signTypedData = account.signTypedData as unknown as SignTypedDataFn;\n  const accessRequestClient: AccessRequestClient =\n    config.accessRequestClient ??\n    createDefaultAccessRequestClient({\n      baseUrl: endpoints.accessRequestBaseUrl,\n      approvalBaseUrl: endpoints.approvalAppBaseUrl,\n      fetchFn: config.fetchFn,\n      appAddress: account.address,\n      signMessage,\n    });\n\n  // Build the escrow payment config, defaulting from the per-network endpoints\n  // table and the contract registry when `config.escrow` is omitted or partial.\n  const escrowChainId = config.escrow?.chainId ?? chainId;\n  const defaultEscrowContract =\n    CONTRACTS.DataPortabilityEscrow.addresses[\n      escrowChainId as keyof typeof CONTRACTS.DataPortabilityEscrow.addresses\n    ] ?? undefined;\n  if (!config.escrow?.escrowContract && !defaultEscrowContract) {\n    throw new DirectConfigError(\n      `No DataPortabilityEscrow address found in the registry for chainId ${escrowChainId}. ` +\n        `Provide an explicit escrow.escrowContract in the controller config.`,\n    );\n  }\n  const escrow: EscrowPaymentConfig = {\n    client:\n      config.escrow?.client ??\n      createEscrowGatewayClient(endpoints.escrowGatewayUrl),\n    escrowContract:\n      config.escrow?.escrowContract ?? (defaultEscrowContract as `0x${string}`),\n    chainId: escrowChainId,\n    nonceSource: config.escrow?.nonceSource,\n    signTypedData,\n  };\n\n  return {\n    appAddress: account.address,\n\n    getAppAddress(): string {\n      return account.address;\n    },\n\n    getAppIdentity(): AppIdentity {\n      return {\n        id: config.app.id,\n        name: config.app.name,\n        homepageUrl: config.app.homepageUrl,\n        address: account.address,\n      };\n    },\n\n    async createAccessRequest(input): Promise<AccessRequest> {\n      return accessRequestClient.createAccessRequest({\n        appAddress: account.address,\n        app: config.app,\n        source: config.source,\n        scopes: config.scopes,\n        returnUrl: input.returnUrl,\n      });\n    },\n\n    async getAccessRequestStatus(\n      requestId: string,\n    ): Promise<AccessRequestStatus> {\n      return accessRequestClient.getAccessRequestStatus(requestId);\n    },\n\n    async readApprovedData<T = unknown>(input: {\n      requestId: string;\n    }): Promise<ApprovedDataResult<T>> {\n      const status = await accessRequestClient.getAccessRequestStatus(\n        input.requestId,\n      );\n      if (\n        status.status !== \"approved\" ||\n        !status.personalServerUrl ||\n        !status.grantId ||\n        !status.scope\n      ) {\n        throw new AccessNotApprovedError(\n          \"Request is not approved or is missing grantId/scope/personalServerUrl\",\n          {\n            requestId: input.requestId,\n            status: status.status,\n            hasPersonalServerUrl: Boolean(status.personalServerUrl),\n            hasGrantId: Boolean(status.grantId),\n            hasScope: Boolean(status.scope),\n          },\n        );\n      }\n\n      const result = await readPersonalServerData({\n        personalServerUrl: status.personalServerUrl,\n        scope: status.scope,\n        grantId: status.grantId,\n        payerAddress: account.address,\n        signMessage,\n        escrow,\n        fetchFn: config.personalServerFetch,\n      });\n\n      return {\n        scope: status.scope,\n        data: result.data as T,\n        payment: result.payment,\n      };\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/direct/controller.d.ts

@@ -67,12 +67,17 @@ export interface DirectDataControllerConfig {
      *
      * @remarks
      * Wires the DPv2 escrow gateway (`protocol/escrow`). The controller supplies
-     * the EIP-712 `signTypedData` from the app key automatically, so you provide
-     * the gateway `client`, the `escrowContract` address, and (optionally) the
-     * `chainId` and a durable `nonceSource`. If omitted, a `402` from the Personal
-     * Server throws {@link PaymentRequiredError} carrying the amount/asset owed.
+     * the EIP-712 `signTypedData` from the app key automatically.
+     *
+     * When omitted (or partially omitted), the SDK derives defaults from the
+     * per-network endpoints table and the contract registry:
+     * - `client` defaults to a gateway client at `endpoints.escrowGatewayUrl`
+     * - `escrowContract` defaults to `CONTRACTS.DataPortabilityEscrow.addresses[chainId]`
+     * - `chainId` defaults to the controller's resolved chain id
+     *
+     * Provide this field only to override a specific default.
      */
-    escrow?: DirectEscrowConfig;
+    escrow?: Partial<DirectEscrowConfig>;
     /** `fetch` used by the default access-request client. Defaults to `globalThis.fetch`. */
     fetchFn?: FetchLike;
     /** `fetch` used for the Personal Server read. Defaults to `globalThis.fetch`. */
@@ -134,11 +139,9 @@ export interface DirectDataController {
      * @remarks
      * Resolves the request to its grant + Personal Server and performs a Web3Signed
      * read. Hides the `402 Payment Required` flow by default: if a read needs
-     * payment and `escrow` is configured, it settles the grant via the escrow
-     * gateway and retries, attaching a {@link DirectPaymentReceipt} under
-     * `payment` so callers can inspect amount/asset/fee breakdown. If `escrow` is
-     * not configured, it throws {@link PaymentRequiredError} carrying the
-     * amount/asset owed.
+     * payment, it signs the Personal Server's payment challenge, retries with
+     * `X-PAYMENT`, and attaches a {@link DirectPaymentReceipt} under `payment`
+     * when the Personal Server returns one.
      *
      * @param input - The `dcr_*` request id to read.
      * @returns `{ scope, data, payment? }`.

package/dist/direct/controller.js

@@ -1,5 +1,7 @@
 import { privateKeyToAccount } from "viem/accounts";
 import { parseScope } from "../protocol/scopes.js";
+import { createEscrowGatewayClient } from "../protocol/escrow.js";
+import { CONTRACTS } from "../generated/addresses.js";
 import {
   createDefaultAccessRequestClient
 } from "./access-request-client.js";
@@ -47,13 +49,20 @@ function createDirectDataController(config) {
     appAddress: account.address,
     signMessage
   });
-  const escrow = config.escrow ? {
-    client: config.escrow.client,
-    escrowContract: config.escrow.escrowContract,
-    chainId: config.escrow.chainId ?? chainId,
-    nonceSource: config.escrow.nonceSource,
+  const escrowChainId = config.escrow?.chainId ?? chainId;
+  const defaultEscrowContract = CONTRACTS.DataPortabilityEscrow.addresses[escrowChainId] ?? void 0;
+  if (!config.escrow?.escrowContract && !defaultEscrowContract) {
+    throw new DirectConfigError(
+      `No DataPortabilityEscrow address found in the registry for chainId ${escrowChainId}. Provide an explicit escrow.escrowContract in the controller config.`
+    );
+  }
+  const escrow = {
+    client: config.escrow?.client ?? createEscrowGatewayClient(endpoints.escrowGatewayUrl),
+    escrowContract: config.escrow?.escrowContract ?? defaultEscrowContract,
+    chainId: escrowChainId,
+    nonceSource: config.escrow?.nonceSource,
     signTypedData
-  } : void 0;
+  };
   return {
     appAddress: account.address,
     getAppAddress() {