eSIM 运营商套件

套件包含什么
一笔交易如何完成
你需要准备
快速开始
文档
目录结构
资金与密钥
测试

以你自己的名义销售旅行流量 eSIM：在网站上卖给用户，也通过 x402 卖给 AI 智能体。你只需要一个批发账户、一台服务器和一个域名。套件就是一整家店：一个五种语言、支持十条链加密货币付款的店铺；一个 AI 智能体向其购买的卖家节点；以及让你的套餐能在 AIMarket 枢纽上被找到的联邦节点。卖家是你，买家直接付款到你的钱包。

先试试： esim.modelmarket.dev 以演示模式运行本套件，展示真实的批发价格以及所有页面和付款步骤，但不收取任何款项。

语言：English · Русский · Español · Français · 中文

套件包含什么

部分	作用
店铺（`store/`）	每个国家一个页面，这正是旅行者搜索的方式。套餐筛选、付款、eSIM 的二维码和安装链接，以及之后的流量用量。支持英语、俄语、西班牙语、法语和中文。
付款	Base、Ethereum、Arbitrum、OP、Polygon、BNB Chain 和 Avalanche 上的 USDC 与 USDT；Tron 上的 USDT；Solana 上的 USDC；TON 上的 USDT 和 TON。如果你接入 Stripe，还可以刷卡。每种方式在你填入收款地址后即开启。
面向智能体的卖家节点（`rails/`）	`esim.quote` 和 `esim.status` 免费且带签名。`esim.order` 通过 x402 以 Base 上的 USDC 付款。
联邦节点（`node/`）	`aimarket node` 把你的能力发布到 AIMarket 枢纽，让在枢纽上搜索的智能体找到你的套餐。
HTTPS	Caddy 监听 80 和 443 端口，证书来自 Let's Encrypt。

一笔交易如何完成

买家选择套餐。价格是你的批发成本加上你的加价（MARGIN_PCT，且比成本至少高 MIN_MARGIN_USD）。价格锁定 20 分钟。
买家付款到你的钱包。店铺自己读取链上数据并确认付款，中间没有支付服务商。
店铺用你在 eSIM Access 的余额按批发价购买配置文件。买家拿到二维码、激活码和安装链接。之后订单页面依然可用，显示已用流量和到期日期。
差价归你。随着销售补充批发余额。

智能体通过 HTTP 完成同样的事：先 POST /agents/quote，再带 x402 付款 POST /agents/order，激活码就在响应里。只有在配置文件创建之后才会结算付款。

你需要准备

一个 eSIM Access 批发账户，并有余额。首次充值至少 50 美元（银行卡、PayPal 或支付宝）。余额按批发价支付你售出的 eSIM。
一台服务器，装有 Docker，有公网 IPv4 地址，开放 80 和 443 端口。1 个 vCPU 和 1 GB 内存就够了。
一个域名或子域名，其 A 记录指向这台服务器。
你要收款的各条链的钱包地址。一个 EVM 地址可用于全部七条 EVM 链。套件只要地址：绝不要私钥，绝不要助记词。
可选：Coinbase Developer Platform API 密钥。它为用户开启 Base 上免 gas 的 USDC 付款，也开启智能体的 x402 付款。同样可选：用于刷卡的 Stripe 账户。

快速开始

git clone https://github.com/alexar76/esim-operator-kit.git && cd esim-operator-kit
cp .env.example .env            # 域名、店名、加价、钱包地址
# 把两个 eSIM Access 密钥放进 secrets/（文件清单见 secrets/README.md）
mkdir -p data/store data/rails data/node data/caddy
sudo chown 1000:1000 secrets/* && sudo chown -R 1000:1000 data/store data/rails data/node
docker compose up -d --build

打开 https://<你的域名>/。在你设置 DEMO_MODE=0 之前，店铺运行在演示模式。运营者指南会带你走完每一步、测试订单和正式上线。

文档

运营者指南：从空服务器到第一笔销售，然后是日常运营、退款、税务和故障排查。
智能体指南：面向 AI 智能体开发者。查找 eSIM、通过 x402 购买、查询用量。
secrets/README.md：哪个密钥放进哪个文件。

目录结构

docker-compose.yml   四个服务
Caddyfile            HTTPS 和路由：/agents/* 到 rails，/.well-known/ai-market.json 和 /ai-market/* 到 node，其余到 store
.env.example         全部设置，带注释
secrets/             你的密钥，每个文件一个（不进 git，只读挂载）
data/                订单、令牌密钥、节点身份、证书（不进 git；请备份）
store/               店铺（Node.js、Express）
rails/               卖家节点，以及店铺也在用的批发客户端
node/                联邦节点镜像（来自 PyPI 的 aimarket-hub）
docs/                五种语言的这些指南

资金与密钥

买家直接付款到你的地址，店铺只读取链上数据。没有热钱包，也没有任何能花钱的密钥。
激活码交给买家，从不存储。每当买家的订单页面请求时，店铺都向批发商重新获取。买家的链接里带一个令牌，店铺只保存它的哈希。
一笔付款只买一张 eSIM。批发订单号由付款推导而来，所以重试不会买两次。
在请求付款之前，店铺会检查你的批发余额是否足够支付这笔订单。

测试

cd rails && npm ci && npm test
cd ../store && npm ci && npm test

测试不需要网络，也不需要密钥。