@pafi-dev/core 0.18.0 → 0.19.0

package/dist/index.d.cts

@@ -695,6 +695,59 @@ interface BuildPerpDepositViaRelayParams {
  */
 declare function buildPerpDepositViaRelay(params: BuildPerpDepositViaRelayParams): PartialUserOperation;
 
+/**
+ * Builder for the `erc20-transfer` sponsored scenario.
+ *
+ * Produces two UserOps from one request — same nonce, same sender:
+ *
+ *   sponsored (2 calls):
+ *     [ token.transfer(PAFI_FEE_RECIPIENT, fee), token.transfer(recipient, amount) ]
+ *
+ *   fallback (1 call):
+ *     [ token.transfer(recipient, amount) ]
+ *
+ * Both calls use the SAME token contract — the fee currency equals the
+ * token being sent (decision documented in
+ * `docs/SPONSORED_ERC20_TRANSFER_SPEC.md`). Caller is responsible for
+ * validating the token is in the sponsorship allowlist; this function
+ * just builds calldata, no policy enforcement.
+ *
+ * The sponsor-relayer's IntentValidator enforces:
+ *   - exactly 2 calls
+ *   - both target the same token address
+ *   - call[0] = transfer to PAFI_FEE_RECIPIENT, amount >= 95% quoted
+ *   - call[1] = transfer to recipient (not fee recipient, not 0x0)
+ *
+ * Fallback variant (1 call, no fee) submits no-paymaster — caller's
+ * `sendWithPaymasterFallback` routes there when sponsorship is refused.
+ */
+interface BuildErc20TransferParams {
+    /** EIP-7702 delegated user EOA (== smart account sender). */
+    userAddress: Address;
+    /** ERC-4337 nonce from the EntryPoint. */
+    aaNonce: bigint;
+    /** Whitelisted ERC-20 to transfer. */
+    tokenAddress: Address;
+    /** Final recipient. Must NOT equal `feeRecipient` or `0x0...0`. */
+    recipient: Address;
+    /** Amount to send (token-native units; 6-dec for stables, 18-dec for PT). */
+    amount: bigint;
+    /**
+     * Operator fee in the SAME token. Sponsored variant only — pass
+     * `undefined` or 0n to skip and build the no-fee variant.
+     */
+    feeAmount?: bigint;
+    /** Required when `feeAmount > 0`. */
+    feeRecipient?: Address;
+    /** Override gas limits if you have a tighter Pimlico estimate. */
+    gasLimits?: {
+        callGasLimit?: bigint;
+        verificationGasLimit?: bigint;
+        preVerificationGas?: bigint;
+    };
+}
+declare function buildErc20TransferUserOp(params: BuildErc20TransferParams): PartialUserOperation;
+
 /**
  * Build an ERC-20 `transfer(to, amount)` operation. Used inside a batch
  * to move fee tokens from the user to the fee recipient atomically with
@@ -1021,7 +1074,7 @@ interface PaymasterConfig {
  * validates the request's target contracts + function selectors
  * match the expected pattern for the scenario.
  */
-type SponsorshipScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate";
+type SponsorshipScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate" | "erc20-transfer";
 
 /**
  * Submission path chosen by `checkEthAndBranch`.
@@ -1576,7 +1629,8 @@ declare function sendWithPaymasterFallback(params: SendWithPaymasterFallbackPara
  *
  * Pass an explicit `gasUnits` to override.
  */
-type FeeScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate";
+type FeeScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate" | "erc20-transfer";
+declare const SCENARIO_GAS_UNITS: Record<FeeScenario, bigint>;
 interface QuoteOperatorFeePtConfig {
     provider: PublicClient;
     chainId: number;
@@ -1689,6 +1743,43 @@ interface QuoteOperatorFeeUsdtConfig {
  */
 declare function quoteOperatorFeeUsdt(config: QuoteOperatorFeeUsdtConfig): Promise<bigint>;
 declare function quoteOperatorFeePt(config: QuoteOperatorFeePtConfig): Promise<bigint>;
+/**
+ * Router quoter for the `erc20-transfer` sponsored scenario — picks
+ * the correct underlying quoter based on the token being transferred:
+ *
+ *   USDC / USDT  →  `quoteOperatorFeeUsdt` (Chainlink-based, 6-dec)
+ *   active PT    →  `quoteOperatorFeePt`   (Chainlink + V3 pool quote)
+ *
+ * Fee is denominated in the SAME token the user is sending — no extra
+ * approval / swap step needed. Caller is responsible for verifying the
+ * token IS in the sponsored allowlist before calling; this function
+ * just routes by address equality.
+ *
+ * Returns the fee in the token's native units (6-dec for USDC/USDT,
+ * 18-dec for PT). The sponsor-relayer reproduces the same quote
+ * server-side with a 5% slack window.
+ *
+ * @example
+ * ```ts
+ * const fee = await quoteOperatorFeeForTransfer({
+ *   provider, chainId: 8453,
+ *   tokenAddress: USDC_ADDRESS,
+ * });
+ * ```
+ */
+interface QuoteOperatorFeeForTransferConfig extends Omit<QuoteOperatorFeeUsdtConfig, "scenario"> {
+    /** The ERC-20 the user is transferring. Drives both quote logic + fee currency. */
+    tokenAddress: Address;
+    /**
+     * Subgraph URL override — only consumed when `tokenAddress` resolves
+     * to a PT (USDC/USDT paths don't hit the subgraph).
+     */
+    subgraphUrl?: string;
+    /** PT fallback (only used when `tokenAddress` is a PT and subgraph fails). */
+    fallbackPtPriceUsdt?: number;
+    fetchImpl?: typeof fetch;
+}
+declare function quoteOperatorFeeForTransfer(config: QuoteOperatorFeeForTransferConfig): Promise<bigint>;
 
 declare const BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: `0x${string}`;
 declare const BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: `0x${string}`;
@@ -2141,4 +2232,4 @@ declare class PafiSDK {
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositViaRelayParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, DUMMY_SIGNATURE_V07, type DelegateDirectParams, type DelegateDirectResult, type DelegateImpl, EIP712Signature, ENTRY_POINT_V07, ENTRY_POINT_V08, type Eip7702AuthorizationJsonRpc, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_RELAY_ABI, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, type Operation, OracleStaleError, type OrderlyRelayDepositRequest, PAFI_SERVICE_URLS, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiErrorType, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSdkError, type PafiServiceUrls, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, QUOTER_V2_ADDRESSES, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, SDK_ERROR_HTTP_STATUS_CODE, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignAuthorizationFn, type SignatureStruct, SignatureVerification, SignatureVerifyOptions, type SignedAuthorization, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeBatchExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeBatchExecute, encodeV3Path, encodeV3PathReversed, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiServiceUrls, getPafiWebModalAdapter, isDelegatedTo, isDelegatedToTarget, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, splitAuthorizationSig, webPopupAdapter };
+export { ApiError, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, type BuildDelegationUserOpParams, type BuildErc20TransferParams, type BuildPartialUserOpParams, type BuildPerpDepositViaRelayParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, DUMMY_SIGNATURE_V07, type DelegateDirectParams, type DelegateDirectResult, type DelegateImpl, EIP712Signature, ENTRY_POINT_V07, ENTRY_POINT_V08, type Eip7702AuthorizationJsonRpc, type FallbackInfo, type FeeScenario, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_RELAY_ABI, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, type Operation, OracleStaleError, type OrderlyRelayDepositRequest, PAFI_SERVICE_URLS, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiErrorType, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSdkError, type PafiServiceUrls, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, QUOTER_V2_ADDRESSES, type QuoteOperatorFeeForTransferConfig, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, SCENARIO_GAS_UNITS, SDK_ERROR_HTTP_STATUS_CODE, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignAuthorizationFn, type SignatureStruct, SignatureVerification, SignatureVerifyOptions, type SignedAuthorization, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildErc20TransferUserOp, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeBatchExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeBatchExecute, encodeV3Path, encodeV3PathReversed, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiServiceUrls, getPafiWebModalAdapter, isDelegatedTo, isDelegatedToTarget, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeeForTransfer, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, splitAuthorizationSig, webPopupAdapter };

package/dist/index.d.ts

@@ -695,6 +695,59 @@ interface BuildPerpDepositViaRelayParams {
  */
 declare function buildPerpDepositViaRelay(params: BuildPerpDepositViaRelayParams): PartialUserOperation;
 
+/**
+ * Builder for the `erc20-transfer` sponsored scenario.
+ *
+ * Produces two UserOps from one request — same nonce, same sender:
+ *
+ *   sponsored (2 calls):
+ *     [ token.transfer(PAFI_FEE_RECIPIENT, fee), token.transfer(recipient, amount) ]
+ *
+ *   fallback (1 call):
+ *     [ token.transfer(recipient, amount) ]
+ *
+ * Both calls use the SAME token contract — the fee currency equals the
+ * token being sent (decision documented in
+ * `docs/SPONSORED_ERC20_TRANSFER_SPEC.md`). Caller is responsible for
+ * validating the token is in the sponsorship allowlist; this function
+ * just builds calldata, no policy enforcement.
+ *
+ * The sponsor-relayer's IntentValidator enforces:
+ *   - exactly 2 calls
+ *   - both target the same token address
+ *   - call[0] = transfer to PAFI_FEE_RECIPIENT, amount >= 95% quoted
+ *   - call[1] = transfer to recipient (not fee recipient, not 0x0)
+ *
+ * Fallback variant (1 call, no fee) submits no-paymaster — caller's
+ * `sendWithPaymasterFallback` routes there when sponsorship is refused.
+ */
+interface BuildErc20TransferParams {
+    /** EIP-7702 delegated user EOA (== smart account sender). */
+    userAddress: Address;
+    /** ERC-4337 nonce from the EntryPoint. */
+    aaNonce: bigint;
+    /** Whitelisted ERC-20 to transfer. */
+    tokenAddress: Address;
+    /** Final recipient. Must NOT equal `feeRecipient` or `0x0...0`. */
+    recipient: Address;
+    /** Amount to send (token-native units; 6-dec for stables, 18-dec for PT). */
+    amount: bigint;
+    /**
+     * Operator fee in the SAME token. Sponsored variant only — pass
+     * `undefined` or 0n to skip and build the no-fee variant.
+     */
+    feeAmount?: bigint;
+    /** Required when `feeAmount > 0`. */
+    feeRecipient?: Address;
+    /** Override gas limits if you have a tighter Pimlico estimate. */
+    gasLimits?: {
+        callGasLimit?: bigint;
+        verificationGasLimit?: bigint;
+        preVerificationGas?: bigint;
+    };
+}
+declare function buildErc20TransferUserOp(params: BuildErc20TransferParams): PartialUserOperation;
+
 /**
  * Build an ERC-20 `transfer(to, amount)` operation. Used inside a batch
  * to move fee tokens from the user to the fee recipient atomically with
@@ -1021,7 +1074,7 @@ interface PaymasterConfig {
  * validates the request's target contracts + function selectors
  * match the expected pattern for the scenario.
  */
-type SponsorshipScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate";
+type SponsorshipScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate" | "erc20-transfer";
 
 /**
  * Submission path chosen by `checkEthAndBranch`.
@@ -1576,7 +1629,8 @@ declare function sendWithPaymasterFallback(params: SendWithPaymasterFallbackPara
  *
  * Pass an explicit `gasUnits` to override.
  */
-type FeeScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate";
+type FeeScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate" | "erc20-transfer";
+declare const SCENARIO_GAS_UNITS: Record<FeeScenario, bigint>;
 interface QuoteOperatorFeePtConfig {
     provider: PublicClient;
     chainId: number;
@@ -1689,6 +1743,43 @@ interface QuoteOperatorFeeUsdtConfig {
  */
 declare function quoteOperatorFeeUsdt(config: QuoteOperatorFeeUsdtConfig): Promise<bigint>;
 declare function quoteOperatorFeePt(config: QuoteOperatorFeePtConfig): Promise<bigint>;
+/**
+ * Router quoter for the `erc20-transfer` sponsored scenario — picks
+ * the correct underlying quoter based on the token being transferred:
+ *
+ *   USDC / USDT  →  `quoteOperatorFeeUsdt` (Chainlink-based, 6-dec)
+ *   active PT    →  `quoteOperatorFeePt`   (Chainlink + V3 pool quote)
+ *
+ * Fee is denominated in the SAME token the user is sending — no extra
+ * approval / swap step needed. Caller is responsible for verifying the
+ * token IS in the sponsored allowlist before calling; this function
+ * just routes by address equality.
+ *
+ * Returns the fee in the token's native units (6-dec for USDC/USDT,
+ * 18-dec for PT). The sponsor-relayer reproduces the same quote
+ * server-side with a 5% slack window.
+ *
+ * @example
+ * ```ts
+ * const fee = await quoteOperatorFeeForTransfer({
+ *   provider, chainId: 8453,
+ *   tokenAddress: USDC_ADDRESS,
+ * });
+ * ```
+ */
+interface QuoteOperatorFeeForTransferConfig extends Omit<QuoteOperatorFeeUsdtConfig, "scenario"> {
+    /** The ERC-20 the user is transferring. Drives both quote logic + fee currency. */
+    tokenAddress: Address;
+    /**
+     * Subgraph URL override — only consumed when `tokenAddress` resolves
+     * to a PT (USDC/USDT paths don't hit the subgraph).
+     */
+    subgraphUrl?: string;
+    /** PT fallback (only used when `tokenAddress` is a PT and subgraph fails). */
+    fallbackPtPriceUsdt?: number;
+    fetchImpl?: typeof fetch;
+}
+declare function quoteOperatorFeeForTransfer(config: QuoteOperatorFeeForTransferConfig): Promise<bigint>;
 
 declare const BATCH_EXECUTOR_ADDRESS_BASE_MAINNET: `0x${string}`;
 declare const BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA: `0x${string}`;
@@ -2141,4 +2232,4 @@ declare class PafiSDK {
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, type BuildDelegationUserOpParams, type BuildPartialUserOpParams, type BuildPerpDepositViaRelayParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, DUMMY_SIGNATURE_V07, type DelegateDirectParams, type DelegateDirectResult, type DelegateImpl, EIP712Signature, ENTRY_POINT_V07, ENTRY_POINT_V08, type Eip7702AuthorizationJsonRpc, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_RELAY_ABI, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, type Operation, OracleStaleError, type OrderlyRelayDepositRequest, PAFI_SERVICE_URLS, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiErrorType, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSdkError, type PafiServiceUrls, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, QUOTER_V2_ADDRESSES, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, SDK_ERROR_HTTP_STATUS_CODE, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignAuthorizationFn, type SignatureStruct, SignatureVerification, SignatureVerifyOptions, type SignedAuthorization, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeBatchExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeBatchExecute, encodeV3Path, encodeV3PathReversed, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiServiceUrls, getPafiWebModalAdapter, isDelegatedTo, isDelegatedToTarget, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, splitAuthorizationSig, webPopupAdapter };
+export { ApiError, BATCH_EXECUTOR_7702_IMPL, BATCH_EXECUTOR_ABI, BATCH_EXECUTOR_ADDRESS_BASE_MAINNET, BATCH_EXECUTOR_ADDRESS_BASE_SEPOLIA, BROKER_HASHES, type BuildDelegationUserOpParams, type BuildErc20TransferParams, type BuildPartialUserOpParams, type BuildPerpDepositViaRelayParams, type BuildPerpDepositWithGasDeductionParams, COMMON_POOLS, COMMON_TOKENS, CONTRACT_ADDRESSES, ChainConfig, type CheckEthAndBranchParams, ConfigurationError, type ContractAddresses, DUMMY_SIGNATURE_V07, type DelegateDirectParams, type DelegateDirectResult, type DelegateImpl, EIP712Signature, ENTRY_POINT_V07, ENTRY_POINT_V08, type Eip7702AuthorizationJsonRpc, type FallbackInfo, type FeeScenario, LoginMessageParams, MintRequest, type ModalOpenOptions, ORDERLY_RELAY_ABI, ORDERLY_VAULT_ABI, ORDERLY_VAULT_ADDRESSES, ORDERLY_VAULT_BASE_MAINNET, type Operation, OracleStaleError, type OrderlyRelayDepositRequest, PAFI_SERVICE_URLS, PAFI_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiErrorType, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSdkError, type PafiServiceUrls, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, QUOTER_V2_ADDRESSES, type QuoteOperatorFeeForTransferConfig, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, SCENARIO_GAS_UNITS, SDK_ERROR_HTTP_STATUS_CODE, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignAuthorizationFn, type SignatureStruct, SignatureVerification, SignatureVerifyOptions, type SignedAuthorization, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildErc20TransferUserOp, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeBatchExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeBatchExecute, encodeV3Path, encodeV3PathReversed, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiServiceUrls, getPafiWebModalAdapter, isDelegatedTo, isDelegatedToTarget, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeeForTransfer, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, splitAuthorizationSig, webPopupAdapter };

package/dist/index.js

@@ -532,6 +532,43 @@ function buildPerpDepositViaRelay(params) {
   });
 }
 
+// src/transfer/buildErc20Transfer.ts
+function buildErc20TransferUserOp(params) {
+  if (params.amount <= 0n) {
+    throw new Error("buildErc20TransferUserOp: amount must be positive");
+  }
+  const operations = [];
+  if (params.feeAmount && params.feeAmount > 0n) {
+    if (!params.feeRecipient) {
+      throw new Error(
+        "buildErc20TransferUserOp: feeRecipient required when feeAmount > 0"
+      );
+    }
+    operations.push(
+      erc20TransferOp(
+        params.tokenAddress,
+        params.feeRecipient,
+        params.feeAmount
+      )
+    );
+  }
+  operations.push(
+    erc20TransferOp(params.tokenAddress, params.recipient, params.amount)
+  );
+  return buildPartialUserOperation({
+    sender: params.userAddress,
+    nonce: params.aaNonce,
+    operations,
+    gasLimits: {
+      // 2 simple ERC-20 transfers + 7702 batch overhead. ~70-90k actual;
+      // 200k matches the `delegate` scenario budget and covers premium.
+      callGasLimit: params.gasLimits?.callGasLimit ?? 200000n,
+      verificationGasLimit: params.gasLimits?.verificationGasLimit ?? 150000n,
+      preVerificationGas: params.gasLimits?.preVerificationGas ?? 50000n
+    }
+  });
+}
+
 // src/userop/types.ts
 var ZERO_VALUE = 0n;
 
@@ -1119,7 +1156,11 @@ var SCENARIO_GAS_UNITS = {
   burn: 500000n,
   swap: 700000n,
   "perp-deposit": 800000n,
-  delegate: 200000n
+  delegate: 200000n,
+  // 2-call batch: 1 ERC-20 fee transfer + 1 ERC-20 transfer + 7702
+  // delegation overhead. ~70-90k empirical; 200k matches `delegate`
+  // budget and gives headroom for premium variance.
+  "erc20-transfer": 200000n
 };
 var DEFAULT_GAS_UNITS = 500000n;
 var DEFAULT_PREMIUM_BPS = 12e3;
@@ -1184,6 +1225,42 @@ async function quoteOperatorFeePt(config) {
   ]);
   return withPremium * ethPrice8dec * ptPerUsdt18dec / 10n ** 26n;
 }
+async function quoteOperatorFeeForTransfer(config) {
+  const { provider, chainId, tokenAddress } = config;
+  const { usdc, usdt } = getContractAddresses(chainId);
+  const tokenLower = tokenAddress.toLowerCase();
+  const isStable = usdc && tokenLower === usdc.toLowerCase() || tokenLower === usdt.toLowerCase();
+  if (isStable) {
+    return quoteOperatorFeeUsdt({
+      provider,
+      chainId,
+      scenario: "erc20-transfer",
+      gasUnits: config.gasUnits,
+      premiumBps: config.premiumBps,
+      chainlinkFeedAddress: config.chainlinkFeedAddress,
+      usdtDecimals: config.usdtDecimals,
+      allowStaleFallback: config.allowStaleFallback,
+      fallbackEthPriceUsd: config.fallbackEthPriceUsd,
+      onFallback: config.onFallback
+    });
+  }
+  return quoteOperatorFeePt({
+    provider,
+    chainId,
+    pointTokenAddress: tokenAddress,
+    scenario: "erc20-transfer",
+    gasUnits: config.gasUnits,
+    premiumBps: config.premiumBps,
+    chainlinkFeedAddress: config.chainlinkFeedAddress,
+    subgraphUrl: config.subgraphUrl,
+    usdtDecimals: config.usdtDecimals,
+    allowStaleFallback: config.allowStaleFallback,
+    fallbackEthPriceUsd: config.fallbackEthPriceUsd,
+    fallbackPtPriceUsdt: config.fallbackPtPriceUsdt,
+    onFallback: config.onFallback,
+    fetchImpl: config.fetchImpl
+  });
+}
 async function getEthPrice8dec(provider, feed, fallback, onFallback) {
   try {
     const result = await provider.readContract({
@@ -1599,6 +1676,7 @@ export {
   PafiSDK,
   PafiSdkError,
   QUOTER_V2_ADDRESSES,
+  SCENARIO_GAS_UNITS,
   SDK_ERROR_HTTP_STATUS_CODE,
   SIMPLE_7702_IMPL_BASE_MAINNET,
   SPONSOR_AUTH_DOMAIN_ANCHOR_BASE_MAINNET,
@@ -1621,6 +1699,7 @@ export {
   buildDelegationUserOp,
   buildDomain,
   buildEip7702Authorization,
+  buildErc20TransferUserOp,
   buildMintRequestTypedData,
   buildPartialUserOperation,
   buildPerpDepositViaRelay,
@@ -1684,6 +1763,7 @@ export {
   permit2Abi,
   pointTokenAbi,
   pointTokenFactoryAbi,
+  quoteOperatorFeeForTransfer,
   quoteOperatorFeePt,
   quoteOperatorFeeUsdt,
   rawCallOp,