Skip to main content

References

Type Aliases

Type AliasDescription
AccountComplete on-chain account information returned by the Keyban API.
AccountAssignmentPending loyalty assignment created before an account exists.
AddressRepresents an Ethereum address in hexadecimal format.
AgentWallet-
AgentWalletStatusString literal union of the agent wallet lifecycle statuses.
ApiErrorCode-
ApplicationApplication configuration and metadata.
ApplicationEventType-
ApplicationFeatureString literal union of the supported application features.
ApplicationThemeModeString literal union describing the theme mode options.
AuthMethod- email-otp: Authentication via a one-time password sent to the user's e-mail address. - phone-otp: Authentication via a one-time password sent by SMS to the user's phone number. - google: Authentication delegated to Google OAuth 2.0 / Sign-in with Google. - auth0: Authentication delegated to an Auth0 tenant (used for enterprise SSO and legacy flows).
AuthUserAuthenticated user profile.
CertificationKeyHistoryItemHistorical certification key item. Includes status, activation dates, and registered networks.
CertificationKeyResponseCertification key response with on-chain registration status. Includes registration status, registered networks, and rotation progress.
CertificationKeyStatusCertification key status enum. - active: Currently used for signing - pending: Awaiting on-chain rotation to complete - rotated: Replaced by a newer key, kept for verification - revoked: Compromised or manually revoked
CertificationKeyStatusCertification key status enum. - active: Currently used for signing - pending: Awaiting on-chain rotation to complete - rotated: Replaced by a newer key, kept for verification - revoked: Compromised or manually revoked
ChargebeeFeatureStable Chargebee feature IDs mapped to platform quota controls; also used as i18n translation keys on the frontend.
ChatRoleChat message role
CreateAgentWallet-
CreateImportMapperBody shape for creating an import mapper.
CreateInvestFund-
CreateInvestIdentity-
CreateInvestLockup-
CreateInvestNav-
CreateInvestOffer-
CreateSigner-
CurrencyFiat currencies supported by the loyalty engine for point accrual and redemption calculations (ISO 4217).
DidDocumentResponseW3C DID Document a tenant publishes at https://{domain}/.well-known/did.json so external verifiers can resolve did:web:{domain} and validate VC signatures without contacting Keyban.
DidWebConfigResponseResponse for GET / PUT /v1/dpp/certification-key/did-web-config. didDocument is null when the tenant has not configured a did:web domain.
DppAction-
DppActions-
DppApplicationMetricsDPP metrics for a specific application.
DppCertificationStatus-
DppClaimResultResult of a DPP claim operation.
DppMetricsDPP metrics for tracking Digital Product Passport lifecycle.
DppMetricsByOrgDPP metrics grouped by organization.
DppPassport-
DppPassportEventType-
DppPassportStatusString literal union of the DPP passport lifecycle statuses.
DppUncpc-
DynamicFieldDef-
DynamicFieldsType-
DynamicFieldType-
Event-
EventSubjectThe domain entity that an audit/quota event targets.
EventTypeThe type of audit/quota event.
EvmNetworkAllowed EVM network identifiers.
GoogleGeminiModelGoogle Gemini models supported in MVP Note: Gemini 1.5 models were retired in 2025, using 2.5 series
HashRepresents a cryptographic hash value in hexadecimal format.
HexRepresents a hexadecimal value in blockchain-related contexts.
ImportJob-
ImportJobProgress-
ImportJobReport-
ImportJobSource- upload: The import job was triggered by a user uploading a file (CSV/Excel) through the admin interface. - shopify: The import job was triggered by a Shopify product catalogue synchronisation.
ImportMapperAn import mapper: an ordered list of field mappings used to transform an imported JSON payload into a target model.
ImportMapperDestinationFieldA field an import-mapper row can write to, as a dot-path into the passport-creation input (e.g. product.name). required marks fields the input schema makes mandatory — the mapper form seeds a locked row for each.
ImportMapperRowA single row in an import mapper.
ImportMapperRowTypeType of an import-mapper row, describing how source is interpreted.
IntlString-
InvestFundInvestment fund definition.
InvestFundStatusStatus of an investment fund through its lifecycle.
InvestHoldingHolding record representing the shares held by an investor in a fund.
InvestIdentityInvestor identity with KYC lifecycle tracking.
InvestIdentityStatusKYC verification status of an investor identity.
InvestLockupCustom lockup period for an investor in a specific fund.
InvestNavNAV (Net Asset Value) record for an investment fund.
InvestOfferSecondary market offer for an investment fund.
InvestOfferTypeString literal union of the invest offer types.
InvestTransactionTransaction record for an investment fund. Represents a share movement: initial distribution, buy-back, or secondary market transfer. Either seller or buyer may be null depending on type.
InvestTransactionStatusString literal union of the invest transaction statuses.
InvestTransactionTypeString literal union of the invest transaction types.
JobStatusString literal union of the BullMQ job statuses.
LlmModelPricing-
LlmProviderSupported LLM providers
LlmUsageByModel-
LlmUsageByOrganization-
LlmUsageByProvider-
LlmUsageMeta-
LlmUsageMetadata-
LlmUsageRecord-
LlmUsageResponse-
LlmUsageTimeline-
LoyaltyApplicationMetricsLoyalty metrics for a specific application.
LoyaltyMetricsLoyalty metrics for tracking program engagement and customer behavior.
LoyaltyMetricsByOrgLoyalty metrics grouped by organization.
LoyaltyRewardTier-
Module-
MyInvestHoldingCurrent investor's holding in a fund (investor-facing, narrower than InvestHolding).
NativeCurrency-
NetworkUnion across every supported blockchain runtime.
ObjectEnum-
ObjectPaths-
OnChainStatusOn-chain certifier status. - registered: Key is registered and valid on at least one network - pending: Key exists but not yet registered on-chain
OnChainStatusOn-chain certifier status. - registered: Key is registered and valid on at least one network - pending: Key exists but not yet registered on-chain
OrderLoyalty order returned by the indexer.
OrderItemIndividual item within a loyalty order.
Organization-
OrganizationQuotas-
Permission-
Permissions-
Plan-
PlanFeature-
PlanPrice-
Prettify-
ProblemDetailsRFC 7807 Problem Details for HTTP APIs.
QuotaUsage-
RotateCertificationKeyResponseResponse from the certification key rotation endpoint. Includes new key details and number of on-chain rotation jobs queued.
SetDidWebDomainRequestBody for PUT /v1/dpp/certification-key/did-web-config. Pass domain: null to disable self-hosted DID Web and fall back to did:key.
ShopifyPassportFields-
ShopifyProductFields-
ShopifyShop-
Signer-
SignerStatusString literal union of the signer lifecycle statuses.
SignerType- agentic: Backend-controlled account using MPC/TSS; the private key is never exposed to the end user.
StarknetNetworkAllowed Starknet network identifiers.
Statements-
StellarNetworkAllowed Stellar network identifiers.
SupportedEmailLocaleBCP 47 language tags the backend i18n infrastructure ships email bundles for (nestjs-i18n + ICU MessageFormat, see ADR 0089). en-US is the source of truth; the others are translated bundles.
SupportedLocaleBCP 47 locale codes supported across the platform for user-facing content (e.g. DPP action labels, product descriptions). Source of truth shared between the backend, the admin UI and the DPP App.
TierDistributionTier distribution representing customer spread across loyalty tiers.
UntpAddress-
UntpBitstringStatusListEntry-
UntpCharacteristics-
UntpClaim-
UntpClassification-
UntpConformityTopic-
UntpCountry-
UntpCredentialIssuer-
UntpDimension-
UntpDpp-
UntpIdGranularity-
UntpImage-
UntpLink-
UntpMaterial-
UntpMeasure-
UntpPackage-
UntpParty-
UntpPartyRole-
UntpPerformance-
UntpPeriod-
UntpProduct-
UntpRenderTemplate2024-
UntpRole-
UntpScore-
UpdateAgentWallet-
UpdateImportMapperBody shape for updating an import mapper.
UpdateInvestFund-
UpdateInvestIdentity-
UpdateInvestLockup-
UpdateInvestOffer-
UpdateSigner-
VerifyDidWebConfigResponseDiscriminated result of POST /v1/dpp/certification-key/did-web-config/verify. Always returned with HTTP 200; status: 'failed' carries a reason matching a VerifyDidWebFailureReason value for actionable UI messaging.
WalletEventType-
WalletInstallationWallet installation metrics (Google and Apple Wallet adoption).

Variables

VariableDescription
AgentWalletStatusLifecycle status of an agent wallet.
ApiErrorCode-
ApplicationFeatureFlags describing which product surfaces (DPP, Loyalty, or Invest) are enabled for a given application. Used throughout the SDK to flip UI and API capabilities.
ApplicationThemeModeEnumerates the supported UI presentation modes for hosted applications. Typedoc consumers rely on this union to toggle light/dark specific assets.
AuthMethod-
ChargebeeFeature-
ChatRoleChat message role
Currency-
DppCertificationStatus-
DppPassportStatusLifecycle status of a DPP (Digital Product Passport).
EventSubject-
EventType-
EvmNetworkCanonical blockchain network identifiers supported by Keyban across EVM, Starknet, and Stellar stacks. These unions align with backend configuration keys and Tilt profiles to prevent drift.
FALLBACK_EMAIL_LOCALEFinal step of the locale cascade when nothing else resolves. Shared by the nestjs-i18n module (fallbackLanguage) and I18nService so the default locale is declared exactly once.
GoogleGeminiModelGoogle Gemini models supported in MVP Note: Gemini 1.5 models were retired in 2025, using 2.5 series
ImportJobSource-
importMapperDestinationFieldsPassport fields an import-mapper row can target. Each is a field explicitly tagged mappable on the passport-creation input schema (the very schema the import validates against — see createDppPassportInputSchema). Generated rather than hand-maintained so the list can never drift from the schema.
ImportMapperRowType-
InvestFundStatus-
InvestIdentityStatus-
InvestOfferTypeType of a secondary market offer.
InvestTransactionStatusStatus of an investment transaction through its lifecycle.
InvestTransactionTypeType of an investment transaction.
JobStatusStatus of a BullMQ job through its lifecycle.
LlmProviderSupported LLM providers
NetworkNormalized lookup that collapses duplicated enum values (e.g. both Starknet/Stellar define Mainnet) into a single Record consumable by Zod.
NETWORK_NATIVE_CURRENCY-
roleStatements-
SignerStatusLifecycle status of an agentic signer.
SignerType-
StarknetNetwork-
statements-
StellarNetwork-
supportedEmailLocaleSchemaBCP 47 language tags the backend i18n infrastructure ships email bundles for (nestjs-i18n + ICU MessageFormat, see ADR 0089). en-US is the source of truth; the others are translated bundles.
SupportedLocale-
UntpIdGranularity-
UntpRole-