agentwallet-sdk 2.3.0 → 2.4.1

package/dist/swap/types.d.ts

@@ -0,0 +1,79 @@
+import type { Address, Hash } from 'viem';
+/** Uniswap V3 fee tier options */
+export type UniswapFeeTier = 100 | 500 | 3000 | 10000;
+/** Quote result from Uniswap V3 Quoter */
+export interface SwapQuote {
+    /** Input token address */
+    tokenIn: Address;
+    /** Output token address */
+    tokenOut: Address;
+    /** Raw amount in (before protocol fee deduction) */
+    amountInRaw: bigint;
+    /** Amount in after protocol fee deduction (what gets swapped) */
+    amountInNet: bigint;
+    /** Protocol fee amount (0.875% of amountInRaw) */
+    feeAmount: bigint;
+    /** Expected output amount */
+    amountOut: bigint;
+    /** Minimum output after slippage */
+    amountOutMinimum: bigint;
+    /** Best Uniswap V3 pool fee tier found */
+    poolFeeTier: UniswapFeeTier;
+    /** Effective exchange rate: amountOut / amountInNet */
+    effectiveRate: number;
+    /** Gas estimate from quoter */
+    gasEstimate: bigint;
+}
+/** Options for a swap call */
+export interface SwapOptions {
+    /** Slippage tolerance in basis points (default: 50 = 0.5%) */
+    slippageBps?: number;
+    /** Override fee tiers to try (default: all four tiers) */
+    feeTiers?: UniswapFeeTier[];
+    /** Deadline in seconds from now (default: 300 = 5 minutes) */
+    deadlineSecs?: number;
+    /** Override fee wallet address (default: wallet's own address) */
+    feeWallet?: Address;
+}
+/** Result of a completed swap */
+export interface SwapResult {
+    /** Transaction hash of the swap */
+    txHash: Hash;
+    /** Transaction hash of the fee transfer (if separate) */
+    feeTxHash?: Hash;
+    /** The quote used for this swap */
+    quote: SwapQuote;
+    /** Whether approval tx was needed */
+    approvalRequired: boolean;
+    /** Approval tx hash (if triggered) */
+    approvalTxHash?: Hash;
+}
+/** SwapModule configuration */
+export interface SwapModuleConfig {
+    /** Uniswap V3 SwapRouter02 address on Base */
+    routerAddress: Address;
+    /** Uniswap V3 QuoterV2 address on Base */
+    quoterAddress: Address;
+    /** Protocol fee in basis points (875 = 0.875%) */
+    feeBps: number;
+    /** Address that receives protocol fees */
+    feeWallet: Address;
+}
+/** Well-known Base Mainnet token addresses */
+export declare const BASE_TOKENS: {
+    readonly USDC: `0x${string}`;
+    readonly WETH: `0x${string}`;
+    readonly cbETH: `0x${string}`;
+    /** Wrapped native (same as WETH on Base) */
+    readonly WNATIVE: `0x${string}`;
+};
+/** Uniswap V3 contract addresses on Base Mainnet (chain 8453) */
+export declare const UNISWAP_V3_BASE: {
+    readonly ROUTER: `0x${string}`;
+    readonly QUOTER_V2: `0x${string}`;
+};
+/** Protocol fee in bps — 0.875% */
+export declare const PROTOCOL_FEE_BPS = 875;
+/** Default slippage in bps — 0.5% */
+export declare const DEFAULT_SLIPPAGE_BPS = 50;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAO,MAAM,MAAM,CAAC;AAE/C,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtD,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,0BAA0B;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,0CAA0C;IAC1C,WAAW,EAAE,cAAc,CAAC;IAC5B,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8BAA8B;AAC9B,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,MAAM,EAAE,IAAI,CAAC;IACb,yDAAyD;IACzD,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,SAAS,CAAC;IACjB,qCAAqC;IACrC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,sCAAsC;IACtC,cAAc,CAAC,EAAE,IAAI,CAAC;CACvB;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,aAAa,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,8CAA8C;AAC9C,eAAO,MAAM,WAAW;;;;IAItB,4CAA4C;;CAEpC,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AAEX,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,KAAK,CAAC"}

package/dist/swap/types.js

@@ -0,0 +1,18 @@
+/** Well-known Base Mainnet token addresses */
+export const BASE_TOKENS = {
+    USDC: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+    WETH: '0x4200000000000000000000000000000000000006',
+    cbETH: '0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22',
+    /** Wrapped native (same as WETH on Base) */
+    WNATIVE: '0x4200000000000000000000000000000000000006',
+};
+/** Uniswap V3 contract addresses on Base Mainnet (chain 8453) */
+export const UNISWAP_V3_BASE = {
+    ROUTER: '0x2626664c2603336E57B271c5C0b26F421741e481',
+    QUOTER_V2: '0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a',
+};
+/** Protocol fee in bps — 0.875% */
+export const PROTOCOL_FEE_BPS = 875;
+/** Default slippage in bps — 0.5% */
+export const DEFAULT_SLIPPAGE_BPS = 50;
+//# sourceMappingURL=types.js.map

package/dist/swap/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AAoEA,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,4CAAuD;IAC7D,IAAI,EAAE,4CAAuD;IAC7D,KAAK,EAAE,4CAAuD;IAC9D,4CAA4C;IAC5C,OAAO,EAAE,4CAAuD;CACxD,CAAC;AAEX,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,4CAAuD;IAC/D,SAAS,EAAE,4CAAuD;CAC1D,CAAC;AAEX,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentwallet-sdk",
-  "version": "2.3.0",
+  "version": "2.4.1",
   "description": "TypeScript SDK for Agent Wallet — autonomous crypto spending for AI agents with user-set limits",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",