支付集成示例

Cronos402支付集成示例和模板,展示如何在各种应用中集成Cronos402支付功能。

  • by Cronos402
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Cronos402/examples

使用说明

Cronos402示例

演示Cronos402使用模式的集成示例和模板。

概述

此目录包含自包含的示例,显示了如何将Cronos402支付功能集成到各种应用程序中。每个示例都是一个完整的工作项目,演示了特定的用例和集成模式。

可用示例

cronos天气服务器

生产就绪的MCP天气API和付款要求。

  • 类型:付费MCP服务器
  • 特性:USDC.e+CRO支付,OpenWeather API集成
  • 科技:Express.js、cronos402 SDK
  • 自述文件: cronos天气服务器/README.md

身份验证示例

身份验证集成示例。

  • 类型:身份验证集成
  • 特性:更好的Auth、会话管理、API密钥处理
  • 科技:Next.js,更好的身份验证

chatgpt应用sdk-nextjs入门

ChatGPT应用程序与Cronos402集成。

  • 类型:ChatGPT插件
  • 特性:ChatGPT操作,OpenAPI集成
  • 科技:Next.js、OpenAPI

运行示例

每个示例都是自己的pnpm工作空间包:

# Navigate to example
cd examples/cronos-weather-server

# Install dependencies
pnpm install

# Run in development
pnpm dev

# Build for production
pnpm build

示例结构

新示例的最小结构:

example-name/
├── src/                 # Source code
├── README.md            # Example documentation
├── package.json         # Dependencies
├── .env.example         # Environment variables template
└── tsconfig.json        # TypeScript configuration

创建新示例

指南

  • 让例子集中在一个概念上
  • 包含全面的自述文件
  • 提供 .env.example 用于配置
  • 在代码中添加清晰的注释
  • 包括错误处理
  • 在测试网和主网上进行测试

模板结构

// Example: Minimal paid MCP server
import { createMcpHandler } from 'cronos402';
import { z } from 'zod';

const handler = createMcpHandler(
  async (server) => {
    server.paidTool(
      'example_tool',
      'Tool description',
      '0.01', // Price in USD
      {
        param: z.string().describe('Parameter description')
      },
      {},
      async ({ param }) => {
        // Tool implementation
        return {
          content: [{
            type: 'text',
            text: `Result: ${param}`
          }]
        };
      }
    );
  },
  {
    recipient: {
      'cronos-testnet': '0x...',
      'cronos-mainnet': '0x...'
    },
    facilitator: {
      url: 'https://facilitator.cronos402.dev'
    }
  }
);

export default handler;

示例类别

MCP服务器

构建付费MCP服务器的示例:

  • 天气API(cronos-Weather-server)
  • API数据示例
  • AI服务示例

客户端集成

消费付费服务的示例:

  • CLI客户端示例
  • ChatGPT应用程序集成
  • 自定义MCP客户端实现

认证

身份验证集成示例:

  • 更好的身份验证设置
  • API密钥管理
  • 会话处理

付款流

展示支付模式的示例:

  • USDC.e无气支付
  • 本地CRO付款
  • 付款验证

测试示例

本地测试

# Start example server
pnpm dev

# Test with CLI
npx cronos402 connect --urls http://localhost:3000/mcp --api-key test

测试网测试

# Configure testnet
export CRONOS_NETWORK=cronos-testnet
export RECIPIENT_ADDRESS=0xYourTestnetAddress

# Get test tokens
# TCRO: https://cronos.org/faucet
# devUSDC.e: https://faucet.cronos.org

# Run example
pnpm start

部署示例

维塞尔

cd examples/your-example
vercel

铁路

railway up

Cloudflare员工

wrangler deploy

资源

贡献

要添加新示例,请执行以下操作:

  1. 在中创建目录 examples/
  2. 添加到pnpm工作区
  3. 包含全面的自述文件
  4. 彻底测试
  5. 提交拉取请求

支持

关于示例的问题:

许可证

麻省理工学院