Embedded defaults
Production wallet and API origins are built into the SDK. Integrators do not need to configure URLs for live dApps.
| Constant | Default |
|---|---|
| WALLCARD_SDK_DEFAULT_WALLET_ORIGIN | https://webapp.wallcard.noderails.com |
| WALLCARD_SDK_DEFAULT_API_BASE_URL | https://api.wallcard.noderails.com |
createNoderailsCardProvider() options
| Option | Required | Description |
|---|---|---|
| mode | No | popup, iframe, or auto for connect + signing UI (default: popup) |
| walletOrigin | No | Override embedded wallet origin |
| apiBaseUrl | No | Override embedded API base URL |
| environment | No | development uses local NodeRails stack via env; default is production embedded URLs |
createNoderailsCardProvider({ mode: "popup" });
// Sandbox or staging override (optional)
createNoderailsCardProvider({
walletOrigin: "https://sandbox-webapp.wallcard.noderails.com",
apiBaseUrl: "https://sandbox-api.wallcard.noderails.com",
});Local development (NodeRails engineers)
Pass environment: "development" to resolve URLs from NEXT_PUBLIC_* / EXPO_PUBLIC_* (or localhost inference) instead of production defaults. Partner integrators normally omit this.
Sandbox
NodeRails will supply sandbox wallet and API origins for integration testing before production cutover.