Wallet Service Configuration
The wallet-service.conf file configures the core wallet service. It is loaded by the wallet-service base feature.
File Location
waltid-services/waltid-wallet-api2/config/wallet-service.conf
Configuration Options
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
publicBaseUrl | String (URL) | Yes | – | Public-facing base URL of this wallet service. |
publicBaseUrl
The public-facing base URL of the wallet, used when building response and redirect URLs (e.g. OpenID4VCI/VP redirect URIs). It is the URL end users reach the wallet at, which is not necessarily the same as the API's bind port (webPort) — typically it points at the user-facing wallet frontend.
publicBaseUrl = "http://localhost:4000"
The value can be overridden with the WALLET_PUBLIC_BASE_URL environment variable.
The shipped config sets this to http://localhost:4000. A dedicated Wallet API v2 frontend is planned; until then this value is largely a placeholder, as the current API does not yet build user-facing redirect flows from it. Set it to the URL your wallet is publicly reachable at.
Example Configuration
# wallet-service.conf
publicBaseUrl = "http://localhost:4000"
For production, set it to your public HTTPS URL:
publicBaseUrl = "https://wallet.example.com"