@1llet.xyz/erc4337-gasless-sdk 0.4.47 → 0.4.49

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

@@ -1,4 +1,4 @@
-import { Chain, Address, Hash, Hex } from 'viem';
+import { Chain, Address, Hash, Hex, WalletClient } from 'viem';
 import * as StellarSdk from 'stellar-sdk';
 import { Address as Address$1 } from 'abitype';
 import z from 'zod';
@@ -83,11 +83,7 @@ declare class AccountAbstraction {
     private entryPointAddress;
     private factoryAddress;
     constructor(chainConfig: EvmChainConfig);
-    /**
-     * Connect to MetaMask OR use Private Key
-     * @param privateKey (Optional) Hex string of private key. If provided, uses local signing.
-     */
-    connect(privateKey?: Hex): Promise<{
+    connect(signer?: Hex | WalletClient): Promise<{
         owner: Address;
         smartAccount: Address;
     }>;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Chain, Address, Hash, Hex } from 'viem';
+import { Chain, Address, Hash, Hex, WalletClient } from 'viem';
 import * as StellarSdk from 'stellar-sdk';
 import { Address as Address$1 } from 'abitype';
 import z from 'zod';
@@ -83,11 +83,7 @@ declare class AccountAbstraction {
     private entryPointAddress;
     private factoryAddress;
     constructor(chainConfig: EvmChainConfig);
-    /**
-     * Connect to MetaMask OR use Private Key
-     * @param privateKey (Optional) Hex string of private key. If provided, uses local signing.
-     */
-    connect(privateKey?: Hex): Promise<{
+    connect(signer?: Hex | WalletClient): Promise<{
         owner: Address;
         smartAccount: Address;
     }>;

package/dist/index.js

@@ -692,13 +692,9 @@ var AccountAbstraction = class {
     this.tokenService = new TokenService(chainConfig, this.publicClient);
     this.userOpBuilder = new UserOpBuilder(chainConfig, this.bundlerClient, this.publicClient);
   }
-  /**
-   * Connect to MetaMask OR use Private Key
-   * @param privateKey (Optional) Hex string of private key. If provided, uses local signing.
-   */
-  async connect(privateKey) {
-    if (privateKey) {
-      const account = accounts.privateKeyToAccount(privateKey);
+  async connect(signer) {
+    if (typeof signer === "string") {
+      const account = accounts.privateKeyToAccount(signer);
       this.owner = account.address;
       const rpcUrl = this.chainConfig.rpcUrl || this.chainConfig.chain.rpcUrls.default.http[0];
       this.walletClient = viem.createWalletClient({
@@ -706,6 +702,10 @@ var AccountAbstraction = class {
         chain: this.chainConfig.chain,
         transport: viem.http(rpcUrl)
       });
+    } else if (signer && typeof signer === "object") {
+      this.walletClient = signer;
+      if (!this.walletClient.account) throw new Error("WalletClient must have an account");
+      this.owner = this.walletClient.account.address;
     } else {
       if (typeof window === "undefined" || !window.ethereum) {
         throw new Error("MetaMask is not installed and no private key provided");