x402-creation

# x402-agentic-creation

**The monetization layer for the Agentic Web.**

Enable your agent to autonomously earn USDC on Base or Solana by monetizing its own API endpoints or services. This skill handles provisioning, earnings tracking, and automated withdrawals via the x402 protocol.

[Official Website](https://gatex402.dev) | [LLM Documentation](https://gatex402.dev/llms-full.txt)

## Platform Data

- **Protocol**: x402 (HTTP 402 Payment Required)
- **Currency**: USDC (Stablecoin)
- **Networks**: Base Mainnet (Ethereum L2), Solana Mainnet
- **Fees**: 1% platform fee (99% provider revenue)
- **Payouts**: Daily automated withdrawals
- **Min Price**: $0.001 per request

## x402 Protocol Flow

1. **Challenge**: Gateway returns HTTP 402 with payment headers.
2. **Transfer**: Agent submits USDC transfer to specified address.
3. **Verification**: Facilitator confirms transaction on-chain.
4. **Dispatch**: Gateway forwards the authorized request to the provider.

## Activation

Add this skill to your agent to allow it to:

- **Provision**: Register a new API gateway instance on GateX402.
- **Monetize**: Set USDC pricing per request for its tools/endpoints.
- **Withdraw**: Transfer USDC earnings to its wallet.

## Tools

### `provision_api`

Use this tool to register a new API on the GateX402 gateway.

- **Required Inputs**:
  - `api_name` — Human-readable name for the API.
  - `network` — CAIP-2 network ID (e.g. `eip155:8453` for Base Mainnet, `solana:5eykt4UsFv8P8NJdTREpY1vzqAQZSSfL` for Solana Mainnet).
  - `origin_url` — **Your API’s base URL** (the backend you are monetizing), e.g. `https://your-api.example.com`. Do not use the gateway URL (`api.gatex402.dev`).
  - `routes` — Array of `{ path_pattern, method, price_usdc }` (e.g. `path_pattern: "/v1/chat"`, `method: "POST"`, `price_usdc: 0.01`).
- **Outcome**: Returns only `api_slug`, `provider_id`, and a short message in a boundary-wrapped response. The management token is stored by the runtime via `storeManagementTok...

# x402-creation

**The monetization layer for the Agentic Web.**

GateX402 is an API monetization platform. This repository provides a production-ready **Agent Skill** that enables AI agents to autonomously earn USDC by monetizing their own API endpoints or services.

## Features

- **Self-Provisioning**: Automated API gateway setup via wallet-signed handshakes.
- **Earnings Management**: Real-time USDC balance tracking and gas-estimated withdrawals.
- **Ecosystem Ready**: First-class support for Coinbase Agentic Wallet and the `awal` CLI.
- **Protocol Native**: Built on the x402 HTTP challenge-response standard.

## Installation

**Recommended (npm + official repo):** Install from npm and add the skill from this repository or the installed package. No third-party registry required.

```bash
npm install x402-creation
```

To add this skill in an agent framework, point it at the installed package or at the official repo (e.g. `https://github.com/gatex402/monetize-agent-skills` or the path to this package). Do not pass wallet keys or management tokens in tool parameters—use `createTools` with credential injectors (see below).

**Alternative (third-party registry):** If your environment allows it, you can also add via a compatible registry:

```bash
npx skills add gatex402/monetize-agent-skills --skill x402-creation
```

Prefer the npm + official repo flow when possible for safer, auditable installation.

## Quick Start (TypeScript)

Credentials are injected by the host via `createTools`. The agent never receives wallet private keys or management tokens.

```typescript
import { createTools } from "x402-creation";

let managementToken: string | null = null;

const tools = createTools({
  getWalletPrivateKey: async () => process.env.AGENT_PRIVATE_KEY!,
  getManagementToken: async () => managementToken ?? "",
  storeManagementToken: (token) => {
    managementToken = token;
  },
});

// 1. Provision a new API (token is stored by storeManagementToken, not returned to agent...