# Tarvos x402

> A Solana x402 trigger that starts an n8n workflow only after an exact USDC payment settles.

Tarvos x402 Paygate verifies and settles x402 v2 exact USDC payments on Solana through PayAI before starting a self-hosted n8n workflow.

## Registry facts

- Readiness: installable
- Lifecycle: alpha
- Installation status: available
- Integration kind: shared-capability
- Node types: trigger
- Providers: PayAI (facilitator)
- Version: 0.1
- License: MIT
- Updated: 2026-09-04
- Repository: https://github.com/TarvosTools/n8n-nodes-Tarvos-x402
- Canonical documentation: https://tarvos-website-lju1.vercel.app/nodes/x402/

## Installation

```bash
git clone https://github.com/TarvosTools/n8n-nodes-Tarvos-x402.git
cd n8n-nodes-Tarvos-x402
npm install
npm run dev
```

## Setup guides

- [README](https://github.com/TarvosTools/n8n-nodes-Tarvos-x402/blob/main/README.md) (reference): Project overview, capabilities, and repository reference.
- [Getting started](https://github.com/TarvosTools/n8n-nodes-Tarvos-x402/blob/main/docs/GETTING-STARTED.md) (standard): Technical setup and first-run instructions.
- [Crypto beginner guide](https://github.com/TarvosTools/n8n-nodes-Tarvos-x402/blob/main/docs/CRYPTO-BEGINNER-GUIDE.md) (beginner): Wallet, USDC, network, and payment basics.

## Credentials

None

## Configuration

- **Service Name** (`serviceName`; required; default: Paid Service): Buyer-facing name for the paid service, included in the payment request and settled workflow output.
- **Network** (`network`; required; default: Solana Devnet; options: Solana Devnet, Solana Mainnet): Solana network on which the exact USDC payment settles.
- **Facilitator** (`facilitator`; required; default: PayAI; options: PayAI): Public facilitator used to verify and settle the payment. PayAI requires no credential in v0.1.
- **Required Amount (USDC)** (`requiredAmount`; required; default: 0.01): Exact positive USDC amount, expressed with no more than six decimal places.
- **Payout Wallet** (`payoutWallet`; required): Public Solana wallet address that receives the USDC payment.
- **Response Mode** (`options.responseMode`; optional; default: Immediately With Receipt; options: Immediately With Receipt, When Workflow Finishes): Return a settlement receipt immediately or wait and return the final workflow output.

## Constraints

- Solana Mainnet and Solana Devnet only.
- USDC only.
- x402 v2 exact payments only.
- No n8n credentials, seller private keys, or runtime dependencies.
- The workflow starts only after PayAI confirms settlement.

## Capabilities

- **Settled x402 payment** (trigger): Exposes a GET paywall endpoint and starts the workflow only after PayAI verifies and settles the configured exact USDC payment on Solana.