@domino-sdk/relay 1.56.0 → 1.60.0

package/dist/authoring.d.ts

@@ -1,24 +1,23 @@
-import { x as xContentBodySchema, I as IdentityKind, y as customSourceSchema, W as WithRecordData, z as WithContent, B as WithAccountRoles, C as ResourceHandle, D as QuestHandle, L as LedgerReference, G as GroupHandle, F as pointLedgerDeclarationSchema, H as TrackerSource, J as trackerDefinitionSchema, N as Tracker, U as TrackerData, V as SourceRoles, X as LedgerHandle, Y as TrackerDataSchema, Z as xSearchSourceSchema, _ as XTweet, $ as XContentMetric, a0 as TrackerTriggerPolicy, a1 as Where, a2 as MemberIdentity, P as PointBalance, a3 as ReferralHandle, a4 as TrackerTriggerContext, a5 as TrackerReader, a6 as TextReviewInput, a7 as TextResult, a8 as PhotoResult, a9 as Decision, aa as rewardSchema, ab as TrackerTriggerMode, ac as RoleOf, ad as WhereSetting, ae as ContentBody, af as BadgeHandle, ag as ContentMetricName, ah as triggerSchema, k as QuestPresentation, l as QuestProfile, m as QuizEvidence, ai as TieredRewardDefinition } from './schema-C4m9RhCR.js';
-export { aj as LedgerSetting, ak as TrackerPage, al as TrackerReadQuery, am as trackerDataSchema, an as trackerTriggerContextSchema } from './schema-C4m9RhCR.js';
-import { M as MemberCompletion, B as Budget } from './capability-error-DSd8EMQC.js';
-export { C as CapabilityError, a as CapabilityErrorCode, c as capabilityErrorCodes } from './capability-error-DSd8EMQC.js';
-import { d as ProfileReferral } from './profiles-BoOK03cR.js';
+import { B as xContentBodySchema, I as IdentityKind, C as customSourceSchema, W as WithRecordData, D as WithContent, F as WithAccountRoles, y as ResourceHandle, x as QuestHandle, L as LedgerReference, G as GroupHandle, H as pointLedgerDeclarationSchema, J as TrackerSource, N as trackerDefinitionSchema, U as Tracker, V as TrackerData, X as SourceRoles, Y as LedgerHandle, Z as TrackerDataSchema, _ as xSearchSourceSchema, $ as XTweet, a0 as XContentMetric, a1 as TrackerTriggerPolicy, a2 as Where, a3 as MemberIdentity, P as PointBalance, a4 as ReferralHandle, a5 as TrackerTriggerContext, a6 as TrackerReader, a7 as TextReviewInput, a8 as TextResult, z as PhotoResult, a9 as Decision, aa as rewardSchema, ab as TrackerTriggerMode, ac as RoleOf, ad as WhereSetting, ae as ContentBody, af as BadgeHandle, ag as ContentMetricName, ah as triggerSchema, k as QuestPresentation, l as QuestProfile, m as QuizEvidence, ai as TieredRewardDefinition } from './schema-CwbRkmlr.js';
+export { aj as LedgerSetting, ak as TrackerPage, al as TrackerReadQuery, am as trackerDataSchema, an as trackerTriggerContextSchema } from './schema-CwbRkmlr.js';
+import { M as MemberCompletion, B as Budget, A as AuthorBudget } from './capability-error-DufwG3G0.js';
+export { C as CapabilityError, a as CapabilityErrorCode, c as capabilityErrorCodes } from './capability-error-DufwG3G0.js';
+import { N as NftCollection, o as ContractCall, p as ContractEvent, S as SolanaProgram, q as WalletBalanceSourceQuery, r as WalletTransaction, s as WalletInstruction, e as ProfileReferral, t as WalletReader } from './wallet-DZWL7lJH.js';
+export { u as ContractCallParts, v as ContractCallReturnType, w as ContractEventInput, x as ContractEventParts, y as ContractFunction, z as CosmosDenom, a as CosmosNetwork, E as EvmChainId, B as NftCollectionParts, D as NftStandard, F as WalletBalance, G as WalletBalanceChange, H as WalletBalanceQuery, I as WalletBalanceSample, J as WalletCall, K as WalletCallArgument, M as WalletCallQuery, Q as WalletDelegations, R as WalletDelegationsQuery, T as WalletEventCondition, U as WalletEventValue, V as WalletEvents, X as WalletEventsQuery, Y as WalletNfts, Z as WalletNftsQuery, _ as WalletTransactions, $ as WalletTransactionsQuery, a0 as cosmosDenomSchema, a1 as cosmosNetworkSchema, a2 as isContractCall, a3 as isContractEvent, a4 as isEvmChainId, a5 as isNftCollection, a6 as isSolanaProgram, a7 as maxWalletEventLogs, a8 as maxWalletEventLookback, a9 as maxWalletTransactionLookback, aa as maxWalletTransactions, ab as parseContractCall, ac as parseContractEvent, ad as parseContractFunction, ae as parseNftCollection } from './wallet-DZWL7lJH.js';
 import * as z from 'zod';
 export { z } from 'zod';
-import { f as badgeDeclarationSchema, B as Badge } from './offers-CtzMeB7O.js';
-export { g as defineOffer } from './offers-CtzMeB7O.js';
-import { E as EngagementBudget, l as leaderboardDefinitionSchema, m as AuthoringIdentity, r as referralAuthoringSchema, C as CampaignDefinition, A as AvailabilityWindow } from './groups-DPE004_V.js';
-export { n as defineCampaign, o as defineGroup } from './groups-DPE004_V.js';
-import { d as discordMessagesSourceSchema, D as DiscordMessageData, c as DiscordMessageTextData, e as discordReactionsSourceSchema, f as DiscordReactionData, g as TelegramReader, h as DiscordReader } from './accounts-DRPENuZe.js';
-export { i as TelegramChatMember, j as TelegramChatMemberStatus, k as TelegramReactionData } from './accounts-DRPENuZe.js';
+import { f as badgeDeclarationSchema, B as Badge } from './offers-CqXfMIxq.js';
+export { g as defineOffer } from './offers-CqXfMIxq.js';
+import { E as EngagementBudget, m as leaderboardDefinitionSchema, l as AuthoringIdentity, r as referralAuthoringSchema, C as CampaignDefinition, A as AvailabilityWindow } from './groups-9Jm3peq3.js';
+export { n as defineCampaign, o as defineGroup } from './groups-9Jm3peq3.js';
+import { d as discordMessagesSourceSchema, D as DiscordMessageData, c as DiscordMessageTextData, e as discordReactionsSourceSchema, f as DiscordReactionData, g as TelegramReader, h as DiscordReader } from './accounts-DoabriBX.js';
+export { i as TelegramChatMember, j as TelegramChatMemberStatus, k as TelegramMessageData, l as TelegramReactionData } from './accounts-DoabriBX.js';
 import { a as StreakPolicy, Q as QuizContent } from './streaks-0YuipsUQ.js';
-import { R as ResourceSource, S as Setting, A as AmountSetting, B as BalanceChain, I as IntegrationModule, a as BoundSettings } from './integrations-CcD5NPEA.js';
-export { D as DashboardInput, b as DashboardPanelInput, T as TikTokVideoBody, c as TikTokVideoMetric, Y as YouTubeShortBody, d as YouTubeShortMetric, e as defineDashboard } from './integrations-CcD5NPEA.js';
-import { P as Prerequisite, T as TextEvidence, U as UrlEvidence, a as TextOptions, b as UrlOptions } from './submission-input-wTiYGdgA.js';
-export { c as balanceAtLeast, d as completed, i as inGroup } from './submission-input-wTiYGdgA.js';
-import { I as ImageReader, X as XReader } from './x-1czZFVUW.js';
-import { h as WalletReader } from './wallet-Ac7OFpOr.js';
-export { i as CosmosDenom, a as CosmosNetwork, E as EvmChainId, j as WalletBalance, k as WalletBalanceQuery, l as cosmosDenomSchema, m as cosmosNetworkSchema, n as isEvmChainId } from './wallet-Ac7OFpOr.js';
+import { R as ResourceSource, S as Setting, A as AmountSetting, B as BalanceChain, I as IntegrationModule, a as BoundSettings, b as Announcement } from './integrations-CmIkP1Gi.js';
+export { D as DashboardInput, c as DashboardPanelInput, T as TikTokVideoBody, d as TikTokVideoMetric, Y as YouTubeShortBody, e as YouTubeShortMetric, f as defineDashboard } from './integrations-CmIkP1Gi.js';
+import { P as Prerequisite, T as TextEvidence, U as UrlEvidence, a as TextOptions, b as UrlOptions } from './submission-input-D9EGH_yb.js';
+export { c as balanceAtLeast, d as completed, i as inGroup } from './submission-input-D9EGH_yb.js';
+import { I as ImageReader, X as XReader } from './x-KFJD2x8y.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
 import './analytics-URV-mxjH.js';
 
@@ -447,18 +446,46 @@ declare const discord: {
         action: "grant-role";
         roleId: string;
     };
+    /**
+     * An announcement Domino's bot posts in a channel of the project's Discord server when a
+     * completion pays, such as `"{beneficiary} got +{points} XP from {author}"`. Placeholders are
+     * `announcementPlaceholders`; `{beneficiary}` and `{author}` mention linked Discord accounts.
+     * Pass it in the quest's `announcements`, and declare the `discord` integration.
+     */
+    postMessage(options: {
+        channel: string;
+        text: string;
+        replyToTriggeringMessage?: boolean;
+    }): {
+        action: "post-message";
+        text: string;
+        provider: "discord";
+        channel: string;
+        replyToTriggeringMessage?: boolean | undefined;
+    };
     messages: typeof messages;
     reactions: typeof reactions;
     roles(options?: {
         assignable?: boolean;
     }): ResourceSource;
+    /**
+     * A channel of the project's Discord server, for a resource setting. With `postable: true`,
+     * Console lists channels Domino's bot cannot post in as unavailable, as an announcement's
+     * channel needs.
+     */
     channels(options?: {
         types?: ChannelTypes;
+        postable?: boolean;
     }): ResourceSource;
 };
 /**
  * Telegram, through Domino's bot in the chats a project connects in Console.
  *
+ * - `telegram.messages()`: a tracker source of the messages members post in those groups and
+ *   supergroups. Each record is one message, keyed by chat and message ID: its `author` is the
+ *   poster's Telegram account. `data` is `TelegramMessageData`, which names the chat, the message,
+ *   and the reply target and topic thread, never the text. Bots', service and channel messages
+ *   are not recorded, and an edit is the same message.
  * - `telegram.reactions()`: a tracker source of the reactions members add to messages in those
  *   groups and supergroups. Each record is one added reaction: its `author` is the reactor and
  *   its `messageAuthor` account is the message's author, both Telegram accounts. `data` is
@@ -466,20 +493,63 @@ declare const discord: {
  *   Pay the message's author with `automatic({ tracker, beneficiary: "messageAuthor" })`.
  * - Quests read membership with `ctx.telegram.member({ chat })`, naming the chat with
  *   `settings.telegramChat()`.
+ * - `telegram.postMessage({ chat, text })`: an announcement the bot posts in a connected chat
+ *   when a completion pays, listed in the quest's `announcements`.
  *
- * In SDK 1.x the reactions source is a custom source whose namespace Relay reserves: only Relay
- * writes its records, and the accounts on them are Telegram accounts whatever `identities` says.
+ * In SDK 1.x both sources are custom sources whose namespaces Relay reserves: only Relay writes
+ * their records, and the accounts on them are Telegram accounts whatever `identities` says.
  */
 declare const telegram: {
+    /**
+     * An announcement Domino's bot posts in a connected chat when a completion pays, such as
+     * `"{beneficiary} got +{points} XP from {author}"`. Name the chat with `settings.telegramChat()`.
+     * Placeholders are `announcementPlaceholders`; `{beneficiary}` and `{author}` mention Telegram
+     * accounts. Pass it in the quest's `announcements`.
+     */
+    postMessage(options: {
+        chat: string;
+        text: string;
+        replyToTriggeringMessage?: boolean;
+    }): {
+        action: "post-message";
+        text: string;
+        provider: "telegram";
+        chat: string;
+        replyToTriggeringMessage?: boolean | undefined;
+    };
+    messages(): {
+        kind: "custom";
+        namespace: string;
+        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
+        accounts?: string[] | undefined;
+        data?: TrackerDataSchema | undefined;
+        content?: {
+            metrics: string[];
+        } | undefined;
+        balance?: {
+            chain: string;
+            token: string | null;
+        } | undefined;
+    } & WithRecordData<{
+        chatId: string;
+        chatType: string;
+        messageId: number;
+        replyToMessageId: number | null;
+        threadId: number | null;
+    }> & WithAccountRoles<"author">;
     reactions(): {
         kind: "custom";
         namespace: string;
-        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
+        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
             metrics: string[];
         } | undefined;
+        balance?: {
+            chain: string;
+            token: string | null;
+        } | undefined;
     } & WithRecordData<{
         chatId: string;
         chatType: string;
@@ -509,12 +579,16 @@ declare const youtube: {
     shorts(): {
         kind: "custom";
         namespace: string;
-        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
+        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
             metrics: string[];
         } | undefined;
+        balance?: {
+            chain: string;
+            token: string | null;
+        } | undefined;
     } & WithRecordData<ContentData<{
         title: string;
         description: string;
@@ -547,12 +621,16 @@ declare const tiktok: {
     videos(): {
         kind: "custom";
         namespace: string;
-        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
+        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
             metrics: string[];
         } | undefined;
+        balance?: {
+            chain: string;
+            token: string | null;
+        } | undefined;
     } & WithRecordData<ContentData<{
         title: string;
         description: string;
@@ -573,6 +651,49 @@ declare const tiktok: {
         isAigc: boolean;
     }, "likes" | "views" | "comments" | "shares"> & WithAccountRoles<"author">;
 };
+/**
+ * Members' linked wallets, sampled by Relay.
+ *
+ * - `wallet.balances({ chain, token })`: a tracker source of daily balance samples. Once per
+ *   project-calendar day, at a time members can't predict, Relay reads the balance of every
+ *   wallet of that chain's family linked by a member who joined the project, every wallet at one
+ *   pinned EVM block or Cosmos height (Solana can't read a past slot: each read reaches at least
+ *   the pinned slot). Each record is one wallet, keyed by its CAIP-10 account on `chain`, which is also
+ *   its `author`; each sample is a new observation whose `occurredAt` is the sample time and whose
+ *   `data` is `WalletBalanceSample`. `chain` and `token` are those of `ctx.wallet.balance()`: an
+ *   EVM chain with its native coin or an ERC-20, Solana with SOL or an SPL or Token-2022 mint, or a
+ *   Cosmos chain with a bank denomination. A day whose reads all fail has no sample: Relay never
+ *   writes a balance it didn't read. Reward holding for days with
+ *   `automatic({ tracker, where: { path: "amount", gte: ... } })` and `streak({ days })`.
+ *
+ * In SDK 1.x the source is a custom source whose namespace Relay reserves: only Relay writes its
+ * records. A project and environment can have at most 5 of them.
+ */
+declare const wallet: {
+    balances(query: WalletBalanceSourceQuery): ({
+        kind: "custom";
+        namespace: string;
+        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
+        accounts?: string[] | undefined;
+        data?: TrackerDataSchema | undefined;
+        content?: {
+            metrics: string[];
+        } | undefined;
+        balance?: {
+            chain: string;
+            token: string | null;
+        } | undefined;
+    } & WithRecordData<{
+        amount: string;
+        decimals: number | null;
+        block: string;
+    }> & WithAccountRoles<"author">) & {
+        balance: {
+            chain: string;
+            token: string | null;
+        };
+    };
+};
 declare const pointLedgers: () => ResourceSource;
 type Label = {
     label: string;
@@ -630,6 +751,50 @@ declare const settings: {
     chain(options: Label & {
         default: BalanceChain;
     }): Setting<"text", z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<"solana" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" | `eip155:${number}`, string>>>>;
+    /**
+     * An NFT collection `ctx.wallet.nfts()` reads, as a CAIP-19 asset type: an EVM chain, the
+     * standard and the contract, such as `"eip155:1/erc721:0x…"`, or `"eip155:8453/erc1155:0x…/1"` for
+     * one ERC-1155 token ID; or a Metaplex collection NFT's mint on Solana mainnet,
+     * `"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/nft:<mint>"`. Relay checks it when the collection is
+     * published or edited: an EVM chain must be one `ctx.wallet.balance()` reads and the contract
+     * must report the standard through ERC-165 `supportsInterface`; a Solana mint must be a Metaplex
+     * collection NFT. Typed as the query's collection, so it passes to
+     * `ctx.wallet.nfts({ collection })` as it is.
+     */
+    nft(options: Label & {
+        default: NftCollection;
+    }): Setting<"text", z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<`eip155:${number}/erc721:0x${string}` | `eip155:${number}/erc1155:0x${string}/${string}` | `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/nft:${string}`, string>>>>;
+    /**
+     * A contract function `ctx.wallet.call()` reads: the contract's CAIP-10 account ID on an EVM
+     * chain, a space, and the function's human-readable signature, such as
+     * `"eip155:8453:0x… function stakedOf(address) view returns (uint256)"`. Only `view` and `pure`
+     * functions with elementary parameters that return one `uint`, `int`, `bool` or `address` are
+     * accepted; publication and Console edits also check that Relay reads the chain. Typed as the
+     * query's call, so it passes to `ctx.wallet.call({ call })` as it is.
+     */
+    contractCall(options: Label & {
+        default: ContractCall;
+    }): Setting<"text", z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<`eip155:${number}:0x${string} function ${string}`, string>>>>;
+    /**
+     * An EVM contract event `ctx.wallet.events()` reads: the contract as a CAIP-10 account ID and
+     * the event's Solidity signature, with argument names and `indexed` markers, such as
+     * `"eip155:8453:0x… Transfer(address indexed from, address indexed to, uint256 value)"`. The event
+     * needs an indexed `address` argument, the one matched against the member's wallets. Relay checks
+     * it when the event is published or edited: the chain must be one `ctx.wallet.balance()` reads
+     * and report a finalized or safe block, and the address must hold a contract. Typed as the query's
+     * event, so it passes to `ctx.wallet.events({ event })` as it is.
+     */
+    contractEvent(options: Label & {
+        default: ContractEvent;
+    }): Setting<"text", z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<`eip155:${number}:0x${string} ${string}`, string>>>>;
+    /**
+     * A Solana mainnet program `ctx.wallet.transactions()` reads: its base58 address, such as
+     * Jupiter's `"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"`. Relay checks it when it is published
+     * or edited: the account must exist and be an executable program.
+     */
+    solanaProgram(options: Label & {
+        default: SolanaProgram;
+    }): Setting<"text", z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
     integer(options: Label & {
         default: number;
         min: number;
@@ -646,6 +811,35 @@ declare const settings: {
     object<T extends Record<string, Setting>>(shape: T): z.ZodObject<{ -readonly [P in keyof T]: T[P]; }, z.core.$strict>;
 };
 
+/**
+ * How much of `mint` (`"SOL"` for lamports) the wallet gained in `tx`, in base units, or `"0"`
+ * when it gained none.
+ */
+declare function received(tx: WalletTransaction, mint: string): string;
+/**
+ * How much of `mint` (`"SOL"` for lamports, rent included, the fee not) the wallet gave up in `tx`, in base
+ * units, or `"0"` when it gave up none.
+ */
+declare function spent(tx: WalletTransaction, mint: string): string;
+/**
+ * Whether the wallet swapped in `tx`: one mint went down and a different one went up. `into` names
+ * the mint that must have gone up, `from` the one that must have gone down; `"SOL"` stands for
+ * lamports. The fee is left out of SOL, but rent is not: a transaction that opens a token account
+ * for the wallet lowers its SOL by the rent, so check a swap out of SOL with `spent(tx, "SOL")`
+ * against a minimum above it.
+ */
+declare function swapped(tx: WalletTransaction, options?: {
+    into?: string;
+    from?: string;
+}): boolean;
+/** Whether `tx` invoked `program`, in a top-level or inner instruction. */
+declare function invoked(tx: WalletTransaction, program: string): boolean;
+/**
+ * The arguments of the first instruction of the program in `tx` named `name`, as the program's
+ * Anchor IDL spells it, or `null` when there is none, or the program's setting has no IDL.
+ */
+declare function instruction(tx: WalletTransaction, name: string): WalletInstruction["args"] | null;
+
 declare const badge: (definition: BadgeHandle & Pick<Badge, "name">) => {
     reward: {
         badge: string;
@@ -916,19 +1110,21 @@ type QuestKeyedContext<S, G> = Omit<KeyedContext, "tracker"> & {
     /** The pinned tracker observation: non-null and typed for a tracker trigger, null for others. */
     tracker: ContextTracker<G>;
 };
-declare const budget: (definition: Omit<Budget, "id" | "cost"> & {
+type BudgetDefinition<B extends Budget | AuthorBudget> = Omit<B, "id" | "cost"> & {
     key: string;
     cost: number | {
         ledger: LedgerReference;
     };
-}) => {
-    id: string;
-    scope: "member" | "project";
-    period: "lifetime" | "day" | "week" | "month";
-    limit: number;
-    cost: number | {
-        balance: string;
-    };
+};
+/**
+ * A named cap on a quest's completions or awarded points, per member (`scope: "member"`), for
+ * everyone together (`"project"`), or per tracker record author (`"author"`): the account that
+ * caused the record, such as a reaction's reactor, whether or not a member linked it. An author
+ * budget caps what one person gives when the quest pays someone else, and needs a tracker trigger.
+ */
+declare const budget: {
+    (definition: BudgetDefinition<Budget>): Budget;
+    (definition: BudgetDefinition<AuthorBudget>): AuthorBudget;
 };
 declare const keyed: (key: (ctx: KeyedContext) => string) => {
     kind: "keyed";
@@ -1312,7 +1508,8 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
      * (`relay.profiles.completions`). Hidden by default.
      */
     profile?: QuestProfile;
-    budgets?: Budget[];
+    /** Its {@link budget}s; an author budget needs a tracker trigger. */
+    budgets?: (Budget | AuthorBudget)[];
     /**
      * Milliseconds a member waits after an attempt is rejected, by the evaluator or a
      * reviewer, before submitting again: `300_000` lets a quiz be retried every five minutes.
@@ -1370,6 +1567,26 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
     })[] | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => Reward[]);
+    /**
+     * Messages Relay posts when a completion pays, after its rewards commit, such as
+     * `telegram.postMessage({ chat, text: "{beneficiary} got +{points} XP from {author}" })`.
+     * At most three. Return none while a setting they need is empty.
+     */
+    announcements?: ({
+        action: "post-message";
+        text: string;
+        provider: "telegram";
+        chat: string;
+        replyToTriggeringMessage?: boolean | undefined;
+    } | {
+        action: "post-message";
+        text: string;
+        provider: "discord";
+        channel: string;
+        replyToTriggeringMessage?: boolean | undefined;
+    })[] | ((ctx: {
+        settings: z.core.$InferObjectOutput<T, {}>;
+    }) => Announcement[]) | undefined;
     evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<D>> | undefined;
     /**
      * A content quest's performance stage: once content evaluation accepts an item, each later
@@ -1402,7 +1619,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             imageAlt?: string | undefined;
             requirements?: ({
                 kind: "account";
-                provider: "x" | "discord" | "google" | "apple";
+                provider: "discord" | "x" | "google" | "apple";
             } | {
                 kind: "wallet";
                 chain?: "solana" | "eip155" | "cosmos" | undefined;
@@ -1426,7 +1643,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 } | undefined;
             } | undefined;
         };
-        integrations: ("x" | "discord")[];
+        integrations: ("discord" | "x")[];
         fields: Record<string, {
             kind: "point-ledger";
             default: string;
@@ -1444,6 +1661,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 provider: "discord";
                 resource: "channel";
                 types: ("text" | "announcement")[];
+                postable?: true | undefined;
             } | {
                 provider: "discord";
                 resource: "role";
@@ -1662,6 +1880,19 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 balance: string;
             };
         }[];
+        announcements?: ({
+            action: "post-message";
+            text: string;
+            provider: "telegram";
+            chat: string;
+            replyToTriggeringMessage?: boolean | undefined;
+        } | {
+            action: "post-message";
+            text: string;
+            provider: "discord";
+            channel: string;
+            replyToTriggeringMessage?: boolean | undefined;
+        })[] | undefined;
         performance?: {
             metrics: string[];
             maxAgeMs: number;
@@ -1679,6 +1910,15 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             from: number;
             until: number;
         } | undefined;
+        authorBudgets?: {
+            id: string;
+            period: "lifetime" | "day" | "week" | "month";
+            limit: number;
+            cost: number | {
+                balance: string;
+            };
+            scope: "author";
+        }[] | undefined;
         retryCooldownMs?: number | undefined;
         completionCooldownMs?: number | undefined;
     };
@@ -1762,7 +2002,8 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
      * (`relay.profiles.completions`). Hidden by default.
      */
     profile?: QuestProfile;
-    budgets?: Budget[];
+    /** Its {@link budget}s; an author budget needs a tracker trigger. */
+    budgets?: (Budget | AuthorBudget)[];
     /**
      * Milliseconds a member waits after an attempt is rejected, by the evaluator or a
      * reviewer, before submitting again: `300_000` lets a quiz be retried every five minutes.
@@ -1820,6 +2061,26 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
     })[] | ((ctx: {
         settings: z.core.$InferObjectOutput<T, {}>;
     }) => Reward[]);
+    /**
+     * Messages Relay posts when a completion pays, after its rewards commit, such as
+     * `telegram.postMessage({ chat, text: "{beneficiary} got +{points} XP from {author}" })`.
+     * At most three. Return none while a setting they need is empty.
+     */
+    announcements?: ({
+        action: "post-message";
+        text: string;
+        provider: "telegram";
+        chat: string;
+        replyToTriggeringMessage?: boolean | undefined;
+    } | {
+        action: "post-message";
+        text: string;
+        provider: "discord";
+        channel: string;
+        replyToTriggeringMessage?: boolean | undefined;
+    })[] | ((ctx: {
+        settings: z.core.$InferObjectOutput<T, {}>;
+    }) => Announcement[]) | undefined;
     evaluate?: Evaluator<z.core.$InferObjectOutput<T, {}>, QuestInput<G>, NoInfer<G>, NoInfer<D>> | undefined;
     /**
      * A content quest's performance stage: once content evaluation accepts an item, each later
@@ -1852,7 +2113,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             imageAlt?: string | undefined;
             requirements?: ({
                 kind: "account";
-                provider: "x" | "discord" | "google" | "apple";
+                provider: "discord" | "x" | "google" | "apple";
             } | {
                 kind: "wallet";
                 chain?: "solana" | "eip155" | "cosmos" | undefined;
@@ -1876,7 +2137,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 } | undefined;
             } | undefined;
         };
-        integrations: ("x" | "discord")[];
+        integrations: ("discord" | "x")[];
         fields: Record<string, {
             kind: "point-ledger";
             default: string;
@@ -1894,6 +2155,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 provider: "discord";
                 resource: "channel";
                 types: ("text" | "announcement")[];
+                postable?: true | undefined;
             } | {
                 provider: "discord";
                 resource: "role";
@@ -2112,6 +2374,19 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 balance: string;
             };
         }[];
+        announcements?: ({
+            action: "post-message";
+            text: string;
+            provider: "telegram";
+            chat: string;
+            replyToTriggeringMessage?: boolean | undefined;
+        } | {
+            action: "post-message";
+            text: string;
+            provider: "discord";
+            channel: string;
+            replyToTriggeringMessage?: boolean | undefined;
+        })[] | undefined;
         performance?: {
             metrics: string[];
             maxAgeMs: number;
@@ -2129,6 +2404,15 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             from: number;
             until: number;
         } | undefined;
+        authorBudgets?: {
+            id: string;
+            period: "lifetime" | "day" | "week" | "month";
+            limit: number;
+            cost: number | {
+                balance: string;
+            };
+            scope: "author";
+        }[] | undefined;
         retryCooldownMs?: number | undefined;
         completionCooldownMs?: number | undefined;
     };
@@ -2192,4 +2476,4 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
     }): Promise<Decision>;
 } & ResourceHandle<"quest">;
 
-export { AmountSetting, BalanceChain, ContentBody, type ContentData, ContentMetricName, type ContentTrigger, type ContentTriggerInput, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, type KeyedContext, LedgerHandle, LedgerReference, MemberCompletion, type MemberCompletionQuery, MemberIdentity, type Outcome, type PerformanceContext, type PerformanceOutcome, PointBalance, ProfileReferral, QuestHandle, type QuestKeyedContext, ReferralHandle, RoleOf, Setting, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletReader, Where, type XContentBody, XReader, automatic, automaticFulfillment, badge, budget, calendar, content, count, customSource, decision, defineBadge, defineEngagementReward, defineLeaderboard, defineLedger, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, earned, evaluators, evidence, groupMembership, keyed, manual, once, pointLedgers, points, progress, questCompleted, rolling, settings, staffHandover, streak, telegram, tiktok, untracked, x, youtube };
+export { AmountSetting, BalanceChain, ContentBody, type ContentData, ContentMetricName, type ContentTrigger, type ContentTriggerInput, ContractCall, ContractEvent, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, type KeyedContext, LedgerHandle, LedgerReference, MemberCompletion, type MemberCompletionQuery, MemberIdentity, NftCollection, type Outcome, type PerformanceContext, type PerformanceOutcome, PointBalance, ProfileReferral, QuestHandle, type QuestKeyedContext, ReferralHandle, RoleOf, Setting, SolanaProgram, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletBalanceSourceQuery, WalletInstruction, WalletReader, WalletTransaction, Where, type XContentBody, XReader, automatic, automaticFulfillment, badge, budget, calendar, content, count, customSource, decision, defineBadge, defineEngagementReward, defineLeaderboard, defineLedger, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, earned, evaluators, evidence, groupMembership, instruction, invoked, keyed, manual, once, pointLedgers, points, progress, questCompleted, received, rolling, settings, spent, staffHandover, streak, swapped, telegram, tiktok, untracked, wallet, x, youtube };