Networks and contracts

Select BNB_TESTNET or BNB_MAINNET explicitly when creating a client. The SDK defaults to testnet; it does not choose an API hostname or switch the user’s wallet network.

Contract addresses

These addresses are exported by the EOA SDK network constants. Use the listed proxy addresses where applicable, not their implementation addresses.

Testnet
Mainnet

BNB testnet · chain 97 · gas token BNB

Contract	Address	Role
TokenVendingMachineV3	`0xeeddf88d5cb406cc27f6eea4636566b4943e3737`	Gacha payment and buybacks
RenaissRegistry (NFT)	`0x57eE95884Ac93E6d081Fd9366AFEF9891C8Eceb4`	Collectible ownership
Mock USDT	`0x3d2745c844cee4a62B66DF18b5Fd93781C26958b`	Payment token; 18 decimals
Permit2	`0x000000000022D473030F116dDEE9F6B43aC78BA3`	Signature-based token transfers
OrderBook	`0x2F562bAE70Ea1Efc9BFC7BC9ccE9a4e2d6bE8A6c`	Marketplace settlement
Cashier	`0x34C63BDD63c437aAd7dA28961817DEb981a06A29`	Redeem fee payment
Manager	`0xc3dc2f3a70742c5ec29b82a60a2d0fe1e3b558ed`	Redeem requests

BNB Smart Chain · chain 56 · gas token BNB

Contract	Address	Role
TokenVendingMachineV3	`0xd4d18607d6111c5fa2f93a4a5b2c0e28f1563f9f`	Gacha payment and buybacks
RenaissRegistry (NFT)	`0xF8646A3Ca093e97Bb404c3b25e675C0394DD5b30`	Collectible ownership
USDT	`0x55d398326f99059fF775485246999027B3197955`	Payment token; 18 decimals
Permit2	`0x000000000022D473030F116dDEE9F6B43aC78BA3`	Signature-based token transfers
OrderBook	`0xAE3e7268EF5A062946216A44f58A8F685fFD11d0`	Marketplace settlement
Cashier	`0x3F364C839fa0C81485d39E2887917153d95e63AF`	Redeem fee payment
Manager	`0xB95F8867fF54fd16342Cb414c0F57237be7Dc512`	Redeem requests

Other mainnet contracts

These protocol contracts are separate from the addresses used to configure the EOA SDK.

Contract	Address
CollectibleInventory	`0x14B662fC59f87Ec004c2C25E0A2a49c9f858ef8c`
TimelockController	`0xB4cc2a69B5E461Dbc76fEf668891D0E1E3b5C80a`

Fees and metadata

Constant	Value
`network.marketplace.platformFeeBps`	`200` (2%) on both networks
USDT decimals	`18` on both networks
`MAX_REDEMPTION_CARDS`	`50` per cart
`REDEMPTION_COUNTRIES`	Country codes, names and `requiresState` hints for shipping forms

import {
  BNB_MAINNET,
  BNB_TESTNET,
  MAX_REDEMPTION_CARDS,
  REDEMPTION_COUNTRIES,
} from '@renaiss-protocol/client';

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

The country metadata excludes CN and requires a state for AU, CA, ID, MX, MY, TH, US and VN. Use the exported list rather than copying it into your app. The API still validates destination eligibility, card limits and current shipping fees. Upgrade the SDK when contract addresses, marketplace fees or form metadata change. Never replace trusted signing expectations with values from a preparation response.

API deployments

Pair the selected network with a matching API and builder credential.

Environment	API base URL
Testnet evaluation	`https://dev-api.renaiss.xyz`
Production	`https://api.renaiss.xyz`

Use the generated API reference served by your selected deployment for its current routes, schemas and authentication requirements. For Redeem through a backend proxy, also configure the canonical walletSessionIssuer. On the testnet evaluation API it is https://dev-api.renaiss.xyz/v2/auth/wallet. Your frontend signing origin is a separate setting.

Getting started

Build a flow

Reference

Partner integrations

Networks and contracts

Contract addresses

Fees and metadata

API deployments

​Contract addresses

​Fees and metadata

​API deployments

Contract addresses

Fees and metadata

API deployments