@domino-sdk/relay 1.67.0 → 1.68.0

package/dist/{chunk-RDUSFUXX.js → chunk-75KF633N.js}

@@ -2,13 +2,14 @@ import {
   capabilityFailureSchema
 } from "./chunk-MWMCQLCG.js";
 import {
+  attemptActionSchema,
   contentPerformanceSnapshotSchema,
   decisionSchema,
   identifier,
   rewardBundleSchema,
   settingsValuesSchema,
   trackerTriggerContextSchema
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 
 // src/server/attempt-captures.ts
 import * as z from "zod";
@@ -57,6 +58,13 @@ var attemptCaptureSchema = /* @__PURE__ */ (() => z.object({
     member: identifier,
     input: z.record(z.string(), z.json()),
     tracker: trackerTriggerContextSchema.nullable(),
+    /**
+     * The action that started the attempt, `ctx.action`. Absent from captures Relay made before it
+     * recorded actions.
+     *
+     * @experimental A minor release can change quest actions.
+     */
+    action: attemptActionSchema.nullable().optional(),
     eligibleAt: timestamp,
     calendar: z.object({
       segments: z.array(

package/dist/{chunk-Q6KTTVOI.js → chunk-7YSVZA7A.js}

@@ -1,7 +1,7 @@
 import {
   clientIdentity,
   retryAfter
-} from "./chunk-5SBA6X5X.js";
+} from "./chunk-KKHENO57.js";
 
 // src/http-exchange.ts
 var uncertainStatuses = /* @__PURE__ */ (() => /* @__PURE__ */ new Set([500, 502, 504]))();

package/dist/{chunk-BMJHFWVT.js → chunk-CZ7NQ7W7.js}

@@ -1,17 +1,20 @@
 import {
   createRelayClient
-} from "./chunk-Z2Z5DBNW.js";
+} from "./chunk-SD74HD75.js";
 import {
-  base58
-} from "./chunk-UWUS4OOV.js";
+  connectSolanaAccount,
+  noAccount,
+  registeredWallets
+} from "./chunk-VAGGGB6B.js";
 import {
+  base58,
   cosmosChain
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 import {
   RelayErrorCode,
   asRelayError,
   clientError
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-IW46TW3A.js";
 
 // src/wallet-browser.ts
 function injected() {
@@ -27,7 +30,6 @@ function utf8Hex(message) {
   }
   return hex;
 }
-var noAccount = "The wallet didn't share an account. Unlock it and try again.";
 function evmSigner(provider, info = {}) {
   return {
     chain: "eip155",
@@ -128,14 +130,7 @@ function walletStandardSolanaSigner(wallet) {
     chain: "solana",
     name: wallet.name,
     async address() {
-      const { accounts } = await feature("standard:connect").connect();
-      const available = accounts.length ? accounts : wallet.accounts;
-      connected = available.find(
-        (account) => account.chains.some((chain) => chain.startsWith("solana:"))
-      ) ?? available[0];
-      if (!connected) {
-        throw new Error(noAccount);
-      }
+      connected = await connectSolanaAccount(wallet);
       return connected.address;
     },
     async sign(message, address) {
@@ -251,35 +246,7 @@ function discoverSolanaWallets() {
   if (!target) {
     return [];
   }
-  const standard = [];
-  const api = {
-    register(...wallets2) {
-      for (const wallet of wallets2) {
-        if (!standard.includes(wallet)) {
-          standard.push(wallet);
-        }
-      }
-      return () => {
-      };
-    }
-  };
-  const registered = (event) => {
-    const callback = event.detail;
-    if (typeof callback === "function") {
-      try {
-        callback(api);
-      } catch {
-      }
-    }
-  };
-  target.addEventListener("wallet-standard:register-wallet", registered);
-  try {
-    target.dispatchEvent(
-      new CustomEvent("wallet-standard:app-ready", { detail: api })
-    );
-  } finally {
-    target.removeEventListener("wallet-standard:register-wallet", registered);
-  }
+  const standard = registeredWallets(target);
   const wallets = [];
   const seen = /* @__PURE__ */ new Set();
   function add(name, signer, icon) {

package/dist/{chunk-X3FMVRMM.js → chunk-DDJN2T5A.js}

@@ -2,7 +2,7 @@ import {
   identifier,
   responseShape,
   xTweetSchema
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 
 // src/x.ts
 import * as z from "zod";

package/dist/{chunk-KUNPCDN6.js → chunk-DNPDR4Z7.js}

@@ -6,13 +6,13 @@ import {
   imageSightingsSchema,
   imageUploadsSchema,
   publishedImageSchema
-} from "./chunk-X3FMVRMM.js";
+} from "./chunk-DDJN2T5A.js";
 import {
   dashboardArtifactSchema,
   dashboardIssue,
   dashboardPreviewSchema,
   normalizeDashboard
-} from "./chunk-QYC3CZVD.js";
+} from "./chunk-MEUAJIVO.js";
 import {
   authProvidersSchema,
   collectionPassSchema,
@@ -23,7 +23,7 @@ import {
   questOutcomePageSchema,
   questOutcomeSchema,
   rewardDeliveriesSchema
-} from "./chunk-NRMQVK2W.js";
+} from "./chunk-R3MNZKNJ.js";
 import {
   catalogDeploymentSchema,
   collectionViewSchema,
@@ -37,7 +37,7 @@ import {
   questExperienceSchema,
   questTypeVersionSchema,
   questViewSchema
-} from "./chunk-DSJ46QLB.js";
+} from "./chunk-6UBFSMCM.js";
 import {
   engagementArtifactSchema,
   engagementBoundaryPageSchema,
@@ -52,7 +52,7 @@ import {
   referralDefinitionSchema,
   referralHistorySchema,
   referralSummarySchema
-} from "./chunk-5DZNMLDM.js";
+} from "./chunk-55WJVFWC.js";
 import {
   accountConnectionSchema,
   attemptSchema,
@@ -114,10 +114,13 @@ import {
   walletEventsSchema,
   walletMessageChallengeSchema,
   walletNftsSchema,
+  walletProgramAccountSchema,
   walletSignInNetworksSchema,
+  walletStakeSchema,
+  walletTransactionChallengeSchema,
   walletTransactionsSchema,
   whereSettings
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 
 // src/deployments.ts
 import * as z from "zod";
@@ -288,7 +291,9 @@ var capabilityResponseTables = /* @__PURE__ */ (() => responseTables({
   walletCallSchema: () => walletCallSchema,
   walletDelegationsSchema: () => walletDelegationsSchema,
   walletEventsSchema: () => walletEventsSchema,
-  walletTransactionsSchema: () => walletTransactionsSchema
+  walletTransactionsSchema: () => walletTransactionsSchema,
+  walletProgramAccountSchema: () => walletProgramAccountSchema,
+  walletStakeSchema: () => walletStakeSchema
 }))();
 var capabilityResponseSchemas = capabilityResponseTables.known;
 var capabilityResponses = capabilityResponseTables.tolerant;
@@ -304,7 +309,8 @@ var activityTypes = {
   reviewPending: "review.pending",
   rewardDeliveryFailed: "reward.delivery.failed",
   entitlementCollected: "entitlement.collected",
-  referralQualified: "referral.qualified"
+  referralQualified: "referral.qualified",
+  walletLinked: "wallet.linked"
 };
 var activityTypeSchema = /* @__PURE__ */ (() => z2.string().min(1).max(100))();
 
@@ -511,7 +517,8 @@ var participantResponseTables = /* @__PURE__ */ (() => responseTables({
   rewardDeliveriesSchema: () => rewardDeliveriesSchema,
   tieredRewardReferenceSchema: () => tieredRewardReferenceSchema,
   walletMessageChallengeSchema: () => walletMessageChallengeSchema,
-  walletSignInNetworksSchema: () => walletSignInNetworksSchema
+  walletSignInNetworksSchema: () => walletSignInNetworksSchema,
+  walletTransactionChallengeSchema: () => walletTransactionChallengeSchema
 }))();
 var participantResponseSchemas = participantResponseTables.known;
 var participantResponses = participantResponseTables.tolerant;

package/dist/{chunk-RWR2LOPA.js → chunk-EXZVWQOQ.js}

@@ -4,10 +4,10 @@ import {
   imageFieldsSchema,
   imageInspectionSchema,
   imageSightingsSchema
-} from "./chunk-X3FMVRMM.js";
+} from "./chunk-DDJN2T5A.js";
 import {
   photoResultSchema
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 
 // src/image-results.ts
 import * as z from "zod";

package/dist/{chunk-MVQQDPQX.js → chunk-HXTKI34N.js}

@@ -3,9 +3,10 @@ import {
   discordMessageTextDataSchema,
   discordReactionDataSchema,
   isKnownTrackerSource,
+  takesSolanaTransaction,
   trackerDataSchema,
   xAccountRoles
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 
 // src/quest-shape.ts
 function validateQuestShape(description, options = {}) {
@@ -16,7 +17,8 @@ function validateQuestShape(description, options = {}) {
     performance,
     retryCooldownMs,
     completionCooldownMs,
-    authorBudgets = []
+    authorBudgets = [],
+    stations
   } = description;
   const tracker = trigger.kind === "automatic" ? trigger.tracker : void 0;
   const content = tracker?.content === true;
@@ -55,6 +57,16 @@ function validateQuestShape(description, options = {}) {
       );
     }
   }
+  if (stations && options.template) {
+    throw new Error(
+      "Reusable quest types cannot declare check-in stations: declare them on a quest written in code"
+    );
+  }
+  if (stations && !takesSolanaTransaction(trigger)) {
+    throw new Error(
+      "Stations are for quests a signed Solana transaction completes: a member-submitted manual() quest without input"
+    );
+  }
   if (trigger.kind === "automatic" && !tracker) {
     if (!options.template && requires.length === 0) {
       throw new Error("Automatic quests need at least one prerequisite");

package/dist/{chunk-FGXLXENM.js → chunk-IW46TW3A.js}

@@ -156,7 +156,27 @@ var RelayErrorCode = {
   /** The wallet sign-in challenge expired, was used or changed; start sign-in again. */
   ChallengeExpired: "challenge-expired",
   /** Too many requests; `retryAfter` says how long to wait when Relay knows. */
-  RateLimited: "rate-limited"
+  RateLimited: "rate-limited",
+  /**
+   * `wallets.linkByTransaction`: the transaction is not finalized yet. Send the same signature
+   * again in a few seconds.
+   *
+   * @experimental A minor release can change linking by transaction.
+   */
+  TransactionNotFinal: "transaction-not-final",
+  /** `wallets.linkByTransaction`: Solana mainnet has no transaction with this signature. @experimental */
+  TransactionNotFound: "transaction-not-found",
+  /** `wallets.linkByTransaction`: the transaction failed, so it proves nothing. @experimental */
+  TransactionFailed: "transaction-failed",
+  /**
+   * `wallets.linkByTransaction`: no memo in the transaction carries one of the member's open
+   * challenges for the address, with the address as signer.
+   *
+   * @experimental A minor release can change linking by transaction.
+   */
+  ProofMismatch: "proof-mismatch",
+  /** `wallets.linkByTransaction`: another transaction already used the challenge. @experimental */
+  ChallengeUsed: "challenge-used"
 };
 var relayErrorBrand = /* @__PURE__ */ (() => /* @__PURE__ */ Symbol.for("@domino-sdk/relay.RelayError"))();
 function isRelayError(value) {

package/dist/{chunk-5SBA6X5X.js → chunk-KKHENO57.js}

@@ -1,10 +1,10 @@
 import {
   isRequestError
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-IW46TW3A.js";
 
 // package.json
 var name = "@domino-sdk/relay";
-var version = "1.67.0";
+var version = "1.68.0";
 
 // src/client-identity.ts
 function clientIdentity() {

package/dist/{chunk-U66GUVSG.js → chunk-LZXDYSUH.js}

@@ -48,6 +48,8 @@ var participantRoutes = [
   { method: "GET", path: "/v1/me/wallets" },
   { method: "POST", path: "/v1/me/wallets/challenge" },
   { method: "POST", path: "/v1/me/wallets/verify" },
+  { method: "POST", path: "/v1/me/wallets/transaction-challenge" },
+  { method: "POST", path: "/v1/me/wallets/link-transaction" },
   { method: "POST", path: "/v1/me/wallets/unlink" },
   // Profiles: the member's own, and the reads keyed by a public profile ID.
   { method: "GET", path: "/v1/me/profile" },

package/dist/{chunk-QYC3CZVD.js → chunk-MEUAJIVO.js}

@@ -3,10 +3,10 @@ import {
   limits,
   resourceHandle,
   responseShape
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 import {
   parseDefinition
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-IW46TW3A.js";
 
 // src/server/analytics.ts
 import * as z from "zod";

package/dist/{chunk-BQXRCJ3N.js → chunk-P4TPW4SY.js}

@@ -2,7 +2,7 @@ import {
   RelayErrorCode,
   clientError,
   isRequestError
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-IW46TW3A.js";
 
 // src/action.ts
 function withActionId(value) {

package/dist/{chunk-NRMQVK2W.js → chunk-R3MNZKNJ.js}

@@ -10,7 +10,7 @@ import {
   skipEnrollmentSchema,
   telegramSignInMethodsSchema,
   walletSignInNetworksSchema
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 
 // src/sign-in-providers.ts
 import * as z from "zod";

package/dist/{chunk-Z2Z5DBNW.js → chunk-SD74HD75.js}

@@ -1,21 +1,21 @@
 import {
   createRelayAction,
   withActionId
-} from "./chunk-BQXRCJ3N.js";
+} from "./chunk-P4TPW4SY.js";
 import {
   setPluginTransport
-} from "./chunk-2HHZV7U3.js";
+} from "./chunk-VRZZB7CQ.js";
 import {
   createHttpExchange,
   untilAborted,
   withQuery
-} from "./chunk-Q6KTTVOI.js";
+} from "./chunk-7YSVZA7A.js";
 import {
   PARTICIPANT_TIMEOUT,
   lifetime,
   retrying,
   validTimeout
-} from "./chunk-5SBA6X5X.js";
+} from "./chunk-KKHENO57.js";
 import {
   authProvidersSchema,
   collectionPassSchema,
@@ -34,7 +34,7 @@ import {
   questOutcomeSchema,
   rewardDeliveriesSchema,
   rewardDeliveryQuerySchema
-} from "./chunk-NRMQVK2W.js";
+} from "./chunk-R3MNZKNJ.js";
 import {
   exchangeResultSchema,
   exchangeSchema,
@@ -44,7 +44,7 @@ import {
   participantSessionSchema,
   questExperienceSchema,
   sessionMember
-} from "./chunk-DSJ46QLB.js";
+} from "./chunk-6UBFSMCM.js";
 import {
   engagementBoundaryPageSchema,
   engagementPageQuerySchema,
@@ -55,7 +55,7 @@ import {
   referralDefinitionSchema,
   referralHistorySchema,
   referralSummarySchema
-} from "./chunk-5DZNMLDM.js";
+} from "./chunk-55WJVFWC.js";
 import {
   AVATAR_UPLOAD_LIMIT,
   accountConnectionSchema,
@@ -110,8 +110,10 @@ import {
   walletAddressInputSchema,
   walletMessageChallengeSchema,
   walletSignatureSchema,
+  walletTransactionChallengeSchema,
+  walletTransactionProofSchema,
   walletUnlinkInputSchema
-} from "./chunk-P33ZAJMS.js";
+} from "./chunk-6YTSRWRB.js";
 import {
   RelayError,
   RelayErrorCode,
@@ -119,7 +121,7 @@ import {
   isRelayError,
   isRequestError,
   parseInput
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-IW46TW3A.js";
 
 // src/legacy-submissions.ts
 import * as z from "zod";
@@ -1820,6 +1822,40 @@ function relayClient(options) {
         replaySafe: unusedChallengeExpires
       }),
       verify: async (value, requestOptions) => linkVerify(value, await bound(requestOptions)),
+      /**
+       * A challenge for linking a Solana account that cannot sign messages, such as a Squads vault:
+       * the account executes a transaction with an SPL Memo instruction that carries `memo` and lists
+       * the account, then `linkByTransaction` submits its signature. The challenge belongs to the
+       * member, not the session, and lasts 7 days, since a multisig approval can take that long. A
+       * repeat for the same address answers the open challenge.
+       *
+       * @experimental A minor release can change linking by transaction.
+       */
+      transactionChallenge: async (value, requestOptions) => request(
+        "/v1/me/wallets/transaction-challenge",
+        walletTransactionChallengeSchema,
+        {
+          json: parseInput(walletAddressInputSchema, value),
+          options: await bound(requestOptions),
+          replaySafe: true
+        }
+      ),
+      /**
+       * Links the account a finalized Solana mainnet transaction proves: it succeeded, and an SPL
+       * Memo instruction in it, top-level or inner, carries an open challenge's `memo` and lists
+       * the account. A transaction that is not final yet is refused with `transaction-not-final`;
+       * try again shortly. Retrying the same signature answers the same wallet.
+       *
+       * @experimental A minor release can change linking by transaction.
+       */
+      linkByTransaction: async (value, requestOptions) => {
+        const proof = parseInput(walletTransactionProofSchema, value);
+        return request("/v1/me/wallets/link-transaction", linkedWalletSchema, {
+          json: proof,
+          options: await bound(requestOptions),
+          operationId: proof.signature
+        });
+      },
       /** The address stays bound to this member: another member still cannot link it. */
       unlink: async (wallet, requestOptions) => request("/v1/me/wallets/unlink", ok, {
         json: parseInput(walletUnlinkInputSchema, {

package/dist/{chunk-JK3XV2CR.js → chunk-TYZFVL73.js}

@@ -1,24 +1,24 @@
-import {
-  base58Bytes
-} from "./chunk-UWUS4OOV.js";
 import {
   createHttpExchange,
   uncertainStatuses
-} from "./chunk-Q6KTTVOI.js";
+} from "./chunk-7YSVZA7A.js";
 import {
   MANAGEMENT_TIMEOUT,
   lifetime,
   retrying,
   validTimeout
-} from "./chunk-5SBA6X5X.js";
+} from "./chunk-KKHENO57.js";
 import {
+  base58Bytes,
   evmAddressSchema,
-  knownResponse
-} from "./chunk-P33ZAJMS.js";
+  knownResponse,
+  solanaDevnet,
+  solanaMainnet
+} from "./chunk-6YTSRWRB.js";
 import {
   RequestError,
   isRequestError
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-IW46TW3A.js";
 
 // src/configuration.ts
 function questConfiguration(release) {
@@ -116,6 +116,45 @@ async function walletSignatureValid(input) {
   }
 }
 
+// src/solana-rpc.ts
+var solanaPublicEndpoints = {
+  [solanaMainnet]: "https://api.mainnet-beta.solana.com",
+  [solanaDevnet]: "https://api.devnet.solana.com"
+};
+async function solanaRpc(url, method, params) {
+  const response = await fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ jsonrpc: "2.0", id: 1, method, params }),
+    signal: AbortSignal.timeout(3e4)
+  });
+  const answer = await response.json();
+  if (answer.error) {
+    throw new Error(answer.error.message ?? JSON.stringify(answer.error));
+  }
+  return answer.result;
+}
+async function confirmedSignature(url, signature, lastValidBlockHeight) {
+  for (; ; ) {
+    const {
+      value: [status]
+    } = await solanaRpc(url, "getSignatureStatuses", [[signature]]);
+    if (status?.err) {
+      return false;
+    }
+    if (status?.confirmationStatus === "confirmed" || status?.confirmationStatus === "finalized") {
+      return true;
+    }
+    const height = await solanaRpc(url, "getBlockHeight", [
+      { commitment: "confirmed" }
+    ]);
+    if (height > lastValidBlockHeight) {
+      return false;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 2e3));
+  }
+}
+
 // src/server/errors.ts
 import * as z from "zod";
 var ManagementErrorCode = {
@@ -403,6 +442,9 @@ export {
   hex,
   canonicalWalletAddress,
   walletSignatureValid,
+  solanaPublicEndpoints,
+  solanaRpc,
+  confirmedSignature,
   ManagementErrorCode,
   managementErrorSchema,
   isManagementError,

package/dist/chunk-VAGGGB6B.js

@@ -0,0 +1,87 @@
+// src/wallet-standard.ts
+var noAccount = "The wallet didn't share an account. Unlock it and try again.";
+function registeredWallets(target) {
+  const standard = [];
+  const api = {
+    register(...wallets) {
+      for (const wallet of wallets) {
+        if (!standard.includes(wallet)) {
+          standard.push(wallet);
+        }
+      }
+      return () => {
+      };
+    }
+  };
+  const registered = (event) => {
+    const callback = event.detail;
+    if (typeof callback === "function") {
+      try {
+        callback(api);
+      } catch {
+      }
+    }
+  };
+  target.addEventListener("wallet-standard:register-wallet", registered);
+  try {
+    target.dispatchEvent(
+      new CustomEvent("wallet-standard:app-ready", { detail: api })
+    );
+  } finally {
+    target.removeEventListener("wallet-standard:register-wallet", registered);
+  }
+  return standard;
+}
+async function connectSolanaAccount(wallet) {
+  const connect = wallet.features["standard:connect"];
+  if (!connect) {
+    throw new Error(`${wallet.name} doesn't support standard:connect.`);
+  }
+  const { accounts } = await connect.connect();
+  const available = accounts.length ? accounts : wallet.accounts;
+  const account = available.find(
+    (candidate) => candidate.chains.some((chain) => chain.startsWith("solana:"))
+  ) ?? available[0];
+  if (!account) {
+    throw new Error(noAccount);
+  }
+  return account;
+}
+
+// src/host-environment.ts
+import * as z from "zod";
+var hostEnvironmentPath = "/__domino/environment";
+var hostEnvironmentSchema = /* @__PURE__ */ (() => z.object({
+  environment: z.enum(["test", "live"]),
+  kind: z.enum(["staging", "preview", "live"])
+}))();
+var pending;
+async function readHostEnvironment() {
+  try {
+    const response = await fetch(hostEnvironmentPath, {
+      headers: { Accept: "application/json" }
+    });
+    if (response.status !== 200) {
+      return null;
+    }
+    const parsed = hostEnvironmentSchema.safeParse(await response.json());
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+function getHostEnvironment() {
+  if (!globalThis.location) {
+    return Promise.resolve(null);
+  }
+  return pending ??= readHostEnvironment();
+}
+
+export {
+  noAccount,
+  registeredWallets,
+  connectSolanaAccount,
+  hostEnvironmentPath,
+  hostEnvironmentSchema,
+  getHostEnvironment
+};

package/dist/{chunk-2HHZV7U3.js → chunk-VRZZB7CQ.js}

@@ -1,7 +1,7 @@
 import {
   RelayErrorCode,
   clientError
-} from "./chunk-FGXLXENM.js";
+} from "./chunk-IW46TW3A.js";
 
 // src/plugin-client.ts
 var transportKey = /* @__PURE__ */ (() => /* @__PURE__ */ Symbol.for("@domino-sdk/relay:plugin-transport"))();