generated: '2026-09-19'
method: derived
source: openapi/eqbuilder-dev-openapi.yml component schemas (52) + path structure; identifier semantics from llms.txt
  and /api/pricing. 200 response schemas are empty in the spec, so response entities are known only where a named
  *Response schema exists (public results, simulation result).
identifiers:
  wallet_address: 0x… EVM address (Base USDC default) or Solana base58 address — the durable identity of a paying
    bot; truncated on the public leaderboard
  tx_hash: settled payment transaction signature; single-use (409 on reuse); also the certificate key (/api/certificate/{tx_hash})
    and the ownership proof for wallet statements (auth_tx_hash)
  bot_id: bot registry key (reset/purge/fee paths)
  duel_id: /api/duel/challenge/{duel_id}, /api/duels/{duel_id}
  result_id: public result (/api/results/{result_id}) created with publish_result
  enrollment_id: coaching enrollment (/api/coaching/cert/{enrollment_id})
  workflow_id: Storelayer free-install workflow
  quote_id: Storelayer agent purchase/renewal/upgrade quote
  checkout_id + claim_secret: card-pack checkout pair; exchanged once for a bundle_token
  bundle_token: secret prepaid-credit token (X-BUNDLE-TOKEN), shown exactly once
  session_secret: per-participant role-play room secret
  referral code: /api/referral/status/{code}; returned as referral.your_code in paid responses
  profile: one of 28 personality profile ids (e.g. support_customer, analytical_executive) from GET /api/profiles
entities:
- name: ScoreInput
  kind: schema
  fields:
  - text
  - delay_seconds
  - profile
  - contact
  - data_consent
  - bot_role
  - model_family
  - applied_suggestion
  - wallet_address
  - source
  - result_ref
  required:
  - text
  - delay_seconds
  - profile
- name: SimulationPayload
  kind: schema
  fields:
  - tx_hash
  - wallet_address
  - target_profile
  - proposed_text
  - response_delay_seconds
  - mode
  - context
  - share_for_calibration
  - tier
  - referral_code
  - publish_result
  - result_ref
  required:
  - target_profile
  - proposed_text
  - response_delay_seconds
- name: SimulationResultResponse
  kind: schema
  fields:
  - status
  - tier
  - certificate_url
  - public_result_url
  required:
  - status
  - tier
- name: DuelPayload
  kind: schema
  fields:
  - tx_hash
  - wallet_address
  - duel_id
  - target_profile
  - prompt_id
  - proposed_text
  - response_delay_seconds
  - share_answer
  - result_ref
  required: []
- name: BundlePayload
  kind: schema
  fields:
  - tx_hash
  - wallet_address
  - referral_code
  - plan
  required: []
- name: CardCheckoutPayload
  kind: schema
  fields:
  - wallet_address
  - pack
  - auto_refill
  required:
  - wallet_address
  - pack
- name: CardClaimPayload
  kind: schema
  fields:
  - checkout_id
  - claim_secret
  required:
  - checkout_id
  - claim_secret
- name: CardRefillPayload
  kind: schema
  fields:
  - checkout_id
  - claim_secret
  required:
  - checkout_id
  - claim_secret
- name: EmbeddedCheckPayload
  kind: schema
  fields:
  - text
  - profile
  - delay_seconds
  - mode
  - context
  - request_id
  required:
  - text
- name: RewritePayload
  kind: schema
  fields:
  - wallet_address
  - tx_hash
  - target_profile
  - proposed_text
  - response_delay_seconds
  required: []
- name: ScriptCheckPayload
  kind: schema
  fields:
  - wallet_address
  - tx_hash
  - reply_text
  - approved_facts
  - source_text
  required: []
- name: StressTestPayload
  kind: schema
  fields:
  - wallet_address
  - tx_hash
  - proposed_text
  - response_delay_seconds
  required: []
- name: ProgressPayload
  kind: schema
  fields:
  - wallet_address
  - tx_hash
  required: []
- name: RoleplayOpenPayload
  kind: schema
  fields:
  - wallet_address
  - tx_hash
  - profile
  - open_to_any_partner
  required: []
- name: RoleplayTurnPayload
  kind: schema
  fields:
  - session_id
  - session_secret
  - text
  - delay_seconds
  - actual_feeling
  - read_feeling
  - read_why
  required: []
- name: RoleplayJoinPayload
  kind: schema
  fields:
  - session_id
  - wallet_address
  - profile
  required: []
- name: CoachingEnrollPayload
  kind: schema
  fields:
  - wallet_address
  - tx_hash
  - pack_id
  required: []
- name: CoachingDrillPayload
  kind: schema
  fields:
  - enrollment_id
  - coach_token
  - drill_id
  - text
  - delay_seconds
  required: []
- name: PublicResultResponse
  kind: schema
  fields:
  - result_id
  - canonical_url
  - observed_at
  - profile
  - score
  - claim
  - freshness
  - evidence
  - badge
  - actions
  required:
  - result_id
  - canonical_url
  - profile
  - score
  - claim
  - freshness
  - evidence
  - badge
  - actions
- name: PublicResultScoreResponse
  kind: schema
  fields:
  - percentage
  - passed_validation
  required:
  - percentage
  - passed_validation
- name: PublicResultProfileResponse
  kind: schema
  fields:
  - id
  - version
  required:
  - id
  - version
- name: ReferenceProfileEntry
  kind: schema
  fields:
  - profile_name
  - description
  - text_sample
  - metrics_target
  - behavioral_delay_bounds
  required:
  - profile_name
  - metrics_target
  - behavioral_delay_bounds
- name: ReferenceProfileMetrics
  kind: schema
  fields:
  - formality
  - directness
  - hesitation_tolerance
  required:
  - formality
  - directness
  - hesitation_tolerance
- name: WishlistInput
  kind: schema
  fields:
  - need
  - audience
  - bot_role
  required:
  - need
- name: StorelayerMatchInput
  kind: schema
  fields:
  - job
  - source
  required:
  - job
- name: StorelayerFreeInstallStart
  kind: schema
  fields:
  - origin
  - widget_id
  - storefront_need
  required:
  - origin
- name: FreeScoreContactInput
  kind: schema
  fields:
  - contact
  - source
  required:
  - contact
- name: SolanaVerifyInput
  kind: schema
  fields:
  - signature
  - network
  required:
  - signature
- name: PersonalityProfile
  kind: observed
  fields:
  - name
  - category
  - trait targets (EQ, formality, directness, hesitation, punctuation, response-delay cadence)
  source: GET /api/profiles (28 profiles)
- name: LedgerTransaction
  kind: observed
  fields:
  - wallet
  - tx_hash
  - product
  - tier
  - lamports/USDC charged
  - passed
  - date
  source: GET /api/ledger, /api/stats aggregates, wallet statement
- name: Certificate
  kind: observed
  fields:
  - tx_hash
  - profile
  - score
  - niche rank
  - shareable URL
  source: GET /api/certificate/{tx_hash} (JSON or HTML)
- name: ArenaRating
  kind: observed
  fields:
  - rating (starts 1000, ±24/session, Elo K=32 duels, idle decay 5/day after 7 days, max 150)
  source: 402 body arena.note; GET /api/leaderboard
relationships:
- from: Wallet
  to: LedgerTransaction
  type: has_many
  via: wallet_address
- from: LedgerTransaction
  to: Certificate
  type: has_one
  via: tx_hash (passed sessions only)
- from: LedgerTransaction
  to: PersonalityProfile
  type: belongs_to
  via: target_profile
- from: Wallet
  to: ArenaRating
  type: has_one
  via: wallet_address
- from: Duel
  to: LedgerTransaction
  type: has_many
  via: one paid leg per bot (tx_hash)
- from: Duel
  to: DuelPrompt
  type: belongs_to
  via: prompt_id
- from: Wallet
  to: BundleToken
  type: has_many
  via: POST /api/bundle or card claim
- from: CardCheckout
  to: BundleToken
  type: has_one
  via: checkout_id + claim_secret → bundle_token
- from: BundleToken
  to: EmbeddedCheck
  type: has_many
  via: X-BUNDLE-TOKEN; one credit per accepted request
- from: Wallet
  to: CoachingEnrollment
  type: has_many
  via: enrollment_id
- from: CoachingEnrollment
  to: CoachingPack
  type: belongs_to
  via: pack
- from: RoleplayRoom
  to: Wallet
  type: has_many
  via: two participants, each with a session_secret
- from: Wallet
  to: ReferralCode
  type: has_one
  via: referral.your_code
- from: Wallet
  to: Wallet
  type: belongs_to
  via: referral_code (referrer, bound at first paid purchase)
- from: PublicResult
  to: LedgerTransaction
  type: belongs_to
  via: publish_result / result_ref
- from: StorelayerFreeInstallWorkflow
  to: StorelayerCatalogEntry
  type: belongs_to
  via: widget slug