trytrench / trench

Open source fraud and abuse prevention tools

Discord - Website - Docs

Getting started

🚧 This project is currently under development 🚧

Trench is a tool for monitoring and preventing fraud and abuse. It helps you collect data on users, identify bad actors, and take action on them (e.g. blocking a payment).

Live demo

Documentation

Check out the full documentation here.

Deploying Trench

• Install Docker Engine and Docker Compose
• Clone the repository: git clone https://github.com/trytrench/trench.git && cd trench
• Run Trench: docker-compose up

Sending data to Trench

You can send user events to Trench via the REST API or using the Javascript SDK.

curl \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  'YOUR_TRENCH_URL/api/event' \
  -d '
{
  "type": "payment",
  "data": {
    "card": {
        "fingerprint": "f2xvb823k",
        "brand": "visa",
        "country": "US",
        "last4": "4242",
    },
    "user": {
      "id": "45912",
      "name": "John Doe",
      "email": "[email protected]"
    },
    ...
  }

Design Philosophy

• Full customization. You know your product and user interactions better than anyone else. To be effective, you should have full control over the data you collect and integrate.
• Full access to your data. You shouldn’t be limited to dashboards and reports. Full access to your data is needed to properly understand your fraud.

Local development

1. Clone the repository: git clone https://github.com/trytrench/trench.git && cd trench
2. Install dependencies: pnpm install
3. Run the development server: pnpm dev

Join our community

Join the Trench community in Discord if you need support or have anything you'd like to ask. We'd love to chat!

trench's Issues

Is this repository runnable in windows OS ?

Is this repository runnable in windows OS ?
Thanks

Error when running npm run dev

I always hit the following error whenever I try to follow the instruction for installation on README.md

getting started locally -- `pnpm bulid` fails, so does `docker-compose up`

Trench sounds interesting. Thanks for your working on it!

In trying to run it locally, I've run into a couple of snags.

Cloned the repo and ran pnpm install at the root. Then tried each of pnpm dev, pnpm build and docker-compose up.

First ran into some type errors in fetchGithubData.ts:

I've opened a PR for fixing above type errors. But even after fixing those, pnpm dev kept failing; and I figured this was likely because prisma-related build steps weren't run. So I gave pnpm build a shot; but that too failed. There seem to be complaints about stuff in Sha1.ts:

However, the code editor isn't complaining about Sha1.ts at all. I'm looking around, but I'm not entirely sure why the build phase complains about this. Any pointers?

Thank you!