feat: x402 bazaar

[phdargen]

Description

• Added new action to discover x402 services
• Fixed x402 fetch with payment actions for CdpSmartWalletProvider
  -> this required to bump all x402 packages and implement sign(hash) method in EvmWalletProvider::toSigner()
• Formatted token amount input/output in human readable format
• Added new network checks

Tests

Chatbot: typescript/examples/langchain-smart-wallet-chatbot/chatbot.ts
Network: Base Mainnet
Prompt: fetch x402 services, my budget is 0.1 usdc
-------------------
{
"success": true,
"walletNetwork": "base",
"total": 50,
"returned": 10,
"items": [
{
"resource": "https://true-cast-agent.vercel.app/api/trueCast",
"description": "News aggregator and fact-checking service grounded by prediction markets and real-time data sources",
"cost": "0.1 USDC on base network",
"input": {
"bodyFields": {
"castHash": {
"description": "Optional Farcaster cast hash for context-specific verification",
"type": "string"
},
"prompt": {
"description": "The statement, claim, or question to fact-check and verify",
"required": true,
"type": "string"
},
"runGuardrail": {
"description": "Whether to run AWS Bedrock Guardrails validation (default: false)",
"type": "boolean"
},
"storeToPinata": {
"description": "Whether to store the response to IPFS via Pinata (default: false)",
"type": "boolean"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
},
"output": {
"properties": {
"assessment": {
"description": "The final truth assessment of the query",
"enum": [
"TRUE",
"FALSE",
"PARTIALLY_TRUE",
"UNVERIFIABLE",
"MARKET_SENTIMENT"
],
"type": "string"
},
"confidenceScore": {
"description": "Confidence level in the assessment (0-100)",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"data_sources": {
"description": "Information from data sources used in verification",
"items": {
"properties": {
"name": {
"description": "Name of the data source",
"type": "string"
},
"prompt": {
"description": "Prompt sent to this data source",
"type": "string"
},
"reply": {
"description": "Response from this data source",
"type": "string"
},
"source": {
"description": "Source URL or identifier",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"guardrail": {
"description": "AWS Bedrock Guardrails validation results (if runGuardrail was true)",
"properties": {
"input": {
"description": "Input validation results",
"type": "object"
},
"output": {
"description": "Output validation results",
"type": "object"
}
},
"type": "object"
},
"ipfs": {
"description": "IPFS storage information (if storeToPinata was true)",
"properties": {
"gatewayUrl": {
"description": "Public gateway URL for the stored response",
"type": "string"
},
"hash": {
"description": "IPFS hash of stored response",
"type": "string"
},
"network": {
"description": "IPFS network used",
"enum": [
"public",
"private"
],
"type": "string"
},
"paymentResponse": {
"description": "Payment transaction details if x402 was used",
"properties": {
"network": {
"type": "string"
},
"payer": {
"type": "string"
},
"success": {
"type": "boolean"
},
"transaction": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"metadata": {
"properties": {
"needsExternalData": {
"description": "Whether external data was needed",
"type": "boolean"
},
"processingTimeSec": {
"description": "Time taken to process in seconds",
"type": "number"
},
"promptType": {
"description": "Categorized type of the prompt",
"type": "string"
},
"sourcesUsed": {
"description": "Names of data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"timestamp": {
"description": "ISO timestamp of processing",
"type": "string"
},
"totalSources": {
"description": "Total number of data sources queried",
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "The original user query that was processed",
"type": "string"
},
"reply": {
"description": "The fact-checked response with analysis and conclusions",
"type": "string"
}
},
"required": [
"query",
"reply",
"assessment",
"confidenceScore",
"metadata"
],
"type": "object"
}
},
{
"resource": "https://x402-tools.vercel.app/api/horoscope",
"description": "Get your daily horoscope",
"cost": "0.01 USDC on base network",
"input": {
"discoverable": true,
"method": "GET",
"queryParams": {
"date": "Today's date in format (YYYY-MM-DD)",
"sign": "Zodiac sign (options: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"
},
"type": "http"
},
"output": {
"properties": {
"horoscope": {
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://x402-demo-discovery-endpoint.vercel.app/protected",
"description": "Demo endpoint for x402 resource discovery",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://smartanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://priceagent-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://x402-hello-agent-production.up.railway.app/api/hello",
"description": "Simple Hello greeting service",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://ai-test-vnc.alchemytech.cc/x402pay",
"description": "The omnichain settlement layer that enables AI agents to seamlessly pay millions of real-world merchants across SEA, LATAM, and Africa — powered by x402 and USDC.",
"cost": "0.01 USDC on base network",
"input": {
"body_fields": null,
"body_type": null,
"discoverable": true,
"header_fields": null,
"method": "POST",
"query_params": {
"address": "Ethereum address to receive payment",
"appId": "Application ID for identifying request source",
"qrCode": "QR code data containing payment information"
},
"type": "http"
},
"output": {
"properties": {
"bankData": {
"description": "Bank information",
"properties": {
"bankAccountName": {
"description": "Bank account name",
"type": "string"
},
"bankAccountNumber": {
"description": "Bank account number",
"type": "string"
},
"bankCode": {
"description": "Bank code",
"type": "string"
},
"bankName": {
"description": "Bank name",
"type": "string"
}
},
"type": "object"
},
"createTime": {
"description": "Transaction creation time",
"type": "string"
},
"fiatExchangeRate": {
"description": "Fiat exchange rate",
"type": "string"
},
"merchantOrderNo": {
"description": "Merchant order number",
"type": "string"
},
"num": {
"description": "System order number",
"type": "string"
},
"orderAmount": {
"description": "Fiat currency amount",
"type": "string"
},
"orderCurrency": {
"description": "Order fiat currency",
"type": "string"
},
"qrCode": {
"description": "QR code",
"type": "string"
},
"status": {
"description": "Order status",
"type": "string"
},
"usdAmount": {
"description": "USD amount",
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://macrotrendsanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://agentanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://scoutpay-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
}
]
}
-------------------
> Here are some x402 services available within your budget of 0.1 USDC:
1. **[News aggregator and fact-checking service](https://true-cast-agent.vercel.app/api/trueCast)**
- **Cost:** 0.1 USDC
- **Description:** Uses prediction markets and real-time data sources for fact-checking.
- **Method:** POST
- **Input required:** Statement or claim to verify.
2. **[Get your daily horoscope](https://x402-tools.vercel.app/api/horoscope)**
- **Cost:** 0.01 USDC
- **Description:** Daily horoscope based on your zodiac sign.
- **Method:** GET
- **Input required:** Zodiac sign and today's date.
3. **[Demo endpoint for x402 resource discovery](https://x402-demo-discovery-endpoint.vercel.app/protected)**
- **Cost:** 0.001 USDC
- **Description:** A demo service.
- **Method:** GET
4. **[Professional blockchain analysis and insights](https://smartanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Provides insights on blockchain data.
- **Method:** GET
5. **[Historical cryptocurrency price data](https://priceagent-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access to historical price data.
- **Method:** GET
6. **[Simple Hello greeting service](https://x402-hello-agent-production.up.railway.app/api/hello)**
- **Cost:** 0.001 USDC
- **Description:** A simple greeting service.
- **Method:** GET
7. **[Omnichain settlement layer](https://ai-test-vnc.alchemytech.cc/x402pay)**
- **Cost:** 0.01 USDC
- **Description:** Enables payments across different platforms.
- **Method:** POST requiring payment info.
8. **[Additional Professional blockchain analysis services](https://macrotrendsanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Another analytic service for blockchain.
- **Method:** GET
9. **[Another Professional blockchain analysis service](https://agentanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Similar insights on blockchain.
- **Method:** GET
10. **[Historical cryptocurrency price data](https://scoutpay-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access historical price data.
- **Method:** GET
-------------------
Prompt: fetch https://x402-demo-discovery-endpoint.vercel.app/protected
-------------------
{"status":"error_402_payment_required","acceptablePaymentOptions":[{"scheme":"exact","network":"base","maxAmountRequired":"1000","resource":"https://x402-demo-discovery-endpoint.vercel.app/protected","description":"Demo endpoint for x402 resource discovery","mimeType":"application/json","payTo":"0x021028695EAfDDe60E139D87000a8bd6cB65645e","maxTimeoutSeconds":300,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","outputSchema":{"input":{"type":"http","method":"GET"}},"extra":{"name":"USD Coin","version":"2"}}],"nextSteps":["Inform the user that the requested server replied with a 402 Payment Required response.","The payment options are: 0.001 USDC on base network","Ask the user if they want to retry the request with payment.","Use retry_http_request_with_x402 to retry the request with payment."]}
-------------------
The requested server returned a **402 Payment Required** response. To access the demo endpoint, you will need to pay **0.001 USDC** on the Base network. Would you like to proceed with the payment to retry the request?
-------------------
Prompt: yes
-------------------
{"status":"success","data":..." ","message":"Request completed successfully with payment","details":{"url":"https://x402-demo-discovery-endpoint.vercel.app/protected","method":"GET","paymentUsed":{"network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000"},"paymentProof":{"transaction":"0x96334990c1996297d382143fa8e6fa1373489bf4a9809094c8f722d03f42286c","network":"base","payer":"0xDb48aB111ea896649547c01aaaE9166DebCe11ae"}}}
-------------------
The request to the demo endpoint was successful! Here are the details:
### Protected Content
- **Message:** Your payment was successful! Enjoy this banger song.
- **Media:** - [Listen to the track](https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/2044190296&color=%23ff5500&auto_play=true&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true).
You can enjoy the track titled "**x402 (DJ Reppel Remix)**" from the artist **danXkim**! -------------------

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

✅ Heimdall Review Status

Requirement	Status	More Info
Reviews	✅ 1/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[phdargen]

As the market place grows, might be needed to reduce amount of returned info per service and/or add pagination or additional filters

[CarsonRoscoe]

Yes, will need to add pagination in the future. We also want to add a query based search to discovery that the agents will eventually be more likely to use. But for now this is great, ty!

[phdargen]

Description

• Added new action to discover x402 services
• Fixed x402 fetch with payment actions for CdpSmartWalletProvider
  -> this required to bump all x402 packages and implement sign(hash) method in EvmWalletProvider::toSigner()
• Formatted token amount input/output in human readable format
• Added new network checks

Tests

Chatbot: typescript/examples/langchain-smart-wallet-chatbot/chatbot.ts
Network: Base Mainnet
Prompt: fetch x402 services, my budget is 0.1 usdc
-------------------
{
"success": true,
"walletNetwork": "base",
"total": 50,
"returned": 10,
"items": [
{
"resource": "https://true-cast-agent.vercel.app/api/trueCast",
"description": "News aggregator and fact-checking service grounded by prediction markets and real-time data sources",
"cost": "0.1 USDC on base network",
"input": {
"bodyFields": {
"castHash": {
"description": "Optional Farcaster cast hash for context-specific verification",
"type": "string"
},
"prompt": {
"description": "The statement, claim, or question to fact-check and verify",
"required": true,
"type": "string"
},
"runGuardrail": {
"description": "Whether to run AWS Bedrock Guardrails validation (default: false)",
"type": "boolean"
},
"storeToPinata": {
"description": "Whether to store the response to IPFS via Pinata (default: false)",
"type": "boolean"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
},
"output": {
"properties": {
"assessment": {
"description": "The final truth assessment of the query",
"enum": [
"TRUE",
"FALSE",
"PARTIALLY_TRUE",
"UNVERIFIABLE",
"MARKET_SENTIMENT"
],
"type": "string"
},
"confidenceScore": {
"description": "Confidence level in the assessment (0-100)",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"data_sources": {
"description": "Information from data sources used in verification",
"items": {
"properties": {
"name": {
"description": "Name of the data source",
"type": "string"
},
"prompt": {
"description": "Prompt sent to this data source",
"type": "string"
},
"reply": {
"description": "Response from this data source",
"type": "string"
},
"source": {
"description": "Source URL or identifier",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"guardrail": {
"description": "AWS Bedrock Guardrails validation results (if runGuardrail was true)",
"properties": {
"input": {
"description": "Input validation results",
"type": "object"
},
"output": {
"description": "Output validation results",
"type": "object"
}
},
"type": "object"
},
"ipfs": {
"description": "IPFS storage information (if storeToPinata was true)",
"properties": {
"gatewayUrl": {
"description": "Public gateway URL for the stored response",
"type": "string"
},
"hash": {
"description": "IPFS hash of stored response",
"type": "string"
},
"network": {
"description": "IPFS network used",
"enum": [
"public",
"private"
],
"type": "string"
},
"paymentResponse": {
"description": "Payment transaction details if x402 was used",
"properties": {
"network": {
"type": "string"
},
"payer": {
"type": "string"
},
"success": {
"type": "boolean"
},
"transaction": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"metadata": {
"properties": {
"needsExternalData": {
"description": "Whether external data was needed",
"type": "boolean"
},
"processingTimeSec": {
"description": "Time taken to process in seconds",
"type": "number"
},
"promptType": {
"description": "Categorized type of the prompt",
"type": "string"
},
"sourcesUsed": {
"description": "Names of data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"timestamp": {
"description": "ISO timestamp of processing",
"type": "string"
},
"totalSources": {
"description": "Total number of data sources queried",
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "The original user query that was processed",
"type": "string"
},
"reply": {
"description": "The fact-checked response with analysis and conclusions",
"type": "string"
}
},
"required": [
"query",
"reply",
"assessment",
"confidenceScore",
"metadata"
],
"type": "object"
}
},
{
"resource": "https://x402-tools.vercel.app/api/horoscope",
"description": "Get your daily horoscope",
"cost": "0.01 USDC on base network",
"input": {
"discoverable": true,
"method": "GET",
"queryParams": {
"date": "Today's date in format (YYYY-MM-DD)",
"sign": "Zodiac sign (options: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"
},
"type": "http"
},
"output": {
"properties": {
"horoscope": {
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://x402-demo-discovery-endpoint.vercel.app/protected",
"description": "Demo endpoint for x402 resource discovery",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://smartanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://priceagent-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://x402-hello-agent-production.up.railway.app/api/hello",
"description": "Simple Hello greeting service",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://ai-test-vnc.alchemytech.cc/x402pay",
"description": "The omnichain settlement layer that enables AI agents to seamlessly pay millions of real-world merchants across SEA, LATAM, and Africa — powered by x402 and USDC.",
"cost": "0.01 USDC on base network",
"input": {
"body_fields": null,
"body_type": null,
"discoverable": true,
"header_fields": null,
"method": "POST",
"query_params": {
"address": "Ethereum address to receive payment",
"appId": "Application ID for identifying request source",
"qrCode": "QR code data containing payment information"
},
"type": "http"
},
"output": {
"properties": {
"bankData": {
"description": "Bank information",
"properties": {
"bankAccountName": {
"description": "Bank account name",
"type": "string"
},
"bankAccountNumber": {
"description": "Bank account number",
"type": "string"
},
"bankCode": {
"description": "Bank code",
"type": "string"
},
"bankName": {
"description": "Bank name",
"type": "string"
}
},
"type": "object"
},
"createTime": {
"description": "Transaction creation time",
"type": "string"
},
"fiatExchangeRate": {
"description": "Fiat exchange rate",
"type": "string"
},
"merchantOrderNo": {
"description": "Merchant order number",
"type": "string"
},
"num": {
"description": "System order number",
"type": "string"
},
"orderAmount": {
"description": "Fiat currency amount",
"type": "string"
},
"orderCurrency": {
"description": "Order fiat currency",
"type": "string"
},
"qrCode": {
"description": "QR code",
"type": "string"
},
"status": {
"description": "Order status",
"type": "string"
},
"usdAmount": {
"description": "USD amount",
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://macrotrendsanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://agentanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://scoutpay-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
}
]
}
-------------------
> Here are some x402 services available within your budget of 0.1 USDC:
1. **[News aggregator and fact-checking service](https://true-cast-agent.vercel.app/api/trueCast)**
- **Cost:** 0.1 USDC
- **Description:** Uses prediction markets and real-time data sources for fact-checking.
- **Method:** POST
- **Input required:** Statement or claim to verify.
2. **[Get your daily horoscope](https://x402-tools.vercel.app/api/horoscope)**
- **Cost:** 0.01 USDC
- **Description:** Daily horoscope based on your zodiac sign.
- **Method:** GET
- **Input required:** Zodiac sign and today's date.
3. **[Demo endpoint for x402 resource discovery](https://x402-demo-discovery-endpoint.vercel.app/protected)**
- **Cost:** 0.001 USDC
- **Description:** A demo service.
- **Method:** GET
4. **[Professional blockchain analysis and insights](https://smartanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Provides insights on blockchain data.
- **Method:** GET
5. **[Historical cryptocurrency price data](https://priceagent-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access to historical price data.
- **Method:** GET
6. **[Simple Hello greeting service](https://x402-hello-agent-production.up.railway.app/api/hello)**
- **Cost:** 0.001 USDC
- **Description:** A simple greeting service.
- **Method:** GET
7. **[Omnichain settlement layer](https://ai-test-vnc.alchemytech.cc/x402pay)**
- **Cost:** 0.01 USDC
- **Description:** Enables payments across different platforms.
- **Method:** POST requiring payment info.
8. **[Additional Professional blockchain analysis services](https://macrotrendsanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Another analytic service for blockchain.
- **Method:** GET
9. **[Another Professional blockchain analysis service](https://agentanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Similar insights on blockchain.
- **Method:** GET
10. **[Historical cryptocurrency price data](https://scoutpay-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access historical price data.
- **Method:** GET
-------------------
Prompt: fetch https://x402-demo-discovery-endpoint.vercel.app/protected
-------------------
{"status":"error_402_payment_required","acceptablePaymentOptions":[{"scheme":"exact","network":"base","maxAmountRequired":"1000","resource":"https://x402-demo-discovery-endpoint.vercel.app/protected","description":"Demo endpoint for x402 resource discovery","mimeType":"application/json","payTo":"0x021028695EAfDDe60E139D87000a8bd6cB65645e","maxTimeoutSeconds":300,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","outputSchema":{"input":{"type":"http","method":"GET"}},"extra":{"name":"USD Coin","version":"2"}}],"nextSteps":["Inform the user that the requested server replied with a 402 Payment Required response.","The payment options are: 0.001 USDC on base network","Ask the user if they want to retry the request with payment.","Use retry_http_request_with_x402 to retry the request with payment."]}
-------------------
The requested server returned a **402 Payment Required** response. To access the demo endpoint, you will need to pay **0.001 USDC** on the Base network. Would you like to proceed with the payment to retry the request?
-------------------
Prompt: yes
-------------------
{"status":"success","data":..." ","message":"Request completed successfully with payment","details":{"url":"https://x402-demo-discovery-endpoint.vercel.app/protected","method":"GET","paymentUsed":{"network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000"},"paymentProof":{"transaction":"0x96334990c1996297d382143fa8e6fa1373489bf4a9809094c8f722d03f42286c","network":"base","payer":"0xDb48aB111ea896649547c01aaaE9166DebCe11ae"}}}
-------------------
The request to the demo endpoint was successful! Here are the details:
### Protected Content
- **Message:** Your payment was successful! Enjoy this banger song.
- **Media:** - [Listen to the track](https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/2044190296&color=%23ff5500&auto_play=true&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true).
You can enjoy the track titled "**x402 (DJ Reppel Remix)**" from the artist **danXkim**! -------------------

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

✅ Heimdall Review Status

Requirement	Status	More Info
Reviews	✅ 1/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[phdargen]

As the market place grows, might be needed to reduce amount of returned info per service and/or add pagination or additional filters

[CarsonRoscoe]

Yes, will need to add pagination in the future. We also want to add a query based search to discovery that the agents will eventually be more likely to use. But for now this is great, ty!

[phdargen]

Description

• Added new action to discover x402 services
• Fixed x402 fetch with payment actions for CdpSmartWalletProvider
  -> this required to bump all x402 packages and implement sign(hash) method in EvmWalletProvider::toSigner()
• Formatted token amount input/output in human readable format
• Added new network checks

Tests

Chatbot: typescript/examples/langchain-smart-wallet-chatbot/chatbot.ts
Network: Base Mainnet
Prompt: fetch x402 services, my budget is 0.1 usdc
-------------------
{
"success": true,
"walletNetwork": "base",
"total": 50,
"returned": 10,
"items": [
{
"resource": "https://true-cast-agent.vercel.app/api/trueCast",
"description": "News aggregator and fact-checking service grounded by prediction markets and real-time data sources",
"cost": "0.1 USDC on base network",
"input": {
"bodyFields": {
"castHash": {
"description": "Optional Farcaster cast hash for context-specific verification",
"type": "string"
},
"prompt": {
"description": "The statement, claim, or question to fact-check and verify",
"required": true,
"type": "string"
},
"runGuardrail": {
"description": "Whether to run AWS Bedrock Guardrails validation (default: false)",
"type": "boolean"
},
"storeToPinata": {
"description": "Whether to store the response to IPFS via Pinata (default: false)",
"type": "boolean"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
},
"output": {
"properties": {
"assessment": {
"description": "The final truth assessment of the query",
"enum": [
"TRUE",
"FALSE",
"PARTIALLY_TRUE",
"UNVERIFIABLE",
"MARKET_SENTIMENT"
],
"type": "string"
},
"confidenceScore": {
"description": "Confidence level in the assessment (0-100)",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"data_sources": {
"description": "Information from data sources used in verification",
"items": {
"properties": {
"name": {
"description": "Name of the data source",
"type": "string"
},
"prompt": {
"description": "Prompt sent to this data source",
"type": "string"
},
"reply": {
"description": "Response from this data source",
"type": "string"
},
"source": {
"description": "Source URL or identifier",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"guardrail": {
"description": "AWS Bedrock Guardrails validation results (if runGuardrail was true)",
"properties": {
"input": {
"description": "Input validation results",
"type": "object"
},
"output": {
"description": "Output validation results",
"type": "object"
}
},
"type": "object"
},
"ipfs": {
"description": "IPFS storage information (if storeToPinata was true)",
"properties": {
"gatewayUrl": {
"description": "Public gateway URL for the stored response",
"type": "string"
},
"hash": {
"description": "IPFS hash of stored response",
"type": "string"
},
"network": {
"description": "IPFS network used",
"enum": [
"public",
"private"
],
"type": "string"
},
"paymentResponse": {
"description": "Payment transaction details if x402 was used",
"properties": {
"network": {
"type": "string"
},
"payer": {
"type": "string"
},
"success": {
"type": "boolean"
},
"transaction": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"metadata": {
"properties": {
"needsExternalData": {
"description": "Whether external data was needed",
"type": "boolean"
},
"processingTimeSec": {
"description": "Time taken to process in seconds",
"type": "number"
},
"promptType": {
"description": "Categorized type of the prompt",
"type": "string"
},
"sourcesUsed": {
"description": "Names of data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"timestamp": {
"description": "ISO timestamp of processing",
"type": "string"
},
"totalSources": {
"description": "Total number of data sources queried",
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "The original user query that was processed",
"type": "string"
},
"reply": {
"description": "The fact-checked response with analysis and conclusions",
"type": "string"
}
},
"required": [
"query",
"reply",
"assessment",
"confidenceScore",
"metadata"
],
"type": "object"
}
},
{
"resource": "https://x402-tools.vercel.app/api/horoscope",
"description": "Get your daily horoscope",
"cost": "0.01 USDC on base network",
"input": {
"discoverable": true,
"method": "GET",
"queryParams": {
"date": "Today's date in format (YYYY-MM-DD)",
"sign": "Zodiac sign (options: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"
},
"type": "http"
},
"output": {
"properties": {
"horoscope": {
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://x402-demo-discovery-endpoint.vercel.app/protected",
"description": "Demo endpoint for x402 resource discovery",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://smartanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://priceagent-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://x402-hello-agent-production.up.railway.app/api/hello",
"description": "Simple Hello greeting service",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://ai-test-vnc.alchemytech.cc/x402pay",
"description": "The omnichain settlement layer that enables AI agents to seamlessly pay millions of real-world merchants across SEA, LATAM, and Africa — powered by x402 and USDC.",
"cost": "0.01 USDC on base network",
"input": {
"body_fields": null,
"body_type": null,
"discoverable": true,
"header_fields": null,
"method": "POST",
"query_params": {
"address": "Ethereum address to receive payment",
"appId": "Application ID for identifying request source",
"qrCode": "QR code data containing payment information"
},
"type": "http"
},
"output": {
"properties": {
"bankData": {
"description": "Bank information",
"properties": {
"bankAccountName": {
"description": "Bank account name",
"type": "string"
},
"bankAccountNumber": {
"description": "Bank account number",
"type": "string"
},
"bankCode": {
"description": "Bank code",
"type": "string"
},
"bankName": {
"description": "Bank name",
"type": "string"
}
},
"type": "object"
},
"createTime": {
"description": "Transaction creation time",
"type": "string"
},
"fiatExchangeRate": {
"description": "Fiat exchange rate",
"type": "string"
},
"merchantOrderNo": {
"description": "Merchant order number",
"type": "string"
},
"num": {
"description": "System order number",
"type": "string"
},
"orderAmount": {
"description": "Fiat currency amount",
"type": "string"
},
"orderCurrency": {
"description": "Order fiat currency",
"type": "string"
},
"qrCode": {
"description": "QR code",
"type": "string"
},
"status": {
"description": "Order status",
"type": "string"
},
"usdAmount": {
"description": "USD amount",
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://macrotrendsanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://agentanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://scoutpay-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
}
]
}
-------------------
> Here are some x402 services available within your budget of 0.1 USDC:
1. **[News aggregator and fact-checking service](https://true-cast-agent.vercel.app/api/trueCast)**
- **Cost:** 0.1 USDC
- **Description:** Uses prediction markets and real-time data sources for fact-checking.
- **Method:** POST
- **Input required:** Statement or claim to verify.
2. **[Get your daily horoscope](https://x402-tools.vercel.app/api/horoscope)**
- **Cost:** 0.01 USDC
- **Description:** Daily horoscope based on your zodiac sign.
- **Method:** GET
- **Input required:** Zodiac sign and today's date.
3. **[Demo endpoint for x402 resource discovery](https://x402-demo-discovery-endpoint.vercel.app/protected)**
- **Cost:** 0.001 USDC
- **Description:** A demo service.
- **Method:** GET
4. **[Professional blockchain analysis and insights](https://smartanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Provides insights on blockchain data.
- **Method:** GET
5. **[Historical cryptocurrency price data](https://priceagent-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access to historical price data.
- **Method:** GET
6. **[Simple Hello greeting service](https://x402-hello-agent-production.up.railway.app/api/hello)**
- **Cost:** 0.001 USDC
- **Description:** A simple greeting service.
- **Method:** GET
7. **[Omnichain settlement layer](https://ai-test-vnc.alchemytech.cc/x402pay)**
- **Cost:** 0.01 USDC
- **Description:** Enables payments across different platforms.
- **Method:** POST requiring payment info.
8. **[Additional Professional blockchain analysis services](https://macrotrendsanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Another analytic service for blockchain.
- **Method:** GET
9. **[Another Professional blockchain analysis service](https://agentanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Similar insights on blockchain.
- **Method:** GET
10. **[Historical cryptocurrency price data](https://scoutpay-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access historical price data.
- **Method:** GET
-------------------
Prompt: fetch https://x402-demo-discovery-endpoint.vercel.app/protected
-------------------
{"status":"error_402_payment_required","acceptablePaymentOptions":[{"scheme":"exact","network":"base","maxAmountRequired":"1000","resource":"https://x402-demo-discovery-endpoint.vercel.app/protected","description":"Demo endpoint for x402 resource discovery","mimeType":"application/json","payTo":"0x021028695EAfDDe60E139D87000a8bd6cB65645e","maxTimeoutSeconds":300,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","outputSchema":{"input":{"type":"http","method":"GET"}},"extra":{"name":"USD Coin","version":"2"}}],"nextSteps":["Inform the user that the requested server replied with a 402 Payment Required response.","The payment options are: 0.001 USDC on base network","Ask the user if they want to retry the request with payment.","Use retry_http_request_with_x402 to retry the request with payment."]}
-------------------
The requested server returned a **402 Payment Required** response. To access the demo endpoint, you will need to pay **0.001 USDC** on the Base network. Would you like to proceed with the payment to retry the request?
-------------------
Prompt: yes
-------------------
{"status":"success","data":..." ","message":"Request completed successfully with payment","details":{"url":"https://x402-demo-discovery-endpoint.vercel.app/protected","method":"GET","paymentUsed":{"network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000"},"paymentProof":{"transaction":"0x96334990c1996297d382143fa8e6fa1373489bf4a9809094c8f722d03f42286c","network":"base","payer":"0xDb48aB111ea896649547c01aaaE9166DebCe11ae"}}}
-------------------
The request to the demo endpoint was successful! Here are the details:
### Protected Content
- **Message:** Your payment was successful! Enjoy this banger song.
- **Media:** - [Listen to the track](https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/2044190296&color=%23ff5500&auto_play=true&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true).
You can enjoy the track titled "**x402 (DJ Reppel Remix)**" from the artist **danXkim**! -------------------

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

✅ Heimdall Review Status

Requirement	Status	More Info
Reviews	✅ 1/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[phdargen]

As the market place grows, might be needed to reduce amount of returned info per service and/or add pagination or additional filters

[CarsonRoscoe]

Yes, will need to add pagination in the future. We also want to add a query based search to discovery that the agents will eventually be more likely to use. But for now this is great, ty!

[phdargen]

Description

• Added new action to discover x402 services
• Fixed x402 fetch with payment actions for CdpSmartWalletProvider
  -> this required to bump all x402 packages and implement sign(hash) method in EvmWalletProvider::toSigner()
• Formatted token amount input/output in human readable format
• Added new network checks

Tests

Chatbot: typescript/examples/langchain-smart-wallet-chatbot/chatbot.ts
Network: Base Mainnet
Prompt: fetch x402 services, my budget is 0.1 usdc
-------------------
{
"success": true,
"walletNetwork": "base",
"total": 50,
"returned": 10,
"items": [
{
"resource": "https://true-cast-agent.vercel.app/api/trueCast",
"description": "News aggregator and fact-checking service grounded by prediction markets and real-time data sources",
"cost": "0.1 USDC on base network",
"input": {
"bodyFields": {
"castHash": {
"description": "Optional Farcaster cast hash for context-specific verification",
"type": "string"
},
"prompt": {
"description": "The statement, claim, or question to fact-check and verify",
"required": true,
"type": "string"
},
"runGuardrail": {
"description": "Whether to run AWS Bedrock Guardrails validation (default: false)",
"type": "boolean"
},
"storeToPinata": {
"description": "Whether to store the response to IPFS via Pinata (default: false)",
"type": "boolean"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
},
"output": {
"properties": {
"assessment": {
"description": "The final truth assessment of the query",
"enum": [
"TRUE",
"FALSE",
"PARTIALLY_TRUE",
"UNVERIFIABLE",
"MARKET_SENTIMENT"
],
"type": "string"
},
"confidenceScore": {
"description": "Confidence level in the assessment (0-100)",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"data_sources": {
"description": "Information from data sources used in verification",
"items": {
"properties": {
"name": {
"description": "Name of the data source",
"type": "string"
},
"prompt": {
"description": "Prompt sent to this data source",
"type": "string"
},
"reply": {
"description": "Response from this data source",
"type": "string"
},
"source": {
"description": "Source URL or identifier",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"guardrail": {
"description": "AWS Bedrock Guardrails validation results (if runGuardrail was true)",
"properties": {
"input": {
"description": "Input validation results",
"type": "object"
},
"output": {
"description": "Output validation results",
"type": "object"
}
},
"type": "object"
},
"ipfs": {
"description": "IPFS storage information (if storeToPinata was true)",
"properties": {
"gatewayUrl": {
"description": "Public gateway URL for the stored response",
"type": "string"
},
"hash": {
"description": "IPFS hash of stored response",
"type": "string"
},
"network": {
"description": "IPFS network used",
"enum": [
"public",
"private"
],
"type": "string"
},
"paymentResponse": {
"description": "Payment transaction details if x402 was used",
"properties": {
"network": {
"type": "string"
},
"payer": {
"type": "string"
},
"success": {
"type": "boolean"
},
"transaction": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"metadata": {
"properties": {
"needsExternalData": {
"description": "Whether external data was needed",
"type": "boolean"
},
"processingTimeSec": {
"description": "Time taken to process in seconds",
"type": "number"
},
"promptType": {
"description": "Categorized type of the prompt",
"type": "string"
},
"sourcesUsed": {
"description": "Names of data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"timestamp": {
"description": "ISO timestamp of processing",
"type": "string"
},
"totalSources": {
"description": "Total number of data sources queried",
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "The original user query that was processed",
"type": "string"
},
"reply": {
"description": "The fact-checked response with analysis and conclusions",
"type": "string"
}
},
"required": [
"query",
"reply",
"assessment",
"confidenceScore",
"metadata"
],
"type": "object"
}
},
{
"resource": "https://x402-tools.vercel.app/api/horoscope",
"description": "Get your daily horoscope",
"cost": "0.01 USDC on base network",
"input": {
"discoverable": true,
"method": "GET",
"queryParams": {
"date": "Today's date in format (YYYY-MM-DD)",
"sign": "Zodiac sign (options: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"
},
"type": "http"
},
"output": {
"properties": {
"horoscope": {
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://x402-demo-discovery-endpoint.vercel.app/protected",
"description": "Demo endpoint for x402 resource discovery",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://smartanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://priceagent-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://x402-hello-agent-production.up.railway.app/api/hello",
"description": "Simple Hello greeting service",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://ai-test-vnc.alchemytech.cc/x402pay",
"description": "The omnichain settlement layer that enables AI agents to seamlessly pay millions of real-world merchants across SEA, LATAM, and Africa — powered by x402 and USDC.",
"cost": "0.01 USDC on base network",
"input": {
"body_fields": null,
"body_type": null,
"discoverable": true,
"header_fields": null,
"method": "POST",
"query_params": {
"address": "Ethereum address to receive payment",
"appId": "Application ID for identifying request source",
"qrCode": "QR code data containing payment information"
},
"type": "http"
},
"output": {
"properties": {
"bankData": {
"description": "Bank information",
"properties": {
"bankAccountName": {
"description": "Bank account name",
"type": "string"
},
"bankAccountNumber": {
"description": "Bank account number",
"type": "string"
},
"bankCode": {
"description": "Bank code",
"type": "string"
},
"bankName": {
"description": "Bank name",
"type": "string"
}
},
"type": "object"
},
"createTime": {
"description": "Transaction creation time",
"type": "string"
},
"fiatExchangeRate": {
"description": "Fiat exchange rate",
"type": "string"
},
"merchantOrderNo": {
"description": "Merchant order number",
"type": "string"
},
"num": {
"description": "System order number",
"type": "string"
},
"orderAmount": {
"description": "Fiat currency amount",
"type": "string"
},
"orderCurrency": {
"description": "Order fiat currency",
"type": "string"
},
"qrCode": {
"description": "QR code",
"type": "string"
},
"status": {
"description": "Order status",
"type": "string"
},
"usdAmount": {
"description": "USD amount",
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://macrotrendsanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://agentanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://scoutpay-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
}
]
}
-------------------
> Here are some x402 services available within your budget of 0.1 USDC:
1. **[News aggregator and fact-checking service](https://true-cast-agent.vercel.app/api/trueCast)**
- **Cost:** 0.1 USDC
- **Description:** Uses prediction markets and real-time data sources for fact-checking.
- **Method:** POST
- **Input required:** Statement or claim to verify.
2. **[Get your daily horoscope](https://x402-tools.vercel.app/api/horoscope)**
- **Cost:** 0.01 USDC
- **Description:** Daily horoscope based on your zodiac sign.
- **Method:** GET
- **Input required:** Zodiac sign and today's date.
3. **[Demo endpoint for x402 resource discovery](https://x402-demo-discovery-endpoint.vercel.app/protected)**
- **Cost:** 0.001 USDC
- **Description:** A demo service.
- **Method:** GET
4. **[Professional blockchain analysis and insights](https://smartanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Provides insights on blockchain data.
- **Method:** GET
5. **[Historical cryptocurrency price data](https://priceagent-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access to historical price data.
- **Method:** GET
6. **[Simple Hello greeting service](https://x402-hello-agent-production.up.railway.app/api/hello)**
- **Cost:** 0.001 USDC
- **Description:** A simple greeting service.
- **Method:** GET
7. **[Omnichain settlement layer](https://ai-test-vnc.alchemytech.cc/x402pay)**
- **Cost:** 0.01 USDC
- **Description:** Enables payments across different platforms.
- **Method:** POST requiring payment info.
8. **[Additional Professional blockchain analysis services](https://macrotrendsanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Another analytic service for blockchain.
- **Method:** GET
9. **[Another Professional blockchain analysis service](https://agentanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Similar insights on blockchain.
- **Method:** GET
10. **[Historical cryptocurrency price data](https://scoutpay-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access historical price data.
- **Method:** GET
-------------------
Prompt: fetch https://x402-demo-discovery-endpoint.vercel.app/protected
-------------------
{"status":"error_402_payment_required","acceptablePaymentOptions":[{"scheme":"exact","network":"base","maxAmountRequired":"1000","resource":"https://x402-demo-discovery-endpoint.vercel.app/protected","description":"Demo endpoint for x402 resource discovery","mimeType":"application/json","payTo":"0x021028695EAfDDe60E139D87000a8bd6cB65645e","maxTimeoutSeconds":300,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","outputSchema":{"input":{"type":"http","method":"GET"}},"extra":{"name":"USD Coin","version":"2"}}],"nextSteps":["Inform the user that the requested server replied with a 402 Payment Required response.","The payment options are: 0.001 USDC on base network","Ask the user if they want to retry the request with payment.","Use retry_http_request_with_x402 to retry the request with payment."]}
-------------------
The requested server returned a **402 Payment Required** response. To access the demo endpoint, you will need to pay **0.001 USDC** on the Base network. Would you like to proceed with the payment to retry the request?
-------------------
Prompt: yes
-------------------
{"status":"success","data":..." ","message":"Request completed successfully with payment","details":{"url":"https://x402-demo-discovery-endpoint.vercel.app/protected","method":"GET","paymentUsed":{"network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000"},"paymentProof":{"transaction":"0x96334990c1996297d382143fa8e6fa1373489bf4a9809094c8f722d03f42286c","network":"base","payer":"0xDb48aB111ea896649547c01aaaE9166DebCe11ae"}}}
-------------------
The request to the demo endpoint was successful! Here are the details:
### Protected Content
- **Message:** Your payment was successful! Enjoy this banger song.
- **Media:** - [Listen to the track](https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/2044190296&color=%23ff5500&auto_play=true&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true).
You can enjoy the track titled "**x402 (DJ Reppel Remix)**" from the artist **danXkim**! -------------------

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

✅ Heimdall Review Status

Requirement	Status	More Info
Reviews	✅ 1/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[phdargen]

As the market place grows, might be needed to reduce amount of returned info per service and/or add pagination or additional filters

[CarsonRoscoe]

Yes, will need to add pagination in the future. We also want to add a query based search to discovery that the agents will eventually be more likely to use. But for now this is great, ty!

[phdargen]

Description

• Added new action to discover x402 services
• Fixed x402 fetch with payment actions for CdpSmartWalletProvider
  -> this required to bump all x402 packages and implement sign(hash) method in EvmWalletProvider::toSigner()
• Formatted token amount input/output in human readable format
• Added new network checks

Tests

Chatbot: typescript/examples/langchain-smart-wallet-chatbot/chatbot.ts
Network: Base Mainnet
Prompt: fetch x402 services, my budget is 0.1 usdc
-------------------
{
"success": true,
"walletNetwork": "base",
"total": 50,
"returned": 10,
"items": [
{
"resource": "https://true-cast-agent.vercel.app/api/trueCast",
"description": "News aggregator and fact-checking service grounded by prediction markets and real-time data sources",
"cost": "0.1 USDC on base network",
"input": {
"bodyFields": {
"castHash": {
"description": "Optional Farcaster cast hash for context-specific verification",
"type": "string"
},
"prompt": {
"description": "The statement, claim, or question to fact-check and verify",
"required": true,
"type": "string"
},
"runGuardrail": {
"description": "Whether to run AWS Bedrock Guardrails validation (default: false)",
"type": "boolean"
},
"storeToPinata": {
"description": "Whether to store the response to IPFS via Pinata (default: false)",
"type": "boolean"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
},
"output": {
"properties": {
"assessment": {
"description": "The final truth assessment of the query",
"enum": [
"TRUE",
"FALSE",
"PARTIALLY_TRUE",
"UNVERIFIABLE",
"MARKET_SENTIMENT"
],
"type": "string"
},
"confidenceScore": {
"description": "Confidence level in the assessment (0-100)",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"data_sources": {
"description": "Information from data sources used in verification",
"items": {
"properties": {
"name": {
"description": "Name of the data source",
"type": "string"
},
"prompt": {
"description": "Prompt sent to this data source",
"type": "string"
},
"reply": {
"description": "Response from this data source",
"type": "string"
},
"source": {
"description": "Source URL or identifier",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"guardrail": {
"description": "AWS Bedrock Guardrails validation results (if runGuardrail was true)",
"properties": {
"input": {
"description": "Input validation results",
"type": "object"
},
"output": {
"description": "Output validation results",
"type": "object"
}
},
"type": "object"
},
"ipfs": {
"description": "IPFS storage information (if storeToPinata was true)",
"properties": {
"gatewayUrl": {
"description": "Public gateway URL for the stored response",
"type": "string"
},
"hash": {
"description": "IPFS hash of stored response",
"type": "string"
},
"network": {
"description": "IPFS network used",
"enum": [
"public",
"private"
],
"type": "string"
},
"paymentResponse": {
"description": "Payment transaction details if x402 was used",
"properties": {
"network": {
"type": "string"
},
"payer": {
"type": "string"
},
"success": {
"type": "boolean"
},
"transaction": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"metadata": {
"properties": {
"needsExternalData": {
"description": "Whether external data was needed",
"type": "boolean"
},
"processingTimeSec": {
"description": "Time taken to process in seconds",
"type": "number"
},
"promptType": {
"description": "Categorized type of the prompt",
"type": "string"
},
"sourcesUsed": {
"description": "Names of data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"timestamp": {
"description": "ISO timestamp of processing",
"type": "string"
},
"totalSources": {
"description": "Total number of data sources queried",
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "The original user query that was processed",
"type": "string"
},
"reply": {
"description": "The fact-checked response with analysis and conclusions",
"type": "string"
}
},
"required": [
"query",
"reply",
"assessment",
"confidenceScore",
"metadata"
],
"type": "object"
}
},
{
"resource": "https://x402-tools.vercel.app/api/horoscope",
"description": "Get your daily horoscope",
"cost": "0.01 USDC on base network",
"input": {
"discoverable": true,
"method": "GET",
"queryParams": {
"date": "Today's date in format (YYYY-MM-DD)",
"sign": "Zodiac sign (options: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"
},
"type": "http"
},
"output": {
"properties": {
"horoscope": {
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://x402-demo-discovery-endpoint.vercel.app/protected",
"description": "Demo endpoint for x402 resource discovery",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://smartanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://priceagent-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://x402-hello-agent-production.up.railway.app/api/hello",
"description": "Simple Hello greeting service",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://ai-test-vnc.alchemytech.cc/x402pay",
"description": "The omnichain settlement layer that enables AI agents to seamlessly pay millions of real-world merchants across SEA, LATAM, and Africa — powered by x402 and USDC.",
"cost": "0.01 USDC on base network",
"input": {
"body_fields": null,
"body_type": null,
"discoverable": true,
"header_fields": null,
"method": "POST",
"query_params": {
"address": "Ethereum address to receive payment",
"appId": "Application ID for identifying request source",
"qrCode": "QR code data containing payment information"
},
"type": "http"
},
"output": {
"properties": {
"bankData": {
"description": "Bank information",
"properties": {
"bankAccountName": {
"description": "Bank account name",
"type": "string"
},
"bankAccountNumber": {
"description": "Bank account number",
"type": "string"
},
"bankCode": {
"description": "Bank code",
"type": "string"
},
"bankName": {
"description": "Bank name",
"type": "string"
}
},
"type": "object"
},
"createTime": {
"description": "Transaction creation time",
"type": "string"
},
"fiatExchangeRate": {
"description": "Fiat exchange rate",
"type": "string"
},
"merchantOrderNo": {
"description": "Merchant order number",
"type": "string"
},
"num": {
"description": "System order number",
"type": "string"
},
"orderAmount": {
"description": "Fiat currency amount",
"type": "string"
},
"orderCurrency": {
"description": "Order fiat currency",
"type": "string"
},
"qrCode": {
"description": "QR code",
"type": "string"
},
"status": {
"description": "Order status",
"type": "string"
},
"usdAmount": {
"description": "USD amount",
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://macrotrendsanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://agentanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://scoutpay-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
}
]
}
-------------------
> Here are some x402 services available within your budget of 0.1 USDC:
1. **[News aggregator and fact-checking service](https://true-cast-agent.vercel.app/api/trueCast)**
- **Cost:** 0.1 USDC
- **Description:** Uses prediction markets and real-time data sources for fact-checking.
- **Method:** POST
- **Input required:** Statement or claim to verify.
2. **[Get your daily horoscope](https://x402-tools.vercel.app/api/horoscope)**
- **Cost:** 0.01 USDC
- **Description:** Daily horoscope based on your zodiac sign.
- **Method:** GET
- **Input required:** Zodiac sign and today's date.
3. **[Demo endpoint for x402 resource discovery](https://x402-demo-discovery-endpoint.vercel.app/protected)**
- **Cost:** 0.001 USDC
- **Description:** A demo service.
- **Method:** GET
4. **[Professional blockchain analysis and insights](https://smartanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Provides insights on blockchain data.
- **Method:** GET
5. **[Historical cryptocurrency price data](https://priceagent-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access to historical price data.
- **Method:** GET
6. **[Simple Hello greeting service](https://x402-hello-agent-production.up.railway.app/api/hello)**
- **Cost:** 0.001 USDC
- **Description:** A simple greeting service.
- **Method:** GET
7. **[Omnichain settlement layer](https://ai-test-vnc.alchemytech.cc/x402pay)**
- **Cost:** 0.01 USDC
- **Description:** Enables payments across different platforms.
- **Method:** POST requiring payment info.
8. **[Additional Professional blockchain analysis services](https://macrotrendsanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Another analytic service for blockchain.
- **Method:** GET
9. **[Another Professional blockchain analysis service](https://agentanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Similar insights on blockchain.
- **Method:** GET
10. **[Historical cryptocurrency price data](https://scoutpay-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access historical price data.
- **Method:** GET
-------------------
Prompt: fetch https://x402-demo-discovery-endpoint.vercel.app/protected
-------------------
{"status":"error_402_payment_required","acceptablePaymentOptions":[{"scheme":"exact","network":"base","maxAmountRequired":"1000","resource":"https://x402-demo-discovery-endpoint.vercel.app/protected","description":"Demo endpoint for x402 resource discovery","mimeType":"application/json","payTo":"0x021028695EAfDDe60E139D87000a8bd6cB65645e","maxTimeoutSeconds":300,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","outputSchema":{"input":{"type":"http","method":"GET"}},"extra":{"name":"USD Coin","version":"2"}}],"nextSteps":["Inform the user that the requested server replied with a 402 Payment Required response.","The payment options are: 0.001 USDC on base network","Ask the user if they want to retry the request with payment.","Use retry_http_request_with_x402 to retry the request with payment."]}
-------------------
The requested server returned a **402 Payment Required** response. To access the demo endpoint, you will need to pay **0.001 USDC** on the Base network. Would you like to proceed with the payment to retry the request?
-------------------
Prompt: yes
-------------------
{"status":"success","data":..." ","message":"Request completed successfully with payment","details":{"url":"https://x402-demo-discovery-endpoint.vercel.app/protected","method":"GET","paymentUsed":{"network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000"},"paymentProof":{"transaction":"0x96334990c1996297d382143fa8e6fa1373489bf4a9809094c8f722d03f42286c","network":"base","payer":"0xDb48aB111ea896649547c01aaaE9166DebCe11ae"}}}
-------------------
The request to the demo endpoint was successful! Here are the details:
### Protected Content
- **Message:** Your payment was successful! Enjoy this banger song.
- **Media:** - [Listen to the track](https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/2044190296&color=%23ff5500&auto_play=true&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true).
You can enjoy the track titled "**x402 (DJ Reppel Remix)**" from the artist **danXkim**! -------------------

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

✅ Heimdall Review Status

Requirement	Status	More Info
Reviews	✅ 1/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[phdargen]

As the market place grows, might be needed to reduce amount of returned info per service and/or add pagination or additional filters

[CarsonRoscoe]

Yes, will need to add pagination in the future. We also want to add a query based search to discovery that the agents will eventually be more likely to use. But for now this is great, ty!

[phdargen]

Description

• Added new action to discover x402 services
• Fixed x402 fetch with payment actions for CdpSmartWalletProvider
  -> this required to bump all x402 packages and implement sign(hash) method in EvmWalletProvider::toSigner()
• Formatted token amount input/output in human readable format
• Added new network checks

Tests

Chatbot: typescript/examples/langchain-smart-wallet-chatbot/chatbot.ts
Network: Base Mainnet
Prompt: fetch x402 services, my budget is 0.1 usdc
-------------------
{
"success": true,
"walletNetwork": "base",
"total": 50,
"returned": 10,
"items": [
{
"resource": "https://true-cast-agent.vercel.app/api/trueCast",
"description": "News aggregator and fact-checking service grounded by prediction markets and real-time data sources",
"cost": "0.1 USDC on base network",
"input": {
"bodyFields": {
"castHash": {
"description": "Optional Farcaster cast hash for context-specific verification",
"type": "string"
},
"prompt": {
"description": "The statement, claim, or question to fact-check and verify",
"required": true,
"type": "string"
},
"runGuardrail": {
"description": "Whether to run AWS Bedrock Guardrails validation (default: false)",
"type": "boolean"
},
"storeToPinata": {
"description": "Whether to store the response to IPFS via Pinata (default: false)",
"type": "boolean"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
},
"output": {
"properties": {
"assessment": {
"description": "The final truth assessment of the query",
"enum": [
"TRUE",
"FALSE",
"PARTIALLY_TRUE",
"UNVERIFIABLE",
"MARKET_SENTIMENT"
],
"type": "string"
},
"confidenceScore": {
"description": "Confidence level in the assessment (0-100)",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"data_sources": {
"description": "Information from data sources used in verification",
"items": {
"properties": {
"name": {
"description": "Name of the data source",
"type": "string"
},
"prompt": {
"description": "Prompt sent to this data source",
"type": "string"
},
"reply": {
"description": "Response from this data source",
"type": "string"
},
"source": {
"description": "Source URL or identifier",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"guardrail": {
"description": "AWS Bedrock Guardrails validation results (if runGuardrail was true)",
"properties": {
"input": {
"description": "Input validation results",
"type": "object"
},
"output": {
"description": "Output validation results",
"type": "object"
}
},
"type": "object"
},
"ipfs": {
"description": "IPFS storage information (if storeToPinata was true)",
"properties": {
"gatewayUrl": {
"description": "Public gateway URL for the stored response",
"type": "string"
},
"hash": {
"description": "IPFS hash of stored response",
"type": "string"
},
"network": {
"description": "IPFS network used",
"enum": [
"public",
"private"
],
"type": "string"
},
"paymentResponse": {
"description": "Payment transaction details if x402 was used",
"properties": {
"network": {
"type": "string"
},
"payer": {
"type": "string"
},
"success": {
"type": "boolean"
},
"transaction": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"metadata": {
"properties": {
"needsExternalData": {
"description": "Whether external data was needed",
"type": "boolean"
},
"processingTimeSec": {
"description": "Time taken to process in seconds",
"type": "number"
},
"promptType": {
"description": "Categorized type of the prompt",
"type": "string"
},
"sourcesUsed": {
"description": "Names of data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"timestamp": {
"description": "ISO timestamp of processing",
"type": "string"
},
"totalSources": {
"description": "Total number of data sources queried",
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "The original user query that was processed",
"type": "string"
},
"reply": {
"description": "The fact-checked response with analysis and conclusions",
"type": "string"
}
},
"required": [
"query",
"reply",
"assessment",
"confidenceScore",
"metadata"
],
"type": "object"
}
},
{
"resource": "https://x402-tools.vercel.app/api/horoscope",
"description": "Get your daily horoscope",
"cost": "0.01 USDC on base network",
"input": {
"discoverable": true,
"method": "GET",
"queryParams": {
"date": "Today's date in format (YYYY-MM-DD)",
"sign": "Zodiac sign (options: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"
},
"type": "http"
},
"output": {
"properties": {
"horoscope": {
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://x402-demo-discovery-endpoint.vercel.app/protected",
"description": "Demo endpoint for x402 resource discovery",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://smartanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://priceagent-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://x402-hello-agent-production.up.railway.app/api/hello",
"description": "Simple Hello greeting service",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://ai-test-vnc.alchemytech.cc/x402pay",
"description": "The omnichain settlement layer that enables AI agents to seamlessly pay millions of real-world merchants across SEA, LATAM, and Africa — powered by x402 and USDC.",
"cost": "0.01 USDC on base network",
"input": {
"body_fields": null,
"body_type": null,
"discoverable": true,
"header_fields": null,
"method": "POST",
"query_params": {
"address": "Ethereum address to receive payment",
"appId": "Application ID for identifying request source",
"qrCode": "QR code data containing payment information"
},
"type": "http"
},
"output": {
"properties": {
"bankData": {
"description": "Bank information",
"properties": {
"bankAccountName": {
"description": "Bank account name",
"type": "string"
},
"bankAccountNumber": {
"description": "Bank account number",
"type": "string"
},
"bankCode": {
"description": "Bank code",
"type": "string"
},
"bankName": {
"description": "Bank name",
"type": "string"
}
},
"type": "object"
},
"createTime": {
"description": "Transaction creation time",
"type": "string"
},
"fiatExchangeRate": {
"description": "Fiat exchange rate",
"type": "string"
},
"merchantOrderNo": {
"description": "Merchant order number",
"type": "string"
},
"num": {
"description": "System order number",
"type": "string"
},
"orderAmount": {
"description": "Fiat currency amount",
"type": "string"
},
"orderCurrency": {
"description": "Order fiat currency",
"type": "string"
},
"qrCode": {
"description": "QR code",
"type": "string"
},
"status": {
"description": "Order status",
"type": "string"
},
"usdAmount": {
"description": "USD amount",
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://macrotrendsanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://agentanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://scoutpay-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
}
]
}
-------------------
> Here are some x402 services available within your budget of 0.1 USDC:
1. **[News aggregator and fact-checking service](https://true-cast-agent.vercel.app/api/trueCast)**
- **Cost:** 0.1 USDC
- **Description:** Uses prediction markets and real-time data sources for fact-checking.
- **Method:** POST
- **Input required:** Statement or claim to verify.
2. **[Get your daily horoscope](https://x402-tools.vercel.app/api/horoscope)**
- **Cost:** 0.01 USDC
- **Description:** Daily horoscope based on your zodiac sign.
- **Method:** GET
- **Input required:** Zodiac sign and today's date.
3. **[Demo endpoint for x402 resource discovery](https://x402-demo-discovery-endpoint.vercel.app/protected)**
- **Cost:** 0.001 USDC
- **Description:** A demo service.
- **Method:** GET
4. **[Professional blockchain analysis and insights](https://smartanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Provides insights on blockchain data.
- **Method:** GET
5. **[Historical cryptocurrency price data](https://priceagent-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access to historical price data.
- **Method:** GET
6. **[Simple Hello greeting service](https://x402-hello-agent-production.up.railway.app/api/hello)**
- **Cost:** 0.001 USDC
- **Description:** A simple greeting service.
- **Method:** GET
7. **[Omnichain settlement layer](https://ai-test-vnc.alchemytech.cc/x402pay)**
- **Cost:** 0.01 USDC
- **Description:** Enables payments across different platforms.
- **Method:** POST requiring payment info.
8. **[Additional Professional blockchain analysis services](https://macrotrendsanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Another analytic service for blockchain.
- **Method:** GET
9. **[Another Professional blockchain analysis service](https://agentanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Similar insights on blockchain.
- **Method:** GET
10. **[Historical cryptocurrency price data](https://scoutpay-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access historical price data.
- **Method:** GET
-------------------
Prompt: fetch https://x402-demo-discovery-endpoint.vercel.app/protected
-------------------
{"status":"error_402_payment_required","acceptablePaymentOptions":[{"scheme":"exact","network":"base","maxAmountRequired":"1000","resource":"https://x402-demo-discovery-endpoint.vercel.app/protected","description":"Demo endpoint for x402 resource discovery","mimeType":"application/json","payTo":"0x021028695EAfDDe60E139D87000a8bd6cB65645e","maxTimeoutSeconds":300,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","outputSchema":{"input":{"type":"http","method":"GET"}},"extra":{"name":"USD Coin","version":"2"}}],"nextSteps":["Inform the user that the requested server replied with a 402 Payment Required response.","The payment options are: 0.001 USDC on base network","Ask the user if they want to retry the request with payment.","Use retry_http_request_with_x402 to retry the request with payment."]}
-------------------
The requested server returned a **402 Payment Required** response. To access the demo endpoint, you will need to pay **0.001 USDC** on the Base network. Would you like to proceed with the payment to retry the request?
-------------------
Prompt: yes
-------------------
{"status":"success","data":..." ","message":"Request completed successfully with payment","details":{"url":"https://x402-demo-discovery-endpoint.vercel.app/protected","method":"GET","paymentUsed":{"network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000"},"paymentProof":{"transaction":"0x96334990c1996297d382143fa8e6fa1373489bf4a9809094c8f722d03f42286c","network":"base","payer":"0xDb48aB111ea896649547c01aaaE9166DebCe11ae"}}}
-------------------
The request to the demo endpoint was successful! Here are the details:
### Protected Content
- **Message:** Your payment was successful! Enjoy this banger song.
- **Media:** - [Listen to the track](https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/2044190296&color=%23ff5500&auto_play=true&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true).
You can enjoy the track titled "**x402 (DJ Reppel Remix)**" from the artist **danXkim**! -------------------

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

✅ Heimdall Review Status

Requirement	Status	More Info
Reviews	✅ 1/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[phdargen]

As the market place grows, might be needed to reduce amount of returned info per service and/or add pagination or additional filters

[CarsonRoscoe]

Yes, will need to add pagination in the future. We also want to add a query based search to discovery that the agents will eventually be more likely to use. But for now this is great, ty!

[phdargen]

Description

• Added new action to discover x402 services
• Fixed x402 fetch with payment actions for CdpSmartWalletProvider
  -> this required to bump all x402 packages and implement sign(hash) method in EvmWalletProvider::toSigner()
• Formatted token amount input/output in human readable format
• Added new network checks

Tests

Chatbot: typescript/examples/langchain-smart-wallet-chatbot/chatbot.ts
Network: Base Mainnet
Prompt: fetch x402 services, my budget is 0.1 usdc
-------------------
{
"success": true,
"walletNetwork": "base",
"total": 50,
"returned": 10,
"items": [
{
"resource": "https://true-cast-agent.vercel.app/api/trueCast",
"description": "News aggregator and fact-checking service grounded by prediction markets and real-time data sources",
"cost": "0.1 USDC on base network",
"input": {
"bodyFields": {
"castHash": {
"description": "Optional Farcaster cast hash for context-specific verification",
"type": "string"
},
"prompt": {
"description": "The statement, claim, or question to fact-check and verify",
"required": true,
"type": "string"
},
"runGuardrail": {
"description": "Whether to run AWS Bedrock Guardrails validation (default: false)",
"type": "boolean"
},
"storeToPinata": {
"description": "Whether to store the response to IPFS via Pinata (default: false)",
"type": "boolean"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
},
"output": {
"properties": {
"assessment": {
"description": "The final truth assessment of the query",
"enum": [
"TRUE",
"FALSE",
"PARTIALLY_TRUE",
"UNVERIFIABLE",
"MARKET_SENTIMENT"
],
"type": "string"
},
"confidenceScore": {
"description": "Confidence level in the assessment (0-100)",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"data_sources": {
"description": "Information from data sources used in verification",
"items": {
"properties": {
"name": {
"description": "Name of the data source",
"type": "string"
},
"prompt": {
"description": "Prompt sent to this data source",
"type": "string"
},
"reply": {
"description": "Response from this data source",
"type": "string"
},
"source": {
"description": "Source URL or identifier",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"guardrail": {
"description": "AWS Bedrock Guardrails validation results (if runGuardrail was true)",
"properties": {
"input": {
"description": "Input validation results",
"type": "object"
},
"output": {
"description": "Output validation results",
"type": "object"
}
},
"type": "object"
},
"ipfs": {
"description": "IPFS storage information (if storeToPinata was true)",
"properties": {
"gatewayUrl": {
"description": "Public gateway URL for the stored response",
"type": "string"
},
"hash": {
"description": "IPFS hash of stored response",
"type": "string"
},
"network": {
"description": "IPFS network used",
"enum": [
"public",
"private"
],
"type": "string"
},
"paymentResponse": {
"description": "Payment transaction details if x402 was used",
"properties": {
"network": {
"type": "string"
},
"payer": {
"type": "string"
},
"success": {
"type": "boolean"
},
"transaction": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"metadata": {
"properties": {
"needsExternalData": {
"description": "Whether external data was needed",
"type": "boolean"
},
"processingTimeSec": {
"description": "Time taken to process in seconds",
"type": "number"
},
"promptType": {
"description": "Categorized type of the prompt",
"type": "string"
},
"sourcesUsed": {
"description": "Names of data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"timestamp": {
"description": "ISO timestamp of processing",
"type": "string"
},
"totalSources": {
"description": "Total number of data sources queried",
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "The original user query that was processed",
"type": "string"
},
"reply": {
"description": "The fact-checked response with analysis and conclusions",
"type": "string"
}
},
"required": [
"query",
"reply",
"assessment",
"confidenceScore",
"metadata"
],
"type": "object"
}
},
{
"resource": "https://x402-tools.vercel.app/api/horoscope",
"description": "Get your daily horoscope",
"cost": "0.01 USDC on base network",
"input": {
"discoverable": true,
"method": "GET",
"queryParams": {
"date": "Today's date in format (YYYY-MM-DD)",
"sign": "Zodiac sign (options: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"
},
"type": "http"
},
"output": {
"properties": {
"horoscope": {
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://x402-demo-discovery-endpoint.vercel.app/protected",
"description": "Demo endpoint for x402 resource discovery",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://smartanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://priceagent-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://x402-hello-agent-production.up.railway.app/api/hello",
"description": "Simple Hello greeting service",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://ai-test-vnc.alchemytech.cc/x402pay",
"description": "The omnichain settlement layer that enables AI agents to seamlessly pay millions of real-world merchants across SEA, LATAM, and Africa — powered by x402 and USDC.",
"cost": "0.01 USDC on base network",
"input": {
"body_fields": null,
"body_type": null,
"discoverable": true,
"header_fields": null,
"method": "POST",
"query_params": {
"address": "Ethereum address to receive payment",
"appId": "Application ID for identifying request source",
"qrCode": "QR code data containing payment information"
},
"type": "http"
},
"output": {
"properties": {
"bankData": {
"description": "Bank information",
"properties": {
"bankAccountName": {
"description": "Bank account name",
"type": "string"
},
"bankAccountNumber": {
"description": "Bank account number",
"type": "string"
},
"bankCode": {
"description": "Bank code",
"type": "string"
},
"bankName": {
"description": "Bank name",
"type": "string"
}
},
"type": "object"
},
"createTime": {
"description": "Transaction creation time",
"type": "string"
},
"fiatExchangeRate": {
"description": "Fiat exchange rate",
"type": "string"
},
"merchantOrderNo": {
"description": "Merchant order number",
"type": "string"
},
"num": {
"description": "System order number",
"type": "string"
},
"orderAmount": {
"description": "Fiat currency amount",
"type": "string"
},
"orderCurrency": {
"description": "Order fiat currency",
"type": "string"
},
"qrCode": {
"description": "QR code",
"type": "string"
},
"status": {
"description": "Order status",
"type": "string"
},
"usdAmount": {
"description": "USD amount",
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://macrotrendsanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://agentanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://scoutpay-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
}
]
}
-------------------
> Here are some x402 services available within your budget of 0.1 USDC:
1. **[News aggregator and fact-checking service](https://true-cast-agent.vercel.app/api/trueCast)**
- **Cost:** 0.1 USDC
- **Description:** Uses prediction markets and real-time data sources for fact-checking.
- **Method:** POST
- **Input required:** Statement or claim to verify.
2. **[Get your daily horoscope](https://x402-tools.vercel.app/api/horoscope)**
- **Cost:** 0.01 USDC
- **Description:** Daily horoscope based on your zodiac sign.
- **Method:** GET
- **Input required:** Zodiac sign and today's date.
3. **[Demo endpoint for x402 resource discovery](https://x402-demo-discovery-endpoint.vercel.app/protected)**
- **Cost:** 0.001 USDC
- **Description:** A demo service.
- **Method:** GET
4. **[Professional blockchain analysis and insights](https://smartanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Provides insights on blockchain data.
- **Method:** GET
5. **[Historical cryptocurrency price data](https://priceagent-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access to historical price data.
- **Method:** GET
6. **[Simple Hello greeting service](https://x402-hello-agent-production.up.railway.app/api/hello)**
- **Cost:** 0.001 USDC
- **Description:** A simple greeting service.
- **Method:** GET
7. **[Omnichain settlement layer](https://ai-test-vnc.alchemytech.cc/x402pay)**
- **Cost:** 0.01 USDC
- **Description:** Enables payments across different platforms.
- **Method:** POST requiring payment info.
8. **[Additional Professional blockchain analysis services](https://macrotrendsanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Another analytic service for blockchain.
- **Method:** GET
9. **[Another Professional blockchain analysis service](https://agentanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Similar insights on blockchain.
- **Method:** GET
10. **[Historical cryptocurrency price data](https://scoutpay-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access historical price data.
- **Method:** GET
-------------------
Prompt: fetch https://x402-demo-discovery-endpoint.vercel.app/protected
-------------------
{"status":"error_402_payment_required","acceptablePaymentOptions":[{"scheme":"exact","network":"base","maxAmountRequired":"1000","resource":"https://x402-demo-discovery-endpoint.vercel.app/protected","description":"Demo endpoint for x402 resource discovery","mimeType":"application/json","payTo":"0x021028695EAfDDe60E139D87000a8bd6cB65645e","maxTimeoutSeconds":300,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","outputSchema":{"input":{"type":"http","method":"GET"}},"extra":{"name":"USD Coin","version":"2"}}],"nextSteps":["Inform the user that the requested server replied with a 402 Payment Required response.","The payment options are: 0.001 USDC on base network","Ask the user if they want to retry the request with payment.","Use retry_http_request_with_x402 to retry the request with payment."]}
-------------------
The requested server returned a **402 Payment Required** response. To access the demo endpoint, you will need to pay **0.001 USDC** on the Base network. Would you like to proceed with the payment to retry the request?
-------------------
Prompt: yes
-------------------
{"status":"success","data":..." ","message":"Request completed successfully with payment","details":{"url":"https://x402-demo-discovery-endpoint.vercel.app/protected","method":"GET","paymentUsed":{"network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000"},"paymentProof":{"transaction":"0x96334990c1996297d382143fa8e6fa1373489bf4a9809094c8f722d03f42286c","network":"base","payer":"0xDb48aB111ea896649547c01aaaE9166DebCe11ae"}}}
-------------------
The request to the demo endpoint was successful! Here are the details:
### Protected Content
- **Message:** Your payment was successful! Enjoy this banger song.
- **Media:** - [Listen to the track](https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/2044190296&color=%23ff5500&auto_play=true&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true).
You can enjoy the track titled "**x402 (DJ Reppel Remix)**" from the artist **danXkim**! -------------------

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

✅ Heimdall Review Status

Requirement	Status	More Info
Reviews	✅ 1/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[phdargen]

As the market place grows, might be needed to reduce amount of returned info per service and/or add pagination or additional filters

[CarsonRoscoe]

Yes, will need to add pagination in the future. We also want to add a query based search to discovery that the agents will eventually be more likely to use. But for now this is great, ty!

[phdargen]

Description

• Added new action to discover x402 services
• Fixed x402 fetch with payment actions for CdpSmartWalletProvider
  -> this required to bump all x402 packages and implement sign(hash) method in EvmWalletProvider::toSigner()
• Formatted token amount input/output in human readable format
• Added new network checks

Tests

Chatbot: typescript/examples/langchain-smart-wallet-chatbot/chatbot.ts
Network: Base Mainnet
Prompt: fetch x402 services, my budget is 0.1 usdc
-------------------
{
"success": true,
"walletNetwork": "base",
"total": 50,
"returned": 10,
"items": [
{
"resource": "https://true-cast-agent.vercel.app/api/trueCast",
"description": "News aggregator and fact-checking service grounded by prediction markets and real-time data sources",
"cost": "0.1 USDC on base network",
"input": {
"bodyFields": {
"castHash": {
"description": "Optional Farcaster cast hash for context-specific verification",
"type": "string"
},
"prompt": {
"description": "The statement, claim, or question to fact-check and verify",
"required": true,
"type": "string"
},
"runGuardrail": {
"description": "Whether to run AWS Bedrock Guardrails validation (default: false)",
"type": "boolean"
},
"storeToPinata": {
"description": "Whether to store the response to IPFS via Pinata (default: false)",
"type": "boolean"
}
},
"bodyType": "json",
"discoverable": true,
"method": "POST",
"type": "http"
},
"output": {
"properties": {
"assessment": {
"description": "The final truth assessment of the query",
"enum": [
"TRUE",
"FALSE",
"PARTIALLY_TRUE",
"UNVERIFIABLE",
"MARKET_SENTIMENT"
],
"type": "string"
},
"confidenceScore": {
"description": "Confidence level in the assessment (0-100)",
"maximum": 100,
"minimum": 0,
"type": "number"
},
"data_sources": {
"description": "Information from data sources used in verification",
"items": {
"properties": {
"name": {
"description": "Name of the data source",
"type": "string"
},
"prompt": {
"description": "Prompt sent to this data source",
"type": "string"
},
"reply": {
"description": "Response from this data source",
"type": "string"
},
"source": {
"description": "Source URL or identifier",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"guardrail": {
"description": "AWS Bedrock Guardrails validation results (if runGuardrail was true)",
"properties": {
"input": {
"description": "Input validation results",
"type": "object"
},
"output": {
"description": "Output validation results",
"type": "object"
}
},
"type": "object"
},
"ipfs": {
"description": "IPFS storage information (if storeToPinata was true)",
"properties": {
"gatewayUrl": {
"description": "Public gateway URL for the stored response",
"type": "string"
},
"hash": {
"description": "IPFS hash of stored response",
"type": "string"
},
"network": {
"description": "IPFS network used",
"enum": [
"public",
"private"
],
"type": "string"
},
"paymentResponse": {
"description": "Payment transaction details if x402 was used",
"properties": {
"network": {
"type": "string"
},
"payer": {
"type": "string"
},
"success": {
"type": "boolean"
},
"transaction": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"metadata": {
"properties": {
"needsExternalData": {
"description": "Whether external data was needed",
"type": "boolean"
},
"processingTimeSec": {
"description": "Time taken to process in seconds",
"type": "number"
},
"promptType": {
"description": "Categorized type of the prompt",
"type": "string"
},
"sourcesUsed": {
"description": "Names of data sources used",
"items": {
"type": "string"
},
"type": "array"
},
"timestamp": {
"description": "ISO timestamp of processing",
"type": "string"
},
"totalSources": {
"description": "Total number of data sources queried",
"type": "number"
}
},
"type": "object"
},
"query": {
"description": "The original user query that was processed",
"type": "string"
},
"reply": {
"description": "The fact-checked response with analysis and conclusions",
"type": "string"
}
},
"required": [
"query",
"reply",
"assessment",
"confidenceScore",
"metadata"
],
"type": "object"
}
},
{
"resource": "https://x402-tools.vercel.app/api/horoscope",
"description": "Get your daily horoscope",
"cost": "0.01 USDC on base network",
"input": {
"discoverable": true,
"method": "GET",
"queryParams": {
"date": "Today's date in format (YYYY-MM-DD)",
"sign": "Zodiac sign (options: aries, taurus, gemini, cancer, leo, virgo, libra, scorpio, sagittarius, capricorn, aquarius, pisces)"
},
"type": "http"
},
"output": {
"properties": {
"horoscope": {
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://x402-demo-discovery-endpoint.vercel.app/protected",
"description": "Demo endpoint for x402 resource discovery",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://smartanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://priceagent-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://x402-hello-agent-production.up.railway.app/api/hello",
"description": "Simple Hello greeting service",
"cost": "0.001 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://ai-test-vnc.alchemytech.cc/x402pay",
"description": "The omnichain settlement layer that enables AI agents to seamlessly pay millions of real-world merchants across SEA, LATAM, and Africa — powered by x402 and USDC.",
"cost": "0.01 USDC on base network",
"input": {
"body_fields": null,
"body_type": null,
"discoverable": true,
"header_fields": null,
"method": "POST",
"query_params": {
"address": "Ethereum address to receive payment",
"appId": "Application ID for identifying request source",
"qrCode": "QR code data containing payment information"
},
"type": "http"
},
"output": {
"properties": {
"bankData": {
"description": "Bank information",
"properties": {
"bankAccountName": {
"description": "Bank account name",
"type": "string"
},
"bankAccountNumber": {
"description": "Bank account number",
"type": "string"
},
"bankCode": {
"description": "Bank code",
"type": "string"
},
"bankName": {
"description": "Bank name",
"type": "string"
}
},
"type": "object"
},
"createTime": {
"description": "Transaction creation time",
"type": "string"
},
"fiatExchangeRate": {
"description": "Fiat exchange rate",
"type": "string"
},
"merchantOrderNo": {
"description": "Merchant order number",
"type": "string"
},
"num": {
"description": "System order number",
"type": "string"
},
"orderAmount": {
"description": "Fiat currency amount",
"type": "string"
},
"orderCurrency": {
"description": "Order fiat currency",
"type": "string"
},
"qrCode": {
"description": "QR code",
"type": "string"
},
"status": {
"description": "Order status",
"type": "string"
},
"usdAmount": {
"description": "USD amount",
"type": "string"
}
},
"type": "object"
}
},
{
"resource": "https://macrotrendsanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://agentanalyst-production.up.railway.app/api/analyze",
"description": "Professional blockchain analysis and insights",
"cost": "0.05 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
},
{
"resource": "https://scoutpay-production.up.railway.app/api/prices",
"description": "Historical cryptocurrency price data",
"cost": "0.01 USDC on base network",
"input": {
"method": "GET",
"type": "http"
}
}
]
}
-------------------
> Here are some x402 services available within your budget of 0.1 USDC:
1. **[News aggregator and fact-checking service](https://true-cast-agent.vercel.app/api/trueCast)**
- **Cost:** 0.1 USDC
- **Description:** Uses prediction markets and real-time data sources for fact-checking.
- **Method:** POST
- **Input required:** Statement or claim to verify.
2. **[Get your daily horoscope](https://x402-tools.vercel.app/api/horoscope)**
- **Cost:** 0.01 USDC
- **Description:** Daily horoscope based on your zodiac sign.
- **Method:** GET
- **Input required:** Zodiac sign and today's date.
3. **[Demo endpoint for x402 resource discovery](https://x402-demo-discovery-endpoint.vercel.app/protected)**
- **Cost:** 0.001 USDC
- **Description:** A demo service.
- **Method:** GET
4. **[Professional blockchain analysis and insights](https://smartanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Provides insights on blockchain data.
- **Method:** GET
5. **[Historical cryptocurrency price data](https://priceagent-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access to historical price data.
- **Method:** GET
6. **[Simple Hello greeting service](https://x402-hello-agent-production.up.railway.app/api/hello)**
- **Cost:** 0.001 USDC
- **Description:** A simple greeting service.
- **Method:** GET
7. **[Omnichain settlement layer](https://ai-test-vnc.alchemytech.cc/x402pay)**
- **Cost:** 0.01 USDC
- **Description:** Enables payments across different platforms.
- **Method:** POST requiring payment info.
8. **[Additional Professional blockchain analysis services](https://macrotrendsanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Another analytic service for blockchain.
- **Method:** GET
9. **[Another Professional blockchain analysis service](https://agentanalyst-production.up.railway.app/api/analyze)**
- **Cost:** 0.05 USDC
- **Description:** Similar insights on blockchain.
- **Method:** GET
10. **[Historical cryptocurrency price data](https://scoutpay-production.up.railway.app/api/prices)**
- **Cost:** 0.01 USDC
- **Description:** Access historical price data.
- **Method:** GET
-------------------
Prompt: fetch https://x402-demo-discovery-endpoint.vercel.app/protected
-------------------
{"status":"error_402_payment_required","acceptablePaymentOptions":[{"scheme":"exact","network":"base","maxAmountRequired":"1000","resource":"https://x402-demo-discovery-endpoint.vercel.app/protected","description":"Demo endpoint for x402 resource discovery","mimeType":"application/json","payTo":"0x021028695EAfDDe60E139D87000a8bd6cB65645e","maxTimeoutSeconds":300,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","outputSchema":{"input":{"type":"http","method":"GET"}},"extra":{"name":"USD Coin","version":"2"}}],"nextSteps":["Inform the user that the requested server replied with a 402 Payment Required response.","The payment options are: 0.001 USDC on base network","Ask the user if they want to retry the request with payment.","Use retry_http_request_with_x402 to retry the request with payment."]}
-------------------
The requested server returned a **402 Payment Required** response. To access the demo endpoint, you will need to pay **0.001 USDC** on the Base network. Would you like to proceed with the payment to retry the request?
-------------------
Prompt: yes
-------------------
{"status":"success","data":..." ","message":"Request completed successfully with payment","details":{"url":"https://x402-demo-discovery-endpoint.vercel.app/protected","method":"GET","paymentUsed":{"network":"base","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"1000"},"paymentProof":{"transaction":"0x96334990c1996297d382143fa8e6fa1373489bf4a9809094c8f722d03f42286c","network":"base","payer":"0xDb48aB111ea896649547c01aaaE9166DebCe11ae"}}}
-------------------
The request to the demo endpoint was successful! Here are the details:
### Protected Content
- **Message:** Your payment was successful! Enjoy this banger song.
- **Media:** - [Listen to the track](https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/2044190296&color=%23ff5500&auto_play=true&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true).
You can enjoy the track titled "**x402 (DJ Reppel Remix)**" from the artist **danXkim**! -------------------

Checklist

A couple of things to include in your PR for completeness:

• Added documentation to all relevant README.md files
• Added a changelog entry

[cb-heimdall]

✅ Heimdall Review Status

Requirement	Status	More Info
Reviews	✅ 1/1	Denominator calculation Show calculation 1 if user is bot 0 1 if user is external 0 2 if repo is sensitive 0 From .codeflow.yml 1 Additional review requirements Show calculation Max 0 0 From CODEOWNERS 0 Global minimum 0 Max 1 1 1 if commit is unverified 0 Sum 1

[phdargen]

As the market place grows, might be needed to reduce amount of returned info per service and/or add pagination or additional filters

[CarsonRoscoe]

Yes, will need to add pagination in the future. We also want to add a query based search to discovery that the agents will eventually be more likely to use. But for now this is great, ty!