Class Rewards

constructor

• new Rewards(config?: CallerConfig, api?: AftermathApi): Rewards

  Creates a rewards HTTP client.

  Parameters

  • Optionalconfig: CallerConfig

    Optional network, API host, access token, and API path.

  • Optionalapi: AftermathApi

    Optional low-level provider used to serialize a caller-supplied transaction before requesting a claim transaction.

  Returns Rewards

Optional Readonlyapi

getClaimable

• getClaimable(
      inputs: ApiRewardsGetClaimableBody,
  ): Promise<ApiRewardsGetClaimableResponse>

  Fetches the wallet's currently claimable rewards.

  Parameters

  • inputs: ApiRewardsGetClaimableBody

    Wallet address to query.

  Returns Promise<ApiRewardsGetClaimableResponse>

  Claimable amounts grouped by coin type. Amounts are bigint values in each coin's smallest units.

  Throws

  AftermathTransportError when the API request or response fails.

getClaimTransaction

• getClaimTransaction(
      inputs: {
          coinTypes?: string[];
          recipientAddress?: string;
          tx?: Transaction;
          walletAddress: string;
      },
  ): Promise<
      Omit<ApiRewardsClaimRequestTxResponse, "txKind"> & { tx: Transaction },
  >

  Requests a reward-claim transaction and restores it as a Sui Transaction.

  If tx is supplied, this method serializes only its TransactionKind via AftermathApi.Transactions().fetchBase64TxKindFromTx and sends that txKind to the API. If tx is omitted, the request can still succeed with a backend-generated transaction. When the response includes a sponsorSignature, the returned bytes are parsed as a full transaction; otherwise they are parsed as a transaction kind. The returned transaction is not signed or executed by this method.

  Parameters

  • inputs: {
        coinTypes?: string[];
        recipientAddress?: string;
        tx?: Transaction;
        walletAddress: string;
    }

    Wallet address, optional coin filters, recipient, and an optional transaction to extend.

  Returns Promise<Omit<ApiRewardsClaimRequestTxResponse, "txKind"> & { tx: Transaction }>

  The parsed claim transaction and any backend sponsor signature.

  Throws

  AftermathTransportError when the API request or response fails.

  Throws

  Error when a supplied transaction cannot be serialized or the response cannot be restored as a Sui transaction.

getDistribution

• getDistribution(
      inputs: ApiRewardsDistributionBody,
  ): Promise<ApiRewardsDistributionResponse>

  Computes the distribution of the maker and taker reward pools across perpetuals accounts.

  Returns per-account maker and taker reward allocations, fee-tier rebates and volume metrics. When accountIds is omitted or empty the API includes every eligible account, so pass an explicit list to scope the result.

  Note: All data returned is for the current epoch only.

  Parameters

  • inputs: ApiRewardsDistributionBody

    ApiRewardsDistributionBody.

  Returns Promise<ApiRewardsDistributionResponse>

  Per-account reward and rebate breakdown for the current epoch.

  Throws

  AftermathTransportError when the API request or response fails.

  Example

  const { totalQScoreFinal, rewards } = await rewards.getDistribution({
    totalMakerRewards: 10000,
    totalTakerRewards: 5000,
    calculationVariables: { ... },
  });
  Copy

getHistory

• getHistory(
      inputs: ApiRewardsGetHistoryBody,
  ): Promise<ApiRewardsGetHistoryResponse>

  Fetches one page of the wallet's reward history.

  Pass cursor from the previous response to request the next page. The API documents a default page size of 20 and a maximum of 100 entries. Amounts in each history entry are returned as bigint values in the coin's smallest units.

  Parameters

  • inputs: ApiRewardsGetHistoryBody

    Wallet authentication data and optional domain and page parameters.

  Returns Promise<ApiRewardsGetHistoryResponse>

  History entries and pagination metadata.

  Throws

  AftermathTransportError when the API request or response fails.

getPoints

• getPoints(inputs: ApiRewardsGetPointsBody): Promise<ApiRewardsGetPointsResponse>

  Parameters

  • inputs: ApiRewardsGetPointsBody

  Returns Promise<ApiRewardsGetPointsResponse>