@1llet.xyz/erc4337-gasless-sdk 0.4.46 → 0.4.48

package/README.md

@@ -1,6 +1,6 @@
 # ERC-4337 Gasless SDK ⛽️
 
-A lightweight, typed SDK to integrate Account Abstraction (ERC-4337) and Cross-Chain transfers into your dApp. It handles Smart Account creation, gasless transactions, and orchestrates cross-chain bridges.
+A lightweight, typed SDK to integrate Account Abstraction (ERC-4337) and Cross-Chain transfers into your dApp. It handles Smart Account creation, gasless transactions, and orchestrates cross-chain bridges strategies including CCTP and Near Intents.
 
 ## 📦 Installation
 
@@ -61,7 +61,7 @@ await aa.sendTransaction({
 
 ## 🌉 Cross-Chain Transfer Manager
 
-The `TransferManager` orchestrates transfers between chains, choosing the best strategy (CCTP, Near Intents) or signaling a direct transfer if on the same chain.
+The `TransferManager` orchestrates transfers between chains, choosing the best strategy (**CCTP**, **Near Intents**) or signaling a **Direct Transfer** if on the same chain.
 
 ```typescript
 import { TransferManager, BridgeContext } from "@1llet.xyz/erc4337-gasless-sdk";
@@ -76,7 +76,14 @@ const context: BridgeContext = {
     amount: "10.5", // Human readable string
     recipient: "0xRecipient...",
     senderAddress: "0xSender...",
-    facilitatorPrivateKey: "0x..." // For CCTP/Near verification usage (Backend)
+    
+    // Optional: Provide depositTxHash if you already made the deposit
+    depositTxHash: "0x...", 
+    
+    // Optional: For Stellar source
+    paymentPayload: {
+        signedXDR: "AAAA..."
+    }
 };
 
 const result = await transferManager.execute(context);
@@ -86,22 +93,79 @@ if (result.success) {
         // Signal to Client: Execute direct transfer on same chain!
         console.log("Execute local transfer:", result.data);
     } else {
-        // Cross-chain initiated
-        console.log("Bridge Tx:", result.transactionHash);
+        // Cross-chain initiated (or Deposit Address returned for Near)
+        console.log("Bridge Tx / Deposit Address:", result.data);
     }
 } else {
     console.error("Error:", result.errorReason);
 }
 ```
 
+### Simulation (Quote)
+
+You can simulate a simulation to estimate fees and received amount before executing.
+
+```typescript
+import { getNearSimulation } from "@1llet.xyz/erc4337-gasless-sdk";
+
+const simulation = await getNearSimulation(
+    "Base", 
+    "Gnosis", 
+    "10", 
+    "USDC", // Source
+    "EURe"  // Destination
+);
+
+if (simulation.success) {
+    console.log(`Fee: ${simulation.protocolFee}`);
+    console.log(`Est. Received: ${simulation.estimatedReceived}`);
+} else {
+    console.error(simulation.error);
+}
+```
+
+---
+
+## 🌟 Stellar Service
+
+The SDK includes a dedicated `StellarService` to handle non-EVM interactions, useful for bridging from Stellar to EVM.
+
+```typescript
+import { StellarService } from "@1llet.xyz/erc4337-gasless-sdk";
+
+const stellar = new StellarService();
+
+// 1. Get Balance
+const balance = await stellar.getBalance("G...", "USDC");
+
+// 2. Build Transfer XDR (for bridging)
+const xdr = await stellar.buildTransferXdr(
+    "S_SENDER_PRIVATE_KEY", 
+    "G_RECIPIENT_ADDRESS", 
+    "10", // Amount 
+    "USDC",
+    "MEMO_IF_NEEDED"
+);
+
+// 3. Submit Transaction
+const hash = await stellar.submitXdr(xdr);
+```
+
+---
+
 ## 🛠️ Supported Chains
 
 The SDK exports pre-configured objects:
 
-- `BASE_MAINNET`
-- `BASE_SEPOLIA`
+- `BASE_MAINNET`, `BASE_SEPOLIA`
 - `OPTIMISM_MAINNET`
+- `ARBITRUM_MAINNET`
 - `GNOSIS_MAINNET`
+- `POLYGON_MAINNET`
+- `AVALANCHE_MAINNET`
+- `STELLAR_MAINNET`
+- `UNICHAIN_SEPOLIA`
+- `WORLD_CHAIN_MAINNET`
 
 ```typescript
 import { GNOSIS_MAINNET } from "@1llet.xyz/erc4337-gasless-sdk";

package/dist/index.d.mts

@@ -464,7 +464,7 @@ declare function getNearSimulation(sourceChain: ChainKey, destChain: ChainKey, a
     amountSent: number;
     protocolFee: number;
     netAmountBridged: number;
-    estimatedReceived: any;
+    estimatedReceived: string;
     minAmount: number;
     error?: undefined;
 } | {

package/dist/index.d.ts

@@ -464,7 +464,7 @@ declare function getNearSimulation(sourceChain: ChainKey, destChain: ChainKey, a
     amountSent: number;
     protocolFee: number;
     netAmountBridged: number;
-    estimatedReceived: any;
+    estimatedReceived: string;
     minAmount: number;
     error?: undefined;
 } | {

package/dist/index.js

@@ -2403,14 +2403,13 @@ async function getNearSimulation(sourceChain, destChain, amount, destToken, sour
       sender,
       { dry: true }
     );
-    console.log(">>> [Bridge Quote] API Response:", JSON.stringify(quoteResult.quote, null, 2));
     return {
       success: true,
       amountSent: amountNum,
       protocolFee: usedFee,
       netAmountBridged: parseFloat(netAmountBridged),
       // @ts-ignore - access safe property
-      estimatedReceived: quoteResult.quote?.quote?.estimatedOutput || "0",
+      estimatedReceived: quoteResult.quote?.quote?.amountOutFormatted || "0",
       minAmount: MIN_AMOUNT
     };
   } catch (error) {