@opendatalabs/vana-sdk 0.1.0-alpha.7e4db82 → 0.1.0-alpha.7ee7635

package/dist/controllers/schemas.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/schemas.ts"],"sourcesContent":["import { Address } from \"viem\";\nimport {\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 { 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 account = this.context.walletClient.account || await this.getUserAddress();\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,\n        chain: this.context.walletClient.chain || null,\n      });\n\n      const { tx } = await import(\"../utils/transactionHelpers\");\n      const txResult = tx({\n        hash,\n        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: Number(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      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<SchemaAddedResult> {\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 account = this.context.walletClient.account || await this.getUserAddress();\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,\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,\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({ hash });\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      .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;AAUA,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,UAAU,KAAK,QAAQ,aAAa,WAAW,MAAM,KAAK,eAAe;AAC/E,YAAM,OAAO,OAAO,YAAY,WAAW,UAAU,QAAQ;AAE7D,YAAM,OAAO,MAAM,KAAK,QAAQ,aAAa,cAAc;AAAA,QACzD,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,MAAM,SAAS,aAAa,GAAG;AAAA,QACtC;AAAA,QACA,OAAO,KAAK,QAAQ,aAAa,SAAS;AAAA,MAC5C,CAAC;AAED,YAAM,EAAE,GAAG,IAAI,MAAM,OAAO,6BAA6B;AACzD,YAAM,WAAW,GAAG;AAAA,QAClB;AAAA,QACA;AAAA,QACA,UAAU;AAAA,QACV,IAAI;AAAA,MACN,CAAC;AAGD,UAAI,CAAC,KAAK,QAAQ,0BAA0B;AAC1C,cAAM,IAAI,MAAM,yCAAyC;AAAA,MAC3D;AAEA,YAAM,SAAS,MAAM,KAAK,QAAQ,yBAAyB,QAAQ;AACnE,YAAM,QAAQ,OAAO,eAAe;AACpC,UAAI,CAAC,OAAO;AACV,cAAM,IAAI,MAAM,4CAA4C;AAAA,MAC9D;AAEA,aAAO;AAAA,QACL,UAAU,OAAO,MAAM,QAAQ;AAAA,QAC/B,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,QAAqD;AACnE,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,UAAU,KAAK,QAAQ,aAAa,WAAW,MAAM,KAAK,eAAe;AAC/E,YAAM,OAAO,OAAO,YAAY,WAAW,UAAU,QAAQ;AAE7D,YAAM,OAAO,MAAM,KAAK,QAAQ,aAAa,cAAc;AAAA,QACzD,SAAS;AAAA,QACT,KAAK;AAAA,QACL,cAAc;AAAA,QACd,MAAM,CAAC,OAAO,MAAM,OAAO,SAAS,OAAO,aAAa;AAAA,QACxD;AAAA,QACA,OAAO,KAAK,QAAQ,aAAa,SAAS;AAAA,MAC5C,CAAC;AAGD,YAAM,EAAE,GAAG,IAAI,MAAM,OAAO,6BAA6B;AACzD,YAAM,WAAW,GAAG;AAAA,QAClB;AAAA,QACA;AAAA,QACA,UAAU;AAAA,QACV,IAAI;AAAA,MACN,CAAC;AAGD,UAAI,CAAC,KAAK,QAAQ,0BAA0B;AAC1C,cAAM,IAAI,MAAM,yCAAyC;AAAA,MAC3D;AAEA,YAAM,SAAS,MAAM,KAAK,QAAQ,yBAAyB,QAAQ;AACnE,YAAM,QAAQ,OAAO,eAAe;AACpC,UAAI,CAAC,OAAO;AACV,cAAM,IAAI,MAAM,4CAA4C;AAAA,MAC9D;AAEA,YAAM,UAAU,MAAM,KAAK,QAAQ,aAAa,sBAAsB,EAAE,KAAK,CAAC;AAE9E,aAAO;AAAA,QACL,iBAAiB;AAAA,QACjB,aAAa,QAAQ;AAAA,QACrB,SAAS,QAAQ;AAAA,QACjB,UAAU,MAAM;AAAA,QAChB,MAAM,MAAM;AAAA,QACZ,SAAS,MAAM;AAAA,QACf,eAAe,MAAM;AAAA,MACvB;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":[]}

package/dist/controllers/schemas.d.cts

@@ -0,0 +1,260 @@
+import { CompleteSchema, Schema, AddSchemaParams } from '../types/data.cjs';
+import { SchemaAddedResult } from '../types/transactionResults.cjs';
+import { ControllerContext } from '../types/controller-context.cjs';
+import 'viem';
+import '../platform/interface.cjs';
+import '../types/config.cjs';
+import '../types/chains.cjs';
+import '../types/storage.cjs';
+import '../types/permissions.cjs';
+import '../storage/manager.cjs';
+import '../types/operations.cjs';
+import '../generated/event-types.cjs';
+import '../generated/server/server-exports.cjs';
+import '../generated/server/server.cjs';
+
+/**
+ * Parameters for creating a new schema with automatic IPFS upload.
+ *
+ * @remarks
+ * This interface is used with the high-level `schemas.create()` method which
+ * automatically uploads the schema definition to IPFS and registers it on-chain.
+ * @category Schema Management
+ */
+interface CreateSchemaParams {
+    /** The name of the schema */
+    name: string;
+    /** The dialect of the schema (e.g., 'json' or 'sqlite') */
+    dialect: "json" | "sqlite";
+    /** The schema definition object or JSON string */
+    schema: object | string;
+}
+/**
+ * Result of creating a new schema.
+ *
+ * @remarks
+ * Returned by the `schemas.create()` method after successful upload and registration.
+ * @category Schema Management
+ */
+interface CreateSchemaResult {
+    /** The schema ID assigned by the contract */
+    schemaId: number;
+    /** The IPFS URL where the schema definition is stored */
+    definitionUrl: string;
+    /** The transaction hash of the schema registration */
+    transactionHash: string;
+}
+/**
+ * Manages data schemas and refiners on the Vana network.
+ *
+ * @remarks
+ * This controller handles the complete lifecycle of data schemas including creation,
+ * validation, IPFS upload, and blockchain registration. It provides methods for managing
+ * both schemas (data structure definitions) and refiners (data processing definitions).
+ *
+ * **Schema Storage:**
+ * Schemas are stored unencrypted on IPFS for public access and reusability across the network.
+ * Schema definitions use JSON Schema format for data validation and structure definition.
+ *
+ * **Method Selection:**
+ * - `create()` validates, uploads to IPFS, and registers new schemas on blockchain
+ * - `get()` retrieves existing schema metadata by ID from blockchain contracts
+ * - `count()` returns total number of registered schemas for pagination
+ * - `list()` provides paginated access to all schemas with optional filtering
+ * - `addSchema()` provides lower-level schema registration with pre-uploaded URLs
+ *
+ * **Storage Requirements:**
+ * Methods requiring storage configuration: `create()`
+ * Methods working without storage: `get()`, `count()`, `list()`, `addSchema()`
+ *
+ * @example
+ * ```typescript
+ * // Create a new schema with automatic IPFS upload
+ * const result = await vana.schemas.create({
+ *   name: "User Profile",
+ *   dialect: "json",
+ *   schema: {
+ *     type: "object",
+ *     properties: {
+ *       name: { type: "string" },
+ *       age: { type: "number" }
+ *     },
+ *     required: ["name"]
+ *   }
+ * });
+ *
+ * // Get an existing schema
+ * const schema = await vana.schemas.get(1);
+ *
+ * // List all schemas
+ * const count = await vana.schemas.count();
+ * ```
+ * @category Schema Management
+ */
+declare class SchemaController {
+    private readonly context;
+    constructor(context: ControllerContext);
+    /**
+     * Creates a new schema with automatic validation and IPFS upload.
+     *
+     * @remarks
+     * This is the primary method for creating schemas on the Vana network. It handles
+     * the complete workflow including schema validation, IPFS upload, and blockchain
+     * registration. The schema definition is stored unencrypted on IPFS to enable
+     * public access and reusability.
+     *
+     * The method automatically:
+     * - Validates the schema definition against the Vana metaschema
+     * - Uploads the definition to IPFS to generate a permanent URL
+     * - Registers the schema on the blockchain with the generated URL
+     *
+     * @param params - Schema creation parameters including name, dialect, and definition
+     * @returns Promise resolving to creation results with schema ID and transaction hash
+     * @throws {SchemaValidationError} When the schema definition is invalid
+     * @throws {Error} When IPFS upload or blockchain registration fails
+     * @example
+     * ```typescript
+     * // Create a JSON schema for user profiles
+     * const result = await vana.schemas.create({
+     *   name: "User Profile",
+     *   dialect: "json",
+     *   schema: {
+     *     type: "object",
+     *     properties: {
+     *       name: { type: "string" },
+     *       age: { type: "number", minimum: 0 }
+     *     },
+     *     required: ["name"]
+     *   }
+     * });
+     *
+     * console.log(`Schema created with ID: ${result.schemaId}`);
+     * ```
+     */
+    create(params: CreateSchemaParams): Promise<CreateSchemaResult>;
+    /**
+     * Retrieves a complete schema by its ID with definition fetched and flattened.
+     *
+     * @param schemaId - The ID of the schema to retrieve
+     * @param options - Optional parameters
+     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
+     * @returns Promise resolving to the complete schema object with all fields populated
+     * @throws {Error} When the schema is not found, definition cannot be fetched, or chain is unavailable
+     * @example
+     * ```typescript
+     * const schema = await vana.schemas.get(1);
+     * console.log(`Schema: ${schema.name} (${schema.dialect})`);
+     * console.log(`Version: ${schema.version}`);
+     * console.log(`Description: ${schema.description}`);
+     * console.log('Schema:', schema.schema);
+     *
+     * // Use directly with validator (schema has all required fields)
+     * validator.validateDataAgainstSchema(data, schema);
+     * ```
+     */
+    get(schemaId: number, options?: {
+        subgraphUrl?: string;
+    }): Promise<CompleteSchema>;
+    /**
+     * Gets the total number of schemas registered on the network.
+     *
+     * @param options - Optional parameters
+     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
+     * @returns Promise resolving to the total schema count
+     * @throws {Error} When the count cannot be retrieved
+     * @example
+     * ```typescript
+     * const count = await vana.schemas.count();
+     * console.log(`Total schemas: ${count}`);
+     *
+     * // With custom subgraph
+     * const count = await vana.schemas.count({
+     *   subgraphUrl: 'https://custom-subgraph.com/graphql'
+     * });
+     * ```
+     */
+    count(options?: {
+        subgraphUrl?: string;
+    }): Promise<number>;
+    /**
+     * Lists all schemas with pagination.
+     *
+     * @param options - Optional parameters for listing schemas
+     * @param options.limit - Maximum number of schemas to return
+     * @param options.offset - Number of schemas to skip
+     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
+     * @param options.includeDefinitions - Whether to fetch and include schema definitions (default: false for performance)
+     * @returns Promise resolving to an array of schemas
+     * @example
+     * ```typescript
+     * // Get all schemas (without definitions for performance)
+     * const schemas = await vana.schemas.list();
+     *
+     * // Get schemas with definitions
+     * const schemas = await vana.schemas.list({ includeDefinitions: true });
+     *
+     * // Get schemas with pagination
+     * const schemas = await vana.schemas.list({ limit: 10, offset: 0 });
+     * ```
+     */
+    list(options?: {
+        limit?: number;
+        offset?: number;
+        subgraphUrl?: string;
+        includeDefinitions?: boolean;
+    }): Promise<Schema[]>;
+    /**
+     * Adds a schema using the legacy method (low-level API).
+     *
+     * @deprecated Use create() instead for the high-level API with automatic IPFS upload
+     * @param params - Schema parameters including pre-generated definition URL
+     * @returns Promise resolving to the add schema result
+     */
+    addSchema(params: AddSchemaParams): Promise<SchemaAddedResult>;
+    /**
+     * Internal method: Query schema via subgraph
+     *
+     * @param params - Query parameters
+     * @param params.schemaId - The ID of the schema to retrieve
+     * @param params.subgraphUrl - The subgraph URL to query
+     * @returns Promise resolving to the schema object
+     * @private
+     */
+    private _getSchemaViaSubgraph;
+    /**
+     * Internal method: List schemas via subgraph
+     *
+     * @param params - Query parameters
+     * @param params.limit - Maximum number of schemas to return
+     * @param params.offset - Number of schemas to skip
+     * @param params.subgraphUrl - The subgraph URL to query
+     * @returns Promise resolving to an array of schemas
+     * @private
+     */
+    private _listSchemasViaSubgraph;
+    /**
+     * Internal method: Count schemas via subgraph
+     *
+     * @param params - Query parameters
+     * @param params.subgraphUrl - The subgraph URL to query
+     * @returns Promise resolving to the total schema count
+     * @private
+     */
+    private _countSchemasViaSubgraph;
+    /**
+     * Gets the user's wallet address.
+     *
+     * @private
+     * @returns Promise resolving to the user's address
+     */
+    private getUserAddress;
+    /**
+     * Fetches and attaches definitions to an array of schemas.
+     *
+     * @param schemas - Array of schemas to fetch definitions for
+     * @private
+     */
+    private _fetchDefinitionsForSchemas;
+}
+
+export { type CreateSchemaParams, type CreateSchemaResult, SchemaController };

package/dist/controllers/schemas.d.ts

@@ -0,0 +1,260 @@
+import { CompleteSchema, Schema, AddSchemaParams } from '../types/data.js';
+import { SchemaAddedResult } from '../types/transactionResults.js';
+import { ControllerContext } from '../types/controller-context.js';
+import 'viem';
+import '../platform/interface.js';
+import '../types/config.js';
+import '../types/chains.js';
+import '../types/storage.js';
+import '../types/permissions.js';
+import '../storage/manager.js';
+import '../types/operations.js';
+import '../generated/event-types.js';
+import '../generated/server/server-exports.js';
+import '../generated/server/server.js';
+
+/**
+ * Parameters for creating a new schema with automatic IPFS upload.
+ *
+ * @remarks
+ * This interface is used with the high-level `schemas.create()` method which
+ * automatically uploads the schema definition to IPFS and registers it on-chain.
+ * @category Schema Management
+ */
+interface CreateSchemaParams {
+    /** The name of the schema */
+    name: string;
+    /** The dialect of the schema (e.g., 'json' or 'sqlite') */
+    dialect: "json" | "sqlite";
+    /** The schema definition object or JSON string */
+    schema: object | string;
+}
+/**
+ * Result of creating a new schema.
+ *
+ * @remarks
+ * Returned by the `schemas.create()` method after successful upload and registration.
+ * @category Schema Management
+ */
+interface CreateSchemaResult {
+    /** The schema ID assigned by the contract */
+    schemaId: number;
+    /** The IPFS URL where the schema definition is stored */
+    definitionUrl: string;
+    /** The transaction hash of the schema registration */
+    transactionHash: string;
+}
+/**
+ * Manages data schemas and refiners on the Vana network.
+ *
+ * @remarks
+ * This controller handles the complete lifecycle of data schemas including creation,
+ * validation, IPFS upload, and blockchain registration. It provides methods for managing
+ * both schemas (data structure definitions) and refiners (data processing definitions).
+ *
+ * **Schema Storage:**
+ * Schemas are stored unencrypted on IPFS for public access and reusability across the network.
+ * Schema definitions use JSON Schema format for data validation and structure definition.
+ *
+ * **Method Selection:**
+ * - `create()` validates, uploads to IPFS, and registers new schemas on blockchain
+ * - `get()` retrieves existing schema metadata by ID from blockchain contracts
+ * - `count()` returns total number of registered schemas for pagination
+ * - `list()` provides paginated access to all schemas with optional filtering
+ * - `addSchema()` provides lower-level schema registration with pre-uploaded URLs
+ *
+ * **Storage Requirements:**
+ * Methods requiring storage configuration: `create()`
+ * Methods working without storage: `get()`, `count()`, `list()`, `addSchema()`
+ *
+ * @example
+ * ```typescript
+ * // Create a new schema with automatic IPFS upload
+ * const result = await vana.schemas.create({
+ *   name: "User Profile",
+ *   dialect: "json",
+ *   schema: {
+ *     type: "object",
+ *     properties: {
+ *       name: { type: "string" },
+ *       age: { type: "number" }
+ *     },
+ *     required: ["name"]
+ *   }
+ * });
+ *
+ * // Get an existing schema
+ * const schema = await vana.schemas.get(1);
+ *
+ * // List all schemas
+ * const count = await vana.schemas.count();
+ * ```
+ * @category Schema Management
+ */
+declare class SchemaController {
+    private readonly context;
+    constructor(context: ControllerContext);
+    /**
+     * Creates a new schema with automatic validation and IPFS upload.
+     *
+     * @remarks
+     * This is the primary method for creating schemas on the Vana network. It handles
+     * the complete workflow including schema validation, IPFS upload, and blockchain
+     * registration. The schema definition is stored unencrypted on IPFS to enable
+     * public access and reusability.
+     *
+     * The method automatically:
+     * - Validates the schema definition against the Vana metaschema
+     * - Uploads the definition to IPFS to generate a permanent URL
+     * - Registers the schema on the blockchain with the generated URL
+     *
+     * @param params - Schema creation parameters including name, dialect, and definition
+     * @returns Promise resolving to creation results with schema ID and transaction hash
+     * @throws {SchemaValidationError} When the schema definition is invalid
+     * @throws {Error} When IPFS upload or blockchain registration fails
+     * @example
+     * ```typescript
+     * // Create a JSON schema for user profiles
+     * const result = await vana.schemas.create({
+     *   name: "User Profile",
+     *   dialect: "json",
+     *   schema: {
+     *     type: "object",
+     *     properties: {
+     *       name: { type: "string" },
+     *       age: { type: "number", minimum: 0 }
+     *     },
+     *     required: ["name"]
+     *   }
+     * });
+     *
+     * console.log(`Schema created with ID: ${result.schemaId}`);
+     * ```
+     */
+    create(params: CreateSchemaParams): Promise<CreateSchemaResult>;
+    /**
+     * Retrieves a complete schema by its ID with definition fetched and flattened.
+     *
+     * @param schemaId - The ID of the schema to retrieve
+     * @param options - Optional parameters
+     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
+     * @returns Promise resolving to the complete schema object with all fields populated
+     * @throws {Error} When the schema is not found, definition cannot be fetched, or chain is unavailable
+     * @example
+     * ```typescript
+     * const schema = await vana.schemas.get(1);
+     * console.log(`Schema: ${schema.name} (${schema.dialect})`);
+     * console.log(`Version: ${schema.version}`);
+     * console.log(`Description: ${schema.description}`);
+     * console.log('Schema:', schema.schema);
+     *
+     * // Use directly with validator (schema has all required fields)
+     * validator.validateDataAgainstSchema(data, schema);
+     * ```
+     */
+    get(schemaId: number, options?: {
+        subgraphUrl?: string;
+    }): Promise<CompleteSchema>;
+    /**
+     * Gets the total number of schemas registered on the network.
+     *
+     * @param options - Optional parameters
+     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
+     * @returns Promise resolving to the total schema count
+     * @throws {Error} When the count cannot be retrieved
+     * @example
+     * ```typescript
+     * const count = await vana.schemas.count();
+     * console.log(`Total schemas: ${count}`);
+     *
+     * // With custom subgraph
+     * const count = await vana.schemas.count({
+     *   subgraphUrl: 'https://custom-subgraph.com/graphql'
+     * });
+     * ```
+     */
+    count(options?: {
+        subgraphUrl?: string;
+    }): Promise<number>;
+    /**
+     * Lists all schemas with pagination.
+     *
+     * @param options - Optional parameters for listing schemas
+     * @param options.limit - Maximum number of schemas to return
+     * @param options.offset - Number of schemas to skip
+     * @param options.subgraphUrl - Custom subgraph URL to use instead of default
+     * @param options.includeDefinitions - Whether to fetch and include schema definitions (default: false for performance)
+     * @returns Promise resolving to an array of schemas
+     * @example
+     * ```typescript
+     * // Get all schemas (without definitions for performance)
+     * const schemas = await vana.schemas.list();
+     *
+     * // Get schemas with definitions
+     * const schemas = await vana.schemas.list({ includeDefinitions: true });
+     *
+     * // Get schemas with pagination
+     * const schemas = await vana.schemas.list({ limit: 10, offset: 0 });
+     * ```
+     */
+    list(options?: {
+        limit?: number;
+        offset?: number;
+        subgraphUrl?: string;
+        includeDefinitions?: boolean;
+    }): Promise<Schema[]>;
+    /**
+     * Adds a schema using the legacy method (low-level API).
+     *
+     * @deprecated Use create() instead for the high-level API with automatic IPFS upload
+     * @param params - Schema parameters including pre-generated definition URL
+     * @returns Promise resolving to the add schema result
+     */
+    addSchema(params: AddSchemaParams): Promise<SchemaAddedResult>;
+    /**
+     * Internal method: Query schema via subgraph
+     *
+     * @param params - Query parameters
+     * @param params.schemaId - The ID of the schema to retrieve
+     * @param params.subgraphUrl - The subgraph URL to query
+     * @returns Promise resolving to the schema object
+     * @private
+     */
+    private _getSchemaViaSubgraph;
+    /**
+     * Internal method: List schemas via subgraph
+     *
+     * @param params - Query parameters
+     * @param params.limit - Maximum number of schemas to return
+     * @param params.offset - Number of schemas to skip
+     * @param params.subgraphUrl - The subgraph URL to query
+     * @returns Promise resolving to an array of schemas
+     * @private
+     */
+    private _listSchemasViaSubgraph;
+    /**
+     * Internal method: Count schemas via subgraph
+     *
+     * @param params - Query parameters
+     * @param params.subgraphUrl - The subgraph URL to query
+     * @returns Promise resolving to the total schema count
+     * @private
+     */
+    private _countSchemasViaSubgraph;
+    /**
+     * Gets the user's wallet address.
+     *
+     * @private
+     * @returns Promise resolving to the user's address
+     */
+    private getUserAddress;
+    /**
+     * Fetches and attaches definitions to an array of schemas.
+     *
+     * @param schemas - Array of schemas to fetch definitions for
+     * @private
+     */
+    private _fetchDefinitionsForSchemas;
+}
+
+export { type CreateSchemaParams, type CreateSchemaResult, SchemaController };