⚡Quick Start

Get Yuki402 up and running in 5 minutes flat. No manual approvals. No friction. Just pure autonomous payment magic. Let's go.

🎯 What You'll Do

By the end of this guide, you'll:

• Make your first autonomous payment request

• Watch Yuki settle transactions at light speed

• Understand the x402 payment flow

• Set up spending limits for safety

📋 What You Need

Before we start:

• ✅ Web3 Wallet - MetaMask, Phantom, or Coinbase Wallet

• ✅ Some Crypto - SOL, ETH, or any x402-compatible token

• ✅ 5 Minutes - That's literally it

Don't have a wallet? Get MetaMask (2-minute setup)

🚀 Step 1: Launch Yuki

Visit yuki402.xyz and hit that "Launch App" button.

You'll see:

• Clean chat interface ready to go

• Your personal AI payment agent (that's Yuki!)

• Zero sign-ups, zero friction

💬 Step 2: Say Hello

Let's start with a simple conversation. Type:

What x402 services can you access?

Yuki will respond with:

• Available APIs and services

• Current pricing

• Service categories (Data, AI, Storage, Web3)

This is your autonomous payment agent understanding natural language. Pretty slick, right?

🔗 Step 3: Connect Your Wallet

Click "Connect Wallet" in the top-right corner.

Choose your wallet:

• MetaMask (Most popular)

• Phantom (Solana native)

• Coinbase Wallet (User-friendly)

• WalletConnect (Mobile-friendly)

Approve the connection and you're in. Your wallet address will appear in the UI.

Pro tip: Use a dedicated wallet for autonomous payments. Never risk more than you can afford to lose while testing.

💸 Step 4: Your First Payment

Time for the magic. Let's make an autonomous payment request:

Generate an OpenWeatherMap API key

Watch Yuki work:

1. She reaches out to the OpenWeatherMap service

2. HTTP 402 detected - Payment Required status received

3. Payment details processed - 0.15 SOL required

4. You approve - Click "Approve & Pay"

5. Yuki strikes - Transaction signed and broadcast

6. 2 seconds later - Payment confirmed, API key delivered

Zero clicks between you approving and getting your API key. That's the power of autonomous payments.

⚙️ Step 5: Set Spending Limits (Critical!)

Before going wild, set spending limits for safety:

Recommended starter limits:

Daily:   0.01 SOL (~$2.50)
Weekly:  0.05 SOL (~$12.50)
Monthly: 0.2 SOL  (~$50)

How to set limits:

1. The limits are configured in your .env.local file

2. Yuki respects these limits automatically

3. She'll reject any payment that exceeds your caps

4. You can adjust anytime

Pro move: Start conservative, scale up as you get comfortable.

🔥 Understanding the Flow

Here's what just happened under the hood:

You Request → API Returns 402 → Yuki Processes Payment →
You Approve → Blockchain Confirms → Service Delivers Data

Time elapsed: 3-5 seconds total

Traditional flow with credit cards:

Sign up → Verify email → Add payment method → Subscribe →
Wait 2-3 days → Access service

Time elapsed: Days, plus ongoing subscription headaches

That's why x402 is the future.

💎 Real-World Examples

Example 1: Weather Data

Request:

Get 7-day forecast for New York from OpenWeather

Yuki's Response:

✓ Service: OpenWeather Premium
✓ Cost: 0.001 SOL
✓ Processing payment...
✓ Confirmed in 2.1 seconds
✓ Here's your forecast: [data]

Example 2: AI Image Generation

Request:

Generate an image of a sunset over mountains

Yuki's Response:

✓ Service: Heurist Mesh
✓ Cost: 0.002 SOL
✓ Payment processed
✓ Generating image...
✓ [Image displayed]

Example 3: IPFS File Storage

Request:

Pin my document to IPFS

Yuki's Response:

✓ Service: Pinata
✓ Cost: 0.001 SOL
✓ Payment confirmed
✓ IPFS Hash: Qm...
✓ Gateway URL: https://...

🎓 Pro Tips for First-Timers

Be Specific

❌ Vague: "Get me some data" ✅ Clear: "Get weather data for London from WeatherAPI"

Start Small

❌ Risky: Set 10 SOL daily limit on day one ✅ Smart: Start with 0.01 SOL, scale up gradually

Monitor Everything

• Check transaction hashes on block explorers

• Review spending against limits

• Verify services before using them

Ask Before Paying

Always ask: "How much would it cost to...?" before committing

🛡️ Stay Safe

Golden Rules:

1. Set Limits - Never skip spending caps

2. Verify Services - Only use verified x402 providers

3. Test First - Small payments before going big

4. Monitor Spending - Check your transaction history daily

5. Secure Your Wallet - Use hardware wallets for large amounts

Red Flags:

• Unverified services offering "too good to be true" pricing

• Services requesting private keys (NEVER share these!)

• Unusual blockchain fees

• Services with no documentation

❓ Common Questions

Q: Is there a platform fee? A: 0%. Yuki charges nothing. Only blockchain gas + service costs.

Q: What if payment fails? A: Your funds revert automatically. Blockchain transactions are atomic.

Q: Can I cancel a pending payment? A: Once on-chain, no. Set spending limits as protection.

Q: Which blockchains work? A: Ethereum, Solana, and any x402-compatible chain. Services specify which they accept.

Q: Are conversations private? A: Yes. No server storage. Refresh to clear history.

Q: What if I exceed my limit? A: Yuki automatically rejects the transaction. Your funds are safe.

🌊 What's Next?

Now that you've made your first payment:

Master the Basics:

• 📖 Full Installation Guide - Complete local setup

• ⚙️ Configuration - Advanced wallet and limit setup

• 💬 Using the Chat - Power user techniques

Go Deeper:

• 🏗️ How Yuki Works - Under the hood

• 🔐 Security Features - How your funds stay safe

• 💎 $YUKI Tokenomics - Hold $YUKI, pay nothing

Get Help:

• 🐛 Troubleshooting - Fix common issues

• ❓ FAQ - All your questions answered

• 📧 Support - We're here to help

🎉 Welcome to the Future

You just experienced autonomous, internet-native payments. No accounts. No subscriptions. No middlemen.

This is what web3 was supposed to be.

Yuki handles the complexity. You get instant access to premium services. Blockchain handles the trust.

It's magic, but make it crypto. ❄️

---

Ready for the full setup? Continue to the Installation Guide for local deployment →