@paxoslabs/amplify-sdk 0.1.1 → 0.2.0-alpha.1

package/CHANGELOG.md

@@ -8,8 +8,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 <!-- auto-changelog-above -->
 
 
-## [0.1.1](///compare/v0.1.1-beta.1...v0.1.1) (2025-12-10)
-
 ## [0.1.1-beta.0](///compare/v0.1.1-alpha.5...v0.1.1-beta.0) (2025-12-10)
 
 ## [0.1.1-alpha.5](///compare/v0.1.1-alpha.4...v0.1.1-alpha.5) (2025-12-10)

package/README.md

@@ -41,6 +41,48 @@ pnpm add @paxoslabs/amplify-sdk viem
 pnpm add wagmi @tanstack/react-query
 ```
 
+## Quick Start
+
+```typescript
+import {
+  initAmplifySDK,
+  prepareDepositAuthorization,
+  prepareDeposit,
+  DepositAuthMethod,
+} from "@paxoslabs/amplify-sdk";
+
+// Initialize SDK with your API key
+await initAmplifySDK("pxl_your_api_key");
+
+// Prepare deposit authorization (auto-detects permit vs approval)
+const auth = await prepareDepositAuthorization({
+  yieldType: "PRIME",
+  depositToken: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", // USDC
+  depositAmount: "1000.0",
+  recipientAddress: userAddress,
+  chainId: 1,
+});
+
+// Handle based on authorization method
+if (auth.method === DepositAuthMethod.PERMIT) {
+  const signature = await signTypedData(auth.permitData);
+  const tx = await prepareDeposit({
+    yieldType: "PRIME",
+    depositToken: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    depositAmount: "1000.0",
+    recipientAddress: userAddress,
+    chainId: 1,
+    signature,
+    deadline: auth.permitData.message.deadline,
+  });
+  await writeContract(tx.txData);
+} else if (auth.method === DepositAuthMethod.APPROVAL) {
+  await writeContract(auth.txData); // Approve first
+  const tx = await prepareDeposit(/* params */);
+  await writeContract(tx.txData);
+}
+```
+
 ## Documentation
 
 Full documentation at https://developers.paxoslabs.com/

package/dist/{chunk-REKEQLQA.mjs → chunk-4ORV7PFT.mjs}

@@ -1,4 +1,4 @@
-import { DEFAULT_DEADLINE } from './chunk-CUGK4ZBJ.mjs';
+import { DEFAULT_DEADLINE } from './chunk-YDMFT2R7.mjs';
 
 // src/utils/time.ts
 var calculateDeadline = (daysFromNow = DEFAULT_DEADLINE) => {
@@ -9,5 +9,5 @@ var calculateDeadline = (daysFromNow = DEFAULT_DEADLINE) => {
 };
 
 export { calculateDeadline };
-//# sourceMappingURL=chunk-REKEQLQA.mjs.map
-//# sourceMappingURL=chunk-REKEQLQA.mjs.map
+//# sourceMappingURL=chunk-4ORV7PFT.mjs.map
+//# sourceMappingURL=chunk-4ORV7PFT.mjs.map

package/dist/{chunk-REKEQLQA.mjs.map → chunk-4ORV7PFT.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils/time.ts"],"names":[],"mappings":";;;AAoBO,IAAM,iBAAA,GAAoB,CAAC,WAAA,GAAc,gBAAA,KAAqB;AAEnE,EAAA,MAAM,aAAA,GAAgB,WAAA,GAAc,EAAA,GAAK,EAAA,GAAK,EAAA;AAG9C,EAAA,MAAM,mBAAmB,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAA,KAAQ,GAAI,CAAA;AAGrD,EAAA,MAAM,WAAW,gBAAA,GAAmB,aAAA;AAEpC,EAAA,OAAO,OAAO,QAAQ,CAAA;AACxB","file":"chunk-REKEQLQA.mjs","sourcesContent":["/**\n * @fileoverview Utility functions for time-related operations\n */\n\nimport { DEFAULT_DEADLINE } from \"../constants\";\n\n/**\n * Calculates a deadline timestamp in seconds from the current time\n *\n * @param {number} [daysFromNow=DEFAULT_DEADLINE] - Number of days from now to set the deadline\n * @returns {number} Unix timestamp in seconds representing the deadline\n *\n * @example\n * // Returns a timestamp 3 days from now (in seconds)\n * const threeDay = calculateDeadline();\n *\n * @example\n * // Returns a timestamp 7 days from now (in seconds)\n * const weekDeadline = calculateDeadline(7);\n */\nexport const calculateDeadline = (daysFromNow = DEFAULT_DEADLINE) => {\n  // Get days in seconds\n  const daysInSeconds = daysFromNow * 24 * 60 * 60;\n\n  // Get current timestamp in seconds\n  const currentTimeStamp = Math.floor(Date.now() / 1000);\n\n  // Calculate deadline (current time + 3 days in seconds)\n  const deadline = currentTimeStamp + daysInSeconds;\n\n  return BigInt(deadline);\n};\n"]}
+{"version":3,"sources":["../src/utils/time.ts"],"names":[],"mappings":";;;AAoBO,IAAM,iBAAA,GAAoB,CAAC,WAAA,GAAc,gBAAA,KAAqB;AAEnE,EAAA,MAAM,aAAA,GAAgB,WAAA,GAAc,EAAA,GAAK,EAAA,GAAK,EAAA;AAG9C,EAAA,MAAM,mBAAmB,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAA,KAAQ,GAAI,CAAA;AAGrD,EAAA,MAAM,WAAW,gBAAA,GAAmB,aAAA;AAEpC,EAAA,OAAO,OAAO,QAAQ,CAAA;AACxB","file":"chunk-4ORV7PFT.mjs","sourcesContent":["/**\n * @fileoverview Utility functions for time-related operations\n */\n\nimport { DEFAULT_DEADLINE } from \"../constants\";\n\n/**\n * Calculates a deadline timestamp in seconds from the current time\n *\n * @param {number} [daysFromNow=DEFAULT_DEADLINE] - Number of days from now to set the deadline\n * @returns {number} Unix timestamp in seconds representing the deadline\n *\n * @example\n * // Returns a timestamp 3 days from now (in seconds)\n * const threeDay = calculateDeadline();\n *\n * @example\n * // Returns a timestamp 7 days from now (in seconds)\n * const weekDeadline = calculateDeadline(7);\n */\nexport const calculateDeadline = (daysFromNow = DEFAULT_DEADLINE) => {\n  // Get days in seconds\n  const daysInSeconds = daysFromNow * 24 * 60 * 60;\n\n  // Get current timestamp in seconds\n  const currentTimeStamp = Math.floor(Date.now() / 1000);\n\n  // Calculate deadline (current time + 3 days in seconds)\n  const deadline = currentTimeStamp + daysInSeconds;\n\n  return BigInt(deadline);\n};\n"]}

package/dist/{chunk-GS7TDQXA.js → chunk-76SRRIGW.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkDTFLXAZJ_js = require('./chunk-DTFLXAZJ.js');
+var chunkTF3S7T6P_js = require('./chunk-TF3S7T6P.js');
 require('viem');
 
 var getPausedStates = async ({
@@ -8,16 +8,16 @@ var getPausedStates = async ({
   tellerAddress,
   chainId
 }) => {
-  const client = await chunkDTFLXAZJ_js.getClient(chainId);
+  const client = await chunkTF3S7T6P_js.getClient(chainId);
   const results = await client.multicall({
     contracts: [
       {
-        abi: chunkDTFLXAZJ_js.TellerAbi,
+        abi: chunkTF3S7T6P_js.TellerAbi,
         address: tellerAddress,
         functionName: "isPaused"
       },
       {
-        abi: chunkDTFLXAZJ_js.AccountantAbi,
+        abi: chunkTF3S7T6P_js.AccountantAbi,
         address: accountantAddress,
         functionName: "accountantState"
       }
@@ -33,9 +33,9 @@ var getPreviewFee = async ({
   contractAddress,
   chainId
 }) => {
-  const client = await chunkDTFLXAZJ_js.getClient(chainId);
+  const client = await chunkTF3S7T6P_js.getClient(chainId);
   const rate = await client.readContract({
-    abi: chunkDTFLXAZJ_js.TellerAbi,
+    abi: chunkTF3S7T6P_js.TellerAbi,
     address: contractAddress,
     functionName: "previewFee",
     args: [shareAmount, bridgeData]
@@ -45,5 +45,5 @@ var getPreviewFee = async ({
 
 exports.getPausedStates = getPausedStates;
 exports.getPreviewFee = getPreviewFee;
-//# sourceMappingURL=chunk-GS7TDQXA.js.map
-//# sourceMappingURL=chunk-GS7TDQXA.js.map
+//# sourceMappingURL=chunk-76SRRIGW.js.map
+//# sourceMappingURL=chunk-76SRRIGW.js.map

package/dist/{chunk-GS7TDQXA.js.map → chunk-76SRRIGW.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/api/multi-call.ts","../src/api/teller.ts"],"names":["getClient","TellerAbi","AccountantAbi"],"mappings":";;;;;AA2CA,IAAM,kBAAkB,OAAO;AAAA,EAC7B,iBAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA,KAAyB;AACvB,EAAA,MAAM,MAAA,GAAS,MAAMA,0BAAA,CAAU,OAAO,CAAA;AAEtC,EAAA,MAAM,OAAA,GAAU,MAAM,MAAA,CAAO,SAAA,CAAU;AAAA,IACrC,SAAA,EAAW;AAAA,MACT;AAAA,QACE,GAAA,EAAKC,0BAAA;AAAA,QACL,OAAA,EAAS,aAAA;AAAA,QACT,YAAA,EAAc;AAAA,OAChB;AAAA,MACA;AAAA,QACE,GAAA,EAAKC,8BAAA;AAAA,QACL,OAAA,EAAS,iBAAA;AAAA,QACT,YAAA,EAAc;AAAA;AAChB;AACF,GACD,CAAA;AACD,EAAA,OAAO,OAAA;AACT;;;ACjCA,IAAM,gBAAgB,OAAO;AAAA,EAC3B,WAAA;AAAA,EACA,UAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF,CAAA,KAA2C;AACzC,EAAA,MAAM,MAAA,GAAS,MAAMF,0BAAA,CAAU,OAAO,CAAA;AAEtC,EAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAAO,YAAA,CAAa;AAAA,IACrC,GAAA,EAAKC,0BAAA;AAAA,IACL,OAAA,EAAS,eAAA;AAAA,IACT,YAAA,EAAc,YAAA;AAAA,IACd,IAAA,EAAM,CAAC,WAAA,EAAa,UAAU;AAAA,GAC/B,CAAA;AAED,EAAA,OAAO,IAAA;AACT","file":"chunk-GS7TDQXA.js","sourcesContent":["import { type Address, erc20Abi } from \"viem\";\nimport { AccountantAbi } from \"../abi/accountant-abi\";\nimport { TellerAbi } from \"../abi/teller-abi\";\nimport { getClient } from \"../lib/viem/client\";\nimport type { ChainId } from \"./vault-config\";\n\ntype RateInQuoteWithAssetDecimalsProps = {\n  assetAddress: Address;\n  accountantAddress: Address;\n  chainId: ChainId;\n};\n\nconst getRateInQuoteWithAssetDecimals = async ({\n  assetAddress,\n  accountantAddress,\n  chainId,\n}: RateInQuoteWithAssetDecimalsProps) => {\n  const client = await getClient(chainId);\n\n  const results = await client.multicall({\n    contracts: [\n      {\n        abi: erc20Abi,\n        address: assetAddress,\n        functionName: \"decimals\",\n      },\n      {\n        abi: AccountantAbi,\n        address: accountantAddress,\n        functionName: \"getRateInQuote\",\n        args: [assetAddress],\n      },\n    ],\n  });\n  return results;\n};\n\ntype PausedStatusProps = {\n  accountantAddress: Address;\n  tellerAddress: Address;\n  chainId: ChainId;\n};\n\nconst getPausedStates = async ({\n  accountantAddress,\n  tellerAddress,\n  chainId,\n}: PausedStatusProps) => {\n  const client = await getClient(chainId);\n\n  const results = await client.multicall({\n    contracts: [\n      {\n        abi: TellerAbi,\n        address: tellerAddress,\n        functionName: \"isPaused\",\n      },\n      {\n        abi: AccountantAbi,\n        address: accountantAddress,\n        functionName: \"accountantState\",\n      },\n    ],\n  });\n  return results;\n};\n\nexport { getPausedStates, getRateInQuoteWithAssetDecimals };\n","/**\n * @fileoverview Functions for interacting with the Teller contract\n */\nimport type { Address } from \"viem\";\nimport { TellerAbi } from \"../abi/teller-abi\";\nimport { getClient } from \"../lib/viem/client\";\nimport type { ChainId } from \"./vault-config\";\n\n/**\n * Arguments required by the bridge contract for cross-chain transfers\n * @interface BridgeData\n * @property {number} chainSelector - Unique identifier for the destination chain\n * @property {Address} destinationChainReceiver - Address that will receive the bridged tokens\n * @property {Address} bridgeFeeToken - Token used to pay the bridge fee\n * @property {bigint} messageGas - Amount of gas allocated for the cross-chain message\n * @property {`0x${string}`} data - Additional data required for the bridge operation (hex encoded)\n */\nexport type BridgeData = {\n  chainSelector: number;\n  destinationChainReceiver: Address;\n  bridgeFeeToken: Address;\n  messageGas: bigint;\n  data: `0x${string}`;\n};\n\ntype GetPreviewFeeProps = {\n  shareAmount: bigint;\n  bridgeData: BridgeData;\n  contractAddress: Address;\n  chainId: ChainId;\n};\n\nconst getPreviewFee = async ({\n  shareAmount,\n  bridgeData,\n  contractAddress,\n  chainId,\n}: GetPreviewFeeProps): Promise<bigint> => {\n  const client = await getClient(chainId);\n\n  const rate = await client.readContract({\n    abi: TellerAbi,\n    address: contractAddress,\n    functionName: \"previewFee\",\n    args: [shareAmount, bridgeData],\n  });\n\n  return rate;\n};\n\nexport { getPreviewFee };\n"]}
+{"version":3,"sources":["../src/api/multi-call.ts","../src/api/teller.ts"],"names":["getClient","TellerAbi","AccountantAbi"],"mappings":";;;;;AA2CA,IAAM,kBAAkB,OAAO;AAAA,EAC7B,iBAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA,KAAyB;AACvB,EAAA,MAAM,MAAA,GAAS,MAAMA,0BAAA,CAAU,OAAO,CAAA;AAEtC,EAAA,MAAM,OAAA,GAAU,MAAM,MAAA,CAAO,SAAA,CAAU;AAAA,IACrC,SAAA,EAAW;AAAA,MACT;AAAA,QACE,GAAA,EAAKC,0BAAA;AAAA,QACL,OAAA,EAAS,aAAA;AAAA,QACT,YAAA,EAAc;AAAA,OAChB;AAAA,MACA;AAAA,QACE,GAAA,EAAKC,8BAAA;AAAA,QACL,OAAA,EAAS,iBAAA;AAAA,QACT,YAAA,EAAc;AAAA;AAChB;AACF,GACD,CAAA;AACD,EAAA,OAAO,OAAA;AACT;;;ACjCA,IAAM,gBAAgB,OAAO;AAAA,EAC3B,WAAA;AAAA,EACA,UAAA;AAAA,EACA,eAAA;AAAA,EACA;AACF,CAAA,KAA2C;AACzC,EAAA,MAAM,MAAA,GAAS,MAAMF,0BAAA,CAAU,OAAO,CAAA;AAEtC,EAAA,MAAM,IAAA,GAAO,MAAM,MAAA,CAAO,YAAA,CAAa;AAAA,IACrC,GAAA,EAAKC,0BAAA;AAAA,IACL,OAAA,EAAS,eAAA;AAAA,IACT,YAAA,EAAc,YAAA;AAAA,IACd,IAAA,EAAM,CAAC,WAAA,EAAa,UAAU;AAAA,GAC/B,CAAA;AAED,EAAA,OAAO,IAAA;AACT","file":"chunk-76SRRIGW.js","sourcesContent":["import { type Address, erc20Abi } from \"viem\";\nimport { AccountantAbi } from \"../abi/accountant-abi\";\nimport { TellerAbi } from \"../abi/teller-abi\";\nimport { getClient } from \"../lib/viem/client\";\nimport type { ChainId } from \"./vault-config\";\n\ntype RateInQuoteWithAssetDecimalsProps = {\n  assetAddress: Address;\n  accountantAddress: Address;\n  chainId: ChainId;\n};\n\nconst getRateInQuoteWithAssetDecimals = async ({\n  assetAddress,\n  accountantAddress,\n  chainId,\n}: RateInQuoteWithAssetDecimalsProps) => {\n  const client = await getClient(chainId);\n\n  const results = await client.multicall({\n    contracts: [\n      {\n        abi: erc20Abi,\n        address: assetAddress,\n        functionName: \"decimals\",\n      },\n      {\n        abi: AccountantAbi,\n        address: accountantAddress,\n        functionName: \"getRateInQuote\",\n        args: [assetAddress],\n      },\n    ],\n  });\n  return results;\n};\n\ntype PausedStatusProps = {\n  accountantAddress: Address;\n  tellerAddress: Address;\n  chainId: ChainId;\n};\n\nconst getPausedStates = async ({\n  accountantAddress,\n  tellerAddress,\n  chainId,\n}: PausedStatusProps) => {\n  const client = await getClient(chainId);\n\n  const results = await client.multicall({\n    contracts: [\n      {\n        abi: TellerAbi,\n        address: tellerAddress,\n        functionName: \"isPaused\",\n      },\n      {\n        abi: AccountantAbi,\n        address: accountantAddress,\n        functionName: \"accountantState\",\n      },\n    ],\n  });\n  return results;\n};\n\nexport { getPausedStates, getRateInQuoteWithAssetDecimals };\n","/**\n * @fileoverview Functions for interacting with the Teller contract\n */\nimport type { Address } from \"viem\";\nimport { TellerAbi } from \"../abi/teller-abi\";\nimport { getClient } from \"../lib/viem/client\";\nimport type { ChainId } from \"./vault-config\";\n\n/**\n * Arguments required by the bridge contract for cross-chain transfers\n * @interface BridgeData\n * @property {number} chainSelector - Unique identifier for the destination chain\n * @property {Address} destinationChainReceiver - Address that will receive the bridged tokens\n * @property {Address} bridgeFeeToken - Token used to pay the bridge fee\n * @property {bigint} messageGas - Amount of gas allocated for the cross-chain message\n * @property {`0x${string}`} data - Additional data required for the bridge operation (hex encoded)\n */\nexport type BridgeData = {\n  chainSelector: number;\n  destinationChainReceiver: Address;\n  bridgeFeeToken: Address;\n  messageGas: bigint;\n  data: `0x${string}`;\n};\n\ntype GetPreviewFeeProps = {\n  shareAmount: bigint;\n  bridgeData: BridgeData;\n  contractAddress: Address;\n  chainId: ChainId;\n};\n\nconst getPreviewFee = async ({\n  shareAmount,\n  bridgeData,\n  contractAddress,\n  chainId,\n}: GetPreviewFeeProps): Promise<bigint> => {\n  const client = await getClient(chainId);\n\n  const rate = await client.readContract({\n    abi: TellerAbi,\n    address: contractAddress,\n    functionName: \"previewFee\",\n    args: [shareAmount, bridgeData],\n  });\n\n  return rate;\n};\n\nexport { getPreviewFee };\n"]}

package/dist/{chunk-XXHRCCZS.mjs → chunk-AQFFMJX7.mjs}

@@ -4,8 +4,8 @@ var YieldType = {
   TBILL: "TBILL",
   LENDING: "LENDING"
 };
-var DEFAULT_SLIPPAGE_BPS = 5;
+var DEFAULT_SLIPPAGE_BPS = 50;
 
 export { DEFAULT_SLIPPAGE_BPS, YieldType };
-//# sourceMappingURL=chunk-XXHRCCZS.mjs.map
-//# sourceMappingURL=chunk-XXHRCCZS.mjs.map
+//# sourceMappingURL=chunk-AQFFMJX7.mjs.map
+//# sourceMappingURL=chunk-AQFFMJX7.mjs.map

package/dist/chunk-AQFFMJX7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants/config.ts"],"names":[],"mappings":";AAeO,IAAM,SAAA,GAAY;AAAA,EACvB,KAAA,EAAO,OAAA;AAAA,EACP,KAAA,EAAO,OAAA;AAAA,EACP,OAAA,EAAS;AACX;AAwDO,IAAM,oBAAA,GAAuB","file":"chunk-AQFFMJX7.mjs","sourcesContent":["/**\n * SDK Configuration Constants\n *\n * Global constants for supported chains, yield types, tokens, and defaults.\n * Centralized configuration for address book integration and permit deposits.\n */\n\nimport type { Address } from \"viem\";\n\n/**\n * Yield Type identifiers\n *\n * Use as const values: YieldType.PRIME, YieldType.TBILL, YieldType.LENDING\n * Use as type annotation: yieldType: YieldType\n */\nexport const YieldType = {\n  PRIME: \"PRIME\",\n  TBILL: \"TBILL\",\n  LENDING: \"LENDING\",\n} as const;\n\nexport type YieldType = (typeof YieldType)[keyof typeof YieldType];\n\n/**\n * Supported Yield Types\n *\n * Yield products offered by Nucleus.\n */\nexport const SUPPORTED_YIELD_TYPES: readonly YieldType[] = [\n  \"PRIME\",\n  \"TBILL\",\n  \"LENDING\",\n];\n\n/**\n * Token Allow List for Permit Deposits\n *\n * @returns Token allow list for permit deposits\n */\nexport const TOKEN_ALLOW_LIST_BY_CHAIN_FOR_PERMIT_DEPOSITS = {\n  1: [\n    {\n      symbol: \"USDC\",\n      address: \"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\",\n      supportsPermit: true,\n    },\n    {\n      symbol: \"USDG\",\n      address: \"0xe343167631d89b6ffc58b88d6b7fb0228795491d\",\n      supportsPermit: true,\n    },\n  ],\n} as const;\n\n/**\n * Permit Types\n *\n * @returns Permit types\n */\nexport const PERMIT_TYPES = {\n  Permit: [\n    { name: \"owner\", type: \"address\" },\n    { name: \"spender\", type: \"address\" },\n    { name: \"value\", type: \"uint256\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"deadline\", type: \"uint256\" },\n  ],\n} as const;\n\n/**\n * Default Slippage: 50 basis points (0.5%)\n *\n * Conservative default for deposit transactions.\n * Can be overridden per transaction.\n */\nexport const DEFAULT_SLIPPAGE_BPS = 50; // 0.5%\n\n/**\n * Maximum Slippage: 10000 basis points (100%)\n *\n * Safeguard against accidental extreme slippage.\n */\nexport const MAX_SLIPPAGE_BPS = 10000;\n\n/**\n * Minimum Slippage: 0 basis points (0%)\n *\n * Minimum enforced slippage in basis points.\n */\nexport const MIN_SLIPPAGE_BPS = 0;\n\n/**\n * Permit Configuration Defaults\n *\n * Default settings for ERC2612 permit-based approvals.\n */\nexport const PERMIT_CONFIG = {\n  /** Default deadline: 1 hour from signature */\n  defaultDeadlineSeconds: 3600,\n  /** Minimum deadline: 5 minutes (time to submit transaction) */\n  minDeadlineSeconds: 300,\n  /** Maximum deadline: 24 hours (limits signature validity) */\n  maxDeadlineSeconds: 86400,\n  /** Cache permit support checks for 24 hours */\n  cachePermitSupport: true,\n  /** Permit support cache TTL: 24 hours */\n  permitSupportCacheTTL: 86400000,\n} as const;\n\n/**\n * Address Book Cache Configuration\n *\n * Default settings for address book query caching.\n */\nexport const ADDRESS_BOOK_CACHE_CONFIG = {\n  /** Cache TTL: 1 hour */\n  defaultTTL: 3600000,\n  /** Auto-refresh cache on errors */\n  autoRefreshOnError: true,\n  /** Maximum cache size: 1000 entries */\n  maxCacheSize: 1000,\n} as const;\n\n/**\n * Deposit Configuration Defaults\n *\n * Default settings for deposit transaction preparation.\n */\nexport const DEPOSIT_CONFIG = {\n  /** Default slippage in basis points */\n  defaultSlippageBps: DEFAULT_SLIPPAGE_BPS,\n  /** Maximum allowed slippage */\n  maxSlippageBps: MAX_SLIPPAGE_BPS,\n  /** Require approval check before deposit */\n  requireApprovalCheck: true,\n  /** Don't auto-approve without user confirmation */\n  autoApprove: false,\n} as const;\n\n/**\n * Gas Estimation Defaults\n *\n * Default gas limits for different operations.\n */\nexport const GAS_CONFIG = {\n  /** Gas limit for approve transaction */\n  approveGasLimit: 100000n,\n  /** Gas limit for permit deposit transaction */\n  permitDepositGasLimit: 500000n,\n  /** Gas limit for standard deposit + approve */\n  standardDepositGasLimit: 600000n,\n} as const;\n\n/**\n * Performance Targets\n *\n * Expected performance characteristics for monitoring.\n */\nexport const PERFORMANCE_TARGETS = {\n  /** Address book queries should complete in <50ms */\n  addressBookQueryMs: 50,\n  /** Permit signature generation should complete in <100ms */\n  permitSignatureMs: 100,\n  /** Transaction preparation should complete in <200ms */\n  transactionPreparationMs: 200,\n} as const;\n\n/**\n * Error Codes\n *\n * Standardized error codes for programmatic error handling.\n */\nexport const ERROR_CODES = {\n  // Address Book Errors\n  VAULT_NOT_FOUND: \"VAULT_NOT_FOUND\",\n  CHAIN_NOT_SUPPORTED: \"CHAIN_NOT_SUPPORTED\",\n  TOKEN_NOT_SUPPORTED: \"TOKEN_NOT_SUPPORTED\",\n  YIELD_TYPE_NOT_SUPPORTED: \"YIELD_TYPE_NOT_SUPPORTED\",\n  ADDRESS_BOOK_DATA_ERROR: \"ADDRESS_BOOK_DATA_ERROR\",\n  ADDRESS_BOOK_CACHE_ERROR: \"ADDRESS_BOOK_CACHE_ERROR\",\n\n  // Permit Errors\n  PERMIT_NOT_SUPPORTED: \"PERMIT_NOT_SUPPORTED\",\n  PERMIT_SIGNATURE_ERROR: \"PERMIT_SIGNATURE_ERROR\",\n  INVALID_DEADLINE: \"INVALID_DEADLINE\",\n  NONCE_ERROR: \"NONCE_ERROR\",\n  DOMAIN_SEPARATOR_ERROR: \"DOMAIN_SEPARATOR_ERROR\",\n  INVALID_PERMIT_SIGNATURE: \"INVALID_PERMIT_SIGNATURE\",\n\n  // Deposit Errors\n  INVALID_DEPOSIT_AMOUNT: \"INVALID_DEPOSIT_AMOUNT\",\n  INVALID_SLIPPAGE: \"INVALID_SLIPPAGE\",\n  INSUFFICIENT_APPROVAL: \"INSUFFICIENT_APPROVAL\",\n  INVALID_USER_ADDRESS: \"INVALID_USER_ADDRESS\",\n  DEPOSIT_VALIDATION_ERROR: \"DEPOSIT_VALIDATION_ERROR\",\n  TRANSACTION_PREPARATION_ERROR: \"TRANSACTION_PREPARATION_ERROR\",\n\n  // CommunityCodeDepositor Errors\n  INVALID_DEPOSITOR_ADDRESS: \"INVALID_DEPOSITOR_ADDRESS\",\n  DEPOSITOR_CONTRACT_ERROR: \"DEPOSITOR_CONTRACT_ERROR\",\n} as const;\n\n/**\n * Type for error codes\n */\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\n/**\n * Helper: Check if yield type is supported\n *\n * @param yieldType - Yield product type\n * @returns true if yield type is in the supported list\n */\nexport function isSupportedYieldType(\n  yieldType: string\n): yieldType is YieldType {\n  return SUPPORTED_YIELD_TYPES.includes(yieldType as YieldType);\n}\n\n/**\n * Helper: Get permit version for token\n *\n * @param symbol - Stablecoin symbol\n * @returns Permit version (\"1\" or \"2\") or undefined if not supported\n */\nexport function getTokenAllowListByChainForPermitDeposits(\n  chainId: number,\n  depositTokenAddress: Address\n) {\n  const tokens =\n    TOKEN_ALLOW_LIST_BY_CHAIN_FOR_PERMIT_DEPOSITS[\n      chainId as keyof typeof TOKEN_ALLOW_LIST_BY_CHAIN_FOR_PERMIT_DEPOSITS\n    ];\n  if (!tokens) {\n    return null;\n  }\n\n  return tokens.find(\n    (t: { address: string; supportsPermit: boolean }) =>\n      t.address.toLowerCase() === depositTokenAddress.toLowerCase()\n  );\n}\n"]}

package/dist/{chunk-B2QCI6ET.js → chunk-EWJDKRSY.js}

@@ -3,29 +3,91 @@
 var viem = require('viem');
 var chains = require('viem/chains');
 
-// src/types/amplify-sdk-api.ts
-var APIError = class _APIError extends Error {
-  constructor(message, options) {
-    super(message);
-    this.name = "APIError";
-    this.statusCode = options?.statusCode;
-    this.endpoint = options?.endpoint;
-    this.cause = options?.cause;
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, _APIError);
+// src/types/telemetry.ts
+var LogLevel = {
+  DEBUG: 0,
+  INFO: 1,
+  WARN: 2,
+  ERROR: 3,
+  NONE: 4
+};
+
+// src/lib/logger.ts
+var ConsoleLogger = class {
+  constructor(level = LogLevel.ERROR) {
+    this.level = level;
+  }
+  /**
+   * Update log level
+   */
+  setLevel(level) {
+    this.level = level;
+  }
+  /**
+   * Get current log level
+   */
+  getLevel() {
+    return this.level;
+  }
+  debug(message, context) {
+    if (this.level <= LogLevel.DEBUG) {
+      if (context) {
+        console.debug("[Amplify SDK]", message, context);
+      } else {
+        console.debug("[Amplify SDK]", message);
+      }
+    }
+  }
+  info(message, context) {
+    if (this.level <= LogLevel.INFO) {
+      if (context) {
+        console.info("[Amplify SDK]", message, context);
+      } else {
+        console.info("[Amplify SDK]", message);
+      }
+    }
+  }
+  warn(message, context) {
+    if (this.level <= LogLevel.WARN) {
+      if (context) {
+        console.warn("[Amplify SDK]", message, context);
+      } else {
+        console.warn("[Amplify SDK]", message);
+      }
+    }
+  }
+  error(message, context) {
+    if (this.level <= LogLevel.ERROR) {
+      if (context) {
+        console.error("[Amplify SDK]", message, context);
+      } else {
+        console.error("[Amplify SDK]", message);
+      }
     }
   }
 };
-function isValidYieldType(value) {
-  return typeof value === "string" && (value === "PRIME" || value === "TBILL" || value === "LENDING");
+var currentLogger = new ConsoleLogger(LogLevel.ERROR);
+var defaultLogger = currentLogger;
+function setLogger(logger) {
+  currentLogger = logger;
 }
-function isValidAddress(value) {
-  return typeof value === "string" && /^0x[a-fA-F0-9]{40}$/.test(value);
+function getLogger() {
+  return currentLogger;
 }
-function isValidChainId(value) {
-  return typeof value === "number" && value > 0 && Number.isInteger(value);
+function setLogLevel(level) {
+  if (defaultLogger && typeof defaultLogger.setLevel === "function") {
+    defaultLogger.setLevel(level);
+  }
 }
 
+// src/constants/index.ts
+var ATOMIC_QUEUE_CONTRACT_ADDRESS = "0x228c44bb4885c6633f4b6c83f14622f37d5112e5";
+var DEFAULT_DEADLINE = 3;
+var NATIVE_TOKEN_FOR_BRIDGE_FEE = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
+var CHAINLINK_ADDRESS = "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419";
+var DEFAULT_APPROVAL_AMOUNT = BigInt(2) ** BigInt(256) - BigInt(1);
+var API_BASE_URL = "https://api.paxoslabs.com";
+
 // src/lib/vault-cache.ts
 var DEFAULT_TTL = 6e5;
 var VaultCache = class {
@@ -193,7 +255,6 @@ var VaultCache = class {
 };
 
 // src/api/amplify-sdk-client.ts
-var API_BASE_URL = "https://api.paxoslabs.com";
 var DEFAULT_TIMEOUT = 1e4;
 function createTimeoutSignal(timeoutMs) {
   const controller = new AbortController();
@@ -619,7 +680,8 @@ var sdkConfig = {
   isInitialized: false,
   initializedAt: null,
   isInitializing: false,
-  initPromise: null
+  initPromise: null,
+  telemetryEnabled: true
 };
 var ERROR_MESSAGES = {
   INVALID_API_KEY: "Invalid API key format. Expected format: pxl_<type>_<string>",
@@ -652,6 +714,8 @@ function clearConfig() {
   sdkConfig.initializedAt = null;
   sdkConfig.isInitializing = false;
   sdkConfig.initPromise = null;
+  sdkConfig.telemetryEnabled = true;
+  resetTelemetry();
 }
 function getRequestHeaders() {
   const apiKey = getAPIKey();
@@ -663,7 +727,7 @@ function getRequestHeaders() {
   }
   return headers;
 }
-async function initAmplifySDK(apiKey) {
+async function initAmplifySDK(apiKey, options) {
   validateAPIKey(apiKey);
   if (sdkConfig.isInitialized && sdkConfig.apiKey === apiKey) {
     return;
@@ -676,6 +740,13 @@ async function initAmplifySDK(apiKey) {
     clearConfig();
     clearCache();
   }
+  if (options?.logger) {
+    setLogger(options.logger);
+  }
+  if (options?.logLevel !== void 0) {
+    setLogLevel(options.logLevel);
+  }
+  sdkConfig.telemetryEnabled = options?.telemetry !== false;
   sdkConfig.isInitializing = true;
   sdkConfig.initPromise = (async () => {
     try {
@@ -684,6 +755,10 @@ async function initAmplifySDK(apiKey) {
       await cache.refresh();
       sdkConfig.isInitialized = true;
       sdkConfig.initializedAt = /* @__PURE__ */ new Date();
+      if (sdkConfig.telemetryEnabled) {
+        initTelemetry(apiKey).catch(() => {
+        });
+      }
     } catch (error) {
       clearConfig();
       clearCache();
@@ -701,6 +776,213 @@ async function initAmplifySDK(apiKey) {
   })();
   await sdkConfig.initPromise;
 }
+
+// src/lib/telemetry.ts
+var SDK_VERSION = "0.1.1-beta.1";
+var MAX_ERROR_BUFFER_SIZE = 10;
+var CONFIG_FETCH_TIMEOUT = 5e3;
+var telemetryState = {
+  enabled: false,
+  isInitialized: false,
+  isInitializing: false,
+  initPromise: null,
+  config: null,
+  apiKey: null
+};
+var posthogClient = null;
+var errorBuffer = [];
+var bufferFullWarningLogged = false;
+function createTimeoutSignal2(timeoutMs) {
+  const controller = new AbortController();
+  setTimeout(() => controller.abort(), timeoutMs);
+  return controller.signal;
+}
+function hashApiKey(apiKey) {
+  const FNV_OFFSET = BigInt("0xcbf29ce484222325");
+  const FNV_PRIME = BigInt("0x100000001b3");
+  let hash = FNV_OFFSET;
+  for (let i = 0; i < apiKey.length; i++) {
+    hash ^= BigInt(apiKey.charCodeAt(i));
+    hash = hash * FNV_PRIME & BigInt("0xffffffffffffffff");
+  }
+  return `sdk_${hash.toString(16).slice(0, 12)}`;
+}
+async function fetchTelemetryConfig(apiKey) {
+  const endpoint = "/v1/earn-sdk/config";
+  const url = `${API_BASE_URL}${endpoint}`;
+  try {
+    const headers = getRequestHeaders();
+    if (!headers["x-api-key"]) {
+      headers["x-api-key"] = apiKey;
+    }
+    const response = await fetch(url, {
+      method: "GET",
+      headers,
+      signal: createTimeoutSignal2(CONFIG_FETCH_TIMEOUT)
+    });
+    if (!response.ok) {
+      return null;
+    }
+    const data = await response.json();
+    if (!data || typeof data.posthogApiKey !== "string") {
+      return null;
+    }
+    return {
+      posthogApiKey: data.posthogApiKey,
+      posthogHost: data.posthogHost || "https://us.i.posthog.com"
+    };
+  } catch {
+    return null;
+  }
+}
+async function flushErrorBuffer() {
+  if (errorBuffer.length === 0 || !posthogClient) {
+    return;
+  }
+  for (const bufferedError of errorBuffer) {
+    const payload = {
+      error_type: bufferedError.name,
+      error_message: bufferedError.message,
+      error_code: bufferedError.code,
+      sdk_version: SDK_VERSION,
+      buffered: true,
+      ...bufferedError.context
+    };
+    posthogClient.capture("sdk_error", payload);
+  }
+  errorBuffer.length = 0;
+}
+async function initTelemetry(apiKey) {
+  if (telemetryState.isInitialized) {
+    return;
+  }
+  if (telemetryState.isInitializing && telemetryState.initPromise) {
+    await telemetryState.initPromise;
+    return;
+  }
+  telemetryState.isInitializing = true;
+  telemetryState.apiKey = apiKey;
+  telemetryState.initPromise = (async () => {
+    try {
+      const config = await fetchTelemetryConfig(apiKey);
+      if (!config) {
+        telemetryState.enabled = false;
+        telemetryState.isInitialized = true;
+        return;
+      }
+      telemetryState.config = config;
+      const posthogModule = await import('posthog-js');
+      const posthog = posthogModule.default;
+      posthog.init(config.posthogApiKey, {
+        api_host: config.posthogHost,
+        autocapture: false,
+        capture_pageview: false,
+        capture_pageleave: false,
+        disable_session_recording: true,
+        persistence: "memory",
+        // Don't persist to localStorage
+        loaded: (ph) => {
+          ph.identify(hashApiKey(apiKey));
+        }
+      });
+      posthogClient = posthog;
+      telemetryState.enabled = true;
+      telemetryState.isInitialized = true;
+      await flushErrorBuffer();
+      posthog.capture("sdk_initialized", {
+        sdk_version: SDK_VERSION
+      });
+    } catch (error) {
+      const logger = getLogger();
+      logger.warn("Telemetry initialization failed", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      telemetryState.enabled = false;
+      telemetryState.isInitialized = true;
+    } finally {
+      telemetryState.isInitializing = false;
+      telemetryState.initPromise = null;
+    }
+  })();
+  await telemetryState.initPromise;
+}
+function trackError(error, context) {
+  const logger = getLogger();
+  logger.error(error.message, {
+    name: error.name,
+    stack: error.stack,
+    ...context
+  });
+  const errorDetails = {
+    name: error.name,
+    message: error.message,
+    code: error.code,
+    context: context || {},
+    timestamp: Date.now()
+  };
+  if (!posthogClient || !telemetryState.enabled) {
+    if (errorBuffer.length < MAX_ERROR_BUFFER_SIZE) {
+      errorBuffer.push(errorDetails);
+    } else if (!bufferFullWarningLogged) {
+      logger.warn(
+        `Telemetry error buffer full (${MAX_ERROR_BUFFER_SIZE} errors). Additional errors will not be tracked until telemetry initializes.`
+      );
+      bufferFullWarningLogged = true;
+    }
+    return;
+  }
+  const payload = {
+    error_type: error.name,
+    error_message: error.message,
+    error_code: error.code,
+    endpoint: error.endpoint,
+    status_code: error.statusCode,
+    sdk_version: SDK_VERSION,
+    ...context
+  };
+  posthogClient.capture("sdk_error", payload);
+}
+function resetTelemetry() {
+  telemetryState.enabled = false;
+  telemetryState.isInitialized = false;
+  telemetryState.isInitializing = false;
+  telemetryState.initPromise = null;
+  telemetryState.config = null;
+  telemetryState.apiKey = null;
+  posthogClient = null;
+  errorBuffer.length = 0;
+  bufferFullWarningLogged = false;
+}
+
+// src/types/amplify-sdk-api.ts
+var APIError = class _APIError extends Error {
+  constructor(message, options) {
+    super(message);
+    this.name = "APIError";
+    this.statusCode = options?.statusCode;
+    this.endpoint = options?.endpoint;
+    this.cause = options?.cause;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _APIError);
+    }
+    try {
+      trackError(this, {
+        endpoint: this.endpoint,
+        statusCode: this.statusCode
+      });
+    } catch {
+    }
+  }
+};
+function isValidYieldType(value) {
+  return typeof value === "string" && (value === "PRIME" || value === "TBILL" || value === "LENDING");
+}
+function isValidAddress(value) {
+  return typeof value === "string" && /^0x[a-fA-F0-9]{40}$/.test(value);
+}
+function isValidChainId(value) {
+  return typeof value === "number" && value > 0 && Number.isInteger(value);
+}
 var rari = viem.defineChain({
   id: 1380012617,
   name: "Rari Chain",
@@ -803,21 +1085,14 @@ function clearChainsCache() {
   chainsCache = null;
 }
 
-// src/constants/index.ts
-var ATOMIC_QUEUE_CONTRACT_ADDRESS = "0x228c44bb4885c6633f4b6c83f14622f37d5112e5";
-var DEFAULT_DEADLINE = 3;
-var NATIVE_TOKEN_FOR_BRIDGE_FEE = "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee";
-var CHAINLINK_ADDRESS = "0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419";
-var DEFAULT_APPROVAL_AMOUNT = BigInt(2) ** BigInt(256) - BigInt(1);
-var NUCLEUS_BASE_URL = "https://backend.nucleusearn.io/v1/protocol";
-
 exports.APIError = APIError;
+exports.API_BASE_URL = API_BASE_URL;
 exports.ATOMIC_QUEUE_CONTRACT_ADDRESS = ATOMIC_QUEUE_CONTRACT_ADDRESS;
 exports.CHAINLINK_ADDRESS = CHAINLINK_ADDRESS;
 exports.DEFAULT_APPROVAL_AMOUNT = DEFAULT_APPROVAL_AMOUNT;
 exports.DEFAULT_DEADLINE = DEFAULT_DEADLINE;
+exports.LogLevel = LogLevel;
 exports.NATIVE_TOKEN_FOR_BRIDGE_FEE = NATIVE_TOKEN_FOR_BRIDGE_FEE;
-exports.NUCLEUS_BASE_URL = NUCLEUS_BASE_URL;
 exports.clearChainsCache = clearChainsCache;
 exports.fetchSupportedAssets = fetchSupportedAssets;
 exports.fetchVaults = fetchVaults;
@@ -825,9 +1100,12 @@ exports.findVaultByConfig = findVaultByConfig;
 exports.getAssetsFromCache = getAssetsFromCache;
 exports.getCache = getCache;
 exports.getChainFromConfig = getChainFromConfig;
+exports.getLogger = getLogger;
 exports.getWithdrawSupportedAssets = getWithdrawSupportedAssets;
 exports.initAmplifySDK = initAmplifySDK;
 exports.initializeCache = initializeCache;
 exports.refreshVaultCache = refreshVaultCache;
-//# sourceMappingURL=chunk-B2QCI6ET.js.map
-//# sourceMappingURL=chunk-B2QCI6ET.js.map
+exports.setLogLevel = setLogLevel;
+exports.setLogger = setLogger;
+//# sourceMappingURL=chunk-EWJDKRSY.js.map
+//# sourceMappingURL=chunk-EWJDKRSY.js.map