REST transaction types

Import

These types are exported by @getpara/rest-sdk.

import type { TransferRequest, TransferResponse, EstimateFeeRequest, ListRestTransactionsRequest, RestTransaction, RestSponsorshipDetails, ResumeRestTransactionRequest, RestAutoRetryDetails, CreateYieldRequest, RestYieldOperation } from "@getpara/rest-sdk";

Transfers and fee estimates

value is the recipient’s transfer amount in asset base units, separate from the network fee (gas). For USDC with 6 decimals, "1000000" sends 1 USDC. Wallet-paid gas requires native tokens such as ETH, even for a USDC transfer. Set sponsoredGas: false or omit it to use the optional initiatorUserId from the signing requests. Sponsored requests reject it, including null or empty values, with 400 SPONSORSHIP_UNSUPPORTED_REQUEST. Set sponsoredGas: true to require Para-paid gas. false and omission select wallet-paid execution, even for enrolled partners. Explicit sponsorship returns an error for unsupported or unavailable execution and never changes the payer. See Gas sponsorship for constraints and replay behavior. With true, supply the payment’s recipient, amount, and supported chain/token; Para manages the nonce, gas limits, fees, and submission. Caller-provided nonce, gas/fee/type fields, and autoRetry are errors, even null or empty; they are never ignored or silently dropped. Sponsored requests accept only to, value, chainId, tokenAddress, kind, broadcast, addressScreening, and sponsoredGas. All other keys, including initiatorUserId and Solana’s network, are rejected even when null or empty. Ordinary transfers also accept the optional reviewId. Explicit sponsorship rejects reviewId, even null or empty, with 400 SPONSORSHIP_UNSUPPORTED_REQUEST. With the flag omitted or false, reviewId uses the ordinary transfer path. A transfer with autoRetry rejects the field with 400 INVALID_REQUEST and the message unsupported auto-retry field. A sponsored transfer paused for review resumes through resumeRestTransaction instead.

interface TransferRequest extends RestSigningRequestContext {
  to: string; value: string; chainId?: string | number; tokenAddress?: string;
  sponsoredGas?: boolean;
  nonce?: number; gasLimit?: string; maxFeePerGas?: string;
  maxPriorityFeePerGas?: string; gasPrice?: string; type?: 0 | 2;
  kind?: 'NATIVE' | 'ERC20' | 'SPL'; broadcast?: boolean; network?: 'SOLANA' | 'SOLANA_DEVNET';
}
interface LegacyTransferResponse {
  sponsoredGas?: false;
  /** @deprecated Use sponsoredGas. Response-only. */
  executionMode?: 'legacy'; signedTransaction: string; txHash?: string; transactionId?: string;
}
interface SponsoredTransferResponse extends RestSponsorshipDetails {
  sponsoredGas?: true;
  /** @deprecated Use sponsoredGas. Response-only. */
  executionMode: 'sponsored'; transactionId: string;
  status: 'pending' | 'submitted' | 'confirmed' | 'reverted' | 'failed';
  txHash?: string; signedTransaction?: never;
}
type TransferResponse = LegacyTransferResponse | SponsoredTransferResponse;
function isSponsoredTransfer(result: TransferResponse): result is SponsoredTransferResponse;
interface EstimateFeeRequest { to: string; value: string; chainId?: string | number; tokenAddress?: string; network?: 'SOLANA' | 'SOLANA_DEVNET'; }
interface EstimateFeeResponse {
  estimatedFee: string; transferAmount: string; currency: string;
  gasLimit?: string; maxFeePerGas?: string; maxPriorityFeePerGas?: string; gasPrice?: string; warning?: string;
}

Use isSponsoredTransfer(result) from @getpara/rest-sdk to identify the sponsored response, which has a tracking ID and no signed bytes. Read signedTransaction only in the ordinary branch, when the helper returns false. The helper reads sponsoredGas first and falls back to the deprecated response-only executionMode for older responses without the Boolean. Sending executionMode in a request returns 400. transfer() throws ParaRestSponsorshipError when the response’s gas payer differs from the requested sponsoredGas value. TransferRequest does not expose autoRetry; use the HTTP examples in Automatic fee retry for managed transfers. Managed signing uses signTransactionWithAutoRetry, and yield uses CreateYieldRequest.autoRetry.

Transaction history

History queries filter by status or intent and use a cursor for pagination. Each transaction records its state, identifiers and any failure details.

interface ListRestTransactionsRequest {
  limit?: number; cursor?: string;
  status?: 'pending' | 'submitted' | 'confirmed' | 'reverted' | 'failed';
  intentKind?: 'transfer' | 'sign_transaction' | 'yield';
}
type RestSponsoredTransactionStage =
  'requires_action' | 'preparing' | 'signed' | 'submission_unknown' | 'included' | 'delivery_unverified';
interface RestSponsorshipDetails {
  userOperationHash?: string; stage?: RestSponsoredTransactionStage; reviewId?: string;
  actualGasCost?: string;
}
interface ResumeRestTransactionRequest { reviewId: string; }
interface RestTransaction extends RestSponsorshipDetails {
  sponsoredGas?: boolean;
  /** @deprecated Use sponsoredGas. Response-only. */
  executionMode?: 'legacy' | 'sponsored';
  transactionId: string; walletId: string; walletType: 'EVM' | 'SOLANA';
  intentKind: 'transfer' | 'sign_transaction' | 'yield'; status: string;
  chainId?: string; network?: 'SOLANA' | 'SOLANA_DEVNET'; to?: string; value?: string; tokenAddress?: string;
  hash?: string | null; blockNumber?: string; blockHash?: string;
  failureStage?: 'mpc_sign' | 'signature_apply' | 'signer_verify' | 'broadcast' | 'monitor_timeout';
  failureCode?: string; failureMessage?: string; createdAt: string; submittedAt?: string; resolvedAt?: string;
  autoRetry?: RestAutoRetryDetails;
  monitoring?: { state: string; reason?: string; winningHash?: string };
}

Automatic retry details

Managed signing responses and the single-transaction lookup expose retry processing separately from the chain outcome. hash can be null before signing. A stopped retry can still be pending; inspect status, monitoring and the saved attempts. Transaction-list summaries omit autoRetry.

interface RestAutoRetryDetails {
  state: 'active' | 'stopped' | 'resolved';
  reason?: string;
  nonce?: number;
  network?: 'SOLANA' | 'SOLANA_DEVNET';
  maxExecutionFeeWei?: string;
  maxExecutionFeeLamports?: string;
  expiresAt: string;
  bumpCount: number;
  latestAttemptHash?: string;
  attempts: Array<{
    ordinal: number;
    stage: 'prepared' | 'signing' | 'rejected' | 'signed' | 'submission_unknown' | 'submitted';
    hash?: string;
    preparedAt: string;
    lastBroadcastAt?: string;
    lastValidBlockHeight?: number;
  }>;
}

Yield operations

createYieldDeposit and createYieldWithdrawal require options.idempotencyKey. getYieldOperation reads the same operation after acceptance, review pauses, restarts and replacements. The optional retry authorization is explicit for each phase and retains one original deadline. See Yield for fee semantics and partial progress.

type RestYieldPhase = 'approval' | 'action';
interface RestYieldAutoRetryAuthorization {
  expiresAt: string;
  action: { maxExecutionFeeWei: string };
  approval?: { maxExecutionFeeWei: string };
}
type CreateYieldRequest =
  ({ marketId: string; chainId?: string | number } | { chainId: string | number; marketId?: string }) & {
    amount: string;
    autoRetry?: RestYieldAutoRetryAuthorization;
  };
interface RestYieldOperation {
  id: string; walletId: string; chainId: number;
  source: 'aave-v3' | 'morpho-v2'; marketId: string;
  action: 'deposit' | 'withdraw'; amount: string;
  status: 'pending' | 'submitted' | 'confirmed' | 'failed' | 'requires_action' | 'cancelled';
  transactions: Array<{
    phase: RestYieldPhase; transactionId: string; hash: string; nonce: number;
    status: 'signed' | 'submitted' | 'confirmed' | 'reverted' | 'failed';
    blockNumber?: number; blockHash?: string;
  }>;
  autoRetry?: RestYieldAutoRetryAuthorization & {
    phases: Array<RestAutoRetryDetails & { phase: RestYieldPhase; transactionId: string }>;
  };
  error?: { code: string; message: string | null; reviewId?: string };
  createdAt: string; updatedAt: string;
}

Overview

Client Methods

Actions

React Hooks

Signers & Integrations

Smart Accounts

Wallet Connectors

REST SDK

Types & Configuration

REST transaction types

Import

Transfers and fee estimates

Transaction history

Automatic retry details

Yield operations

​Import

​Transfers and fee estimates

​Transaction history

​Automatic retry details

​Yield operations

Import

Transfers and fee estimates

Transaction history

Automatic retry details

Yield operations