Wallet Service Configuration

wallet-service.conf configures the core Wallet API v2 service. It is loaded by the wallet-service base feature.

The shipped config sets publicBaseUrl 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.

File Location

waltid-services/waltid-wallet-api2/config/wallet-service.conf

Fields

publicBaseUrl

String — Public-facing base URL of the wallet service.

The value is used when building response and redirect URLs, such as OID4VCI/OID4VP 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.

Example Configuration

# wallet-service.conf
publicBaseUrl = "http://localhost:4000"

For production, set it to your public HTTPS URL:

publicBaseUrl = "https://wallet.example.com"
Last updated on August 18, 2026