Skip to content

Subscriptions with Wraith Names tutorial #127

Description

@truthixify

Tier: M (2-4 days) | Type: tutorial

Context. Recurring payment mechanics are already scattered across two pages: guides/spectre-stellar-cookbook.mdx has "Recipe 2: DAO Weekly Payroll in USDC on Stellar" (lines 289+) with a monthly-destination-rotation step and a full payroll scheduler; guides/stellar-payment-links.mdx lists subscription billing as a row in the expiry table (line 312). What no page covers is the .wraith name composition angle: how using a .wraith handle instead of a raw meta-address changes cancellation, migration, and name-expiry behavior in a subscription flow. This tutorial focuses on that composition, with the cookbook and payment-links pages linked as prerequisite reading.

Scope.

  • New guides/stellar/subscriptions-with-wraith-names.mdx.
  • Model: recipient publishes a .wraith name; payer schedules recurring stealth transfers keyed off the name (not the meta-address), so the recipient can rotate address without breaking the subscription.
  • Contrast against the cookbook's raw meta-address flow: what changes for cancellation, missed-payment behavior, and name-expiry edge case.
  • Off-chain scheduler pattern (link to cookbook Recipe 2 for the mechanics, do not duplicate).
  • End-to-end example (monthly USDC to merchant.wraith) showing a name rotation mid-subscription.

Acceptance.

  • Example runs against futurenet fixtures
  • Renders in mint dev
  • Passes Compile docs snippets CI
  • Cross-linked with wraith-names-lifecycle.mdx, stellar-payment-links.mdx, and spectre-stellar-cookbook.mdx Recipe 2
  • Nav entry under Guides

Files. guides/stellar/subscriptions-with-wraith-names.mdx (new), docs.json.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Stellar WaveIssues in the Stellar wave programdocsDocumentationdripsFunded via Drips Networkhelp wantedExtra attention is needednamesstellarTouches Stellar / Soroban codestellar-waveAuto-created for Wave 8tutorialAuto-created for Wave 8wave-8Auto-created for Wave 8writing

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions