{"name":"cast","description":"Host private RSS feeds and episodes for podcast distribution. One wallet, no podcast-host signup.","tags":["podcast-hosting","podcast","rss","feed","audio"],"auth":["secp256k1-schnorr-v2"],"auth_audience":{"dvm_id":"c0fc2b10-4428-4507-9af6-c3f43f9361f5","builder_pubkey":"ff3b2baf3cc9b11faf5bbebec0b0639ceb4d87c18f4f238615853df1ad7c2b68"},"protocol_version":1,"sdk_sha":"14d450bc74c5f512352d13ae5694400e8e2e194e","deploy_id":"ca7ac858-0153-44b8-8d2e-be13ca1f4a7a","owner":{"handle":"dvmkit","display_name":"dvmkit","avatar_url":null,"type":"org"},"builder":{"pubkey":"ff3b2baf3cc9b11faf5bbebec0b0639ceb4d87c18f4f238615853df1ad7c2b68","attestation":{"dvm_id":"c0fc2b10-4428-4507-9af6-c3f43f9361f5","slug":"cast","capabilities_hash":"54d3d4ff3e8be6f44b5a29a540870b1cf4f783533887d7771b7398ab98101c84","builder_pubkey":"ff3b2baf3cc9b11faf5bbebec0b0639ceb4d87c18f4f238615853df1ad7c2b68","receipt_pubkey":"72051ef31cdee527d7a01c84839bbe86e03ca091ee4157fd57c3268113ad6a3e","deployed_at":1795273865},"signature":"ea6d356f2e0e7659dd95a19bfb6d32064cc6277e9b5d0f7bbecc413c2cffd067a1649508fae9f70893819d150a6b3582ffc32e02bfbbfa9b998e8ef452e54a41"},"receipts":true,"request_recovery":true,"credit":{"balance_payment":true,"standing_mandate":true,"mandate_skipped":true,"jit_refund_park":true,"min_micro":100000,"max_micro":20000000,"ttl_ms":7776000000,"currency":"usd","funding":["cashu","x402","tempo","lightning","stripe"],"tempo":{"methods":[{"method":"tempo","intent":"session"}]},"x402":{"schemes":[{"scheme":"batch-settlement","network":"eip155:8453"}]},"lightning_min_micro":697602,"stripe":{"network_id":"profile_61VgnRtFqQLcajMW5A6VgnRtNvE92NHPeeyDjYRjkR7o","checkout":true,"min_micro":5000000,"currency":"usd"}},"mints":["https://mint.coinos.io","https://mint.lnvoltz.com"],"capabilities":{"add-episode":{"description":"Add an episode to a private RSS feed. Audio comes from one of two sources (supply exactly one): `episode.audio_url` (a public https URL cast fetches) or `episode.audio_upload_handle` (a handle from POST /v1/ingest/audio, for bytes you hold with no hosting). The first add-episode against a `feed_slug` creates the feed and seeds its title from `feed_title`; feed-level metadata (title, description, author, category, explicit, cover art) is set and edited anytime, post-publish, via the free `update-feed` capability — set the feed's cover art there, not here. Optional per-episode artwork rides on `episode.episode_image_url` or `episode.episode_image_upload_handle` (upload local image bytes via POST /v1/ingest/image first). Episode fields (title, description, artwork, transcript, chapters) are editable post-publish via the free `update-episode` capability, which preserves the episode's GUID — correct a typo or swap artwork without re-downloading on clients. (Swapping the audio itself is still delete + re-add.) Requires `episode.ttl_days`: the retention window (in days) the episode and its public RSS enclosure stay live before being auto-deleted — it drives both storage cost and how permanent the episode is. TTL is a consequential operator choice: for real published episodes, surface and confirm it with the human operator rather than silently choosing a long value (see the ttl_days field docs for guideline windows).","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pubkey":{"type":"string","pattern":"^[0-9a-f]{64}$"},"signature":{"type":"string","pattern":"^[0-9a-f]{128}$"},"timestamp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nonce":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,64}$"},"feed_slug":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"},"feed_title":{"type":"string","minLength":1,"maxLength":200,"description":"Feed display title. Seeds the feed's title when this add-episode first creates the feed_slug; on later episodes it is ignored. Edit the live feed's title (and all other feed-level metadata) anytime, post-publish, via the free update-feed capability."},"episode":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","maxLength":5000},"audio_url":{"type":"string","format":"uri","description":"Audio source by URL-fetch: a public https URL cast HEAD-fetches at quote time and streams into storage after payment. Supply exactly one of audio_url or audio_upload_handle. Use audio_upload_handle instead when you have the bytes in hand with no hosting (e.g. a HEAD/fetch against the source URL fails)."},"audio_upload_handle":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"Audio source by staged bytes-upload: the upload_handle UUID returned by a prior POST /v1/ingest/audio call, signed by this same pubkey. The bytes already live in cast's staging area. Supply exactly one of audio_url or audio_upload_handle."},"ttl_days":{"type":"integer","minimum":1,"maximum":3650,"description":"Retention window in days: how long this episode and its public RSS enclosure stay live. At expiry the episode is auto-deleted, drops out of the feed, and its bytes are gone — irreversible (re-publish to restore). Storage cost scales with size × days. Range 1–3650 (1 day to 10 years); REQUIRED, there is no default — it is a deliberate choice. Guideline windows: 1–7 for smoke tests / drafts, 30–90 for disposable digests, 365–3650 for canonical podcast-feed material. TTL is a consequential operator decision: for real published episodes, surface and confirm it with the human operator rather than silently picking a long value."},"chapters":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"title":{"type":"string","minLength":1,"maxLength":200},"image_url":{"type":"string","format":"uri"}},"required":["start_seconds","title"]}},"transcript":{"type":"object","properties":{"content":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["text/plain","text/vtt","application/srt","application/json"]},"language":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})*(-[A-Z]{2})?$","description":"BCP-47 language tag for the transcript (e.g. \"en\", \"en-US\")."}}},"episode_image_url":{"type":"string","format":"uri","description":"Optional per-episode artwork by https URL: a square JPEG/PNG/WebP at ≥ 1400×1400, rendered as <itunes:image> on the episode. Editable post-publish via update-episode (preserving the episode's GUID). Mutually exclusive with episode_image_upload_handle. Feed cover art is separate — set it via update-feed."},"episode_image_upload_handle":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"Optional per-episode artwork by staged bytes-upload: the upload_handle UUID from a prior POST /v1/ingest/image call (same pubkey), for locally generated/selected images with no hosting. Mutually exclusive with episode_image_url."}},"required":["title","ttl_days"]}},"required":["pubkey","signature","timestamp","nonce","feed_slug","feed_title","episode"]},"pricing":{"quote":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pubkey":{"type":"string","pattern":"^[0-9a-f]{64}$"},"signature":{"type":"string","pattern":"^[0-9a-f]{128}$"},"timestamp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nonce":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,64}$"},"feed_slug":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"},"feed_title":{"type":"string","minLength":1,"maxLength":200,"description":"Feed display title. Seeds the feed's title when this add-episode first creates the feed_slug; on later episodes it is ignored. Edit the live feed's title (and all other feed-level metadata) anytime, post-publish, via the free update-feed capability."},"episode":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","maxLength":5000},"audio_url":{"type":"string","format":"uri","description":"Audio source by URL-fetch: a public https URL cast HEAD-fetches at quote time and streams into storage after payment. Supply exactly one of audio_url or audio_upload_handle. Use audio_upload_handle instead when you have the bytes in hand with no hosting (e.g. a HEAD/fetch against the source URL fails)."},"audio_upload_handle":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"Audio source by staged bytes-upload: the upload_handle UUID returned by a prior POST /v1/ingest/audio call, signed by this same pubkey. The bytes already live in cast's staging area. Supply exactly one of audio_url or audio_upload_handle."},"ttl_days":{"type":"integer","minimum":1,"maximum":3650,"description":"Retention window in days: how long this episode and its public RSS enclosure stay live. At expiry the episode is auto-deleted, drops out of the feed, and its bytes are gone — irreversible (re-publish to restore). Storage cost scales with size × days. Range 1–3650 (1 day to 10 years); REQUIRED, there is no default — it is a deliberate choice. Guideline windows: 1–7 for smoke tests / drafts, 30–90 for disposable digests, 365–3650 for canonical podcast-feed material. TTL is a consequential operator decision: for real published episodes, surface and confirm it with the human operator rather than silently picking a long value."},"chapters":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"title":{"type":"string","minLength":1,"maxLength":200},"image_url":{"type":"string","format":"uri"}},"required":["start_seconds","title"]}},"transcript":{"type":"object","properties":{"content":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["text/plain","text/vtt","application/srt","application/json"]},"language":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})*(-[A-Z]{2})?$","description":"BCP-47 language tag for the transcript (e.g. \"en\", \"en-US\")."}}},"episode_image_url":{"type":"string","format":"uri","description":"Optional per-episode artwork by https URL: a square JPEG/PNG/WebP at ≥ 1400×1400, rendered as <itunes:image> on the episode. Editable post-publish via update-episode (preserving the episode's GUID). Mutually exclusive with episode_image_upload_handle. Feed cover art is separate — set it via update-feed."},"episode_image_upload_handle":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"Optional per-episode artwork by staged bytes-upload: the upload_handle UUID from a prior POST /v1/ingest/image call (same pubkey), for locally generated/selected images with no hosting. Mutually exclusive with episode_image_url."}},"required":["title","ttl_days"]}},"required":["pubkey","signature","timestamp","nonce","feed_slug","feed_title","episode"]}},"rates":[{"amount":"0.02","currency":"USD","per":"episode"},{"amount":"0.00512","currency":"USD","per":"GiB per day stored"}]}},"update-feed":{"description":"Update any feed-level metadata — title, description, author, language, category, explicit, owner (name + email, for the Apple-required <itunes:owner> block), copyright, podcast type (episodic/serial), and cover art — on an existing cast feed. Cover art accepts either an https URL (`feed.cover_image_url`) or a staged image-upload handle (`feed.cover_image_upload_handle`) from POST /v1/ingest/image, for images you generated or selected locally with no hosting. Every field is editable post-publish; pass only the fields you want changed. Safe to run after the feed is live: preserves the feed URL/identity and returns the updated metadata so you can verify the change.","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pubkey":{"type":"string","pattern":"^[0-9a-f]{64}$"},"signature":{"type":"string","pattern":"^[0-9a-f]{128}$"},"timestamp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nonce":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,64}$"},"feed_slug":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"},"feed":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200,"description":"Feed display title. Seeded at first add-episode via feed_title; fully editable here post-publish without changing the feed URL/identity (DVM-1015)."},"description":{"type":"string","minLength":1,"maxLength":4000},"language":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})*(-[A-Z]{2})?$","description":"BCP-47 language tag for the feed (e.g. \"en\", \"en-US\")."},"author":{"type":"string","minLength":1,"maxLength":255},"category":{"type":"string","minLength":1,"maxLength":255,"description":"iTunes category, optionally nested with \" > \" (e.g. \"Technology > Podcasting\")."},"explicit":{"type":"boolean"},"owner_name":{"type":"string","minLength":1,"maxLength":255,"description":"Podcast owner name for the <itunes:owner> block. Independent of author — set it explicitly. Apple Podcasts commonly expects both owner name and email on feed submission; copying author here is a sensible default."},"owner_email":{"type":"string","maxLength":255,"format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"Podcast owner email for the <itunes:owner> block. Required by Apple Podcasts for feed submission. Apple commonly expects both owner name and email."},"copyright":{"type":"string","minLength":1,"maxLength":255,"description":"Channel-level copyright string (e.g. \"© 2026 Jane Smith\")."},"itunes_type":{"type":"string","enum":["episodic","serial"],"description":"Podcast type: episodic (default) for standalone episodes, serial for ordered seasons."},"cover_image_url":{"type":"string","format":"uri","description":"Feed cover art by https URL: a square JPEG/PNG/WebP at ≥ 1400×1400 that cast fetches, validates, and re-hosts. The feed-level artwork podcast apps display. Mutually exclusive with cover_image_upload_handle."},"cover_image_upload_handle":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"Feed cover art by staged bytes-upload: the upload_handle UUID from a prior POST /v1/ingest/image call (same pubkey), for locally generated/selected images with no hosting. The validated bytes are server-side-copied into the feed cover key. Recommended flow: generate/select image → POST /v1/ingest/image → update-feed with this handle. Mutually exclusive with cover_image_url (DVM-1016)."}}}},"required":["pubkey","signature","timestamp","nonce","feed_slug","feed"]}},"update-episode":{"description":"Patch an existing episode's metadata in place — title, description, per-episode artwork (`episode.episode_image_url` or `episode.episode_image_upload_handle`), transcript, and chapters — selected by `feed_slug` + `episode_id`. Free. Preserves the episode's GUID, pub_date, feed position, and audio enclosure, so podcast clients see an edit (not a re-download or reorder), unlike delete + re-add. Pass only the fields you want changed; artwork/transcript/chapters are replace-only (the prior R2 object is cleaned up). Audio enclosure swaps are out of scope — that is still delete + re-add. Returns the post-update episode metadata so you can verify the change.","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pubkey":{"type":"string","pattern":"^[0-9a-f]{64}$"},"signature":{"type":"string","pattern":"^[0-9a-f]{128}$"},"timestamp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nonce":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,64}$"},"feed_slug":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"},"episode_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"},"episode":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":500},"description":{"type":"string","minLength":1,"maxLength":5000},"chapters":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"start_seconds":{"type":"number","minimum":0},"title":{"type":"string","minLength":1,"maxLength":200},"image_url":{"type":"string","format":"uri"}},"required":["start_seconds","title"]},"description":"Replace the episode's chapter markers wholesale. Re-renders the JSON Chapters file in place under the episode's GUID; the prior file is overwritten."},"transcript":{"type":"object","properties":{"content":{"type":"string","minLength":1},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["text/plain","text/vtt","application/srt","application/json"]},"language":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Za-z]{2,4})*(-[A-Z]{2})?$","description":"BCP-47 language tag for the transcript (e.g. \"en\", \"en-US\")."}},"description":"Replace the episode's transcript wholesale (exactly one of inline content or external url, like add-episode). Any prior inline transcript object is deleted."},"episode_image_url":{"type":"string","format":"uri","description":"Replace per-episode artwork by https URL: a square JPEG/PNG/WebP at ≥ 1400×1400. The prior artwork object is deleted. Mutually exclusive with episode_image_upload_handle."},"episode_image_upload_handle":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$","description":"Replace per-episode artwork by staged bytes-upload: the upload_handle UUID from a prior POST /v1/ingest/image call (same pubkey). Mutually exclusive with episode_image_url."}}}},"required":["pubkey","signature","timestamp","nonce","feed_slug","episode_id","episode"]}},"delete-episode":{"description":"Delete a single episode from an existing cast feed (owner-signed; idempotent)","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pubkey":{"type":"string","pattern":"^[0-9a-f]{64}$"},"signature":{"type":"string","pattern":"^[0-9a-f]{128}$"},"timestamp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nonce":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,64}$"},"feed_slug":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"},"episode_id":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"}},"required":["pubkey","signature","timestamp","nonce","feed_slug","episode_id"]}},"delete-feed":{"description":"Delete an entire cast feed and cascade to all its episodes (owner-signed; idempotent)","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pubkey":{"type":"string","pattern":"^[0-9a-f]{64}$"},"signature":{"type":"string","pattern":"^[0-9a-f]{128}$"},"timestamp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nonce":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,64}$"},"feed_slug":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}},"required":["pubkey","signature","timestamp","nonce","feed_slug"]}},"list-feeds":{"description":"List all RSS feeds owned by the calling pubkey, with canonical feed URLs and metadata (owner-signed; free). The recovery path for rediscovering feeds without external memory.","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pubkey":{"type":"string","pattern":"^[0-9a-f]{64}$"},"signature":{"type":"string","pattern":"^[0-9a-f]{128}$"},"timestamp":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"nonce":{"type":"string","pattern":"^[a-zA-Z0-9_-]{8,64}$"}},"required":["pubkey","signature","timestamp","nonce"]}}},"payment":{"methods":["cashu","x402","tempo"]},"x402":{"pay_to":"0xFBb2b3101CA6B24A56436534a1849270548Db264","network":"eip155:8453","asset":"USDC","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","dual_serve":true},"tempo":{"methods":[{"method":"tempo","intent":"charge"},{"method":"tempo","intent":"session"}],"realm":"dvmkit-cast","recipient":"0xFBb2b3101CA6B24A56436534a1849270548Db264","payment_token":"0x20C000000000000000000000b9537d11c60E8b50","chain_id":4217,"operator":"0x74A3fF9b51408C11Bc477dfFF8712cFC25707067","fee_token":"0x20C000000000000000000000b9537d11c60E8b50"},"cashu":{"mints":["https://mint.coinos.io","https://mint.lnvoltz.com"],"lock_pubkeys":["03cea50b2cdffc6a7fd2ffebd0a72fc8ad0045259b2ebd831ebff5e25f326c8620"],"lock_pubkey_grace_seconds":86400,"min_locktime":604800,"canonical_id":"c0fc2b10-4428-4507-9af6-c3f43f9361f5"}}