@terkoizmy/intent-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Terkoizmy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,258 @@
+# Intent Parser SDK
+
+Lightweight natural language parser and autonomous solver SDK for blockchain intents.
+
+## Installation
+
+```bash
+npm install @terkoizmy/intent-sdk
+# or
+bun add @terkoizmy/intent-sdk
+```
+
+## Quick Start
+
+> **For the full, comprehensive guide, please see [docs/USAGE.md](./docs/USAGE.md).**
+
+### Parser Only
+
+```typescript
+import { IntentParser } from "@terkoizmy/intent-sdk";
+
+const parser = new IntentParser();
+const result = await parser.parse("Bridge 100 USDC from Ethereum to Arbitrum");
+
+// { success: true, data: { intentType: 'bridge', parameters: { ... } } }
+```
+
+### SDK Factory (Parser + Solver)
+
+```typescript
+import { createIntentSDK } from "@terkoizmy/intent-sdk";
+
+const { parser, solver } = createIntentSDK({
+    solver: {
+        privateKey: process.env.SOLVER_PRIVATE_KEY!,
+        supportedChains: [1, 10, 42161],
+        supportedTokens: ["USDC", "USDT"],
+        mode: "simulate"   // use "live" for real execution
+    },
+    }
+});
+
+await solver.initialize();
+
+if (solver.canSolve(intent)) {
+    const result = await solver.solve(intent);
+    console.log(result); // { success: true, txHash: "0x...", profit: "..." }
+}
+```
+
+### Autonomous Mode
+
+Connect to a mempool server and solve intents automatically in the background:
+
+```typescript
+import { createIntentSDK } from "@terkoizmy/intent-sdk";
+
+const { solver } = createIntentSDK({
+    solver: {
+        privateKey: process.env.SOLVER_PRIVATE_KEY!,
+        supportedChains: [1, 10, 42161],
+        supportedTokens: ["USDC"],
+        mode: "live"
+    },
+    }
+});
+
+await solver.initialize();
+solver.start("wss://mempool.yourprotocol.com/ws");
+
+setInterval(() => {
+    const stats = solver.getStats();
+    console.log("Solved:", stats.mempoolStats.solved);
+}, 5000);
+```
+
+## Supported Intent Types
+
+| Type | Example |
+|------|---------|
+| **bridge** | "Bridge 100 USDC from Ethereum to Arbitrum" |
+| **send** | "Send 50 USDT to 0xAbc..." |
+| **swap** | "Swap 1 ETH for USDC on Uniswap" |
+| **claim** | "Claim rewards from staking" |
+| **yield_strategy** | "Deposit 1000 USDC into yield strategy with low risk" |
+
+## Supported Chains
+
+### Mainnets
+
+| Chain | ID |
+|-------|----|
+| Ethereum Mainnet | 1 |
+| Optimism | 10 |
+| Arbitrum One | 42161 |
+
+### Testnets
+
+| Chain | ID | Settlement Contract |
+|-------|----|--------------------|
+| Unichain Sepolia | 1301 | [`0x7066f6...`](https://unichain-sepolia.blockscout.com/address/0x7066f6dFc1C652c165Bc9BB10085fD95719b5eA6) |
+| Ethereum Sepolia | 11155111 | — |
+| Arbitrum Sepolia | 421614 | — |
+| Base Sepolia | 84532 | — |
+
+Configure additional chains by adding their IDs to `supportedChains` and providing RPC URLs.
+
+## Environment Configuration
+
+```bash
+cp .env.example .env
+```
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `SOLVER_PRIVATE_KEY` | ✅ | Solver wallet private key (hex, with `0x`) |
+| `UNICHAIN_SEPOLIA_RPC_URL` | ✅ | RPC for Unichain Sepolia (1301) |
+| `SEPOLIA_RPC_URL` | Optional | RPC for Ethereum Sepolia |
+| `ARB_SEPOLIA_RPC_URL` | Optional | RPC for Arbitrum Sepolia |
+| `ETH_RPC_URL` | Optional | Ethereum Mainnet RPC (Aave reads) |
+| `SETTLEMENT_CONTRACT_UNICHAIN_SEPOLIA` | For live settlement | Deployed proxy address |
+
+See [.env.example](./.env.example) for the full list.
+
+## Solver Economics
+
+The solver earns a fee on every successful solve:
+
+```
+totalFee = baseFee + gasCost + slippageCapture
+```
+
+- **baseFee** — fixed % of the bridge amount (configurable, default 0.05%)
+- **gasCost** — estimated gas cost on the destination chain
+- **slippageCapture** — profit from unused slippage tolerance
+
+The solver receives `userPays = inputAmount` from the source chain settlement and pays the user `userReceives = inputAmount - totalFee` on the target chain. The difference is solver profit.
+
+## API
+
+### `IntentParser`
+
+```typescript
+new IntentParser(config?: ParserConfig)
+```
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `parse(text)` | `Promise<ParseResult>` | Parse a natural language intent |
+| `parseBatch(texts)` | `Promise<ParseResult[]>` | Parse multiple intents |
+
+### `IntentSolver`
+
+```typescript
+new IntentSolver(config: LiquidityAgentConfig)
+```
+
+| Method | Description |
+|--------|-------------|
+| `initialize()` | Load balances and derive solver address |
+| `start(url)` | Connect to mempool WebSocket |
+| `stop()` | Disconnect and stop all background work |
+| `canSolve(intent)` | Check if this intent can be solved |
+| `getQuote(intent)` | Get fee breakdown without executing |
+| `solve(intent)` | Execute full solve → settlement flow |
+| `getStatus()` | Returns `"idle"` or `"processing"` |
+| `getStats()` | Returns profit + mempool statistics |
+
+### `createIntentSDK(config)`
+
+Factory that creates both `parser` and `solver` in one call:
+
+```typescript
+const { parser, solver } = createIntentSDK(config);
+```
+
+## Documentation
+
+| Document | Contents |
+|----------|----------|
+| [docs/USAGE.md](./docs/USAGE.md) | Comprehensive How-To Guide for using the SDK |
+| [docs/SOLVER.md](./docs/SOLVER.md) | Architecture, config reference, fee structure, API details |
+| [docs/SDK_WORKFLOW.md](./docs/SDK_WORKFLOW.md) | End-to-end workflow diagrams |
+| [docs/ERC_STANDARDS.md](./docs/ERC_STANDARDS.md) | ERC-7683, ERC-712 standards used |
+| [docs/DEPLOYMENT.md](./docs/DEPLOYMENT.md) | Step-by-step testnet deployment guide |
+| [docs/TESTNET_GUIDE.md](./docs/TESTNET_GUIDE.md) | Faucets, funding, troubleshooting |
+
+## Examples
+
+| File | Description |
+|------|-------------|
+| `examples/basic-bridge.ts` | Parse + manual solve |
+| `examples/autonomous-agent.ts` | Autonomous mempool listener |
+| `examples/inventory-management.ts` | Inventory snapshot + rebalancing |
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Build
+bun run build
+
+# Test all (parser + solver units + integration)
+bun test
+
+# Run specific test suites
+bun test tests/parser/
+bun test tests/solver/
+bun test tests/integration/
+bun test tests/shared/
+
+# Live tests (requires funded wallet + RPC)
+bun test tests/live/
+
+# E2E testnet tests (full pipeline)
+bun test tests/e2e/
+
+# Run an example
+npx tsx examples/basic-bridge.ts
+```
+
+## Project Structure
+
+```
+src/
+├── parser/          ← IntentParser (Stage 1)
+├── solver/          ← IntentSolver / LiquidityAgent (Stage 2+3)
+│   ├── agent/       ← LiquidityAgent, AgentConfig
+│   ├── contracts/   ← IntentSettlement viem wrapper
+│   ├── inventory/   ← InventoryManager, Rebalancer
+│   ├── pricing/     ← DynamicPricing, FeeCalculator
+│   ├── settlement/  ← ProofGenerator, SettlementManager
+│   ├── mempool/     ← MempoolClient, IntentFilter
+│   ├── monitoring/  ← ProfitTracker, HealthChecker
+│   └── protocols/   ← LiFi (aggregator), Aave (lending)
+├── shared/          ← WalletManager, ChainRegistry, RPC, TokenRegistry
+│   ├── rpc/         ← RPCProviderManager, ViemProvider (with retry)
+│   ├── utils/       ← ERC-20 utils, retry with backoff
+│   └── chain-registry/ ← Chain configs, chain names
+├── errors/          ← Domain-specific error classes
+└── types/           ← Shared types
+contracts/           ← IntentSettlement.sol (ERC-7683, UUPS)
+tests/
+├── parser/          ← Parser unit tests
+├── solver/          ← Solver unit tests
+├── shared/          ← Shared util tests (retry, viem, enrichment)
+├── integration/     ← Mock-based integration tests
+├── live/            ← Live testnet tests (guarded)
+└── e2e/             ← Full E2E pipeline tests (guarded)
+docs/                ← Documentation
+examples/            ← Runnable usage examples
+```
+
+## License
+
+MIT

package/dist/config/chains.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Chain Configurations
+ *
+ * Pre-configured chain data for supported networks.
+ * Import SUPPORTED_CHAINS to register semua chains
+ * atau import individual configs.
+ */
+import type { ChainConfig } from "../types/chain";
+/**
+ * Ethereum Mainnet Configuration
+ */
+export declare const ETHEREUM_CONFIG: ChainConfig;
+/**
+ * Polygon PoS Configuration
+ */
+export declare const POLYGON_CONFIG: ChainConfig;
+/**
+ * Arbitrum One Configuration
+ */
+export declare const ARBITRUM_CONFIG: ChainConfig;
+/**
+ * All supported chain configurations
+ */
+export declare const SUPPORTED_CHAINS: ChainConfig[];
+//# sourceMappingURL=chains.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../src/config/chains.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,WAmB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAmB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,WAmB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAIzC,CAAC"}

package/dist/config/chains.js

@@ -0,0 +1,85 @@
+/**
+ * Chain Configurations
+ *
+ * Pre-configured chain data for supported networks.
+ * Import SUPPORTED_CHAINS to register semua chains
+ * atau import individual configs.
+ */
+/**
+ * Ethereum Mainnet Configuration
+ */
+export const ETHEREUM_CONFIG = {
+    id: 1,
+    name: "Ethereum",
+    rpcUrl: "https://eth.llamarpc.com",
+    fallbackRpcUrls: [
+        "https://rpc.ankr.com/eth",
+        "https://ethereum-rpc.publicnode.com",
+    ],
+    nativeCurrency: {
+        name: "Ether",
+        symbol: "ETH",
+        decimals: 18,
+    },
+    explorer: "https://etherscan.io",
+    contracts: {
+        usdc: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    },
+    blockTimeSeconds: 12,
+    confirmations: 12,
+};
+/**
+ * Polygon PoS Configuration
+ */
+export const POLYGON_CONFIG = {
+    id: 137,
+    name: "Polygon",
+    rpcUrl: "https://polygon.llamarpc.com",
+    fallbackRpcUrls: [
+        "https://rpc.ankr.com/polygon",
+        "https://polygon-bor-rpc.publicnode.com",
+    ],
+    nativeCurrency: {
+        name: "POL",
+        symbol: "POL",
+        decimals: 18,
+    },
+    explorer: "https://polygonscan.com",
+    contracts: {
+        usdc: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    },
+    blockTimeSeconds: 2,
+    confirmations: 30,
+};
+/**
+ * Arbitrum One Configuration
+ */
+export const ARBITRUM_CONFIG = {
+    id: 42161,
+    name: "Arbitrum One",
+    rpcUrl: "https://arbitrum.llamarpc.com",
+    fallbackRpcUrls: [
+        "https://rpc.ankr.com/arbitrum",
+        "https://arbitrum-one-rpc.publicnode.com",
+    ],
+    nativeCurrency: {
+        name: "Ether",
+        symbol: "ETH",
+        decimals: 18,
+    },
+    explorer: "https://arbiscan.io",
+    contracts: {
+        usdc: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    },
+    blockTimeSeconds: 0.25,
+    confirmations: 12,
+};
+/**
+ * All supported chain configurations
+ */
+export const SUPPORTED_CHAINS = [
+    ETHEREUM_CONFIG,
+    POLYGON_CONFIG,
+    ARBITRUM_CONFIG,
+];
+//# sourceMappingURL=chains.js.map

package/dist/config/chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../src/config/chains.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgB;IACxC,EAAE,EAAE,CAAC;IACL,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,0BAA0B;IAClC,eAAe,EAAE;QACb,0BAA0B;QAC1B,qCAAqC;KACxC;IACD,cAAc,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,sBAAsB;IAChC,SAAS,EAAE;QACP,IAAI,EAAE,4CAAuD;KAChE;IACD,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE,EAAE;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACvC,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,8BAA8B;IACtC,eAAe,EAAE;QACb,8BAA8B;QAC9B,wCAAwC;KAC3C;IACD,cAAc,EAAE;QACZ,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,yBAAyB;IACnC,SAAS,EAAE;QACP,IAAI,EAAE,4CAAuD;KAChE;IACD,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,EAAE;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgB;IACxC,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,+BAA+B;IACvC,eAAe,EAAE;QACb,+BAA+B;QAC/B,yCAAyC;KAC5C;IACD,cAAc,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,qBAAqB;IAC/B,SAAS,EAAE;QACP,IAAI,EAAE,4CAAuD;KAChE;IACD,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,EAAE;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC3C,eAAe;IACf,cAAc;IACd,eAAe;CAClB,CAAC"}

package/dist/config/default.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Default Configurations
+ *
+ * Sensible defaults untuk semua configurable aspects of the solver.
+ * Override individual fields saat creating AgentConfig.
+ */
+import type { PricingConfig } from "../solver/types/pricing";
+import type { InventoryConfig } from "../solver/types/inventory";
+/**
+ * Default pricing configuration
+ *
+ * - 0.5% base fee
+ * - Minimum $1 fee
+ * - Max 3% fee cap
+ * - 50% slippage share
+ */
+export declare const DEFAULT_PRICING_CONFIG: PricingConfig;
+/**
+ * Default inventory configuration
+ *
+ * - Keep minimum 10% reserve per chain
+ * - Trigger rebalance if >15% deviation from target
+ * - Poll balances every 30s
+ */
+export declare const DEFAULT_INVENTORY_CONFIG: InventoryConfig;
+/**
+ * Default agent configuration partial
+ *
+ * Used by buildAgentConfig() to merge with user-provided config.
+ */
+export declare const DEFAULT_AGENT_SETTINGS: {
+    /** Operating mode */
+    readonly mode: "simulate";
+    /** Maximum concurrent intents to process */
+    readonly maxConcurrentIntents: 5;
+    /** Intent timeout in seconds (1 hour) */
+    readonly intentTimeout: 3600;
+};
+//# sourceMappingURL=default.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/config/default.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAItC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;IAC/B,qBAAqB;;IAGrB,4CAA4C;;IAG5C,yCAAyC;;CAEnC,CAAC"}

package/dist/config/default.js

@@ -0,0 +1,46 @@
+/**
+ * Default Configurations
+ *
+ * Sensible defaults untuk semua configurable aspects of the solver.
+ * Override individual fields saat creating AgentConfig.
+ */
+/**
+ * Default pricing configuration
+ *
+ * - 0.5% base fee
+ * - Minimum $1 fee
+ * - Max 3% fee cap
+ * - 50% slippage share
+ */
+export const DEFAULT_PRICING_CONFIG = {
+    baseFeePercent: 0.005,
+    minFeeUSD: 1,
+    maxFeePercent: 0.03,
+    slippageSharePercent: 0.5,
+};
+/**
+ * Default inventory configuration
+ *
+ * - Keep minimum 10% reserve per chain
+ * - Trigger rebalance if >15% deviation from target
+ * - Poll balances every 30s
+ */
+export const DEFAULT_INVENTORY_CONFIG = {
+    minReservePercent: 0.1,
+    rebalanceThreshold: 0.15,
+    pollingIntervalMs: 30_000,
+};
+/**
+ * Default agent configuration partial
+ *
+ * Used by buildAgentConfig() to merge with user-provided config.
+ */
+export const DEFAULT_AGENT_SETTINGS = {
+    /** Operating mode */
+    mode: "simulate",
+    /** Maximum concurrent intents to process */
+    maxConcurrentIntents: 5,
+    /** Intent timeout in seconds (1 hour) */
+    intentTimeout: 3600,
+};
+//# sourceMappingURL=default.js.map

package/dist/config/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../src/config/default.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACjD,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,CAAC;IACZ,aAAa,EAAE,IAAI;IACnB,oBAAoB,EAAE,GAAG;CAC5B,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACrD,iBAAiB,EAAE,GAAG;IACtB,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,MAAM;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC,qBAAqB;IACrB,IAAI,EAAE,UAAmB;IAEzB,4CAA4C;IAC5C,oBAAoB,EAAE,CAAC;IAEvB,yCAAyC;IACzC,aAAa,EAAE,IAAI;CACb,CAAC"}

package/dist/config/testnets.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Testnet Chain Configurations
+ *
+ * Pre-configured chain data for supported testnet networks.
+ * Import SUPPORTED_TESTNETS to register all testnet chains
+ * or import individual configs.
+ *
+ * Stage 3 — Live Integration
+ */
+import type { ChainConfig } from "../types/chain";
+/**
+ * Ethereum Sepolia Testnet Configuration
+ */
+export declare const SEPOLIA_CONFIG: ChainConfig;
+/**
+ * Arbitrum Sepolia Testnet Configuration
+ */
+export declare const ARBITRUM_SEPOLIA_CONFIG: ChainConfig;
+/**
+ * Unichain Sepolia Testnet Configuration
+ */
+export declare const UNICHAIN_SEPOLIA_CONFIG: ChainConfig;
+/**
+ * Base Sepolia Testnet Configuration
+ */
+export declare const BASE_SEPOLIA_CONFIG: ChainConfig;
+/**
+ * All supported testnet chain configurations
+ */
+export declare const SUPPORTED_TESTNETS: ChainConfig[];
+//# sourceMappingURL=testnets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testnets.d.ts","sourceRoot":"","sources":["../../src/config/testnets.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAgB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAgBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,WAgBrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAgBjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,EAK3C,CAAC"}

package/dist/config/testnets.js

@@ -0,0 +1,99 @@
+/**
+ * Testnet Chain Configurations
+ *
+ * Pre-configured chain data for supported testnet networks.
+ * Import SUPPORTED_TESTNETS to register all testnet chains
+ * or import individual configs.
+ *
+ * Stage 3 — Live Integration
+ */
+/**
+ * Ethereum Sepolia Testnet Configuration
+ */
+export const SEPOLIA_CONFIG = {
+    id: 11155111,
+    name: "Sepolia",
+    rpcUrl: "", // TODO: Set via SEPOLIA_RPC_URL env var
+    fallbackRpcUrls: [],
+    nativeCurrency: {
+        name: "Sepolia Ether",
+        symbol: "ETH",
+        decimals: 18,
+    },
+    explorer: "https://sepolia.etherscan.io",
+    contracts: {
+        usdc: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+    },
+    blockTimeSeconds: 12,
+    confirmations: 2,
+};
+/**
+ * Arbitrum Sepolia Testnet Configuration
+ */
+export const ARBITRUM_SEPOLIA_CONFIG = {
+    id: 421614,
+    name: "Arbitrum Sepolia",
+    rpcUrl: "", // TODO: Set via ARB_SEPOLIA_RPC_URL env var
+    fallbackRpcUrls: [],
+    nativeCurrency: {
+        name: "Ether",
+        symbol: "ETH",
+        decimals: 18,
+    },
+    explorer: "https://sepolia.arbiscan.io",
+    contracts: {
+        usdc: "0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d",
+    },
+    blockTimeSeconds: 0.25,
+    confirmations: 1,
+};
+/**
+ * Unichain Sepolia Testnet Configuration
+ */
+export const UNICHAIN_SEPOLIA_CONFIG = {
+    id: 1301,
+    name: "Unichain Sepolia",
+    rpcUrl: "", // TODO: Set via UNICHAIN_SEPOLIA_RPC_URL env var
+    fallbackRpcUrls: [],
+    nativeCurrency: {
+        name: "Ether",
+        symbol: "ETH",
+        decimals: 18,
+    },
+    explorer: "https://unichain-sepolia.blockscout.com",
+    contracts: {
+        usdc: "0x31d0220469e10c4E71834a79b1f276d740d3768F", // Confirm before mainnet
+    },
+    blockTimeSeconds: 1,
+    confirmations: 1,
+};
+/**
+ * Base Sepolia Testnet Configuration
+ */
+export const BASE_SEPOLIA_CONFIG = {
+    id: 84532,
+    name: "Base Sepolia",
+    rpcUrl: "", // TODO: Set via BASE_SEPOLIA_RPC_URL env var
+    fallbackRpcUrls: [],
+    nativeCurrency: {
+        name: "Ether",
+        symbol: "ETH",
+        decimals: 18,
+    },
+    explorer: "https://sepolia.basescan.org",
+    contracts: {
+        usdc: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    },
+    blockTimeSeconds: 2,
+    confirmations: 1,
+};
+/**
+ * All supported testnet chain configurations
+ */
+export const SUPPORTED_TESTNETS = [
+    SEPOLIA_CONFIG,
+    ARBITRUM_SEPOLIA_CONFIG,
+    UNICHAIN_SEPOLIA_CONFIG,
+    BASE_SEPOLIA_CONFIG,
+];
+//# sourceMappingURL=testnets.js.map

package/dist/config/testnets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testnets.js","sourceRoot":"","sources":["../../src/config/testnets.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACvC,EAAE,EAAE,QAAQ;IACZ,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,EAAE,EAAE,wCAAwC;IACpD,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE;QACZ,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,8BAA8B;IACxC,SAAS,EAAE;QACP,IAAI,EAAE,4CAAuD;KAChE;IACD,gBAAgB,EAAE,EAAE;IACpB,aAAa,EAAE,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAgB;IAChD,EAAE,EAAE,MAAM;IACV,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,EAAE,EAAE,4CAA4C;IACxD,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,6BAA6B;IACvC,SAAS,EAAE;QACP,IAAI,EAAE,4CAAuD;KAChE;IACD,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAgB;IAChD,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,kBAAkB;IACxB,MAAM,EAAE,EAAE,EAAE,iDAAiD;IAC7D,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,yCAAyC;IACnD,SAAS,EAAE;QACP,IAAI,EAAE,4CAAuD,EAAE,yBAAyB;KAC3F;IACD,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC5C,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,EAAE,EAAE,6CAA6C;IACzD,eAAe,EAAE,EAAE;IACnB,cAAc,EAAE;QACZ,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,EAAE;KACf;IACD,QAAQ,EAAE,8BAA8B;IACxC,SAAS,EAAE;QACP,IAAI,EAAE,4CAAuD;KAChE;IACD,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAkB;IAC7C,cAAc;IACd,uBAAuB;IACvB,uBAAuB;IACvB,mBAAmB;CACtB,CAAC"}

package/dist/errors/inventory-errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Inventory Errors
+ *
+ * Errors specific to inventory management operations.
+ */
+import type { ChainId } from "../types/common";
+/**
+ * Base error class for inventory-related errors
+ */
+export declare class InventoryError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Thrown when trying to lock more inventory than available
+ */
+export declare class InventoryLockError extends InventoryError {
+    readonly intentId: string;
+    constructor(intentId: string, message?: string);
+}
+/**
+ * Thrown when a rebalancing operation fails
+ */
+export declare class RebalancingFailedError extends InventoryError {
+    readonly fromChain: ChainId;
+    readonly toChain: ChainId;
+    readonly amount: string;
+    readonly reason: string;
+    constructor(fromChain: ChainId, toChain: ChainId, amount: string, reason: string);
+}
+//# sourceMappingURL=inventory-errors.d.ts.map

package/dist/errors/inventory-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-errors.d.ts","sourceRoot":"","sources":["../../src/errors/inventory-errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAA0B;CAKhE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IAClD,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAQjD;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,cAAc;IACtD,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAG3B,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;CAYrB"}