GitHub - ASGCompute/asg-pay-public: Cross-chain payment gateway for AI agents - Fund any agent from any chain via Wormhole, Stripe, or Stellar. One URL. Three payment rails.

Cross-Chain Payment Gateway for AI Agents

Fund any AI agent from any chain. One URL. Three payment rails.
Fiat → Crypto → Bridge — all settling on Stellar.

Live Demo · Integration Guide · Wormhole Bridge Docs · Stellar Tutorial · Contributing

The Problem

AI agents are becoming autonomous economic participants — they purchase APIs, rent compute, pay for storage, and subscribe to SaaS. But funding them is broken:

Crypto users need to know the exact chain, token, and address
Fiat users have no checkout flow at all
Cross-chain users must manually bridge and swap before sending

There is no universal, chain-agnostic way for a human to fund an AI agent.

The Solution

ASG Pay is an open-source checkout page that any AI agent generates with a single URL:

https://fund.asgcard.dev/?agentName=MyBot&toAddress=GDQP...&toAmount=50&toToken=USDC

The user clicks the link, picks any payment method, and the agent's wallet is funded. That's it.

Built with

_Stellar

_Wormhole

_Stripe

_{Circle USDC}

_MasterCard

Source
chains

_Ethereum

_Solana

_Base

_Polygon

_{BNB Chain}

→

_Stellar

Three Payment Rails

Rail	How it Works	Source	Settlement	Status
🏦 Bank & Card	Stripe Checkout → USDC purchase → Stellar delivery	Fiat (Card / Bank)	Stellar	✅ Live
🌐 Bridge & Swap	Wormhole cross-chain bridge → auto-route → Stellar	Ethereum, Solana, Base, Polygon, BSC	Stellar	✅ Live
📤 Direct Send	Freighter wallet → sign → Horizon submit	Stellar (XLM / USDC)	Stellar	✅ Live

All three rails share the same universal URL interface. No matter how the user pays, the agent receives USDC on Stellar.

Wormhole Integration

ASG Pay uses Wormhole as its cross-chain interoperability layer, enabling users on any supported EVM chain to fund AI agents on Stellar in a single transaction.

graph LR
    subgraph Source Chains
        ETH[Ethereum]
        SOL[Solana]
        BASE[Base]
        POLY[Polygon]
        BSC[BNB Chain]
    end

    subgraph Wormhole
        WH["🌀 Wormhole Bridge<br/>Token Bridge + Connect"]
    end

    subgraph Settlement
        STELLAR["⭐ Stellar Network<br/>USDC Settlement"]
    end

    subgraph Destination
        AGENT["🤖 AI Agent Wallet"]
    end

    ETH --> WH
    SOL --> WH
    BASE --> WH
    POLY --> WH
    BSC --> WH
    WH --> STELLAR
    STELLAR --> AGENT

    style WH fill:#7c3aed,stroke:#fff,stroke-width:2px,color:#fff
    style STELLAR fill:#000,stroke:#fff,stroke-width:2px,color:#fff
    style AGENT fill:#22c55e,stroke:#fff,stroke-width:2px,color:#000

How the Bridge Works

User selects source chain and token (e.g., USDC on Ethereum)
ASG Pay generates a Wormhole transfer via the Token Bridge
User signs in their wallet (MetaMask, Phantom, etc.)
Wormhole bridges the tokens cross-chain to Stellar
Agent receives USDC on their Stellar address

Supported Bridge Paths

From	Token	To	Bridge
Ethereum	USDC, USDT, ETH	Stellar (USDC)	Wormhole Token Bridge
Solana	USDC, SOL	Stellar (USDC)	Wormhole Token Bridge
Base	USDC, ETH	Stellar (USDC)	Wormhole Token Bridge
Polygon	USDC, POL	Stellar (USDC)	Wormhole Token Bridge
BNB Chain	USDC, BNB	Stellar (USDC)	Wormhole Token Bridge

See docs/WORMHOLE_BRIDGE.md for detailed integration documentation.

Quick Start

Use the Hosted Version

https://fund.asgcard.dev/?agentName=MyBot&toAddress=GDQP...&toAmount=100&toToken=USDC

Self-Host

git clone https://github.com/ASGCompute/asg-pay-public.git
cd asg-pay-public
npm install
npm run dev       # → http://localhost:5173

URL Parameters

Parameter	Required	Default	Description
`agentName`	Recommended	`Stacy agent`	Display name of the AI agent
`toAddress`	Required	Demo address	Stellar public key (`G...`)
`toAmount`	Recommended	`50`	Amount to fund
`toToken`	No	`USDC`	Token to receive (`USDC`, `XLM`)
`toChain`	No	`Stellar`	Settlement chain

Architecture

graph TB
    Agent["🤖 AI Agent"] -->|Generates URL| Portal["ASG Pay Portal"]
    User["👤 User"] -->|Opens link| Portal

    Portal --> Selection["Payment Method Selection"]

    Selection --> Fiat["🏦 Bank & Card"]
    Selection --> Bridge["🌐 Bridge & Swap"]
    Selection --> Send["📤 Direct Send"]

    Fiat -->|"Stripe Checkout"| StripeAPI["Stripe API"]
    StripeAPI -->|"Webhook"| Settlement["Settlement Engine"]
    Settlement -->|"USDC"| AgentWallet["Agent Wallet<br/>(Stellar)"]

    Bridge -->|"Wormhole SDK"| WH["Wormhole<br/>Token Bridge"]
    WH -->|"Cross-chain settle"| AgentWallet

    Send -->|"Freighter Sign"| Horizon["Stellar Horizon"]
    Horizon --> AgentWallet

    style AgentWallet fill:#22c55e,stroke:#fff,stroke-width:2px,color:#000
    style Portal fill:#7c3aed,stroke:#fff,stroke-width:2px,color:#fff
    style WH fill:#6366f1,stroke:#fff,stroke-width:2px,color:#fff

Tech Stack

Layer	Technology
Frontend	React 19, TypeScript, Vite 8
Styling	Vanilla CSS (glassmorphic design system, 1700+ lines)
Stellar	`@stellar/stellar-sdk`, `@stellar/freighter-api`
Cross-chain	Wormhole Token Bridge, Wormhole Connect
Fiat	Stripe Checkout
Hosting	Vercel (auto-deploy from `main`)

Developer Tools

ASG Pay is part of the broader ASG Card ecosystem — a suite of open-source tools for AI agent payments:

Package	Description	Install
ASG Pay	Cross-chain funding portal (this repo)	`git clone` / hosted
@asgcard/sdk	TypeScript SDK for payment integration	`npm i @asgcard/sdk`
@asgcard/cli	CLI for wallet setup + card management	`npx @asgcard/cli`
@asgcard/mcp-server	MCP Server (11 tools) for AI agents	`npx @asgcard/mcp-server`

Integration Examples

Python — Generate payment link

from urllib.parse import urlencode

def create_funding_url(agent_name: str, address: str, amount: float) -> str:
    params = {
        "agentName": agent_name,
        "toAddress": address,
        "toAmount": str(amount),
        "toToken": "USDC",
    }
    return f"https://fund.asgcard.dev/?{urlencode(params)}"

# Usage
url = create_funding_url("Trading Bot", "GDQP2KPQ...", 100)
print(f"Fund your agent: {url}")

TypeScript — Generate payment link

function createFundingUrl(params: {
  agentName: string;
  toAddress: string;
  toAmount: number;
  toToken?: string;
}): string {
  const search = new URLSearchParams({
    agentName: params.agentName,
    toAddress: params.toAddress,
    toAmount: String(params.toAmount),
    toToken: params.toToken || "USDC",
  });
  return `https://fund.asgcard.dev/?${search.toString()}`;
}

MCP Tool — Auto-generate via AI agent

# Install the MCP server
npx @asgcard/mcp-server

# The MCP server provides payment URL generation as a built-in tool
# AI agents using Claude, Cursor, or Codex can create funding links automatically

Stellar — Monitor incoming payments

import { Horizon } from "@stellar/stellar-sdk";

const server = new Horizon.Server("https://horizon.stellar.org");

server.payments()
  .forAccount("YOUR_AGENT_ADDRESS")
  .cursor("now")
  .stream({
    onmessage: (payment) => {
      if (payment.type === "payment") {
        console.log(`Received ${payment.amount} ${payment.asset_code || "XLM"}`);
      }
    },
  });

Project Structure

src/
├── App.tsx                    # Root: URL params, balance fetching, routing
├── types.ts                   # TypeScript interfaces (AppState, TokenInfo)
├── index.css                  # Design system (1700+ lines, CSS variables)
├── providers.tsx              # React context providers
├── components/
│   ├── AgentInfoCard.tsx      # Left panel: agent identity, destination, balances
│   ├── PaymentSelection.tsx   # Payment method selection (Fiat / Stablecoin / Crypto)
│   ├── ExchangeWidget.tsx     # Tabbed widget: Bank & Card / Bridge & Swap / Send
│   ├── ReceiveWidget.tsx      # Route selection and bridge confirmation
│   ├── Header.tsx             # Page header with wallet status
│   ├── ErrorBoundary.tsx      # React error boundary
│   └── modals/
│       ├── TokenModal.tsx     # Multi-chain token selector
│       ├── SettingsModal.tsx   # Bridge settings (slippage, gas, routes)
│       ├── WalletModal.tsx    # Wallet connection (Freighter, MetaMask, Phantom, WC)
│       └── ProgressOverlay.tsx # Tx progress + Wormhole bridge tracking + success state
└── utils/
    └── stellar.ts             # Stellar SDK: build, sign, submit transactions

Wallet Support

Wallet	Chains	Protocol
Freighter	Stellar	Native (TESTNET + MAINNET)
MetaMask	Ethereum, Base, Polygon, BSC	EVM + Wormhole Bridge
Phantom	Solana	Solana + Wormhole Bridge
WalletConnect	Multi-chain	QR Code

Security

🔒 Destination locked — recipient address is pre-filled and immutable
🔑 No private keys — all signing happens in the user's wallet extension
🌐 Client-side only — no backend stores sensitive data
✅ Open source — fully auditable codebase
🛡️ CSP headers — Content Security Policy enforced via Vercel

Roadmap

Phase	Status	Description
✅ Phase 1	Complete	Core UI: agent card, payment selection, glassmorphic design system
✅ Phase 2	Complete	Stellar wallet: Freighter integration, real tx signing, Horizon submission
✅ Phase 3	Complete	Fiat on-ramp: Stripe Checkout with fee calculation
✅ Phase 4	Complete	Cross-chain bridge: Wormhole Token Bridge integration
🔧 Phase 5	In Progress	Wormhole Connect widget embedding + advanced route optimization
📋 Phase 6	Planned	Payment API: programmatic checkout sessions + webhook callbacks
📋 Phase 7	Planned	Soroban: on-chain payment verification smart contract

Contributing

We welcome contributions from the Stellar and Wormhole communities. See CONTRIBUTING.md for guidelines.

Good First Issues

Add Wormhole Connect widget to Bridge & Swap tab
Implement bridge transaction status polling via Wormhole API
Add loading skeletons while Horizon balance data loads
Keyboard accessibility for modal overlays

Ecosystem & Collaboration

Stellar
_{Settlement network}

Wormhole
_{Cross-chain bridge}

Stripe
_{Fiat on-ramp}

Circle
_{USDC issuer}

MasterCard
_{Card issuance (via ASG Card)}

License

Apache 2.0 — Use it, fork it, build on it.

_{Built with ♥ by ASG Compute for the Stellar and Wormhole ecosystems.}

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
.github		.github
docs		docs
examples		examples
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
TECHNICAL_OVERVIEW.md		TECHNICAL_OVERVIEW.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Cross-Chain Payment Gateway for AI Agents

The Problem

The Solution

Three Payment Rails

Wormhole Integration

How the Bridge Works

Supported Bridge Paths

Quick Start

Use the Hosted Version

Self-Host

URL Parameters

Architecture

Tech Stack

Developer Tools

Integration Examples

Project Structure

Wallet Support

Security

Roadmap

Contributing

Good First Issues

Ecosystem & Collaboration

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Cross-Chain Payment Gateway for AI Agents

The Problem

The Solution

Three Payment Rails

Wormhole Integration

How the Bridge Works

Supported Bridge Paths

Quick Start

Use the Hosted Version

Self-Host

URL Parameters

Architecture

Tech Stack

Developer Tools

Integration Examples

Project Structure

Wallet Support

Security

Roadmap

Contributing

Good First Issues

Ecosystem & Collaboration

License

About

Topics

Resources

License

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Packages