gitwtfhub

wtf is smart-transaction-stack?

not-a-vibe-coder/smart-transaction-stack — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 5/5Setup · hard

TL;DR

A hackathon project that makes Solana stablecoin payments more reliable by tracking their full lifecycle and using an AI agent to decide how to recover from failures.

Mindmap

mindmap
  root((Solana Pay Dispatcher))
    What it does
      Tracks payment lifecycle
      AI powered retries
      Generates receipts
    Tech stack
      TypeScript and Node.js
      Solana web3.js
      Anthropic SDK
    Use cases
      Stablecoin payments
      Failure recovery
      Network health monitoring
    Audience
      Blockchain developers
      Hackathon reviewers
      Payment infra builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Submit Solana stablecoin payments with lifecycle tracking from queued through finalized.

REASON 2

Automatically retry failed blockchain transactions using AI reasoning about the failure cause.

REASON 3

Generate verifiable payment receipts with slot numbers and retry history.

REASON 4

Monitor Solana network health to adjust transaction tips dynamically.

What's in the stack?

TypeScriptNode.jsSolana web3.jsNext.jsSQLiteAnthropic SDK

How it stacks up

not-a-vibe-coder/smart-transaction-stack0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardhardhard
Complexity5/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires Solana RPC, Geyser gRPC, Jito block engine, and Anthropic API keys all configured before it runs.

Wtf does this do

Solana Pay Dispatcher is a system built for a hackathon challenge that tries to make stablecoin payments on the Solana blockchain more reliable. The README explains that Nigeria moves over 22 billion dollars a year in stablecoin transactions, but Solana transactions can fail at rates above 40 percent during busy periods, and existing tools simply submit a transaction and give you no way to know what happened to it afterward. This project wraps every payment in what is called a Jito bundle, which helps the transaction land safely and protects it from being manipulated by other actors on the network. It watches the network in real time using a Geyser data stream, calculates transaction tips dynamically based on live market conditions, and uses a Claude AI agent to decide how to respond when a payment fails, rather than relying on a fixed retry rule. Every payment moves through a tracked set of stages: queued, submitted, processed, confirmed, and finalized, with each step logged and checkable against a public block explorer. When something goes wrong, such as an expired blockhash or an insufficient tip, the AI agent reads the type of failure along with current network health and tip statistics, then decides whether to retry, wait, or adjust the tip before resubmitting. At the end of a successful payment, the system produces a receipt containing the block slot number, total time taken, and a record of any retry decisions the AI made. The project is built with TypeScript on Node.js, using the official Solana web3 and token libraries, the Jito block engine for bundle submission, a Yellowstone gRPC client for the Geyser stream, the Anthropic SDK for the Claude AI agent, and a SQLite database for storage. The dashboard is a Next.js and Tailwind CSS frontend with Recharts for charts. Setup requires cloning the repository, installing dependencies with npm, and filling in an environment file with API keys and endpoints for an RPC provider, the Geyser stream, and the Anthropic API before running the dispatcher and dashboard servers separately.

Yoink these prompts

Prompt 1
Walk me through setting up the .env file needed to run the Solana Pay Dispatcher locally.
Prompt 2
Explain how the FailureClassifier and AI agent decide whether to retry a failed Solana bundle.
Prompt 3
Help me connect a Helius or QuickNode devnet RPC endpoint to this dispatcher project.
Prompt 4
Show me how the payment lifecycle states from queued to finalized are logged in this codebase.

Frequently asked questions

wtf is smart-transaction-stack?

A hackathon project that makes Solana stablecoin payments more reliable by tracking their full lifecycle and using an AI agent to decide how to recover from failures.

What language is smart-transaction-stack written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Solana web3.js.

How hard is smart-transaction-stack to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is smart-transaction-stack for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.