@domino-sdk/relay 1.67.0 → 1.68.0

package/dist/telegram.d.ts

@@ -1,15 +1,15 @@
-import { k as RelayRequestOptions, R as RelayClient } from './client-CZPewB9h.js';
+import { k as RelayRequestOptions, R as RelayClient } from './client-BMif22WQ.js';
 import { b as ParticipantSession } from './participant-activity-DXRq4s6K.js';
-import './accounts-C2O8mpB8.js';
+import './accounts-DnpKoJCo.js';
 import 'zod';
-import './tracker-data-BqY-9Vu-.js';
-import './wallet-Btng186v.js';
-import './submission-input-C152xIdn.js';
+import './tracker-data-CAK942sx.js';
+import './wallet-DQtJelQQ.js';
+import './submission-input-CaL8drIh.js';
 import './request-error-D_dUPLwo.js';
-import './reward-deliveries-BOWpMytr.js';
-import './catalog-CbiftcxQ.js';
+import './reward-deliveries-0VvT6LMj.js';
+import './catalog-BLGie8Lh.js';
 import './action-9Xl0StBg.js';
-import './sign-in-providers-BRYVOSlG.js';
+import './sign-in-providers-C5_753DZ.js';
 
 /**
  * A plugin's own sign-in method, such as Telegram's Mini App sign-in: the app passes the vendor's

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-VRZZB7CQ.js";
+import "./chunk-IW46TW3A.js";
 
 // src/plugins/telegram.generated.ts
 function withTelegram(relay) {

package/dist/testing.d.ts

@@ -1,19 +1,19 @@
-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 { de as pointBalanceSchema, bM as discordMemberSchema, bP as discordMessageSchema, d8 as photoResultSchema, aa as TextReviewInput, H as Reward, ae as Decision, P as PointBalance, y as PointLedgerReference, u as PointEntry, o as LeaderboardPage } from './accounts-DnpKoJCo.js';
+import { N as NftCollection, X as SolanaSeed, bl as profileReferralSchema, b8 as linkedWalletSchema, by as walletBalanceSchema, bE as walletNftsSchema, a1 as WalletCallArgument, bz as walletCallSchema, bB as walletDelegationsSchema, a5 as WalletEventCondition, bC as walletEventsSchema, bN as walletTransactionsSchema, bF as walletProgramAccountSchema, bL as walletStakeSchema, S as SolanaNetwork, H as WalletReader } from './wallet-DQtJelQQ.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 { C as xConnectionSchema, G as xProfileSchema, F as xPostSchema, g as ImageReference, u as imageInspectionSchema, q as imageComparisonSchema, x as imageSightingsSchema } from './limits-ByVRQePO.js';
+export { L as Limits, l as limits } from './limits-ByVRQePO.js';
+import { aS as memberIdentitySchema, bo as trackerQuerySchema, bj as trackerPageSchema, bx as trackerSummarySchema, af as TrackerContentQuery, b4 as trackerContentSchema, ab as TrackerAttribution, g as Tracker, h as TrackerData, C as ContentBody, p as TrackerTriggerContext, y as TrackerPage } from './tracker-data-CAK942sx.js';
+import { C as telegramConnectionSchema, y as telegramChatMemberSchema, e as TelegramReader } from './submission-input-CaL8drIh.js';
 import { EvaluationMember } from './authoring.js';
-export { A as AttemptCapture, C as CapturedFact } from './attempt-captures-ClHAoo_n.js';
+export { A as AttemptCapture, C as CapturedFact } from './attempt-captures-DMNFMYFb.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 { B as Badge } from './offers-xcPbYaEv.js';
+import { b as QuestView, q as questExperienceSchema } from './catalog-BLGie8Lh.js';
 import './streaks-0YuipsUQ.js';
-import './dashboards-jGPM3AxF.js';
+import './dashboards-DMk-vL1q.js';
 import './units-CwgsPB_r.js';
 
 /** One project time-zone change: from `effectiveAt` on, days are counted in `timeZone`. */
@@ -275,6 +275,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 +343,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 +424,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 +466,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 +548,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 +727,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>;

package/dist/testing.js

@@ -1,19 +1,19 @@
 import {
   attemptCaptureSchema
-} from "./chunk-RDUSFUXX.js";
+} from "./chunk-75KF633N.js";
 import {
   parseImageResult
-} from "./chunk-RWR2LOPA.js";
+} from "./chunk-EXZVWQOQ.js";
 import {
   isParticipantRoute
-} from "./chunk-U66GUVSG.js";
+} from "./chunk-LZXDYSUH.js";
 import {
   imageRequestSchema,
   xConnectionSchema,
   xPostSchema,
   xProfileSchema,
   xRequestSchema
-} from "./chunk-X3FMVRMM.js";
+} from "./chunk-DDJN2T5A.js";
 import {
   CapabilityError
 } from "./chunk-MWMCQLCG.js";
@@ -22,7 +22,7 @@ import {
   participantActivitySchema,
   participantSessionSchema,
   questExperienceSchema
-} from "./chunk-DSJ46QLB.js";
+} from "./chunk-6UBFSMCM.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-6YTSRWRB.js";
 import {
   RelayErrorCode
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-IW46TW3A.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 } : {},