https://github.com/base/tips
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/base/tips
- Owner: base
- Created: 2025-07-18T18:38:51.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-09-26T04:59:38.000Z (9 months ago)
- Last Synced: 2025-09-26T06:23:16.828Z (9 months ago)
- Language: Rust
- Size: 646 KB
- Stars: 7
- Watchers: 0
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TIPS - Transaction Inclusion & Prioritization Stack
> [!WARNING]
> This repository is an experiment to enable bundles, transaction simulation and transaction tracing for Base.
> It's being used to explore ideas and experiment. It is currently not production ready.
## Architecture Overview
The project consists of several components:
### 🗄️ Datastore (`crates/datastore`)
Postgres storage layer that provides API's to persist and retrieve bundles.
### 📊 Audit (`crates/audit`)
Event streaming and archival system that:
- Provides an API to publish bundle events to Kafka
- Archives bundle history to S3 for long-term storage
- See [S3 Storage Format](docs/AUDIT_S3_FORMAT.md) for data structure details
### 🔌 Ingress RPC (`crates/ingress-rpc`)
The main entry point that provides a JSON-RPC API for receiving transactions and bundles.
### 🔨 Maintenance (`crates/maintenance`)
A service that maintains the health of the TIPS DataStore, by removing stale or included bundles.
### ✍️ Ingress Writer (`crates/ingress-writer`)
A service that consumes bundles from Kafka and persists them to the datastore.
### 🖥️ UI (`ui`)
A debug UI for viewing the state of the bundle store and S3.