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

package/dist/controllers/schemas.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/schemas.ts"],"sourcesContent":["import { Address } from \"viem\";\nimport {\n  Schema,\n  SchemaMetadata,\n  CompleteSchema,\n  AddSchemaParams,\n  AddSchemaResult,\n} from \"../types/index\";\nimport { ControllerContext } from \"./permissions\";\nimport { getContractAddress } from \"../config/addresses\";\nimport { getAbi } from \"../generated/abi\";\nimport { gasAwareMulticall } from \"../utils/multicall\";\nimport {\n  validateDataSchemaAgainstMetaSchema,\n  SchemaValidationError,\n  type DataSchema,\n} from \"../utils/schemaValidation\";\nimport {\n  fetchSchemaFromChain,\n  fetchSchemaCountFromChain,\n} from \"../utils/blockchain/registry\";\nimport {\n  GetSchemaDocument,\n  ListSchemasDocument,\n  CountSchemasDocument,\n  type GetSchemaQuery,\n  type ListSchemasQuery,\n  type CountSchemasQuery,\n} from \"../generated/subgraph\";\nimport { print } from \"graphql\";\nimport { fetchFromUrl, UrlResolutionError } from \"../utils/urlResolver\";\n\n/**\n * Parameters for creating a new schema with automatic IPFS upload.\n *\n * @remarks\n * This interface is used with the high-level `schemas.create()` method which\n * automatically uploads the schema definition to IPFS and registers it on-chain.\n * @category Schema Management\n */\nexport interface CreateSchemaParams {\n  /** The name of the schema */\n  name: string;\n  /** The dialect of the schema (e.g., 'json' or 'sqlite') */\n  dialect: \"json\" | \"sqlite\";\n  /** The schema definition object or JSON string */\n  schema: object | string;\n}\n\n/**\n * Result of creating a new schema.\n *\n * @remarks\n * Returned by the `schemas.create()` method after successful upload and registration.\n * @category Schema Management\n */\nexport interface CreateSchemaResult {\n  /** The schema ID assigned by the contract */\n  schemaId: number;\n  /** The IPFS URL where the schema definition is stored */\n  definitionUrl: string;\n  /** The transaction hash of the schema registration */\n  transactionHash: string;\n}\n\n/**\n * Manages data schemas and refiners on the Vana network.\n *\n * @remarks\n * This controller handles the complete lifecycle of data schemas including creation,\n * validation, IPFS upload, and blockchain registration. It provides methods for managing\n * both schemas (data structure definitions) and refiners (data processing definitions).\n *\n * **Schema Storage:**\n * Schemas are stored unencrypted on IPFS for public access and reusability across the network.\n * Schema definitions use JSON Schema format for data validation and structure definition.\n *\n * **Method Selection:**\n * - `create()` validates, uploads to IPFS, and registers new schemas on blockchain\n * - `get()` retrieves existing schema metadata by ID from blockchain contracts\n * - `count()` returns total number of registered schemas for pagination\n * - `list()` provides paginated access to all schemas with optional filtering\n * - `addSchema()` provides lower-level schema registration with pre-uploaded URLs\n *\n * **Storage Requirements:**\n * Methods requiring storage configuration: `create()`\n * Methods working without storage: `get()`, `count()`, `list()`, `addSchema()`\n *\n * @example\n * ```typescript\n * // Create a new schema with automatic IPFS upload\n * const result = await vana.schemas.create({\n *   name: \"User Profile\",\n *   dialect: \"json\",\n *   schema: {\n *     type: \"object\",\n *     properties: {\n *       name: { type: \"string\" },\n *       age: { type: \"number\" }\n *     },\n *     required: [\"name\"]\n *   }\n * });\n *\n * // Get an existing schema\n * const schema = await vana.schemas.get(1);\n *\n * // List all schemas\n * const count = await vana.schemas.count();\n * ```\n * @category Schema Management\n */\nexport class SchemaController {\n  constructor(private readonly context: ControllerContext) {}\n\n  /**\n   * Creates a new schema with automatic validation and IPFS upload.\n   *\n   * @remarks\n   * This is the primary method for creating schemas on the Vana network. It handles\n   * the complete workflow including schema validation, IPFS upload, and blockchain\n   * registration. The schema definition is stored unencrypted on IPFS to enable\n   * public access and reusability.\n   *\n   * The method automatically:\n   * - Validates the schema definition against the Vana metaschema\n   * - Uploads the definition to IPFS to generate a permanent URL\n   * - Registers the schema on the blockchain with the generated URL\n   *\n   * @param params - Schema creation parameters including name, dialect, and definition\n   * @returns Promise resolving to creation results with schema ID and transaction hash\n   * @throws {SchemaValidationError} When the schema definition is invalid\n   * @throws {Error} When IPFS upload or blockchain registration fails\n   * @example\n   * ```typescript\n   * // Create a JSON schema for user profiles\n   * const result = await vana.schemas.create({\n   *   name: \"User Profile\",\n   *   dialect: \"json\",\n   *   schema: {\n   *     type: \"object\",\n   *     properties: {\n   *       name: { type: \"string\" },\n   *       age: { type: \"number\", minimum: 0 }\n   *     },\n   *     required: [\"name\"]\n   *   }\n   * });\n   *\n   * console.log(`Schema created with ID: ${result.schemaId}`);\n   * ```\n   */\n  async create(params: CreateSchemaParams): Promise<CreateSchemaResult> {\n    const { name, dialect, schema } = params;\n\n    try {\n      // Step 1: Normalize and validate the schema definition\n      let schemaDefinition: object;\n      if (typeof schema === \"string\") {\n        try {\n          schemaDefinition = JSON.parse(schema);\n        } catch {\n          throw new SchemaValidationError(\n            \"Invalid JSON in schema definition\",\n            [],\n          );\n        }\n      } else {\n        schemaDefinition = schema;\n      }\n\n      // Step 2: Validate against metaschema\n      const dataSchema: DataSchema = {\n        name,\n        version: \"1.0.0\",\n        dialect,\n        schema: schemaDefinition,\n      };\n\n      validateDataSchemaAgainstMetaSchema(dataSchema);\n\n      // Step 3: Upload to IPFS (unencrypted for public access)\n      if (!this.context.storageManager) {\n        // Use centralized validation if available, otherwise fall back to old behavior\n        if (this.context.validateStorageRequired) {\n          this.context.validateStorageRequired();\n          // The validateStorageRequired method throws, so this line should never be reached\n          // but TypeScript doesn't know that, so we need this fallback\n          throw new Error(\"Storage validation failed\");\n        } else {\n          throw new Error(\n            \"Storage manager not configured. Please provide storage providers in VanaConfig.\",\n          );\n        }\n      }\n\n      const schemaBlob = new Blob([JSON.stringify(dataSchema)], {\n        type: \"application/json\",\n      });\n\n      const uploadResult = await this.context.storageManager.upload(\n        schemaBlob,\n        `${name.replace(/[^a-zA-Z0-9]/g, \"_\")}.json`,\n        \"ipfs\", // Use IPFS for public schema storage\n      );\n\n      // Step 4: Register on blockchain\n      const chainId = this.context.walletClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      const userAddress = await this.getUserAddress();\n\n      const txHash = await this.context.walletClient.writeContract({\n        address: dataRefinerRegistryAddress,\n        abi: dataRefinerRegistryAbi,\n        functionName: \"addSchema\",\n        args: [name, dialect, uploadResult.url],\n        account: this.context.walletClient.account || userAddress,\n        chain: this.context.walletClient.chain || null,\n      });\n\n      // Wait for transaction confirmation and parse events\n      const receipt = await this.context.publicClient.waitForTransactionReceipt(\n        {\n          hash: txHash,\n          confirmations: 1,\n        },\n      );\n\n      // Parse the SchemaAdded event to get the schema ID\n      const { parseSchemaAddedEvent } = await import(\"../utils/eventParsing\");\n      const eventData = parseSchemaAddedEvent(receipt);\n\n      return {\n        schemaId: Number(eventData.schemaId),\n        definitionUrl: uploadResult.url,\n        transactionHash: txHash,\n      };\n    } catch (error) {\n      if (error instanceof SchemaValidationError) {\n        throw error;\n      }\n      throw new Error(\n        `Schema creation failed: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Retrieves a complete schema by its ID with definition fetched and flattened.\n   *\n   * @param schemaId - The ID of the schema to retrieve\n   * @param options - Optional parameters\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @returns Promise resolving to the complete schema object with all fields populated\n   * @throws {Error} When the schema is not found, definition cannot be fetched, or chain is unavailable\n   * @example\n   * ```typescript\n   * const schema = await vana.schemas.get(1);\n   * console.log(`Schema: ${schema.name} (${schema.dialect})`);\n   * console.log(`Version: ${schema.version}`);\n   * console.log(`Description: ${schema.description}`);\n   * console.log('Schema:', schema.schema);\n   *\n   * // Use directly with validator (schema has all required fields)\n   * validator.validateDataAgainstSchema(data, schema);\n   * ```\n   */\n  async get(\n    schemaId: number,\n    options: { subgraphUrl?: string } = {},\n  ): Promise<CompleteSchema> {\n    const subgraphUrl = options.subgraphUrl || this.context.subgraphUrl;\n\n    let metadata: SchemaMetadata;\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        metadata = await this._getSchemaViaSubgraph({ schemaId, subgraphUrl });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n        try {\n          metadata = await fetchSchemaFromChain(this.context, schemaId);\n        } catch (rpcError) {\n          throw new Error(\n            `Failed to get schema: ${rpcError instanceof Error ? rpcError.message : \"Unknown error\"}`,\n          );\n        }\n      }\n    } else {\n      // Use RPC directly\n      try {\n        metadata = await fetchSchemaFromChain(this.context, schemaId);\n      } catch (error) {\n        throw new Error(\n          `Failed to get schema: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        );\n      }\n    }\n\n    // Fetch the definition (should be a complete DataSchema)\n    const definition = await fetchFromUrl(\n      metadata.definitionUrl,\n      this.context.downloadRelayer,\n    );\n\n    if (!definition || typeof definition !== \"object\") {\n      throw new Error(\n        `Invalid schema definition format for schema ${schemaId}`,\n      );\n    }\n\n    // Validate the fetched DataSchema\n    validateDataSchemaAgainstMetaSchema(definition);\n    const dataSchema = definition as DataSchema;\n\n    // Verify on-chain and off-chain data match\n    if (dataSchema.name !== metadata.name) {\n      throw new Error(\n        `Schema name mismatch: on-chain=\"${metadata.name}\" off-chain=\"${dataSchema.name}\"`,\n      );\n    }\n    if (dataSchema.dialect !== metadata.dialect) {\n      throw new Error(\n        `Schema dialect mismatch: on-chain=\"${metadata.dialect}\" off-chain=\"${dataSchema.dialect}\"`,\n      );\n    }\n\n    // Return using on-chain values as authoritative source\n    return {\n      ...metadata,\n      version: dataSchema.version,\n      description: dataSchema.description,\n      schema: dataSchema.schema,\n    };\n  }\n\n  /**\n   * Gets the total number of schemas registered on the network.\n   *\n   * @param options - Optional parameters\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @returns Promise resolving to the total schema count\n   * @throws {Error} When the count cannot be retrieved\n   * @example\n   * ```typescript\n   * const count = await vana.schemas.count();\n   * console.log(`Total schemas: ${count}`);\n   *\n   * // With custom subgraph\n   * const count = await vana.schemas.count({\n   *   subgraphUrl: 'https://custom-subgraph.com/graphql'\n   * });\n   * ```\n   */\n  async count(options: { subgraphUrl?: string } = {}): Promise<number> {\n    const subgraphUrl = options.subgraphUrl || this.context.subgraphUrl;\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        return await this._countSchemasViaSubgraph({ subgraphUrl });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n      }\n    }\n\n    // Use RPC (as fallback or primary method)\n    try {\n      return await fetchSchemaCountFromChain(this.context);\n    } catch (error) {\n      throw new Error(\n        `Failed to get schemas count: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Lists all schemas with pagination.\n   *\n   * @param options - Optional parameters for listing schemas\n   * @param options.limit - Maximum number of schemas to return\n   * @param options.offset - Number of schemas to skip\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @param options.includeDefinitions - Whether to fetch and include schema definitions (default: false for performance)\n   * @returns Promise resolving to an array of schemas\n   * @example\n   * ```typescript\n   * // Get all schemas (without definitions for performance)\n   * const schemas = await vana.schemas.list();\n   *\n   * // Get schemas with definitions\n   * const schemas = await vana.schemas.list({ includeDefinitions: true });\n   *\n   * // Get schemas with pagination\n   * const schemas = await vana.schemas.list({ limit: 10, offset: 0 });\n   * ```\n   */\n  async list(\n    options: {\n      limit?: number;\n      offset?: number;\n      subgraphUrl?: string;\n      includeDefinitions?: boolean;\n    } = {},\n  ): Promise<Schema[]> {\n    const { limit = 100, offset = 0, includeDefinitions = false } = options;\n    const subgraphUrl = options.subgraphUrl || this.context.subgraphUrl;\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        return await this._listSchemasViaSubgraph({\n          limit,\n          offset,\n          subgraphUrl,\n        });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n      }\n    }\n\n    try {\n      const totalCount = await this.count();\n      const start = offset;\n      const end = Math.min(start + limit, totalCount);\n\n      if (end <= start) {\n        return [];\n      }\n\n      // Get contract address and ABI\n      const chainId = this.context.walletClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      // Build multicall batch for fetching schemas\n      const schemaCalls = [];\n      for (let i = start; i < end; i++) {\n        schemaCalls.push({\n          address: dataRefinerRegistryAddress,\n          abi: dataRefinerRegistryAbi,\n          functionName: \"schemas\",\n          args: [BigInt(i + 1)], // Schema IDs are 1-based\n        } as const);\n      }\n\n      // Fetch all schemas in batches using gasAwareMulticall\n      const schemaResults = await gasAwareMulticall<\n        typeof schemaCalls,\n        true // Allow failures for individual schema lookups\n      >(this.context.publicClient, {\n        contracts: schemaCalls,\n        allowFailure: true,\n      });\n\n      // Process results\n      const schemas: Schema[] = [];\n      schemaResults.forEach((result, index) => {\n        if (result.status === \"success\" && result.result) {\n          const schemaId = start + index + 1; // Schema IDs are 1-based\n          const schemaData = result.result as {\n            name: string;\n            dialect: string;\n            definitionUrl: string;\n          };\n\n          if (\n            schemaData.name &&\n            schemaData.dialect &&\n            schemaData.definitionUrl\n          ) {\n            schemas.push({\n              id: schemaId,\n              name: schemaData.name,\n              dialect: schemaData.dialect as \"json\" | \"sqlite\",\n              definitionUrl: schemaData.definitionUrl,\n            });\n          } else {\n            console.warn(`Incomplete schema data for ID ${schemaId}`);\n          }\n        } else {\n          // Skip schemas that can't be retrieved\n          console.warn(`Failed to retrieve schema ${start + index + 1}`);\n        }\n      });\n\n      // Optionally fetch definitions for all schemas\n      if (includeDefinitions) {\n        await this._fetchDefinitionsForSchemas(schemas);\n      }\n\n      return schemas;\n    } catch (error) {\n      throw new Error(\n        `Failed to list schemas: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Adds a schema using the legacy method (low-level API).\n   *\n   * @deprecated Use create() instead for the high-level API with automatic IPFS upload\n   * @param params - Schema parameters including pre-generated definition URL\n   * @returns Promise resolving to the add schema result\n   */\n  async addSchema(params: AddSchemaParams): Promise<AddSchemaResult> {\n    try {\n      const chainId = this.context.walletClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      const userAddress = await this.getUserAddress();\n\n      const txHash = await this.context.walletClient.writeContract({\n        address: dataRefinerRegistryAddress,\n        abi: dataRefinerRegistryAbi,\n        functionName: \"addSchema\",\n        args: [params.name, params.dialect, params.definitionUrl],\n        account: this.context.walletClient.account || userAddress,\n        chain: this.context.walletClient.chain || null,\n      });\n\n      // Wait for transaction confirmation and parse events\n      const receipt = await this.context.publicClient.waitForTransactionReceipt(\n        {\n          hash: txHash,\n          confirmations: 1,\n        },\n      );\n\n      // Parse the SchemaAdded event to get the schema ID\n      const { parseSchemaAddedEvent } = await import(\"../utils/eventParsing\");\n      const eventData = parseSchemaAddedEvent(receipt);\n\n      return {\n        schemaId: Number(eventData.schemaId),\n        transactionHash: txHash,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to add schema: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Internal method: Query schema via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.schemaId - The ID of the schema to retrieve\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to the schema object\n   * @private\n   */\n  private async _getSchemaViaSubgraph(params: {\n    schemaId: number;\n    subgraphUrl: string;\n  }): Promise<SchemaMetadata> {\n    const { schemaId, subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(GetSchemaDocument),\n        variables: { id: schemaId.toString() },\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Subgraph request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    const result = (await response.json()) as {\n      data?: GetSchemaQuery;\n      errors?: { message: string }[];\n    };\n\n    if (result.errors) {\n      throw new Error(\n        `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    if (!result.data?.schema) {\n      throw new Error(`Schema ${schemaId} not found in subgraph`);\n    }\n\n    // Map subgraph schema to SDK schema type\n    const subgraphSchema = result.data.schema;\n    return {\n      id: parseInt(subgraphSchema.id),\n      name: subgraphSchema.name,\n      dialect: subgraphSchema.dialect as \"json\" | \"sqlite\",\n      definitionUrl: subgraphSchema.definitionUrl,\n    };\n  }\n\n  /**\n   * Internal method: List schemas via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.limit - Maximum number of schemas to return\n   * @param params.offset - Number of schemas to skip\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to an array of schemas\n   * @private\n   */\n  private async _listSchemasViaSubgraph(params: {\n    limit: number;\n    offset: number;\n    subgraphUrl: string;\n  }): Promise<Schema[]> {\n    const { limit, offset, subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(ListSchemasDocument),\n        variables: { first: limit, skip: offset },\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Subgraph request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    const result = (await response.json()) as {\n      data?: ListSchemasQuery;\n      errors?: { message: string }[];\n    };\n\n    if (result.errors) {\n      throw new Error(\n        `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    if (!result.data?.schemas) {\n      return [];\n    }\n\n    // Map subgraph schemas to SDK schema type\n    const schemas = result.data.schemas.map((schema) => ({\n      id: parseInt(schema.id),\n      name: schema.name,\n      dialect: schema.dialect as \"json\" | \"sqlite\",\n      definitionUrl: schema.definitionUrl,\n    }));\n\n    // Optionally fetch definitions if requested\n    const includeDefinitions = (params as { includeDefinitions?: boolean })\n      .includeDefinitions;\n    if (includeDefinitions) {\n      await this._fetchDefinitionsForSchemas(schemas);\n    }\n\n    return schemas;\n  }\n\n  /**\n   * Internal method: Count schemas via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to the total schema count\n   * @private\n   */\n  private async _countSchemasViaSubgraph(params: {\n    subgraphUrl: string;\n  }): Promise<number> {\n    const { subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(CountSchemasDocument),\n        variables: {},\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Subgraph request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    const result = (await response.json()) as {\n      data?: CountSchemasQuery;\n      errors?: { message: string }[];\n    };\n\n    if (result.errors) {\n      throw new Error(\n        `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    return result.data?.schemas?.length || 0;\n  }\n\n  /**\n   * Gets the user's wallet address.\n   *\n   * @private\n   * @returns Promise resolving to the user's address\n   */\n  private async getUserAddress(): Promise<Address> {\n    if (!this.context.walletClient.account) {\n      throw new Error(\"No wallet account connected\");\n    }\n\n    // Return the account address directly if available\n    if (typeof this.context.walletClient.account === \"string\") {\n      return this.context.walletClient.account as Address;\n    }\n\n    // If account is an object, get the address property\n    if (\n      typeof this.context.walletClient.account === \"object\" &&\n      this.context.walletClient.account.address\n    ) {\n      return this.context.walletClient.account.address;\n    }\n\n    throw new Error(\"Unable to determine wallet address\");\n  }\n\n  /**\n   * Fetches and attaches definitions to an array of schemas.\n   *\n   * @param schemas - Array of schemas to fetch definitions for\n   * @private\n   */\n  private async _fetchDefinitionsForSchemas(schemas: Schema[]): Promise<void> {\n    // Fetch definitions concurrently for performance\n    await Promise.all(\n      schemas.map(async (schema) => {\n        if (!schema.definitionUrl) return;\n\n        try {\n          const definition = await fetchFromUrl(\n            schema.definitionUrl,\n            this.context.downloadRelayer,\n          );\n\n          if (definition && typeof definition === \"object\") {\n            // Validate the fetched DataSchema\n            validateDataSchemaAgainstMetaSchema(definition);\n            const dataSchema = definition as DataSchema;\n\n            // Populate flat fields\n            schema.version = dataSchema.version;\n            schema.description = dataSchema.description;\n            schema.schema = dataSchema.schema;\n          }\n        } catch (error) {\n          // Don't fail the entire list operation if one definition fails\n          console.error(\n            `Failed to fetch/validate definition for schema ${schema.id}:`,\n            error instanceof UrlResolutionError ||\n              error instanceof SchemaValidationError\n              ? error.message\n              : error,\n          );\n        }\n      }),\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AASA,uBAAmC;AACnC,iBAAuB;AACvB,uBAAkC;AAClC,8BAIO;AACP,sBAGO;AACP,sBAOO;AACP,qBAAsB;AACtB,yBAAiD;AAkF1C,MAAM,iBAAiB;AAAA,EAC5B,YAA6B,SAA4B;AAA5B;AAAA,EAA6B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuC1D,MAAM,OAAO,QAAyD;AACpE,UAAM,EAAE,MAAM,SAAS,OAAO,IAAI;AAElC,QAAI;AAEF,UAAI;AACJ,UAAI,OAAO,WAAW,UAAU;AAC9B,YAAI;AACF,6BAAmB,KAAK,MAAM,MAAM;AAAA,QACtC,QAAQ;AACN,gBAAM,IAAI;AAAA,YACR;AAAA,YACA,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MACF,OAAO;AACL,2BAAmB;AAAA,MACrB;AAGA,YAAM,aAAyB;AAAA,QAC7B;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA,QAAQ;AAAA,MACV;AAEA,uEAAoC,UAAU;AAG9C,UAAI,CAAC,KAAK,QAAQ,gBAAgB;AAEhC,YAAI,KAAK,QAAQ,yBAAyB;AACxC,eAAK,QAAQ,wBAAwB;AAGrC,gBAAM,IAAI,MAAM,2BAA2B;AAAA,QAC7C,OAAO;AACL,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAEA,YAAM,aAAa,IAAI,KAAK,CAAC,KAAK,UAAU,UAAU,CAAC,GAAG;AAAA,QACxD,MAAM;AAAA,MACR,CAAC;AAED,YAAM,eAAe,MAAM,KAAK,QAAQ,eAAe;AAAA,QACrD;AAAA,QACA,GAAG,KAAK,QAAQ,iBAAiB,GAAG,CAAC;AAAA,QACrC;AAAA;AAAA,MACF;AAGA,YAAM,UAAU,KAAK,QAAQ,aAAa,OAAO;AACjD,UAAI,CAAC,SAAS;AACZ,cAAM,IAAI,MAAM,wBAAwB;AAAA,MAC1C;AAEA,YAAM,iCAA6B;AAAA,QACjC;AAAA,QACA;AAAA,MACF;AACA,YAAM,6BAAyB,mBAAO,qBAAqB;AAE3D,YAAM,cAAc,MAAM,KAAK,eAAe;AAE9C,YAAM,SAAS,MAAM,KAAK,QAAQ,aAAa,cAAc;AAAA,QAC3D,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,MAAM,SAAS,aAAa,GAAG;AAAA,QACtC,SAAS,KAAK,QAAQ,aAAa,WAAW;AAAA,QAC9C,OAAO,KAAK,QAAQ,aAAa,SAAS;AAAA,MAC5C,CAAC;AAGD,YAAM,UAAU,MAAM,KAAK,QAAQ,aAAa;AAAA,QAC9C;AAAA,UACE,MAAM;AAAA,UACN,eAAe;AAAA,QACjB;AAAA,MACF;AAGA,YAAM,EAAE,sBAAsB,IAAI,MAAM,OAAO,uBAAuB;AACtE,YAAM,YAAY,sBAAsB,OAAO;AAE/C,aAAO;AAAA,QACL,UAAU,OAAO,UAAU,QAAQ;AAAA,QACnC,eAAe,aAAa;AAAA,QAC5B,iBAAiB;AAAA,MACnB;AAAA,IACF,SAAS,OAAO;AACd,UAAI,iBAAiB,+CAAuB;AAC1C,cAAM;AAAA,MACR;AACA,YAAM,IAAI;AAAA,QACR,2BAA2B,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,MACrF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,MAAM,IACJ,UACA,UAAoC,CAAC,GACZ;AACzB,UAAM,cAAc,QAAQ,eAAe,KAAK,QAAQ;AAExD,QAAI;AAGJ,QAAI,aAAa;AACf,UAAI;AACF,mBAAW,MAAM,KAAK,sBAAsB,EAAE,UAAU,YAAY,CAAC;AAAA,MACvE,SAAS,OAAO;AACd,gBAAQ,MAAM,+CAA+C,KAAK;AAElE,YAAI;AACF,qBAAW,UAAM,sCAAqB,KAAK,SAAS,QAAQ;AAAA,QAC9D,SAAS,UAAU;AACjB,gBAAM,IAAI;AAAA,YACR,yBAAyB,oBAAoB,QAAQ,SAAS,UAAU,eAAe;AAAA,UACzF;AAAA,QACF;AAAA,MACF;AAAA,IACF,OAAO;AAEL,UAAI;AACF,mBAAW,UAAM,sCAAqB,KAAK,SAAS,QAAQ;AAAA,MAC9D,SAAS,OAAO;AACd,cAAM,IAAI;AAAA,UACR,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,QACnF;AAAA,MACF;AAAA,IACF;AAGA,UAAM,aAAa,UAAM;AAAA,MACvB,SAAS;AAAA,MACT,KAAK,QAAQ;AAAA,IACf;AAEA,QAAI,CAAC,cAAc,OAAO,eAAe,UAAU;AACjD,YAAM,IAAI;AAAA,QACR,+CAA+C,QAAQ;AAAA,MACzD;AAAA,IACF;AAGA,qEAAoC,UAAU;AAC9C,UAAM,aAAa;AAGnB,QAAI,WAAW,SAAS,SAAS,MAAM;AACrC,YAAM,IAAI;AAAA,QACR,mCAAmC,SAAS,IAAI,gBAAgB,WAAW,IAAI;AAAA,MACjF;AAAA,IACF;AACA,QAAI,WAAW,YAAY,SAAS,SAAS;AAC3C,YAAM,IAAI;AAAA,QACR,sCAAsC,SAAS,OAAO,gBAAgB,WAAW,OAAO;AAAA,MAC1F;AAAA,IACF;AAGA,WAAO;AAAA,MACL,GAAG;AAAA,MACH,SAAS,WAAW;AAAA,MACpB,aAAa,WAAW;AAAA,MACxB,QAAQ,WAAW;AAAA,IACrB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,MAAM,MAAM,UAAoC,CAAC,GAAoB;AACnE,UAAM,cAAc,QAAQ,eAAe,KAAK,QAAQ;AAGxD,QAAI,aAAa;AACf,UAAI;AACF,eAAO,MAAM,KAAK,yBAAyB,EAAE,YAAY,CAAC;AAAA,MAC5D,SAAS,OAAO;AACd,gBAAQ,MAAM,+CAA+C,KAAK;AAAA,MAEpE;AAAA,IACF;AAGA,QAAI;AACF,aAAO,UAAM,2CAA0B,KAAK,OAAO;AAAA,IACrD,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,gCAAgC,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,MAC1F;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAuBA,MAAM,KACJ,UAKI,CAAC,GACc;AACnB,UAAM,EAAE,QAAQ,KAAK,SAAS,GAAG,qBAAqB,MAAM,IAAI;AAChE,UAAM,cAAc,QAAQ,eAAe,KAAK,QAAQ;AAGxD,QAAI,aAAa;AACf,UAAI;AACF,eAAO,MAAM,KAAK,wBAAwB;AAAA,UACxC;AAAA,UACA;AAAA,UACA;AAAA,QACF,CAAC;AAAA,MACH,SAAS,OAAO;AACd,gBAAQ,MAAM,+CAA+C,KAAK;AAAA,MAEpE;AAAA,IACF;AAEA,QAAI;AACF,YAAM,aAAa,MAAM,KAAK,MAAM;AACpC,YAAM,QAAQ;AACd,YAAM,MAAM,KAAK,IAAI,QAAQ,OAAO,UAAU;AAE9C,UAAI,OAAO,OAAO;AAChB,eAAO,CAAC;AAAA,MACV;AAGA,YAAM,UAAU,KAAK,QAAQ,aAAa,OAAO;AACjD,UAAI,CAAC,SAAS;AACZ,cAAM,IAAI,MAAM,wBAAwB;AAAA,MAC1C;AACA,YAAM,iCAA6B;AAAA,QACjC;AAAA,QACA;AAAA,MACF;AACA,YAAM,6BAAyB,mBAAO,qBAAqB;AAG3D,YAAM,cAAc,CAAC;AACrB,eAAS,IAAI,OAAO,IAAI,KAAK,KAAK;AAChC,oBAAY,KAAK;AAAA,UACf,SAAS;AAAA,UACT,KAAK;AAAA,UACL,cAAc;AAAA,UACd,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC;AAAA;AAAA,QACtB,CAAU;AAAA,MACZ;AAGA,YAAM,gBAAgB,UAAM,oCAG1B,KAAK,QAAQ,cAAc;AAAA,QAC3B,WAAW;AAAA,QACX,cAAc;AAAA,MAChB,CAAC;AAGD,YAAM,UAAoB,CAAC;AAC3B,oBAAc,QAAQ,CAAC,QAAQ,UAAU;AACvC,YAAI,OAAO,WAAW,aAAa,OAAO,QAAQ;AAChD,gBAAM,WAAW,QAAQ,QAAQ;AACjC,gBAAM,aAAa,OAAO;AAM1B,cACE,WAAW,QACX,WAAW,WACX,WAAW,eACX;AACA,oBAAQ,KAAK;AAAA,cACX,IAAI;AAAA,cACJ,MAAM,WAAW;AAAA,cACjB,SAAS,WAAW;AAAA,cACpB,eAAe,WAAW;AAAA,YAC5B,CAAC;AAAA,UACH,OAAO;AACL,oBAAQ,KAAK,iCAAiC,QAAQ,EAAE;AAAA,UAC1D;AAAA,QACF,OAAO;AAEL,kBAAQ,KAAK,6BAA6B,QAAQ,QAAQ,CAAC,EAAE;AAAA,QAC/D;AAAA,MACF,CAAC;AAGD,UAAI,oBAAoB;AACtB,cAAM,KAAK,4BAA4B,OAAO;AAAA,MAChD;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,2BAA2B,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,MACrF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,UAAU,QAAmD;AACjE,QAAI;AACF,YAAM,UAAU,KAAK,QAAQ,aAAa,OAAO;AACjD,UAAI,CAAC,SAAS;AACZ,cAAM,IAAI,MAAM,wBAAwB;AAAA,MAC1C;AAEA,YAAM,iCAA6B;AAAA,QACjC;AAAA,QACA;AAAA,MACF;AACA,YAAM,6BAAyB,mBAAO,qBAAqB;AAE3D,YAAM,cAAc,MAAM,KAAK,eAAe;AAE9C,YAAM,SAAS,MAAM,KAAK,QAAQ,aAAa,cAAc;AAAA,QAC3D,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,OAAO,MAAM,OAAO,SAAS,OAAO,aAAa;AAAA,QACxD,SAAS,KAAK,QAAQ,aAAa,WAAW;AAAA,QAC9C,OAAO,KAAK,QAAQ,aAAa,SAAS;AAAA,MAC5C,CAAC;AAGD,YAAM,UAAU,MAAM,KAAK,QAAQ,aAAa;AAAA,QAC9C;AAAA,UACE,MAAM;AAAA,UACN,eAAe;AAAA,QACjB;AAAA,MACF;AAGA,YAAM,EAAE,sBAAsB,IAAI,MAAM,OAAO,uBAAuB;AACtE,YAAM,YAAY,sBAAsB,OAAO;AAE/C,aAAO;AAAA,QACL,UAAU,OAAO,UAAU,QAAQ;AAAA,QACnC,iBAAiB;AAAA,MACnB;AAAA,IACF,SAAS,OAAO;AACd,YAAM,IAAI;AAAA,QACR,yBAAyB,iBAAiB,QAAQ,MAAM,UAAU,eAAe;AAAA,MACnF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAc,sBAAsB,QAGR;AAC1B,UAAM,EAAE,UAAU,YAAY,IAAI;AAElC,UAAM,WAAW,MAAM,MAAM,aAAa;AAAA,MACxC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU;AAAA,QACnB,WAAO,sBAAM,iCAAiB;AAAA,QAC9B,WAAW,EAAE,IAAI,SAAS,SAAS,EAAE;AAAA,MACvC,CAAC;AAAA,IACH,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI;AAAA,QACR,4BAA4B,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,MACpE;AAAA,IACF;AAEA,UAAM,SAAU,MAAM,SAAS,KAAK;AAKpC,QAAI,OAAO,QAAQ;AACjB,YAAM,IAAI;AAAA,QACR,0BAA0B,OAAO,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,MAC1E;AAAA,IACF;AAEA,QAAI,CAAC,OAAO,MAAM,QAAQ;AACxB,YAAM,IAAI,MAAM,UAAU,QAAQ,wBAAwB;AAAA,IAC5D;AAGA,UAAM,iBAAiB,OAAO,KAAK;AACnC,WAAO;AAAA,MACL,IAAI,SAAS,eAAe,EAAE;AAAA,MAC9B,MAAM,eAAe;AAAA,MACrB,SAAS,eAAe;AAAA,MACxB,eAAe,eAAe;AAAA,IAChC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAc,wBAAwB,QAIhB;AACpB,UAAM,EAAE,OAAO,QAAQ,YAAY,IAAI;AAEvC,UAAM,WAAW,MAAM,MAAM,aAAa;AAAA,MACxC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU;AAAA,QACnB,WAAO,sBAAM,mCAAmB;AAAA,QAChC,WAAW,EAAE,OAAO,OAAO,MAAM,OAAO;AAAA,MAC1C,CAAC;AAAA,IACH,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI;AAAA,QACR,4BAA4B,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,MACpE;AAAA,IACF;AAEA,UAAM,SAAU,MAAM,SAAS,KAAK;AAKpC,QAAI,OAAO,QAAQ;AACjB,YAAM,IAAI;AAAA,QACR,0BAA0B,OAAO,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,MAC1E;AAAA,IACF;AAEA,QAAI,CAAC,OAAO,MAAM,SAAS;AACzB,aAAO,CAAC;AAAA,IACV;AAGA,UAAM,UAAU,OAAO,KAAK,QAAQ,IAAI,CAAC,YAAY;AAAA,MACnD,IAAI,SAAS,OAAO,EAAE;AAAA,MACtB,MAAM,OAAO;AAAA,MACb,SAAS,OAAO;AAAA,MAChB,eAAe,OAAO;AAAA,IACxB,EAAE;AAGF,UAAM,qBAAsB,OACzB;AACH,QAAI,oBAAoB;AACtB,YAAM,KAAK,4BAA4B,OAAO;AAAA,IAChD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAc,yBAAyB,QAEnB;AAClB,UAAM,EAAE,YAAY,IAAI;AAExB,UAAM,WAAW,MAAM,MAAM,aAAa;AAAA,MACxC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU;AAAA,QACnB,WAAO,sBAAM,oCAAoB;AAAA,QACjC,WAAW,CAAC;AAAA,MACd,CAAC;AAAA,IACH,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI;AAAA,QACR,4BAA4B,SAAS,MAAM,IAAI,SAAS,UAAU;AAAA,MACpE;AAAA,IACF;AAEA,UAAM,SAAU,MAAM,SAAS,KAAK;AAKpC,QAAI,OAAO,QAAQ;AACjB,YAAM,IAAI;AAAA,QACR,0BAA0B,OAAO,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAAA,MAC1E;AAAA,IACF;AAEA,WAAO,OAAO,MAAM,SAAS,UAAU;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAc,iBAAmC;AAC/C,QAAI,CAAC,KAAK,QAAQ,aAAa,SAAS;AACtC,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AAGA,QAAI,OAAO,KAAK,QAAQ,aAAa,YAAY,UAAU;AACzD,aAAO,KAAK,QAAQ,aAAa;AAAA,IACnC;AAGA,QACE,OAAO,KAAK,QAAQ,aAAa,YAAY,YAC7C,KAAK,QAAQ,aAAa,QAAQ,SAClC;AACA,aAAO,KAAK,QAAQ,aAAa,QAAQ;AAAA,IAC3C;AAEA,UAAM,IAAI,MAAM,oCAAoC;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAc,4BAA4B,SAAkC;AAE1E,UAAM,QAAQ;AAAA,MACZ,QAAQ,IAAI,OAAO,WAAW;AAC5B,YAAI,CAAC,OAAO,cAAe;AAE3B,YAAI;AACF,gBAAM,aAAa,UAAM;AAAA,YACvB,OAAO;AAAA,YACP,KAAK,QAAQ;AAAA,UACf;AAEA,cAAI,cAAc,OAAO,eAAe,UAAU;AAEhD,6EAAoC,UAAU;AAC9C,kBAAM,aAAa;AAGnB,mBAAO,UAAU,WAAW;AAC5B,mBAAO,cAAc,WAAW;AAChC,mBAAO,SAAS,WAAW;AAAA,UAC7B;AAAA,QACF,SAAS,OAAO;AAEd,kBAAQ;AAAA,YACN,kDAAkD,OAAO,EAAE;AAAA,YAC3D,iBAAiB,yCACf,iBAAiB,gDACf,MAAM,UACN;AAAA,UACN;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/controllers/schemas.ts"],"sourcesContent":["import type {\n  Schema,\n  SchemaMetadata,\n  CompleteSchema,\n  AddSchemaParams,\n} from \"../types/index\";\n// import type { TransactionResult } from \"../types/operations\";\nimport type { SchemaAddedResult } from \"../types/transactionResults\";\nimport type { ControllerContext } from \"./permissions\";\nimport { BaseController } from \"./base\";\nimport { getContractAddress } from \"../config/addresses\";\nimport { getAbi } from \"../generated/abi\";\nimport { gasAwareMulticall } from \"../utils/multicall\";\nimport {\n  validateDataSchemaAgainstMetaSchema,\n  SchemaValidationError,\n  type DataSchema,\n} from \"../utils/schemaValidation\";\nimport {\n  fetchSchemaFromChain,\n  fetchSchemaCountFromChain,\n} from \"../utils/blockchain/registry\";\nimport {\n  GetSchemaDocument,\n  ListSchemasDocument,\n  CountSchemasDocument,\n  type GetSchemaQuery,\n  type ListSchemasQuery,\n  type CountSchemasQuery,\n} from \"../generated/subgraph\";\nimport { print } from \"graphql\";\nimport { fetchFromUrl, UrlResolutionError } from \"../utils/urlResolver\";\n\n/**\n * Parameters for creating a new schema with automatic IPFS upload.\n *\n * @remarks\n * This interface is used with the high-level `schemas.create()` method which\n * automatically uploads the schema definition to IPFS and registers it on-chain.\n * @category Schema Management\n */\nexport interface CreateSchemaParams {\n  /** The name of the schema */\n  name: string;\n  /** The dialect of the schema (e.g., 'json' or 'sqlite') */\n  dialect: \"json\" | \"sqlite\";\n  /** The schema definition object or JSON string */\n  schema: object | string;\n}\n\n/**\n * Result of creating a new schema.\n *\n * @remarks\n * Returned by the `schemas.create()` method after successful upload and registration.\n * @category Schema Management\n */\nexport interface CreateSchemaResult {\n  /** The schema ID assigned by the contract */\n  schemaId: bigint;\n  /** The IPFS URL where the schema definition is stored */\n  definitionUrl: string;\n  /** The transaction hash of the schema registration */\n  transactionHash: string;\n}\n\n/**\n * Manages data schemas and refiners on the Vana network.\n *\n * @remarks\n * This controller handles the complete lifecycle of data schemas including creation,\n * validation, IPFS upload, and blockchain registration. It provides methods for managing\n * both schemas (data structure definitions) and refiners (data processing definitions).\n *\n * **Schema Storage:**\n * Schemas are stored unencrypted on IPFS for public access and reusability across the network.\n * Schema definitions use JSON Schema format for data validation and structure definition.\n *\n * **Method Selection:**\n * - `create()` validates, uploads to IPFS, and registers new schemas on blockchain\n * - `get()` retrieves existing schema metadata by ID from blockchain contracts\n * - `count()` returns total number of registered schemas for pagination\n * - `list()` provides paginated access to all schemas with optional filtering\n * - `addSchema()` provides lower-level schema registration with pre-uploaded URLs\n *\n * **Storage Requirements:**\n * Methods requiring storage configuration: `create()`\n * Methods working without storage: `get()`, `count()`, `list()`, `addSchema()`\n *\n * @example\n * ```typescript\n * // Create a new schema with automatic IPFS upload\n * const result = await vana.schemas.create({\n *   name: \"User Profile\",\n *   dialect: \"json\",\n *   schema: {\n *     type: \"object\",\n *     properties: {\n *       name: { type: \"string\" },\n *       age: { type: \"number\" }\n *     },\n *     required: [\"name\"]\n *   }\n * });\n *\n * // Get an existing schema\n * const schema = await vana.schemas.get(1);\n *\n * // List all schemas\n * const count = await vana.schemas.count();\n * ```\n * @category Schema Management\n */\nexport class SchemaController extends BaseController {\n  constructor(context: ControllerContext) {\n    super(context);\n  }\n\n  /**\n   * Creates a new schema with automatic validation and IPFS upload.\n   *\n   * @remarks\n   * This is the primary method for creating schemas on the Vana network. It handles\n   * the complete workflow including schema validation, IPFS upload, and blockchain\n   * registration. The schema definition is stored unencrypted on IPFS to enable\n   * public access and reusability.\n   *\n   * The method automatically:\n   * - Validates the schema definition against the Vana metaschema\n   * - Uploads the definition to IPFS to generate a permanent URL\n   * - Registers the schema on the blockchain with the generated URL\n   *\n   * @param params - Schema creation parameters including name, dialect, and definition\n   * @returns Promise resolving to creation results with schema ID and transaction hash\n   * @throws {SchemaValidationError} When the schema definition is invalid\n   * @throws {Error} When IPFS upload or blockchain registration fails\n   * @example\n   * ```typescript\n   * // Create a JSON schema for user profiles\n   * const result = await vana.schemas.create({\n   *   name: \"User Profile\",\n   *   dialect: \"json\",\n   *   schema: {\n   *     type: \"object\",\n   *     properties: {\n   *       name: { type: \"string\" },\n   *       age: { type: \"number\", minimum: 0 }\n   *     },\n   *     required: [\"name\"]\n   *   }\n   * });\n   *\n   * console.log(`Schema created with ID: ${result.schemaId}`);\n   * ```\n   */\n  async create(params: CreateSchemaParams): Promise<CreateSchemaResult> {\n    this.assertWallet();\n    const { name, dialect, schema } = params;\n\n    try {\n      // Step 1: Normalize and validate the schema definition\n      let schemaDefinition: object;\n      if (typeof schema === \"string\") {\n        try {\n          schemaDefinition = JSON.parse(schema);\n        } catch {\n          throw new SchemaValidationError(\n            \"Invalid JSON in schema definition\",\n            [],\n          );\n        }\n      } else {\n        schemaDefinition = schema;\n      }\n\n      // Step 2: Validate against metaschema\n      const dataSchema: DataSchema = {\n        name,\n        version: \"1.0.0\",\n        dialect,\n        schema: schemaDefinition,\n      };\n\n      validateDataSchemaAgainstMetaSchema(dataSchema);\n\n      // Step 3: Upload to IPFS (unencrypted for public access)\n      if (!this.context.storageManager) {\n        // Use centralized validation if available, otherwise fall back to old behavior\n        if (this.context.validateStorageRequired) {\n          this.context.validateStorageRequired();\n          // The validateStorageRequired method throws, so this line should never be reached\n          // but TypeScript doesn't know that, so we need this fallback\n          throw new Error(\"Storage validation failed\");\n        } else {\n          throw new Error(\n            \"Storage manager not configured. Please provide storage providers in VanaConfig.\",\n          );\n        }\n      }\n\n      const schemaBlob = new Blob([JSON.stringify(dataSchema)], {\n        type: \"application/json\",\n      });\n\n      const uploadResult = await this.context.storageManager.upload(\n        schemaBlob,\n        `${name.replace(/[^a-zA-Z0-9]/g, \"_\")}.json`,\n        \"ipfs\", // Use IPFS for public schema storage\n      );\n\n      // Step 4: Register on blockchain\n      const chainId =\n        this.context.walletClient?.chain?.id ??\n        this.context.publicClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      const account = this.context.walletClient.account;\n      const from = typeof account === \"string\" ? account : account?.address;\n\n      const hash = await this.context.walletClient.writeContract({\n        address: dataRefinerRegistryAddress,\n        abi: dataRefinerRegistryAbi,\n        functionName: \"addSchema\",\n        args: [name, dialect, uploadResult.url],\n        account: account ?? null,\n        chain: this.context.walletClient.chain ?? null,\n      });\n\n      const { tx } = await import(\"../utils/transactionHelpers\");\n      const txResult = tx({\n        hash,\n        from: from!,\n        contract: \"DataRefinerRegistry\",\n        fn: \"addSchema\",\n      });\n\n      // Wait for events and extract domain data\n      if (!this.context.waitForTransactionEvents) {\n        throw new Error(\"waitForTransactionEvents not configured\");\n      }\n\n      const result = await this.context.waitForTransactionEvents(txResult);\n      const event = result.expectedEvents.SchemaAdded;\n      if (!event) {\n        throw new Error(\"SchemaAdded event not found in transaction\");\n      }\n\n      return {\n        schemaId: event.schemaId,\n        definitionUrl: uploadResult.url,\n        transactionHash: hash,\n      };\n    } catch (error) {\n      if (error instanceof SchemaValidationError) {\n        throw error;\n      }\n      throw new Error(\n        `Schema creation failed: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Retrieves a complete schema by its ID with definition fetched and flattened.\n   *\n   * @param schemaId - The ID of the schema to retrieve\n   * @param options - Optional parameters\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @returns Promise resolving to the complete schema object with all fields populated\n   * @throws {Error} When the schema is not found, definition cannot be fetched, or chain is unavailable\n   * @example\n   * ```typescript\n   * const schema = await vana.schemas.get(1);\n   * console.log(`Schema: ${schema.name} (${schema.dialect})`);\n   * console.log(`Version: ${schema.version}`);\n   * console.log(`Description: ${schema.description}`);\n   * console.log('Schema:', schema.schema);\n   *\n   * // Use directly with validator (schema has all required fields)\n   * validator.validateDataAgainstSchema(data, schema);\n   * ```\n   */\n  async get(\n    schemaId: number,\n    options: { subgraphUrl?: string } = {},\n  ): Promise<CompleteSchema> {\n    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;\n\n    let metadata: SchemaMetadata;\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        metadata = await this._getSchemaViaSubgraph({ schemaId, subgraphUrl });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n        try {\n          metadata = await fetchSchemaFromChain(this.context, schemaId);\n        } catch (rpcError) {\n          throw new Error(\n            `Failed to get schema: ${rpcError instanceof Error ? rpcError.message : \"Unknown error\"}`,\n          );\n        }\n      }\n    } else {\n      // Use RPC directly\n      try {\n        metadata = await fetchSchemaFromChain(this.context, schemaId);\n      } catch (error) {\n        throw new Error(\n          `Failed to get schema: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n        );\n      }\n    }\n\n    // Fetch the definition (should be a complete DataSchema)\n    const definition = await fetchFromUrl(\n      metadata.definitionUrl,\n      this.context.downloadRelayer,\n    );\n\n    if (!definition || typeof definition !== \"object\") {\n      throw new Error(\n        `Invalid schema definition format for schema ${schemaId}`,\n      );\n    }\n\n    // Validate the fetched DataSchema\n    validateDataSchemaAgainstMetaSchema(definition);\n    const dataSchema = definition as DataSchema;\n\n    // Verify on-chain and off-chain data match\n    if (dataSchema.name !== metadata.name) {\n      console.warn(\n        `Schema name mismatch for ID ${schemaId}: on-chain=\"${metadata.name}\" off-chain=\"${dataSchema.name}\" (using on-chain value)`,\n      );\n    }\n    if (dataSchema.dialect !== metadata.dialect) {\n      console.warn(\n        `Schema dialect mismatch for ID ${schemaId}: on-chain=\"${metadata.dialect}\" off-chain=\"${dataSchema.dialect}\" (using on-chain value)`,\n      );\n    }\n\n    // Return using on-chain values as authoritative source\n    return {\n      ...metadata,\n      version: dataSchema.version,\n      description: dataSchema.description,\n      schema: dataSchema.schema,\n    };\n  }\n\n  /**\n   * Gets the total number of schemas registered on the network.\n   *\n   * @param options - Optional parameters\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @returns Promise resolving to the total schema count\n   * @throws {Error} When the count cannot be retrieved\n   * @example\n   * ```typescript\n   * const count = await vana.schemas.count();\n   * console.log(`Total schemas: ${count}`);\n   *\n   * // With custom subgraph\n   * const count = await vana.schemas.count({\n   *   subgraphUrl: 'https://custom-subgraph.com/graphql'\n   * });\n   * ```\n   */\n  async count(options: { subgraphUrl?: string } = {}): Promise<number> {\n    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        return await this._countSchemasViaSubgraph({ subgraphUrl });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n      }\n    }\n\n    // Use RPC (as fallback or primary method)\n    try {\n      return await fetchSchemaCountFromChain(this.context);\n    } catch (error) {\n      throw new Error(\n        `Failed to get schemas count: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Lists all schemas with pagination.\n   *\n   * @param options - Optional parameters for listing schemas\n   * @param options.limit - Maximum number of schemas to return\n   * @param options.offset - Number of schemas to skip\n   * @param options.subgraphUrl - Custom subgraph URL to use instead of default\n   * @param options.includeDefinitions - Whether to fetch and include schema definitions (default: false for performance)\n   * @returns Promise resolving to an array of schemas\n   * @example\n   * ```typescript\n   * // Get all schemas (without definitions for performance)\n   * const schemas = await vana.schemas.list();\n   *\n   * // Get schemas with definitions\n   * const schemas = await vana.schemas.list({ includeDefinitions: true });\n   *\n   * // Get schemas with pagination\n   * const schemas = await vana.schemas.list({ limit: 10, offset: 0 });\n   * ```\n   */\n  async list(\n    options: {\n      limit?: number;\n      offset?: number;\n      subgraphUrl?: string;\n      includeDefinitions?: boolean;\n    } = {},\n  ): Promise<Schema[]> {\n    const { limit = 100, offset = 0, includeDefinitions = false } = options;\n    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;\n\n    // Try subgraph first if available\n    if (subgraphUrl) {\n      try {\n        return await this._listSchemasViaSubgraph({\n          limit,\n          offset,\n          subgraphUrl,\n        });\n      } catch (error) {\n        console.debug(\"Subgraph query failed, falling back to RPC:\", error);\n        // Fall through to RPC\n      }\n    }\n\n    try {\n      const totalCount = await this.count();\n      const start = offset;\n      const end = Math.min(start + limit, totalCount);\n\n      if (end <= start) {\n        return [];\n      }\n\n      // Get contract address and ABI\n      const chainId =\n        this.context.walletClient?.chain?.id ??\n        this.context.publicClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      // Build multicall batch for fetching schemas\n      const schemaCalls = [];\n      for (let i = start; i < end; i++) {\n        schemaCalls.push({\n          address: dataRefinerRegistryAddress,\n          abi: dataRefinerRegistryAbi,\n          functionName: \"schemas\",\n          args: [BigInt(i + 1)], // Schema IDs are 1-based\n        } as const);\n      }\n\n      // Fetch all schemas in batches using gasAwareMulticall\n      const schemaResults = await gasAwareMulticall<\n        typeof schemaCalls,\n        true // Allow failures for individual schema lookups\n      >(this.context.publicClient, {\n        contracts: schemaCalls,\n        allowFailure: true,\n      });\n\n      // Process results\n      const schemas: Schema[] = [];\n      schemaResults.forEach((result, index) => {\n        if (result.status === \"success\" && result.result) {\n          const schemaId = start + index + 1; // Schema IDs are 1-based\n          const schemaData = result.result as {\n            name: string;\n            dialect: string;\n            definitionUrl: string;\n          };\n\n          if (\n            schemaData.name &&\n            schemaData.dialect &&\n            schemaData.definitionUrl\n          ) {\n            schemas.push({\n              id: schemaId,\n              name: schemaData.name,\n              dialect: schemaData.dialect as \"json\" | \"sqlite\",\n              definitionUrl: schemaData.definitionUrl,\n            });\n          } else {\n            console.warn(`Incomplete schema data for ID ${schemaId}`);\n          }\n        } else {\n          // Skip schemas that can't be retrieved\n          console.warn(`Failed to retrieve schema ${start + index + 1}`);\n        }\n      });\n\n      // Optionally fetch definitions for all schemas\n      if (includeDefinitions) {\n        await this._fetchDefinitionsForSchemas(schemas);\n      }\n\n      return schemas;\n    } catch (error) {\n      throw new Error(\n        `Failed to list schemas: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Adds a schema using the legacy method (low-level API).\n   *\n   * @deprecated Use create() instead for the high-level API with automatic IPFS upload\n   * @param params - Schema parameters including pre-generated definition URL\n   * @returns Promise resolving to the add schema result\n   */\n  async addSchema(params: AddSchemaParams): Promise<SchemaAddedResult> {\n    this.assertWallet();\n    try {\n      const chainId =\n        this.context.walletClient?.chain?.id ??\n        this.context.publicClient.chain?.id;\n      if (!chainId) {\n        throw new Error(\"Chain ID not available\");\n      }\n\n      const dataRefinerRegistryAddress = getContractAddress(\n        chainId,\n        \"DataRefinerRegistry\",\n      );\n      const dataRefinerRegistryAbi = getAbi(\"DataRefinerRegistry\");\n\n      const account = this.context.walletClient.account;\n      const from = typeof account === \"string\" ? account : account?.address;\n\n      const hash = await this.context.walletClient.writeContract({\n        address: dataRefinerRegistryAddress,\n        abi: dataRefinerRegistryAbi,\n        functionName: \"addSchema\",\n        args: [params.name, params.dialect, params.definitionUrl],\n        account: account ?? null,\n        chain: this.context.walletClient.chain ?? null,\n      });\n\n      // Create TransactionResult POJO\n      const { tx } = await import(\"../utils/transactionHelpers\");\n      const txResult = tx({\n        hash,\n        from: from!,\n        contract: \"DataRefinerRegistry\",\n        fn: \"addSchema\",\n      });\n\n      // Wait for events and extract domain data\n      if (!this.context.waitForTransactionEvents) {\n        throw new Error(\"waitForTransactionEvents not configured\");\n      }\n\n      const result = await this.context.waitForTransactionEvents(txResult);\n      const event = result.expectedEvents.SchemaAdded;\n      if (!event) {\n        throw new Error(\"SchemaAdded event not found in transaction\");\n      }\n\n      const receipt = await this.context.publicClient.getTransactionReceipt({\n        hash,\n      });\n\n      return {\n        transactionHash: hash,\n        blockNumber: receipt.blockNumber,\n        gasUsed: receipt.gasUsed,\n        schemaId: event.schemaId,\n        name: event.name,\n        dialect: event.dialect,\n        definitionUrl: event.definitionUrl,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to add schema: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Internal method: Query schema via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.schemaId - The ID of the schema to retrieve\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to the schema object\n   * @private\n   */\n  private async _getSchemaViaSubgraph(params: {\n    schemaId: number;\n    subgraphUrl: string;\n  }): Promise<SchemaMetadata> {\n    const { schemaId, subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(GetSchemaDocument),\n        variables: { id: schemaId.toString() },\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Subgraph request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    const result = (await response.json()) as {\n      data?: GetSchemaQuery;\n      errors?: { message: string }[];\n    };\n\n    if (result.errors) {\n      throw new Error(\n        `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    if (!result.data?.schema) {\n      throw new Error(`Schema ${schemaId} not found in subgraph`);\n    }\n\n    // Map subgraph schema to SDK schema type\n    const subgraphSchema = result.data.schema;\n    return {\n      id: parseInt(subgraphSchema.id),\n      name: subgraphSchema.name,\n      dialect: subgraphSchema.dialect as \"json\" | \"sqlite\",\n      definitionUrl: subgraphSchema.definitionUrl,\n    };\n  }\n\n  /**\n   * Internal method: List schemas via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.limit - Maximum number of schemas to return\n   * @param params.offset - Number of schemas to skip\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to an array of schemas\n   * @private\n   */\n  private async _listSchemasViaSubgraph(params: {\n    limit: number;\n    offset: number;\n    subgraphUrl: string;\n  }): Promise<Schema[]> {\n    const { limit, offset, subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(ListSchemasDocument),\n        variables: { first: limit, skip: offset },\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Subgraph request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    const result = (await response.json()) as {\n      data?: ListSchemasQuery;\n      errors?: { message: string }[];\n    };\n\n    if (result.errors) {\n      throw new Error(\n        `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    if (!result.data?.schemas) {\n      return [];\n    }\n\n    // Map subgraph schemas to SDK schema type\n    const schemas = result.data.schemas.map((schema) => ({\n      id: parseInt(schema.id),\n      name: schema.name,\n      dialect: schema.dialect as \"json\" | \"sqlite\",\n      definitionUrl: schema.definitionUrl,\n    }));\n\n    // Optionally fetch definitions if requested\n    const { includeDefinitions } = params as { includeDefinitions?: boolean };\n    if (includeDefinitions) {\n      await this._fetchDefinitionsForSchemas(schemas);\n    }\n\n    return schemas;\n  }\n\n  /**\n   * Internal method: Count schemas via subgraph\n   *\n   * @param params - Query parameters\n   * @param params.subgraphUrl - The subgraph URL to query\n   * @returns Promise resolving to the total schema count\n   * @private\n   */\n  private async _countSchemasViaSubgraph(params: {\n    subgraphUrl: string;\n  }): Promise<number> {\n    const { subgraphUrl } = params;\n\n    const response = await fetch(subgraphUrl, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        query: print(CountSchemasDocument),\n        variables: {},\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Subgraph request failed: ${response.status} ${response.statusText}`,\n      );\n    }\n\n    const result = (await response.json()) as {\n      data?: CountSchemasQuery;\n      errors?: { message: string }[];\n    };\n\n    if (result.errors) {\n      throw new Error(\n        `Subgraph query errors: ${result.errors.map((e) => e.message).join(\", \")}`,\n      );\n    }\n\n    return result.data?.schemas?.length ?? 0;\n  }\n\n  /**\n   * Gets the user's wallet address.\n   *\n   * @private\n   * @returns Promise resolving to the user's address\n   */\n\n  /**\n   * Fetches and attaches definitions to an array of schemas.\n   *\n   * @param schemas - Array of schemas to fetch definitions for\n   * @private\n   */\n  private async _fetchDefinitionsForSchemas(schemas: Schema[]): Promise<void> {\n    // Fetch definitions concurrently for performance\n    await Promise.all(\n      schemas.map(async (schema) => {\n        if (!schema.definitionUrl) return;\n\n        try {\n          const definition = await fetchFromUrl(\n            schema.definitionUrl,\n            this.context.downloadRelayer,\n          );\n\n          if (definition && typeof definition === \"object\") {\n            // Validate the fetched DataSchema\n            validateDataSchemaAgainstMetaSchema(definition);\n            const dataSchema = definition as DataSchema;\n\n            // Populate flat fields\n            schema.version = dataSchema.version;\n            schema.description = dataSchema.description;\n            schema.schema = dataSchema.schema;\n          }\n        } catch (error) {\n          // Don't fail the entire list operation if one definition fails\n          console.error(\n            `Failed to fetch/validate definition for schema ${schema.id}:`,\n            error instanceof UrlResolutionError ||\n              error instanceof SchemaValidationError\n              ? error.message\n              : error,\n          );\n        }\n      }),\n    );\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/controllers/schemas.d.ts

@@ -1,30 +1,7 @@
-import { CompleteSchema, Schema, AddSchemaParams, AddSchemaResult } from '../types/data.js';
-import { C as ControllerContext } from '../permissions-eo8YeLGf.js';
-import 'viem';
-import '../types/operations.js';
-import '../generated/server/server-exports.js';
-import '../generated/server/server.js';
-import '../types/config.js';
-import '../types/chains.js';
-import '../types/storage.js';
-import '../types/permissions.js';
-import '../config/eventMappings.js';
-import '../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';
-import '../storage/manager.js';
-import '../platform/interface.js';
-
+import type { Schema, CompleteSchema, AddSchemaParams } from "../types/index";
+import type { SchemaAddedResult } from "../types/transactionResults";
+import type { ControllerContext } from "./permissions";
+import { BaseController } from "./base";
 /**
  * Parameters for creating a new schema with automatic IPFS upload.
  *
@@ -33,7 +10,7 @@ import '../platform/interface.js';
  * automatically uploads the schema definition to IPFS and registers it on-chain.
  * @category Schema Management
  */
-interface CreateSchemaParams {
+export interface CreateSchemaParams {
     /** The name of the schema */
     name: string;
     /** The dialect of the schema (e.g., 'json' or 'sqlite') */
@@ -48,9 +25,9 @@ interface CreateSchemaParams {
  * Returned by the `schemas.create()` method after successful upload and registration.
  * @category Schema Management
  */
-interface CreateSchemaResult {
+export interface CreateSchemaResult {
     /** The schema ID assigned by the contract */
-    schemaId: number;
+    schemaId: bigint;
     /** The IPFS URL where the schema definition is stored */
     definitionUrl: string;
     /** The transaction hash of the schema registration */
@@ -103,8 +80,7 @@ interface CreateSchemaResult {
  * ```
  * @category Schema Management
  */
-declare class SchemaController {
-    private readonly context;
+export declare class SchemaController extends BaseController {
     constructor(context: ControllerContext);
     /**
      * Creates a new schema with automatic validation and IPFS upload.
@@ -222,7 +198,7 @@ declare class SchemaController {
      * @param params - Schema parameters including pre-generated definition URL
      * @returns Promise resolving to the add schema result
      */
-    addSchema(params: AddSchemaParams): Promise<AddSchemaResult>;
+    addSchema(params: AddSchemaParams): Promise<SchemaAddedResult>;
     /**
      * Internal method: Query schema via subgraph
      *
@@ -259,7 +235,6 @@ declare class SchemaController {
      * @private
      * @returns Promise resolving to the user's address
      */
-    private getUserAddress;
     /**
      * Fetches and attaches definitions to an array of schemas.
      *
@@ -268,5 +243,3 @@ declare class SchemaController {
      */
     private _fetchDefinitionsForSchemas;
 }
-
-export { type CreateSchemaParams, type CreateSchemaResult, SchemaController };

package/dist/controllers/schemas.js

@@ -1,3 +1,4 @@
+import { BaseController } from "./base";
 import { getContractAddress } from "../config/addresses";
 import { getAbi } from "../generated/abi";
 import { gasAwareMulticall } from "../utils/multicall";
@@ -16,9 +17,9 @@ import {
 } from "../generated/subgraph";
 import { print } from "graphql";
 import { fetchFromUrl, UrlResolutionError } from "../utils/urlResolver";
-class SchemaController {
+class SchemaController extends BaseController {
   constructor(context) {
-    this.context = context;
+    super(context);
   }
   /**
    * Creates a new schema with automatic validation and IPFS upload.
@@ -58,6 +59,7 @@ class SchemaController {
    * ```
    */
   async create(params) {
+    this.assertWallet();
     const { name, dialect, schema } = params;
     try {
       let schemaDefinition;
@@ -99,7 +101,7 @@ class SchemaController {
         "ipfs"
         // Use IPFS for public schema storage
       );
-      const chainId = this.context.walletClient.chain?.id;
+      const chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id;
       if (!chainId) {
         throw new Error("Chain ID not available");
       }
@@ -108,27 +110,35 @@ class SchemaController {
         "DataRefinerRegistry"
       );
       const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
-      const userAddress = await this.getUserAddress();
-      const txHash = await this.context.walletClient.writeContract({
+      const account = this.context.walletClient.account;
+      const from = typeof account === "string" ? account : account?.address;
+      const hash = await this.context.walletClient.writeContract({
         address: dataRefinerRegistryAddress,
         abi: dataRefinerRegistryAbi,
         functionName: "addSchema",
         args: [name, dialect, uploadResult.url],
-        account: this.context.walletClient.account || userAddress,
-        chain: this.context.walletClient.chain || null
+        account: account ?? null,
+        chain: this.context.walletClient.chain ?? null
       });
-      const receipt = await this.context.publicClient.waitForTransactionReceipt(
-        {
-          hash: txHash,
-          confirmations: 1
-        }
-      );
-      const { parseSchemaAddedEvent } = await import("../utils/eventParsing");
-      const eventData = parseSchemaAddedEvent(receipt);
+      const { tx } = await import("../utils/transactionHelpers");
+      const txResult = tx({
+        hash,
+        from,
+        contract: "DataRefinerRegistry",
+        fn: "addSchema"
+      });
+      if (!this.context.waitForTransactionEvents) {
+        throw new Error("waitForTransactionEvents not configured");
+      }
+      const result = await this.context.waitForTransactionEvents(txResult);
+      const event = result.expectedEvents.SchemaAdded;
+      if (!event) {
+        throw new Error("SchemaAdded event not found in transaction");
+      }
       return {
-        schemaId: Number(eventData.schemaId),
+        schemaId: event.schemaId,
         definitionUrl: uploadResult.url,
-        transactionHash: txHash
+        transactionHash: hash
       };
     } catch (error) {
       if (error instanceof SchemaValidationError) {
@@ -160,7 +170,7 @@ class SchemaController {
    * ```
    */
   async get(schemaId, options = {}) {
-    const subgraphUrl = options.subgraphUrl || this.context.subgraphUrl;
+    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;
     let metadata;
     if (subgraphUrl) {
       try {
@@ -196,13 +206,13 @@ class SchemaController {
     validateDataSchemaAgainstMetaSchema(definition);
     const dataSchema = definition;
     if (dataSchema.name !== metadata.name) {
-      throw new Error(
-        `Schema name mismatch: on-chain="${metadata.name}" off-chain="${dataSchema.name}"`
+      console.warn(
+        `Schema name mismatch for ID ${schemaId}: on-chain="${metadata.name}" off-chain="${dataSchema.name}" (using on-chain value)`
       );
     }
     if (dataSchema.dialect !== metadata.dialect) {
-      throw new Error(
-        `Schema dialect mismatch: on-chain="${metadata.dialect}" off-chain="${dataSchema.dialect}"`
+      console.warn(
+        `Schema dialect mismatch for ID ${schemaId}: on-chain="${metadata.dialect}" off-chain="${dataSchema.dialect}" (using on-chain value)`
       );
     }
     return {
@@ -231,7 +241,7 @@ class SchemaController {
    * ```
    */
   async count(options = {}) {
-    const subgraphUrl = options.subgraphUrl || this.context.subgraphUrl;
+    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;
     if (subgraphUrl) {
       try {
         return await this._countSchemasViaSubgraph({ subgraphUrl });
@@ -270,7 +280,7 @@ class SchemaController {
    */
   async list(options = {}) {
     const { limit = 100, offset = 0, includeDefinitions = false } = options;
-    const subgraphUrl = options.subgraphUrl || this.context.subgraphUrl;
+    const subgraphUrl = options.subgraphUrl ?? this.context.subgraphUrl;
     if (subgraphUrl) {
       try {
         return await this._listSchemasViaSubgraph({
@@ -289,7 +299,7 @@ class SchemaController {
       if (end <= start) {
         return [];
       }
-      const chainId = this.context.walletClient.chain?.id;
+      const chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id;
       if (!chainId) {
         throw new Error("Chain ID not available");
       }
@@ -349,8 +359,9 @@ class SchemaController {
    * @returns Promise resolving to the add schema result
    */
   async addSchema(params) {
+    this.assertWallet();
     try {
-      const chainId = this.context.walletClient.chain?.id;
+      const chainId = this.context.walletClient?.chain?.id ?? this.context.publicClient.chain?.id;
       if (!chainId) {
         throw new Error("Chain ID not available");
       }
@@ -359,26 +370,42 @@ class SchemaController {
         "DataRefinerRegistry"
       );
       const dataRefinerRegistryAbi = getAbi("DataRefinerRegistry");
-      const userAddress = await this.getUserAddress();
-      const txHash = await this.context.walletClient.writeContract({
+      const account = this.context.walletClient.account;
+      const from = typeof account === "string" ? account : account?.address;
+      const hash = await this.context.walletClient.writeContract({
         address: dataRefinerRegistryAddress,
         abi: dataRefinerRegistryAbi,
         functionName: "addSchema",
         args: [params.name, params.dialect, params.definitionUrl],
-        account: this.context.walletClient.account || userAddress,
-        chain: this.context.walletClient.chain || null
+        account: account ?? null,
+        chain: this.context.walletClient.chain ?? null
+      });
+      const { tx } = await import("../utils/transactionHelpers");
+      const txResult = tx({
+        hash,
+        from,
+        contract: "DataRefinerRegistry",
+        fn: "addSchema"
+      });
+      if (!this.context.waitForTransactionEvents) {
+        throw new Error("waitForTransactionEvents not configured");
+      }
+      const result = await this.context.waitForTransactionEvents(txResult);
+      const event = result.expectedEvents.SchemaAdded;
+      if (!event) {
+        throw new Error("SchemaAdded event not found in transaction");
+      }
+      const receipt = await this.context.publicClient.getTransactionReceipt({
+        hash
       });
-      const receipt = await this.context.publicClient.waitForTransactionReceipt(
-        {
-          hash: txHash,
-          confirmations: 1
-        }
-      );
-      const { parseSchemaAddedEvent } = await import("../utils/eventParsing");
-      const eventData = parseSchemaAddedEvent(receipt);
       return {
-        schemaId: Number(eventData.schemaId),
-        transactionHash: txHash
+        transactionHash: hash,
+        blockNumber: receipt.blockNumber,
+        gasUsed: receipt.gasUsed,
+        schemaId: event.schemaId,
+        name: event.name,
+        dialect: event.dialect,
+        definitionUrl: event.definitionUrl
       };
     } catch (error) {
       throw new Error(
@@ -467,7 +494,7 @@ class SchemaController {
       dialect: schema.dialect,
       definitionUrl: schema.definitionUrl
     }));
-    const includeDefinitions = params.includeDefinitions;
+    const { includeDefinitions } = params;
     if (includeDefinitions) {
       await this._fetchDefinitionsForSchemas(schemas);
     }
@@ -502,7 +529,7 @@ class SchemaController {
         `Subgraph query errors: ${result.errors.map((e) => e.message).join(", ")}`
       );
     }
-    return result.data?.schemas?.length || 0;
+    return result.data?.schemas?.length ?? 0;
   }
   /**
    * Gets the user's wallet address.
@@ -510,18 +537,6 @@ class SchemaController {
    * @private
    * @returns Promise resolving to the user's address
    */
-  async getUserAddress() {
-    if (!this.context.walletClient.account) {
-      throw new Error("No wallet account connected");
-    }
-    if (typeof this.context.walletClient.account === "string") {
-      return this.context.walletClient.account;
-    }
-    if (typeof this.context.walletClient.account === "object" && this.context.walletClient.account.address) {
-      return this.context.walletClient.account.address;
-    }
-    throw new Error("Unable to determine wallet address");
-  }
   /**
    * Fetches and attaches definitions to an array of schemas.
    *