@domino-sdk/relay 1.66.1 → 1.68.0

package/dist/authoring.d.ts

@@ -1,21 +1,21 @@
-import { _ as EngagementBudget, $ as leaderboardDefinitionSchema, Z as AuthoringIdentity, a0 as pointLedgerDeclarationSchema, a1 as referralAuthoringSchema, a2 as discordMessagesSourceSchema, a3 as DiscordMessageData, a4 as DiscordMessageTextData, a5 as discordReactionsSourceSchema, a6 as DiscordReactionData, a7 as KnownIntegrationModule, P as PointBalance, C as CampaignDefinition, a8 as TextReviewInput, a9 as TextResult, aa as PhotoResult, ab as DiscordReader, ac as Decision, ad as rewardSchema, ae as triggerSchema, af as IntegrationModule, D as QuestPresentation, d as AvailabilityWindow, F as QuestProfile, G as QuizEvidence, W as IntegrationModuleProvider, ag as TieredRewardDefinition } from './accounts-_lNsiR2k.js';
-export { ah as KnownIntegrationModuleProvider, ai as defineCampaign, aj as defineGroup } from './accounts-_lNsiR2k.js';
-import { x as xContentBodySchema, I as IdentityKind, j as customSourceSchema, W as WithRecordData, k as WithContent, l as WithAccountRoles, R as ResourceHandle, Q as QuestHandle, L as LedgerReference, G as GroupHandle, m as TrackerSource, n as trackerDefinitionSchema, o as Tracker, p as TrackerData, q as SourceRoles, r as LedgerHandle, i as TrackerDataSchema, u as xSearchSourceSchema, X as XTweet, v as XContentMetric, y as TrackerTriggerPolicy, z as Where, M as MemberIdentity, A as ReferralHandle, B as TrackerTriggerContext, C as TrackerReader, D as TrackerTriggerMode, E as RoleOf, F as WhereSetting, H as ContentBody, J as BadgeHandle, N as ContentMetricName } from './tracker-data-Bl-qPIvZ.js';
-export { P as LedgerSetting, U as TrackerPage, V as TrackerReadQuery, Y as trackerDataSchema, Z as trackerTriggerContextSchema } from './tracker-data-Bl-qPIvZ.js';
+import { $ as EngagementBudget, a0 as leaderboardDefinitionSchema, _ as AuthoringIdentity, a1 as pointLedgerDeclarationSchema, a2 as referralAuthoringSchema, a3 as discordMessagesSourceSchema, a4 as DiscordMessageData, a5 as DiscordMessageTextData, a6 as discordReactionsSourceSchema, a7 as DiscordReactionData, a8 as KnownIntegrationModule, P as PointBalance, C as CampaignDefinition, a9 as SolanaTransactionAction, aa as TextReviewInput, ab as TextResult, ac as PhotoResult, ad as DiscordReader, ae as Decision, af as rewardSchema, ag as triggerSchema, ah as IntegrationModule, D as QuestPresentation, d as AvailabilityWindow, F as QuestProfile, ai as QuestStation, G as QuizEvidence, X as IntegrationModuleProvider, aj as TieredRewardDefinition } from './accounts-DnpKoJCo.js';
+export { ak as KnownIntegrationModuleProvider, al as defineCampaign, am as defineGroup } from './accounts-DnpKoJCo.js';
+import { x as xContentBodySchema, I as IdentityKind, c as customSourceSchema, W as WithRecordData, d as WithContent, e as WithAccountRoles, R as ResourceHandle, Q as QuestHandle, L as LedgerReference, G as GroupHandle, f as TrackerSource, t as trackerDefinitionSchema, g as Tracker, h as TrackerData, i as SourceRoles, j as LedgerHandle, b as TrackerDataSchema, k as xSearchSourceSchema, X as XTweet, l as XContentMetric, m as TrackerTriggerPolicy, n as Where, M as MemberIdentity, o as ReferralHandle, p as TrackerTriggerContext, q as TrackerReader, r as TrackerTriggerMode, s as RoleOf, u as WhereSetting, C as ContentBody, B as BadgeHandle, v as ContentMetricName } from './tracker-data-CAK942sx.js';
+export { w as LedgerSetting, y as TrackerPage, z as TrackerReadQuery, A as trackerDataSchema, D as trackerTriggerContextSchema } from './tracker-data-CAK942sx.js';
 import { R as ResourceSource, M as MemberCompletion, B as Budget, A as AuthorBudget, a as Announcement } from './capability-error-CuI_F7yM.js';
 export { C as CapabilityError, b as CapabilityErrorCode, T as TikTokVideoBody, c as TikTokVideoMetric, Y as YouTubeShortBody, d as YouTubeShortMetric, e as capabilityErrorCodes } from './capability-error-CuI_F7yM.js';
-import { N as NftCollection, p as ContractCall, q as ContractEvent, r as SolanaProgram, s as WalletBalanceSourceQuery, t as WalletTransaction, u as WalletInstruction, e as ProfileReferral, v as WalletReader } from './wallet-B7e06v4m.js';
-export { w as ContractCallParts, x as ContractCallReturnType, y as ContractEventInput, z as ContractEventParts, B as ContractFunction, D as CosmosDenom, a as CosmosNetwork, E as EvmChainId, F as NftCollectionParts, G as NftStandard, H as WalletBalance, I as WalletBalanceChange, o as WalletBalanceQuery, J as WalletBalanceSample, K as WalletCall, M as WalletCallArgument, Q as WalletCallQuery, R as WalletDelegations, T as WalletDelegationsQuery, U as WalletEventCondition, V as WalletEventValue, X as WalletEvents, Y as WalletEventsQuery, Z as WalletNfts, _ as WalletNftsQuery, $ as WalletTransactions, a0 as WalletTransactionsQuery, a1 as cosmosDenomSchema, a2 as cosmosNetworkSchema, a3 as isContractCall, a4 as isContractEvent, a5 as isEvmChainId, a6 as isNftCollection, a7 as isSolanaProgram, a8 as maxWalletEventLogs, a9 as maxWalletEventLookback, aa as maxWalletTransactionLookback, ab as maxWalletTransactions, ac as parseContractCall, ad as parseContractEvent, ae as parseContractFunction, af as parseNftCollection } from './wallet-B7e06v4m.js';
+import { N as NftCollection, w as ContractCall, x as ContractEvent, y as SolanaProgram, z as WalletBalanceSourceQuery, B as WalletProgramActivitySourceQuery, D as WalletNftSourceQuery, E as WalletStakeSourceQuery, F as WalletTransaction, G as WalletInstruction, f as ProfileReferral, H as WalletReader } from './wallet-DQtJelQQ.js';
+export { I as ContractCallParts, J as ContractCallReturnType, K as ContractEventInput, M as ContractEventParts, Q as ContractFunction, R as CosmosDenom, a as CosmosNetwork, T as EvmChainId, U as NftCollectionParts, V as NftStandard, X as SolanaSeed, Y as SolanaSeedInteger, Z as WalletBalance, _ as WalletBalanceChange, v as WalletBalanceQuery, $ as WalletBalanceSample, a0 as WalletCall, a1 as WalletCallArgument, a2 as WalletCallQuery, a3 as WalletDelegations, a4 as WalletDelegationsQuery, a5 as WalletEventCondition, a6 as WalletEventValue, a7 as WalletEvents, a8 as WalletEventsQuery, a9 as WalletNftSample, aa as WalletNfts, ab as WalletNftsQuery, ac as WalletProgramAccount, ad as WalletProgramAccountQuery, ae as WalletProgramActivity, af as WalletStake, ag as WalletStakeQuery, ah as WalletStakeSample, ai as WalletTransactions, aj as WalletTransactionsQuery, ak as cosmosDenomSchema, al as cosmosNetworkSchema, am as isContractCall, an as isContractEvent, ao as isEvmChainId, ap as isNftCollection, aq as isSolanaProgram, ar as maxWalletEventLogs, as as maxWalletEventLookback, at as maxWalletTransactionLookback, au as maxWalletTransactions, av as parseContractCall, aw as parseContractEvent, ax as parseContractFunction, ay as parseNftCollection } from './wallet-DQtJelQQ.js';
 import * as z from 'zod';
 export { z } from 'zod';
-import { g as badgeDeclarationSchema, h as OfferAuthoring, B as Badge } from './offers-Hw2P6tcK.js';
+import { g as badgeDeclarationSchema, h as OfferAuthoring, B as Badge } from './offers-xcPbYaEv.js';
 import { a as StreakPolicy, Q as QuizContent } from './streaks-0YuipsUQ.js';
-import { S as Setting, A as AmountSetting, B as BalanceChain, a as BoundSettings } from './dashboards-pVfclkyh.js';
-export { D as DashboardInput, b as DashboardPanelInput, e as defineDashboard } from './dashboards-pVfclkyh.js';
-import { e as TelegramReader, P as Prerequisite, b as TextEvidence, U as UrlEvidence, c as TextOptions, d as UrlOptions } from './submission-input-ChL1aYNH.js';
-export { f as TelegramChatMember, g as TelegramChatMemberStatus, h as TelegramConnection, i as TelegramMessageData, j as TelegramReactionData, k as balanceAtLeast, l as completed, m as inGroup } from './submission-input-ChL1aYNH.js';
-import { I as ImageReader, X as XReader } from './limits-pE04y9O2.js';
-export { L as Limits, l as limits } from './limits-pE04y9O2.js';
+import { S as Setting, A as AmountSetting, B as BalanceChain, a as BoundSettings } from './dashboards-DMk-vL1q.js';
+export { D as DashboardInput, b as DashboardPanelInput, d as defineDashboard } from './dashboards-DMk-vL1q.js';
+import { e as TelegramReader, P as Prerequisite, b as TextEvidence, U as UrlEvidence, c as TextOptions, d as UrlOptions } from './submission-input-CaL8drIh.js';
+export { f as TelegramChatMember, g as TelegramChatMemberStatus, h as TelegramConnection, i as TelegramMessageData, j as TelegramReactionData, k as balanceAtLeast, l as completed, m as inGroup } from './submission-input-CaL8drIh.js';
+import { I as ImageReader, X as XReader } from './limits-ByVRQePO.js';
+export { L as Limits, l as limits } from './limits-ByVRQePO.js';
 export { f as formatUnits, p as parseUnits } from './units-CwgsPB_r.js';
 
 declare function defineBadge(input: z.input<typeof badgeDeclarationSchema>): {
@@ -590,7 +590,7 @@ declare const telegram: {
     messages(): {
         kind: "custom";
         namespace: string;
-        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
@@ -600,6 +600,21 @@ declare const telegram: {
             chain: string;
             token: string | null;
         } | undefined;
+        activity?: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        } | undefined;
+        nfts?: {
+            collection: string;
+        } | undefined;
+        stake?: {
+            chain: string;
+            voteAccount: string | null;
+        } | undefined;
     } & WithRecordData<{
         chatId: string;
         chatType: string;
@@ -610,7 +625,7 @@ declare const telegram: {
     reactions(): {
         kind: "custom";
         namespace: string;
-        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
@@ -620,6 +635,21 @@ declare const telegram: {
             chain: string;
             token: string | null;
         } | undefined;
+        activity?: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        } | undefined;
+        nfts?: {
+            collection: string;
+        } | undefined;
+        stake?: {
+            chain: string;
+            voteAccount: string | null;
+        } | undefined;
     } & WithRecordData<{
         chatId: string;
         chatType: string;
@@ -649,7 +679,7 @@ declare const youtube: {
     shorts(): {
         kind: "custom";
         namespace: string;
-        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
@@ -659,6 +689,21 @@ declare const youtube: {
             chain: string;
             token: string | null;
         } | undefined;
+        activity?: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        } | undefined;
+        nfts?: {
+            collection: string;
+        } | undefined;
+        stake?: {
+            chain: string;
+            voteAccount: string | null;
+        } | undefined;
     } & WithRecordData<ContentData<{
         title: string;
         description: string;
@@ -691,7 +736,7 @@ declare const tiktok: {
     videos(): {
         kind: "custom";
         namespace: string;
-        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
@@ -701,6 +746,21 @@ declare const tiktok: {
             chain: string;
             token: string | null;
         } | undefined;
+        activity?: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        } | undefined;
+        nfts?: {
+            collection: string;
+        } | undefined;
+        stake?: {
+            chain: string;
+            voteAccount: string | null;
+        } | undefined;
     } & WithRecordData<ContentData<{
         title: string;
         description: string;
@@ -735,15 +795,47 @@ declare const tiktok: {
  *   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 })`.
+ * - `wallet.nfts({ collection })`: a tracker source of daily NFT holding samples, sampled as
+ *   `wallet.balances()` samples balances: once per project-calendar day, every wallet of the
+ *   collection's family, one pinned EVM block or (on Solana) the slot every read must reach. `data`
+ *   is `WalletNftSample`: how many of the collection's NFTs the wallet held, counted as
+ *   `ctx.wallet.nfts()` counts them, except compressed NFTs: samples don't count a Token Metadata
+ *   collection's, and refuse a Core collection with the `BubblegumV2` plugin. Each run first checks the collection as publication checks a
+ *   `settings.nft()` value, and shows a wrong contract or mint on the tracker. Reward holding for
+ *   days with `automatic({ tracker, where: { path: "count", gte: 1 } })` and `streak({ days })`.
+ * - `wallet.programActivity({ chain, program, instruction, mint, minAmount, signer })`: a tracker
+ *   source of members' Solana transactions that call `program`. Relay reads the finalized,
+ *   successful transactions of every Solana wallet linked by a member who joined the project, from
+ *   the later of when the wallet was linked and the tracker's window start (at most 30 days before
+ *   its first read), every 10 minutes. Reads are shared by the project's program activity trackers,
+ *   so one published while another already reads the cluster records from its publication. Each
+ *   record is one transaction, keyed by its signature, authored by the wallet's CAIP-10 account on
+ *   `chain`, with the block time as `occurredAt` and `WalletProgramActivity` as `data`. By default
+ *   only transactions the wallet signed count (`signer: "any"` counts others that name it).
+ *   `instruction` narrows to one instruction of the program's IDL, and `mint` to
+ *   transactions that change the wallet's balance of an SPL mint, by at least `minAmount` base
+ *   units when set. Pay per transaction with `automatic({ tracker })` and a keyed completion, feed
+ *   a leaderboard with its points, or count active days with `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.
+ * - `wallet.stake({ chain, voteAccount })`: a tracker source of daily native stake samples on
+ *   Solana (`chain` `"solana"` for mainnet, the default, or devnet), sampled as `wallet.balances()`
+ *   samples balances: once per project-calendar day, every linked Solana wallet, each read
+ *   reaching the run's pinned slot. `data` is `WalletStakeSample`: the lamports the wallet
+ *   delegates through the stake accounts it controls as staker or withdrawer, to `voteAccount`
+ *   only when set, counted as `ctx.wallet.stake({ address })` counts that one wallet's (`amount`
+ *   is active stake; `activating` and `deactivating` are apart). Reward keeping stake delegated
+ *   with `automatic({ tracker, where: { path: "amount", gte: ... } })` and `streak({ days })`.
+ *
+ * In SDK 1.x each source is a custom source whose namespace Relay reserves: only Relay writes its
+ * records. A project and environment can have at most 5 `wallet.balances()` trackers, 5
+ * `wallet.nfts()` trackers, 5 `wallet.stake()` trackers and 20 `wallet.programActivity()`
+ * trackers.
  */
 declare const wallet: {
     balances(query: WalletBalanceSourceQuery): ({
         kind: "custom";
         namespace: string;
-        identities?: ("discord" | "member" | "wallet" | "x" | `app:${string}`)[] | undefined;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
         accounts?: string[] | undefined;
         data?: TrackerDataSchema | undefined;
         content?: {
@@ -753,6 +845,21 @@ declare const wallet: {
             chain: string;
             token: string | null;
         } | undefined;
+        activity?: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        } | undefined;
+        nfts?: {
+            collection: string;
+        } | undefined;
+        stake?: {
+            chain: string;
+            voteAccount: string | null;
+        } | undefined;
     } & WithRecordData<{
         amount: string;
         decimals: number | null;
@@ -763,6 +870,127 @@ declare const wallet: {
             token: string | null;
         };
     };
+    programActivity(query: WalletProgramActivitySourceQuery): ({
+        kind: "custom";
+        namespace: string;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
+        accounts?: string[] | undefined;
+        data?: TrackerDataSchema | undefined;
+        content?: {
+            metrics: string[];
+        } | undefined;
+        balance?: {
+            chain: string;
+            token: string | null;
+        } | undefined;
+        activity?: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        } | undefined;
+        nfts?: {
+            collection: string;
+        } | undefined;
+        stake?: {
+            chain: string;
+            voteAccount: string | null;
+        } | undefined;
+    } & WithRecordData<{
+        signature: string;
+        slot: string;
+        timestamp: number;
+        signer: boolean;
+        instruction: string | null;
+        amount: string | null;
+        delta: string | null;
+    }> & WithAccountRoles<"author">) & {
+        activity: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        };
+    };
+    nfts(query: WalletNftSourceQuery): ({
+        kind: "custom";
+        namespace: string;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
+        accounts?: string[] | undefined;
+        data?: TrackerDataSchema | undefined;
+        content?: {
+            metrics: string[];
+        } | undefined;
+        balance?: {
+            chain: string;
+            token: string | null;
+        } | undefined;
+        activity?: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        } | undefined;
+        nfts?: {
+            collection: string;
+        } | undefined;
+        stake?: {
+            chain: string;
+            voteAccount: string | null;
+        } | undefined;
+    } & WithRecordData<{
+        count: string;
+        block: string;
+    }> & WithAccountRoles<"author">) & {
+        nfts: {
+            collection: NftCollection;
+        };
+    };
+    stake(query?: WalletStakeSourceQuery): ({
+        kind: "custom";
+        namespace: string;
+        identities?: ("x" | "discord" | "member" | "wallet" | `app:${string}`)[] | undefined;
+        accounts?: string[] | undefined;
+        data?: TrackerDataSchema | undefined;
+        content?: {
+            metrics: string[];
+        } | undefined;
+        balance?: {
+            chain: string;
+            token: string | null;
+        } | undefined;
+        activity?: {
+            chain: string;
+            program: string;
+            instruction: string | null;
+            mint: string | null;
+            minAmount: string | null;
+            anySigner: boolean;
+        } | undefined;
+        nfts?: {
+            collection: string;
+        } | undefined;
+        stake?: {
+            chain: string;
+            voteAccount: string | null;
+        } | undefined;
+    } & WithRecordData<{
+        amount: string;
+        activating: string;
+        deactivating: string;
+        block: string;
+    }> & WithAccountRoles<"author">) & {
+        stake: {
+            chain: string;
+            voteAccount: string | null;
+        };
+    };
 };
 declare const pointLedgers: () => ResourceSource;
 type Label = {
@@ -823,26 +1051,27 @@ declare const settings: {
         decimals?: number;
     }): AmountSetting<z.ZodDefault<z.ZodString>>;
     /**
-     * A chain `ctx.wallet.balance()` reads: `"solana"` (or Solana mainnet's CAIP-2 ID), or an EVM
-     * chain's CAIP-2 ID such as `"eip155:8453"`. Typed as the query's chain, so it passes to
+     * A chain `ctx.wallet.balance()` reads: `"solana"` (or Solana mainnet's CAIP-2 ID), Solana
+     * devnet's CAIP-2 ID, or an EVM chain's CAIP-2 ID such as `"eip155:8453"`. Typed as the query's chain, so it passes to
      * `ctx.wallet.balance({ chain })` as it is.
      */
     chain(options: Label & {
         default: BalanceChain;
-    }): Setting<"text", z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<"solana" | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" | `eip155:${number}`, string>>>>;
+    }): Setting<"text", z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<"solana" | `eip155:${number}` | "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" | "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1", 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
+     * one ERC-1155 token ID; or a Solana cluster and a Metaplex Core collection's address or a Token
+     * Metadata collection NFT's mint there, `"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/nft:<address>"`
+     * on mainnet or `"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1/nft:<address>"` on devnet. 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
+     * address must be a Core collection or a Metaplex collection NFT on its cluster. 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>>>>;
+    }): 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}` | `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1/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
@@ -867,9 +1096,10 @@ declare const settings: {
         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.
+     * A Solana program `ctx.wallet.transactions()` or `ctx.wallet.programAccount()` reads: its base58
+     * address, such as Jupiter's `"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"`. Relay checks it when
+     * it is published or edited: the account must be an executable program on Solana mainnet or
+     * devnet. Its IDL (Anchor, Codama or Shank), stored then, decodes the program's instructions and accounts.
      */
     solanaProgram(options: Label & {
         default: SolanaProgram;
@@ -915,7 +1145,7 @@ declare function swapped(tx: WalletTransaction, options?: {
 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.
+ * 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;
 
@@ -1052,8 +1282,9 @@ type TrackerTriggerInput<T extends Tracker = Tracker, W extends Where<TrackerDat
     tracker: T;
     /**
      * Which observations fire. `"new-record"`: each record's first observation (the default for X,
-     * Discord and Telegram trackers, where it means each newly collected post, message or reaction,
-     * so a removed and re-added Telegram reaction does not fire again). `"new-observation"`: each
+     * Discord, Telegram and `wallet.programActivity()` trackers, where it means each newly collected
+     * post, message, reaction or transaction, so a removed and re-added Telegram reaction does not
+     * fire again). `"new-observation"`: each
      * observation that becomes its record's current one (the default for other custom trackers,
      * YouTube and TikTok included, where every refresh observes each video again). `"data-changed"`: a
      * new record, or a current observation whose `data` differs from the previous one.
@@ -1181,6 +1412,14 @@ type KeyedContext = {
     };
     /** The pinned tracker observation of a tracker-triggered quest; null for other triggers. */
     tracker: TrackerTriggerContext | null;
+    /**
+     * The signed Solana transaction that started the attempt, with its memo's `reference`; null or
+     * absent for any other attempt. `keyed((ctx) => ctx.action?.reference ?? "app")` completes once per
+     * reference.
+     *
+     * @experimental A minor release can change quest actions.
+     */
+    action?: SolanaTransactionAction | null;
     eligibleAt: number;
     /** The evaluation run's pinned project calendar. */
     calendar: EvaluationCalendar;
@@ -1227,6 +1466,18 @@ declare const keyed: (key: (ctx: KeyedContext) => string, options?: KeyedOptions
     kind: "keyed";
     key: (ctx: KeyedContext) => string;
 };
+/**
+ * The completion of a quest with `stations`: each member completes it once per station, keyed by
+ * the station the signed transaction's memo names. Relay refuses a transaction for an unknown or
+ * closed station before the quest runs, and a member's own submission of the quest.
+ *
+ * @experimental A minor release can change check-in stations.
+ */
+declare const perStation: () => {
+    across?: "members" | undefined;
+    kind: "keyed";
+    key: (ctx: KeyedContext) => string;
+};
 type ProgressDefinition<C> = {
     distinct: (ctx: C) => string;
     goal: ReturnType<typeof count>;
@@ -1483,6 +1734,14 @@ type EvaluationContext<T, I = {
      * body type.
      */
     tracker: ContextTracker<G>;
+    /**
+     * The action that started this attempt: the Solana transaction the member signed, which an app's
+     * server submitted with `management.attempts.submitSolanaTransaction()`, with the signing wallet
+     * and the memo's `reference`. Null or absent for any other attempt.
+     *
+     * @experimental A minor release can change quest actions.
+     */
+    action?: SolanaTransactionAction | null;
     /**
      * When the activity happened, in epoch milliseconds: the tracker record's occurrence time, else
      * when the attempt was admitted. Budgets and daily keys use it.
@@ -1560,6 +1819,7 @@ type CompletionPolicies<S, G> = {
     keyed: (key: (ctx: QuestKeyedContext<S, G>) => string, options?: KeyedOptions) => ReturnType<typeof keyed>;
     streak: typeof streak;
     progress: (definition: ProgressDefinition<QuestKeyedContext<S, G>>) => ReturnType<typeof progress>;
+    perStation: typeof perStation;
 };
 /** How a quest completes: a content quest once per content item, so it takes no `completion`. */
 type CompletionFor<G, S> = IsContent<G> extends true ? {
@@ -1635,6 +1895,18 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
      * Omit it for no cooldown.
      */
     completionCooldownMs?: number;
+    /**
+     * Check-in stations, up to 200: `{ key, label, opensAt?, closesAt? }`, with each key the
+     * `reference` of a station's memo (`solanaActionMemo({ quest, reference })`) and the window
+     * in epoch milliseconds. A signed transaction completes the quest only when its memo names
+     * a station that was open at the transaction's block time; complete it once per station
+     * with `perStation()`. Only on a member-submitted `manual()` quest without input. Keep a
+     * station's key once its codes are printed: to rotate codes, add a station and close the
+     * old one.
+     *
+     * @experimental A minor release can change check-in stations.
+     */
+    stations?: readonly QuestStation[];
     /**
      * Whether staff can review this quest's attempts. Human review is on unless this returns
      * `{ enabled: false }`. With it off, `decision.review(...)` becomes a reject that keeps the
@@ -1731,7 +2003,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
             imageAlt?: string | undefined;
             requirements?: ({
                 kind: "account";
-                provider: "discord" | "x" | "google" | "apple";
+                provider: "x" | "discord" | "google" | "apple";
             } | {
                 kind: "wallet";
                 chain?: "solana" | "eip155" | "cosmos" | undefined;
@@ -1755,7 +2027,7 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
                 } | undefined;
             } | undefined;
         };
-        integrations: ("discord" | "x")[];
+        integrations: ("x" | "discord")[];
         fields: Record<string, {
             kind: "point-ledger";
             default: string;
@@ -2036,6 +2308,12 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
         }[] | undefined;
         retryCooldownMs?: number | undefined;
         completionCooldownMs?: number | undefined;
+        stations?: {
+            key: string;
+            label: string;
+            opensAt?: number | undefined;
+            closesAt?: number | undefined;
+        }[] | undefined;
     };
     evaluate(ctx: {
         settings: unknown;
@@ -2048,6 +2326,14 @@ declare const defineQuest: <T extends Record<string, Setting>, const G extends T
          * body type.
          */
         tracker: TrackerTriggerContext | null;
+        /**
+         * The action that started this attempt: the Solana transaction the member signed, which an app's
+         * server submitted with `management.attempts.submitSolanaTransaction()`, with the signing wallet
+         * and the memo's `reference`. Null or absent for any other attempt.
+         *
+         * @experimental A minor release can change quest actions.
+         */
+        action?: SolanaTransactionAction | null;
         /**
          * When the activity happened, in epoch milliseconds: the tracker record's occurrence time, else
          * when the attempt was admitted. Budgets and daily keys use it.
@@ -2136,6 +2422,18 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
      * Omit it for no cooldown.
      */
     completionCooldownMs?: number;
+    /**
+     * Check-in stations, up to 200: `{ key, label, opensAt?, closesAt? }`, with each key the
+     * `reference` of a station's memo (`solanaActionMemo({ quest, reference })`) and the window
+     * in epoch milliseconds. A signed transaction completes the quest only when its memo names
+     * a station that was open at the transaction's block time; complete it once per station
+     * with `perStation()`. Only on a member-submitted `manual()` quest without input. Keep a
+     * station's key once its codes are printed: to rotate codes, add a station and close the
+     * old one.
+     *
+     * @experimental A minor release can change check-in stations.
+     */
+    stations?: readonly QuestStation[];
     /**
      * Whether staff can review this quest's attempts. Human review is on unless this returns
      * `{ enabled: false }`. With it off, `decision.review(...)` becomes a reject that keeps the
@@ -2232,7 +2530,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
             imageAlt?: string | undefined;
             requirements?: ({
                 kind: "account";
-                provider: "discord" | "x" | "google" | "apple";
+                provider: "x" | "discord" | "google" | "apple";
             } | {
                 kind: "wallet";
                 chain?: "solana" | "eip155" | "cosmos" | undefined;
@@ -2256,7 +2554,7 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
                 } | undefined;
             } | undefined;
         };
-        integrations: ("discord" | "x")[];
+        integrations: ("x" | "discord")[];
         fields: Record<string, {
             kind: "point-ledger";
             default: string;
@@ -2537,6 +2835,12 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
         }[] | undefined;
         retryCooldownMs?: number | undefined;
         completionCooldownMs?: number | undefined;
+        stations?: {
+            key: string;
+            label: string;
+            opensAt?: number | undefined;
+            closesAt?: number | undefined;
+        }[] | undefined;
     };
     evaluate(ctx: {
         settings: unknown;
@@ -2549,6 +2853,14 @@ declare const defineQuestType: <T extends Record<string, Setting>, const G exten
          * body type.
          */
         tracker: TrackerTriggerContext | null;
+        /**
+         * The action that started this attempt: the Solana transaction the member signed, which an app's
+         * server submitted with `management.attempts.submitSolanaTransaction()`, with the signing wallet
+         * and the memo's `reference`. Null or absent for any other attempt.
+         *
+         * @experimental A minor release can change quest actions.
+         */
+        action?: SolanaTransactionAction | null;
         /**
          * When the activity happened, in epoch milliseconds: the tracker record's occurrence time, else
          * when the attempt was admitted. Budgets and daily keys use it.
@@ -2598,4 +2910,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, ContractCall, ContractEvent, DiscordMessageData, DiscordMessageTextData, DiscordReactionData, DiscordReader, type EvaluationCalendar, type EvaluationCalendarDay, type EvaluationContext, type EvaluationMember, GroupHandle, IdentityKind, ImageReader, IntegrationModule, IntegrationModuleProvider, type KeyedContext, type KeyedOptions, KnownIntegrationModule, 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, defineOffer, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, earned, evaluators, evidence, groupMembership, instruction, invoked, keyed, leaderboardTiesWarning, manual, once, pointLedgers, points, progress, questCompleted, received, rolling, settings, spent, staffHandover, streak, swapped, telegram, tiktok, untracked, wallet, 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, IntegrationModuleProvider, type KeyedContext, type KeyedOptions, KnownIntegrationModule, LedgerHandle, LedgerReference, MemberCompletion, type MemberCompletionQuery, MemberIdentity, NftCollection, type Outcome, type PerformanceContext, type PerformanceOutcome, PointBalance, ProfileReferral, QuestHandle, type QuestKeyedContext, QuestStation, ReferralHandle, RoleOf, Setting, SolanaProgram, SolanaTransactionAction, TelegramReader, Tracker, TrackerData, TrackerDataSchema, TrackerReader, type TrackerTrigger, TrackerTriggerContext, type TrackerTriggerInput, type TriggerAdmission, WalletBalanceSourceQuery, WalletInstruction, WalletNftSourceQuery, WalletProgramActivitySourceQuery, WalletReader, WalletStakeSourceQuery, WalletTransaction, Where, type XContentBody, XReader, automatic, automaticFulfillment, badge, budget, calendar, content, count, customSource, decision, defineBadge, defineEngagementReward, defineLeaderboard, defineLedger, defineOffer, defineQuest, defineQuestType, defineReferral, defineTieredReward, defineTracker, discord, earned, evaluators, evidence, groupMembership, instruction, invoked, keyed, leaderboardTiesWarning, manual, once, perStation, pointLedgers, points, progress, questCompleted, received, rolling, settings, spent, staffHandover, streak, swapped, telegram, tiktok, untracked, wallet, x, youtube };