explaingit

0xbebis/hyperpay

14TypeScriptAudience · developerComplexity · 5/5LicenseSetup · hard

TLDR

Payment infrastructure for AI agents to autonomously pay for their own compute costs, handling gasless cross-chain USDC transfers, bridge verification, and deposit funding without human intervention.

Mindmap

mindmap
  root((hyperpay))
    Core Packages
      x402 gasless payments
      cctp-verify bridge checks
      funding-pipeline coordinator
    What it solves
      AI agent self-funding
      Cross-chain USDC moves
      Compute credit buying
    Blockchains
      10 source chains
      Base settlement chain
      Arc future target
    Usage
      Read and adapt code
      Bring your own infra
      MIT licensed
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Build an AI trading agent that automatically tops up its own compute credits by watching for USDC deposits across multiple blockchains.

USE CASE 2

Implement gasless USDC payments in your app where users sign off-chain and the server settles on-chain without the user paying gas fees.

USE CASE 3

Verify that a cross-chain USDC bridge transfer has fully arrived before allowing downstream actions in your pipeline.

Tech stack

TypeScriptUSDCCircle CCTPBaseHyperliquid

Getting it running

Difficulty · hard Time to first run · 1day+

Reference code intended to be read and adapted, not imported as a library, requires your own wallet infrastructure, RPC endpoints, and database implementations.

MIT license, use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

HyperPay is payment infrastructure code that was originally built for Cod3x, an AI trading platform, and has been released publicly as open-source. The core problem it solves: AI agents that earn money from trading need a way to automatically pay for the computing power they run on, without a human stepping in to move funds around. HyperPay handles that entire funding loop autonomously. The system is built around three packages. The first, x402, handles gasless payments using a protocol where the buyer signs an off-chain authorization and a server settles the payment on-chain, meaning the person paying does not need to spend extra funds on network fees. The second, cctp-verify, checks whether a cross-chain transfer has actually arrived at its destination by polling multiple blockchains until it sees the funds appear. The third, funding-pipeline, acts as the coordinator: it watches for USDC deposits across ten different blockchains, bridges them to a central settlement chain, buys compute credits, and deposits into Hyperliquid (a trading platform). If something crashes mid-process, it picks up exactly where it stopped. The underlying bridge technology is Circle CCTP, a standard that lets USDC move between blockchains by burning it on the source chain and minting it fresh on the destination. The repo currently settles on the Base blockchain but is built to switch to Arc (Circle's own dedicated USDC chain) once that launches on mainnet, which requires only a configuration change. The README is explicit that this is not a ready-to-install library. It is production code extracted into readable packages with clean interfaces, intended to be read and adapted into your own project rather than imported as a dependency. Everything is MIT licensed. The repo also includes an AGENTS.md file specifically for people using AI coding tools like Claude or Cursor to integrate these packages, which is an unusual and practical touch. To use it, you clone the repository, install dependencies with npm, and work directly with the three packages under the packages directory. All external provider dependencies (database, wallet infrastructure, RPC endpoints) are defined as interfaces, so you supply your own implementations.

Copy-paste prompts

Prompt 1
I want to use the HyperPay funding-pipeline package to watch for USDC deposits on Ethereum and bridge them to Base. Walk me through which interfaces I need to implement and how to wire them together.
Prompt 2
Explain how the x402 gasless payment flow in HyperPay works step by step: what the client signs, what the server does, and how settlement happens on-chain.
Prompt 3
I need to add Arbitrum as a new source chain in the HyperPay funding-pipeline. What configuration changes are required to make it watch for USDC deposits on Arbitrum?
Open on GitHub → Explain another repo

← 0xbebis on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.