@opendatalabs/vana-sdk 0.1.0-alpha.376e2fd

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025, Vana
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 

package/README.md

@@ -0,0 +1,364 @@
+# Vana SDK
+
+> **⚠️ ALPHA SOFTWARE - EXPERIMENTAL USE ONLY**
+>
+> This SDK is in early alpha development and is **NOT SUITABLE FOR PRODUCTION USE**.
+> Features may change without notice, and data loss or unexpected behavior may occur.
+> Use at your own risk and avoid using with mainnet assets or critical operations.
+
+A TypeScript SDK for building data-driven applications on the Vana Network. Enable users to grant gasless permissions, manage encrypted data, and interact with privacy-preserving infrastructure.
+
+[![npm version](https://img.shields.io/npm/v/@opendatalabs/vana-sdk)](https://www.npmjs.com/package/@opendatalabs/vana-sdk)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue)](https://www.typescriptlang.org/)
+[![License: ISC](https://img.shields.io/badge/License-ISC-green.svg)](https://opensource.org/licenses/ISC)
+
+[API Documentation](https://vana-com.github.io/vana-sdk) • [Examples](#examples) • [Configuration](#configuration)
+
+## Installation
+
+```bash
+npm install @opendatalabs/vana-sdk
+```
+
+**Peer Dependencies:**
+
+```bash
+npm install viem@^2.31.7
+```
+
+## Quick Start
+
+The Vana SDK supports both browser and Node.js environments with explicit entry points:
+
+### Browser Applications (React, Vue, etc.)
+
+```typescript
+// For browser-based applications (React, Vue, etc.)
+import { Vana, mokshaTestnet } from "@opendatalabs/vana-sdk/browser";
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+
+// Create wallet client
+const account = privateKeyToAccount("0x...");
+const walletClient = createWalletClient({
+  account,
+  chain: mokshaTestnet,
+  transport: http("https://rpc.moksha.vana.org"),
+});
+
+// Initialize SDK
+const vana = Vana({
+  walletClient,
+  relayerUrl: "https://relayer.moksha.vana.org",
+});
+```
+
+### Server-side Applications (Next.js API routes, Express)
+
+```typescript
+// For server-side applications (Next.js API routes, Express)
+import { Vana, mokshaTestnet } from "@opendatalabs/vana-sdk/node";
+import { createWalletClient, http } from "viem";
+import { privateKeyToAccount } from "viem/accounts";
+
+// Create wallet client
+const account = privateKeyToAccount("0x...");
+const walletClient = createWalletClient({
+  account,
+  chain: mokshaTestnet,
+  transport: http("https://rpc.moksha.vana.org"),
+});
+
+// Initialize SDK
+const vana = Vana({
+  walletClient,
+  relayerUrl: "https://relayer.moksha.vana.org",
+});
+
+// Grant gasless permission
+const txHash = await vana.permissions.grant({
+  grantee: "0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36",
+  operation: "llm_inference",
+  parameters: {
+    prompt: "Analyze my data for insights",
+    maxTokens: 1000,
+  },
+  expiresAt: Math.floor(Date.now() / 1000) + 86400, // 24 hours
+});
+```
+
+## Core Features
+
+### Gasless Permissions
+
+Users can grant data access permissions without paying gas fees through EIP-712 signatures and relay infrastructure.
+
+```typescript
+// Grant permission with custom parameters
+await vana.permissions.grant({
+  grantee: applicationAddress,
+  operation: "data_analysis",
+  parameters: {
+    analysisType: "sentiment",
+    files: [12, 15, 28],
+    model: "gpt-4",
+  },
+});
+```
+
+### Encrypted Data Management
+
+Upload, query, and manage encrypted user data files with built-in schema validation.
+
+```typescript
+// Query user files
+const files = await vana.data.getUserFiles({
+  owner: "0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36",
+});
+
+// Upload encrypted file
+const result = await vana.data.uploadEncryptedFile({
+  data: encryptedBlob,
+  schemaId: 123,
+  filename: "user-data.json",
+});
+```
+
+### Flexible Storage
+
+Abstract storage layer supporting IPFS, Google Drive, and custom providers.
+
+```typescript
+// For browser applications
+import { StorageManager, PinataStorage } from "@opendatalabs/vana-sdk/browser";
+// OR for server-side applications
+// import { StorageManager, PinataStorage } from "@opendatalabs/vana-sdk/node";
+
+const storageManager = new StorageManager();
+storageManager.register(
+  "ipfs",
+  new PinataStorage({
+    apiKey: process.env.PINATA_API_KEY,
+    secretKey: process.env.PINATA_SECRET_KEY,
+  }),
+);
+```
+
+## Architecture
+
+The SDK provides four main controllers:
+
+| Controller    | Purpose                        | Key Methods                                                       |
+| ------------- | ------------------------------ | ----------------------------------------------------------------- |
+| `permissions` | Gasless permission management  | `grant()`, `revoke()`, `getUserPermissions()`                     |
+| `data`        | File management and validation | `getUserFiles()`, `uploadEncryptedFile()`, `validateDataSchema()` |
+| `server`      | Trusted server operations      | `trustServer()`, `processWithTrustedServer()`                     |
+| `protocol`    | Contract interaction           | `getContract()`, `getAvailableContracts()`                        |
+
+## Configuration
+
+```typescript
+const vana = Vana({
+  walletClient,
+
+  // Gasless transaction relay
+  relayerUrl: "https://relayer.moksha.vana.org",
+
+  // Custom relay callbacks
+  relayerCallbacks: {
+    submitPermissionGrant: async (typedData, signature) => {
+      return await customRelayer.submit(typedData, signature);
+    },
+  },
+
+  // Storage configuration
+  storageManager: new StorageManager({
+    defaultProvider: "ipfs",
+    providers: {
+      ipfs: new PinataStorage({ apiKey: "...", secretKey: "..." }),
+    },
+  }),
+
+  // Subgraph for efficient queries
+  subgraphUrl: "https://api.thegraph.com/subgraphs/name/vana/moksha",
+});
+```
+
+## Error Handling
+
+The SDK provides specific error types for different failure scenarios:
+
+```typescript
+import {
+  RelayerError,
+  UserRejectedRequestError,
+  SchemaValidationError,
+  NetworkError,
+} from "@opendatalabs/vana-sdk/browser";
+// OR for server-side applications
+// } from "@opendatalabs/vana-sdk/node";
+
+try {
+  await vana.permissions.grant(params);
+} catch (error) {
+  if (error instanceof UserRejectedRequestError) {
+    // User cancelled transaction
+  } else if (error instanceof RelayerError) {
+    // Relayer service error
+  } else if (error instanceof SchemaValidationError) {
+    // Schema validation failed
+  }
+}
+```
+
+## Supported Networks
+
+| Network            | Chain ID | RPC URL                       |
+| ------------------ | -------- | ----------------------------- |
+| **Vana Mainnet**   | `1480`   | `https://rpc.vana.org`        |
+| **Moksha Testnet** | `14800`  | `https://rpc.moksha.vana.org` |
+
+## Examples
+
+### Complete Permission Flow
+
+```typescript
+import {
+  Vana,
+  generateEncryptionKey,
+  encryptBlobWithSignedKey,
+} from "@opendatalabs/vana-sdk/browser";
+// OR for server-side applications
+// } from "@opendatalabs/vana-sdk/node";
+
+async function grantDataPermission() {
+  const vana = Vana({ walletClient });
+
+  // 1. Encrypt user data
+  const encryptionKey = await generateEncryptionKey(walletClient);
+  const userData = new Blob([JSON.stringify({ data: "sensitive info" })]);
+  const encryptedData = await encryptBlobWithSignedKey(userData, encryptionKey);
+
+  // 2. Upload encrypted file
+  const uploadResult = await vana.data.uploadEncryptedFile({
+    data: encryptedData,
+    schemaId: 123,
+    filename: "user-data.json",
+  });
+
+  // 3. Grant permission
+  const permissionTx = await vana.permissions.grant({
+    grantee: "0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36",
+    operation: "ai_training",
+    parameters: {
+      files: [uploadResult.fileId],
+      model: "llm-v1",
+    },
+  });
+
+  return permissionTx;
+}
+```
+
+### Schema Validation
+
+```typescript
+// Define data schema
+const schema = {
+  name: "Social Media Export",
+  version: "1.0.0",
+  dialect: "json",
+  schema: {
+    type: "object",
+    properties: {
+      posts: { type: "array" },
+      profile: { type: "object" },
+    },
+    required: ["profile"],
+  },
+};
+
+// Validate schema
+vana.data.validateDataSchema(schema);
+
+// Validate user data
+const userData = {
+  profile: { username: "alice" },
+  posts: [],
+};
+vana.data.validateDataAgainstSchema(userData, schema);
+```
+
+## API Reference
+
+### Permissions
+
+```typescript
+// Grant permission
+await vana.permissions.grant({
+  grantee: Address,
+  operation: string,
+  parameters: object,
+  expiresAt?: number
+}): Promise<Hash>
+
+// Revoke permission
+await vana.permissions.revoke({
+  grantId: string
+}): Promise<Hash>
+
+// Get user permissions
+await vana.permissions.getUserPermissions({
+  owner: Address
+}): Promise<GrantedPermission[]>
+```
+
+### Data
+
+```typescript
+// Get user files
+await vana.data.getUserFiles({
+  owner: Address
+}): Promise<UserFile[]>
+
+// Upload encrypted file
+await vana.data.uploadEncryptedFile({
+  data: Blob,
+  schemaId?: number,
+  filename?: string
+}): Promise<UploadResult>
+
+// Validate schema
+vana.data.validateDataSchema(schema: unknown): void
+
+// Validate data against schema
+vana.data.validateDataAgainstSchema(data: unknown, schema: DataSchema): void
+```
+
+## Documentation
+
+- [API Documentation](https://vana-com.github.io/vana-sdk) - Complete TypeDoc API reference
+- [Getting Started](https://vana-com.github.io/vana-sdk/getting-started) - Step-by-step setup guide
+- [Architecture](https://vana-com.github.io/vana-sdk/architecture) - SDK design and patterns
+- [Configuration](https://vana-com.github.io/vana-sdk/configuration) - All configuration options
+- [Security](https://vana-com.github.io/vana-sdk/security) - Best practices and security
+
+## Support
+
+- **Documentation**: [vana-com.github.io/vana-sdk](https://vana-com.github.io/vana-sdk)
+- **Issues**: [GitHub Issues](https://github.com/vana-com/vana-sdk/issues)
+- **Discord**: [Join our community](https://discord.gg/vanabuilders)
+
+## Development
+
+```bash
+git clone https://github.com/vana-com/vana-sdk.git
+cd vana-sdk
+npm install
+npm run build
+npm test
+```
+
+## License
+
+[ISC License](LICENSE) © Vana Foundation

package/dist/chains.browser.cjs

@@ -0,0 +1,96 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/chains.browser.ts
+var chains_browser_exports = {};
+__export(chains_browser_exports, {
+  getAllChains: () => getAllChains,
+  getChainConfig: () => getChainConfig,
+  moksha: () => moksha,
+  mokshaTestnet: () => mokshaTestnet,
+  vanaMainnet: () => vanaMainnet
+});
+module.exports = __toCommonJS(chains_browser_exports);
+
+// src/chains/definitions.ts
+var vanaMainnet = {
+  id: 1480,
+  name: "Vana",
+  nativeCurrency: {
+    name: "VANA",
+    symbol: "VANA",
+    decimals: 18
+  },
+  rpcUrls: {
+    default: {
+      http: ["https://rpc.vana.org"]
+    }
+  },
+  blockExplorers: {
+    default: {
+      name: "Vanascan",
+      url: "https://vanascan.io"
+    }
+  },
+  subgraphUrl: "https://api.goldsky.com/api/public/project_cm168cz887zva010j39il7a6p/subgraphs/vana/7.0.2/gn"
+};
+var moksha = {
+  id: 14800,
+  name: "Moksha Testnet",
+  nativeCurrency: {
+    name: "VANA",
+    symbol: "VANA",
+    decimals: 18
+  },
+  rpcUrls: {
+    default: {
+      http: ["https://rpc.moksha.vana.org"]
+    }
+  },
+  blockExplorers: {
+    default: {
+      name: "Vanascan - Moksha",
+      url: "https://moksha.vanascan.io"
+    }
+  },
+  subgraphUrl: "https://api.goldsky.com/api/public/project_cm168cz887zva010j39il7a6p/subgraphs/moksha/7.0.3/gn"
+};
+function getChainConfig(chainId) {
+  switch (chainId) {
+    case 1480:
+      return vanaMainnet;
+    case 14800:
+      return moksha;
+    default:
+      return void 0;
+  }
+}
+var mokshaTestnet = moksha;
+function getAllChains() {
+  return [vanaMainnet, moksha];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getAllChains,
+  getChainConfig,
+  moksha,
+  mokshaTestnet,
+  vanaMainnet
+});
+//# sourceMappingURL=chains.browser.cjs.map

package/dist/chains.browser.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chains.browser.ts","../src/chains/definitions.ts"],"sourcesContent":["/**\n * Browser-specific chains entry point\n *\n * This is identical to the base chains export since chain configurations\n * are environment-agnostic.\n */\n\nexport type { VanaChainConfig } from \"./chains/definitions\";\nexport {\n  vanaMainnet,\n  moksha,\n  mokshaTestnet,\n  getChainConfig,\n  getAllChains,\n} from \"./chains/definitions\";\n","/**\n * Chain configuration definitions for Vana networks\n *\n * These provide default configurations for known Vana chains.\n * Applications can use these as-is or override specific values.\n */\n\nimport type { Chain } from \"viem\";\n\nexport interface VanaChainConfig extends Chain {\n  /** URL for the subgraph API endpoint used to query on-chain data */\n  subgraphUrl: string;\n}\n\n/**\n * Vana Mainnet configuration\n */\nexport const vanaMainnet: VanaChainConfig = {\n  id: 1480,\n  name: \"Vana\",\n  nativeCurrency: {\n    name: \"VANA\",\n    symbol: \"VANA\",\n    decimals: 18,\n  },\n  rpcUrls: {\n    default: {\n      http: [\"https://rpc.vana.org\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Vanascan\",\n      url: \"https://vanascan.io\",\n    },\n  },\n  subgraphUrl:\n    \"https://api.goldsky.com/api/public/project_cm168cz887zva010j39il7a6p/subgraphs/vana/7.0.2/gn\",\n} as const;\n\n/**\n * Moksha Testnet configuration\n */\nexport const moksha: VanaChainConfig = {\n  id: 14800,\n  name: \"Moksha Testnet\",\n  nativeCurrency: {\n    name: \"VANA\",\n    symbol: \"VANA\",\n    decimals: 18,\n  },\n  rpcUrls: {\n    default: {\n      http: [\"https://rpc.moksha.vana.org\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Vanascan - Moksha\",\n      url: \"https://moksha.vanascan.io\",\n    },\n  },\n  subgraphUrl:\n    \"https://api.goldsky.com/api/public/project_cm168cz887zva010j39il7a6p/subgraphs/moksha/7.0.3/gn\",\n} as const;\n\n/**\n * Retrieves the chain configuration for a given chain ID.\n *\n * @param chainId - The numeric chain ID to look up\n * @returns The chain configuration if found, undefined otherwise\n * @example\n * ```typescript\n * const config = getChainConfig(1480);\n * if (config) {\n *   console.log('Chain name:', config.name);\n *   console.log('Subgraph URL:', config.subgraphUrl);\n * }\n * ```\n */\nexport function getChainConfig(chainId: number): VanaChainConfig | undefined {\n  switch (chainId) {\n    case 1480:\n      return vanaMainnet;\n    case 14800:\n      return moksha;\n    default:\n      return undefined;\n  }\n}\n\n// Backwards compatibility alias\nexport const mokshaTestnet = moksha;\n\n/**\n * Retrieves all available Vana chain configurations.\n *\n * @returns Array of all supported Vana chain configurations\n * @example\n * ```typescript\n * const chains = getAllChains();\n * console.log('Supported chains:');\n * chains.forEach(chain => {\n *   console.log(`- ${chain.name} (ID: ${chain.id})`);\n * });\n * ```\n */\nexport function getAllChains(): VanaChainConfig[] {\n  return [vanaMainnet, moksha];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBO,IAAM,cAA+B;AAAA,EAC1C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB;AAAA,IACd,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,SAAS;AAAA,MACP,MAAM,CAAC,sBAAsB;AAAA,IAC/B;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,aACE;AACJ;AAKO,IAAM,SAA0B;AAAA,EACrC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB;AAAA,IACd,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,SAAS;AAAA,MACP,MAAM,CAAC,6BAA6B;AAAA,IACtC;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,aACE;AACJ;AAgBO,SAAS,eAAe,SAA8C;AAC3E,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAGO,IAAM,gBAAgB;AAetB,SAAS,eAAkC;AAChD,SAAO,CAAC,aAAa,MAAM;AAC7B;","names":[]}

package/dist/chains.browser.d.cts

@@ -0,0 +1,53 @@
+import { Chain } from 'viem';
+
+/**
+ * Chain configuration definitions for Vana networks
+ *
+ * These provide default configurations for known Vana chains.
+ * Applications can use these as-is or override specific values.
+ */
+
+interface VanaChainConfig extends Chain {
+    /** URL for the subgraph API endpoint used to query on-chain data */
+    subgraphUrl: string;
+}
+/**
+ * Vana Mainnet configuration
+ */
+declare const vanaMainnet: VanaChainConfig;
+/**
+ * Moksha Testnet configuration
+ */
+declare const moksha: VanaChainConfig;
+/**
+ * Retrieves the chain configuration for a given chain ID.
+ *
+ * @param chainId - The numeric chain ID to look up
+ * @returns The chain configuration if found, undefined otherwise
+ * @example
+ * ```typescript
+ * const config = getChainConfig(1480);
+ * if (config) {
+ *   console.log('Chain name:', config.name);
+ *   console.log('Subgraph URL:', config.subgraphUrl);
+ * }
+ * ```
+ */
+declare function getChainConfig(chainId: number): VanaChainConfig | undefined;
+declare const mokshaTestnet: VanaChainConfig;
+/**
+ * Retrieves all available Vana chain configurations.
+ *
+ * @returns Array of all supported Vana chain configurations
+ * @example
+ * ```typescript
+ * const chains = getAllChains();
+ * console.log('Supported chains:');
+ * chains.forEach(chain => {
+ *   console.log(`- ${chain.name} (ID: ${chain.id})`);
+ * });
+ * ```
+ */
+declare function getAllChains(): VanaChainConfig[];
+
+export { type VanaChainConfig, getAllChains, getChainConfig, moksha, mokshaTestnet, vanaMainnet };

package/dist/chains.browser.d.ts

@@ -0,0 +1,53 @@
+import { Chain } from 'viem';
+
+/**
+ * Chain configuration definitions for Vana networks
+ *
+ * These provide default configurations for known Vana chains.
+ * Applications can use these as-is or override specific values.
+ */
+
+interface VanaChainConfig extends Chain {
+    /** URL for the subgraph API endpoint used to query on-chain data */
+    subgraphUrl: string;
+}
+/**
+ * Vana Mainnet configuration
+ */
+declare const vanaMainnet: VanaChainConfig;
+/**
+ * Moksha Testnet configuration
+ */
+declare const moksha: VanaChainConfig;
+/**
+ * Retrieves the chain configuration for a given chain ID.
+ *
+ * @param chainId - The numeric chain ID to look up
+ * @returns The chain configuration if found, undefined otherwise
+ * @example
+ * ```typescript
+ * const config = getChainConfig(1480);
+ * if (config) {
+ *   console.log('Chain name:', config.name);
+ *   console.log('Subgraph URL:', config.subgraphUrl);
+ * }
+ * ```
+ */
+declare function getChainConfig(chainId: number): VanaChainConfig | undefined;
+declare const mokshaTestnet: VanaChainConfig;
+/**
+ * Retrieves all available Vana chain configurations.
+ *
+ * @returns Array of all supported Vana chain configurations
+ * @example
+ * ```typescript
+ * const chains = getAllChains();
+ * console.log('Supported chains:');
+ * chains.forEach(chain => {
+ *   console.log(`- ${chain.name} (ID: ${chain.id})`);
+ * });
+ * ```
+ */
+declare function getAllChains(): VanaChainConfig[];
+
+export { type VanaChainConfig, getAllChains, getChainConfig, moksha, mokshaTestnet, vanaMainnet };

package/dist/chains.browser.js

@@ -0,0 +1,65 @@
+// src/chains/definitions.ts
+var vanaMainnet = {
+  id: 1480,
+  name: "Vana",
+  nativeCurrency: {
+    name: "VANA",
+    symbol: "VANA",
+    decimals: 18
+  },
+  rpcUrls: {
+    default: {
+      http: ["https://rpc.vana.org"]
+    }
+  },
+  blockExplorers: {
+    default: {
+      name: "Vanascan",
+      url: "https://vanascan.io"
+    }
+  },
+  subgraphUrl: "https://api.goldsky.com/api/public/project_cm168cz887zva010j39il7a6p/subgraphs/vana/7.0.2/gn"
+};
+var moksha = {
+  id: 14800,
+  name: "Moksha Testnet",
+  nativeCurrency: {
+    name: "VANA",
+    symbol: "VANA",
+    decimals: 18
+  },
+  rpcUrls: {
+    default: {
+      http: ["https://rpc.moksha.vana.org"]
+    }
+  },
+  blockExplorers: {
+    default: {
+      name: "Vanascan - Moksha",
+      url: "https://moksha.vanascan.io"
+    }
+  },
+  subgraphUrl: "https://api.goldsky.com/api/public/project_cm168cz887zva010j39il7a6p/subgraphs/moksha/7.0.3/gn"
+};
+function getChainConfig(chainId) {
+  switch (chainId) {
+    case 1480:
+      return vanaMainnet;
+    case 14800:
+      return moksha;
+    default:
+      return void 0;
+  }
+}
+var mokshaTestnet = moksha;
+function getAllChains() {
+  return [vanaMainnet, moksha];
+}
+export {
+  getAllChains,
+  getChainConfig,
+  moksha,
+  mokshaTestnet,
+  vanaMainnet
+};
+//# sourceMappingURL=chains.browser.js.map

package/dist/chains.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chains/definitions.ts"],"sourcesContent":["/**\n * Chain configuration definitions for Vana networks\n *\n * These provide default configurations for known Vana chains.\n * Applications can use these as-is or override specific values.\n */\n\nimport type { Chain } from \"viem\";\n\nexport interface VanaChainConfig extends Chain {\n  /** URL for the subgraph API endpoint used to query on-chain data */\n  subgraphUrl: string;\n}\n\n/**\n * Vana Mainnet configuration\n */\nexport const vanaMainnet: VanaChainConfig = {\n  id: 1480,\n  name: \"Vana\",\n  nativeCurrency: {\n    name: \"VANA\",\n    symbol: \"VANA\",\n    decimals: 18,\n  },\n  rpcUrls: {\n    default: {\n      http: [\"https://rpc.vana.org\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Vanascan\",\n      url: \"https://vanascan.io\",\n    },\n  },\n  subgraphUrl:\n    \"https://api.goldsky.com/api/public/project_cm168cz887zva010j39il7a6p/subgraphs/vana/7.0.2/gn\",\n} as const;\n\n/**\n * Moksha Testnet configuration\n */\nexport const moksha: VanaChainConfig = {\n  id: 14800,\n  name: \"Moksha Testnet\",\n  nativeCurrency: {\n    name: \"VANA\",\n    symbol: \"VANA\",\n    decimals: 18,\n  },\n  rpcUrls: {\n    default: {\n      http: [\"https://rpc.moksha.vana.org\"],\n    },\n  },\n  blockExplorers: {\n    default: {\n      name: \"Vanascan - Moksha\",\n      url: \"https://moksha.vanascan.io\",\n    },\n  },\n  subgraphUrl:\n    \"https://api.goldsky.com/api/public/project_cm168cz887zva010j39il7a6p/subgraphs/moksha/7.0.3/gn\",\n} as const;\n\n/**\n * Retrieves the chain configuration for a given chain ID.\n *\n * @param chainId - The numeric chain ID to look up\n * @returns The chain configuration if found, undefined otherwise\n * @example\n * ```typescript\n * const config = getChainConfig(1480);\n * if (config) {\n *   console.log('Chain name:', config.name);\n *   console.log('Subgraph URL:', config.subgraphUrl);\n * }\n * ```\n */\nexport function getChainConfig(chainId: number): VanaChainConfig | undefined {\n  switch (chainId) {\n    case 1480:\n      return vanaMainnet;\n    case 14800:\n      return moksha;\n    default:\n      return undefined;\n  }\n}\n\n// Backwards compatibility alias\nexport const mokshaTestnet = moksha;\n\n/**\n * Retrieves all available Vana chain configurations.\n *\n * @returns Array of all supported Vana chain configurations\n * @example\n * ```typescript\n * const chains = getAllChains();\n * console.log('Supported chains:');\n * chains.forEach(chain => {\n *   console.log(`- ${chain.name} (ID: ${chain.id})`);\n * });\n * ```\n */\nexport function getAllChains(): VanaChainConfig[] {\n  return [vanaMainnet, moksha];\n}\n"],"mappings":";AAiBO,IAAM,cAA+B;AAAA,EAC1C,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB;AAAA,IACd,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,SAAS;AAAA,MACP,MAAM,CAAC,sBAAsB;AAAA,IAC/B;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,aACE;AACJ;AAKO,IAAM,SAA0B;AAAA,EACrC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,gBAAgB;AAAA,IACd,MAAM;AAAA,IACN,QAAQ;AAAA,IACR,UAAU;AAAA,EACZ;AAAA,EACA,SAAS;AAAA,IACP,SAAS;AAAA,MACP,MAAM,CAAC,6BAA6B;AAAA,IACtC;AAAA,EACF;AAAA,EACA,gBAAgB;AAAA,IACd,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK;AAAA,IACP;AAAA,EACF;AAAA,EACA,aACE;AACJ;AAgBO,SAAS,eAAe,SAA8C;AAC3E,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EACX;AACF;AAGO,IAAM,gBAAgB;AAetB,SAAS,eAAkC;AAChD,SAAO,CAAC,aAAa,MAAM;AAC7B;","names":[]}