> ## Documentation Index
> Fetch the complete documentation index at: https://docs.renaiss.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 网络与合约

> 查看 BNB 测试网与主网的合约地址、支付单位、SDK 常量和 API 部署。

创建客户端时显式选择 `BNB_TESTNET` 或 `BNB_MAINNET`。SDK 默认使用测试网，但不会自动选择 API 主机或切换用户的钱包网络。

## 合约地址

下列地址由 EOA SDK 的网络常量导出。使用代理合约时请选择表中列出的代理地址，避免误用其实现合约地址。

> [tab] 测试网
>
> **BNB 测试网 · 链 ID 97 · Gas 代币 BNB**
>
> | 合约 | 地址 | 用途 |
> | - | - | - |
> | TokenVendingMachineV3 | [`0xeeddf88d5cb406cc27f6eea4636566b4943e3737`](https://testnet.bscscan.com/address/0xeeddf88d5cb406cc27f6eea4636566b4943e3737) | 抽卡支付及回购 |
> | RenaissRegistry (NFT) | [`0x57eE95884Ac93E6d081Fd9366AFEF9891C8Eceb4`](https://testnet.bscscan.com/address/0x57eE95884Ac93E6d081Fd9366AFEF9891C8Eceb4) | 藏品所有权 |
> | Mock USDT | [`0x3d2745c844cee4a62B66DF18b5Fd93781C26958b`](https://testnet.bscscan.com/address/0x3d2745c844cee4a62B66DF18b5Fd93781C26958b) | 支付代币，精度为 18 位 |
> | Permit2 | [`0x000000000022D473030F116dDEE9F6B43aC78BA3`](https://testnet.bscscan.com/address/0x000000000022D473030F116dDEE9F6B43aC78BA3) | 基于签名的代币转账 |
> | OrderBook | [`0x2F562bAE70Ea1Efc9BFC7BC9ccE9a4e2d6bE8A6c`](https://testnet.bscscan.com/address/0x2F562bAE70Ea1Efc9BFC7BC9ccE9a4e2d6bE8A6c) | 市场交易结算 |
> | Cashier | [`0x34C63BDD63c437aAd7dA28961817DEb981a06A29`](https://testnet.bscscan.com/address/0x34C63BDD63c437aAd7dA28961817DEb981a06A29) | 支付兑换费用 |
> | Manager | [`0xc3dc2f3a70742c5ec29b82a60a2d0fe1e3b558ed`](https://testnet.bscscan.com/address/0xc3dc2f3a70742c5ec29b82a60a2d0fe1e3b558ed) | 发起兑换请求 |

> [tab] 主网
>
> **BNB 智能链主网 · 链 ID 56 · Gas 代币 BNB**
>
> | 合约 | 地址 | 用途 |
> | - | - | - |
> | TokenVendingMachineV3 | [`0xd4d18607d6111c5fa2f93a4a5b2c0e28f1563f9f`](https://bscscan.com/address/0xd4d18607d6111c5fa2f93a4a5b2c0e28f1563f9f) | 抽卡支付及回购 |
> | RenaissRegistry (NFT) | [`0xF8646A3Ca093e97Bb404c3b25e675C0394DD5b30`](https://bscscan.com/address/0xF8646A3Ca093e97Bb404c3b25e675C0394DD5b30) | 藏品所有权 |
> | USDT | [`0x55d398326f99059fF775485246999027B3197955`](https://bscscan.com/address/0x55d398326f99059fF775485246999027B3197955) | 支付代币，精度为 18 位 |
> | Permit2 | [`0x000000000022D473030F116dDEE9F6B43aC78BA3`](https://bscscan.com/address/0x000000000022D473030F116dDEE9F6B43aC78BA3) | 基于签名的代币转账 |
> | OrderBook | [`0xAE3e7268EF5A062946216A44f58A8F685fFD11d0`](https://bscscan.com/address/0xAE3e7268EF5A062946216A44f58A8F685fFD11d0) | 市场交易结算 |
> | Cashier | [`0x3F364C839fa0C81485d39E2887917153d95e63AF`](https://bscscan.com/address/0x3F364C839fa0C81485d39E2887917153d95e63AF) | 支付兑换费用 |
> | Manager | [`0xB95F8867fF54fd16342Cb414c0F57237be7Dc512`](https://bscscan.com/address/0xB95F8867fF54fd16342Cb414c0F57237be7Dc512) | 发起兑换请求 |

> [accordion] 其他主网合约
>
> 以下为其他协议合约。配置 EOA SDK 时请使用上方地址。
>
> | 合约 | 地址 |
> | - | - |
> | CollectibleInventory | [`0x14B662fC59f87Ec004c2C25E0A2a49c9f858ef8c`](https://bscscan.com/address/0x14B662fC59f87Ec004c2C25E0A2a49c9f858ef8c) |
> | TimelockController | [`0xB4cc2a69B5E461Dbc76fEf668891D0E1E3b5C80a`](https://bscscan.com/address/0xB4cc2a69B5E461Dbc76fEf668891D0E1E3b5C80a) |

## 费用与常量

| 常量 | 值 |
| - | - |
| `network.marketplace.platformFeeBps` | 两个网络均为 `200`（2%） |
| USDT 小数位数 | 两个网络均为 `18` |
| `MAX_REDEMPTION_CARDS` | 每个购物车 `50` 张 |

```ts theme={null}
import {
  BNB_MAINNET,
  BNB_TESTNET,
  MAX_REDEMPTION_CARDS,
} from '@renaiss-protocol/client';

const network = BNB_TESTNET;
const { contracts, platformFeeBps } = network.marketplace;
const { cashierAddress, managerAddress } = network.redemption;
```

自行提供地址表单中的国家及地区选项。API 会根据金库地区和卡牌验证收货地并返回当前可用的配送服务。

合约地址、市场费率或购物车上限发生变化时，请升级 SDK。不要用准备接口返回的未验证值替换本地可信的签名校验值。

## API 部署

为所选网络配置对应的 API 和开发者凭据。

| 环境 | API 基础 URL |
| - | - |
| 测试网 | `https://dev-api.renaiss.xyz` |
| 生产环境 | `https://api.renaiss.xyz` |

在[接口参考](https://docs.renaiss.xyz/cn/api-reference.md#选择环境)中查看当前部署的路由、数据结构和身份验证要求。

通过后端代理接入兑换时，还须配置规范签发方 `walletSessionIssuer`。测试网为 `https://dev-api.renaiss.xyz/v2/auth/wallet`。另行注册[前端签名来源](https://docs.renaiss.xyz/cn/authentication.md#前端来源与签发方)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.