@varity-labs/sdk 2.0.0-alpha.1

package/dist/core/config.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Varity SDK v1 - Network Configuration
+ *
+ * Manages network settings and contract addresses for different networks.
+ */
+import { NetworkConfig, Network } from './types';
+/**
+ * Network configurations for Varity SDK
+ * Contract addresses will be populated after deployment
+ */
+export declare const NETWORK_CONFIGS: Record<Network, NetworkConfig>;
+/**
+ * Default SDK configuration
+ */
+export declare const DEFAULT_CONFIG: {
+    network: Network;
+    apiEndpoint: string;
+    timeout: number;
+};
+/**
+ * Get network configuration
+ */
+export declare function getNetworkConfig(network: Network): NetworkConfig;
+/**
+ * Validate contract addresses are configured
+ */
+export declare function validateContractAddresses(network: Network): void;
+/**
+ * Backend API endpoints
+ */
+export declare const API_ENDPOINTS: {
+    storage: {
+        pin: string;
+        retrieve: string;
+        unpin: string;
+    };
+    celestia: {
+        submit: string;
+        retrieve: string;
+        submitBatch: string;
+    };
+    llm: {
+        query: string;
+        queryWithRAG: string;
+    };
+    config: {
+        contracts: string;
+        networks: string;
+    };
+};
+/**
+ * Storage layer configuration
+ */
+export declare const STORAGE_CONFIG: {
+    defaultBackend: "filecoin-ipfs";
+    pinata: {
+        gateway: string;
+        api: string;
+    };
+    celestia: {
+        namespacePrefix: string;
+        testnetRPC: string;
+    };
+    encryption: {
+        algorithm: string;
+        keyDerivation: string;
+        iterations: number;
+    };
+    multiTier: {
+        hotTier: {
+            backend: "filecoin-ipfs";
+            replication: number;
+            costPerGB: number;
+            accessLatency: number;
+        };
+        coldTier: {
+            backend: "filecoin-ipfs";
+            replication: number;
+            costPerGB: number;
+            accessLatency: number;
+        };
+        autoTiering: {
+            enabled: boolean;
+            policy: "access-based";
+            checkInterval: number;
+            rules: ({
+                name: string;
+                description: string;
+                condition: {
+                    type: "last_accessed";
+                    operator: "gt";
+                    value: number;
+                    unit: "days";
+                };
+                action: {
+                    moveTo: "cold";
+                    notify: boolean;
+                };
+                priority: number;
+                enabled: boolean;
+            } | {
+                name: string;
+                description: string;
+                condition: {
+                    type: "access_count";
+                    operator: "gte";
+                    value: number;
+                    unit: "accesses";
+                };
+                action: {
+                    moveTo: "hot";
+                    notify: boolean;
+                };
+                priority: number;
+                enabled: boolean;
+            })[];
+        };
+    };
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEhD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,CA2C1D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;aACM,OAAO;;;CAGvC,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAMhE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgBhE;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;CAmBzB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6E1B,CAAA"}

package/dist/core/config.js

@@ -0,0 +1,187 @@
+/**
+ * Varity SDK v1 - Network Configuration
+ *
+ * Manages network settings and contract addresses for different networks.
+ */
+/**
+ * Network configurations for Varity SDK
+ * Contract addresses will be populated after deployment
+ */
+export const NETWORK_CONFIGS = {
+    'arbitrum-sepolia': {
+        chainId: 421614, // Arbitrum Sepolia testnet chain ID
+        rpcUrl: process.env.ARBITRUM_SEPOLIA_RPC || 'https://sepolia-rollup.arbitrum.io/rpc',
+        explorerUrl: 'https://sepolia.arbiscan.io',
+        contracts: {
+            MerchantRegistry: process.env.MERCHANT_REGISTRY_ARBITRUM_SEPOLIA || '',
+            TransactionVault: process.env.TRANSACTION_VAULT_ARBITRUM_SEPOLIA || '',
+            RepPerformance: process.env.REP_PERFORMANCE_ARBITRUM_SEPOLIA || '',
+            ResidualCalculator: process.env.RESIDUAL_CALCULATOR_ARBITRUM_SEPOLIA || '',
+            AccessControlRegistry: process.env.ACCESS_CONTROL_ARBITRUM_SEPOLIA || '',
+            DataProofRegistry: process.env.DATA_PROOF_REGISTRY_ARBITRUM_SEPOLIA || '',
+            VarityWalletFactory: process.env.WALLET_FACTORY_ARBITRUM_SEPOLIA || ''
+        }
+    },
+    'arbitrum-l3-testnet': {
+        chainId: 33529, // Varity L3 Testnet (Arbitrum Orbit on Conduit)
+        rpcUrl: process.env.ARBITRUM_L3_TESTNET_RPC || 'https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz',
+        explorerUrl: 'https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz',
+        contracts: {
+            MerchantRegistry: process.env.MERCHANT_REGISTRY_L3_TESTNET || '',
+            TransactionVault: process.env.TRANSACTION_VAULT_L3_TESTNET || '',
+            RepPerformance: process.env.REP_PERFORMANCE_L3_TESTNET || '',
+            ResidualCalculator: process.env.RESIDUAL_CALCULATOR_L3_TESTNET || '',
+            AccessControlRegistry: process.env.ACCESS_CONTROL_L3_TESTNET || '',
+            DataProofRegistry: process.env.DATA_PROOF_REGISTRY_L3_TESTNET || '',
+            VarityWalletFactory: process.env.WALLET_FACTORY_L3_TESTNET || ''
+        }
+    },
+    'arbitrum-l3-mainnet': {
+        chainId: 1000000, // Placeholder - will be updated with actual L3 mainnet
+        rpcUrl: process.env.ARBITRUM_L3_MAINNET_RPC || '',
+        explorerUrl: 'https://explorer.varity.io',
+        contracts: {
+            MerchantRegistry: process.env.MERCHANT_REGISTRY_L3_MAINNET || '',
+            TransactionVault: process.env.TRANSACTION_VAULT_L3_MAINNET || '',
+            RepPerformance: process.env.REP_PERFORMANCE_L3_MAINNET || '',
+            ResidualCalculator: process.env.RESIDUAL_CALCULATOR_L3_MAINNET || '',
+            AccessControlRegistry: process.env.ACCESS_CONTROL_L3_MAINNET || '',
+            DataProofRegistry: process.env.DATA_PROOF_REGISTRY_L3_MAINNET || '',
+            VarityWalletFactory: process.env.WALLET_FACTORY_L3_MAINNET || ''
+        }
+    }
+};
+/**
+ * Default SDK configuration
+ */
+export const DEFAULT_CONFIG = {
+    network: 'arbitrum-sepolia',
+    apiEndpoint: process.env.VARITY_API_ENDPOINT || 'https://api.varity.io',
+    timeout: 30000 // 30 seconds
+};
+/**
+ * Get network configuration
+ */
+export function getNetworkConfig(network) {
+    const config = NETWORK_CONFIGS[network];
+    if (!config) {
+        throw new Error(`Unsupported network: ${network}`);
+    }
+    return config;
+}
+/**
+ * Validate contract addresses are configured
+ */
+export function validateContractAddresses(network) {
+    const config = getNetworkConfig(network);
+    const missingContracts = [];
+    Object.entries(config.contracts).forEach(([name, address]) => {
+        if (!address || address === '') {
+            missingContracts.push(name);
+        }
+    });
+    if (missingContracts.length > 0) {
+        throw new Error(`Missing contract addresses for ${network}: ${missingContracts.join(', ')}\n` +
+            `Please set environment variables or deploy contracts to this network.`);
+    }
+}
+/**
+ * Backend API endpoints
+ */
+export const API_ENDPOINTS = {
+    storage: {
+        pin: '/api/v1/storage/pin',
+        retrieve: '/api/v1/storage/retrieve',
+        unpin: '/api/v1/storage/unpin'
+    },
+    celestia: {
+        submit: '/api/v1/celestia/submit',
+        retrieve: '/api/v1/celestia/retrieve',
+        submitBatch: '/api/v1/celestia/submit-batch'
+    },
+    llm: {
+        query: '/api/v1/llm/query',
+        queryWithRAG: '/api/v1/llm/query-rag'
+    },
+    config: {
+        contracts: '/api/v1/config/contracts',
+        networks: '/api/v1/config/networks'
+    }
+};
+/**
+ * Storage layer configuration
+ */
+export const STORAGE_CONFIG = {
+    // Default storage backend
+    defaultBackend: 'filecoin-ipfs',
+    // Filecoin/IPFS configuration
+    pinata: {
+        gateway: 'https://gateway.pinata.cloud/ipfs/',
+        api: 'https://api.pinata.cloud'
+    },
+    // Celestia Data Availability
+    celestia: {
+        namespacePrefix: 'varity-',
+        testnetRPC: process.env.CELESTIA_TESTNET_RPC || 'https://rpc-mocha.pops.one'
+    },
+    // Encryption settings
+    encryption: {
+        algorithm: 'aes-256-gcm',
+        keyDerivation: 'pbkdf2',
+        iterations: 100000
+    },
+    // Multi-tier storage default configuration
+    multiTier: {
+        hotTier: {
+            backend: 'filecoin-ipfs',
+            replication: 3,
+            costPerGB: 0.001, // $0.001 per GB per month
+            accessLatency: 50 // 50ms average
+        },
+        coldTier: {
+            backend: 'filecoin-ipfs',
+            replication: 2,
+            costPerGB: 0.0005, // $0.0005 per GB per month
+            accessLatency: 200 // 200ms average
+        },
+        autoTiering: {
+            enabled: true,
+            policy: 'access-based',
+            checkInterval: 24, // Check every 24 hours
+            rules: [
+                {
+                    name: 'Demote to cold after 30 days',
+                    description: 'Move hot tier objects to cold tier if not accessed for 30 days',
+                    condition: {
+                        type: 'last_accessed',
+                        operator: 'gt',
+                        value: 30,
+                        unit: 'days'
+                    },
+                    action: {
+                        moveTo: 'cold',
+                        notify: false
+                    },
+                    priority: 1,
+                    enabled: true
+                },
+                {
+                    name: 'Promote frequently accessed',
+                    description: 'Move cold tier objects to hot tier if accessed more than 5 times',
+                    condition: {
+                        type: 'access_count',
+                        operator: 'gte',
+                        value: 5,
+                        unit: 'accesses'
+                    },
+                    action: {
+                        moveTo: 'hot',
+                        notify: false
+                    },
+                    priority: 2,
+                    enabled: true
+                }
+            ]
+        }
+    }
+};

package/dist/core/credentials-proxy.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Varity SDK - Credential Proxy Client
+ *
+ * Client-side integration with Varity Credential Proxy service.
+ * Fetches credentials from server-side proxy instead of bundling them in client code.
+ *
+ * **Security Model**:
+ * - Real credentials stored server-side ONLY
+ * - Client receives session-based tokens
+ * - No credentials in client bundles
+ * - Automatic session management
+ *
+ * @example Usage in SDK
+ * ```typescript
+ * import { ProxyCredentialClient } from '@varity-labs/sdk';
+ *
+ * const client = new ProxyCredentialClient();
+ * const credentials = await client.getCredentials();
+ *
+ * // Use credentials with Privy/thirdweb
+ * const privyAppId = credentials.privy.appId;
+ * const thirdwebClientId = credentials.thirdweb.clientId;
+ * ```
+ */
+import type { CredentialConfig } from './credentials';
+/**
+ * Configuration for ProxyCredentialClient
+ */
+export interface ProxyClientConfig {
+    /**
+     * URL of the credential proxy service
+     * @default "https://api.varity.so/credentials"
+     */
+    proxyUrl?: string;
+    /**
+     * App domain (auto-detected from window.location.hostname)
+     */
+    appDomain?: string;
+    /**
+     * Optional Varity App Store ID
+     */
+    appId?: string;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Credential Proxy Client
+ *
+ * Fetches Privy and thirdweb credentials from server-side proxy.
+ * Handles session management, caching, and automatic refresh.
+ */
+export declare class ProxyCredentialClient {
+    private proxyUrl;
+    private appDomain;
+    private appId?;
+    private debug;
+    private sessionToken;
+    private sessionExpiresAt;
+    private cachedCredentials;
+    constructor(config?: ProxyClientConfig);
+    /**
+     * Get credentials from proxy
+     *
+     * Automatically handles session creation and refresh.
+     *
+     * @returns Credential configuration
+     */
+    getCredentials(): Promise<CredentialConfig>;
+    /**
+     * Create a new session with the credential proxy
+     */
+    private createSession;
+    /**
+     * Get Privy configuration from proxy
+     */
+    private getPrivyConfig;
+    /**
+     * Get thirdweb configuration from proxy
+     */
+    private getThirdwebConfig;
+    /**
+     * Check if current session is still valid
+     */
+    private isSessionValid;
+    /**
+     * Detect app domain from browser environment
+     */
+    private detectAppDomain;
+    /**
+     * Clear cached credentials and session
+     */
+    clearCache(): void;
+    /**
+     * Debug logging
+     */
+    private log;
+}
+/**
+ * Get or create global ProxyCredentialClient instance
+ *
+ * @param config - Optional configuration (only used on first call)
+ * @returns Global ProxyCredentialClient instance
+ *
+ * @example
+ * ```typescript
+ * import { getProxyCredentials } from '@varity-labs/sdk';
+ *
+ * const credentials = await getProxyCredentials();
+ * // Use credentials.privy.appId and credentials.thirdweb.clientId
+ * ```
+ */
+export declare function getProxyCredentials(config?: ProxyClientConfig): Promise<CredentialConfig>;
+/**
+ * Check if credential proxy is available
+ *
+ * Tests connectivity to the credential proxy service.
+ *
+ * @param proxyUrl - Optional proxy URL (defaults to production URL)
+ * @returns true if proxy is available, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { isProxyAvailable } from '@varity-labs/sdk';
+ *
+ * if (await isProxyAvailable()) {
+ *   // Use proxy credentials
+ * } else {
+ *   // Fallback to manual credentials
+ * }
+ * ```
+ */
+export declare function isProxyAvailable(proxyUrl?: string): Promise<boolean>;
+/**
+ * Resolve credentials with automatic proxy fallback
+ *
+ * Attempts to use credential proxy first, falls back to manual credentials if proxy unavailable.
+ *
+ * @param manualAppId - Manual Privy app ID (fallback)
+ * @param manualClientId - Manual thirdweb client ID (fallback)
+ * @param config - Proxy client configuration
+ * @returns Resolved credentials
+ *
+ * @example
+ * ```typescript
+ * import { resolveCredentialsWithProxy } from '@varity-labs/sdk';
+ *
+ * const credentials = await resolveCredentialsWithProxy(
+ *   process.env.PRIVY_APP_ID,
+ *   process.env.THIRDWEB_CLIENT_ID
+ * );
+ * ```
+ */
+export declare function resolveCredentialsWithProxy(manualAppId?: string, manualClientId?: string, config?: ProxyClientConfig): Promise<CredentialConfig>;
+//# sourceMappingURL=credentials-proxy.d.ts.map

package/dist/core/credentials-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials-proxy.d.ts","sourceRoot":"","sources":["../../src/core/credentials-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA2BD;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,KAAK,CAAU;IAGvB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAAqB;IAG7C,OAAO,CAAC,iBAAiB,CAAiC;gBAE9C,MAAM,GAAE,iBAAsB;IAgB1C;;;;;;OAMG;IACG,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAiCjD;;OAEG;YACW,aAAa;IAsC3B;;OAEG;YACW,cAAc;IA+B5B;;OAEG;YACW,iBAAiB;IA+B/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,UAAU,IAAI,IAAI;IAOlB;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAM3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,GAAE,MAAuF,GAChG,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EACvB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAwE3B"}