gitwtfhub

wtf is atlas?

sidneycodes1/atlas — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5Setup · hard

TL;DR

An automated system that watches Solana blockchain transactions, detects failures, and uses AI plus live fee data to resubmit and recover them without user action.

Mindmap

mindmap
  root((Atlas))
    What it does
      Watches Solana transactions
      Detects failures
      Recovers automatically
    Tech stack
      TypeScript
      Next.js
      Gemini AI
    Use cases
      Auto transaction recovery
      Real time streaming
      AI failure analysis
    Audience
      Solana developers
    Setup
      Privy account
      RPC provider
      Devnet wallet

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

Automatically detect and recover failed Solana transactions without a manual retry.

REASON 2

Watch live transaction status using a real-time gRPC stream with automatic fallback to polling.

REASON 3

Use AI to classify why a blockchain transaction failed and recommend a recovery plan.

REASON 4

Give new users an automatically funded Solana test wallet through Privy login, with no faucet step.

What's in the stack?

TypeScriptNext.jsSolanaGemini AIJito

How it stacks up

sidneycodes1/atlas0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatemoderate
Complexity4/53/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 accounts with Privy, a Solana RPC provider, and a funded devnet treasury wallet.

Wtf does this do

Atlas is a system built for the Solana blockchain that watches transactions as they are submitted and automatically fixes the ones that fail, without a person needing to click a retry button or take any other action. It was built for a hackathon called the Superteam Nigeria Advanced Infrastructure Challenge and runs on Solana's test network, called devnet, rather than the live network people use with real money. The system connects to a real time data stream from a service called Yellowstone to watch transactions as they move through the network. If that streaming connection is not available, for example because the plan being used does not include it, Atlas automatically switches to checking transaction status by asking the network directly instead, without needing any change to its settings. When a transaction fails, Atlas asks Google's Gemini AI model to look at the failure and suggest what went wrong and how to fix it. If the AI service is not available, a simpler set of built in rules takes over instead, so the system keeps working either way. To recover a failed transaction, Atlas rebuilds it with an updated fee, based on live pricing data from a service called Jito that helps transactions get processed reliably and protects them from being manipulated by other participants on the network. Every transaction is tracked through several stages, from first submitted to fully confirmed, with timestamps recorded at each step. New users log in through a service called Privy, which creates a digital wallet for them automatically, and the project automatically sends a small amount of test currency to that new wallet so users can try the system immediately without needing to find their own funds first. This project is aimed at developers interested in Solana blockchain infrastructure, particularly those exploring automated transaction reliability systems. Setting it up requires accounts with several external services, including Privy, a Solana RPC provider, and optionally Google's Gemini AI. The README does not clearly state what license applies to this code.

Yoink these prompts

Prompt 1
Help me set up the .env.local file for this project with Privy, RPC, and Gemini API credentials.
Prompt 2
Explain how this system decides between the 50th and 75th percentile Jito tip when submitting a transaction.
Prompt 3
Walk me through what happens when the Yellowstone gRPC stream returns a PERMISSION_DENIED error.
Prompt 4
Show me how the rule-based fallback planner works when the Gemini AI service is unavailable.

Frequently asked questions

wtf is atlas?

An automated system that watches Solana blockchain transactions, detects failures, and uses AI plus live fee data to resubmit and recover them without user action.

What language is atlas written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Solana.

How hard is atlas to set up?

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

Who is atlas for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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