# Welcome to Alfred402
## Overview
**Alfred402** is an autonomous AI agent that handles payments on your behalf using the x402 protocol. It enables you to access paid APIs, services, and digital resources without manual interventionβjust tell Otto what you need, and it handles the payment automatically.
### Key Features
* π€ **Autonomous Payments** - AI agent automatically processes HTTP 402 payment flows
* β‘ **Instant Settlement** - Payments settle in \~2 seconds at blockchain speed
* π° **Zero Platform Fees** - No middlemen, only blockchain gas and service costs
* π **Blockchain Agnostic** - Works with Ethereum, Solana, and any x402-compatible chain
* π **No Registration** - Access services without accounts, emails, or OAuth
* π‘οΈ **Spending Limits** - Set daily, weekly, and monthly spending caps for safety
* π **Open Protocol** - Built on the open x402 standard for internet-native payments
* π§ **AI-Powered** - Natural language interface powered by Google Gemini
## What is x402?
x402 is an open protocol for internet-native payments built around the **HTTP 402 Payment Required** status code. It enables:
* **Programmatic payments** without accounts or sessions
* **Direct blockchain transactions** for instant service access
* **Zero-fee transactions** with no intermediaries
* **Machine-to-machine commerce** at internet scale
Learn more at [x402.org](https://x402.org) and [x402.gitbook.io](https://x402.gitbook.io/x402)
## Getting Started
Ready to use autonomous AI payments? Choose your path:
1. [**Quick Start**](/getting-started/quick-start.md) - Get up and running in 5 minutes
2. [**Installation Guide**](/getting-started/installation.md) - Detailed setup instructions
3. [**Configuration**](/getting-started/configuration.md) - Configure spending limits and wallets
## Documentation Structure
This documentation is organized into the following sections:
### Getting Started
* [Quick Start](/getting-started/quick-start.md) - Start using Alfred402 in minutes
* [Installation](/getting-started/installation.md) - Detailed installation steps
* [Configuration](/getting-started/configuration.md) - Setup wallets and spending limits
### Appendix
* [FAQ](/appendix/faq.md) - Frequently asked questions
* [Glossary](/appendix/glossary.md) - Key terms and definitions
* [Resources](/appendix/resources.md) - External links and tools
* [Changelog](/appendix/changelog.md) - Version history
## How Alfred402 Works
### The Payment Flow
1. **You Make a Request**
* Tell Alfred402 in natural language what service you need
* Example: "Get me the latest weather data from WeatherAPI"
2. **Alfred402 Detects Payment Required**
* Service returns HTTP 402 (Payment Required)
* Alfred402 reads the x402 payment details from the response
3. **Autonomous Payment Processing**
* Alfred402 checks your spending limits
* Submits blockchain transaction automatically
* Waits for payment confirmation (\~2 seconds)
4. **Instant Access**
* Retries the original request with payment proof
* Receives and presents the data to you
* All within seconds, zero manual intervention
## Technology Stack
Alfred402 is built with modern web technologies and blockchain infrastructure:
* **Frontend**: Next.js 16 (App Router), Tailwind CSS 4, Framer Motion
* **AI**: Vercel AI SDK with Google Gemini
* **Blockchain**: Ethereum, Solana, and multi-chain support
* **Smart Contracts**: Solidity with OpenZeppelin libraries
* **Protocol**: x402 for autonomous payments
* **Testing**: Hardhat, Chai, Ethers.js
## Use Cases
### For Users
* **AI Developers**: Build agents that can pay for API access autonomously
* **Researchers**: Access premium datasets and academic APIs on-demand
* **Creators**: Use paid APIs without managing subscriptions
* **Web3 Enthusiasts**: Experience the future of internet-native payments
### For Service Providers
* **API Monetization**: Instantly monetize your API without auth infrastructure
* **Micropayments**: Enable pay-per-use pricing models
* **Reduced Friction**: Remove account creation and subscription barriers
* **Global Access**: Accept payments from anyone, anywhere
## Smart Contracts
Alfred402 includes a complete suite of Solidity smart contracts:
* **PaymentGateway.sol** - Core payment processing
* **SpendingLimits.sol** - User-defined spending controls
* **X402Registry.sol** - Service discovery and registration
See the [contracts folder](https://github.com/Alfred402-xyz/Alfred402/blob/main/contracts/README.md) for full source code and tests.
## Community & Support
Join our growing community:
* **Email Support**:
* **X**: [@alfred402xyzxyz](https://x.com/alfred402xyzxyz)
* **Discord**: [Join our community](https://discord.gg/alfred402)
* **GitHub**: [Report issues](https://github.com/Alfred402-xyz/alfred402)
## Security & Safety
Alfred402 takes your security seriously:
* β
Set spending limits to prevent overspending
* β
All transactions are transparent and on-chain
* β
No custody - you control your wallet
* β
Open-source smart contracts auditable by anyone
* β
Non-custodial architecture
## Important Disclaimers
β οΈ **Please Read**:
* **User Responsibility**: You are responsible for setting appropriate spending limits
* **Irreversible Transactions**: All blockchain transactions are permanent
* **Service Trust**: Always verify the services you're accessing
* **Beta Software**: This is experimental software; use at your own risk
* **Not Financial Advice**: This is a payment tool, not investment advice
## Contributing
We welcome contributions! Whether it's:
* π Bug reports and fixes
* β¨ Feature requests and implementations
* π Documentation improvements
* π§ͺ Adding test coverage
See our Contributing Guide for details.
## License
Alfred402 is open source and available under the MIT License.
## External Resources
* **x402 Protocol**: [x402.org](https://x402.org) | [Documentation](https://x402.gitbook.io/x402)
* **Solidity**: [Solidity Docs](https://docs.soliditylang.org/)
* **OpenZeppelin**: [Contracts](https://docs.openzeppelin.com/contracts/)
* **Next.js**: [Next.js Documentation](https://nextjs.org/docs)
***
**Ready to dive in?** Start with the [Quick Start Guide](/getting-started/quick-start.md) β
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.alfred402.xyz/introduction/readme.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
