即将推出的变更

我们正在开发令人兴奋的新功能，将增强您的体验。在我们继续开发这些更新的同时，您可以继续构建！

我们建议您定期查看此更新日志以获取最新更新，并相应地规划您的开发周期。您的反馈对我们非常宝贵，如有任何建议或问题，请随时与我们分享。

产品更新

新版本和改进

新功能智能体支付

智能体支付：x402 和 MPP

AI 智能体现在可以从 Blockradar 钱包用稳定币按请求为 API 付费，企业也可以通过 Blockradar 钱包接收智能体的付款。两者都使用您已有的类型化数据签名端点和存款流程，没有新增 API。

变更内容

付款：智能体在 EVM 链上用 USDC 支付 x402 和 MPP（EVM charge）请求。Blockradar 签署 EIP-3009 授权，私钥始终保留在 Blockradar 内，付款钱包无需 Gas。指南提供了适配官方 @x402/fetch 和 mppx 客户端的代码。
收款：付到 Blockradar 地址的 x402 和 MPP 款项会作为普通存款到账，触发常规的 deposit.success Webhook，senderAddress 为付款钱包。这也包括 Solana 上以 USDC 支付的 x402 款项，以及 Tempo 主网上以 OUSD、USDC.e 和 USDT 支付的 MPP charge。
即将推出：在 Tempo 上支付 MPP charge，以及 MPP session。

您需要做什么

无需任何操作，除非您希望使用智能体支付。签名没有单笔付款限额，因此请为每个智能体分配一个专用地址，只存放它被允许支出的资金。详情请参阅发起智能体支付和接收智能体支付。

新功能Gateway

Gateway：支持 Solana

Solana 现已成为 Gateway 在主网和 Devnet 上支持的链。您可以使用现有的 Gateway 端点，将 Solana 上的 USDC 存入统一的 Gateway 余额，也可以从该余额提款到 Solana 地址。

变更内容

新增链：Solana（主网）和 Solana Devnet，均可作为来源链和目标链。存款在 ~2-3 个区块（约 8 秒）后入账。
混合余额：从 master wallet 发起的提款可以同时使用您在 EVM 和 Solana 上的 Gateway 余额，并铸造到任一 EVM 链或 Solana。
Solana 收款方：请将 address 设置为钱包地址，而不是 USDC 代币账户。代币账户及其他归程序所有的地址会被拒绝并返回 400。如果收款方尚无 USDC 代币账户，Gateway 会自动创建。

您需要做什么

无需任何操作，除非您希望在 Solana 上使用 Gateway。如需使用，请在控制台中创建一个 Solana master wallet，并充入 SOL 以支付网络费用。详情请参阅提款到 Solana。

新功能

支持 OpenUSD（OUSD）

美元稳定币 OpenUSD（OUSD）现已在四个网络的主网上获得支持：Tempo、Base、Ethereum 和 Solana。在钱包上启用 OUSD 后，发送到您地址的 OUSD 充值会像其他稳定币一样被检测和通知，OUSD 余额按 1:1 折算为美元。

变更内容

新资产：主网上的 OUSD，所有网络均为 6 位小数：

网络	合约 / Mint 地址
Tempo	`0x20c0000000000000000000006a37DA5C996874BE`
Base	`0xB2000000000000000000002fEb517dFeC7415344`
Ethereum	`0x9f6F3991D525015a6F8CaF062C83b62fD3AC4436`
Solana	`ousd2mJsPEckLHcSCDxyKD7NDGARZcfLbDZkKiatYHB`

仅限主网：OUSD 不支持任何测试网。
Solana 使用 Token-2022：Solana 上的 Mint 是 Token-2022 代币（与 Solana 上的 PYUSD 相同），而非经典 SPL 代币。

您需要做什么

如无需接收 OUSD，则无需任何操作。如需接收，请在每个需要接收 OUSD 的钱包上启用它，详见资产管理。钱包只会检测已启用资产的充值。

其他代币也可能使用 OUSD 符号，只有上述地址才是 OpenUSD。如果您从其他平台向 Blockradar 地址发送 OUSD，请确认合约或 Mint 地址一致。

新功能Stellar

Stellar：支持 PYUSD

Stellar 主网现已支持 PayPal USD（PYUSD），与 USDC、EURC 和 USDT 并列。您可以使用已用于其他 Stellar 资产的相同端点，在 Stellar 上接收、提取和归集 PYUSD。PYUSD 此前已在 Ethereum、Solana 和 Arbitrum 上获得支持。

变更内容

新资产：Stellar 主网上的 PYUSD（资产代码 PYUSD，发行方 GDQE7IXJ4HUHV6RQHIUPRJSEZE4DRS5WY577O2FY6YQ5LVWZ7JZTU2V5，由 Paxos 发行）。Stellar 测试网不支持。
按需启用：在您启用 PYUSD 之前，您的钱包不会有任何变化。启用后，主钱包和该钱包下的每个已激活地址会新增一条 PYUSD 信任线，各需 0.5 XLM 储备金；该钱包下新地址的激活成本也会增加 0.5 XLM。

您需要做什么

如无需在 Stellar 上接收 PYUSD，则无需任何操作。如需接收，请先确保主钱包中至少持有钱包下每个已激活地址 0.5 XLM，外加主钱包自身 0.5 XLM，然后在钱包上启用 PYUSD。

Stellar 上有许多账户发行名为 PYUSD 的资产，只有上述发行方的资产才是 PayPal USD。如果您从其他平台向 Blockradar 地址发送 PYUSD，请确认其使用的是同一发行方。

详情请参阅地址激活。

新功能Stellar

Stellar：支持 USDT

Stellar 主网现已支持 USDT，与 USDC 和 EURC 并列。您可以使用已用于其他 Stellar 资产的相同端点，在 Stellar 上接收、提取和归集 USDT。

变更内容

新资产：Stellar 主网上的 USDT（链上资产代码 USDT0，发行方 GATISXX6BZ6NC7IKQBY37CJD4SOZL3CYZJWXEDG6JVIY4WBS6KXJHN6Q）。与其他所有链一致，API 以 USDT 符号返回该资产。Stellar 测试网不支持。
按需建立信任线：Stellar 信任线跟随每个钱包上已启用的资产。未启用 USDT 的钱包不受影响，也不会有 XLM 转出。
激活成本：在启用了 USDT 的钱包上，每个新地址会多建立一条信任线，因此每个地址的激活储备金增加 0.5 XLM（启用 USDC、EURC 和 USDT 时为 2.5 XLM，而非 2 XLM）。
现有地址：在钱包上启用 USDT 后，其主钱包和每个已激活地址会在约 10 分钟内自动新增 USDT 信任线，并各自从您的主钱包收到 0.5 XLM 以覆盖新增的储备金。
跨链桥存款：经跨链桥进入 Stellar 的 USDT 会直接铸造（mint）给收款方，因此跨链桥存款的 deposit.success Webhook 中 senderAddress 为 null。

您需要做什么

如需在 Stellar 上接收 USDT，请在钱包上启用该资产。启用前，请确保主钱包中至少持有钱包下每个已激活地址 0.5 XLM，外加主钱包自身 0.5 XLM。
确保您的 Webhook 处理程序能够接受 null 的 senderAddress。

详情请参阅地址激活。

新功能法币提现

法币提现：使用 `amountSide` 固定到账金额

v2 法币提现端点现在支持从转换的任意一侧进行报价和执行——发送精确的稳定币金额，或向收款人交付精确的法币金额。

变更内容

v2 报价和执行端点（主钱包和子地址）以及 v2 汇率端点新增 amountSide 参数：source（默认）将 amount 视为要发送的稳定币金额；target 将其视为收款人必须收到的法币金额。
使用 amountSide: "target" 时，稳定币扣除金额由报价汇率推导，并按资产的小数精度向上取整，确保到账金额永远不会低于所请求的法币金额。
该参数为可选项，默认为 source，因此现有集成不受影响。v1 法币提现端点不支持 amountSide。

您需要做什么

无需任何操作——该参数是可选且增量的。要发放精确的法币金额（工资、发票、固定金额结算），请传入 amountSide: "target" 并在 amount 中填入法币金额，且在报价和执行调用中使用相同的值。请参阅 Master Wallet Quote 和指南中的固定到账金额。

新功能地址

地址验证端点

现在您可以在转移资金之前检查地址对于给定区块链是否有效——例如，在客户输入提款目标地址时即时验证，而不是等到提款失败才发现错误。

变更内容

GET /addresses/validate：传入 blockchain slug 和 address，响应会告诉您该地址对于该链是否有效。对于 EVM 区块链，有效地址会以 EIP-55 校验和格式返回。该端点使用与提款端点相同的验证规则，并支持 Blockradar 的所有区块链——EVM 链、Tron、Solana 和 Stellar。
验证针对链的地址格式离线进行——不执行任何链上查询或 AML 筛查，因此响应速度快。该端点适用标准 API 速率限制，请在表单提交时进行验证，而不是在每次按键时调用。
无效地址返回 200 且 isValid: false。404 表示区块链 slug 未知或不可用，400 表示请求本身格式错误——因此您可以区分”地址错误”和”请求错误”。
AML 查询加固：向 /aml/lookup 发送重复的 blockchain 查询参数现在返回 400 而不是 500。

您需要做什么

无需任何操作——这是一个新端点，现有集成不受影响。要开始验证地址，请参阅 Validate Address API 参考。

新功能Webhooks

Webhook 载荷中的网络费用

交易 webhook 现在会准确告诉您一笔交易花费了多少网络费用，以便您将成本转嫁给您的客户。

变更内容

networkFee：您的 Blockradar 托管钱包在交易流程中支付的网络费用总额，以链的原生代币和美元计。在您未承担任何费用的事件上为 null，例如 gas 由存款人支付的 deposit.success。
networkFees：逐笔费用明细。每一条包含操作类型、付款钱包、原生代币和美元金额，以及自己的交易哈希用于链上验证。由 Blockradar 赞助的条目标记为 PLATFORM 或 PROVIDER，并且不计入 networkFee 总额。

您需要做什么

无需任何操作，这些字段是新增的。要向客户收取确切的网络成本，请在您的 webhook 处理程序中读取 networkFee.amountUsd。详情参见 Webhook 载荷中的网络费用。

新功能Stellar

Stellar：Soroban 合约与 Muxed 收款地址

Stellar 提款和交易签名现在支持更多的收款地址类型和交易类型。

变更内容

Muxed 收款地址（M...）：所有资产的提款均支持 muxed 地址。资金会结算到底层的 G... 账户，且不会附加 memo——路由 ID 已嵌入在地址本身中。
Soroban 合约收款地址（C...）：代币提款（例如 USDC、EURC）可以发送到 Soroban 合约地址。转账会通过 Soroban RPC 在该代币的 Stellar Asset Contract 上执行。合约收款地址仅对代币资产有效——将原生 XLM 发送到 C... 地址会返回 400 错误。
签名端点支持 Soroban 交易：/signing/transaction 和 /signing/broadcast 端点接受 Soroban 交易（Stellar Asset Contract 转账或自定义合约调用）。请在提交签名之前先模拟并组装交易。

您需要做什么

无需任何操作——现有的经典 G... 提款不受影响。要使用新的收款地址类型，请在 address 字段中传入 M... 或 C... 地址。详情请参阅 Stellar 收款地址和 Stellar Soroban 交易。

改进资产更新

cNGN 合约地址更新

cNGN 团队已在 5 个网络上部署了新的合约地址。之前的地址现已标记为 “Old v2”，将逐步淘汰。

变更内容

cNGN 新部署：Ethereum、BNB Chain、Base、Asset Chain 和 Arc 上的 cNGN 合约地址已更新
之前的地址已重新标记：控制面板中现有地址已标记为 “Old v2”
新网络支持：cNGN 现已在 Arc 网络上可用

您需要做什么

进入控制面板并添加新的 cNGN 资产（查找没有 “Old” 标签的资产）
更新您的集成以使用新的合约地址
之前的地址在过渡期间将继续正常工作

新合约地址

网络	新 cNGN 合约地址
Ethereum	`0xF55E56423e6b50808fD07cB62b6A32B91903f50E`
BNB Chain	`0x8a078b182bA9649c03982c2a80CDcc81cdc99dA8`
Base	`0xEFdF04BAfE0ebabb5F5cD9e3f36564f51CFe1530`
Asset Chain	`0x00F0a33d9AFaC108A4963D4Cb4Ef6A9C6B8D8859`
Arc	`0x1716Df6A18DcFF031BFD209aDB8035174AdC0D31`

cNGN 测试代币

需要用于沙盒（测试网）集成的测试 cNGN？请使用官方 cNGN Faucet 获取测试代币。有关 cNGN 稳定币项目的更多信息，请访问官方仓库。

重大变更虚拟账户

虚拟账户 API 重大变更

重大变更：此更新现已生效。使用虚拟账户 API 的现有集成应更新至新的响应格式。

为什么进行此变更

之前，每个钱包或地址只能拥有一个虚拟账户。我们听到企业反馈需要每个钱包拥有多个虚拟账户——例如，为不同的客户或用例分配单独的账户。此更新实现了这种灵活性，同时保持了检索单个账户的向后兼容性。

变更内容

端点	之前的行为	新的行为
`GET /wallets/{walletId}/virtual-accounts`	返回单个对象	返回分页数组
`GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts`	返回单个对象	返回分页数组

新增端点

要检索特定的虚拟账户（相当于旧的单对象响应），请使用这些新端点：

端点	描述
`GET /wallets/{walletId}/virtual-accounts/{virtualAccountId}`	获取特定虚拟账户
`GET /wallets/{walletId}/virtual-accounts/{virtualAccountId}/transactions`	获取虚拟账户的交易记录
`POST /wallets/{walletId}/virtual-accounts/{virtualAccountId}/regenerate`	重新生成虚拟账户
`GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}`	获取特定子地址虚拟账户
`GET /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}/transactions`	获取子地址虚拟账户的交易记录
`POST /wallets/{walletId}/addresses/{addressId}/virtual-accounts/{virtualAccountId}/regenerate`	重新生成子地址虚拟账户

分页详情

所有列表端点现在支持以下分页参数：

参数	类型	默认值	最大值	描述
`page`	integer	`1`	—	要检索的页码
`limit`	integer	`10`	`100`	每页记录数

新功能

虚拟账户标签：添加自定义标签以组织账户（例如，“客户A”、“工资单”）
账户重新生成：生成新的账户号码，带有原因跟踪以便审计
交易历史：查询与特定虚拟账户关联的交易

迁移指南

之前 — 单对象响应：

const response = await fetch(`/wallets/${walletId}/virtual-accounts`);
const account = await response.json();

console.log(account.accountNumber);
console.log(account.bankName);

之后 — 分页数组响应：

const response = await fetch(`/wallets/${walletId}/virtual-accounts`);
const { data, meta } = await response.json();

// 处理空数组情况
if (data.length === 0) {
  console.log('未找到虚拟账户');
  return;
}

// 获取第一个账户（相当于旧行为）
const account = data[0];
console.log(account.accountNumber);
console.log(account.bankName);

// 或遍历所有账户
for (const account of data) {
  console.log(account.accountNumber);
}

// 分页信息在 meta 中可用
console.log(`第 ${meta.currentPage} 页，共 ${meta.totalPages} 页`);

通过 ID 获取特定账户（推荐）：

const response = await fetch(`/wallets/${walletId}/virtual-accounts/${virtualAccountId}`);

if (!response.ok) {
  console.log('未找到虚拟账户');
  return;
}

const { data } = await response.json();
console.log(data.accountNumber);

API 响应示例

列表端点 GET /wallets/{walletId}/virtual-accounts：

{
  "message": "Virtual accounts retrieved successfully",
  "statusCode": 200,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "accountNumber": "8012345678",
      "accountName": "Blockradar/John Doe",
      "bankName": "Wema Bank",
      "bankCode": "035",
      "isActive": true,
      "type": "AUTO_FUNDING",
      "label": "Customer Deposits",
      "createdAt": "2026-01-22T10:30:00.000Z",
      "updatedAt": "2026-01-22T10:30:00.000Z"
    }
  ],
  "meta": {
    "itemCount": 1,
    "totalItems": 1,
    "itemsPerPage": 10,
    "totalPages": 1,
    "currentPage": 1
  }
}

单账户端点 GET /wallets/{walletId}/virtual-accounts/{virtualAccountId}：

{
  "message": "Virtual account retrieved successfully",
  "statusCode": 200,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "accountNumber": "8012345678",
    "accountName": "Blockradar/John Doe",
    "bankName": "Wema Bank",
    "bankCode": "035",
    "isActive": true,
    "type": "AUTO_FUNDING",
    "label": "Customer Deposits",
    "createdAt": "2026-01-22T10:30:00.000Z",
    "updatedAt": "2026-01-22T10:30:00.000Z"
  }
}

需要帮助？

文档：虚拟账户指南
API 参考：虚拟账户端点
邮件支持：[email protected]

新功能虚拟账户

虚拟账户 API

新功能：虚拟账户 API 使企业能够创建和管理与主钱包或子地址关联的虚拟银行账户
法币转稳定币转换：客户可以通过传统银行转账接收 NGN 付款，自动转换为 cNGN 稳定币
自动充值支持：AUTO_FUNDING 类型账户在收到法币付款时自动铸造 cNGN 并转移到关联钱包
主钱包集成：创建直接关联到主钱包的虚拟账户
子地址集成：创建关联到特定子地址的虚拟账户以实现精细控制
账户管理：激活或停用虚拟账户以控制自动充值行为

您需要做什么

启用功能：联系 [email protected] 为您的企业启用虚拟账户
确保 cNGN 支持：确保您的主钱包支持 cNGN 稳定币资产
仅限主网：请注意虚拟账户仅在主网环境中可用
查阅 API 端点：查看虚拟账户 API 文档了解实现详情

API 端点

以下是虚拟账户操作的核心 API 端点：

主钱包端点

POST /wallets//virtual-accounts – 为主钱包创建虚拟账户
GET /wallets//virtual-accounts – 检索虚拟账户详情
PATCH /wallets//virtual-accounts/ – 更新虚拟账户状态

子地址端点

POST /wallets//addresses//virtual-accounts – 为子地址创建虚拟账户
GET /wallets//addresses//virtual-accounts – 检索虚拟账户详情
PATCH /wallets//addresses//virtual-accounts/ – 更新虚拟账户状态

主要功能

支持的货币：NGN（尼日利亚奈拉）用于法币付款，cNGN 用于稳定币转换
自动充值流程：收到付款时自动铸造和转移 cNGN（AUTO_FUNDING 类型）
账户激活：通过激活或停用账户控制自动充值行为
客户管理：使用客户信息（名字、姓氏、邮箱、电话）创建账户

更多信息，请参阅虚拟账户文档和 API 参考。

改进资产更新

cNGN 测试网代币地址更新

更新的 cNGN 测试网地址：cNGN 团队已更新其在多个网络上的测试网代币地址
新资产支持：在控制面板中添加了对更新后 cNGN 代币的支持
资产管理：之前的测试网地址现在标记为 “old”，将在 30 天后移除
Tron USDT 支持：添加了更新的 Tron USDT 支持地址，之前的地址标记为 “old”

您需要做什么

进入控制面板并添加新的 cNGN 资产（查找没有 “old” 标签的资产）
更新您的集成以使用新的测试网地址
旧的测试网地址将在 30 天后自动移除
注意：这些更改仅适用于测试网环境 - 主网地址保持不变

更新的测试网地址

网络	新 cNGN 合约地址
ASSETCHAIN	0x4c00E85cd0B0307D8ED0b5534Bc678776C4aa7D3
BASE	0x929A08903C22440182646Bb450a67178Be402f7f
BNBCHAIN	0x20354A3Ad3B67836ab9c6D7D82cF5e5Ddfe104dD
ETHEREUM	0xd076ceCB8af5D92F7f6F32bDf24Da708859593d3
POLYGON	0xf24B1Cee8cA70341FcefBCa10e7e4Db9A4896486
LISK	0x999E3A32eF3F9EAbF133186512b5F29fADB8a816

更新的 Tron USDT 地址

网络	新 Tron USDT 合约地址
TRON	TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf

有关 cNGN 稳定币项目的更多信息，请访问官方仓库。

​即将推出的变更

​产品更新

​智能体支付：x402 和 MPP

​变更内容

​您需要做什么

​Gateway：支持 Solana

​变更内容

​您需要做什么

​支持 OpenUSD（OUSD）

​变更内容

​您需要做什么

​Stellar：支持 PYUSD

​变更内容

​您需要做什么

​Stellar：支持 USDT

​变更内容

​您需要做什么

​法币提现：使用 amountSide 固定到账金额

​变更内容

​您需要做什么

​地址验证端点

​变更内容

​您需要做什么

​Webhook 载荷中的网络费用

​变更内容

​您需要做什么

​Stellar：Soroban 合约与 Muxed 收款地址

​变更内容

​您需要做什么

​cNGN 合约地址更新

​变更内容

​您需要做什么

​新合约地址

​cNGN 测试代币

​虚拟账户 API 重大变更

​为什么进行此变更

​变更内容

​新增端点

​分页详情

​新功能

​迁移指南

​API 响应示例

​需要帮助？

​虚拟账户 API

​您需要做什么

​API 端点

​主钱包端点

​子地址端点

​主要功能

​cNGN 测试网代币地址更新

​您需要做什么

​更新的测试网地址

​更新的 Tron USDT 地址

即将推出的变更

产品更新

智能体支付：x402 和 MPP

变更内容

您需要做什么

Gateway：支持 Solana

变更内容

您需要做什么

支持 OpenUSD（OUSD）

变更内容

您需要做什么

Stellar：支持 PYUSD

变更内容

您需要做什么

Stellar：支持 USDT

变更内容

您需要做什么

法币提现：使用 `amountSide` 固定到账金额

变更内容

您需要做什么

地址验证端点

变更内容

您需要做什么

Webhook 载荷中的网络费用

变更内容

您需要做什么

Stellar：Soroban 合约与 Muxed 收款地址

变更内容

您需要做什么

cNGN 合约地址更新

变更内容

您需要做什么

新合约地址

cNGN 测试代币

虚拟账户 API 重大变更

为什么进行此变更

变更内容

新增端点

分页详情

新功能

迁移指南

API 响应示例

需要帮助？

虚拟账户 API

您需要做什么

API 端点

主钱包端点

子地址端点

主要功能

cNGN 测试网代币地址更新

您需要做什么

更新的测试网地址

更新的 Tron USDT 地址