Proxy API requests

​

Why proxy requests?

There are two main benefits of using a proxy server to route requests to ChainPatrol:

1. Prevent leaking your API key - You can proxy requests to ChainPatrol through your own server which adds the ChainPatrol API key to each requests only on the server. This way, your API key is never exposed to the public.

2. Protect your user’s privacy - By proxying requests through your own server, ChainPatrol servers will not be able to read the IP addresses of your users if you are using the /asset/check API. This is because the requests to ChainPatrol will originate from your server and not from your user’s browser.

​

How to proxy requests

You can proxy requests to ChainPatrol using any server-side technology. Below are some examples of how to proxy requests using different technologies.

const API_KEY = 'YOUR_API_KEY';
const UPSTREAM_URL = 'https://app.chainpatrol.io/api/v2/asset/check';

export default {
  async fetch(request, env, ctx) {
    // Create a new request to the upstream server
    const url = new URL(UPSTREAM_URL);
    const upstreamRequest = new Request(url, request);

    // Set the ChainPatrol API key
    upstreamRequest.headers.set('X-API-KEY', API_KEY);

    // Return the response
    return fetch(upstreamRequest);
  },
};

curl --request POST \
  --url https://chainpatrol-proxy.your-subdomain.workers.dev/ \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "URL",
    "content": "google.com"
  }'

{"status":"ALLOWED"}

import { serve } from "https://deno.land/[email protected]/http/server.ts";

const UPSTREAM_URL = "https://app.chainpatrol.io/api/v2/asset/check";

async function handler(request: Request): Promise<Response> {
    // Create a new request to the upstream server
    const url = new URL(UPSTREAM_URL);
    const upstreamRequest = new Request(url, request);

    // Set the ChainPatrol API key
    upstreamRequest.headers.set('X-API-KEY', Deno.env.API_KEY);

    // Return the response
    return fetch(upstreamRequest);
}

serve(handler);

​

Important Considerations

• When deploying your proxy server, consider the ingress and egress volume that you’ll handle from your clients. If you’re expecting a lot of traffic, you may want to consider using a serverless platform like Cloudflare Workers or Deno Deploy to reduce costs.

• Try to keep your proxy server as close to your clients as possible. This will reduce latency and improve performance.

• When deploying your proxy server, make sure to use HTTPS. This will ensure that your requests are encrypted and secure.

• We reserve the right to block/rate-limit your API key if we detect excessive usage or abuse. Please make sure to handle errors gracefully in the event of unexpected downtime and let us know when you are planning on going live with your integration, so that we can provision the appropriate resources to meet your demand. If you have any questions, please contact us at [email protected].