tRPC Feature Flags API
tRPC Endpoints
tRPC Feature Flags API
Feature flag reads for global public surfaces and authenticated user-specific rollout decisions.
POST
tRPC Feature Flags API
The
featureFlags.* namespace is available on the tRPC base endpoint:
- Base endpoint:
POST /v1/trpc - Namespace:
featureFlags.*
Procedures
-
featureFlags.getGlobalFlags- Auth: public
- Purpose: read global yes/no feature flag defaults for public client surfaces that must not depend on wallet login state
- Input:
- required
featureKeys, 1-50 non-empty feature keys
- required
- Response:
flags: object keyed by requested feature key. A key resolves totrueonly when the feature row exists,is_active = true, anddefault_state = true; missing or inactive keys resolve tofalse.
- Does not evaluate per-user overrides, codes, percentage rollouts, country, plan, or app-version targeting.
-
featureFlags.getUserFlags- Auth: wallet session or API key with wallet context
- Purpose: evaluate user-specific feature flags with overrides, redeemed codes, rollouts, and defaults
- Input:
- optional
country - optional
planTier - optional
appVer
- optional
- Response:
flags: evaluated feature flags for the authenticated wallet userredeemedDescriptions: descriptions for redeemed feature-code gated access
Runtime Notes
- Use
getGlobalFlagsfor public UI gates such as default-on browse surfaces or global execution-route kill switches. - Use
getUserFlagsonly when the product behavior actually depends on the authenticated user, rollout bucket, override, or redeemed code state.