@stableflow/wallet-evm 0.0.0-experimental-5a8afd7389-20260703

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StableFlow AI
+
+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,36 @@
+# @stableflow/wallet-evm
+
+EVM wallet adapter for the StableFlow SDK. Implements `WalletConfig` methods used by `BridgeSFA` and `ServiceMap` routes (approve, transfer, sign, quote simulation).
+
+## Installation
+
+```bash
+pnpm add @stableflow/wallet-evm @stableflow/core @stableflow/bridges
+```
+
+**Peer dependencies:**
+
+- `@layerzerolabs/lz-v2-utilities` ^3.0.151
+
+## When to use
+
+Connect any EVM-compatible wallet (MetaMask, WalletConnect via wagmi/ethers, etc.) and pass `wallet.wallet` (`WalletConfig`) into `BridgeSFA.getAllQuote` / `BridgeSFA.send`.
+
+For routes that require a separate EVM signer (e.g. permit on another chain), also pass `evmWallet` and `evmAddress` in `GetAllQuoteParams`.
+
+## Main exports
+
+```ts
+import EVMWallet, { EVMWallet as Named } from '@stableflow/wallet-evm';
+
+const adapter = new EVMWallet(/* ethers signer or wagmi client */);
+const walletConfig = adapter.wallet; // WalletConfig
+```
+
+See `dist/index.d.ts` after `pnpm build`.
+
+## See also
+
+- [Developer Guide](../../DEVELOPER_GUIDE.md)
+- [demo-evm example](../../examples/demo-evm/README.md)
+- [@stableflow/bridges](../bridges/README.md)

package/dist/index.d.mts

@@ -0,0 +1,109 @@
+import { Service, SendType } from '@stableflow/core';
+import { ethers } from 'ethers';
+
+declare class EVMWallet {
+    provider: any;
+    signer: any;
+    private csl;
+    constructor(_provider: any, _signer?: any);
+    transfer(data: {
+        originAsset: string;
+        depositAddress: string;
+        amount: string;
+    }): Promise<any>;
+    getBalance(token: any, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<any>;
+    balanceOf(token: any, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<any>;
+    /**
+     * Estimate gas limit for transfer transaction
+     * @param data Transfer data
+     * @returns Gas limit estimate, gas price, and estimated gas cost
+     */
+    estimateTransferGas(data: {
+        fromToken: any;
+        depositAddress: string;
+        amount: string;
+        account: string;
+    }): Promise<{
+        gasLimit: bigint;
+        gasPrice: bigint;
+        estimateGas: bigint;
+    }>;
+    getContract(params: any): ethers.Contract;
+    allowance(params: any): Promise<{
+        contract: ethers.Contract;
+        allowance: string;
+        needApprove: boolean;
+    }>;
+    approve(params: any): Promise<any>;
+    getEstimateGas(params: any): Promise<{
+        gasPrice: any;
+        usd: string;
+        wei: bigint;
+        amount: string;
+    }>;
+    estimateTransaction(params: any): Promise<{
+        estimateSourceGasLimit: bigint;
+        estimateSourceGas: bigint;
+        estimateSourceGasUsd: string;
+    }>;
+    quoteOFT(params: any): Promise<any>;
+    sendTransaction(params: any): Promise<any>;
+    /**
+     * Unified quote method that routes to specific quote methods based on type
+     * @param type Service type from Service
+     * @param params Parameters for the quote
+     */
+    quote(type: Service, params: any): Promise<any>;
+    /**
+     * Unified send method that routes to specific send methods based on type
+     * @param type Send type from SendType enum
+     * @param params Parameters for the send transaction
+     */
+    send(type: SendType, params: any): Promise<any>;
+    quoteCCTP(params: any): Promise<any>;
+    quoteOneClickProxy(params: any): Promise<any>;
+    quoteNative(params: any): Promise<any>;
+    quoteFraxZero(params: any): Promise<any>;
+    preivewRedeemFrxUSD(params: any): Promise<{
+        maxUsdc: any;
+        maxRwa: any;
+        amountWeiBigInt: bigint;
+        totalAssetsOut: bigint;
+        isInsufficientLiquidity: boolean;
+    }>;
+    previewMintFrxUSD(params: any): Promise<{
+        maxUsdc: any;
+        amountWeiBigInt: bigint;
+        totalMax: any;
+        totalAssetsOut: any;
+    }>;
+    /**
+     * Redeem frxUSD to USDC via USDC and/or RWA custodian contracts.
+     * Uses mdwrComboView to get max redeemable liquidity and splits redemption across USDC/RWA paths.
+     * Uses previewRedeem to get accurate output amount (USDC).
+     */
+    redeemFrxUSD(params: any): Promise<any>;
+    /**
+     * Mint frxUSD by depositing USDC into the custodian contract.
+     * Calls deposit(assetsIn, receiver) on usdcCustodianAddress.
+     * assetsIn = USDC amount (6 decimals), sharesOut = frxUSD amount (18 decimals).
+     */
+    mintFrxUSD(params: any): Promise<any>;
+    mintAndSendFrxUSD(params: any): Promise<any>;
+    retryLayerzeroLzComponse(params: any): Promise<any>;
+    signTypedData(params: any): Promise<{
+        owner: any;
+        value: any;
+        deadline: number;
+        nonce: number;
+        v: 27 | 28;
+        r: string;
+        s: string;
+    }>;
+}
+
+export { EVMWallet, EVMWallet as default };

package/dist/index.d.ts

@@ -0,0 +1,109 @@
+import { Service, SendType } from '@stableflow/core';
+import { ethers } from 'ethers';
+
+declare class EVMWallet {
+    provider: any;
+    signer: any;
+    private csl;
+    constructor(_provider: any, _signer?: any);
+    transfer(data: {
+        originAsset: string;
+        depositAddress: string;
+        amount: string;
+    }): Promise<any>;
+    getBalance(token: any, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<any>;
+    balanceOf(token: any, account: string, options?: {
+        isCatchError?: boolean;
+    }): Promise<any>;
+    /**
+     * Estimate gas limit for transfer transaction
+     * @param data Transfer data
+     * @returns Gas limit estimate, gas price, and estimated gas cost
+     */
+    estimateTransferGas(data: {
+        fromToken: any;
+        depositAddress: string;
+        amount: string;
+        account: string;
+    }): Promise<{
+        gasLimit: bigint;
+        gasPrice: bigint;
+        estimateGas: bigint;
+    }>;
+    getContract(params: any): ethers.Contract;
+    allowance(params: any): Promise<{
+        contract: ethers.Contract;
+        allowance: string;
+        needApprove: boolean;
+    }>;
+    approve(params: any): Promise<any>;
+    getEstimateGas(params: any): Promise<{
+        gasPrice: any;
+        usd: string;
+        wei: bigint;
+        amount: string;
+    }>;
+    estimateTransaction(params: any): Promise<{
+        estimateSourceGasLimit: bigint;
+        estimateSourceGas: bigint;
+        estimateSourceGasUsd: string;
+    }>;
+    quoteOFT(params: any): Promise<any>;
+    sendTransaction(params: any): Promise<any>;
+    /**
+     * Unified quote method that routes to specific quote methods based on type
+     * @param type Service type from Service
+     * @param params Parameters for the quote
+     */
+    quote(type: Service, params: any): Promise<any>;
+    /**
+     * Unified send method that routes to specific send methods based on type
+     * @param type Send type from SendType enum
+     * @param params Parameters for the send transaction
+     */
+    send(type: SendType, params: any): Promise<any>;
+    quoteCCTP(params: any): Promise<any>;
+    quoteOneClickProxy(params: any): Promise<any>;
+    quoteNative(params: any): Promise<any>;
+    quoteFraxZero(params: any): Promise<any>;
+    preivewRedeemFrxUSD(params: any): Promise<{
+        maxUsdc: any;
+        maxRwa: any;
+        amountWeiBigInt: bigint;
+        totalAssetsOut: bigint;
+        isInsufficientLiquidity: boolean;
+    }>;
+    previewMintFrxUSD(params: any): Promise<{
+        maxUsdc: any;
+        amountWeiBigInt: bigint;
+        totalMax: any;
+        totalAssetsOut: any;
+    }>;
+    /**
+     * Redeem frxUSD to USDC via USDC and/or RWA custodian contracts.
+     * Uses mdwrComboView to get max redeemable liquidity and splits redemption across USDC/RWA paths.
+     * Uses previewRedeem to get accurate output amount (USDC).
+     */
+    redeemFrxUSD(params: any): Promise<any>;
+    /**
+     * Mint frxUSD by depositing USDC into the custodian contract.
+     * Calls deposit(assetsIn, receiver) on usdcCustodianAddress.
+     * assetsIn = USDC amount (6 decimals), sharesOut = frxUSD amount (18 decimals).
+     */
+    mintFrxUSD(params: any): Promise<any>;
+    mintAndSendFrxUSD(params: any): Promise<any>;
+    retryLayerzeroLzComponse(params: any): Promise<any>;
+    signTypedData(params: any): Promise<{
+        owner: any;
+        value: any;
+        deadline: number;
+        nonce: number;
+        v: 27 | 28;
+        r: string;
+        s: string;
+    }>;
+}
+
+export { EVMWallet, EVMWallet as default };