@pafi-dev/trading 0.12.0 → 0.13.0

package/dist/index.d.cts

@@ -350,6 +350,36 @@ interface ApiErc20TransferResponse {
     /** Echo of `tokenAddress` (checksummed). Use as a sanity tag in FE logs. */
     tokenAddress: Address;
 }
+interface ApiAsterDepositRequest {
+    chainId: number;
+    userAddress: Address;
+    /** USDT amount to deposit (6-decimal raw units). Credited to the user's Aster account. */
+    amount: bigint;
+    /** ERC-4337 account nonce for the user's EOA (from EntryPoint). */
+    aaNonce: bigint;
+    /**
+     * USDT operator fee — input-token transfer prepended to the batch
+     * (token-availability rule). `undefined` = auto-quote via
+     * `quoteOperatorFeeUsdt`; `0n` = strip fee (unsponsored); explicit = override.
+     */
+    gasFee?: bigint;
+}
+interface ApiAsterDepositResponse {
+    /** Unsigned sponsored UserOp — [USDT fee, USDT approve, Bridge.deposit]. */
+    userOp: PartialUserOperation;
+    /** Fee-stripped fallback (paymaster-refused path). Present only when `gasFee > 0n`. */
+    userOpFallback?: PartialUserOperation;
+    /** USDT operator fee embedded — echoes auto-quote or override. `0n` if no-fee mode. */
+    feeAmount: bigint;
+    /** Recipient used for the fee transfer (= `pafiFeeRecipient`). */
+    feeRecipient: Address;
+    /** Aster Deposit Bridge target the deposit call is pinned to. */
+    bridgeAddress: Address;
+    /** Deposit token (Arbitrum USDT). */
+    token: Address;
+    /** PAFI Aster broker id used for referral attribution. */
+    broker: bigint;
+}
 
 interface TradingHandlersConfig {
     provider: PublicClient;
@@ -455,6 +485,20 @@ declare class TradingHandlers {
      * sentinel (Relay not deployed for that chain).
      */
     handlePerpDeposit(authenticatedAddress: Address, request: ApiPerpDepositRequest): Promise<ApiPerpDepositResponse>;
+    /**
+     * Build a sponsored Aster deposit UserOp pair (sponsored + fallback).
+     *
+     * Aster is same-chain (Arbitrum), so — unlike Orderly — there is NO Relay,
+     * Vault, broker-hash, or LayerZero msg.value. The user's own delegated
+     * account deposits USDT straight into the Aster Deposit Bridge:
+     *   sponsored: `[USDT.transfer(PAFI, fee), USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+     *   fallback:  `[                          USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+     *
+     * ⚠️ Built against an ASSUMED Aster Deposit Bridge ABI (`ASTER_DEPOSIT_ABI`
+     * in @pafi-dev/core) — Aster has not published it. Confirm the deposit
+     * signature + PAFI's `broker` id before mainnet.
+     */
+    handleAsterDeposit(authenticatedAddress: Address, request: ApiAsterDepositRequest): Promise<ApiAsterDepositResponse>;
     /**
      * Build a sponsored ERC-20 transfer UserOp pair (sponsored + fallback).
      *

package/dist/index.d.ts

@@ -350,6 +350,36 @@ interface ApiErc20TransferResponse {
     /** Echo of `tokenAddress` (checksummed). Use as a sanity tag in FE logs. */
     tokenAddress: Address;
 }
+interface ApiAsterDepositRequest {
+    chainId: number;
+    userAddress: Address;
+    /** USDT amount to deposit (6-decimal raw units). Credited to the user's Aster account. */
+    amount: bigint;
+    /** ERC-4337 account nonce for the user's EOA (from EntryPoint). */
+    aaNonce: bigint;
+    /**
+     * USDT operator fee — input-token transfer prepended to the batch
+     * (token-availability rule). `undefined` = auto-quote via
+     * `quoteOperatorFeeUsdt`; `0n` = strip fee (unsponsored); explicit = override.
+     */
+    gasFee?: bigint;
+}
+interface ApiAsterDepositResponse {
+    /** Unsigned sponsored UserOp — [USDT fee, USDT approve, Bridge.deposit]. */
+    userOp: PartialUserOperation;
+    /** Fee-stripped fallback (paymaster-refused path). Present only when `gasFee > 0n`. */
+    userOpFallback?: PartialUserOperation;
+    /** USDT operator fee embedded — echoes auto-quote or override. `0n` if no-fee mode. */
+    feeAmount: bigint;
+    /** Recipient used for the fee transfer (= `pafiFeeRecipient`). */
+    feeRecipient: Address;
+    /** Aster Deposit Bridge target the deposit call is pinned to. */
+    bridgeAddress: Address;
+    /** Deposit token (Arbitrum USDT). */
+    token: Address;
+    /** PAFI Aster broker id used for referral attribution. */
+    broker: bigint;
+}
 
 interface TradingHandlersConfig {
     provider: PublicClient;
@@ -455,6 +485,20 @@ declare class TradingHandlers {
      * sentinel (Relay not deployed for that chain).
      */
     handlePerpDeposit(authenticatedAddress: Address, request: ApiPerpDepositRequest): Promise<ApiPerpDepositResponse>;
+    /**
+     * Build a sponsored Aster deposit UserOp pair (sponsored + fallback).
+     *
+     * Aster is same-chain (Arbitrum), so — unlike Orderly — there is NO Relay,
+     * Vault, broker-hash, or LayerZero msg.value. The user's own delegated
+     * account deposits USDT straight into the Aster Deposit Bridge:
+     *   sponsored: `[USDT.transfer(PAFI, fee), USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+     *   fallback:  `[                          USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+     *
+     * ⚠️ Built against an ASSUMED Aster Deposit Bridge ABI (`ASTER_DEPOSIT_ABI`
+     * in @pafi-dev/core) — Aster has not published it. Confirm the deposit
+     * signature + PAFI's `broker` id before mainnet.
+     */
+    handleAsterDeposit(authenticatedAddress: Address, request: ApiAsterDepositRequest): Promise<ApiAsterDepositResponse>;
     /**
      * Build a sponsored ERC-20 transfer UserOp pair (sponsored + fallback).
      *

package/dist/index.js

@@ -3,6 +3,8 @@ import { getAddress } from "viem";
 import {
   buildPerpDepositWithGasDeduction,
   buildPerpDepositViaRelay,
+  buildAsterDeposit,
+  getAsterBrokerId,
   buildErc20TransferUserOp,
   ORDERLY_RELAY_ABI,
   getContractAddresses,
@@ -1111,6 +1113,80 @@ var TradingHandlers = class {
     };
   }
   // =========================================================================
+  // POST /aster-deposit  — Aster perp deposit (same-chain on Arbitrum)
+  // =========================================================================
+  /**
+   * Build a sponsored Aster deposit UserOp pair (sponsored + fallback).
+   *
+   * Aster is same-chain (Arbitrum), so — unlike Orderly — there is NO Relay,
+   * Vault, broker-hash, or LayerZero msg.value. The user's own delegated
+   * account deposits USDT straight into the Aster Deposit Bridge:
+   *   sponsored: `[USDT.transfer(PAFI, fee), USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+   *   fallback:  `[                          USDT.approve(bridge, amount), Bridge.deposit(token, amount, broker)]`
+   *
+   * ⚠️ Built against an ASSUMED Aster Deposit Bridge ABI (`ASTER_DEPOSIT_ABI`
+   * in @pafi-dev/core) — Aster has not published it. Confirm the deposit
+   * signature + PAFI's `broker` id before mainnet.
+   */
+  async handleAsterDeposit(authenticatedAddress, request) {
+    const userAddress = getAddress(request.userAddress);
+    if (getAddress(authenticatedAddress) !== userAddress) {
+      throw new ValidationError(
+        "ADDRESS_MISMATCH",
+        `handleAsterDeposit: authenticatedAddress (${authenticatedAddress}) does not match request.userAddress (${request.userAddress})`
+      );
+    }
+    if (request.chainId !== this.chainId) {
+      throw new ValidationError(
+        "CHAIN_MISMATCH",
+        `handleAsterDeposit: unsupported chainId ${request.chainId}`
+      );
+    }
+    if (request.amount <= 0n) {
+      throw new ValidationError(
+        "INVALID_AMOUNT",
+        "handleAsterDeposit: amount must be positive"
+      );
+    }
+    const { asterDepositBridge, usdt, pafiFeeRecipient } = getContractAddresses(
+      request.chainId
+    );
+    if (!asterDepositBridge) {
+      throw new ValidationError(
+        "ASTER_NOT_AVAILABLE",
+        `handleAsterDeposit: Aster is not deployed on chainId ${request.chainId} (no Deposit Bridge)`
+      );
+    }
+    const broker = getAsterBrokerId(request.chainId);
+    const gasFee = request.gasFee !== void 0 ? request.gasFee : await quoteOperatorFeeUsdt({
+      provider: this.provider,
+      chainId: request.chainId
+    }).catch(() => 0n);
+    const common = {
+      userAddress,
+      aaNonce: request.aaNonce,
+      bridgeAddress: asterDepositBridge,
+      token: usdt,
+      amount: request.amount,
+      broker
+    };
+    const userOp = buildAsterDeposit({
+      ...common,
+      gasFee: gasFee > 0n ? gasFee : void 0,
+      gasFeeRecipient: gasFee > 0n ? pafiFeeRecipient : void 0
+    });
+    const userOpFallback = gasFee > 0n ? buildAsterDeposit(common) : void 0;
+    return {
+      userOp,
+      userOpFallback,
+      feeAmount: gasFee > 0n ? gasFee : 0n,
+      feeRecipient: pafiFeeRecipient,
+      bridgeAddress: asterDepositBridge,
+      token: usdt,
+      broker
+    };
+  }
+  // =========================================================================
   // POST /erc20-transfer  — gasless ERC-20 send (USDC/USDT/active-PT)
   // =========================================================================
   /**