Skip to content

Conversation

@0xh3rman
Copy link
Collaborator

@0xh3rman 0xh3rman commented Dec 5, 2025

No description provided.

Introduces the SwapperError type to the API and types package, enabling structured error handling for swapper endpoints. API responses for quote and quote_data now use a ProxyResponse type with standardized error objects. The typeshare preparation script now generates SwapperError from the Rust crate to avoid duplication. Minor updates to ProxyQuoteRequest and index exports for consistency.
@semanticdiff-com
Copy link

semanticdiff-com bot commented Dec 5, 2025

Review changes with  SemanticDiff

Changed Files
File Status
  apps/api/src/index.ts  36% smaller
  scripts/prepare_typeshare.py  4% smaller
  packages/types/src/index.ts  0% smaller
  packages/types/src/primitives/index.ts  0% smaller
  packages/types/src/primitives/swap/Error.ts  0% smaller
  packages/types/src/primitives/swap/Mod.ts  0% smaller
  scripts/templates/primitives_index.ts  0% smaller

@gemini-code-assist
Copy link

Summary of Changes

Hello @0xh3rman, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly enhances the API's error reporting by implementing a structured SwapperError object for all error responses. It also introduces API versioning to manage the transition to these new error formats and automates the generation of error types from the backend, improving overall robustness and developer experience.

Highlights

  • Structured Error Responses: The API endpoints now return a SwapperError object for errors, providing more detailed and structured error information instead of generic error messages. Successful responses are wrapped in an ok object.
  • API Versioning for Errors: A versioning mechanism has been introduced for API responses, allowing clients to request structured error objects based on a version query parameter, ensuring backward compatibility.
  • Dynamic Error Type Generation: The SwapperError type is now automatically generated from the Rust swapper crate using the typeshare tool, ensuring consistency between frontend and backend error definitions and reducing manual synchronization.
  • New Request Field: An optional use_max_amount field has been added to the ProxyQuoteRequest interface, providing more flexibility for quote requests.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces structured error handling by returning SwapperError objects, which is a great improvement for API clients. My review focuses on making this new implementation more robust and maintainable. I've identified a couple of high-severity issues: one related to potential information loss in the new structured error responses, and another concerning unsafe handling of request bodies which could lead to runtime errors. I've also included a medium-severity suggestion to refactor duplicated code into a middleware to improve maintainability. Addressing these points will make the API more reliable and easier to maintain.

Comment on lines 43 to 51
const providerId = req.params.providerId;
const provider = providers[providerId];
const version = parseVersion(req.query.v);
const errorObject = version >= API_VERSION;

if (!provider) {
res.status(404).json(errorResponse({ type: "no_available_provider" }, `Provider ${providerId} not found`, errorObject));
return;
}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

There's significant code duplication between this route handler (/:providerId/quote) and the /:providerId/quote_data handler (lines 68-76). The logic for parsing providerId, looking up the provider, parsing the version, and handling the 'provider not found' case is identical.

To improve maintainability and reduce redundancy, consider extracting this common logic into an Express middleware. The middleware could attach the provider and errorObject flag to the request object for subsequent handlers to use.

Example of what a middleware could look like:

function providerMiddleware(req, res, next) {
  const providerId = req.params.providerId;
  const provider = providers[providerId];
  const version = parseVersion(req.query.v);
  
  // Extend Express.Request type to add these properties
  req.provider = provider;
  req.errorObject = version >= API_VERSION;

  if (!provider) {
    res.status(404).json(errorResponse({ type: "no_available_provider" }, `Provider ${providerId} not found`, req.errorObject));
    return;
  }

  next();
}

// Usage:
app.post("/:providerId/quote", providerMiddleware, async (req, res) => {
  // req.provider is available here
  // ...
});

Replaces 'input_amount_too_small' with 'input_amount_error' in SwapperError type and adds a 'min_amount' field to provide more detailed error information.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants