@pafi-dev/core 0.20.1 → 0.23.0

package/dist/index.d.cts

@@ -1499,6 +1499,87 @@ interface DelegateDirectResult {
  */
 declare function delegateDirect(params: DelegateDirectParams): Promise<DelegateDirectResult>;
 
+interface AttachDelegationIfNeededParams {
+    /**
+     * Public client connected to the chain on which the delegation lives.
+     * The helper uses it to (1) read on-chain code via `eth_getCode` and
+     * (2) read the EOA's tx nonce — both reads must hit the SAME chain
+     * that `chainId` declares, otherwise Pimlico's bundler will reject the
+     * authorization with a chain-mismatch error.
+     */
+    rpc: PublicClient;
+    /**
+     * The user's EOA — the wallet that will become a temporary smart account
+     * via EIP-7702 SetCode. MUST match the `sender` of the UserOp the caller
+     * is about to submit; otherwise the bundler's recovered-signer check
+     * fails ("recovered signer does not match userOperation sender").
+     */
+    account: Address;
+    /**
+     * The implementation address the EOA should delegate to — typically the
+     * Pimlico Simple7702Account / BatchExecutor on the target chain (Base
+     * mainnet: `0xe6Cae83BdE06E4c305530e199D7217f42808555B`).
+     *
+     * The helper compares the on-chain code at `account` against this address.
+     * Mismatch → sign a new authorization to switch the delegate. Match →
+     * return `undefined` (caller passes nothing — extra auth would be wasted
+     * gas + the bundler may reject redundant authorizations).
+     */
+    expectedDelegate: Address;
+    /**
+     * Chain id baked into the EIP-7702 authorization tuple. Must equal the
+     * chain `rpc` connects to.
+     */
+    chainId: number;
+    /**
+     * Privy-shaped authorization signer. Pass `useSign7702Authorization().signAuthorization`
+     * directly on web, or the Expo SDK's equivalent on mobile.
+     *
+     * The helper feeds it `(contractAddress, chainId, nonce)` — the signer
+     * MUST sign with the same private key that controls `account`, otherwise
+     * the recovered signer mismatch above triggers.
+     */
+    signAuthorization: SignAuthorizationFn;
+}
+/**
+ * Sign an EIP-7702 authorization for `account` ONLY when the EOA does not
+ * already delegate to `expectedDelegate`. Returns the authorization in the
+ * shape that permissionless / viem expect on
+ * `smartClient.sendTransaction({ authorization, ... })`. Pimlico bundles
+ * the SetCode + UserOp execution into a SINGLE bundler tx — "atomic
+ * activation" — so the user never sees a separate "delegate" step on their
+ * first action.
+ *
+ * Returns `undefined` when the EOA already points at `expectedDelegate`.
+ * Caller spreads the return value into the tx params:
+ *
+ * ```ts
+ * const authPart = await attachDelegationIfNeeded({ ... });
+ * await smartClient.sendTransaction({
+ *   to: pointToken,
+ *   data: encodeMintCalldata(amount),
+ *   ...(authPart ?? {}),  // attaches { authorization: ... } only when needed
+ * });
+ * ```
+ *
+ * Cost: 1 `eth_getCode` read every time + 1 `eth_getTransactionCount` +
+ * 1 signature (only the first time per EOA). Subsequent calls collapse to
+ * a single RPC read and return `undefined` — cheap to call before every
+ * UserOp.
+ *
+ * Implementation notes:
+ *   - Comparison is case-insensitive (`isDelegatedTo` lowercases both
+ *     sides) so passing checksum-cased addresses is safe.
+ *   - Nonce is fetched freshly per call to avoid replaying an old nonce
+ *     when the FE held the helper params across multiple actions.
+ *   - The signed tuple is passed through `buildEip7702Authorization` to
+ *     normalise `r` / `s` / `yParity` into the wire shape Pimlico accepts
+ *     (handles Privy's bigint `v` and string-hex `yParity` variants).
+ */
+declare function attachDelegationIfNeeded(params: AttachDelegationIfNeededParams): Promise<{
+    authorization: Eip7702AuthorizationJsonRpc;
+} | undefined>;
+
 /**
  * Parameters for `createPafiProxyTransport`.
  */
@@ -2650,7 +2731,21 @@ declare function openPafiWebModal(url: string, options?: ModalOpenOptions): Prom
  * MintFeeWrapper. Schema entities: `MintFeeWrapper`, `MintFeeConfig`,
  * `FeeRecipient`, `MintWithFeeEvent`, `FeeDistribution`.
  */
-declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v4";
+/**
+ * Default subgraph endpoint. Points at `pafi-subgraph-v1` — the deployment
+ * that indexes the V2 contract bucket (IssuerRegistry 0x3e8264…,
+ * PointTokenFactory 0x34f9F8…, TokenRegistry 0x7092b3…, MintingOracle
+ * 0x19F5Ea…, MintFeeWrapper 0x72B8FB…). Despite the "v1" name in the URL
+ * this is the freshest subgraph — naming is a deploy-order artifact, not
+ * a contract-version indicator.
+ *
+ * Previous deployments (`pafi-subgraph-v4`, `v5`) tracked the v1.6
+ * contract bucket and have been retired alongside the v2 cutover.
+ *
+ * Override per-call via `subgraphUrl` parameter when you need to point at
+ * a fork or a private graph node for staging.
+ */
+declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v1";
 /**
  * Fetch the Uniswap V3 pool(s) for a PAFI PointToken from the subgraph.
  *
@@ -2731,4 +2826,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 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_ABI, POINT_TOKEN_BEACON_ADDRESSES, POINT_TOKEN_BURN_SIG_ABI, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_MINT_SIG_ABI, 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, VAULT_BEACON_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 };
+export { ApiError, type AttachDelegationIfNeededParams, 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_ABI, POINT_TOKEN_BEACON_ADDRESSES, POINT_TOKEN_BURN_SIG_ABI, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_MINT_SIG_ABI, 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, VAULT_BEACON_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, attachDelegationIfNeeded, 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

@@ -1499,6 +1499,87 @@ interface DelegateDirectResult {
  */
 declare function delegateDirect(params: DelegateDirectParams): Promise<DelegateDirectResult>;
 
+interface AttachDelegationIfNeededParams {
+    /**
+     * Public client connected to the chain on which the delegation lives.
+     * The helper uses it to (1) read on-chain code via `eth_getCode` and
+     * (2) read the EOA's tx nonce — both reads must hit the SAME chain
+     * that `chainId` declares, otherwise Pimlico's bundler will reject the
+     * authorization with a chain-mismatch error.
+     */
+    rpc: PublicClient;
+    /**
+     * The user's EOA — the wallet that will become a temporary smart account
+     * via EIP-7702 SetCode. MUST match the `sender` of the UserOp the caller
+     * is about to submit; otherwise the bundler's recovered-signer check
+     * fails ("recovered signer does not match userOperation sender").
+     */
+    account: Address;
+    /**
+     * The implementation address the EOA should delegate to — typically the
+     * Pimlico Simple7702Account / BatchExecutor on the target chain (Base
+     * mainnet: `0xe6Cae83BdE06E4c305530e199D7217f42808555B`).
+     *
+     * The helper compares the on-chain code at `account` against this address.
+     * Mismatch → sign a new authorization to switch the delegate. Match →
+     * return `undefined` (caller passes nothing — extra auth would be wasted
+     * gas + the bundler may reject redundant authorizations).
+     */
+    expectedDelegate: Address;
+    /**
+     * Chain id baked into the EIP-7702 authorization tuple. Must equal the
+     * chain `rpc` connects to.
+     */
+    chainId: number;
+    /**
+     * Privy-shaped authorization signer. Pass `useSign7702Authorization().signAuthorization`
+     * directly on web, or the Expo SDK's equivalent on mobile.
+     *
+     * The helper feeds it `(contractAddress, chainId, nonce)` — the signer
+     * MUST sign with the same private key that controls `account`, otherwise
+     * the recovered signer mismatch above triggers.
+     */
+    signAuthorization: SignAuthorizationFn;
+}
+/**
+ * Sign an EIP-7702 authorization for `account` ONLY when the EOA does not
+ * already delegate to `expectedDelegate`. Returns the authorization in the
+ * shape that permissionless / viem expect on
+ * `smartClient.sendTransaction({ authorization, ... })`. Pimlico bundles
+ * the SetCode + UserOp execution into a SINGLE bundler tx — "atomic
+ * activation" — so the user never sees a separate "delegate" step on their
+ * first action.
+ *
+ * Returns `undefined` when the EOA already points at `expectedDelegate`.
+ * Caller spreads the return value into the tx params:
+ *
+ * ```ts
+ * const authPart = await attachDelegationIfNeeded({ ... });
+ * await smartClient.sendTransaction({
+ *   to: pointToken,
+ *   data: encodeMintCalldata(amount),
+ *   ...(authPart ?? {}),  // attaches { authorization: ... } only when needed
+ * });
+ * ```
+ *
+ * Cost: 1 `eth_getCode` read every time + 1 `eth_getTransactionCount` +
+ * 1 signature (only the first time per EOA). Subsequent calls collapse to
+ * a single RPC read and return `undefined` — cheap to call before every
+ * UserOp.
+ *
+ * Implementation notes:
+ *   - Comparison is case-insensitive (`isDelegatedTo` lowercases both
+ *     sides) so passing checksum-cased addresses is safe.
+ *   - Nonce is fetched freshly per call to avoid replaying an old nonce
+ *     when the FE held the helper params across multiple actions.
+ *   - The signed tuple is passed through `buildEip7702Authorization` to
+ *     normalise `r` / `s` / `yParity` into the wire shape Pimlico accepts
+ *     (handles Privy's bigint `v` and string-hex `yParity` variants).
+ */
+declare function attachDelegationIfNeeded(params: AttachDelegationIfNeededParams): Promise<{
+    authorization: Eip7702AuthorizationJsonRpc;
+} | undefined>;
+
 /**
  * Parameters for `createPafiProxyTransport`.
  */
@@ -2650,7 +2731,21 @@ declare function openPafiWebModal(url: string, options?: ModalOpenOptions): Prom
  * MintFeeWrapper. Schema entities: `MintFeeWrapper`, `MintFeeConfig`,
  * `FeeRecipient`, `MintWithFeeEvent`, `FeeDistribution`.
  */
-declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v4";
+/**
+ * Default subgraph endpoint. Points at `pafi-subgraph-v1` — the deployment
+ * that indexes the V2 contract bucket (IssuerRegistry 0x3e8264…,
+ * PointTokenFactory 0x34f9F8…, TokenRegistry 0x7092b3…, MintingOracle
+ * 0x19F5Ea…, MintFeeWrapper 0x72B8FB…). Despite the "v1" name in the URL
+ * this is the freshest subgraph — naming is a deploy-order artifact, not
+ * a contract-version indicator.
+ *
+ * Previous deployments (`pafi-subgraph-v4`, `v5`) tracked the v1.6
+ * contract bucket and have been retired alongside the v2 cutover.
+ *
+ * Override per-call via `subgraphUrl` parameter when you need to point at
+ * a fork or a private graph node for staging.
+ */
+declare const PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v1";
 /**
  * Fetch the Uniswap V3 pool(s) for a PAFI PointToken from the subgraph.
  *
@@ -2731,4 +2826,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 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_ABI, POINT_TOKEN_BEACON_ADDRESSES, POINT_TOKEN_BURN_SIG_ABI, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_MINT_SIG_ABI, 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, VAULT_BEACON_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 };
+export { ApiError, type AttachDelegationIfNeededParams, 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_ABI, POINT_TOKEN_BEACON_ADDRESSES, POINT_TOKEN_BURN_SIG_ABI, POINT_TOKEN_FACTORY_ADDRESSES, POINT_TOKEN_IMPL_ADDRESSES, POINT_TOKEN_MINT_SIG_ABI, 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, VAULT_BEACON_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, attachDelegationIfNeeded, 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

@@ -900,11 +900,23 @@ var CONTRACT_ADDRESSES = {
     // top-level export.
     permit2: "0xEB450d21ae68D3303Cf5775A54Cc84EE7c3fC8eC",
     // ── Stablecoins ───────────────────────────────────────────────
-    // USDT inherited from v1.6 (MockUSDT — no new V2 USDT deploy).
-    usdt: "0x3F7e71B150e97316Bb9f363A32c19CcD36ac2382",
-    // V2 USDC — PAFI ecosystem USDC (custom deploy, NOT canonical Base
-    // USDC `0x833589fC...`). Paired with the USDC/USD Chainlink feed below.
-    usdc: "0xf0Fa9eB05fd3a373d3c54775Ff0ed55Dc9cc2D3E",
+    // Canonical Base stables — the PT pools team deploys against these
+    // (verified on-chain: pool `0xB135E06E…` LTR/USDC and `0x6348D133…`
+    // JLB/USDC both list `token = 0x833589fC…` = canonical USDC). The
+    // earlier PAFI custom-deploy USDT/USDC (MockUSDT `0x3F7e71…` +
+    // PAFI V2 USDC `0xf0Fa9eB0…`) were unused by production pools and
+    // caused sponsor-relayer's `isStableFeeToken` to fall through to
+    // the PT quoter, producing 1e12× INSUFFICIENT_FEE rejects on every
+    // swap. See addresses.ts history before 2026-06-16 if archeology
+    // is needed.
+    //
+    // Canonical Tether USDT on Base (Tether's official native deploy,
+    // symbol="USDT", name="Tether USD", 6 decimals).
+    usdt: "0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2",
+    // Canonical Circle USDC on Base (Coinbase official deploy,
+    // symbol="USDC", 6 decimals). Paired with the USDC/USD Chainlink
+    // feed below.
+    usdc: "0x833589fCD6EDb6E08f4c7C32D4f71b54bdA02913",
     chainlinkUsdcUsd: "0xEE86BfD4E2B3A1e71a1b45f750791D67e735e4a7",
     // ── V2 core registries (replaces v1.6) ────────────────────────
     issuerRegistry: "0x3e82647b0f716f80e65d311354E2C4F0DcFd6997",
@@ -1048,6 +1060,46 @@ function normalizeHex32(value) {
   return "0x" + stripped.padStart(64, "0");
 }
 
+// src/delegation/attachDelegationIfNeeded.ts
+var inFlight = /* @__PURE__ */ new Map();
+function cacheKey(chainId, account) {
+  return `${chainId}:${account.toLowerCase()}`;
+}
+async function attachDelegationIfNeeded(params) {
+  const key = cacheKey(params.chainId, params.account);
+  const existing = inFlight.get(key);
+  if (existing) return existing;
+  const promise = doAttach(params).finally(() => {
+    inFlight.delete(key);
+  });
+  inFlight.set(key, promise);
+  return promise;
+}
+async function doAttach(params) {
+  const { rpc, account, expectedDelegate, chainId, signAuthorization } = params;
+  if (await isDelegatedTo(rpc, account, expectedDelegate)) {
+    return void 0;
+  }
+  const nonce = await rpc.getTransactionCount({ address: account });
+  const rawAuth = await signAuthorization({
+    contractAddress: expectedDelegate,
+    chainId,
+    nonce
+  });
+  const authorization = {
+    chainId: toHexQuantity(rawAuth.chainId),
+    address: rawAuth.contractAddress ?? rawAuth.address ?? expectedDelegate,
+    nonce: toHexQuantity(BigInt(rawAuth.nonce)),
+    r: rawAuth.r,
+    s: rawAuth.s,
+    yParity: typeof rawAuth.yParity === "string" ? rawAuth.yParity.startsWith("0x") ? rawAuth.yParity : `0x${rawAuth.yParity}` : `0x${rawAuth.yParity}`
+  };
+  return { authorization };
+}
+function toHexQuantity(n) {
+  return `0x${BigInt(n).toString(16)}`;
+}
+
 // src/transport/proxyTransport.ts
 import { http } from "viem";
 function createPafiProxyTransport(params) {
@@ -1107,7 +1159,7 @@ import { parseAbi as parseAbi3 } from "viem";
 
 // src/subgraph/pools.ts
 import { isAddress } from "viem";
-var PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v4";
+var PAFI_SUBGRAPH_URL = "https://graph-base-mainnet.pacificfinance.org/subgraphs/name/pafi-subgraph-v1";
 var POOL_QUERY = `
   query GetPoolForPointToken($id: ID!) {
     pafiToken(id: $id) {
@@ -1796,6 +1848,7 @@ export {
   ZERO_VALUE,
   assembleUserOperation,
   assertDomainMatchesContract,
+  attachDelegationIfNeeded,
   buildAndSignSponsorAuth,
   buildBurnRequestTypedData,
   buildDelegationUserOp,