Thanks to visit codestin.com
Credit goes to github.com

Skip to content

DoBestone/nexcore-sdk

NexCore Official SDKs

面向开发者的综合数字基础服务平台 · 官方多语言 SDK

License: MIT v3.0.0 Website Docs

官方网站 · nexcores.net  |  API 文档 · /docs  |  易记 · 9188.PRO


关于 NexCore

NexCore 是面向开发者与中小团队的综合数字基础服务平台,把"加密支付、跨链兑换、TRON 能量、虚拟卡、云服务、海外通讯、AI 网关"等高频但难自研的能力统一封装为 API,让一个开发者也能跑完跨境业务全链路.

2021 年 7 月 启动以来,服务范围已经从最初的多链收款扩展到 9 大业务模块,目前是国内少数同时提供加密金融、海外通讯、AI 接入完整工具栈的开发者平台之一.

设计哲学

  • 🔌 一次接入,全栈可用 — 一个 SDK 实例覆盖所有业务,共享 baseUrl + 凭据池
  • 🛡️ 自托管友好 — Webhook HMAC 签名 + 常量时间校验,合规可审计
  • 🌍 多语言对等 — PHP / Python / Node.js / Go 行为完全一致,迁移零成本
  • 📜 永远跟文档对齐 — SDK 字段命名与 /docs 100% 一致,不需要"翻译表"
  • 🪶 零或最少依赖 — Go / Node 零运行时依赖,Python 仅 requests,PHP 仅 ext-curl

平台业务一览

NexCore 平台共 9 个业务模块,本 SDK 当前覆盖核心 4 个(其余 5 个见线上文档说明):

业务 SDK 覆盖 定位
🪙 多链收款 / Payment client.payment USDT/USDC/TRX/BTC/ETH 等 6 主链加密货币收款,秒级确认,商户自托管
💱 汇率 / Exchange client.exchange 实时加密 ↔ 法币 / 法币 ↔ 法币 汇率服务,Payment 配套
TRON 能量租赁 / Energy client.energy TRC20 转账省 60% gas,即租即用,30 秒到账
📧 SMTP 聚合 API / Smtp client.smtp 模板邮件 + 多账号智能轮发 + 打开/点击全跟踪
🔄 多链闪兑 / Swap 任意币 ↔ 任意币,链上充提,30 分钟自动到账
💳 虚拟信用卡 / Vcard USDT 充值开卡,海外广告 / AI 订阅秒结算,Visa / Mastercard 全球
☁️ 云服务 / Cloud 域名 / 服务器 / DNS / SSL 一站式
📱 SMS 接码 + 专用邮箱 / SMS 海外平台注册首选,60+ 国家真实运营商号源
🤖 Astrenix AI / AiApi Claude / OpenAI / Gemini 全代理,兼容官方 SDK(直接用 openai SDK 改 base_url)

⚠️ Swap / Vcard / Cloud / SMS / Astrenix AI 当前通过线上文档 + Web 控制台调用.SDK 后续按需求扩展.

业务覆盖(25 个 v1 公开 endpoint)

模块 路径前缀 鉴权 endpoints
多链收款 Payment /api/v1/pay/* HMAC-SHA256 签名(app_id + app_key) 7
汇率 Exchange /api/v1/rate / /api/v1/rates* / /api/v1/convert X-App-Key + X-App-Secret 5
能量租赁 Energy /api/v1/energy/* X-API-Key + X-Secret-Key 8
SMTP 聚合 Smtp /api/v1/smtp/* Authorization: Bearer smk_xxx 5

所有 endpoint 完全对照 /docs 在线文档,字段命名与后端 100% 一致.

支持语言

语言 目录 包管理 安装
🐘 PHP 7.4+ php/ Composer composer require nexcore/sdk
🐍 Python 3.8+ python/ pip pip install nexcore-sdk
🟢 Node.js 16+ node/ npm npm install @nexcore/sdk
🐹 Go 1.21+ go/ go modules go get github.com/DoBestone/nexcore-sdk/go

(npm/PyPI/Packagist 发布详见 PUBLISH.md)

统一设计

所有语言遵循同样的客户端结构:

Client(config)
  ├─ .payment    多链收款
  │   ├─ createOrder / queryOrder / closeOrder / getAppConfig
  │   ├─ bindAddress / getUserAddress / unbindAddress  (一对一模式)
  │   └─ sign() / verifyNotifySign()                   (签名工具)
  ├─ .exchange   汇率
  │   ├─ getRate / convert
  │   └─ getRates / getFiatRates / getAllRates
  ├─ .energy     TRON 能量租赁
  │   ├─ getInfo / getPrice / estimateEnergy
  │   ├─ createOrder / createOnetimeOrder
  │   └─ queryOrder / listOrders / reclaimOrder
  └─ .smtp       SMTP 聚合
      ├─ send / sendBatch / sendTemplate
      └─ getQuota / getStatus

文件组织(规范化)

每个语言 SDK 按业务命名空间拆分多文件,便于阅读和维护:

sdk/
├── php/
│   ├── composer.json                (PSR-4 autoload)
│   └── src/
│       ├── Client.php
│       ├── Http.php
│       ├── NexCoreError.php
│       └── Namespaces/
│           ├── Payment.php  Exchange.php  Energy.php  Smtp.php
├── python/
│   ├── pyproject.toml               (pip 可安装)
│   └── nexcore/
│       ├── __init__.py / client.py / http.py / errors.py
│       └── namespaces/
│           ├── payment.py  exchange.py  energy.py  smtp.py
├── node/
│   ├── package.json                 (npm 可发布)
│   ├── index.js / index.d.ts
│   └── src/
│       ├── client.js / http.js / errors.js
│       └── namespaces/
│           ├── payment.js  exchange.js  energy.js  smtp.js
└── go/
    ├── go.mod                       (module: github.com/DoBestone/nexcore-sdk/go)
    ├── doc.go / client.go / http.go / errors.go
    └── payment.go  exchange.go  energy.go  smtp.go

鉴权配置

一个 Client 实例可同时挂多种凭据,各业务自动用对应凭据.

Python

from nexcore import Client, NexCoreError

client = Client(
    base_url="https://your-domain.com",
    payment_app_id="APP20260412XXXX",
    payment_app_key="your_app_key_here",
    energy_api_key="energy_key",
    energy_secret_key="energy_secret",
    smtp_api_key="smk_xxx",
)

# 创建支付订单
order = client.payment.create_order(
    out_order_id="ORDER_001",
    amount="100.00",
    currency="CNY",
    trade_type="usdt.trc20",
    call_type="rotation",
)

# 估算 TRC20 能量
estimate = client.energy.estimate_energy("TXxxxxxxxxxxxxxxxxxxxxx")

# 查询汇率
rate = client.exchange.get_rate("USDT", "CNY")

# 发送邮件
result = client.smtp.send(to="[email protected]", subject="Hi", body="Hello")

Node.js

const { Client, NexCoreError } = require('@nexcore/sdk');

const client = new Client({
  baseUrl: 'https://your-domain.com',
  paymentAppId: 'APP20260412XXXX',
  paymentAppKey: 'your_app_key_here',
  energyApiKey: 'energy_key',
  energySecretKey: 'energy_secret',
  smtpApiKey: 'smk_xxx',
});

const order = await client.payment.createOrder({
  out_order_id: `ORDER_${Date.now()}`,
  amount: '100.00',
  currency: 'CNY',
  trade_type: 'usdt.trc20',
  call_type: 'rotation',
});

PHP

require_once __DIR__ . '/vendor/autoload.php';
use NexCore\Client;

$client = new Client([
    'base_url'        => 'https://your-domain.com',
    'payment_app_id'  => 'APP20260412XXXX',
    'payment_app_key' => 'your_app_key_here',
    // ...
]);

$order = $client->payment->createOrder([
    'out_order_id' => 'ORDER_' . time(),
    'amount'       => '100.00',
    'currency'     => 'CNY',
    'trade_type'   => 'usdt.trc20',
    'call_type'    => 'rotation',
]);

Go

import nexcore "github.com/DoBestone/nexcore-sdk/go"

c := nexcore.NewClient(nexcore.Config{
    BaseURL:       "https://your-domain.com",
    PaymentAppID:  "APP20260412XXXX",
    PaymentAppKey: "your_app_key_here",
})

raw, err := c.Payment.CreateOrder(map[string]any{
    "out_order_id": fmt.Sprintf("ORDER_%d", time.Now().Unix()),
    "amount":       "100.00",
    "currency":     "CNY",
    "trade_type":   "usdt.trc20",
    "call_type":    "rotation",
})

异常处理

所有 SDK 统一抛出 NexCoreError(各语言适配名),包含:

  • code — 平台返回错误码(0=成功;-1=客户端层错误)
  • message — 错误信息
  • requestId / request_id — 服务端日志 ID(响应头 X-Trace-Id,排查问题用)
  • httpStatus / http_status — HTTP 状态码

Webhook 签名校验

四个语言都用常量时间比较防时序攻击:

  • PHP — hash_equals()
  • Python — hmac.compare_digest()
  • Node.js — crypto.timingSafeEqual()
  • Go — hmac.Equal()

每个语言的 client.payment.verifyNotifySign(payload) 一行调用即完成校验.

适用场景

  • 跨境电商 / 数字商品 — 多链收款 + 法币汇率 + 自动归集
  • 海外广告投流团队 — 虚拟卡批量开卡 / USDT 自动充值
  • AI 应用开发者 — 通过 Astrenix AI 网关同时接 Claude/GPT/Gemini,统一计费
  • 海外平台运营 — SMS 接码 + 专用邮箱 + SMTP 聚合发送,完整通讯栈
  • DApp / Web3 应用 — TRON 能量租赁 + 多链收款,链上业务标配

版本

当前 SDK 版本:v3.0.0(跟主仓库 v3.x 主线一致)

反馈

License

MIT © 2026 NexCore


About

Official NexCore platform SDK — multi-chain payment / exchange rates / TRON energy / SMTP. PHP, Python, Node.js, Go. 25 endpoints, 4 languages, namespace-split.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors