@opendatalabs/vana-sdk 0.1.0-alpha.d6bebb0 → 0.1.0-alpha.d7fc764

package/dist/config/eventMappings.d.ts

@@ -0,0 +1,108 @@
+import { VanaContract } from '../generated/abi/index.js';
+import '../generated/abi/DataPortabilityPermissionsImplementation.js';
+import '../generated/abi/DataPortabilityServersImplementation.js';
+import '../generated/abi/DataPortabilityGranteesImplementation.js';
+import '../generated/abi/VanaEpochImplementation.js';
+import '../generated/abi/DLPRegistryImplementation.js';
+import '../generated/abi/DLPTreasuryImplementation.js';
+import '../generated/abi/DLPRewardDeployerTreasuryImplementation.js';
+import '../generated/abi/DLPPerformanceImplementation.js';
+import '../generated/abi/DLPRewardDeployerImplementation.js';
+import '../generated/abi/DLPRootImplementation.js';
+import '../generated/abi/DataLiquidityPoolImplementation.js';
+import '../generated/abi/DLPRegistryTreasuryImplementation.js';
+
+interface EventMapping {
+    contract: VanaContract;
+    event: string;
+}
+/**
+ * Comprehensive mapping of SDK transaction operations to blockchain events.
+ * Used by the generic transaction parser to know which contract and event
+ * to look for when parsing transaction results.
+ */
+declare const EVENT_MAPPINGS: {
+    readonly grant: {
+        readonly contract: "DataPortabilityPermissions";
+        readonly event: "PermissionAdded";
+    };
+    readonly revoke: {
+        readonly contract: "DataPortabilityPermissions";
+        readonly event: "PermissionRevoked";
+    };
+    readonly revokePermission: {
+        readonly contract: "DataPortabilityPermissions";
+        readonly event: "PermissionRevoked";
+    };
+    readonly addServerFilesAndPermissions: {
+        readonly contract: "DataPortabilityPermissions";
+        readonly event: "PermissionAdded";
+    };
+    readonly trustServer: {
+        readonly contract: "DataPortabilityServers";
+        readonly event: "ServerTrusted";
+    };
+    readonly untrustServer: {
+        readonly contract: "DataPortabilityServers";
+        readonly event: "ServerUntrusted";
+    };
+    readonly registerServer: {
+        readonly contract: "DataPortabilityServers";
+        readonly event: "ServerRegistered";
+    };
+    readonly updateServer: {
+        readonly contract: "DataPortabilityServers";
+        readonly event: "ServerUpdated";
+    };
+    readonly addAndTrustServer: {
+        readonly contract: "DataPortabilityServers";
+        readonly event: "ServerTrusted";
+    };
+    readonly addFile: {
+        readonly contract: "DataRegistry";
+        readonly event: "FileAddedV2";
+    };
+    readonly addFileWithPermissionsAndSchema: {
+        readonly contract: "DataRegistry";
+        readonly event: "FileAddedV2";
+    };
+    readonly addFileWithSchema: {
+        readonly contract: "DataRegistry";
+        readonly event: "FileAddedV2";
+    };
+    readonly addFileWithPermissions: {
+        readonly contract: "DataRegistry";
+        readonly event: "FileAddedV2";
+    };
+    readonly addRefinement: {
+        readonly contract: "DataRegistry";
+        readonly event: "RefinementAdded";
+    };
+    readonly addRefiner: {
+        readonly contract: "DataRefinerRegistry";
+        readonly event: "RefinerAdded";
+    };
+    readonly updateSchemaId: {
+        readonly contract: "DataRefinerRegistry";
+        readonly event: "SchemaAdded";
+    };
+    readonly addSchema: {
+        readonly contract: "DataRefinerRegistry";
+        readonly event: "SchemaAdded";
+    };
+    readonly updateRefinement: {
+        readonly contract: "DataRegistry";
+        readonly event: "RefinementUpdated";
+    };
+    readonly addFilePermission: {
+        readonly contract: "DataRegistry";
+        readonly event: "PermissionGranted";
+    };
+    readonly registerGrantee: {
+        readonly contract: "DataPortabilityGrantees";
+        readonly event: "GranteeRegistered";
+    };
+};
+type TransactionOperation = keyof typeof EVENT_MAPPINGS;
+
+export { EVENT_MAPPINGS, type EventMapping, type TransactionOperation };

package/dist/config/eventMappings.js

@@ -0,0 +1,90 @@
+const EVENT_MAPPINGS = {
+  // DataPortabilityPermissions operations
+  grant: {
+    contract: "DataPortabilityPermissions",
+    event: "PermissionAdded"
+  },
+  revoke: {
+    contract: "DataPortabilityPermissions",
+    event: "PermissionRevoked"
+  },
+  revokePermission: {
+    contract: "DataPortabilityPermissions",
+    event: "PermissionRevoked"
+  },
+  addServerFilesAndPermissions: {
+    contract: "DataPortabilityPermissions",
+    event: "PermissionAdded"
+  },
+  // DataPortabilityServers operations
+  trustServer: {
+    contract: "DataPortabilityServers",
+    event: "ServerTrusted"
+  },
+  untrustServer: {
+    contract: "DataPortabilityServers",
+    event: "ServerUntrusted"
+  },
+  registerServer: {
+    contract: "DataPortabilityServers",
+    event: "ServerRegistered"
+  },
+  updateServer: {
+    contract: "DataPortabilityServers",
+    event: "ServerUpdated"
+  },
+  addAndTrustServer: {
+    contract: "DataPortabilityServers",
+    event: "ServerTrusted"
+  },
+  // DataRegistry operations
+  addFile: {
+    contract: "DataRegistry",
+    event: "FileAddedV2"
+  },
+  addFileWithPermissionsAndSchema: {
+    contract: "DataRegistry",
+    event: "FileAddedV2"
+  },
+  addFileWithSchema: {
+    contract: "DataRegistry",
+    event: "FileAddedV2"
+  },
+  addFileWithPermissions: {
+    contract: "DataRegistry",
+    event: "FileAddedV2"
+  },
+  addRefinement: {
+    contract: "DataRegistry",
+    event: "RefinementAdded"
+  },
+  addRefiner: {
+    contract: "DataRefinerRegistry",
+    event: "RefinerAdded"
+  },
+  updateSchemaId: {
+    contract: "DataRefinerRegistry",
+    event: "SchemaAdded"
+  },
+  addSchema: {
+    contract: "DataRefinerRegistry",
+    event: "SchemaAdded"
+  },
+  updateRefinement: {
+    contract: "DataRegistry",
+    event: "RefinementUpdated"
+  },
+  addFilePermission: {
+    contract: "DataRegistry",
+    event: "PermissionGranted"
+  },
+  // DataPortabilityGrantees operations
+  registerGrantee: {
+    contract: "DataPortabilityGrantees",
+    event: "GranteeRegistered"
+  }
+};
+export {
+  EVENT_MAPPINGS
+};
+//# sourceMappingURL=eventMappings.js.map

package/dist/config/eventMappings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/eventMappings.ts"],"sourcesContent":["// Event mapping configuration for transaction result parsing\n// Maps SDK operation names to their corresponding contract events\n\nimport type { VanaContract } from \"../generated/abi\";\n\nexport interface EventMapping {\n  contract: VanaContract;\n  event: string;\n}\n\n/**\n * Comprehensive mapping of SDK transaction operations to blockchain events.\n * Used by the generic transaction parser to know which contract and event\n * to look for when parsing transaction results.\n */\nexport const EVENT_MAPPINGS = {\n  // DataPortabilityPermissions operations\n  grant: {\n    contract: \"DataPortabilityPermissions\",\n    event: \"PermissionAdded\",\n  },\n  revoke: {\n    contract: \"DataPortabilityPermissions\",\n    event: \"PermissionRevoked\",\n  },\n  revokePermission: {\n    contract: \"DataPortabilityPermissions\",\n    event: \"PermissionRevoked\",\n  },\n  addServerFilesAndPermissions: {\n    contract: \"DataPortabilityPermissions\",\n    event: \"PermissionAdded\",\n  },\n\n  // DataPortabilityServers operations\n  trustServer: {\n    contract: \"DataPortabilityServers\",\n    event: \"ServerTrusted\",\n  },\n  untrustServer: {\n    contract: \"DataPortabilityServers\",\n    event: \"ServerUntrusted\",\n  },\n  registerServer: {\n    contract: \"DataPortabilityServers\",\n    event: \"ServerRegistered\",\n  },\n  updateServer: {\n    contract: \"DataPortabilityServers\",\n    event: \"ServerUpdated\",\n  },\n  addAndTrustServer: {\n    contract: \"DataPortabilityServers\",\n    event: \"ServerTrusted\",\n  },\n\n  // DataRegistry operations\n  addFile: {\n    contract: \"DataRegistry\",\n    event: \"FileAddedV2\",\n  },\n  addFileWithPermissionsAndSchema: {\n    contract: \"DataRegistry\",\n    event: \"FileAddedV2\",\n  },\n  addFileWithSchema: {\n    contract: \"DataRegistry\",\n    event: \"FileAddedV2\",\n  },\n  addFileWithPermissions: {\n    contract: \"DataRegistry\",\n    event: \"FileAddedV2\",\n  },\n  addRefinement: {\n    contract: \"DataRegistry\",\n    event: \"RefinementAdded\",\n  },\n  addRefiner: {\n    contract: \"DataRefinerRegistry\",\n    event: \"RefinerAdded\",\n  },\n  updateSchemaId: {\n    contract: \"DataRefinerRegistry\",\n    event: \"SchemaAdded\",\n  },\n  addSchema: {\n    contract: \"DataRefinerRegistry\",\n    event: \"SchemaAdded\",\n  },\n  updateRefinement: {\n    contract: \"DataRegistry\",\n    event: \"RefinementUpdated\",\n  },\n  addFilePermission: {\n    contract: \"DataRegistry\",\n    event: \"PermissionGranted\",\n  },\n\n  // DataPortabilityGrantees operations\n  registerGrantee: {\n    contract: \"DataPortabilityGrantees\",\n    event: \"GranteeRegistered\",\n  },\n} as const satisfies Record<string, EventMapping>;\n\nexport type TransactionOperation = keyof typeof EVENT_MAPPINGS;\n"],"mappings":"AAeO,MAAM,iBAAiB;AAAA;AAAA,EAE5B,OAAO;AAAA,IACL,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,QAAQ;AAAA,IACN,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,kBAAkB;AAAA,IAChB,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,8BAA8B;AAAA,IAC5B,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA;AAAA,EAGA,aAAa;AAAA,IACX,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,eAAe;AAAA,IACb,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,gBAAgB;AAAA,IACd,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,cAAc;AAAA,IACZ,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,mBAAmB;AAAA,IACjB,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA;AAAA,EAGA,SAAS;AAAA,IACP,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,iCAAiC;AAAA,IAC/B,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,mBAAmB;AAAA,IACjB,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,wBAAwB;AAAA,IACtB,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,eAAe;AAAA,IACb,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,YAAY;AAAA,IACV,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,gBAAgB;AAAA,IACd,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,WAAW;AAAA,IACT,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,kBAAkB;AAAA,IAChB,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA,EACA,mBAAmB;AAAA,IACjB,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AAAA;AAAA,EAGA,iBAAiB;AAAA,IACf,UAAU;AAAA,IACV,OAAO;AAAA,EACT;AACF;","names":[]}

package/dist/config/features.cjs

@@ -0,0 +1,52 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var features_exports = {};
+__export(features_exports, {
+  features: () => features
+});
+module.exports = __toCommonJS(features_exports);
+const features = {
+  /**
+   * Use custom ECIES implementation instead of eccrypto
+   *
+   * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability
+   * When true: Uses the custom platform-specific ECIES implementation
+   *
+   * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true
+   *
+   * @example
+   * ```bash
+   * # Use eccrypto-js (default)
+   * VANA_USE_CUSTOM_ECIES=false npm run your-app
+   *
+   * # Use custom ECIES implementation
+   * VANA_USE_CUSTOM_ECIES=true npm run your-app
+   * ```
+   *
+   * @returns Whether to use custom ECIES implementation
+   */
+  get useCustomECIES() {
+    return process.env.VANA_USE_CUSTOM_ECIES === "true";
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  features
+});
+//# sourceMappingURL=features.cjs.map

package/dist/config/features.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/features.ts"],"sourcesContent":["/**\n * Feature flags for the Vana SDK\n *\n * @remarks\n * This module controls feature toggles that allow switching between different\n * implementations or enabling experimental features.\n *\n * The getter pattern is used to allow dynamic evaluation of environment variables,\n * which is necessary for tests to override the default before modules are loaded.\n *\n * ## Dual-Mode ECIES Support\n *\n * The SDK supports two encryption implementations:\n *\n * 1. **eccrypto-js** (Default)\n *    - Pure JavaScript implementation\n *    - Works everywhere (Node.js and browsers)\n *    - No native dependencies\n *    - Good performance for most use cases\n *\n * 2. **Custom ECIES** (Opt-in)\n *    - Uses native `secp256k1` module in Node.js for optimal performance\n *    - Uses `@noble/secp256k1` in browsers (pure JS)\n *    - Slightly faster in Node.js environments\n *    - Currently used by tests to ensure compatibility\n *\n * ### Architecture Notes\n * - Browser builds: Never reference native `secp256k1`, use `@noble/secp256k1` instead\n * - Node builds: Include both implementations, feature flag chooses at runtime\n * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues\n *\n * ### Future Plans\n * Once the custom ECIES implementation is battle-tested:\n * 1. Make custom ECIES the default\n * 2. Eventually remove eccrypto-js dependency\n * 3. Keep the same architecture (native for Node, @noble for browser)\n */\n\n/**\n * Feature flag configuration\n */\nexport const features = {\n  /**\n   * Use custom ECIES implementation instead of eccrypto\n   *\n   * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability\n   * When true: Uses the custom platform-specific ECIES implementation\n   *\n   * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true\n   *\n   * @example\n   * ```bash\n   * # Use eccrypto-js (default)\n   * VANA_USE_CUSTOM_ECIES=false npm run your-app\n   *\n   * # Use custom ECIES implementation\n   * VANA_USE_CUSTOM_ECIES=true npm run your-app\n   * ```\n   *\n   * @returns Whether to use custom ECIES implementation\n   */\n  get useCustomECIES(): boolean {\n    // Default to false (use eccrypto for stability)\n    // Tests will override this to true since they test the custom implementation\n    return process.env.VANA_USE_CUSTOM_ECIES === \"true\";\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyCO,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBtB,IAAI,iBAA0B;AAG5B,WAAO,QAAQ,IAAI,0BAA0B;AAAA,EAC/C;AACF;","names":[]}

package/dist/config/features.d.cts

@@ -0,0 +1,64 @@
+/**
+ * Feature flags for the Vana SDK
+ *
+ * @remarks
+ * This module controls feature toggles that allow switching between different
+ * implementations or enabling experimental features.
+ *
+ * The getter pattern is used to allow dynamic evaluation of environment variables,
+ * which is necessary for tests to override the default before modules are loaded.
+ *
+ * ## Dual-Mode ECIES Support
+ *
+ * The SDK supports two encryption implementations:
+ *
+ * 1. **eccrypto-js** (Default)
+ *    - Pure JavaScript implementation
+ *    - Works everywhere (Node.js and browsers)
+ *    - No native dependencies
+ *    - Good performance for most use cases
+ *
+ * 2. **Custom ECIES** (Opt-in)
+ *    - Uses native `secp256k1` module in Node.js for optimal performance
+ *    - Uses `@noble/secp256k1` in browsers (pure JS)
+ *    - Slightly faster in Node.js environments
+ *    - Currently used by tests to ensure compatibility
+ *
+ * ### Architecture Notes
+ * - Browser builds: Never reference native `secp256k1`, use `@noble/secp256k1` instead
+ * - Node builds: Include both implementations, feature flag chooses at runtime
+ * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues
+ *
+ * ### Future Plans
+ * Once the custom ECIES implementation is battle-tested:
+ * 1. Make custom ECIES the default
+ * 2. Eventually remove eccrypto-js dependency
+ * 3. Keep the same architecture (native for Node, @noble for browser)
+ */
+/**
+ * Feature flag configuration
+ */
+declare const features: {
+    /**
+     * Use custom ECIES implementation instead of eccrypto
+     *
+     * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability
+     * When true: Uses the custom platform-specific ECIES implementation
+     *
+     * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true
+     *
+     * @example
+     * ```bash
+     * # Use eccrypto-js (default)
+     * VANA_USE_CUSTOM_ECIES=false npm run your-app
+     *
+     * # Use custom ECIES implementation
+     * VANA_USE_CUSTOM_ECIES=true npm run your-app
+     * ```
+     *
+     * @returns Whether to use custom ECIES implementation
+     */
+    readonly useCustomECIES: boolean;
+};
+
+export { features };

package/dist/config/features.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Feature flags for the Vana SDK
+ *
+ * @remarks
+ * This module controls feature toggles that allow switching between different
+ * implementations or enabling experimental features.
+ *
+ * The getter pattern is used to allow dynamic evaluation of environment variables,
+ * which is necessary for tests to override the default before modules are loaded.
+ *
+ * ## Dual-Mode ECIES Support
+ *
+ * The SDK supports two encryption implementations:
+ *
+ * 1. **eccrypto-js** (Default)
+ *    - Pure JavaScript implementation
+ *    - Works everywhere (Node.js and browsers)
+ *    - No native dependencies
+ *    - Good performance for most use cases
+ *
+ * 2. **Custom ECIES** (Opt-in)
+ *    - Uses native `secp256k1` module in Node.js for optimal performance
+ *    - Uses `@noble/secp256k1` in browsers (pure JS)
+ *    - Slightly faster in Node.js environments
+ *    - Currently used by tests to ensure compatibility
+ *
+ * ### Architecture Notes
+ * - Browser builds: Never reference native `secp256k1`, use `@noble/secp256k1` instead
+ * - Node builds: Include both implementations, feature flag chooses at runtime
+ * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues
+ *
+ * ### Future Plans
+ * Once the custom ECIES implementation is battle-tested:
+ * 1. Make custom ECIES the default
+ * 2. Eventually remove eccrypto-js dependency
+ * 3. Keep the same architecture (native for Node, @noble for browser)
+ */
+/**
+ * Feature flag configuration
+ */
+declare const features: {
+    /**
+     * Use custom ECIES implementation instead of eccrypto
+     *
+     * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability
+     * When true: Uses the custom platform-specific ECIES implementation
+     *
+     * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true
+     *
+     * @example
+     * ```bash
+     * # Use eccrypto-js (default)
+     * VANA_USE_CUSTOM_ECIES=false npm run your-app
+     *
+     * # Use custom ECIES implementation
+     * VANA_USE_CUSTOM_ECIES=true npm run your-app
+     * ```
+     *
+     * @returns Whether to use custom ECIES implementation
+     */
+    readonly useCustomECIES: boolean;
+};
+
+export { features };

package/dist/config/features.js

@@ -0,0 +1,28 @@
+const features = {
+  /**
+   * Use custom ECIES implementation instead of eccrypto
+   *
+   * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability
+   * When true: Uses the custom platform-specific ECIES implementation
+   *
+   * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true
+   *
+   * @example
+   * ```bash
+   * # Use eccrypto-js (default)
+   * VANA_USE_CUSTOM_ECIES=false npm run your-app
+   *
+   * # Use custom ECIES implementation
+   * VANA_USE_CUSTOM_ECIES=true npm run your-app
+   * ```
+   *
+   * @returns Whether to use custom ECIES implementation
+   */
+  get useCustomECIES() {
+    return process.env.VANA_USE_CUSTOM_ECIES === "true";
+  }
+};
+export {
+  features
+};
+//# sourceMappingURL=features.js.map

package/dist/config/features.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/config/features.ts"],"sourcesContent":["/**\n * Feature flags for the Vana SDK\n *\n * @remarks\n * This module controls feature toggles that allow switching between different\n * implementations or enabling experimental features.\n *\n * The getter pattern is used to allow dynamic evaluation of environment variables,\n * which is necessary for tests to override the default before modules are loaded.\n *\n * ## Dual-Mode ECIES Support\n *\n * The SDK supports two encryption implementations:\n *\n * 1. **eccrypto-js** (Default)\n *    - Pure JavaScript implementation\n *    - Works everywhere (Node.js and browsers)\n *    - No native dependencies\n *    - Good performance for most use cases\n *\n * 2. **Custom ECIES** (Opt-in)\n *    - Uses native `secp256k1` module in Node.js for optimal performance\n *    - Uses `@noble/secp256k1` in browsers (pure JS)\n *    - Slightly faster in Node.js environments\n *    - Currently used by tests to ensure compatibility\n *\n * ### Architecture Notes\n * - Browser builds: Never reference native `secp256k1`, use `@noble/secp256k1` instead\n * - Node builds: Include both implementations, feature flag chooses at runtime\n * - `secp256k1`: Remains an `optionalDependency` so browser-only users don't face build issues\n *\n * ### Future Plans\n * Once the custom ECIES implementation is battle-tested:\n * 1. Make custom ECIES the default\n * 2. Eventually remove eccrypto-js dependency\n * 3. Keep the same architecture (native for Node, @noble for browser)\n */\n\n/**\n * Feature flag configuration\n */\nexport const features = {\n  /**\n   * Use custom ECIES implementation instead of eccrypto\n   *\n   * When false (default): Uses the original eccrypto/eccrypto-js libraries for stability\n   * When true: Uses the custom platform-specific ECIES implementation\n   *\n   * Enable by setting environment variable: VANA_USE_CUSTOM_ECIES=true\n   *\n   * @example\n   * ```bash\n   * # Use eccrypto-js (default)\n   * VANA_USE_CUSTOM_ECIES=false npm run your-app\n   *\n   * # Use custom ECIES implementation\n   * VANA_USE_CUSTOM_ECIES=true npm run your-app\n   * ```\n   *\n   * @returns Whether to use custom ECIES implementation\n   */\n  get useCustomECIES(): boolean {\n    // Default to false (use eccrypto for stability)\n    // Tests will override this to true since they test the custom implementation\n    return process.env.VANA_USE_CUSTOM_ECIES === \"true\";\n  },\n};\n"],"mappings":"AAyCO,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBtB,IAAI,iBAA0B;AAG5B,WAAO,QAAQ,IAAI,0BAA0B;AAAA,EAC/C;AACF;","names":[]}

package/dist/contracts/contractController.cjs

@@ -0,0 +1,126 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var contractController_exports = {};
+__export(contractController_exports, {
+  ContractFactory: () => ContractFactory,
+  __contractCache: () => __contractCache,
+  clearContractCache: () => clearContractCache,
+  getContractController: () => getContractController,
+  getContractInfo: () => getContractInfo
+});
+module.exports = __toCommonJS(contractController_exports);
+var import_viem = require("viem");
+var import_abi = require("../generated/abi");
+var import_addresses = require("../config/addresses");
+var import_client = require("../core/client");
+var import_chains = require("../config/chains");
+const contractCache = /* @__PURE__ */ new Map();
+const __contractCache = contractCache;
+function createCacheKey(contract, chainId) {
+  return `${contract}:${chainId}`;
+}
+function getContractController(contract, client = (0, import_client.createClient)()) {
+  const chainId = client.chain?.id ?? import_chains.vanaMainnet.id;
+  const cacheKey = createCacheKey(contract, chainId);
+  let controller = contractCache.get(cacheKey);
+  if (!controller) {
+    controller = (0, import_viem.getContract)({
+      address: (0, import_addresses.getContractAddress)(chainId, contract),
+      abi: (0, import_abi.getAbi)(contract),
+      client
+    });
+    contractCache.set(cacheKey, controller);
+  }
+  return controller;
+}
+function getContractInfo(contract, chainId = import_chains.vanaMainnet.id) {
+  return {
+    address: (0, import_addresses.getContractAddress)(chainId, contract),
+    abi: (0, import_abi.getAbi)(contract)
+  };
+}
+class ContractFactory {
+  client;
+  chainId;
+  constructor(client) {
+    this.client = client;
+    try {
+      this.chainId = client.chain?.id ?? import_chains.vanaMainnet.id;
+    } catch {
+      this.chainId = import_chains.vanaMainnet.id;
+    }
+  }
+  /**
+   * Creates a typed contract instance
+   *
+   * @param contract - Contract name (use const assertion for full typing)
+   * @returns Fully typed contract instance
+   */
+  create(contract) {
+    return getContractController(contract, this.client);
+  }
+  /**
+   * Gets contract information without creating an instance
+   *
+   * @param contract - Contract name
+   * @returns Contract information with typed ABI
+   */
+  getInfo(contract) {
+    return getContractInfo(contract, this.chainId);
+  }
+  /**
+   * Lists all available contracts for the current chain
+   *
+   * @returns Array of contract names available on this chain
+   */
+  getAvailableContracts() {
+    const chainAddresses = import_addresses.CONTRACT_ADDRESSES[this.chainId];
+    if (!chainAddresses) return [];
+    return Object.keys(chainAddresses);
+  }
+}
+function clearContractCache(contract, chainId) {
+  if (contract && chainId) {
+    const cacheKey = createCacheKey(contract, chainId);
+    contractCache.delete(cacheKey);
+  } else if (contract) {
+    for (const key of contractCache.keys()) {
+      if (key.startsWith(`${contract}:`)) {
+        contractCache.delete(key);
+      }
+    }
+  } else if (chainId) {
+    for (const key of contractCache.keys()) {
+      if (key.endsWith(`:${chainId}`)) {
+        contractCache.delete(key);
+      }
+    }
+  } else {
+    contractCache.clear();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ContractFactory,
+  __contractCache,
+  clearContractCache,
+  getContractController,
+  getContractInfo
+});
+//# sourceMappingURL=contractController.cjs.map

package/dist/contracts/contractController.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contracts/contractController.ts"],"sourcesContent":["import type { Abi } from \"abitype\";\nimport {\n  getContract,\n  type GetContractReturnType,\n  type PublicClient,\n  type WalletClient,\n} from \"viem\";\nimport { type ContractAbis, getAbi, type VanaContract } from \"../generated/abi\";\nimport type { VanaChainId, ContractInfo } from \"../types/index\";\nimport { getContractAddress, CONTRACT_ADDRESSES } from \"../config/addresses\";\nimport { createClient } from \"../core/client\";\nimport { vanaMainnet } from \"../config/chains\";\n\n// Cache for contract instances - keyed by contract name and chain ID\nconst contractCache = new Map<string, GetContractReturnType<Abi>>();\n\n// Export cache for testing\nexport const __contractCache = contractCache;\n\n/**\n * Creates a cache key for contract instances\n *\n * @param contract - The contract name to create a cache key for\n * @param chainId - The chain ID to include in the cache key\n * @returns A string cache key combining contract name and chain ID\n */\nfunction createCacheKey(contract: VanaContract, chainId: number): string {\n  return `${contract}:${chainId}`;\n}\n\n/**\n * Gets a typed contract instance for the specified contract name with full type inference.\n * This function provides complete type safety following viem's patterns.\n *\n * @param contract - Name of the contract to instantiate (must be a const assertion for full typing)\n * @param client - Optional viem client instance\n * @returns A fully typed contract instance with methods corresponding to the contract's ABI\n * @example\n * ```typescript\n * // Full type inference with const assertion\n * const dataRegistry = getContractController(\"DataRegistry\" as const, client);\n *\n * // Now dataRegistry has full type inference for all methods\n * const result = await dataRegistry.read.getFileCount(); // Type: bigint\n * await dataRegistry.write.addFile([url, proof]); // Typed parameters\n * ```\n */\nexport function getContractController<T extends VanaContract>(\n  contract: T,\n  client:\n    | PublicClient\n    | WalletClient\n    | ReturnType<typeof createClient> = createClient(),\n): GetContractReturnType<ContractAbis[T]> {\n  const chainId = client.chain?.id ?? vanaMainnet.id;\n  const cacheKey = createCacheKey(contract, chainId);\n\n  let controller = contractCache.get(cacheKey);\n\n  if (!controller) {\n    controller = getContract({\n      address: getContractAddress(chainId, contract),\n      abi: getAbi(contract),\n      client,\n    }) as GetContractReturnType<ContractAbis[T]>;\n\n    contractCache.set(cacheKey, controller);\n  }\n\n  return controller as GetContractReturnType<ContractAbis[T]>;\n}\n\n/**\n * Gets contract information (address and ABI) without creating a contract instance.\n * Useful for cases where you need contract details but don't want to create a client connection.\n *\n * @param contract - Name of the contract\n * @param chainId - Chain ID (defaults to Vana mainnet)\n * @returns Contract information with typed ABI\n * @example\n * ```typescript\n * const info = getContractInfo(\"DataRegistry\" as const, 14800);\n * console.log(info.address); // Typed as Address\n * console.log(info.abi); // Fully typed ABI\n * ```\n */\nexport function getContractInfo<T extends VanaContract>(\n  contract: T,\n  chainId: VanaChainId = vanaMainnet.id as VanaChainId,\n): ContractInfo<ContractAbis[T]> {\n  return {\n    address: getContractAddress(chainId, contract),\n    abi: getAbi(contract),\n  };\n}\n\n/**\n * Type-safe contract factory that creates contract instances with full type inference.\n * This provides an alternative API that's more explicit about typing.\n */\nexport class ContractFactory {\n  private readonly client:\n    | PublicClient\n    | WalletClient\n    | ReturnType<typeof createClient>;\n  private readonly chainId: number;\n\n  constructor(\n    client: PublicClient | WalletClient | ReturnType<typeof createClient>,\n  ) {\n    this.client = client;\n    try {\n      this.chainId = client.chain?.id ?? vanaMainnet.id;\n    } catch {\n      this.chainId = vanaMainnet.id;\n    }\n  }\n\n  /**\n   * Creates a typed contract instance\n   *\n   * @param contract - Contract name (use const assertion for full typing)\n   * @returns Fully typed contract instance\n   */\n  create<T extends VanaContract>(\n    contract: T,\n  ): GetContractReturnType<ContractAbis[T]> {\n    return getContractController(contract, this.client);\n  }\n\n  /**\n   * Gets contract information without creating an instance\n   *\n   * @param contract - Contract name\n   * @returns Contract information with typed ABI\n   */\n  getInfo<T extends VanaContract>(contract: T): ContractInfo<ContractAbis[T]> {\n    return getContractInfo(contract, this.chainId as VanaChainId);\n  }\n\n  /**\n   * Lists all available contracts for the current chain\n   *\n   * @returns Array of contract names available on this chain\n   */\n  getAvailableContracts(): VanaContract[] {\n    // Return all contract names that have addresses on this chain\n    const chainAddresses = CONTRACT_ADDRESSES[this.chainId];\n    if (!chainAddresses) return [];\n\n    return Object.keys(chainAddresses) as VanaContract[];\n  }\n}\n\n/**\n * Clears the contract cache. Useful for testing or when chain configurations change.\n *\n * @param contract - Optional specific contract to clear, or clear all if not provided\n * @param chainId - Optional specific chain to clear, or clear all if not provided\n */\nexport function clearContractCache(\n  contract?: VanaContract,\n  chainId?: number,\n): void {\n  if (contract && chainId) {\n    const cacheKey = createCacheKey(contract, chainId);\n    contractCache.delete(cacheKey);\n  } else if (contract) {\n    // Clear all instances of this contract across all chains\n    for (const key of contractCache.keys()) {\n      if (key.startsWith(`${contract}:`)) {\n        contractCache.delete(key);\n      }\n    }\n  } else if (chainId) {\n    // Clear all contracts for this chain\n    for (const key of contractCache.keys()) {\n      if (key.endsWith(`:${chainId}`)) {\n        contractCache.delete(key);\n      }\n    }\n  } else {\n    // Clear entire cache\n    contractCache.clear();\n  }\n}\n\n// Function is already exported above, no need for redundant export\n\n// Type-only exports for enhanced type safety\nexport type { GetContractReturnType } from \"viem\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,kBAKO;AACP,iBAA6D;AAE7D,uBAAuD;AACvD,oBAA6B;AAC7B,oBAA4B;AAG5B,MAAM,gBAAgB,oBAAI,IAAwC;AAG3D,MAAM,kBAAkB;AAS/B,SAAS,eAAe,UAAwB,SAAyB;AACvE,SAAO,GAAG,QAAQ,IAAI,OAAO;AAC/B;AAmBO,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;AAgBO,SAAS,gBACd,UACA,UAAuB,0BAAY,IACJ;AAC/B,SAAO;AAAA,IACL,aAAS,qCAAmB,SAAS,QAAQ;AAAA,IAC7C,SAAK,mBAAO,QAAQ;AAAA,EACtB;AACF;AAMO,MAAM,gBAAgB;AAAA,EACV;AAAA,EAIA;AAAA,EAEjB,YACE,QACA;AACA,SAAK,SAAS;AACd,QAAI;AACF,WAAK,UAAU,OAAO,OAAO,MAAM,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":[]}