@terkoizmy/intent-sdk 1.0.0

package/dist/solver/types/inventory.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Inventory Management Types
+ *
+ * Types untuk tracking balance USDC/token di semua chains
+ * dan rebalancing antar chain.
+ */
+import type { ChainId } from "../../types/common";
+/**
+ * Balance on a single chain for a single token
+ *
+ * Tracks available, locked, and total balance.
+ * Locked = reserved for pending intent fulfillment.
+ */
+export interface InventoryBalance {
+    /** Chain ID where this balance is held */
+    chainId: ChainId;
+    /** Token symbol (e.g., "USDC") */
+    token: string;
+    /** Available balance (not locked) — in token's smallest unit (e.g., 6 decimals for USDC) */
+    available: bigint;
+    /** Locked balance (reserved for pending intents) */
+    locked: bigint;
+    /** Timestamp when this balance was last refreshed from on-chain */
+    lastUpdated: number;
+}
+/**
+ * Full inventory snapshot across all chains
+ *
+ * Digunakan untuk monitoring dashboard & rebalancing decisions.
+ */
+export interface InventorySnapshot {
+    /** All balances across chains and tokens */
+    balances: InventoryBalance[];
+    /** Total value in USD (sum of all token balances) */
+    totalUSDValue: string;
+    /** Timestamp ketika snapshot diambil */
+    timestamp: number;
+}
+/**
+ * Rebalancing task priority
+ */
+export type RebalancePriority = "low" | "medium" | "high" | "critical";
+/**
+ * Task untuk rebalancing token antar chain
+ *
+ * CONTOH:
+ *   {
+ *     fromChain: 1,       // Ethereum
+ *     toChain: 137,       // Polygon
+ *     token: "USDC",
+ *     amount: 50000n * 10n**6n, // 50,000 USDC
+ *     reason: "Polygon balance below 20% threshold",
+ *     priority: "high"
+ *   }
+ */
+export interface RebalanceTask {
+    /** Source chain ID (where we have excess) */
+    fromChain: ChainId;
+    /** Target chain ID (where we need more) */
+    toChain: ChainId;
+    /** Token symbol to rebalance */
+    token: string;
+    /** Amount to bridge (in token's smallest unit) */
+    amount: bigint;
+    /** Human-readable reason for rebalancing */
+    reason: string;
+    /** Task priority — critical tasks are executed first */
+    priority: RebalancePriority;
+}
+/**
+ * Inventory configuration
+ */
+export interface InventoryConfig {
+    /** Minimum reserve percentage per chain (0-1). Default: 0.1 (10%) */
+    minReservePercent: number;
+    /** Rebalance trigger threshold (0-1). Default: 0.15 (15% deviation) */
+    rebalanceThreshold: number;
+    /** Target distribution per chain (chainId → percentage). If not set, distributes equally */
+    targetDistribution?: Record<ChainId, number>;
+    /** Polling interval for balance refresh (milliseconds). Default: 30_000 */
+    pollingIntervalMs?: number;
+}
+//# sourceMappingURL=inventory.d.ts.map

package/dist/solver/types/inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.d.ts","sourceRoot":"","sources":["../../../src/solver/types/inventory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC7B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IAEjB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,4FAA4F;IAC5F,SAAS,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IAEf,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAC9B,4CAA4C;IAC5C,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAE7B,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IAEtB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC1B,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IAEnB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IAEjB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IAEd,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IAEf,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IAEf,wDAAwD;IACxD,QAAQ,EAAE,iBAAiB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,CAAC;IAE1B,uEAAuE;IACvE,kBAAkB,EAAE,MAAM,CAAC;IAE3B,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAE7C,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/solver/types/inventory.js

@@ -0,0 +1,8 @@
+/**
+ * Inventory Management Types
+ *
+ * Types untuk tracking balance USDC/token di semua chains
+ * dan rebalancing antar chain.
+ */
+export {};
+//# sourceMappingURL=inventory.js.map

package/dist/solver/types/inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory.js","sourceRoot":"","sources":["../../../src/solver/types/inventory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/solver/types/pricing.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Pricing Types
+ *
+ * Types untuk fee calculation dan dynamic pricing engine.
+ * Fee = baseFee + gasCost + slippageCapture
+ */
+/**
+ * Pricing Result
+ *
+ * Full fee breakdown dari pricing engine.
+ * Semua amount dalam token's smallest unit (e.g., 6 decimals for USDC).
+ *
+ * CONTOH untuk 1000 USDC bridge:
+ *   {
+ *     baseFee: "5000000",            // 5 USDC (0.5%)
+ *     gasCost: "500000",             // 0.5 USDC
+ *     slippageCapture: "2500000",    // 2.5 USDC (50% of user's max slippage)
+ *     totalFee: "8000000",           // 8 USDC total
+ *     userPays: "1000000000",        // 1000 USDC
+ *     userReceives: "992000000",     // 992 USDC
+ *     solverProfit: "7500000",       // 7.5 USDC (totalFee - gasCost)
+ *   }
+ */
+export interface PricingResult {
+    /** Base fee (amount * baseFeePercent) */
+    baseFee: string;
+    /** Estimated gas cost in token equivalent (USDC) */
+    gasCost: string;
+    /** Slippage capture from user's max slippage tolerance */
+    slippageCapture: string;
+    /** Total fee = baseFee + gasCost + slippageCapture */
+    totalFee: string;
+    /** Total amount user pays (including fees locked in contract) */
+    userPays: string;
+    /** Amount user actually receives on target chain */
+    userReceives: string;
+    /** Net solver profit = totalFee - gasCost */
+    solverProfit: string;
+}
+/**
+ * Pricing Configuration
+ *
+ * DEFAULTS:
+ *   baseFeePercent: 0.005 (0.5%)
+ *   minFeeUSD: 1
+ *   maxFeePercent: 0.03 (3%)
+ *   slippageSharePercent: 0.5 (50% of user's max slippage)
+ */
+export interface PricingConfig {
+    /** Base fee as percentage of amount (0.005 = 0.5%) */
+    baseFeePercent: number;
+    /** Minimum fee in USD — enforce even for small amounts */
+    minFeeUSD: number;
+    /** Maximum fee as percentage (cap to prevent excessive fees) */
+    maxFeePercent: number;
+    /** Share of user's max slippage that solver captures (0.5 = 50%) */
+    slippageSharePercent: number;
+}
+//# sourceMappingURL=pricing.d.ts.map

package/dist/solver/types/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../../src/solver/types/pricing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAa;IAC1B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAEhB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;IAExB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IAEjB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IAEjB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC1B,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IAEvB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAElB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IAEtB,oEAAoE;IACpE,oBAAoB,EAAE,MAAM,CAAC;CAChC"}

package/dist/solver/types/pricing.js

@@ -0,0 +1,8 @@
+/**
+ * Pricing Types
+ *
+ * Types untuk fee calculation dan dynamic pricing engine.
+ * Fee = baseFee + gasCost + slippageCapture
+ */
+export {};
+//# sourceMappingURL=pricing.js.map

package/dist/solver/types/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../../src/solver/types/pricing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/solver/types/settlement.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Settlement Types
+ *
+ * Types untuk cross-chain settlement dan proof verification.
+ * Settlement = proses claim funds di source chain setelah
+ * berhasil mengirim funds di target chain.
+ */
+import type { Address, ChainId, Hash } from "../../types/common";
+/**
+ * Parameters for generating a signature proof.
+ */
+export interface ProofGenerationParams {
+    /** Unique intent ID */
+    intentId: string;
+    /** Transaction hash on target chain (fulfillment tx) */
+    targetTxHash: Hash;
+    /** Target chain ID */
+    targetChainId: ChainId;
+    /** Amount transferred (in token's smallest unit) */
+    amount: string;
+    /** Recipient address on target chain */
+    recipient: Address;
+    /** Number of block confirmations to wait (default: 3) */
+    confirmations?: number;
+}
+/** Wallet signing capability (subset of WalletManager) */
+export interface IProofSigner {
+    getAddress(): Address | Promise<Address>;
+    signMessage(message: string | Uint8Array): Promise<string>;
+}
+/** RPC provider capability (subset of RPCProviderManager) */
+export interface IProviderForProof {
+    getTransactionReceipt(chainId: ChainId, txHash: Hash): Promise<{
+        blockNumber: number;
+        status: number;
+    } | null>;
+    getBlockNumber(chainId: ChainId): Promise<number>;
+}
+/**
+ * Settlement status
+ */
+export type SettlementStatus = "pending" | "proving" | "claiming" | "completed" | "failed";
+/**
+ * Settlement record
+ *
+ * Merepresentasikan satu settlement cycle:
+ * 1. Solver kirim di target chain (targetTx)
+ * 2. Generate proof
+ * 3. Claim di source chain (sourceTx)
+ */
+export interface Settlement {
+    /** Intent ID yang di-settle */
+    intentId: string;
+    /** Solver address yang melakukan settlement */
+    solver: Address;
+    /** Transaction hash di source chain (claim tx) */
+    sourceTx?: Hash;
+    /** Transaction hash di target chain (fulfillment tx) */
+    targetTx: Hash;
+    /** Cross-chain proof used for claim */
+    proof?: CrossChainProof;
+    /** Current settlement status */
+    status: SettlementStatus;
+    /** Timestamp ketika settlement selesai (Unix seconds) */
+    settledAt?: number;
+    /** Timestamp ketika settlement dimulai */
+    startedAt: number;
+    /** Number of claim attempts (for retry tracking) */
+    claimAttempts: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Cross-Chain Proof
+ *
+ * Bukti bahwa solver telah mengirim funds di target chain.
+ * Digunakan untuk claim funds di source chain contract.
+ *
+ * Proof mechanism: EIP-712 signature dari solver atas data transfer.
+ */
+export interface CrossChainProof {
+    /** Target chain transaction hash */
+    txHash: Hash;
+    /** Target chain ID */
+    chainId: ChainId;
+    /** Block number where target tx was included */
+    blockNumber: number;
+    /** Solver's EIP-712 signature over proof data */
+    solverSignature: string;
+    /** Data yang di-sign (untuk verification) */
+    signedData?: {
+        intentId: string;
+        targetTxHash: Hash;
+        amount: string;
+        recipient: Address;
+    };
+}
+//# sourceMappingURL=settlement.d.ts.map

package/dist/solver/types/settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../../../src/solver/types/settlement.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAMjE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IAEjB,wDAAwD;IACxD,YAAY,EAAE,IAAI,CAAC;IAEnB,sBAAsB;IACtB,aAAa,EAAE,OAAO,CAAC;IAEvB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IAEnB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IACzB,UAAU,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9D;AAED,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAC9B,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;QAC3D,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC,CAAC;IACV,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACtB,SAAS,GACT,SAAS,GACT,UAAU,GACV,WAAW,GACX,QAAQ,CAAC;AAEf;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACvB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;IAEhB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEhB,wDAAwD;IACxD,QAAQ,EAAE,IAAI,CAAC;IAEf,uCAAuC;IACvC,KAAK,CAAC,EAAE,eAAe,CAAC;IAExB,gCAAgC;IAChC,MAAM,EAAE,gBAAgB,CAAC;IAEzB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IAEtB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC5B,oCAAoC;IACpC,MAAM,EAAE,IAAI,CAAC;IAEb,sBAAsB;IACtB,OAAO,EAAE,OAAO,CAAC;IAEjB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IAExB,6CAA6C;IAC7C,UAAU,CAAC,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,IAAI,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,OAAO,CAAC;KACtB,CAAC;CACL"}

package/dist/solver/types/settlement.js

@@ -0,0 +1,9 @@
+/**
+ * Settlement Types
+ *
+ * Types untuk cross-chain settlement dan proof verification.
+ * Settlement = proses claim funds di source chain setelah
+ * berhasil mengirim funds di target chain.
+ */
+export {};
+//# sourceMappingURL=settlement.js.map

package/dist/solver/types/settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement.js","sourceRoot":"","sources":["../../../src/solver/types/settlement.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/types/chain.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Chain Configuration Types
+ *
+ * Konfigurasi per-chain untuk EVM networks.
+ */
+import type { Address, ChainId } from "./common";
+/**
+ * Native currency info for a chain
+ */
+export interface NativeCurrency {
+    /** Currency name (e.g., "Ether") */
+    name: string;
+    /** Currency symbol (e.g., "ETH") */
+    symbol: string;
+    /** Decimals (always 18 for EVM native) */
+    decimals: number;
+}
+/**
+ * Contract addresses deployed on a specific chain
+ */
+export interface ChainContracts {
+    /** IntentSettlement contract address */
+    intentSettlement?: Address;
+    /** ERC-8004 Agent Registry address */
+    agentRegistry?: Address;
+    /** USDC token address on this chain */
+    usdc?: Address;
+}
+/**
+ * Chain Configuration
+ *
+ * Full config for an EVM chain.
+ * Dipakai oleh ChainRegistry, RPCProviderManager, WalletManager.
+ *
+ * CONTOH:
+ *   {
+ *     id: 1,
+ *     name: "Ethereum",
+ *     rpcUrl: "https://eth.llamarpc.com",
+ *     fallbackRpcUrls: ["https://rpc.ankr.com/eth"],
+ *     nativeCurrency: { name: "Ether", symbol: "ETH", decimals: 18 },
+ *     explorer: "https://etherscan.io",
+ *     contracts: { usdc: "0xA0b86991..." }
+ *   }
+ */
+export interface ChainConfig {
+    /** Chain ID (e.g., 1 for Ethereum, 137 for Polygon) */
+    id: ChainId;
+    /** Human-readable chain name */
+    name: string;
+    /** Primary RPC URL */
+    rpcUrl: string;
+    /** Fallback RPC URLs (tried in order if primary fails) */
+    fallbackRpcUrls: string[];
+    /** Native currency information */
+    nativeCurrency: NativeCurrency;
+    /** Block explorer base URL */
+    explorer: string;
+    /** Deployed contract addresses on this chain */
+    contracts: ChainContracts;
+    /** Average block time in seconds (for confirmation estimates) */
+    blockTimeSeconds?: number;
+    /** Number of confirmations to wait (default: 12) */
+    confirmations?: number;
+}
+//# sourceMappingURL=chain.d.ts.map

package/dist/types/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/types/chain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAW;IACxB,uDAAuD;IACvD,EAAE,EAAE,OAAO,CAAC;IAEZ,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf,0DAA0D;IAC1D,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,kCAAkC;IAClC,cAAc,EAAE,cAAc,CAAC;IAE/B,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,SAAS,EAAE,cAAc,CAAC;IAE1B,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/types/chain.js

@@ -0,0 +1,7 @@
+/**
+ * Chain Configuration Types
+ *
+ * Konfigurasi per-chain untuk EVM networks.
+ */
+export {};
+//# sourceMappingURL=chain.js.map

package/dist/types/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/types/chain.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/common.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Common Primitive Types
+ *
+ * Low-level types yang digunakan di seluruh SDK.
+ * Tidak tergantung pada module lain.
+ */
+/**
+ * EVM address (hex string with 0x prefix, 42 characters)
+ *
+ * CONTOH: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+ */
+export type Address = `0x${string}`;
+/**
+ * Amount as string (representing bigint)
+ *
+ * Digunakan untuk serialization karena bigint tidak bisa di-JSON.stringify.
+ * Format: decimal string tanpa separators.
+ *
+ * CONTOH:
+ *   1000 USDC (6 decimals) = "1000000000"
+ *   0.5 ETH (18 decimals) = "500000000000000000"
+ */
+export type Amount = string;
+/**
+ * Chain ID (EVM chain identifier)
+ *
+ * CONTOH:
+ *   1 = Ethereum Mainnet
+ *   137 = Polygon
+ *   42161 = Arbitrum One
+ *   10 = Optimism
+ */
+export type ChainId = number;
+/**
+ * Transaction or data hash (hex string with 0x prefix, 66 characters)
+ *
+ * CONTOH: "0xabc123..."
+ */
+export type Hash = `0x${string}`;
+/**
+ * Unix timestamp in seconds
+ */
+export type UnixTimestamp = number;
+//# sourceMappingURL=common.d.ts.map

package/dist/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,KAAK,MAAM,EAAE,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;;;;;;;GAQG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC"}

package/dist/types/common.js

@@ -0,0 +1,8 @@
+/**
+ * Common Primitive Types
+ *
+ * Low-level types yang digunakan di seluruh SDK.
+ * Tidak tergantung pada module lain.
+ */
+export {};
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/types/entities.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Extracted entities from natural language
+ */
+export interface ExtractedEntities {
+    amounts: AmountEntity[];
+    tokens: TokenEntity[];
+    actions: ActionEntity[];
+    constraints: ConstraintEntity[];
+    riskIndicators: RiskIndicator[];
+}
+/**
+ * Amount Entity
+ * Example: "10k USDC" -> { value: 10000, rawText: "10k", unit: "USDC" }
+ */
+export interface AmountEntity {
+    value: number;
+    rawText: string;
+    unit?: string;
+    position: [number, number];
+}
+/**
+ * Token Entity
+ * Example: "USDC", "ETH", "Bored Ape"
+ */
+export interface TokenEntity {
+    symbol: string;
+    rawText: string;
+    type: "fungible" | "nft" | "collection";
+    address?: string;
+    position: [number, number];
+}
+/**
+ * Action Entity
+ * Example: "swap", "maximize", "buy"
+ */
+export interface ActionEntity {
+    action: string;
+    rawText: string;
+    category: "trade" | "yield" | "purchase" | "transfer" | "other";
+    position: [number, number];
+}
+/**
+ * Constraint Entity
+ * Example: "max 1% slippage", "deadline in 1 hour"
+ */
+export interface ConstraintEntity {
+    type: "slippage" | "deadline" | "gas" | "price" | "other";
+    value: string | number;
+    rawText: string;
+    position: [number, number];
+}
+/**
+ * Risk Indicator
+ * Example: "safe", "risky", "conservative"
+ */
+export interface RiskIndicator {
+    level: "low" | "medium" | "high";
+    keywords: string[];
+    confidence: number;
+}
+//# sourceMappingURL=entities.d.ts.map

package/dist/types/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,OAAO,EAAE,YAAY,EAAE,CAAC;IAGxB,MAAM,EAAE,WAAW,EAAE,CAAC;IAGtB,OAAO,EAAE,YAAY,EAAE,CAAC;IAGxB,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAGhC,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,GAAG,KAAK,GAAG,YAAY,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC;IAChE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IAC1D,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/entities.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entities.js.map

package/dist/types/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/types/entities.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -0,0 +1,44 @@
+import { StructuredIntent } from "./intent";
+import type { TokenResolverConfig } from "./token";
+export * from "./common";
+export * from "./chain";
+export * from "./intent";
+export * from "./entities";
+export * from "./templates";
+export * from "./token";
+/**
+ * Parser Configuration
+ */
+export interface ParserConfig {
+    defaultDeadlineOffset?: number;
+    knownTokens?: Record<string, string>;
+    knownProtocols?: string[];
+    enableFuzzyMatching?: boolean;
+    enableCache?: boolean;
+    minConfidence?: number;
+    /**
+     * Token Resolver Configuration (Swing.xyz API)
+     *
+     * Jika disediakan dan enabled=true, gunakan parseAsync() untuk mendapatkan
+     * token address resolution. parse() tetap sync dan backward-compatible.
+     *
+     * CONTOH:
+     *   tokenResolver: {
+     *     enabled: true,
+     *     cacheTTL: 300_000,
+     *     timeout: 5000,
+     *   }
+     */
+    tokenResolver?: TokenResolverConfig;
+}
+/**
+ * Parse Result
+ * Wrapper around StructuredIntent with success/error handling
+ */
+export interface ParseResult {
+    success: boolean;
+    data?: StructuredIntent;
+    error?: string;
+    warnings?: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,YAAY;IAE3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAGrC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAG1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/types/index.js

@@ -0,0 +1,8 @@
+// Re-export all types
+export * from "./common";
+export * from "./chain";
+export * from "./intent";
+export * from "./entities";
+export * from "./templates";
+export * from "./token";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAEA,sBAAsB;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/types/intent.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Intent Types - Define all possible intent types
+ */
+export type IntentType = "swap" | "yield_strategy" | "nft_purchase" | "send" | "bridge" | "claim" | "unknown";
+/**
+ * Risk Level for DeFi operations
+ */
+export type RiskLevel = "low" | "medium" | "high";
+/**
+ * Claim Type for reward/airdrop/vesting operations
+ */
+export type ClaimType = "airdrop" | "rewards" | "vesting";
+/**
+ * Base Structured Intent
+ * This is what gets returned after parsing
+ */
+export interface StructuredIntent {
+    intentType: IntentType;
+    parameters: IntentParameters;
+    constraints: IntentConstraints;
+    metadata: IntentMetadata;
+}
+/**
+ * Intent Parameters - varies by intent type
+ */
+export interface IntentParameters {
+    inputToken?: string;
+    inputTokenAddress?: string;
+    inputAmount?: string;
+    outputToken?: string;
+    outputTokenAddress?: string;
+    minOutputAmount?: string;
+    recipient?: string;
+    riskLevel?: RiskLevel;
+    diversificationRequired?: boolean;
+    preferredProtocols?: string[];
+    targetAPY?: string;
+    collection?: string;
+    collectionAddress?: string;
+    traits?: Record<string, string>;
+    maxPrice?: string;
+    sourceChain?: string;
+    targetChain?: string;
+    claimType?: ClaimType;
+    protocol?: string;
+    [key: string]: any;
+}
+/**
+ * Intent Constraints
+ */
+export interface IntentConstraints {
+    deadline: number;
+    maxSlippage?: number;
+    maxGasCost?: string;
+    minProtocols?: number;
+    maxExposurePerProtocol?: number;
+    preferredDEXs?: string[];
+    preferredMarketplaces?: string[];
+    [key: string]: any;
+}
+/**
+ * Intent Metadata
+ */
+export interface IntentMetadata {
+    originalText: string;
+    confidence: number;
+    parsedAt: number;
+    warnings?: string[];
+}
+//# sourceMappingURL=intent.d.ts.map

package/dist/types/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/types/intent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,gBAAgB,GAChB,cAAc,GACd,MAAM,GACN,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAE/B,UAAU,EAAE,UAAU,CAAC;IAGvB,UAAU,EAAE,gBAAgB,CAAC;IAG7B,WAAW,EAAE,iBAAiB,CAAC;IAG/B,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/types/intent.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=intent.js.map

package/dist/types/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/types/intent.ts"],"names":[],"mappings":""}