Advanced configuration

Sensible defaults mean most integrations need no configuration. These knobs are here for self-hosting and local development.

Base URL

By default everything talks to the production API at https://api.guveno.com/v1, so you never need to set it. If you run a self-hosted Guveno server (or point at a staging environment), override the base URL. Keep the /v1 path.

• SDK: pass baseUrl to the client: new GuvenoApiClient({ apiKey, baseUrl }).
• CLI: pass --base-url on any command, or save it once with guveno init --base-url ....
• Either: set the GUVENO_API_BASE_URL environment variable.

Environment variables

• GUVENO_API_KEY: the gv_live_... key used by the SDK and CLI when no key is passed explicitly.
• GUVENO_API_BASE_URL: override the API base URL (defaults to production).
• GUVENO_ENCRYPTION_PASSWORD: unlocks your encryption key for create/derive/reveal/sign without an interactive prompt.
• GUVENO_WALLET_HOME: directory for the CLI's local config cache (defaults to ~/.guveno).