Skip to content
View ProwlFi's full-sized avatar

Organizations

@PercolatorFinance

Block or report ProwlFi

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ProwlFi/README.md

ProwlFi Labs

🐺 ProwlFi

Private rails for the agentic economy on Solana.

Stealth addresses and x402 payments for AI agents β€” every payment lands at a fresh, single-use address that only the recipient can spend, so who paid whom, and how much, never reaches the public ledger.

Website Β  Documentation Β  X / Twitter Β  GitHub

MIT License Solana mainnet x402 SVM TypeScript


Overview

The agent economy is being built in public, on rails that publish every payment forever. For an autonomous agent that transacts continuously, the public ledger becomes a strategy leak: who it pays, how much, and when are all readable straight from the transaction graph.

ProwlFi closes that gap at the address layer. It combines two primitives:

  • Stealth addresses β€” the recipient publishes one long-lived meta-address; senders derive a fresh, single-use destination for every payment that cannot be linked to one another or back to the recipient.
  • x402 payments β€” the dormant HTTP 402 Payment Required status code, turned into a working machine-to-machine settlement layer so one agent can pay another over plain HTTP, with the payment landing at a stealth address.

The result: agents keep operating on standard Solana β€” standard wallets, standard SPL tokens β€” without surrendering their strategy to anyone with a block explorer. An operator retains a viewing key for a complete, attributable audit trail, so ProwlFi is private from the public, not from you. It is confidentiality infrastructure, not a mixer.

Links

Website Β  Documentation Β  X / Twitter Β  GitHub

Features

  • Single-use stealth addresses β€” derived per payment on ed25519, no reuse, no clustering.
  • x402 stealth payments β€” pay any agent endpoint over HTTP; settlement lands at a fresh address.
  • View-tag scanning β€” one-byte view tags discard ~99.6% of announcements before any derivation.
  • Viewing keys β€” selective disclosure: export a deterministic audit trail without revealing strategy.
  • Gasless sweeps β€” SOL and SPL, fee-sponsored, so no SOL needs to be pre-funded at a destination.
  • Non-custodial β€” spending keys are derived from your seed and never leave your process.
  • Three surfaces β€” TypeScript SDK, MCP server, and a REST API. Same engine, same guarantees.

Quickstart

npm install @prowlfi/sdk
import { createProwl } from "@prowlfi/sdk";

const agent = createProwl({ chain: "solana" });

// Resolve a recipient to a fresh, one-time stealth address and settle over x402.
const { receipt } = await agent.payX402({
  url: "https://api.vendor.xyz/infer",
  to: "prowl:vendor-7",
  amount: 0.02,
  token: "USDC",
});

// Recipient side: scan announcements with a viewing key and sweep what arrived.
const incoming = await agent.scan(agent.viewingKey());

See examples/ for runnable end-to-end flows.

Packages

This is a monorepo for the ProwlFi protocol and its agent-facing surfaces.

Package Description
@prowlfi/sdk TypeScript SDK β€” stealth derivation, x402 payments, scanning, sweeps.
@prowlfi/mcp-server Model Context Protocol server exposing ProwlFi tools to Claude Code, Cursor, Windsurf, and any MCP host.

ProwlFi Γ— Pump.fun

ProwlFi x Pump.fun

Something is coming. Follow @tryProwlFi for the announcement.

How it works

A minimal on-chain program announces payments; everything cryptographic happens client-side, inside your agent.

  1. Publish. The recipient publishes a meta-address β€” prowl:<spend>.<view>.
  2. Derive. The sender combines an ephemeral keypair with the recipient's public keys to compute a unique stealth address, entirely client-side.
  3. Pay. Funds are sent to the stealth address; the ephemeral public key and a one-byte view tag are emitted in an on-chain announcement.
  4. Scan. The recipient filters announcements by view tag, recognizes payments meant for them with their viewing key, and derives the key to spend.
on-chain program  ->  pure-TS privacy engine  ->  SDK / MCP / REST

Architecture

.
β”œβ”€β”€ packages/
β”‚   β”œβ”€β”€ sdk/            # @prowlfi/sdk β€” client engine (derivation, x402, scan, sweep)
β”‚   └── mcp-server/     # @prowlfi/mcp-server β€” MCP tools for agent hosts
β”œβ”€β”€ examples/           # runnable end-to-end flows
β”œβ”€β”€ docs/               # protocol documentation
└── assets/             # brand assets

Roadmap

  • Stealth scheme and on-chain announcement program on Solana mainnet
  • TypeScript SDK, MCP server, and REST surfaces
  • Independent audit and sRFC submission for the stealth-address standard
  • Confidential amounts (BN-254) and network-privacy relays
  • Cross-SVM coverage

Security

ProwlFi is in active development; the stealth scheme and on-chain program are scoped for third-party audit. Do not treat mainnet usage as audited until that completes. To report a vulnerability, see SECURITY.md β€” please do not open public issues for security reports.

Contributing

Contributions are welcome. See CONTRIBUTING.md for the development workflow, and CODE_OF_CONDUCT.md.

License

Released under the MIT License. Β© ProwlFi Labs.


ProwlFi

🐺 Built on Solana · prowl.finance

Pinned Loading

  1. ProwlFi ProwlFi Public

    Private rails for the agentic economy on Solana. 🐺 Stealth addresses + x402 payments for AI agents.

    TypeScript 331 13

  2. oven-sh/bun oven-sh/bun Public

    Incredibly fast JavaScript runtime, bundler, test runner, and package manager – all in one

    Rust 92.9k 4.7k