@harukit/sdk 1.0.0

package/dist/config/manager.js

@@ -0,0 +1,221 @@
+/**
+ * ConfigManager - Validate and test configs against the Haru API
+ *
+ * @example
+ * ```typescript
+ * const result = await ConfigManager.validate(
+ *   { chains: ['arbitrum'] },
+ *   { apiKey: 'haru_live_demo123' }
+ * );
+ *
+ * if (result.valid) {
+ *   console.log('Config is valid!');
+ * }
+ * ```
+ */
+export class ConfigManager {
+    static getBaseUrl(options) {
+        return options.baseUrl || 'https://api.haruapi.com';
+    }
+    static getHeaders(options) {
+        return {
+            'Content-Type': 'application/json',
+            'X-API-Key': options.apiKey,
+        };
+    }
+    /**
+     * Validate a config against the API
+     * Checks if chains are allowed, tokens can be hydrated, etc.
+     */
+    static async validate(config, options) {
+        const baseUrl = this.getBaseUrl(options);
+        try {
+            const response = await fetch(`${baseUrl}/v1/config/verify`, {
+                method: 'POST',
+                headers: this.getHeaders(options),
+                body: JSON.stringify({ config }),
+            });
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({ error: 'Unknown error' }));
+                return {
+                    valid: false,
+                    errors: [error.error || `HTTP ${response.status}`],
+                };
+            }
+            const result = await response.json();
+            return {
+                valid: result.verified === true,
+                errors: result.error ? [result.error] : [],
+                config: result.config,
+                hydratedTokens: result.hydratedTokens,
+            };
+        }
+        catch (e) {
+            return {
+                valid: false,
+                errors: [e.message || 'Network error'],
+            };
+        }
+    }
+    /**
+     * Test a config by making dry-run calls to all endpoints
+     * This validates that the config works for all features
+     */
+    static async test(config, options) {
+        const baseUrl = this.getBaseUrl(options);
+        const headers = {
+            'X-API-Key': options.apiKey,
+            'X-Haru-Config': JSON.stringify(config),
+        };
+        const results = {
+            tokens: { success: false },
+            balances: { success: false },
+            swaps: { success: false },
+            transfers: { success: false },
+            yield: { success: false },
+            relay: { success: false },
+        };
+        // Test tokens
+        try {
+            const response = await fetch(`${baseUrl}/v1/tokens/defaults`, { headers });
+            results.tokens.success = response.ok;
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({}));
+                results.tokens.error = error.error;
+            }
+        }
+        catch (e) {
+            results.tokens.error = e.message;
+        }
+        // Test balances (requires userAddress - skip if no chains)
+        if (config.chains?.length > 0) {
+            try {
+                // Use a dummy address for testing
+                const dummyAddress = '0x0000000000000000000000000000000000000000';
+                const response = await fetch(`${baseUrl}/v1/balances/${dummyAddress}`, { headers });
+                // 400 is expected for dummy address, but API should respond
+                results.balances.success = response.status === 400 || response.ok;
+                if (!response.ok && response.status !== 400) {
+                    const error = await response.json().catch(() => ({}));
+                    results.balances.error = error.error;
+                }
+                else {
+                    results.balances.success = true;
+                }
+            }
+            catch (e) {
+                results.balances.error = e.message;
+            }
+        }
+        // Test swaps
+        try {
+            const response = await fetch(`${baseUrl}/v1/swaps/quote-by-usd`, {
+                method: 'POST',
+                headers: { ...headers, 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    userAddress: '0x0000000000000000000000000000000000000000',
+                    fromSymbol: 'USDC',
+                    toSymbol: 'WETH',
+                    usdValue: '100',
+                }),
+            });
+            // 400 is expected for dummy data, but API should respond
+            results.swaps.success = response.status === 400 || response.ok;
+            if (!response.ok && response.status !== 400) {
+                const error = await response.json().catch(() => ({}));
+                results.swaps.error = error.error;
+            }
+            else {
+                results.swaps.success = true;
+            }
+        }
+        catch (e) {
+            results.swaps.error = e.message;
+        }
+        // Test transfers
+        try {
+            const response = await fetch(`${baseUrl}/v1/transfers/by-usd`, {
+                method: 'POST',
+                headers: { ...headers, 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    fromUser: '0x0000000000000000000000000000000000000000',
+                    toUser: '0x0000000000000000000000000000000000000001',
+                    tokenSymbol: 'USDC',
+                    usdValue: '100',
+                }),
+            });
+            results.transfers.success = response.status === 400 || response.ok;
+            if (!response.ok && response.status !== 400) {
+                const error = await response.json().catch(() => ({}));
+                results.transfers.error = error.error;
+            }
+            else {
+                results.transfers.success = true;
+            }
+        }
+        catch (e) {
+            results.transfers.error = e.message;
+        }
+        // Test yield
+        try {
+            const response = await fetch(`${baseUrl}/v1/yield/rates`, { headers });
+            results.yield.success = response.ok;
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({}));
+                results.yield.error = error.error;
+            }
+        }
+        catch (e) {
+            results.yield.error = e.message;
+        }
+        // Test relay
+        try {
+            const response = await fetch(`${baseUrl}/v1/relay/sponsor`, { headers });
+            results.relay.success = response.ok;
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({}));
+                results.relay.error = error.error;
+            }
+        }
+        catch (e) {
+            results.relay.error = e.message;
+        }
+        return results;
+    }
+    /**
+     * Create a config from a template
+     * This is local-only, doesn't validate against API
+     */
+    static create(template) {
+        const now = Date.now();
+        const templates = {
+            minimal: {
+                chains: ['arbitrum'],
+                sig: '',
+                ts: now,
+                exp: now + 30 * 24 * 60 * 60 * 1000, // 30 days
+            },
+            default: {
+                chains: ['arbitrum', 'base'],
+                tokens: ['USDC', 'WETH'],
+                primaryUsd: ['USDC'],
+                sig: '',
+                ts: now,
+                exp: now + 30 * 24 * 60 * 60 * 1000,
+            },
+            full: {
+                chains: ['arbitrum', 'base', 'optimism', 'ethereum'],
+                tokens: ['USDC', 'USDT', 'WETH', 'WBTC'],
+                primaryUsd: ['USDC', 'USDT'],
+                yield: {
+                    enabled: true,
+                    allowList: ['USDC', 'USDT'],
+                },
+                sig: '',
+                ts: now,
+                exp: now + 30 * 24 * 60 * 60 * 1000,
+            },
+        };
+        return templates[template || 'default'];
+    }
+}

package/dist/haru-7702.d.ts

@@ -0,0 +1,85 @@
+import { type Address } from 'viem';
+import type { CleanSwapQuote, CleanTransfer, EIP7702Call, ChainCallBundle, SignedBatch, SimulationResult, TxStatus, NonceMetadata, SponsorTxResponse, PrivySignRawHash, Haru7702Options as Haru7702OptionsType, MultiInputSwapQuote } from '@harukit/types';
+export type { Haru7702Options } from '@harukit/types';
+/**
+ * Haru7702 — EIP-7702 batch transaction client with gas sponsorship.
+ *
+ * @example Single-chain swap (one-shot)
+ * ```ts
+ * const haru = new Haru7702({ apiKey: '...' }); // defaultChain = 'arbitrum'
+ * await haru.executeSwap({ quote, wallet, signAuthorization });
+ * ```
+ *
+ * @example Multi-chain swap (automatic parallel execution)
+ * ```ts
+ * const haru = new Haru7702({ apiKey: '...' });
+ * const batches = haru.buildCalls(quote); // Map { 'arbitrum' → ChainCallBundle, 'base' → ChainCallBundle }
+ * await haru.executeSwap({ quote, wallet, signAuthorization }); // handles multi-chain automatically
+ * ```
+ *
+ * @example Transfer
+ * ```ts
+ * await haru.executeTransfer({ transfer, wallet, signAuthorization });
+ * ```
+ */
+export declare class Haru7702 {
+    private defaultChain;
+    private apiBaseUrl;
+    private apiKey;
+    constructor(options?: Haru7702OptionsType);
+    private getHeaders;
+    private serializeWithBigInt;
+    createSignRawHash(wallet: any): Promise<PrivySignRawHash>;
+    signAuthorization(signAuthorization: any, walletAddress: string, chain?: string): Promise<string>;
+    signBatchCall(calls: EIP7702Call[], nonce: bigint, deadline: bigint, sponsor: Address, signRawHash: PrivySignRawHash, walletAddress: string, chain?: string): Promise<string>;
+    /**
+     * Build execution calls from a swap quote or transfer.
+     * Always returns calls grouped by chain as Map<chain, ChainCallBundle>.
+     * Works for both single-chain and multi-chain operations.
+     */
+    buildCalls(quote: CleanSwapQuote | MultiInputSwapQuote | CleanTransfer): Map<string, ChainCallBundle>;
+    /**
+     * Execute a swap in one call. Handles multi-chain automatically.
+     * Returns immediately with transaction hashes (does not wait for confirmation).
+     */
+    executeSwap(params: {
+        quote: CleanSwapQuote | MultiInputSwapQuote;
+        wallet: any;
+        signAuthorization: any;
+        deadline?: bigint;
+    }): Promise<Map<string, SponsorTxResponse>>;
+    /**
+     * Execute a transfer in one call.
+     * Returns immediately with transaction hash (does not wait for confirmation).
+     */
+    executeTransfer(params: {
+        transfer: CleanTransfer;
+        wallet: any;
+        signAuthorization: any;
+        deadline?: bigint;
+    }): Promise<Map<string, SponsorTxResponse>>;
+    /**
+     * Execute a pre-built bundle (from buildCalls) in one call.
+     * Useful when you've combined multiple quotes into a single bundle.
+     * Returns immediately with transaction hash (does not wait for confirmation).
+     */
+    executeBatch(params: {
+        bundle: ChainCallBundle;
+        wallet: any;
+        signAuthorization: any;
+        deadline?: bigint;
+    }): Promise<Map<string, SponsorTxResponse>>;
+    /**
+     * Get the contract address for a specific chain.
+     * Fetches from the dedicated contract-address endpoint.
+     */
+    getContractAddress(chainId: number): Promise<Address>;
+    getSponsorAddress(): Promise<Address>;
+    getNonce(userAddress: Address, chain?: string): Promise<bigint>;
+    getNonceMetadata(userAddress: Address, chainId?: number): Promise<NonceMetadata>;
+    simulateTx(authorization: string, signedBatch: SignedBatch, userEOA: Address, chain?: string): Promise<SimulationResult>;
+    sponsorTx(signedBatch: SignedBatch, authorization: string, userEOA: Address, chain?: string): Promise<SponsorTxResponse>;
+    waitForTx(txHash: string, chain?: string): Promise<TxStatus>;
+    getTxStatus(txHash: string, chain?: string): Promise<TxStatus>;
+}
+//# sourceMappingURL=haru-7702.d.ts.map

package/dist/haru-7702.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"haru-7702.d.ts","sourceRoot":"","sources":["../src/haru-7702.ts"],"names":[],"mappings":"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"}