@terkoizmy/intent-sdk 1.0.0

package/dist/shared/chain-registry/chain-names.js

@@ -0,0 +1,49 @@
+/**
+ * Chain Names — Human-Readable Display Names
+ *
+ * Static lookup map for well-known EVM chain IDs.
+ * Zero external dependencies — used across error messages and logging.
+ *
+ * Stage 3 — Phase G (Production Hardening)
+ */
+/**
+ * Well-known EVM chain ID → human-readable name.
+ */
+export const CHAIN_NAMES = {
+    // Mainnets
+    1: "Ethereum",
+    10: "Optimism",
+    56: "BNB Chain",
+    100: "Gnosis",
+    137: "Polygon",
+    250: "Fantom",
+    324: "zkSync Era",
+    8453: "Base",
+    42161: "Arbitrum One",
+    43114: "Avalanche",
+    59144: "Linea",
+    534352: "Scroll",
+    // Testnets
+    5: "Goerli",
+    1301: "Unichain Sepolia",
+    11155111: "Sepolia",
+    84532: "Base Sepolia",
+    421614: "Arbitrum Sepolia",
+    11155420: "Optimism Sepolia",
+};
+/**
+ * Get a human-readable display name for a chain ID.
+ *
+ * Returns `"Ethereum (1)"` for known chains or `"Unknown Chain (99999)"` for unknown.
+ *
+ * @param chainId - Numeric EVM chain ID
+ * @returns Display string like `"Arbitrum One (42161)"`
+ */
+export function getChainDisplayName(chainId) {
+    const name = CHAIN_NAMES[chainId];
+    if (name) {
+        return `${name} (${chainId})`;
+    }
+    return `Unknown Chain (${chainId})`;
+}
+//# sourceMappingURL=chain-names.js.map

package/dist/shared/chain-registry/chain-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain-names.js","sourceRoot":"","sources":["../../../src/shared/chain-registry/chain-names.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAA2B;IAC/C,WAAW;IACX,CAAC,EAAE,UAAU;IACb,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,WAAW;IACf,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,cAAc;IACrB,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAEhB,WAAW;IACX,CAAC,EAAE,QAAQ;IACX,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,kBAAkB;CAC/B,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,IAAI,EAAE,CAAC;QACP,OAAO,GAAG,IAAI,KAAK,OAAO,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,kBAAkB,OAAO,GAAG,CAAC;AACxC,CAAC"}

package/dist/shared/chain-registry/configs/arbitrum-sepolia.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Arbitrum Sepolia Testnet Chain Config
+ *
+ * Re-export from centralized testnets config for convenience.
+ *
+ * Stage 3 — Live Integration
+ */
+export { ARBITRUM_SEPOLIA_CONFIG } from "../../../config/testnets";
+//# sourceMappingURL=arbitrum-sepolia.d.ts.map

package/dist/shared/chain-registry/configs/arbitrum-sepolia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arbitrum-sepolia.d.ts","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/arbitrum-sepolia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/chain-registry/configs/arbitrum-sepolia.js

@@ -0,0 +1,9 @@
+/**
+ * Arbitrum Sepolia Testnet Chain Config
+ *
+ * Re-export from centralized testnets config for convenience.
+ *
+ * Stage 3 — Live Integration
+ */
+export { ARBITRUM_SEPOLIA_CONFIG } from "../../../config/testnets";
+//# sourceMappingURL=arbitrum-sepolia.js.map

package/dist/shared/chain-registry/configs/arbitrum-sepolia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arbitrum-sepolia.js","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/arbitrum-sepolia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/chain-registry/configs/base-sepolia.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Base Sepolia Testnet Chain Config
+ *
+ * Re-export from centralized testnets config for convenience.
+ *
+ * Stage 3 — Live Integration
+ */
+export { BASE_SEPOLIA_CONFIG } from "../../../config/testnets";
+//# sourceMappingURL=base-sepolia.d.ts.map

package/dist/shared/chain-registry/configs/base-sepolia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-sepolia.d.ts","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/base-sepolia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/chain-registry/configs/base-sepolia.js

@@ -0,0 +1,9 @@
+/**
+ * Base Sepolia Testnet Chain Config
+ *
+ * Re-export from centralized testnets config for convenience.
+ *
+ * Stage 3 — Live Integration
+ */
+export { BASE_SEPOLIA_CONFIG } from "../../../config/testnets";
+//# sourceMappingURL=base-sepolia.js.map

package/dist/shared/chain-registry/configs/base-sepolia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-sepolia.js","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/base-sepolia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/chain-registry/configs/ethereum.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Ethereum Chain Config
+ *
+ * Re-export from centralized chains config for convenience.
+ */
+export { ETHEREUM_CONFIG } from "../../../config/chains";
+//# sourceMappingURL=ethereum.d.ts.map

package/dist/shared/chain-registry/configs/ethereum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethereum.d.ts","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/ethereum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/shared/chain-registry/configs/ethereum.js

@@ -0,0 +1,7 @@
+/**
+ * Ethereum Chain Config
+ *
+ * Re-export from centralized chains config for convenience.
+ */
+export { ETHEREUM_CONFIG } from "../../../config/chains";
+//# sourceMappingURL=ethereum.js.map

package/dist/shared/chain-registry/configs/ethereum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethereum.js","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/ethereum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/shared/chain-registry/configs/polygon.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Polygon Chain Config
+ *
+ * Re-export from centralized chains config for convenience.
+ */
+export { POLYGON_CONFIG } from "../../../config/chains";
+//# sourceMappingURL=polygon.d.ts.map

package/dist/shared/chain-registry/configs/polygon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/polygon.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/shared/chain-registry/configs/polygon.js

@@ -0,0 +1,7 @@
+/**
+ * Polygon Chain Config
+ *
+ * Re-export from centralized chains config for convenience.
+ */
+export { POLYGON_CONFIG } from "../../../config/chains";
+//# sourceMappingURL=polygon.js.map

package/dist/shared/chain-registry/configs/polygon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon.js","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/polygon.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/shared/chain-registry/configs/sepolia.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Ethereum Sepolia Testnet Chain Config
+ *
+ * Re-export from centralized testnets config for convenience.
+ *
+ * Stage 3 — Live Integration
+ */
+export { SEPOLIA_CONFIG } from "../../../config/testnets";
+//# sourceMappingURL=sepolia.d.ts.map

package/dist/shared/chain-registry/configs/sepolia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sepolia.d.ts","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/sepolia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/chain-registry/configs/sepolia.js

@@ -0,0 +1,9 @@
+/**
+ * Ethereum Sepolia Testnet Chain Config
+ *
+ * Re-export from centralized testnets config for convenience.
+ *
+ * Stage 3 — Live Integration
+ */
+export { SEPOLIA_CONFIG } from "../../../config/testnets";
+//# sourceMappingURL=sepolia.js.map

package/dist/shared/chain-registry/configs/sepolia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sepolia.js","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/sepolia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/chain-registry/configs/unichain-sepolia.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Unichain Sepolia Testnet Chain Config
+ *
+ * Re-export from centralized testnets config for convenience.
+ *
+ * Stage 3 — Live Integration
+ */
+export { UNICHAIN_SEPOLIA_CONFIG } from "../../../config/testnets";
+//# sourceMappingURL=unichain-sepolia.d.ts.map

package/dist/shared/chain-registry/configs/unichain-sepolia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unichain-sepolia.d.ts","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/unichain-sepolia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/chain-registry/configs/unichain-sepolia.js

@@ -0,0 +1,9 @@
+/**
+ * Unichain Sepolia Testnet Chain Config
+ *
+ * Re-export from centralized testnets config for convenience.
+ *
+ * Stage 3 — Live Integration
+ */
+export { UNICHAIN_SEPOLIA_CONFIG } from "../../../config/testnets";
+//# sourceMappingURL=unichain-sepolia.js.map

package/dist/shared/chain-registry/configs/unichain-sepolia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unichain-sepolia.js","sourceRoot":"","sources":["../../../../src/shared/chain-registry/configs/unichain-sepolia.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/shared/chain-registry/registry.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Chain Registry
+ *
+ * Central registry for all supported EVM chain configurations.
+ * Singleton-like pattern — register once, lookup by chainId.
+ *
+ * USAGE:
+ *   const registry = new ChainRegistry();
+ *   registry.register(ETHEREUM_CONFIG);
+ *   registry.register(POLYGON_CONFIG);
+ *
+ *   const eth = registry.get(1);
+ *   console.log(eth.name); // "Ethereum"
+ */
+import type { ChainConfig } from "../../types/chain";
+import type { ChainId } from "../../types/common";
+export declare class ChainRegistry {
+    private chains;
+    /**
+     * Register a chain configuration.
+     * Throws if chain with same ID is already registered.
+     */
+    register(config: ChainConfig): void;
+    /**
+     * Register multiple chains at once.
+     */
+    registerAll(configs: ChainConfig[]): void;
+    /**
+     * Get chain config by ID.
+     * Throws if chain is not registered.
+     */
+    get(chainId: ChainId): ChainConfig;
+    /**
+     * Check if a chain is registered.
+     */
+    has(chainId: ChainId): boolean;
+    /**
+     * Get all registered chain configs.
+     */
+    list(): ChainConfig[];
+    /**
+     * Get all registered chain IDs.
+     */
+    listIds(): ChainId[];
+    /**
+     * Get number of registered chains.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/shared/chain-registry/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/shared/chain-registry/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,qBAAa,aAAa;IACtB,OAAO,CAAC,MAAM,CAAwC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IASnC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAMzC;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW;IAQlC;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAI9B;;OAEG;IACH,IAAI,IAAI,WAAW,EAAE;IAIrB;;OAEG;IACH,OAAO,IAAI,OAAO,EAAE;IAIpB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/shared/chain-registry/registry.js

@@ -0,0 +1,72 @@
+/**
+ * Chain Registry
+ *
+ * Central registry for all supported EVM chain configurations.
+ * Singleton-like pattern — register once, lookup by chainId.
+ *
+ * USAGE:
+ *   const registry = new ChainRegistry();
+ *   registry.register(ETHEREUM_CONFIG);
+ *   registry.register(POLYGON_CONFIG);
+ *
+ *   const eth = registry.get(1);
+ *   console.log(eth.name); // "Ethereum"
+ */
+import { getChainDisplayName } from "./chain-names";
+export class ChainRegistry {
+    chains = new Map();
+    /**
+     * Register a chain configuration.
+     * Throws if chain with same ID is already registered.
+     */
+    register(config) {
+        if (this.chains.has(config.id)) {
+            throw new Error(`Chain ${config.id} (${config.name}) is already registered`);
+        }
+        this.chains.set(config.id, config);
+    }
+    /**
+     * Register multiple chains at once.
+     */
+    registerAll(configs) {
+        for (const config of configs) {
+            this.register(config);
+        }
+    }
+    /**
+     * Get chain config by ID.
+     * Throws if chain is not registered.
+     */
+    get(chainId) {
+        const config = this.chains.get(chainId);
+        if (!config) {
+            throw new Error(`Chain ${getChainDisplayName(chainId)} is not registered`);
+        }
+        return config;
+    }
+    /**
+     * Check if a chain is registered.
+     */
+    has(chainId) {
+        return this.chains.has(chainId);
+    }
+    /**
+     * Get all registered chain configs.
+     */
+    list() {
+        return Array.from(this.chains.values());
+    }
+    /**
+     * Get all registered chain IDs.
+     */
+    listIds() {
+        return Array.from(this.chains.keys());
+    }
+    /**
+     * Get number of registered chains.
+     */
+    get size() {
+        return this.chains.size;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/shared/chain-registry/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/shared/chain-registry/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,OAAO,aAAa;IACd,MAAM,GAA8B,IAAI,GAAG,EAAE,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,MAAmB;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACX,SAAS,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,yBAAyB,CAC9D,CAAC;QACN,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAsB;QAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,OAAgB;QAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,SAAS,mBAAmB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,OAAgB;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,OAAO;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC5B,CAAC;CACJ"}

package/dist/shared/rpc/provider-manager.d.ts

@@ -0,0 +1,111 @@
+/**
+ * RPC Provider Manager
+ *
+ * Manages JSON-RPC provider connections to multiple chains.
+ * Features: caching, fallback URLs, basic ERC20 balance queries.
+ *
+ * NOTE: Ini adalah lightweight abstraction.
+ * Provider-specific logic (ethers.JsonRpcProvider / viem publicClient)
+ * diinject via factory pattern.
+ *
+ * USAGE:
+ *   const rpm = new RPCProviderManager(chainRegistry);
+ *   const balance = await rpm.getTokenBalance(137, usdcAddr, walletAddr);
+ */
+import type { ChainConfig } from "../../types/chain";
+import type { Address, ChainId } from "../../types/common";
+/**
+ * Abstract RPC Provider interface
+ *
+ * Abstraction atas JSON-RPC calls. Implement with ethers.js, viem, or fetch.
+ */
+export interface IRPCProvider {
+    /** Chain ID this provider is connected to */
+    chainId: ChainId;
+    /** Call a contract view function */
+    call(to: Address, data: string): Promise<string>;
+    /** Get current block number */
+    getBlockNumber(): Promise<number>;
+    /** Get transaction receipt */
+    getTransactionReceipt(txHash: string): Promise<{
+        status: number;
+        blockNumber: number;
+        gasUsed: string;
+    } | null>;
+    /** Get gas price in wei */
+    getGasPrice(): Promise<string>;
+    /** Check if provider is healthy */
+    isHealthy(): Promise<boolean>;
+    /**
+     * Send a signed (serialized) transaction to the network.
+     * Returns the transaction hash.
+     *
+     * Stage 3 — Phase B addition
+     */
+    sendRawTransaction?(signedTx: `0x${string}`): Promise<string>;
+    /**
+     * Estimate gas required for a transaction.
+     *
+     * Stage 3 — Phase B addition
+     */
+    estimateGas?(tx: {
+        to: Address;
+        data?: string;
+        value?: bigint;
+        from?: Address;
+    }): Promise<bigint>;
+}
+/**
+ * Provider factory function type
+ *
+ * Given a chain config, create an IRPCProvider.
+ * Memungkinkan inject ethers.js atau viem tanpa hard dependency.
+ */
+export type ProviderFactory = (config: ChainConfig) => IRPCProvider;
+/**
+ * RPCProviderManager
+ *
+ * Central manager for all RPC providers across chains.
+ * Auto-creates and caches providers per chain.
+ */
+export declare class RPCProviderManager {
+    private providers;
+    private chainConfigs;
+    private providerFactory?;
+    constructor(providerFactory?: ProviderFactory);
+    /**
+     * Set or update the provider factory after instantiation.
+     */
+    setProviderFactory(factory: ProviderFactory): void;
+    /**
+     * Register a chain config (called by initialization logic)
+     */
+    registerChain(config: ChainConfig): void;
+    /**
+     * Register multiple chain configs
+     */
+    registerChains(configs: ChainConfig[]): void;
+    /**
+     * Get or create a provider for a specific chain.
+     * Providers are cached after first creation.
+     *
+     * Throws if no provider factory is configured or chain is not registered.
+     */
+    getProvider(chainId: ChainId): IRPCProvider;
+    /**
+     * Get ERC20 token balance for a wallet on a specific chain.
+     *
+     * Calls balanceOf(address) on the token contract.
+     * Returns balance in token's smallest unit.
+     */
+    getTokenBalance(chainId: ChainId, tokenAddress: Address, walletAddress: Address): Promise<bigint>;
+    /**
+     * Check if all registered chains have healthy providers.
+     */
+    checkHealth(): Promise<Map<ChainId, boolean>>;
+    /**
+     * Clear all cached providers (for testing or reconnection).
+     */
+    clearProviders(): void;
+}
+//# sourceMappingURL=provider-manager.d.ts.map

package/dist/shared/rpc/provider-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-manager.d.ts","sourceRoot":"","sources":["../../../src/shared/rpc/provider-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG3D;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IAEjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD,+BAA+B;IAC/B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC,8BAA8B;IAC9B,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC3C,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACnB,GAAG,IAAI,CAAC,CAAC;IAEV,2BAA2B;IAC3B,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/B,mCAAmC;IACnC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B;;;;;OAKG;IACH,kBAAkB,CAAC,CAAC,QAAQ,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9D;;;;OAIG;IACH,WAAW,CAAC,CAAC,EAAE,EAAE;QACb,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,YAAY,CAAC;AAEpE;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,eAAe,CAAC,CAAkB;gBAE9B,eAAe,CAAC,EAAE,eAAe;IAI7C;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAIlD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIxC;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;IAM5C;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IAuB3C;;;;;OAKG;IACG,eAAe,CACjB,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,GACvB,OAAO,CAAC,MAAM,CAAC;IAkBlB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAgBnD;;OAEG;IACH,cAAc,IAAI,IAAI;CAGzB"}

package/dist/shared/rpc/provider-manager.js

@@ -0,0 +1,116 @@
+/**
+ * RPC Provider Manager
+ *
+ * Manages JSON-RPC provider connections to multiple chains.
+ * Features: caching, fallback URLs, basic ERC20 balance queries.
+ *
+ * NOTE: Ini adalah lightweight abstraction.
+ * Provider-specific logic (ethers.JsonRpcProvider / viem publicClient)
+ * diinject via factory pattern.
+ *
+ * USAGE:
+ *   const rpm = new RPCProviderManager(chainRegistry);
+ *   const balance = await rpm.getTokenBalance(137, usdcAddr, walletAddr);
+ */
+import { getChainDisplayName } from "../chain-registry/chain-names";
+/**
+ * RPCProviderManager
+ *
+ * Central manager for all RPC providers across chains.
+ * Auto-creates and caches providers per chain.
+ */
+export class RPCProviderManager {
+    providers = new Map();
+    chainConfigs = new Map();
+    providerFactory;
+    constructor(providerFactory) {
+        this.providerFactory = providerFactory;
+    }
+    /**
+     * Set or update the provider factory after instantiation.
+     */
+    setProviderFactory(factory) {
+        this.providerFactory = factory;
+    }
+    /**
+     * Register a chain config (called by initialization logic)
+     */
+    registerChain(config) {
+        this.chainConfigs.set(config.id, config);
+    }
+    /**
+     * Register multiple chain configs
+     */
+    registerChains(configs) {
+        for (const config of configs) {
+            this.registerChain(config);
+        }
+    }
+    /**
+     * Get or create a provider for a specific chain.
+     * Providers are cached after first creation.
+     *
+     * Throws if no provider factory is configured or chain is not registered.
+     */
+    getProvider(chainId) {
+        // Return cached provider
+        const cached = this.providers.get(chainId);
+        if (cached)
+            return cached;
+        // Create new provider
+        const config = this.chainConfigs.get(chainId);
+        if (!config) {
+            throw new Error(`Chain ${getChainDisplayName(chainId)} is not registered in RPCProviderManager`);
+        }
+        if (!this.providerFactory) {
+            throw new Error("RPCProviderManager requires a providerFactory. " +
+                "Provide one via constructor.");
+        }
+        const provider = this.providerFactory(config);
+        this.providers.set(chainId, provider);
+        return provider;
+    }
+    /**
+     * Get ERC20 token balance for a wallet on a specific chain.
+     *
+     * Calls balanceOf(address) on the token contract.
+     * Returns balance in token's smallest unit.
+     */
+    async getTokenBalance(chainId, tokenAddress, walletAddress) {
+        const provider = this.getProvider(chainId);
+        // ERC20 balanceOf(address) selector = 0x70a08231
+        // ABI encode: selector + padded address
+        const data = "0x70a08231" +
+            walletAddress.slice(2).padStart(64, "0");
+        const result = await provider.call(tokenAddress, data);
+        // Parse hex result to bigint
+        if (!result || result === "0x" || result === "0x0") {
+            return 0n;
+        }
+        return BigInt(result);
+    }
+    /**
+     * Check if all registered chains have healthy providers.
+     */
+    async checkHealth() {
+        const results = new Map();
+        for (const chainId of this.chainConfigs.keys()) {
+            try {
+                const provider = this.getProvider(chainId);
+                const healthy = await provider.isHealthy();
+                results.set(chainId, healthy);
+            }
+            catch {
+                results.set(chainId, false);
+            }
+        }
+        return results;
+    }
+    /**
+     * Clear all cached providers (for testing or reconnection).
+     */
+    clearProviders() {
+        this.providers.clear();
+    }
+}
+//# sourceMappingURL=provider-manager.js.map

package/dist/shared/rpc/provider-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-manager.js","sourceRoot":"","sources":["../../../src/shared/rpc/provider-manager.ts"],"names":[],"mappings":"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"}