@domino-sdk/relay 1.67.0 → 1.69.0

package/dist/{submission-input-C152xIdn.d.ts → submission-input-BD7nORuh.d.ts}

@@ -1,6 +1,6 @@
 import * as z from 'zod';
-import { L as LedgerReference, Q as QuestHandle } from './tracker-data-BqY-9Vu-.js';
-import { B as ProjectGroupReference } from './accounts-C2O8mpB8.js';
+import { L as LedgerReference, Q as QuestHandle } from './tracker-data-DQgX3FIc.js';
+import { B as ProjectGroupReference } from './accounts-DD4gAOCe.js';
 
 declare const completionPrerequisiteSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"completion">;
@@ -340,4 +340,5 @@ declare function validateSubmissionValue(input: ValueEvidence, contract: {
 /** Extract an ID only. The URL and its author name are untrusted claims. */
 declare function xPostId(value: string): string | null;
 
-export { telegramChatsSchema as A, telegramConnectionInputSchema as B, telegramConnectionSchema as C, telegramInitDataSchema as D, telegramMemberInputSchema as E, telegramMessageDataSchema as F, telegramMiniAppSignInSchema as G, telegramReactionDataSchema as H, telegramSignInMethodsSchema as I, textEvidenceSchema as J, textOptionsSchema as K, urlEvidenceSchema as L, type MissingPrerequisite as M, urlOptionsSchema as N, validateSubmissionValue as O, type Prerequisite as P, valueEvidenceSchema as Q, xPostId as R, type TelegramAccountConnection as T, type UrlEvidence as U, type ValueEvidence as V, type TelegramSignInMethods as a, type TextEvidence as b, type TextOptions as c, type UrlOptions as d, type TelegramReader as e, type TelegramChatMember as f, type TelegramChatMemberStatus as g, type TelegramConnection as h, type TelegramMessageData as i, type TelegramReactionData as j, balanceAtLeast as k, completed as l, inGroup as m, type TelegramChat as n, type TelegramChatConnection as o, type TelegramChats as p, balancePrerequisiteSchema as q, completionPrerequisiteSchema as r, groupPrerequisiteSchema as s, missingPrerequisiteSchema as t, prerequisiteSchema as u, telegramAccountConnectionSchema as v, telegramChatConnectionSchema as w, telegramChatIdSchema as x, telegramChatMemberSchema as y, telegramChatSchema as z };
+export { telegramChatsSchema as A, telegramConnectionInputSchema as B, telegramConnectionSchema as C, telegramInitDataSchema as D, telegramMemberInputSchema as E, telegramMessageDataSchema as F, telegramMiniAppSignInSchema as G, telegramReactionDataSchema as H, telegramSignInMethodsSchema as I, textEvidenceSchema as J, textOptionsSchema as K, urlEvidenceSchema as L, urlOptionsSchema as N, validateSubmissionValue as O, valueEvidenceSchema as Q, xPostId as R, balanceAtLeast as k, completed as l, inGroup as m, balancePrerequisiteSchema as q, completionPrerequisiteSchema as r, groupPrerequisiteSchema as s, missingPrerequisiteSchema as t, prerequisiteSchema as u, telegramAccountConnectionSchema as v, telegramChatConnectionSchema as w, telegramChatIdSchema as x, telegramChatMemberSchema as y, telegramChatSchema as z };
+export type { MissingPrerequisite as M, Prerequisite as P, TelegramAccountConnection as T, UrlEvidence as U, ValueEvidence as V, TelegramSignInMethods as a, TextEvidence as b, TextOptions as c, UrlOptions as d, TelegramReader as e, TelegramChatMember as f, TelegramChatMemberStatus as g, TelegramConnection as h, TelegramMessageData as i, TelegramReactionData as j, TelegramChat as n, TelegramChatConnection as o, TelegramChats as p };

package/dist/{telegram-browser-657QqiQl.d.ts → telegram-browser-gRMgGs7B.d.ts}

@@ -1,111 +1,9 @@
-import { c as AuthProvider, J as SignInProvider } from './accounts-C2O8mpB8.js';
-import { p as createRelayClient, k as RelayRequestOptions, g as RelayError } from './client-CZPewB9h.js';
-import { a as TelegramSignInMethods } from './submission-input-C152xIdn.js';
-import { b as ParticipantSession } from './participant-activity-DXRq4s6K.js';
-import { C as CosmosChain, a as CosmosNetwork, m as WalletSigner, k as WalletSignInNetwork } from './wallet-Btng186v.js';
-
-/** An EIP-1193 provider, such as `window.ethereum` or an EIP-6963 announcement's provider. */
-type Eip1193Provider = {
-    request(args: {
-        method: string;
-        params?: unknown[] | object;
-    }): Promise<unknown>;
-    /** Subscribes to a provider event such as `accountsChanged`; wallets without events leave it out. */
-    on?(event: string, listener: (...args: unknown[]) => void): unknown;
-    removeListener?(event: string, listener: (...args: unknown[]) => void): unknown;
-};
-/** The legacy injected Solana shape Phantom, Solflare and Backpack expose. */
-type SolanaInjectedProvider = {
-    connect(): Promise<unknown>;
-    publicKey?: {
-        toBase58(): string;
-    } | null;
-    signMessage(message: Uint8Array, display?: "utf8"): Promise<{
-        signature: Uint8Array;
-    } | Uint8Array>;
-};
-/** The part of a Wallet Standard account Relay uses. */
-type StandardWalletAccount = {
-    readonly address: string;
-    readonly chains: readonly string[];
-};
-/** The part of a Wallet Standard wallet Relay uses; any conforming wallet object fits. */
-type StandardWallet = {
-    readonly name: string;
-    readonly icon?: string;
-    readonly chains: readonly string[];
-    readonly accounts: readonly StandardWalletAccount[];
-    readonly features: Readonly<Record<string, unknown>>;
-};
-/** Keplr's API, which Leap and Cosmostation also implement. */
-type KeplrLike = {
-    enable(chainId: string | string[]): Promise<void>;
-    getKey(chainId: string): Promise<{
-        bech32Address: string;
-    }>;
-    signArbitrary(chainId: string, signer: string, data: string): Promise<{
-        signature: string;
-        pub_key: {
-            type: string;
-            value: string;
-        };
-    }>;
-    /** Adds a chain the wallet does not know, after the user approves it. */
-    experimentalSuggestChain?(chainInfo: CosmosChain["chainInfo"]): Promise<void>;
-};
-/** A wallet found in the page, ready to pass to `relay.wallets.link`. */
-type DiscoveredWallet = {
-    id: string;
-    name: string;
-    icon?: string;
-    signer: WalletSigner;
-};
-/** Signs with an EIP-1193 provider through `personal_sign`. */
-declare function evmSigner(provider: Eip1193Provider, info?: {
-    name?: string;
-}): WalletSigner;
-/** Signs with a legacy injected Solana provider, such as `window.phantom.solana`. */
-declare function solanaSigner(provider: SolanaInjectedProvider, info?: {
-    name?: string;
-}): WalletSigner;
-/** Signs with a Wallet Standard wallet's `solana:signMessage` feature. */
-declare function walletStandardSolanaSigner(wallet: StandardWallet): WalletSigner;
-/**
- * Signs an ADR-36 message with Keplr or a wallet that implements its API, on the app's chain:
- * `{ chainId, chainInfo? }` or `"cosmos:<chain ID>"`. When the wallet does not know the chain and
- * `chainInfo` is given, it suggests the chain to the wallet (`experimentalSuggestChain`) and tries
- * again; without `chainInfo`, or with a wallet that cannot add chains, it throws an error that
- * names the chain. Other failures, such as a rejected request, pass through.
- */
-declare function cosmosSigner(provider: KeplrLike, chain: CosmosChain | CosmosNetwork, info?: {
-    name?: string;
-}): WalletSigner;
-/** EIP-6963 wallets, or `window.ethereum` when none announce themselves within `timeoutMs`. */
-declare function discoverEvmWallets(timeoutMs?: number): Promise<DiscoveredWallet[]>;
-/** Wallet Standard wallets that can sign Solana messages, then legacy injected providers. */
-declare function discoverSolanaWallets(): DiscoveredWallet[];
-/**
- * Keplr, Leap and Cosmostation, each signing on the app's chain (see `cosmosSigner`). IDs end with
- * the chain ID.
- */
-declare function discoverCosmosWallets(chain: CosmosChain | CosmosNetwork): DiscoveredWallet[];
-/**
- * The Cosmos SDK chains an app offers wallets on: one chain or several, each as
- * `{ chainId, chainInfo? }` or `"cosmos:<chain ID>"`. Relay has no chain list of its own.
- */
-type CosmosChains = CosmosChain | CosmosNetwork | readonly (CosmosChain | CosmosNetwork)[];
-/** The chains in `CosmosChains`, as a list. */
-declare function cosmosChainList(chains: CosmosChains | undefined): (CosmosChain | CosmosNetwork)[];
-/** An installed wallet that can sign in on one of the project's enabled wallet families. */
-type SignInWallet = DiscoveredWallet & {
-    network: WalletSignInNetwork;
-};
-/**
- * The wallets installed in this browser that can sign in with `families`: EVM wallets first, then
- * Solana wallets, then Cosmos wallets once per chain in `cosmos`. Without `cosmos` there are no
- * Cosmos wallets. Empty during SSR.
- */
-declare function discoverSignInWallets(families: readonly WalletSignInNetwork[], cosmos?: CosmosChains): Promise<SignInWallet[]>;
+import { c as AuthProvider, J as SignInProvider } from './accounts-DD4gAOCe.js';
+import { p as createRelayClient, k as RelayRequestOptions, g as RelayError } from './client-6eSYOl8h.js';
+import { a as TelegramSignInMethods } from './submission-input-BD7nORuh.js';
+import { b as ParticipantSession } from './participant-activity-BznrcePT.js';
+import { e as WalletSignInNetwork, g as WalletSigner } from './wallet-CPAjrW4k.js';
+import { C as CosmosChains } from './wallet-browser-BzPt_Qb5.js';
 
 type Auth = ReturnType<typeof createRelayClient>["auth"];
 /**
@@ -286,4 +184,5 @@ declare function signInOptions(relay: SignInClient, input?: {
  */
 declare function telegramMiniAppInitData(): string | null;
 
-export { type CosmosChains as C, type DiscoveredWallet as D, type Eip1193Provider as E, type KeplrLike as K, type OAuthSignInOption as O, type ProviderSignInOption as P, type SignInClient as S, type TelegramSignInOption as T, type WalletSignInOption as W, type EmailSignInOption as a, type SignInIcon as b, type SignInMethods as c, type SignInOption as d, type SignInOptions as e, type SignInUnavailable as f, type SignInWallet as g, type SolanaInjectedProvider as h, type StandardWallet as i, type StandardWalletAccount as j, cosmosChainList as k, cosmosSigner as l, discoverCosmosWallets as m, discoverEvmWallets as n, discoverSignInWallets as o, discoverSolanaWallets as p, evmSigner as q, solanaSigner as r, signInOptions as s, telegramMiniAppInitData as t, walletStandardSolanaSigner as w };
+export { signInOptions as s, telegramMiniAppInitData as t };
+export type { EmailSignInOption as E, OAuthSignInOption as O, ProviderSignInOption as P, SignInClient as S, TelegramSignInOption as T, WalletSignInOption as W, SignInIcon as a, SignInMethods as b, SignInOption as c, SignInOptions as d, SignInUnavailable as e };

package/dist/telegram.d.ts

@@ -1,15 +1,16 @@
-import { k as RelayRequestOptions, R as RelayClient } from './client-CZPewB9h.js';
-import { b as ParticipantSession } from './participant-activity-DXRq4s6K.js';
-import './accounts-C2O8mpB8.js';
+import { RelayRequestOptions, RelayClient } from './index.js';
+import { ParticipantSession } from './index.js';
+import './accounts-DD4gAOCe.js';
 import 'zod';
-import './tracker-data-BqY-9Vu-.js';
-import './wallet-Btng186v.js';
-import './submission-input-C152xIdn.js';
-import './request-error-D_dUPLwo.js';
-import './reward-deliveries-BOWpMytr.js';
-import './catalog-CbiftcxQ.js';
-import './action-9Xl0StBg.js';
-import './sign-in-providers-BRYVOSlG.js';
+import './tracker-data-DQgX3FIc.js';
+import './wallet-CPAjrW4k.js';
+import './submission-input-BD7nORuh.js';
+import './request-error-C24SY7n9.js';
+import './reward-deliveries-DFhYGJdx.js';
+import './catalog-Cf3fHDNn.js';
+import './action-BDFKqGlH.js';
+import './sign-in-providers-C97mRNbG.js';
+import './profiles-CLDKZVFx.js';
 
 /**
  * A plugin's own sign-in method, such as Telegram's Mini App sign-in: the app passes the vendor's
@@ -61,4 +62,5 @@ declare function withTelegram<Client extends RelayClient>(relay: Client): Client
  */
 declare function telegramMiniAppInitData(): string | null;
 
-export { type PluginSignInMethod, type TelegramClient, telegramMiniAppInitData, withTelegram };
+export { telegramMiniAppInitData, withTelegram };
+export type { PluginSignInMethod, TelegramClient };

package/dist/telegram.js

@@ -3,8 +3,8 @@ import {
 } from "./chunk-FWLQ5XCS.js";
 import {
   withPluginNamespace
-} from "./chunk-2HHZV7U3.js";
-import "./chunk-FGXLXENM.js";
+} from "./chunk-LDO5GP7G.js";
+import "./chunk-VNEJH4NT.js";
 
 // src/plugins/telegram.generated.ts
 function withTelegram(relay) {

package/dist/testing.d.ts

@@ -1,19 +1,27 @@
-import { d5 as pointBalanceSchema, bD as discordMemberSchema, bG as discordMessageSchema, c$ as photoResultSchema, a8 as TextReviewInput, H as Reward, ac as Decision, P as PointBalance, y as PointLedgerReference, u as PointEntry, o as LeaderboardPage } from './accounts-C2O8mpB8.js';
+import { ae as Decision } from './accounts-DD4gAOCe.js';
+import { PointBalance } from './authoring.js';
+import { Reward, PointLedgerReference, PointEntry, LeaderboardPage } from './index.js';
+import { pointBalanceSchema, discordMemberSchema, discordMessageSchema, photoResultSchema, TextReviewInput } from './schema.js';
+import { NftCollection, SolanaSeed, WalletCallArgument, WalletEventCondition, WalletReader } from './authoring.js';
+import { linkedWalletSchema, walletBalanceSchema, walletNftsSchema, walletCallSchema, walletDelegationsSchema, walletEventsSchema, walletTransactionsSchema, walletProgramAccountSchema, walletStakeSchema, SolanaNetwork } from './schema.js';
 import * as z from 'zod';
-import { N as NftCollection, aR as profileReferralSchema, aH as linkedWalletSchema, b0 as walletBalanceSchema, b6 as walletNftsSchema, Q as WalletCallArgument, b1 as walletCallSchema, b3 as walletDelegationsSchema, V as WalletEventCondition, b4 as walletEventsSchema, bb as walletTransactionsSchema, w as WalletReader } from './wallet-Btng186v.js';
-import { f as CapabilityFailure, q as memberCompletionSchema } from './capability-error-CuI_F7yM.js';
-export { C as CapabilityError } from './capability-error-CuI_F7yM.js';
-import { C as xConnectionSchema, G as xProfileSchema, F as xPostSchema, g as ImageReference, u as imageInspectionSchema, q as imageComparisonSchema, x as imageSightingsSchema } from './limits-C4RzrOV4.js';
-export { L as Limits, l as limits } from './limits-C4RzrOV4.js';
-import { aM as memberIdentitySchema, bf as trackerQuerySchema, ba as trackerPageSchema, bo as trackerSummarySchema, ac as TrackerContentQuery, aX as trackerContentSchema, a8 as TrackerAttribution, o as Tracker, p as TrackerData, H as ContentBody, B as TrackerTriggerContext, U as TrackerPage } from './tracker-data-BqY-9Vu-.js';
-import { C as telegramConnectionSchema, y as telegramChatMemberSchema, e as TelegramReader } from './submission-input-C152xIdn.js';
+import { CapabilityFailure, memberCompletionSchema } from './schema.js';
+export { C as CapabilityError } from './capability-error-db7kO8-P.js';
+import { xConnectionSchema, xProfileSchema, xPostSchema, ImageReference, imageInspectionSchema, imageComparisonSchema, imageSightingsSchema } from './schema.js';
+export { L as Limits, l as limits } from './limits-Ctaeq23J.js';
+import { Tracker, TrackerData, ContentBody, TrackerTriggerContext, TrackerPage } from './authoring.js';
+import { memberIdentitySchema, trackerQuerySchema, trackerPageSchema, trackerSummarySchema, TrackerContentQuery, trackerContentSchema, TrackerAttribution } from './schema.js';
+import { TelegramReader } from './authoring.js';
+import { telegramConnectionSchema, telegramChatMemberSchema } from './schema.js';
+import { profileReferralSchema } from './schema.js';
 import { EvaluationMember } from './authoring.js';
-export { A as AttemptCapture, C as CapturedFact } from './attempt-captures-ClHAoo_n.js';
-import { b as ParticipantSession, R as RelayEvent } from './participant-activity-DXRq4s6K.js';
-import { B as Badge } from './offers-BpYenB9i.js';
-import { b as QuestView, q as questExperienceSchema } from './catalog-CbiftcxQ.js';
-import './streaks-0YuipsUQ.js';
-import './dashboards-jGPM3AxF.js';
+export { A as AttemptCapture, C as CapturedFact } from './attempt-captures-CbuCmthd.js';
+import { ParticipantSession, RelayEvent } from './index.js';
+import { Badge } from './index.js';
+import { QuestView } from './index.js';
+import { questExperienceSchema } from './schema.js';
+import './streaks-MAqKHbHC.js';
+import './dashboards-DCOAXL54.js';
 import './units-CwgsPB_r.js';
 
 /** One project time-zone change: from `effectiveAt` on, days are counted in `timeZone`. */
@@ -275,6 +283,24 @@ declare const walletTransactionsRequestSchema: z.ZodObject<{
     address: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 type WalletTransactionsRequest = z.output<typeof walletTransactionsRequestSchema>;
+/** `ctx.wallet.programAccount()`'s request: answered and numbered like transaction reads, and unlisted the same way. */
+declare const walletProgramAccountRequestSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"wallet-program-account">;
+    program: z.ZodString & z.ZodType<string, string, z.core.$ZodTypeInternals<string, string>>;
+    chain: z.ZodOptional<z.ZodLiteral<"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1">>;
+    account: z.ZodString;
+    seeds: z.ZodArray<z.ZodType<SolanaSeed, unknown, z.core.$ZodTypeInternals<SolanaSeed, unknown>>>;
+    address: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type WalletProgramAccountRequest = z.output<typeof walletProgramAccountRequestSchema>;
+/** `ctx.wallet.stake()`'s request: answered and numbered like transaction reads, and unlisted the same way. */
+declare const walletStakeRequestSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"wallet-stake">;
+    chain: z.ZodOptional<z.ZodLiteral<"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1">>;
+    voteAccount: z.ZodNullable<z.ZodString>;
+    address: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+type WalletStakeRequest = z.output<typeof walletStakeRequestSchema>;
 /**
  * `ctx.wallet.call()`'s and `ctx.wallet.delegations()`'s requests. Like NFT reads, they stay out of
  * the closed `CapabilityRequest`: the kit answers and numbers them, but lists them only in a run's `capabilityCalls`, not in the deprecated `calls`.
@@ -325,7 +351,7 @@ declare const memberStateRequestSchemas: {
 };
 type MemberStateRequest = z.output<(typeof memberStateRequestSchemas)[keyof typeof memberStateRequestSchemas]>;
 /** Every request the kit answers: the public `CapabilityRequest` kinds, Telegram's, NFT, contract call and delegation reads, and the member's state. */
-type KitRequest = CapabilityRequest | TelegramRequest | WalletNftsRequest | WalletCallRequest | WalletDelegationsRequest | WalletEventsRequest | WalletTransactionsRequest | MemberStateRequest;
+type KitRequest = CapabilityRequest | TelegramRequest | WalletNftsRequest | WalletCallRequest | WalletDelegationsRequest | WalletEventsRequest | WalletTransactionsRequest | WalletProgramAccountRequest | WalletStakeRequest | MemberStateRequest;
 /**
  * The capability kinds this release of the kit knows, one per reader method family.
  *
@@ -406,6 +432,26 @@ type WalletTransactionsQueryRequest = {
     mint: string | null;
     address: string | null;
 };
+/**
+ * A program-account read as Relay receives it: `chain` only for devnet, and `address` null when
+ * the quest leaves it out.
+ */
+type WalletProgramAccountQueryRequest = {
+    program: string;
+    chain?: string;
+    account: string;
+    seeds: SolanaSeed[];
+    address: string | null;
+};
+/**
+ * A stake read as Relay receives it: `chain` only for devnet, and `voteAccount` and `address` null
+ * when the quest leaves them out.
+ */
+type WalletStakeQueryRequest = {
+    chain?: string;
+    voteAccount: string | null;
+    address: string | null;
+};
 /** A tracker read as Relay receives it: defaults applied, and `asOf` set (`eligibleAt` unless given). */
 type TrackerReadRequest = z.output<typeof trackerQuerySchema> & {
     asOf: number;
@@ -428,7 +474,7 @@ type TrackerFacts = {
  *
  * Reads of the member's own accounts default to a member who has linked nothing:
  * `member.identities()`, `wallet.list()`, `wallet.balance()`, `wallet.nfts()`, `wallet.call()`,
- * `wallet.delegations()`, `x.connection()`, `x.profile()`,
+ * `wallet.delegations()`, `wallet.events()`, `wallet.transactions()`, `wallet.programAccount()`, `wallet.stake()`, `x.connection()`, `x.profile()`,
  * `x.follows()`, `x.reposted()`, `discord.member()`, `telegram.connection()` and `telegram.member()` resolve to null. Once the test links an
  * account (`wallet.list` or `x.connection` set to a value), supply every read of it the quest
  * makes. Every other read (the member's balances, completions, groups, campaigns and referrals, an
@@ -510,11 +556,30 @@ type TestFacts = {
          * `ctx.wallet.transactions({ program, since })`. Like `balance`, it reads null while the
          * member has no linked Solana wallet. The kit does not apply `program`, `since` or `mint`:
          * answer with the transactions Relay would return, with `instructions` when the program's
-         * setting has an Anchor IDL. A run's `capabilityCalls` lists these calls; the deprecated `calls` does not.
+         * setting has an IDL. A run's `capabilityCalls` lists these calls; the deprecated `calls` does not.
          */
         transactions?: FakeAnswer<[
             query: WalletTransactionsQueryRequest
         ], Result<typeof walletTransactionsSchema> | null>;
+        /**
+         * `ctx.wallet.programAccount({ program, account, seeds })`. Like `balance`, it reads null
+         * while the member has no linked Solana wallet. The kit does not derive or decode accounts:
+         * answer with the decoded fields Relay would return per wallet, `fields: null` for a wallet
+         * without the account. A run's `capabilityCalls` lists these calls; the deprecated `calls`
+         * does not.
+         */
+        programAccount?: FakeAnswer<[
+            query: WalletProgramAccountQueryRequest
+        ], Result<typeof walletProgramAccountSchema> | null>;
+        /**
+         * `ctx.wallet.stake({ voteAccount })`. Like `balance`, it reads null while the member has no
+         * linked Solana wallet. The kit does not classify stake accounts: answer with the amounts
+         * Relay would return. A run's `capabilityCalls` lists these calls; the deprecated `calls`
+         * does not.
+         */
+        stake?: FakeAnswer<[
+            query: WalletStakeQueryRequest
+        ], Result<typeof walletStakeSchema> | null>;
     };
     x?: {
         connection?: FakeAnswer<[], Result<typeof xConnectionSchema> | null>;
@@ -670,6 +735,21 @@ type RunQuestOptions<Q extends TestableQuest = TestableQuest> = {
      * `trackerObservation(tracker, { data })`.
      */
     tracker?: unknown;
+    /**
+     * The signed Solana transaction that started the attempt, `ctx.action`: the member's `wallet`
+     * that signed it and the memo's `reference`. As in Relay, only a member-submitted `manual()`
+     * quest without input takes one. `signature` and `chain` (mainnet) have defaults. On a quest with
+     * `stations`, the reference must name a station open at `now`, which stands in for the
+     * transaction's block time, and a run without an action is refused, as Relay refuses them.
+     *
+     * @experimental A minor release can change quest actions.
+     */
+    action?: {
+        wallet: string;
+        reference?: string | null;
+        signature?: string;
+        chain?: SolanaNetwork;
+    };
     /** A content quest's performance stage: the metric sample to evaluate. */
     performance?: {
         metrics: Record<string, number>;
@@ -1103,4 +1183,5 @@ type FakeRelay = {
  */
 declare function createFakeRelay(options?: FakeRelayOptions): FakeRelay;
 
-export { type AttemptReplay, type CalendarSegment, type CapabilityCall, type CapabilityCallRecord, type CapabilityCallRequest, type CapabilityDivergence, type CapabilityOutcome, type CapabilityRequest, Decision, DecisionAssertionError, EvaluatorError, type FakeAnswer, type FakeRelay, type FakeRelayOptions, type FakeRelayRequest, type KnownCapabilityKind, type KnownDivergenceReason, type QuestDiagnostic, type QuestHostContext, type QuestInputOf, type QuestRun, type ReplayDivergence, type ReplayOptions, type RunQuestOptions, type TestContext, type TestFacts, type TestRelease, TestSetupError, type TestableQuest, type TrackerFacts, type TrackerObservationInput, type TrackerReadRequest, type TrackerRecordInput, type WalletBalanceRequest, createFakeRelay, createTestContext, defaultMember, defaultNow, defaultSeed, expectAccept, expectDefer, expectProgress, expectReject, expectReview, fakeEvaluationMember, fakeTelegramReader, fakeWalletReader, maxCapabilityCalls, replayAttempt, runQuest, trackerObservation, trackerPage };
+export { Decision, DecisionAssertionError, EvaluatorError, TestSetupError, createFakeRelay, createTestContext, defaultMember, defaultNow, defaultSeed, expectAccept, expectDefer, expectProgress, expectReject, expectReview, fakeEvaluationMember, fakeTelegramReader, fakeWalletReader, maxCapabilityCalls, replayAttempt, runQuest, trackerObservation, trackerPage };
+export type { AttemptReplay, CalendarSegment, CapabilityCall, CapabilityCallRecord, CapabilityCallRequest, CapabilityDivergence, CapabilityOutcome, CapabilityRequest, FakeAnswer, FakeRelay, FakeRelayOptions, FakeRelayRequest, KnownCapabilityKind, KnownDivergenceReason, QuestDiagnostic, QuestHostContext, QuestInputOf, QuestRun, ReplayDivergence, ReplayOptions, RunQuestOptions, TestContext, TestFacts, TestRelease, TestableQuest, TrackerFacts, TrackerObservationInput, TrackerReadRequest, TrackerRecordInput, WalletBalanceRequest };

package/dist/testing.js

@@ -1,19 +1,19 @@
 import {
   attemptCaptureSchema
-} from "./chunk-RDUSFUXX.js";
+} from "./chunk-GEVARKEV.js";
 import {
   parseImageResult
-} from "./chunk-RWR2LOPA.js";
+} from "./chunk-RKTMSTT7.js";
 import {
   isParticipantRoute
-} from "./chunk-U66GUVSG.js";
+} from "./chunk-LZXDYSUH.js";
 import {
   imageRequestSchema,
   xConnectionSchema,
   xPostSchema,
   xProfileSchema,
   xRequestSchema
-} from "./chunk-X3FMVRMM.js";
+} from "./chunk-DIXYVGXO.js";
 import {
   CapabilityError
 } from "./chunk-MWMCQLCG.js";
@@ -22,7 +22,7 @@ import {
   participantActivitySchema,
   participantSessionSchema,
   questExperienceSchema
-} from "./chunk-DSJ46QLB.js";
+} from "./chunk-PO2ZDY27.js";
 import {
   badgeCatalogSchema,
   badgeSchema,
@@ -44,6 +44,7 @@ import {
   leaderboardPageSchema,
   limits,
   linkedWalletSchema,
+  maxSolanaSeeds,
   memberCompletionSchema,
   memberIdentitySchema,
   photoResultSchema,
@@ -52,11 +53,15 @@ import {
   pointHistoryPageSchema,
   pointLedgerReferenceSchema,
   profileReferralSchema,
+  questStationsSchema,
   quizEvidenceSchema,
   rewardKey,
   solanaAddressSchema,
   solanaDevnet,
   solanaMainnet,
+  solanaSeedSchema,
+  stationRefusal,
+  takesSolanaTransaction,
   telegramChatMemberSchema,
   telegramConnectionInputSchema,
   telegramConnectionSchema,
@@ -78,11 +83,13 @@ import {
   walletDelegationsSchema,
   walletEventsSchema,
   walletNftsSchema,
+  walletProgramAccountSchema,
+  walletStakeSchema,
   walletTransactionsSchema
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-CQVKOD3B.js";
 import {
   RelayErrorCode
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-VNEJH4NT.js";
 
 // src/testing/run.ts
 import * as z3 from "zod";
@@ -256,6 +263,22 @@ var walletTransactionsRequestSchema = /* @__PURE__ */ (() => z.strictObject({
   mint: solanaAddressSchema.nullable(),
   address: z.string().min(1).max(100).nullable()
 }))();
+var walletProgramAccountRequestSchema = /* @__PURE__ */ (() => z.strictObject({
+  kind: z.literal("wallet-program-account"),
+  program: z.string().max(44).refine(isSolanaProgram),
+  /** Solana devnet; absent for mainnet, as Relay's request has it. */
+  chain: z.literal(solanaDevnet).optional(),
+  account: z.string().min(1).max(200),
+  seeds: z.array(solanaSeedSchema).max(maxSolanaSeeds),
+  address: z.string().min(1).max(100).nullable()
+}))();
+var walletStakeRequestSchema = /* @__PURE__ */ (() => z.strictObject({
+  kind: z.literal("wallet-stake"),
+  /** Solana devnet; absent for mainnet, as Relay's request has it. */
+  chain: z.literal(solanaDevnet).optional(),
+  voteAccount: z.string().min(1).max(100).nullable(),
+  address: z.string().min(1).max(100).nullable()
+}))();
 var walletCallRequestSchema = /* @__PURE__ */ (() => z.strictObject({
   kind: z.literal("wallet-call"),
   call: z.string().max(400).refine(isContractCall),
@@ -300,7 +323,7 @@ var memberStateRequestSchemas = /* @__PURE__ */ (() => ({
   })
 }))();
 function unlistedRequest(request) {
-  return request.kind === "telegram" || request.kind === "wallet-nfts" || request.kind === "wallet-call" || request.kind === "wallet-delegations" || request.kind === "wallet-events" || request.kind === "wallet-transactions" || request.kind === "member-balance" || request.kind === "member-completions" || request.kind === "member-groups" || request.kind === "member-enrolled" || request.kind === "member-referrals";
+  return request.kind === "telegram" || request.kind === "wallet-nfts" || request.kind === "wallet-call" || request.kind === "wallet-delegations" || request.kind === "wallet-events" || request.kind === "wallet-transactions" || request.kind === "wallet-program-account" || request.kind === "wallet-stake" || request.kind === "member-balance" || request.kind === "member-completions" || request.kind === "member-groups" || request.kind === "member-enrolled" || request.kind === "member-referrals";
 }
 var capabilityRequestSchema = /* @__PURE__ */ (() => z.discriminatedUnion("kind", [
   capabilityRequestSchemas["wallet-balance"],
@@ -320,6 +343,8 @@ var capabilityRequestSchema = /* @__PURE__ */ (() => z.discriminatedUnion("kind"
   walletDelegationsRequestSchema,
   walletEventsRequestSchema,
   walletTransactionsRequestSchema,
+  walletProgramAccountRequestSchema,
+  walletStakeRequestSchema,
   memberStateRequestSchemas["member-balance"],
   memberStateRequestSchemas["member-completions"],
   memberStateRequestSchemas["member-groups"],
@@ -378,6 +403,10 @@ function parseCapabilityResult(request, value) {
       return walletEventsSchema.nullable().parse(value);
     case "wallet-transactions":
       return walletTransactionsSchema.nullable().parse(value);
+    case "wallet-program-account":
+      return walletProgramAccountSchema.nullable().parse(value);
+    case "wallet-stake":
+      return walletStakeSchema.nullable().parse(value);
     case "member-balance":
       return pointBalanceSchema.parse(value);
     case "member-completions":
@@ -434,6 +463,7 @@ function capabilityEvidence(request) {
     (image) => "evidence" in image ? [image.evidence] : []
   );
 }
+var solanaCluster = (chain) => chain === void 0 || chain === "solana" || chain === solanaMainnet ? {} : { chain };
 var readerFactories = {
   member: (call, input) => {
     const key = (reference) => typeof reference === "string" ? reference : reference.key;
@@ -544,12 +574,25 @@ var readerFactories = {
     transactions: (query) => call({
       kind: "wallet-transactions",
       program: query.program,
-      // Only for another cluster, so a mainnet read sends the request it always did.
-      ...query.chain === void 0 || query.chain === "solana" || query.chain === solanaMainnet ? {} : { chain: query.chain },
+      ...solanaCluster(query.chain),
       since: query.since,
       afterActivation: query.afterActivation ?? false,
       mint: query.mint ?? null,
       address: query.address ?? null
+    }),
+    programAccount: (query) => call({
+      kind: "wallet-program-account",
+      program: query.program,
+      ...solanaCluster(query.chain),
+      account: query.account,
+      seeds: query.seeds,
+      address: query.address ?? null
+    }),
+    stake: (query) => call({
+      kind: "wallet-stake",
+      ...solanaCluster(query.chain),
+      voteAccount: query.voteAccount ?? null,
+      address: query.address ?? null
     })
   })
 };
@@ -827,6 +870,22 @@ function fakeFor(facts, request) {
         args: [query]
       };
     }
+    case "wallet-program-account": {
+      const { kind: _, ...query } = request;
+      return {
+        name: "wallet.programAccount",
+        answer: facts.wallet?.programAccount,
+        args: [query]
+      };
+    }
+    case "wallet-stake": {
+      const { kind: _, ...query } = request;
+      return {
+        name: "wallet.stake",
+        answer: facts.wallet?.stake,
+        args: [query]
+      };
+    }
     case "x": {
       const { operation, ...input } = request.input;
       return {
@@ -1109,11 +1168,19 @@ function factsAnswerer(facts) {
         return wallets.length ? ask(fake) : { value: null };
       }
       case "wallet-events":
-      case "wallet-transactions": {
+      case "wallet-transactions":
+      case "wallet-program-account":
+      case "wallet-stake": {
         const pinned = await pin(walletList);
         if ("error" in pinned) {
           return pinned;
         }
+        if (request.kind === "wallet-stake" && request.voteAccount !== null && !solanaAddressSchema.safeParse(request.voteAccount).success) {
+          return failure(
+            "author-error",
+            `${request.voteAccount} is not a Solana vote account address`
+          );
+        }
         const chain = request.kind === "wallet-events" ? request.event.split(":").slice(0, 2).join(":") : request.chain ?? solanaMainnet;
         const wallets = (pinned.value ?? []).filter(
           (wallet) => covers(wallet, chain)
@@ -1216,6 +1283,7 @@ function rewardSelectionIssue(selected, published) {
 var defaultNow = /* @__PURE__ */ (() => Date.UTC(2026, 0, 1))();
 var defaultMember = "member_test";
 var defaultSeed = "attempt_test";
+var defaultSignature = /* @__PURE__ */ (() => "1".repeat(64))();
 var maxCapabilityCalls = 8;
 var evaluationTimeoutMs = 15e3;
 var time = (value) => value instanceof Date ? value.getTime() : value;
@@ -1292,6 +1360,23 @@ function hostedRun(quest, options) {
     trigger,
     options.input
   );
+  if (options.action && !takesSolanaTransaction(trigger)) {
+    throw new TestSetupError(
+      `Quest "${quest.key}" takes no Solana transaction: Relay accepts one only for a member-submitted manual() quest without input`
+    );
+  }
+  const stations = questStationsSchema.optional().parse(release.stations);
+  const station = stations && stationRefusal(stations, options.action?.reference ?? null, now);
+  if (station) {
+    throw new TestSetupError(`${station.message} (${station.code})`);
+  }
+  const action = options.action ? {
+    kind: "solana-transaction",
+    chain: options.action.chain ?? solanaMainnet,
+    signature: options.action.signature ?? defaultSignature,
+    wallet: options.action.wallet,
+    reference: options.action.reference ?? null
+  } : null;
   const performance = options.performance ? contentPerformanceSnapshotSchema.parse({
     contentAttempt: "attempt_content",
     observation: "observation_test",
@@ -1309,6 +1394,7 @@ function hostedRun(quest, options) {
     member,
     input,
     tracker,
+    action,
     eligibleAt,
     segments: options.calendar ?? (options.timeZone ? [{ effectiveAt: 0, timeZone: options.timeZone }] : []),
     ...performance ? { performance } : {},
@@ -1318,6 +1404,7 @@ function hostedRun(quest, options) {
 }
 function hostContext(run, answer) {
   const { release, member, input, tracker, eligibleAt, performance, now } = run;
+  const action = run.action ?? null;
   const evidence = typeof input.evidence === "string" ? input.evidence : void 0;
   const calendar = evaluationCalendar({ segments: run.segments }, eligibleAt);
   const calls = [];
@@ -1412,6 +1499,7 @@ function hostContext(run, answer) {
     humanReview: release.humanReview,
     input,
     tracker,
+    action,
     eligibleAt,
     calendar,
     now,
@@ -1848,6 +1936,8 @@ async function replayAttempt(quest, capture, options = {}) {
       member: context.member,
       input: context.input,
       tracker: context.tracker,
+      // Relay records only Solana transaction actions so far.
+      action: context.action ?? null,
       eligibleAt: context.eligibleAt,
       segments: context.calendar.segments,
       ...context.performance ? { performance: context.performance } : {},