@pafi-dev/core 0.7.4 → 0.7.6

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Address, Hex, TypedDataDomain, PublicClient, HttpTransport, WalletClient } from 'viem';
+import { Address, Hex, TypedDataDomain, PublicClient, WalletClient, TransactionReceipt, HttpTransport } from 'viem';
 import { P as PoolKey, C as ChainConfig, a as PafiSDKConfig, b as PointTokenDomainConfig, M as MintRequest, R as ReceiverConsent, E as EIP712Signature, S as SignatureVerification } from './types-BAkmxgVo.cjs';
 export { B as BestQuote, c as BurnRequest, I as Issuer, d as PathKey, Q as QuoteResult } from './types-BAkmxgVo.cjs';
 export { pointTokenAbi as POINT_TOKEN_V2_ABI, erc20Abi, issuerRegistryAbi, mintingOracleAbi, permit2Abi, pointTokenAbi, pointTokenFactoryAbi, universalRouterAbi, v4QuoterAbi } from './abi/index.cjs';
@@ -1152,6 +1152,157 @@ declare function buildEip7702Authorization(params: {
     authSig: Hex | string;
 }): Eip7702AuthorizationJsonRpc;
 
+/**
+ * Privy-style EIP-7702 authorization signer. Matches the shape returned
+ * by `useSign7702Authorization()` from `@privy-io/react-auth` /
+ * `@privy-io/expo`. Pass it via `params.signAuthorization` and the
+ * helper takes care of the rest.
+ *
+ * The signer MUST be the user's Privy embedded wallet — external
+ * wallets (MetaMask, WalletConnect, …) cannot produce raw secp256k1
+ * EIP-7702 authorizations.
+ */
+type SignAuthorizationFn = (args: {
+    contractAddress: Address;
+    chainId: number;
+    nonce: number;
+}) => Promise<{
+    contractAddress?: Address;
+    address?: Address;
+    chainId: number;
+    nonce: number;
+    r: Hex | string;
+    s: Hex | string;
+    v?: string | number;
+    yParity: 0 | 1 | string;
+}>;
+/**
+ * Authorization tuple in the shape `walletClient.sendTransaction`
+ * expects on its `authorizationList` field. Mirrors viem's
+ * `SignedAuthorization` so callers can also build it manually.
+ */
+interface SignedAuthorization {
+    contractAddress: Address;
+    chainId: number;
+    nonce: number;
+    r: Hex;
+    s: Hex;
+    yParity: 0 | 1;
+}
+interface DelegateDirectParams {
+    /** User EOA — must equal `walletClient.account.address`. */
+    userAddress: Address;
+    chainId: number;
+    /** viem PublicClient — used for `getCode` + `getTransactionCount`. */
+    publicClient: PublicClient;
+    /** viem WalletClient (or any sender that exposes `sendTransaction`). */
+    walletClient: WalletClient;
+    /**
+     * Privy hook that produces the EIP-7702 authorization signature.
+     * Pass `useSign7702Authorization().signAuthorization` directly.
+     */
+    signAuthorization: SignAuthorizationFn;
+    /**
+     * Override the impl the EOA delegates to. Defaults to
+     * `getContractAddresses(chainId).batchExecutor` (Pimlico
+     * Simple7702Account on Base mainnet — the canonical PAFI delegate
+     * target).
+     */
+    contractAddress?: Address;
+    /**
+     * When the user already has a 7702 delegation pointing at the
+     * expected impl, skip the tx and return early. Default `true`.
+     * Set `false` to force re-delegate even if status check passes.
+     */
+    skipIfAlreadyDelegated?: boolean;
+    /**
+     * Wait for the transaction receipt before returning. Default
+     * `true` — caller usually wants to know "delegation completed"
+     * before proceeding to claim/redeem flows.
+     */
+    waitForReceipt?: boolean;
+    /** Optional onWarning hook for non-fatal warnings (logger surface). */
+    onWarning?: (msg: string) => void;
+}
+interface DelegateDirectResult {
+    /** `'sent'` when a tx was broadcast; `'already-delegated'` when skipped. */
+    status: "sent" | "already-delegated";
+    /** Transaction hash. `undefined` on `already-delegated`. */
+    txHash?: Hex;
+    /** Receipt — present when `waitForReceipt` AND status is `'sent'`. */
+    receipt?: TransactionReceipt;
+    /** EIP-7702 authorization tuple actually sent. */
+    authorization: SignedAuthorization;
+    /** Impl address user delegated to. */
+    delegatedTo: Address;
+}
+/**
+ * One-shot helper for the FE-direct EIP-7702 delegation path —
+ * **no AA, no paymaster, no PAFI sponsor-relayer**. The user EOA
+ * pays gas in ETH and broadcasts a single type-4 transaction with the
+ * authorization attached.
+ *
+ * Use this when:
+ *   - The FE already has a Privy embedded wallet ready and the user
+ *     has a small ETH balance for gas (~$0.01–0.10 on Base).
+ *   - You don't want to depend on `permissionless` / Pimlico bundlers
+ *     / sponsor-relayer for the one-time delegation step.
+ *   - You're testing or running a self-hosted dev environment without
+ *     the full PAFI infra.
+ *
+ * Flow:
+ *   1. Read on-chain code; short-circuit if already delegated to the
+ *      expected impl (`skipIfAlreadyDelegated`).
+ *   2. Read EOA tx nonce (pending).
+ *   3. Call `signAuthorization` (Privy hook) → r/s/yParity.
+ *   4. Send EIP-7702 type-4 tx with `authorizationList: [auth]` and
+ *      `to: userAddress, data: '0x'` (no-op self-call; the work is
+ *      bundling the authorization).
+ *   5. Wait for receipt (optional).
+ *
+ * Caller's `signAuthorization` MUST be wired to the user's Privy
+ * embedded wallet — external wallets (MetaMask, …) do NOT support
+ * raw secp256k1 EIP-7702 sign.
+ *
+ * @example
+ * ```ts
+ * import { useSign7702Authorization, useWallets } from "@privy-io/react-auth";
+ * import { delegateDirect } from "@pafi-dev/core";
+ * import { createWalletClient, custom } from "viem";
+ * import { base } from "viem/chains";
+ *
+ * function DelegateButton() {
+ *   const { wallets } = useWallets();
+ *   const { signAuthorization } = useSign7702Authorization();
+ *   const wallet = wallets.find(w => w.walletClientType === "privy"); // embedded
+ *
+ *   async function handleClick() {
+ *     const provider = await wallet.getEthereumProvider();
+ *     const walletClient = createWalletClient({
+ *       account: wallet.address,
+ *       chain: base,
+ *       transport: custom(provider),
+ *     });
+ *
+ *     const result = await delegateDirect({
+ *       userAddress: wallet.address as `0x${string}`,
+ *       chainId: 8453,
+ *       publicClient,
+ *       walletClient,
+ *       signAuthorization,
+ *     });
+ *
+ *     if (result.status === "already-delegated") {
+ *       console.log("Already delegated to", result.delegatedTo);
+ *     } else {
+ *       console.log("Delegated! tx:", result.txHash);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare function delegateDirect(params: DelegateDirectParams): Promise<DelegateDirectResult>;
+
 /**
  * Parameters for `createPafiProxyTransport`.
  */
@@ -1820,4 +1971,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 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_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, PafiSdkError, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, ReceiverConsent, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignatureStruct, SignatureVerification, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V4_QUOTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, createPafiProxyTransport, decodeBatchExecuteCalls, detectDelegateImpl, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isDelegatedToTarget, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, receiverConsentTypes, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, setPaymasterConfig, 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 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_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, PafiSdkError, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, ReceiverConsent, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignAuthorizationFn, type SignatureStruct, SignatureVerification, type SignedAuthorization, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V4_QUOTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, createPafiProxyTransport, decodeBatchExecuteCalls, delegateDirect, detectDelegateImpl, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isDelegatedToTarget, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, receiverConsentTypes, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, setPaymasterConfig, splitAuthorizationSig, webPopupAdapter };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Address, Hex, TypedDataDomain, PublicClient, HttpTransport, WalletClient } from 'viem';
+import { Address, Hex, TypedDataDomain, PublicClient, WalletClient, TransactionReceipt, HttpTransport } from 'viem';
 import { P as PoolKey, C as ChainConfig, a as PafiSDKConfig, b as PointTokenDomainConfig, M as MintRequest, R as ReceiverConsent, E as EIP712Signature, S as SignatureVerification } from './types-BAkmxgVo.js';
 export { B as BestQuote, c as BurnRequest, I as Issuer, d as PathKey, Q as QuoteResult } from './types-BAkmxgVo.js';
 export { pointTokenAbi as POINT_TOKEN_V2_ABI, erc20Abi, issuerRegistryAbi, mintingOracleAbi, permit2Abi, pointTokenAbi, pointTokenFactoryAbi, universalRouterAbi, v4QuoterAbi } from './abi/index.js';
@@ -1152,6 +1152,157 @@ declare function buildEip7702Authorization(params: {
     authSig: Hex | string;
 }): Eip7702AuthorizationJsonRpc;
 
+/**
+ * Privy-style EIP-7702 authorization signer. Matches the shape returned
+ * by `useSign7702Authorization()` from `@privy-io/react-auth` /
+ * `@privy-io/expo`. Pass it via `params.signAuthorization` and the
+ * helper takes care of the rest.
+ *
+ * The signer MUST be the user's Privy embedded wallet — external
+ * wallets (MetaMask, WalletConnect, …) cannot produce raw secp256k1
+ * EIP-7702 authorizations.
+ */
+type SignAuthorizationFn = (args: {
+    contractAddress: Address;
+    chainId: number;
+    nonce: number;
+}) => Promise<{
+    contractAddress?: Address;
+    address?: Address;
+    chainId: number;
+    nonce: number;
+    r: Hex | string;
+    s: Hex | string;
+    v?: string | number;
+    yParity: 0 | 1 | string;
+}>;
+/**
+ * Authorization tuple in the shape `walletClient.sendTransaction`
+ * expects on its `authorizationList` field. Mirrors viem's
+ * `SignedAuthorization` so callers can also build it manually.
+ */
+interface SignedAuthorization {
+    contractAddress: Address;
+    chainId: number;
+    nonce: number;
+    r: Hex;
+    s: Hex;
+    yParity: 0 | 1;
+}
+interface DelegateDirectParams {
+    /** User EOA — must equal `walletClient.account.address`. */
+    userAddress: Address;
+    chainId: number;
+    /** viem PublicClient — used for `getCode` + `getTransactionCount`. */
+    publicClient: PublicClient;
+    /** viem WalletClient (or any sender that exposes `sendTransaction`). */
+    walletClient: WalletClient;
+    /**
+     * Privy hook that produces the EIP-7702 authorization signature.
+     * Pass `useSign7702Authorization().signAuthorization` directly.
+     */
+    signAuthorization: SignAuthorizationFn;
+    /**
+     * Override the impl the EOA delegates to. Defaults to
+     * `getContractAddresses(chainId).batchExecutor` (Pimlico
+     * Simple7702Account on Base mainnet — the canonical PAFI delegate
+     * target).
+     */
+    contractAddress?: Address;
+    /**
+     * When the user already has a 7702 delegation pointing at the
+     * expected impl, skip the tx and return early. Default `true`.
+     * Set `false` to force re-delegate even if status check passes.
+     */
+    skipIfAlreadyDelegated?: boolean;
+    /**
+     * Wait for the transaction receipt before returning. Default
+     * `true` — caller usually wants to know "delegation completed"
+     * before proceeding to claim/redeem flows.
+     */
+    waitForReceipt?: boolean;
+    /** Optional onWarning hook for non-fatal warnings (logger surface). */
+    onWarning?: (msg: string) => void;
+}
+interface DelegateDirectResult {
+    /** `'sent'` when a tx was broadcast; `'already-delegated'` when skipped. */
+    status: "sent" | "already-delegated";
+    /** Transaction hash. `undefined` on `already-delegated`. */
+    txHash?: Hex;
+    /** Receipt — present when `waitForReceipt` AND status is `'sent'`. */
+    receipt?: TransactionReceipt;
+    /** EIP-7702 authorization tuple actually sent. */
+    authorization: SignedAuthorization;
+    /** Impl address user delegated to. */
+    delegatedTo: Address;
+}
+/**
+ * One-shot helper for the FE-direct EIP-7702 delegation path —
+ * **no AA, no paymaster, no PAFI sponsor-relayer**. The user EOA
+ * pays gas in ETH and broadcasts a single type-4 transaction with the
+ * authorization attached.
+ *
+ * Use this when:
+ *   - The FE already has a Privy embedded wallet ready and the user
+ *     has a small ETH balance for gas (~$0.01–0.10 on Base).
+ *   - You don't want to depend on `permissionless` / Pimlico bundlers
+ *     / sponsor-relayer for the one-time delegation step.
+ *   - You're testing or running a self-hosted dev environment without
+ *     the full PAFI infra.
+ *
+ * Flow:
+ *   1. Read on-chain code; short-circuit if already delegated to the
+ *      expected impl (`skipIfAlreadyDelegated`).
+ *   2. Read EOA tx nonce (pending).
+ *   3. Call `signAuthorization` (Privy hook) → r/s/yParity.
+ *   4. Send EIP-7702 type-4 tx with `authorizationList: [auth]` and
+ *      `to: userAddress, data: '0x'` (no-op self-call; the work is
+ *      bundling the authorization).
+ *   5. Wait for receipt (optional).
+ *
+ * Caller's `signAuthorization` MUST be wired to the user's Privy
+ * embedded wallet — external wallets (MetaMask, …) do NOT support
+ * raw secp256k1 EIP-7702 sign.
+ *
+ * @example
+ * ```ts
+ * import { useSign7702Authorization, useWallets } from "@privy-io/react-auth";
+ * import { delegateDirect } from "@pafi-dev/core";
+ * import { createWalletClient, custom } from "viem";
+ * import { base } from "viem/chains";
+ *
+ * function DelegateButton() {
+ *   const { wallets } = useWallets();
+ *   const { signAuthorization } = useSign7702Authorization();
+ *   const wallet = wallets.find(w => w.walletClientType === "privy"); // embedded
+ *
+ *   async function handleClick() {
+ *     const provider = await wallet.getEthereumProvider();
+ *     const walletClient = createWalletClient({
+ *       account: wallet.address,
+ *       chain: base,
+ *       transport: custom(provider),
+ *     });
+ *
+ *     const result = await delegateDirect({
+ *       userAddress: wallet.address as `0x${string}`,
+ *       chainId: 8453,
+ *       publicClient,
+ *       walletClient,
+ *       signAuthorization,
+ *     });
+ *
+ *     if (result.status === "already-delegated") {
+ *       console.log("Already delegated to", result.delegatedTo);
+ *     } else {
+ *       console.log("Delegated! tx:", result.txHash);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare function delegateDirect(params: DelegateDirectParams): Promise<DelegateDirectResult>;
+
 /**
  * Parameters for `createPafiProxyTransport`.
  */
@@ -1820,4 +1971,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 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_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, PafiSdkError, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, ReceiverConsent, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignatureStruct, SignatureVerification, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V4_QUOTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, createPafiProxyTransport, decodeBatchExecuteCalls, detectDelegateImpl, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isDelegatedToTarget, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, receiverConsentTypes, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, setPaymasterConfig, 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 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_SUBGRAPH_URL, PERMIT2_ADDRESS, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_POOLS, type PackedUserOperationMessage, type PafiProxyTransportParams, PafiSDK, PafiSDKConfig, PafiSDKError, PafiSdkError, type PafiWebModalAdapter, type PafiWebModalHandle, type PartialUserOperation, type PaymasterConfig, type PaymasterFields, PointTokenDomainConfig, PoolKey, type QuoteOperatorFeePtConfig, type QuoteOperatorFeeUsdtConfig, ReceiverConsent, SIMPLE_7702_IMPL_BASE_MAINNET, SUPPORTED_CHAINS, type SdkErrorHttpStatus, type SendWithPaymasterFallbackParams, type SignAuthorizationFn, type SignatureStruct, SignatureVerification, type SignedAuthorization, SigningError, SimulationError, type SmartAccountSender, type SponsorshipScenario, type SubmissionPath, TOKEN_HASHES, UNIVERSAL_ROUTER_ADDRESSES, type UserOpReceipt, type UserOpTypedData, type UserOperation, V4_QUOTER_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, _resetPaymasterConfigForTests, assembleUserOperation, buildDelegationUserOp, buildEip7702Authorization, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, buildUserOpTypedData, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, createPafiProxyTransport, decodeBatchExecuteCalls, delegateDirect, detectDelegateImpl, encodeBatchExecute, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getContractAddresses, getDummySignatureFor7702, getPafiWebModalAdapter, getPaymasterConfig, isDelegatedTo, isDelegatedToTarget, isPaymasterConfigured, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, receiverConsentTypes, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, setPaymasterConfig, splitAuthorizationSig, webPopupAdapter };

package/dist/index.js

@@ -739,6 +739,155 @@ function buildEip7702Authorization(params) {
   };
 }
 
+// src/contracts/real/addresses.ts
+var PLACEHOLDER_DEAD = (suffix) => `0x000000000000000000000000000000000000${suffix.toLowerCase().padStart(4, "0")}`;
+var CONTRACT_ADDRESSES = {
+  // Base mainnet — SC-delivered (2026-04-21, 2026-04-22)
+  // registry:       IssuerRegistry       0xda2D3338CF70F462Ac175F5f2edfa45660CA4f31
+  // factory:        PointTokenFactory    0x36c0BAb2faBE45EfA6d13001143e43A266Af673B
+  // oracle:         MintingOracle        0xD85165939C700E51c8a45099316C6482634C2Ab9
+  // tokenImpl:      PointToken (impl)    0x2e6FB1B0C1A51abb83eC974890126a64eC02E995
+  // mockUsdt:       MockERC20            0x5d313485Ba59C3bb91e1A9C0C11782F0b83d5dcd
+  // POINT:          PointToken instance  0x7d25E7156E51F865D522fd3ef257a6B5DD41b97e
+  // batchExecutor:  Pimlico Simple7702   0xe6Cae83BdE06E4c305530e199D7217f42808555B
+  //                  (v0.7.6 — switched from Coinbase SW v2
+  //                  `0x7702cb...7176C`; CSW v2 uses SignatureWrapper
+  //                  format that Pimlico's `pm_sponsorUserOperation`
+  //                  cannot produce a working dummy sig for, leading
+  //                  to AA23 `0x3c10b94e` reverts on the simulator.
+  //                  Pimlico's `Simple7702Account` accepts standard
+  //                  v0.7 ECDSA dummy and matches what the web FE +
+  //                  permissionless `to7702SimpleSmartAccount` already
+  //                  used in production.)
+  // pafiHook:       PAFIHook (V4, 10%)   0x870cAF9882d3160602AaC1769C2B264A2d8EC044
+  8453: {
+    pointToken: "0x7d25E7156E51F865D522fd3ef257a6B5DD41b97e",
+    batchExecutor: "0xe6Cae83BdE06E4c305530e199D7217f42808555B",
+    usdt: "0x5d313485Ba59C3bb91e1A9C0C11782F0b83d5dcd",
+    issuerRegistry: "0xda2D3338CF70F462Ac175F5f2edfa45660CA4f31",
+    mintingOracle: "0xD85165939C700E51c8a45099316C6482634C2Ab9",
+    pafiHook: "0x870cAF9882d3160602AaC1769C2B264A2d8EC044",
+    chainlinkEthUsd: "0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70",
+    orderlyRelay: "0xDA082DAce1522c185aeB5A713FcA6fa6B6E99e7f",
+    pafiFeeRecipient: "0xa3F71eadEd101513a0151007590020dCFD7C495e",
+    universalRouter: "0x6fF5693b99212Da76ad316178A184AB56D299b43"
+  },
+  // Base Sepolia — not in active use; placeholders kept so the map
+  // compiles for tooling that enumerates chains.
+  84532: {
+    pointToken: PLACEHOLDER_DEAD("dead"),
+    batchExecutor: PLACEHOLDER_DEAD("de01"),
+    usdt: PLACEHOLDER_DEAD("dead"),
+    issuerRegistry: PLACEHOLDER_DEAD("dead"),
+    mintingOracle: PLACEHOLDER_DEAD("dead"),
+    pafiHook: PLACEHOLDER_DEAD("dead"),
+    chainlinkEthUsd: PLACEHOLDER_DEAD("de02"),
+    orderlyRelay: PLACEHOLDER_DEAD("de03"),
+    pafiFeeRecipient: PLACEHOLDER_DEAD("de04"),
+    universalRouter: PLACEHOLDER_DEAD("de05")
+  }
+};
+var POINT_TOKEN_FACTORY_ADDRESSES = {
+  8453: "0x36c0BAb2faBE45EfA6d13001143e43A266Af673B",
+  84532: PLACEHOLDER_DEAD("dead")
+};
+var POINT_TOKEN_IMPL_ADDRESSES = {
+  8453: "0x2e6FB1B0C1A51abb83eC974890126a64eC02E995",
+  84532: PLACEHOLDER_DEAD("dead")
+};
+function getContractAddresses(chainId) {
+  const addrs = CONTRACT_ADDRESSES[chainId];
+  if (!addrs) {
+    throw new Error(
+      `getContractAddresses: no addresses for chainId ${chainId}. Supported: ${Object.keys(CONTRACT_ADDRESSES).join(", ")}`
+    );
+  }
+  return addrs;
+}
+
+// src/delegation/delegateDirect.ts
+async function delegateDirect(params) {
+  const target = params.contractAddress ?? getContractAddresses(params.chainId).batchExecutor;
+  if (params.skipIfAlreadyDelegated !== false) {
+    const code = await params.publicClient.getCode({
+      address: params.userAddress
+    });
+    const current = parseEip7702DelegatedAddress(code);
+    if (current && current.toLowerCase() === target.toLowerCase()) {
+      return {
+        status: "already-delegated",
+        delegatedTo: current,
+        authorization: {
+          contractAddress: target,
+          chainId: params.chainId,
+          nonce: 0,
+          r: "0x",
+          s: "0x",
+          yParity: 0
+        }
+      };
+    }
+  }
+  const nonce = await params.publicClient.getTransactionCount({
+    address: params.userAddress,
+    blockTag: "pending"
+  });
+  const raw = await params.signAuthorization({
+    contractAddress: target,
+    chainId: params.chainId,
+    nonce
+  });
+  const yParityRaw = raw.yParity;
+  const yParity = typeof yParityRaw === "number" ? yParityRaw : String(yParityRaw) === "1" || String(yParityRaw) === "0x1" ? 1 : 0;
+  const authorization = {
+    contractAddress: target,
+    chainId: params.chainId,
+    nonce,
+    r: normalizeHex32(raw.r),
+    s: normalizeHex32(raw.s),
+    yParity
+  };
+  const account = params.walletClient.account;
+  if (!account) {
+    throw new Error(
+      "delegateDirect: walletClient has no account attached \u2014 cannot send tx"
+    );
+  }
+  const txHash = await params.walletClient.sendTransaction({
+    account,
+    chain: params.walletClient.chain,
+    to: params.userAddress,
+    value: 0n,
+    data: "0x",
+    authorizationList: [authorization]
+  });
+  const waitForReceipt = params.waitForReceipt !== false;
+  let receipt;
+  if (waitForReceipt) {
+    try {
+      receipt = await params.publicClient.waitForTransactionReceipt({
+        hash: txHash
+      });
+    } catch (err) {
+      params.onWarning?.(
+        `delegateDirect: tx ${txHash} sent but receipt fetch failed: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  }
+  return {
+    status: "sent",
+    txHash,
+    receipt,
+    authorization,
+    delegatedTo: target
+  };
+}
+function normalizeHex32(value) {
+  if (!value) return "0x";
+  const stripped = value.replace(/^0x/i, "");
+  return "0x" + stripped.padStart(64, "0");
+}
+
 // src/transport/proxyTransport.ts
 import { http } from "viem";
 function createPafiProxyTransport(params) {
@@ -863,72 +1012,6 @@ async function fetchPafiPools(_chainId, pointTokenAddress, subgraphUrl = PAFI_SU
   }];
 }
 
-// src/contracts/real/addresses.ts
-var PLACEHOLDER_DEAD = (suffix) => `0x000000000000000000000000000000000000${suffix.toLowerCase().padStart(4, "0")}`;
-var CONTRACT_ADDRESSES = {
-  // Base mainnet — SC-delivered (2026-04-21, 2026-04-22)
-  // registry:       IssuerRegistry       0xda2D3338CF70F462Ac175F5f2edfa45660CA4f31
-  // factory:        PointTokenFactory    0x36c0BAb2faBE45EfA6d13001143e43A266Af673B
-  // oracle:         MintingOracle        0xD85165939C700E51c8a45099316C6482634C2Ab9
-  // tokenImpl:      PointToken (impl)    0x2e6FB1B0C1A51abb83eC974890126a64eC02E995
-  // mockUsdt:       MockERC20            0x5d313485Ba59C3bb91e1A9C0C11782F0b83d5dcd
-  // POINT:          PointToken instance  0x7d25E7156E51F865D522fd3ef257a6B5DD41b97e
-  // batchExecutor:  Pimlico Simple7702   0xe6Cae83BdE06E4c305530e199D7217f42808555B
-  //                  (v0.7.6 — switched from Coinbase SW v2
-  //                  `0x7702cb...7176C`; CSW v2 uses SignatureWrapper
-  //                  format that Pimlico's `pm_sponsorUserOperation`
-  //                  cannot produce a working dummy sig for, leading
-  //                  to AA23 `0x3c10b94e` reverts on the simulator.
-  //                  Pimlico's `Simple7702Account` accepts standard
-  //                  v0.7 ECDSA dummy and matches what the web FE +
-  //                  permissionless `to7702SimpleSmartAccount` already
-  //                  used in production.)
-  // pafiHook:       PAFIHook (V4, 10%)   0x870cAF9882d3160602AaC1769C2B264A2d8EC044
-  8453: {
-    pointToken: "0x7d25E7156E51F865D522fd3ef257a6B5DD41b97e",
-    batchExecutor: "0xe6Cae83BdE06E4c305530e199D7217f42808555B",
-    usdt: "0x5d313485Ba59C3bb91e1A9C0C11782F0b83d5dcd",
-    issuerRegistry: "0xda2D3338CF70F462Ac175F5f2edfa45660CA4f31",
-    mintingOracle: "0xD85165939C700E51c8a45099316C6482634C2Ab9",
-    pafiHook: "0x870cAF9882d3160602AaC1769C2B264A2d8EC044",
-    chainlinkEthUsd: "0x71041dddad3595F9CEd3DcCFBe3D1F4b0a16Bb70",
-    orderlyRelay: "0xDA082DAce1522c185aeB5A713FcA6fa6B6E99e7f",
-    pafiFeeRecipient: "0xa3F71eadEd101513a0151007590020dCFD7C495e",
-    universalRouter: "0x6fF5693b99212Da76ad316178A184AB56D299b43"
-  },
-  // Base Sepolia — not in active use; placeholders kept so the map
-  // compiles for tooling that enumerates chains.
-  84532: {
-    pointToken: PLACEHOLDER_DEAD("dead"),
-    batchExecutor: PLACEHOLDER_DEAD("de01"),
-    usdt: PLACEHOLDER_DEAD("dead"),
-    issuerRegistry: PLACEHOLDER_DEAD("dead"),
-    mintingOracle: PLACEHOLDER_DEAD("dead"),
-    pafiHook: PLACEHOLDER_DEAD("dead"),
-    chainlinkEthUsd: PLACEHOLDER_DEAD("de02"),
-    orderlyRelay: PLACEHOLDER_DEAD("de03"),
-    pafiFeeRecipient: PLACEHOLDER_DEAD("de04"),
-    universalRouter: PLACEHOLDER_DEAD("de05")
-  }
-};
-var POINT_TOKEN_FACTORY_ADDRESSES = {
-  8453: "0x36c0BAb2faBE45EfA6d13001143e43A266Af673B",
-  84532: PLACEHOLDER_DEAD("dead")
-};
-var POINT_TOKEN_IMPL_ADDRESSES = {
-  8453: "0x2e6FB1B0C1A51abb83eC974890126a64eC02E995",
-  84532: PLACEHOLDER_DEAD("dead")
-};
-function getContractAddresses(chainId) {
-  const addrs = CONTRACT_ADDRESSES[chainId];
-  if (!addrs) {
-    throw new Error(
-      `getContractAddresses: no addresses for chainId ${chainId}. Supported: ${Object.keys(CONTRACT_ADDRESSES).join(", ")}`
-    );
-  }
-  return addrs;
-}
-
 // src/fee/operatorFeeQuoter.ts
 var CHAINLINK_ABI = parseAbi3([
   "function latestRoundData() external view returns (uint80, int256, uint256, uint256, uint80)"
@@ -1433,6 +1516,7 @@ export {
   createLoginMessage,
   createPafiProxyTransport,
   decodeBatchExecuteCalls,
+  delegateDirect,
   detectDelegateImpl,
   encodeBatchExecute,
   erc20Abi,