Icon LinkPagination

Pagination is highly efficient when dealing with large sets of data. Because of this some methods from the Provider class support GraphQL cursor pagination Icon Link, allowing you to efficiently navigate through data chunks.

Icon LinkPagination Arguments

The pagination arguments object is used to specify the range of data you want to retrieve. It includes the following properties:

• after: A cursor pointing to a position after which you want to retrieve items.
• first: The number of items to retrieve after the specified cursor. This is used in conjunction with the after argument.
• before: A cursor pointing to a position before which you want to retrieve items.
• last: The number of items to retrieve before the specified cursor. This is used in conjunction with the before argument.

const paginationArgsExample: CursorPaginationArgs = {
  after: 'cursor',
  first: 10,
  before: 'cursor',
  last: 10,
};

Icon LinkPage Info

The pageInfo object is included in the GraphQL response for requests that support cursor pagination. It provides crucial metadata about the current page of results, allowing you to understand the pagination state and determine if there are more items to fetch before or after the current set.

• endCursor: A cursor representing the last item in the current set of results. It should be used as the after argument in subsequent queries to fetch the next set of items.
• hasNextPage: A boolean indicating whether there are more items available after the current set.
• startCursor: A cursor representing the first item in the current set of results. It should be used as the before argument in subsequent queries to fetch the previous set of items.
• hasPreviousPage: A boolean indicating whether there are more items available before the current set.

const pageInfoExample: PageInfo = {
  endCursor: 'cursor',
  hasNextPage: true,
  startCursor: 'cursor',
  hasPreviousPage: true,
};

Icon LinkUsing Pagination

One of the methods that supports pagination is the getCoins method. This method receives three parameters:

• address: The owner's account address
• assetId: The asset ID of the coins (optional)
• paginationArgs: The pagination arguments (optional)

Icon LinkBasic Pagination

Here is how you can use the getCoins method with pagination:

const provider = await Provider.create(LOCAL_NETWORK_URL);
 
let paginationArgs: CursorPaginationArgs = {
  first: 10, // It will return only the first 10 coins
};
 
const { coins, pageInfo } = await provider.getCoins(
  WALLET_ADDRESS,
  provider.getBaseAssetId(),
  paginationArgs
);
 
if (pageInfo.hasNextPage) {
  paginationArgs = {
    after: pageInfo.endCursor,
    first: 10,
  };
  // The coins array will include the next 10 coins after the last one in the previous array
  await provider.getCoins(
    WALLET_ADDRESS,
    provider.getBaseAssetId(),
    paginationArgs
  );
}

Icon LinkNavigating to the Previous Page

You can also use the paginationArgs to navigate to the previous page of results:

if (pageInfo.hasPreviousPage) {
  paginationArgs = {
    before: pageInfo.startCursor,
    last: 10,
  };
 
  // It will includes the previous 10 coins before the first one in the previous array
  await provider.getCoins(
    WALLET_ADDRESS,
    provider.getBaseAssetId(),
    paginationArgs
  );
}

Icon LinkValid Combinations

• Forward Pagination:

  Use after with first to retrieve items following a cursor.

const paginationArgsForward: CursorPaginationArgs = {
  after: 'cursor',
  first: 10,
};

• Backward Pagination:

  Use before with last to retrieve items preceding a cursor.

const paginationArgsBackwards: CursorPaginationArgs = {
  before: 'cursor',
  last: 10,
};

Icon LinkDefault Behavior

If neither assetId nor paginationArgs are provided, the getCoins method will default to the base asset ID and return the first 100 items:

// It will return the first 100 coins for a given wallet
await provider.getCoins(WALLET_ADDRESS);