Credentials

API credentials, on-chain identifiers, and smart contract addresses provided by Wirex.

Before You Start

Read the following guides before proceeding:

GuideWhy
Platform OverviewPlatform overview

API Credentials

Wirex provides the following credentials per environment:

CredentialFormatPurpose
client_idUUIDIdentifies your company for API requests
client_secretStringSecret key for S2S token exchange

On-Chain Identifier

CredentialFormatPurpose
partner_id16-byte hexOn-chain identifier for Account Abstraction operations

The partner_id is used as the parentEntity parameter when registering user wallets in the Accounts smart contract.


Blockchain Infrastructure

When deploying Smart Wallets directly (not using Wirex SDK), you receive the following endpoints per environment:

CredentialPurpose
Bundler RPC URLZeroDev bundler for UserOperation submission
Paymaster RPC URLZeroDev paymaster for gas sponsorship
RPC Provider URLBlockchain RPC endpoint

Rhino.fi Integration

For multi-chain deposits via global addresses:

CredentialPurpose
Rhino.fi API KeyCreating smart deposit addresses for cross-chain bridging

See Global Addresses for integration details.


Smart Contract Addresses

Wirex provides a ContractRegistry address per chain and environment. All other contract addresses are resolved dynamically from the registry using contractByName(name).

ContractRegistry Addresses

EnvironmentChainChain IDContractRegistry Address
SandboxBase Sepolia845320xC801a0f38E20500B5840c4927553b3409890bc3c
SandboxStellar Testnet9223372036854775806CBI44PUQEKP2IAD77ZPCTN2QX2IOWOSY5VYHI3SPBN4CAZY6BHR7KIVE
ProductionBase84530xAFa697ebC7919998AF5CdE325Fbe990dC926aae4
ProductionStellar9223372036854775806CC34TW4W4NUAS54WYPSAUK7RR4LMF4RSAJV555J6ZMTPGEVPAB3A563E

Contracts Resolved from Registry

Contract NamePurpose
AccountsUser registration (createUserAccountWithWallet)
FundsManagementExecutor module for oracle transactions
ExecutionDelayPolicyTime-lock policy for wallets
TokensRegistrySupported token list

See ABI Reference for contract ABIs and interface definitions.


Credential Storage

API Credentials

  • Store client_secret in a secrets manager (AWS Secrets Manager, HashiCorp Vault, GCP Secret Manager)
  • Never commit credentials to source control
  • Never expose credentials in client-side code or logs
  • Rotate credentials immediately if compromised

Partner ID

  • The partner_id can be stored in application configuration
  • It is not secret but should be validated against your expected value

Token Addresses

Production (Base - Chain ID 8453)

TokenAddressDecimals
USDC0x833589fCD6eDb6E08f4c7C32D4f71b54bdA029136
USDT0xfde4C96c8593536E31F229EA8f37b2ADa2699bb26
EURC0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb426
WUSD0xb4bB2032A73A53C0Aa7Dc9ee2d9658a978fA7bC218
WEUR0x379e120C1921bFD8f5E0A1a3C699e7e800b6660618

Sandbox (Base Sepolia - Chain ID 84532)

TokenAddressDecimals
USDC0x7Af7cDbd557eD302F7538Db1e3d094C8BBcA665c6
USDT0x2C6c7c00ACa9B9D8446d107367485079b047170618
EURC0xF70461ffb413981852683657A310892227e3989e6
WUSD0x0774164DC20524Bb239b39D1DC42573C3E4C697618
WEUR0x5c55F314624718019A326F16a62A05D6C6d8C8A218