@portal-hq/web 3.13.2 → 3.14.0-alpha.0

package/src/shared/types/common.ts

@@ -75,6 +75,7 @@ export interface LegacyTransaction {
 
 export type EthereumTransaction = EIP1559Transaction | LegacyTransaction
 
+// Legacy transaction type (deprecated - use TransactionHistoryItem instead)
 export interface Transaction {
   asset: string
   blockNum: string
@@ -98,6 +99,240 @@ export interface Transaction {
   value: number
 }
 
+/**
+ * Solana error type (can be string, structured object, or null)
+ * Observed from backend: errors can be strings or objects with code/message
+ */
+export type SolanaError =
+  | string
+  | {
+      code?: string | number
+      message?: string
+      data?: unknown
+    }
+  | null
+
+/**
+ * Solana transaction instruction data structure
+ * Backend returns variable shapes depending on program
+ * Extended version with optional parsed fields
+ */
+export interface SolanaTransactionInstruction {
+  accounts: number[]
+  data: string
+  programIdIndex: number
+  stackHeight?: number
+  parsed?: unknown
+  program?: string
+  programId?: string
+}
+
+/**
+ * Token balance type for Solana pre/post balances
+ * Structure varies by token standard (SPL, Token-2022, etc.)
+ */
+export interface SolanaTokenBalance {
+  accountIndex: number
+  mint: string
+  owner?: string
+  programId?: string
+  uiTokenAmount?: {
+    amount: string
+    decimals: number
+    uiAmount: number | null
+    uiAmountString: string
+  }
+}
+
+/**
+ * Inner instruction structure for Solana transactions
+ * Nested program invocations
+ */
+export interface SolanaInnerInstruction {
+  index: number
+  instructions: Array<{
+    accounts: number[]
+    data: string
+    programIdIndex: number
+    parsed?: unknown
+  }>
+}
+
+/**
+ * Solana transaction reward entry
+ */
+export interface SolanaReward {
+  pubkey: string
+  lamports: number
+  postBalance: number
+  rewardType: string | null
+  commission: number | null
+}
+
+/**
+ * Base transaction type shared by both regular and UserOp transactions
+ */
+interface BaseTransactionHistoryItem {
+  hash: string
+  from: string
+  to: string | null
+  value: string
+  blockNumber: string | null
+  blockTimestamp: number | null
+  status: string | null
+  chainId: string
+}
+
+/**
+ * Regular blockchain transaction (EVM, Bitcoin, Tron, Stellar, etc.)
+ * Includes optional token transfer metadata
+ */
+export interface RegularTransaction extends BaseTransactionHistoryItem {
+  type: 'transaction'
+  asset?: string
+  tokenAddress?: string
+  tokenDecimals?: number
+  // UserOp fields must NOT be present
+  userOpHash?: never
+  entryPoint?: never
+  actualGasCost?: never
+  actualGasUsed?: never
+}
+
+/**
+ * ERC-4337 User Operation transaction (EVM only)
+ * Always has to=null and value='0', includes UserOp-specific fields
+ */
+export interface UserOperationTransaction extends BaseTransactionHistoryItem {
+  type: 'userOperation'
+  to: null
+  value: '0'
+  userOpHash: string
+  entryPoint: string
+  actualGasCost?: string
+  actualGasUsed?: string
+  // Token fields must NOT be present
+  asset?: never
+  tokenAddress?: never
+  tokenDecimals?: never
+}
+
+/**
+ * Discriminated union for unified transaction format
+ * Used by EVM, Bitcoin, Tron, Stellar chains
+ */
+export type TransactionHistoryItem = RegularTransaction | UserOperationTransaction
+
+/**
+ * Solana transaction details (legacy format)
+ * Returned only for chains with namespace 'solana:*'
+ * Uses signature-based identification instead of hash
+ */
+export interface SolanaTransactionDetails {
+  blockTime: number
+  error: SolanaError
+  signature: string
+  status: string
+  tokenMint: string | null
+  transactionDetails: {
+    transaction: {
+      message: {
+        accountKeys: string[]
+        header: {
+          numRequiredSignatures: number
+          numReadonlySignedAccounts: number
+          numReadonlyUnsignedAccounts: number
+        }
+        instructions: SolanaTransactionInstruction[]
+        recentBlockhash: string
+      }
+      signatures: string[]
+    } | null
+    signatureDetails: {
+      blockTime: number
+      confirmationStatus: string
+      error: SolanaError
+      memo: string | null
+      signature: string
+      slot: number
+    } | null
+    metadata: {
+      blockTime: number | null
+      slot: number | null
+      error: SolanaError
+      fee: number | null
+      innerInstructions?: SolanaInnerInstruction[] | null
+      loadedAddresses?: {
+        readonly: string[]
+        writable: string[]
+      } | null
+      logMessages: string[] | null
+      postBalances: number[] | null
+      postTokenBalances?: SolanaTokenBalance[] | null
+      preBalances: number[] | null
+      preTokenBalances?: SolanaTokenBalance[] | null
+      rewards?: SolanaReward[] | null
+      status: {
+        Ok?: null | unknown
+        Err?: unknown
+      } | null
+      version: 'legacy' | number | null
+    } | null
+  } | null
+}
+
+/**
+ * Request parameters for fetching transaction history
+ */
+export interface GetTransactionHistoryParams {
+  chainId: string
+  limit?: number
+  offset?: number
+  order?: 'asc' | 'desc'
+  address?: string
+  userOperations?: 'include' | 'only' | 'exclude'
+}
+
+/**
+ * Response metadata (same structure for both Solana and unified formats)
+ */
+export interface GetTransactionHistoryMetadata {
+  address: string
+  chainId: string
+  clientId: string
+  limit: number
+  offset: number
+  count: number
+}
+
+/**
+ * Response for Solana chains (solana:*)
+ */
+export interface SolanaTransactionsResponse {
+  data: {
+    transactions: SolanaTransactionDetails[]
+  }
+  metadata: GetTransactionHistoryMetadata
+}
+
+/**
+ * Response for unified format (EVM, Bitcoin, Tron, Stellar, etc.)
+ */
+export interface UnifiedTransactionsResponse {
+  data: {
+    transactions: TransactionHistoryItem[]
+  }
+  metadata: GetTransactionHistoryMetadata
+}
+
+/**
+ * Polymorphic response type based on chain namespace
+ * Runtime discrimination: check metadata.chainId namespace
+ */
+export type GetTransactionHistoryResponse = 
+  | SolanaTransactionsResponse 
+  | UnifiedTransactionsResponse
+
 // Built transaction types
 export type BuiltTransaction = BuiltEip155Transaction | BuiltSolanaTransaction
 
@@ -117,6 +352,15 @@ export interface BuiltEip155Transaction {
   }
 }
 
+/**
+ * Solana token extension data
+ * Structure varies by extension type (e.g., transfer fee, metadata pointer)
+ */
+export interface SolanaTokenExtension {
+  extension?: string
+  state?: unknown
+}
+
 export interface BuiltSolanaTransaction {
   transaction:
     | string
@@ -133,7 +377,7 @@ export interface BuiltSolanaTransaction {
     tokenMintAddress: string
     tokenDecimals: number
     tokenProgramId: string
-    tokenExtensions: any[]
+    tokenExtensions: SolanaTokenExtension[]
     rawAmount: string
     lastValidBlockHeight: string
     serializedTransactionBase64Encoded: string
@@ -226,26 +470,79 @@ interface AssetMovement {
   rawValue: string
 }
 
+/**
+ * Asset metadata from Blockaid simulation
+ */
+export interface AssetMetadata {
+  type: string
+  decimals: number
+  chainName?: string
+  chainId?: number
+  logoUrl?: string
+  name?: string
+  symbol?: string
+}
+
+/**
+ * Asset differential (inflows/outflows)
+ */
 interface AssetDiff {
-  asset: Record<
-    string,
-    {
-      type: string
-      decimals: number
-      chainName?: string
-      chainId?: number
-      logoUrl?: string
-      name?: string
-      symbol?: string
-    }
-  >
+  asset: Record<string, AssetMetadata>
   in: Record<string, AssetMovement>[]
   out: Record<string, AssetMovement>[]
 }
 
+/**
+ * Extended asset properties from Blockaid
+ * Structure varies by chain and asset type
+ */
+export interface ExtendedAssetProperties {
+  address?: string
+  contractAddress?: string
+  tokenId?: string
+  standard?: string
+  [key: string]: unknown
+}
+
+/**
+ * Account-level summary from simulation
+ */
 interface AccountSummary {
   assetsDiffs: Record<string, AssetDiff>[]
-  [k: string]: any
+  exposures?: Record<string, ExtendedAssetProperties>[]
+  totalUsdDiff?: Record<string, ExtendedAssetProperties>
+  totalUsdExposure?: Record<string, ExtendedAssetProperties>
+}
+
+/**
+ * Address details from simulation (contract info, labels, etc.)
+ */
+export interface AddressDetails {
+  contractName?: string
+  type?: string
+  isVerified?: boolean
+  [key: string]: unknown
+}
+
+/**
+ * Solana-specific delegation info
+ */
+export interface SolanaDelegation {
+  account: string
+  authority?: string
+  amount?: string
+  state?: string
+  [key: string]: unknown
+}
+
+/**
+ * Solana-specific ownership diff
+ */
+export interface SolanaOwnershipDiff {
+  account: string
+  before?: string
+  after?: string
+  [key: string]: unknown
 }
 
 export type Simulation = SuccessfulSimulation | UnsuccessfulSimulation
@@ -253,15 +550,15 @@ export type Simulation = SuccessfulSimulation | UnsuccessfulSimulation
 interface SuccessfulSimulation {
   accountAddress: string
   accountSummary: AccountSummary
-  addressDetails: Record<string, any>
+  addressDetails: Record<string, AddressDetails>
   assetsDiffs: Record<string, AssetDiff[]>
   status: string
-  exposures?: Record<string, any>
-  totalUsdDiff?: Record<string, any>
-  totalUsdExposure?: Record<string, any>
+  exposures?: Record<string, ExtendedAssetProperties[]>
+  totalUsdDiff?: Record<string, ExtendedAssetProperties>
+  totalUsdExposure?: Record<string, ExtendedAssetProperties>
   solana?: {
-    delegations: Record<string, Record<string, any>[]>
-    assetsOwnershipDiff: Record<string, Record<string, any>[]>
+    delegations: Record<string, SolanaDelegation[]>
+    assetsOwnershipDiff: Record<string, SolanaOwnershipDiff[]>
   }
 }
 
@@ -384,6 +681,21 @@ export interface RpcConfig {
   [key: string]: string
 }
 
+export interface RpcProxyRequest {
+  requestId: string
+  method: string
+  params: unknown[]
+  chainId: string
+}
+
+export interface RpcProxyResponse {
+  requestId: string
+  jsonrpc: '2.0'
+  id: string
+  result?: unknown
+  error?: { code: number; message: string }
+}
+
 export interface CustomBackupConfig {
   encryptionKey: string
 }

package/src/shared/types/delegations.ts

@@ -112,3 +112,13 @@ export interface TransferFromResponse {
   encodedTransactions?: ConstructedSolanaTransaction[]
   metadata: TransferAsDelegateMetadata
 }
+
+/**
+ * Progress event for delegation submit flows (`approveAndSubmit`, `revokeAndSubmit`, `transferAndSubmit`).
+ */
+export interface DelegationSubmitProgress {
+  step: 'signing' | 'submitted'
+  index: number
+  total: number
+  hash?: string
+}

package/src/shared/types/index.ts

@@ -37,4 +37,5 @@ export type {
   TransferFromRequest,
   TransferAsDelegateMetadata,
   TransferFromResponse,
+  DelegationSubmitProgress,
 } from './delegations'

package/src/shared/types/lifi.ts

@@ -510,6 +510,8 @@ export interface LifiTransactionRequest {
   from?: string
   gasLimit?: string
   gasPrice?: string
+  maxFeePerGas?: string
+  maxPriorityFeePerGas?: string
   to?: string
   value?: string
 }
@@ -1234,3 +1236,83 @@ export interface LifiStepTransactionResponse {
 export interface LifiStepTransactionData {
   rawResponse: LifiStep
 }
+
+// --- High-level LiFi trade and route/step polling types ---
+
+export type LifiTradeAssetProgressStatus =
+  | 'fetching_routes'
+  | 'route_selected'
+  | 'preparing_step'
+  | 'signing'
+  | 'submitted'
+  | 'confirming'
+  | 'lifi_pending'
+  | 'step_done'
+  | 'complete'
+  | 'failed'
+
+export interface LifiTradeAssetProgressData {
+  errorMessage?: string
+  routeIndex?: number
+  route?: LifiRoute
+  stepIndex?: number
+  totalSteps?: number
+  step?: LifiStep
+  txHash?: string
+  lifiStatus?: LifiStatusRawResponse
+  transaction?: unknown
+}
+
+export interface LifiTradeAssetParams {
+  fromChain: string
+  toChain: string
+  fromToken: string
+  toToken: string
+  amount: string
+  fromAddress: string
+  toAddress?: string
+  routeOptions?: LifiRoutesRequestOptions
+  routeIndex?: number
+  onProgress?: (
+    status: LifiTradeAssetProgressStatus,
+    data?: LifiTradeAssetProgressData,
+  ) => void
+  statusPoll?: LifiPollStatusOptions
+}
+
+export interface LifiTradeAssetOptions {
+  signAndSendTransaction?: (
+    transaction: unknown,
+    network: string,
+  ) => Promise<string>
+  waitForConfirmation?: (
+    txHash: string,
+    network: string,
+  ) => Promise<void | boolean>
+  evmRequestFn?: (
+    method: string,
+    params: unknown[],
+    network: string,
+  ) => Promise<unknown>
+  evmPollerOptions?: {
+    pollIntervalMs?: number
+    timeoutMs?: number
+  }
+}
+
+export interface LifiTradeAssetResult {
+  hashes: string[]
+  steps: LifiStep[]
+  route: LifiRoute
+}
+
+export interface LifiPollStatusOptions {
+  everyMs?: number
+  initialDelayMs?: number
+  timeoutMs?: number
+  maxConsecutiveErrors?: number
+  backoff?: {
+    factor: number
+    maxIntervalMs: number
+  }
+}