voulti

Name: voulti
Author: csacanam

本地服务

github.com/csacanam金融数据04 周前更新

代码仓库

关于 voulti

Voulti 是面向商户的加密货币支付网关，支持在五个网络上收取稳定币。其 Agent 集成无需 API 密钥即可创建发票、查询发票详情或获取支付链接。

主要功能

01支持五个网络的稳定币支付
02创建发票并查询状态
03托管结账页与支付链接
04连接钱包或按地址付款
05汇总多链余额
06自动检测存款并结算

适用场景

01通过 AI Agent 创建发票
02向客户发送托管结账链接
03在支持的网络收取稳定币
04查看余额并提取资金

MCP 相关

MCP 服务提供创建发票、查询发票详情和获取支付链接的工具。该集成 API 无需 API 密钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "csacanam-voulti": {
      "command": "npx",
      "args": [
        "-y",
        "voulti-mcp"
      ],
      "env": {
        "VOULTI_COMMERCE_ID": "<VOULTI_COMMERCE_ID>"
      }
    }
  }
}

启动命令npx -y voulti-mcp

需要配置的环境变量

VOULTI_COMMERCE_IDDefault merchant id (from app.voulti.com → Receive Payments → Developers). Optional — can be passed per call.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmvoulti-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
reference	string	否	你自己的备注：订单 ID、客户名称……
expires_at	string	否	ISO 8601 形式的到期时间（默认：从现在起 1 小时）
amount_fiat	number	是	商户基础货币金额
commerce_id	string	否	商户 ID（默认使用 VOULTI_COMMERCE_ID 环境变量）

详细介绍

面向商家的加密货币支付网关。在 5 个网络上接受 USDC、USDT 和稳定币。

架构

apps/
  checkout/     React + Vite — customer payment page
  merchant/     Next.js — merchant dashboard
  api/          Fastify — backend API

contracts/
  core/         DerampProxy + modules (Hardhat, Solidity ^0.8.28)

packages/
  shared/       Shared utilities

assets/
  brand/        The logo, and the icons every app is derived from

网络

网络	链 ID	代币
Celo	42220	USDC、USDT、COPm
Arbitrum	42161	USDC、USD₮0
Polygon	137	USDC、USDT0
Base	8453	USDC
BSC	56	USDC、USDT

面向 AI Agent

Voulti 全程可供 Agent 使用 — 集成 API 无需 API 密钥：

MCP 服务：claude mcp add voulti -- npx -y voulti-mcp — 工具 create_invoice、get_invoice、get_payment_link。请参阅 mcp/README.md。
Agent 技能：npx skills add csacanam/voulti — 或访问 voulti.com/skill.md 阅读。
纯 HTTP：使用 { commerce_id, amount_fiat, reference? } 向 POST https://api.voulti.com/invoices 发送请求 → 获取托管结账链接。LLM 索引：voulti.com/llms.txt。

功能

自助注册 — 商家连接钱包、填写商家名称，即可完成
两种支付方式 — 连接钱包或通过地址付款（二维码 + 存款）
多链余额 — 按代币汇总，自动选择网络
发送资金 — 从仪表板提现至任意钱包
HD 钱包归集 — 自动检测存款并结算
部分付款／超额付款处理 — 超额付款时自动退款，部分付款时等待
i18n — 西班牙语和英语

智能合约

采用模块化代理架构，部署在 5 个网络上：

DerampProxy — 入口点，将调用路由至各模块
DerampStorage — 集中式数据存储
AccessManager — 角色、代币／商家白名单
InvoiceManager — 发票生命周期管理
PaymentProcessor — 支付执行、费用计算
TreasuryManager — 服务费收取
WithdrawalManager — 商家资金提现

所有地址请参阅 contracts/core/deployed-addresses/PRODUCTION.md。

运营钱包

0x21581Cb82D9a66126fBe7639f4AF55DdfEA48E26 — 部署合约、将商家加入白名单，并为 HD 钱包归集发送 Gas。

本地开发

# Prerequisites: Node 18+, pnpm
pnpm install
cd contracts/core && npm install

# Start Hardhat node (terminal 1)
npx hardhat node

# Deploy + setup (terminal 2)
cd contracts/core
npx hardhat run scripts/setup-local.ts --network localhost

# Start API (terminal 3)
pnpm dev:api

# Start checkout (terminal 4)
pnpm dev:checkout

# Start merchant dashboard (terminal 5)
pnpm dev:merchant

API 端点

方法	路径	身份验证	说明
POST	/commerces	Privy	注册商家
GET	/commerces/:id	Public	商家信息
GET	/commerces/:id/balances	Privy	多链余额
POST	/invoices	Privy	创建发票
GET	/invoices/:id	Public	发票详情 + 代币
POST	/blockchain/create	Public	创建链上发票
GET	/blockchain/status/:id	Public	链上发票状态
POST	/deposit/generate	Public	生成 HD 存款地址
GET	/deposit/status/:id	Public	存款监控状态
GET	/stats	Public	营收统计（公开构建中）
GET	/prices/rates	Public	数据库中的法币 + 代币汇率
POST	/prices/update-fiat-rates	Cron	更新法币汇率（OpenExchangeRates）
POST	/prices/update-token-prices	Cron	更新代币价格（CoinGecko）

定时任务

在 DigitalOcean（或任何调度器）中将以下任务配置为定时任务：

任务	URL	计划	说明
法币汇率	`POST /prices/update-fiat-rates`	每小时	从 OpenExchangeRates 更新 USD→COP/EUR/BRL/MXN/ARS 汇率
代币价格	`POST /prices/update-token-prices`	每小时	从 CoinGecko 更新 USDC/USDT/COPm 汇率
使发票过期	`POST /orders/expire-orders`	每分钟	将过期发票标记为 Expired
处理邮件	`POST /notifications/process-emails`	每分钟	通过 Resend 发送付款确认邮件
处理 Webhook	`POST /notifications/process-url-confirmations`	每分钟	调用商家确认 URL