@pafi-dev/core 0.25.1 → 0.25.2

package/dist/index.d.cts

@@ -104,6 +104,11 @@ declare const V3_FACTORY_ADDRESSES: Record<number, Address>;
  * Pool-init code hash for PAFI's V3 deployment. Combined with the factory
  * address + sorted tokens + fee, deterministically yields a pool's
  * address via the standard Uniswap V3 CREATE2 derivation.
+ *
+ * ⚠️ MULTI-CHAIN: this is a SINGLE Base value. The Arbitrum PAFI fork hash
+ * is identical ONLY if the pool bytecode matches — confirm with the SC team.
+ * When Arbitrum goes live, promote this to `Record<number, Hex>` (like the
+ * factory map above). See docs/ARBITRUM_ADDRESSES.md.
  */
 declare const V3_POOL_INIT_CODE_HASH: Hex;
 declare const COMMON_TOKENS: Record<number, Record<string, Address>>;
@@ -124,9 +129,16 @@ declare const ENTRY_POINT_V07: Address;
  * see `AA23 reverted account: not from EntryPoint`.
  */
 declare const ENTRY_POINT_V08: Address;
-/** Permit2 — Uniswap's universal approval contract, same address on all EVM chains. */
+/** Permit2 — Uniswap's canonical instance, same address on all EVM chains. */
 /**
- * Permit2 — PAFI's deployed instance. PAFI ships its own forked deployment.
+ * Permit2 — PAFI's deployed FORK instance (Base). PAFI ships its own forked
+ * deployment paired with the fork UniversalRouter.
+ *
+ * ⚠️ MULTI-CHAIN: this is a SINGLE Base value; the Arbitrum fork Permit2 is a
+ * separate PAFI deploy (TBD — SC team). The per-chain `permit2` field already
+ * exists on `CONTRACT_ADDRESSES`; when Arbitrum goes live, migrate callers to
+ * `getContractAddresses(chainId).permit2` and retire this single const (or
+ * make it `Record<number, Address>`). See docs/ARBITRUM_ADDRESSES.md.
  */
 declare const PERMIT2_ADDRESS: Address;
 
@@ -719,6 +731,72 @@ interface BuildPerpDepositViaRelayParams {
  */
 declare function buildPerpDepositViaRelay(params: BuildPerpDepositViaRelayParams): PartialUserOperation;
 
+declare const ASTER_DEPOSIT_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "deposit";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "broker";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}];
+/** 4-byte selector of the assumed `deposit(address,uint256,uint256)`. Kept as
+ *  a derived constant so it updates automatically when the ABI is corrected. */
+declare const ASTER_DEPOSIT_SELECTOR: Hex;
+/**
+ * PAFI's registered Aster broker id per chain (referral attribution — PAFI
+ * earns broker fees the way it does on Orderly). `0n` = no broker / not yet
+ * registered. TBD: replace with PAFI's real Aster broker id once assigned.
+ */
+declare const ASTER_BROKER_IDS: Record<number, bigint>;
+declare function getAsterBrokerId(chainId: number): bigint;
+interface BuildAsterDepositParams {
+    /** User EOA (msg.sender via EIP-7702 delegation — also the Aster account). */
+    userAddress: Address;
+    /** ERC-4337 account nonce. */
+    aaNonce: bigint;
+    /** Aster Deposit Bridge — `getContractAddresses(chainId).asterDepositBridge`. */
+    bridgeAddress: Address;
+    /** Deposit token — Arbitrum USDT (`getContractAddresses(chainId).usdt`). */
+    token: Address;
+    /** Raw deposit amount (token decimals — USDT is 6). Credited to the user. */
+    amount: bigint;
+    /** PAFI Aster broker id (referral) — `getAsterBrokerId(chainId)`. */
+    broker: bigint;
+    /**
+     * Optional gas-fee transfer prepended to the batch (PAFI gas reimbursement,
+     * sponsored path). Same input-token as the deposit (USDT), so the user needs
+     * no second token. Set both together; omit for the fee-free fallback where
+     * the user pays ERC-4337 gas in ETH. Fee runs FIRST (user holds USDT before
+     * the deposit) — the token-availability rule, same as `buildPerpDepositViaRelay`.
+     */
+    gasFee?: bigint;
+    gasFeeRecipient?: Address;
+    gasLimits?: {
+        callGasLimit?: bigint;
+        verificationGasLimit?: bigint;
+        preVerificationGas?: bigint;
+    };
+}
+/**
+ * Build a UserOp for an Aster perp deposit (same-chain on Arbitrum).
+ *
+ * Sponsored: `[USDT.transfer(feeRecipient, gasFee), USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+ * Fallback:  `[                                     USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+ *
+ * No `msg.value`, no Relay indirection (unlike Orderly) — Aster is same-chain,
+ * so the user's own delegated account is the depositor and the beneficiary.
+ * Net deposit to Aster = `amount` (the gasFee is a separate PAFI reimbursement).
+ */
+declare function buildAsterDeposit(params: BuildAsterDepositParams): PartialUserOperation;
+
 /**
  * Builder for the `erc20-transfer` sponsored scenario.
  *
@@ -1043,7 +1121,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" | "erc20-transfer";
+type SponsorshipScenario = "mint" | "burn" | "swap" | "perp-deposit" | "aster-deposit" | "delegate" | "erc20-transfer";
 
 /**
  * Submission path chosen by `checkEthAndBranch`.
@@ -1628,7 +1706,7 @@ declare function sendWithPaymasterFallback(params: SendWithPaymasterFallbackPara
  *
  * Pass an explicit `gasUnits` to override.
  */
-type FeeScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate" | "erc20-transfer";
+type FeeScenario = "mint" | "burn" | "swap" | "perp-deposit" | "aster-deposit" | "delegate" | "erc20-transfer";
 declare const SCENARIO_GAS_UNITS: Record<FeeScenario, bigint>;
 interface QuoteOperatorFeePtConfig {
     provider: PublicClient;
@@ -2324,6 +2402,14 @@ interface ContractAddresses {
      * consumers can resolve the full registry set from one address.
      */
     pointModuleCore: Address;
+    /**
+     * Aster "Deposit Bridge" — the on-chain contract users deposit USDT into
+     * to fund their Aster perp account (same-chain on Arbitrum). Optional
+     * because it only exists on chains where Aster is deployed (Arbitrum);
+     * undefined on Base. Target-pinned by sponsor-relayer's `aster-deposit`
+     * scenario. See `buildAsterDeposit`.
+     */
+    asterDepositBridge?: Address;
 }
 declare const CONTRACT_ADDRESSES: Record<number, ContractAddresses>;
 /**
@@ -2743,4 +2829,4 @@ declare class PafiSDK {
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, type AttachDelegationIfNeededParams, BROKER_HASHES, 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, KERNEL_ADDRESS_BASE_MAINNET, KERNEL_ADDRESS_BASE_SEPOLIA, KERNEL_EXECUTE_ABI, KERNEL_EXECUTE_SELECTOR, KERNEL_EXECUTE_USEROP_SELECTOR, KERNEL_V3_3_IMPL, 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 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, 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 UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, VAULT_BEACON_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, attachDelegationIfNeeded, buildEip7702Authorization, buildErc20TransferUserOp, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeKernelExecute, decodeKernelExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeKernelExecute, 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 { ASTER_BROKER_IDS, ASTER_DEPOSIT_ABI, ASTER_DEPOSIT_SELECTOR, ApiError, type AttachDelegationIfNeededParams, BROKER_HASHES, type BuildAsterDepositParams, 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, KERNEL_ADDRESS_BASE_MAINNET, KERNEL_ADDRESS_BASE_SEPOLIA, KERNEL_EXECUTE_ABI, KERNEL_EXECUTE_SELECTOR, KERNEL_EXECUTE_USEROP_SELECTOR, KERNEL_V3_3_IMPL, 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 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, 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 UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, VAULT_BEACON_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, attachDelegationIfNeeded, buildAsterDeposit, buildEip7702Authorization, buildErc20TransferUserOp, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeKernelExecute, decodeKernelExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeKernelExecute, encodeV3Path, encodeV3PathReversed, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getAsterBrokerId, 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

@@ -104,6 +104,11 @@ declare const V3_FACTORY_ADDRESSES: Record<number, Address>;
  * Pool-init code hash for PAFI's V3 deployment. Combined with the factory
  * address + sorted tokens + fee, deterministically yields a pool's
  * address via the standard Uniswap V3 CREATE2 derivation.
+ *
+ * ⚠️ MULTI-CHAIN: this is a SINGLE Base value. The Arbitrum PAFI fork hash
+ * is identical ONLY if the pool bytecode matches — confirm with the SC team.
+ * When Arbitrum goes live, promote this to `Record<number, Hex>` (like the
+ * factory map above). See docs/ARBITRUM_ADDRESSES.md.
  */
 declare const V3_POOL_INIT_CODE_HASH: Hex;
 declare const COMMON_TOKENS: Record<number, Record<string, Address>>;
@@ -124,9 +129,16 @@ declare const ENTRY_POINT_V07: Address;
  * see `AA23 reverted account: not from EntryPoint`.
  */
 declare const ENTRY_POINT_V08: Address;
-/** Permit2 — Uniswap's universal approval contract, same address on all EVM chains. */
+/** Permit2 — Uniswap's canonical instance, same address on all EVM chains. */
 /**
- * Permit2 — PAFI's deployed instance. PAFI ships its own forked deployment.
+ * Permit2 — PAFI's deployed FORK instance (Base). PAFI ships its own forked
+ * deployment paired with the fork UniversalRouter.
+ *
+ * ⚠️ MULTI-CHAIN: this is a SINGLE Base value; the Arbitrum fork Permit2 is a
+ * separate PAFI deploy (TBD — SC team). The per-chain `permit2` field already
+ * exists on `CONTRACT_ADDRESSES`; when Arbitrum goes live, migrate callers to
+ * `getContractAddresses(chainId).permit2` and retire this single const (or
+ * make it `Record<number, Address>`). See docs/ARBITRUM_ADDRESSES.md.
  */
 declare const PERMIT2_ADDRESS: Address;
 
@@ -719,6 +731,72 @@ interface BuildPerpDepositViaRelayParams {
  */
 declare function buildPerpDepositViaRelay(params: BuildPerpDepositViaRelayParams): PartialUserOperation;
 
+declare const ASTER_DEPOSIT_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "deposit";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }, {
+        readonly name: "broker";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [];
+}];
+/** 4-byte selector of the assumed `deposit(address,uint256,uint256)`. Kept as
+ *  a derived constant so it updates automatically when the ABI is corrected. */
+declare const ASTER_DEPOSIT_SELECTOR: Hex;
+/**
+ * PAFI's registered Aster broker id per chain (referral attribution — PAFI
+ * earns broker fees the way it does on Orderly). `0n` = no broker / not yet
+ * registered. TBD: replace with PAFI's real Aster broker id once assigned.
+ */
+declare const ASTER_BROKER_IDS: Record<number, bigint>;
+declare function getAsterBrokerId(chainId: number): bigint;
+interface BuildAsterDepositParams {
+    /** User EOA (msg.sender via EIP-7702 delegation — also the Aster account). */
+    userAddress: Address;
+    /** ERC-4337 account nonce. */
+    aaNonce: bigint;
+    /** Aster Deposit Bridge — `getContractAddresses(chainId).asterDepositBridge`. */
+    bridgeAddress: Address;
+    /** Deposit token — Arbitrum USDT (`getContractAddresses(chainId).usdt`). */
+    token: Address;
+    /** Raw deposit amount (token decimals — USDT is 6). Credited to the user. */
+    amount: bigint;
+    /** PAFI Aster broker id (referral) — `getAsterBrokerId(chainId)`. */
+    broker: bigint;
+    /**
+     * Optional gas-fee transfer prepended to the batch (PAFI gas reimbursement,
+     * sponsored path). Same input-token as the deposit (USDT), so the user needs
+     * no second token. Set both together; omit for the fee-free fallback where
+     * the user pays ERC-4337 gas in ETH. Fee runs FIRST (user holds USDT before
+     * the deposit) — the token-availability rule, same as `buildPerpDepositViaRelay`.
+     */
+    gasFee?: bigint;
+    gasFeeRecipient?: Address;
+    gasLimits?: {
+        callGasLimit?: bigint;
+        verificationGasLimit?: bigint;
+        preVerificationGas?: bigint;
+    };
+}
+/**
+ * Build a UserOp for an Aster perp deposit (same-chain on Arbitrum).
+ *
+ * Sponsored: `[USDT.transfer(feeRecipient, gasFee), USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+ * Fallback:  `[                                     USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+ *
+ * No `msg.value`, no Relay indirection (unlike Orderly) — Aster is same-chain,
+ * so the user's own delegated account is the depositor and the beneficiary.
+ * Net deposit to Aster = `amount` (the gasFee is a separate PAFI reimbursement).
+ */
+declare function buildAsterDeposit(params: BuildAsterDepositParams): PartialUserOperation;
+
 /**
  * Builder for the `erc20-transfer` sponsored scenario.
  *
@@ -1043,7 +1121,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" | "erc20-transfer";
+type SponsorshipScenario = "mint" | "burn" | "swap" | "perp-deposit" | "aster-deposit" | "delegate" | "erc20-transfer";
 
 /**
  * Submission path chosen by `checkEthAndBranch`.
@@ -1628,7 +1706,7 @@ declare function sendWithPaymasterFallback(params: SendWithPaymasterFallbackPara
  *
  * Pass an explicit `gasUnits` to override.
  */
-type FeeScenario = "mint" | "burn" | "swap" | "perp-deposit" | "delegate" | "erc20-transfer";
+type FeeScenario = "mint" | "burn" | "swap" | "perp-deposit" | "aster-deposit" | "delegate" | "erc20-transfer";
 declare const SCENARIO_GAS_UNITS: Record<FeeScenario, bigint>;
 interface QuoteOperatorFeePtConfig {
     provider: PublicClient;
@@ -2324,6 +2402,14 @@ interface ContractAddresses {
      * consumers can resolve the full registry set from one address.
      */
     pointModuleCore: Address;
+    /**
+     * Aster "Deposit Bridge" — the on-chain contract users deposit USDT into
+     * to fund their Aster perp account (same-chain on Arbitrum). Optional
+     * because it only exists on chains where Aster is deployed (Arbitrum);
+     * undefined on Base. Target-pinned by sponsor-relayer's `aster-deposit`
+     * scenario. See `buildAsterDeposit`.
+     */
+    asterDepositBridge?: Address;
 }
 declare const CONTRACT_ADDRESSES: Record<number, ContractAddresses>;
 /**
@@ -2743,4 +2829,4 @@ declare class PafiSDK {
     signLoginMessage(message: string): Promise<Hex>;
 }
 
-export { ApiError, type AttachDelegationIfNeededParams, BROKER_HASHES, 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, KERNEL_ADDRESS_BASE_MAINNET, KERNEL_ADDRESS_BASE_SEPOLIA, KERNEL_EXECUTE_ABI, KERNEL_EXECUTE_SELECTOR, KERNEL_EXECUTE_USEROP_SELECTOR, KERNEL_V3_3_IMPL, 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 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, 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 UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, VAULT_BEACON_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, attachDelegationIfNeeded, buildEip7702Authorization, buildErc20TransferUserOp, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeKernelExecute, decodeKernelExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeKernelExecute, 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 { ASTER_BROKER_IDS, ASTER_DEPOSIT_ABI, ASTER_DEPOSIT_SELECTOR, ApiError, type AttachDelegationIfNeededParams, BROKER_HASHES, type BuildAsterDepositParams, 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, KERNEL_ADDRESS_BASE_MAINNET, KERNEL_ADDRESS_BASE_SEPOLIA, KERNEL_EXECUTE_ABI, KERNEL_EXECUTE_SELECTOR, KERNEL_EXECUTE_USEROP_SELECTOR, KERNEL_V3_3_IMPL, 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 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, 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 UserOperation, V3Path, V3_FACTORY_ADDRESSES, V3_POOL_INIT_CODE_HASH, V3_SWAP_ROUTER_ADDRESSES, VAULT_BEACON_ADDRESSES, ValidationError, type VaultDepositFE, ZERO_VALUE, assembleUserOperation, attachDelegationIfNeeded, buildAsterDeposit, buildEip7702Authorization, buildErc20TransferUserOp, buildPartialUserOperation, buildPerpDepositViaRelay, buildPerpDepositWithGasDeduction, burnRequestTypes, checkDelegation, checkEthAndBranch, computeAccountId, computeAuthorizationHash, computeUserOpHash, computeV3PoolAddress, createPafiProxyTransport, decodeKernelExecute, decodeKernelExecuteCalls, defaultErrorTypeForStatus, delegateDirect, detectDelegateImpl, encodeKernelExecute, encodeV3Path, encodeV3PathReversed, erc20ApproveOp, erc20BurnOp, erc20TransferOp, fetchPafiPools, getAaNonce, getAsterBrokerId, getContractAddresses, getDummySignatureFor7702, getPafiServiceUrls, getPafiWebModalAdapter, isDelegatedTo, isDelegatedToTarget, isPaymasterError, mintRequestTypes, openPafiWebModal, openWebPopup, parseEip7702DelegatedAddress, quoteOperatorFeeForTransfer, quoteOperatorFeePt, quoteOperatorFeeUsdt, rawCallOp, sendWithPaymasterFallback, serializeUserOpToJsonRpc, setPafiWebModalAdapter, splitAuthorizationSig, webPopupAdapter };

package/dist/index.js

@@ -1,15 +1,3 @@
-import {
-  erc20Abi,
-  permit2Abi,
-  pointModuleCoreAbi,
-  pointTokenFactoryAbi,
-  settlementVaultAbi,
-  tokenRegistryAbi,
-  universalRouterAbi,
-  v3QuoterV2Abi,
-  vaultFactoryAbi,
-  vaultRegistryAbi
-} from "./chunk-ZQVYWMOG.js";
 import {
   SPONSOR_AUTH_DOMAIN_ANCHOR_BASE_MAINNET,
   SPONSOR_AUTH_DOMAIN_NAME,
@@ -26,6 +14,18 @@ import {
   verifyLoginMessage,
   verifySponsorAuth
 } from "./chunk-NSTUVR2D.js";
+import {
+  erc20Abi,
+  permit2Abi,
+  pointModuleCoreAbi,
+  pointTokenFactoryAbi,
+  settlementVaultAbi,
+  tokenRegistryAbi,
+  universalRouterAbi,
+  v3QuoterV2Abi,
+  vaultFactoryAbi,
+  vaultRegistryAbi
+} from "./chunk-ZQVYWMOG.js";
 import {
   Source,
   computeEquityCap,
@@ -74,7 +74,7 @@ import {
   signMintRequest,
   verifyBurnRequest,
   verifyMintRequest
-} from "./chunk-K4GBOB5V.js";
+} from "./chunk-MOTNU74I.js";
 import {
   pointTokenAbi
 } from "./chunk-5Y7MGN56.js";
@@ -203,7 +203,11 @@ import { encodeFunctionData as encodeFunctionData3 } from "viem";
 import { keccak256, encodePacked, encodeAbiParameters } from "viem";
 var ORDERLY_VAULT_BASE_MAINNET = "0x816f722424B49Cf1275cc86DA9840Fbd5a6167e9";
 var ORDERLY_VAULT_ADDRESSES = {
-  8453: ORDERLY_VAULT_BASE_MAINNET
+  8453: ORDERLY_VAULT_BASE_MAINNET,
+  // Arbitrum One (42161) — Orderly perp path is KEPT on the Arbitrum move.
+  // Orderly's Vault Proxy is deployed at the SAME address on Arbitrum as on
+  // Base (verified on-chain: 2882 bytes at this address on Arbitrum One).
+  42161: "0x816f722424B49Cf1275cc86DA9840Fbd5a6167e9"
 };
 var BROKER_HASHES = {
   /** Default partner broker on Base — most commonly whitelisted. */
@@ -620,6 +624,70 @@ function buildPerpDepositViaRelay(params) {
   });
 }
 
+// src/perp/buildAsterDeposit.ts
+import { encodeFunctionData as encodeFunctionData5, toFunctionSelector } from "viem";
+var ASTER_DEPOSIT_ABI = [
+  {
+    type: "function",
+    name: "deposit",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "token", type: "address" },
+      { name: "amount", type: "uint256" },
+      { name: "broker", type: "uint256" }
+    ],
+    outputs: []
+  }
+];
+var ASTER_DEPOSIT_SELECTOR = toFunctionSelector(
+  ASTER_DEPOSIT_ABI[0]
+);
+var ASTER_BROKER_IDS = {
+  42161: 0n
+  // TBD — PAFI Aster broker id
+};
+function getAsterBrokerId(chainId) {
+  return ASTER_BROKER_IDS[chainId] ?? 0n;
+}
+function buildAsterDeposit(params) {
+  if (params.amount <= 0n) {
+    throw new Error("buildAsterDeposit: amount must be positive");
+  }
+  if (!params.bridgeAddress) {
+    throw new Error("buildAsterDeposit: bridgeAddress required");
+  }
+  const operations = [];
+  if (params.gasFee && params.gasFee > 0n) {
+    if (!params.gasFeeRecipient) {
+      throw new Error(
+        "buildAsterDeposit: gasFeeRecipient required when gasFee > 0"
+      );
+    }
+    operations.push(
+      erc20TransferOp(params.token, params.gasFeeRecipient, params.gasFee)
+    );
+  }
+  operations.push(
+    erc20ApproveOp(params.token, params.bridgeAddress, params.amount)
+  );
+  const depositCallData = encodeFunctionData5({
+    abi: ASTER_DEPOSIT_ABI,
+    functionName: "deposit",
+    args: [params.token, params.amount, params.broker]
+  });
+  operations.push(rawCallOp(params.bridgeAddress, depositCallData));
+  return buildPartialUserOperation({
+    sender: params.userAddress,
+    nonce: params.aaNonce,
+    operations,
+    gasLimits: {
+      callGasLimit: params.gasLimits?.callGasLimit ?? 600000n,
+      verificationGasLimit: params.gasLimits?.verificationGasLimit ?? 150000n,
+      preVerificationGas: params.gasLimits?.preVerificationGas ?? 50000n
+    }
+  });
+}
+
 // src/transfer/buildErc20Transfer.ts
 function buildErc20TransferUserOp(params) {
   if (params.amount <= 0n) {
@@ -896,6 +964,7 @@ function buildEip7702Authorization(params) {
 
 // src/contracts/real/addresses.ts
 var PLACEHOLDER_DEAD = (suffix) => `0x000000000000000000000000000000000000${suffix.toLowerCase().padStart(4, "0")}`;
+var TBD_ARBITRUM = "0x0000000000000000000000000000000000000000";
 var CONTRACT_ADDRESSES = {
   // ──────────────────────────────────────────────────────────────────
   // Base mainnet (8453) — V2 dual-bucket deploy 2026-06-12
@@ -972,27 +1041,72 @@ var CONTRACT_ADDRESSES = {
     vaultRegistry: PLACEHOLDER_DEAD("de08"),
     vaultFactory: PLACEHOLDER_DEAD("de09"),
     pointModuleCore: PLACEHOLDER_DEAD("de0a")
+  },
+  // ──────────────────────────────────────────────────────────────────
+  // Arbitrum One (42161) — PAFI SC (re)deploy target (2026-07-03).
+  // Aster deposit is same-chain here (no bridge). Researched/canonical
+  // fields are FINAL; PAFI-deployed fields are TBD_ARBITRUM until the SC
+  // team sends the Arbitrum addresses. See docs/ARBITRUM_ADDRESSES.md.
+  // ──────────────────────────────────────────────────────────────────
+  42161: {
+    // ── Researched / canonical (FINAL) ────────────────────────────
+    // Kernel v3.3 impl — CREATE2-deterministic, identical on every chain.
+    kernel: "0xd6CEDDe84be40893d153Be9d467CD6aD37875b28",
+    // Arbitrum USDT is now "USDT0" (LayerZero OFT), 6 decimals — also the
+    // token Aster deposits accept on Arbitrum.
+    usdt: "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
+    // Native Circle USDC on Arbitrum, 6 decimals.
+    usdc: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    chainlinkEthUsd: "0x639Fe6ab55C921f74e7fac1ee960C0B6293ba612",
+    chainlinkUsdcUsd: "0x50834F3163758fcC1Df9973b6e91f0F0F0434aD3",
+    // Aster "Deposit Bridge" on Arbitrum (labelled on Arbiscan). Users
+    // deposit USDT here to fund their Aster perp account. FINAL.
+    asterDepositBridge: "0x9E36CB86a159d479cEd94Fa05036f235Ac40E1d5",
+    // ── PAFI-deployed (TBD — awaiting SC team Arbitrum deploy) ─────
+    issuerRegistry: TBD_ARBITRUM,
+    mintingOracle: TBD_ARBITRUM,
+    mintFeeWrapper: TBD_ARBITRUM,
+    tokenRegistry: TBD_ARBITRUM,
+    vaultRegistry: TBD_ARBITRUM,
+    vaultFactory: TBD_ARBITRUM,
+    pointModuleCore: TBD_ARBITRUM,
+    // Only if the Orderly perp path is kept on Arbitrum (else remove).
+    orderlyRelay: TBD_ARBITRUM,
+    // PAFI-controlled fee recipient — confirm whether Base EOA is reused.
+    pafiFeeRecipient: TBD_ARBITRUM,
+    // PAFI V3-fork UniversalRouter + its paired fork Permit2 — NOT the
+    // canonical Arbitrum UR / canonical Permit2 (0x0000…22D473).
+    universalRouter: TBD_ARBITRUM,
+    permit2: TBD_ARBITRUM
   }
 };
 var POINT_TOKEN_FACTORY_ADDRESSES = {
   // V2 dual-bucket factory (2026-06-12). Replaces v1.6 factory
   // `0xA08274458b43E7D6F4ff61ddFe8A9852c6531085`.
   8453: "0x34f9F84841A77A19040686396b8B64522A2da4c8",
-  84532: PLACEHOLDER_DEAD("dead")
+  84532: PLACEHOLDER_DEAD("dead"),
+  42161: TBD_ARBITRUM
+  // Arbitrum PAFI deploy — SC team
 };
 var POINT_TOKEN_IMPL_ADDRESSES = {
   // V2 dual-bucket impl (2026-06-12). Replaces v1.6 impl
   // `0xc41c3F8A0380c7760Ee1209d6d19C4b81dE994e4` (single-bucket).
   8453: "0x067d2d82F7cfbAf9bBA1f493167cC6043eD5d7dd",
-  84532: PLACEHOLDER_DEAD("dead")
+  84532: PLACEHOLDER_DEAD("dead"),
+  42161: TBD_ARBITRUM
+  // Arbitrum PAFI deploy — SC team
 };
 var POINT_TOKEN_BEACON_ADDRESSES = {
   8453: "0xdC479E294FD12658FDC68B9400c2073De291acf3",
-  84532: PLACEHOLDER_DEAD("dead")
+  84532: PLACEHOLDER_DEAD("dead"),
+  42161: TBD_ARBITRUM
+  // Arbitrum PAFI deploy — SC team
 };
 var VAULT_BEACON_ADDRESSES = {
   8453: "0x4E583d64bfcCD86dFf1f68b792D5a1Cd169f22eB",
-  84532: PLACEHOLDER_DEAD("dead")
+  84532: PLACEHOLDER_DEAD("dead"),
+  42161: TBD_ARBITRUM
+  // Arbitrum PAFI deploy — SC team
 };
 function getContractAddresses(chainId) {
   const addrs = CONTRACT_ADDRESSES[chainId];
@@ -1279,6 +1393,9 @@ var SCENARIO_GAS_UNITS = {
   burn: 500000n,
   swap: 700000n,
   "perp-deposit": 800000n,
+  // Aster deposit is same-chain (no Orderly LayerZero msg.value hop) — a
+  // plain [fee, approve, bridge.deposit] batch, so cheaper than perp-deposit.
+  "aster-deposit": 600000n,
   delegate: 200000n,
   // 2-call batch: 1 ERC-20 fee transfer + 1 ERC-20 transfer + 7702
   // delegation overhead. ~70-90k empirical; 200k matches `delegate`
@@ -1548,6 +1665,12 @@ var PAFI_SERVICE_URLS = {
   84532: {
     sponsorRelayer: "https://api-dev.pacificfinance.org/api/sponsor",
     issuerApi: "https://api-dev.pacificfinance.org/api/issuer"
+  },
+  // Arbitrum One — same Kong host, path-routed (chain lives in the ZeroDev
+  // forward URL, not the PAFI service URL). Swap to prod hosts when live.
+  42161: {
+    sponsorRelayer: "https://api-dev.pacificfinance.org/api/sponsor",
+    issuerApi: "https://api-dev.pacificfinance.org/api/issuer"
   }
 };
 function getPafiServiceUrls(chainId, overrides) {
@@ -1831,6 +1954,9 @@ var PafiSDK = class {
   }
 };
 export {
+  ASTER_BROKER_IDS,
+  ASTER_DEPOSIT_ABI,
+  ASTER_DEPOSIT_SELECTOR,
   ApiError,
   BROKER_HASHES,
   COMMON_POOLS,
@@ -1886,6 +2012,7 @@ export {
   assertDomainMatchesContract,
   attachDelegationIfNeeded,
   buildAndSignSponsorAuth,
+  buildAsterDeposit,
   buildBurnRequestTypedData,
   buildDomain,
   buildEip7702Authorization,
@@ -1922,6 +2049,7 @@ export {
   fetchPafiPools,
   generateSponsorAuthNonce,
   getAaNonce,
+  getAsterBrokerId,
   getBurnRequestNonce,
   getContractAddresses,
   getDummySignatureFor7702,