@domino-sdk/relay 1.66.1 → 1.68.0

package/dist/{wallet-B7e06v4m.d.ts → wallet-DQtJelQQ.d.ts}

@@ -32,6 +32,59 @@ declare const profileDefaultsSchema: z.ZodArray<z.ZodEnum<{
     x: "x";
 }>>;
 type ProfileDefaults = z.infer<typeof profileDefaultsSchema>;
+/**
+ * The sources a project can list as profile defaults: the `profileDefaultProviderSchema` accounts,
+ * and `sol`, the primary `.sol` name of a Solana wallet the member linked. A `.sol` name supplies a
+ * name only, never a picture. Settings answer the full list in `defaultSources`.
+ *
+ * @experimental A minor release can change `.sol` names.
+ */
+declare const knownProfileDefaultSources: readonly ["x", "discord", "sol"];
+/**
+ * A default source this SDK knows.
+ *
+ * @compat open
+ * @experimental A minor release can change `.sol` names.
+ */
+type KnownProfileDefaultSource = (typeof knownProfileDefaultSources)[number];
+/**
+ * A profile default source: one of `knownProfileDefaultSources`, or one a later Relay adds.
+ *
+ * @experimental A minor release can change `.sol` names.
+ */
+type ProfileDefaultSource = KnownProfileDefaultSource | (string & {});
+/**
+ * The default sources a settings change can list, in order, each once.
+ *
+ * @experimental A minor release can change `.sol` names.
+ */
+declare const profileDefaultSourcesSchema: z.ZodArray<z.ZodEnum<{
+    discord: "discord";
+    x: "x";
+    sol: "sol";
+}>>;
+/**
+ * Where a member's chosen name comes from instead of a name they typed: `sol` follows the primary
+ * `.sol` name of a Solana wallet they linked.
+ *
+ * @experimental A minor release can change `.sol` names.
+ */
+declare const profileNameSourceSchema: z.ZodEnum<{
+    sol: "sol";
+}>;
+/**
+ * A name source this SDK knows.
+ *
+ * @compat open
+ * @experimental A minor release can change `.sol` names.
+ */
+type KnownProfileNameSource = z.infer<typeof profileNameSourceSchema>;
+/**
+ * A profile name source, or one a later Relay adds.
+ *
+ * @experimental A minor release can change `.sol` names.
+ */
+type ProfileNameSource = KnownProfileNameSource | (string & {});
 /**
  * The seed of a generated avatar (`defaultAvatar`), the same one `relay.me.get()` returns: an HMAC
  * of the member under the project's secret, so it reveals nothing about the member.
@@ -91,10 +144,15 @@ declare const displayNameSchema: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform
 /**
  * A change to the member's own profile; omitted fields stay. `displayName: null` and
  * `avatar: null` return to the project's defaults (null also removes an uploaded picture).
- * Upload a picture with `relay.profiles.uploadAvatar`.
+ * `nameSource: "sol"` shows the member's `.sol` name (one of `nameOptions`) and keeps following
+ * it; a `displayName`, or `nameSource: null`, stops following it. Upload a picture with
+ * `relay.profiles.uploadAvatar`.
  */
 declare const profileUpdateSchema: z.ZodObject<{
     displayName: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>>;
+    nameSource: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        sol: "sol";
+    }>>>;
     avatar: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
         source: z.ZodLiteral<"account">;
         provider: z.ZodEnum<{
@@ -158,6 +216,11 @@ declare const ownProfileSchema: z.ZodObject<{
         givenName: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         imageUrl: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>>;
+    nameSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    nameOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 /** @compat output */
 type OwnProfile = z.infer<typeof ownProfileSchema>;
@@ -216,6 +279,7 @@ declare const profileSettingsSchema: z.ZodObject<{
         discord: "discord";
         x: "x";
     }>>;
+    defaultSources: z.ZodOptional<z.ZodArray<z.ZodString>>;
     revision: z.ZodNumber;
     actor: z.ZodNullable<z.ZodString>;
     updatedAt: z.ZodNullable<z.ZodNumber>;
@@ -231,6 +295,11 @@ declare const profileSettingsInputSchema: z.ZodObject<{
         discord: "discord";
         x: "x";
     }>>;
+    defaultSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        discord: "discord";
+        x: "x";
+        sol: "sol";
+    }>>>;
     actionId: z.ZodString;
     expectedRevision: z.ZodNumber;
     reason: z.ZodString;
@@ -274,6 +343,7 @@ declare const managedProfileSchema: z.ZodObject<{
         source: z.ZodLiteral<"generated">;
         seed: z.ZodString;
     }, z.core.$strip>], "source">;
+    nameSource: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     avatarChoice: z.ZodEnum<{
         default: "default";
         account: "account";
@@ -330,6 +400,15 @@ declare function cosmosChain(chain: CosmosChain | CosmosNetwork): CosmosChain &
 };
 /** The CAIP-2 ID of Solana mainnet (its genesis hash, truncated to 32 characters). */
 declare const solanaMainnet = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+/** The CAIP-2 ID of Solana devnet (its genesis hash, truncated to 32 characters). */
+declare const solanaDevnet = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+/**
+ * A Solana cluster Relay reads, by CAIP-2 ID: mainnet or devnet. A linked Solana wallet reads on
+ * both, since links are chain-family-wide.
+ */
+type SolanaNetwork = typeof solanaMainnet | typeof solanaDevnet;
+/** Whether `value` is the CAIP-2 ID of a Solana cluster Relay reads ({@link SolanaNetwork}). */
+declare function isSolanaNetwork(value: string): value is SolanaNetwork;
 declare const evmAddressSchema: z.ZodString;
 /** Bech32 with any prefix, in one case. The server checks the checksum and stores lowercase. */
 declare const cosmosAddressSchema: z.ZodString;
@@ -371,6 +450,61 @@ declare const walletSignatureSchema: z.ZodObject<{
     publicKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type WalletSignature = z.infer<typeof walletSignatureSchema>;
+/** An EVM chain's CAIP-2 ID: `eip155:` and the chain ID in decimal, such as `"eip155:8453"` (Base). */
+type EvmChainId = `eip155:${number}`;
+/**
+ * Whether `value` is an EVM CAIP-2 ID in canonical form (no leading zeros, at most 16 digits).
+ * Syntax only: the chains Relay reads balances on are the platform's to list
+ * (`management.walletBalanceChains()`).
+ */
+declare function isEvmChainId(value: string): value is EvmChainId;
+/** {@link isEvmChainId} as a schema. */
+declare const evmChainIdSchema: z.ZodCustom<`eip155:${number}`, `eip155:${number}`>;
+/** The SPL Memo program (v2), whose instruction fails unless every account it lists signed. */
+declare const solanaMemoProgram = "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr";
+/** A Solana transaction signature: base58, 64 bytes. */
+declare const solanaSignatureSchema: z.ZodString;
+/**
+ * What a Solana account that cannot sign messages, such as a Squads vault, puts on chain to prove
+ * it is the member's: a transaction it executes with an SPL Memo instruction carrying `memo` and
+ * listing the account. Not strict: newer servers may add fields.
+ *
+ * @experimental A minor release can change linking by transaction.
+ */
+declare const walletTransactionChallengeSchema: z.ZodObject<{
+    id: z.ZodString;
+    chain: z.ZodEnum<{
+        solana: "solana";
+        eip155: "eip155";
+        cosmos: "cosmos";
+    }>;
+    address: z.ZodString;
+    memo: z.ZodString;
+    memoProgram: z.ZodString;
+    expiresAt: z.ZodNumber;
+}, z.core.$strip>;
+/** @experimental */
+type WalletTransactionChallenge = z.infer<typeof walletTransactionChallengeSchema>;
+/**
+ * The transaction that carries a challenge's memo, for the account it proves.
+ *
+ * @experimental A minor release can change linking by transaction.
+ */
+declare const walletTransactionProofSchema: z.ZodObject<{
+    chain: z.ZodLiteral<"solana">;
+    address: z.ZodString;
+    signature: z.ZodString;
+}, z.core.$strict>;
+/** @experimental */
+type WalletTransactionProof = z.infer<typeof walletTransactionProofSchema>;
+/**
+ * How a wallet proved it is the member's, when not by signing a message.
+ *
+ * @compat open
+ */
+type KnownWalletProofKind = "transaction";
+/** A known proof kind, or one a newer Relay sends. */
+type WalletProofKind = KnownWalletProofKind | (string & {});
 declare const linkedWalletSchema: z.ZodObject<{
     chain: z.ZodEnum<{
         solana: "solana";
@@ -379,6 +513,9 @@ declare const linkedWalletSchema: z.ZodObject<{
     }>;
     network: z.ZodNullable<z.ZodCustom<`cosmos:${string}`, `cosmos:${string}`>>;
     address: z.ZodString;
+    provedOn: z.ZodOptional<z.ZodCustom<`eip155:${number}`, `eip155:${number}`>>;
+    provedBy: z.ZodOptional<z.ZodType<WalletProofKind, unknown, z.core.$ZodTypeInternals<WalletProofKind, unknown>>>;
+    proofTransaction: z.ZodOptional<z.ZodString>;
     verifiedAt: z.ZodNumber;
     revision: z.ZodNumber;
     signIn: z.ZodBoolean;
@@ -405,7 +542,7 @@ type WalletSigner = {
     readonly name?: string;
     /** Connect if needed and return the address to challenge. */
     address(): Promise<string>;
-    /** EVM only: the wallet's current chain, shown in the message's Chain ID line. */
+    /** EVM only: the wallet's current chain, in the message's Chain ID line. A smart-contract wallet's signature is checked on it. */
     chainId?(): Promise<number>;
     /** Sign the exact UTF-8 message and return the encoding `walletSignatureSchema` documents. */
     sign(message: string, address: string): Promise<{
@@ -450,25 +587,29 @@ declare const walletSignInNetworksSchema: z.ZodPipe<z.ZodArray<z.ZodEnum<{
 /** The sign-in setting a wallet account falls under: its chain family. */
 declare function walletSignInNetwork(wallet: Pick<LinkedWallet, "chain" | "network">): WalletSignInNetwork;
 /**
- * The CAIP-10 account ID of a wallet on one network. Linked Solana and EVM wallets are
- * chain-agnostic, so pass the network you mean; the defaults are Solana mainnet and Ethereum
- * (`eip155:1`). A Cosmos wallet always uses the network it was linked on.
+ * Whether a linked wallet is an account on the EVM `chain` (CAIP-2). An EOA's address is one key
+ * on every EVM chain. A smart-contract wallet is the contract on the chain that proved it
+ * (`provedOn`): another chain's contract at the same address can belong to someone else. Relay's
+ * readers and the testing kit decide with this.
  */
-declare function caip10(wallet: Pick<LinkedWallet, "chain" | "network" | "address">, network?: string): string;
-/** An EVM chain's CAIP-2 ID: `eip155:` and the chain ID in decimal, such as `"eip155:8453"` (Base). */
-type EvmChainId = `eip155:${number}`;
+declare function evmWalletOn(wallet: {
+    chain: string;
+    provedOn?: string | null;
+}, chain: string): boolean;
 /**
- * Whether `value` is an EVM CAIP-2 ID in canonical form (no leading zeros, at most 16 digits).
- * Syntax only: the chains Relay reads balances on are the platform's to list
- * (`management.walletBalanceChains()`).
+ * The CAIP-10 account ID of a wallet on one network. Linked Solana wallets and EVM EOAs are
+ * chain-agnostic, so pass the network you mean; the defaults are Solana mainnet and Ethereum
+ * (`eip155:1`). A Cosmos wallet always uses the network it was linked on, and an EVM
+ * smart-contract wallet the network that proved it (`provedOn`).
  */
-declare function isEvmChainId(value: string): value is EvmChainId;
-/** {@link isEvmChainId} as a schema. */
-declare const evmChainIdSchema: z.ZodCustom<`eip155:${number}`, `eip155:${number}`>;
+declare function caip10(wallet: Pick<LinkedWallet, "chain" | "network" | "address"> & Partial<Pick<LinkedWallet, "provedOn">>, network?: string): string;
 /** What `ctx.wallet.balance()` reads. Omit `token` for a Solana or EVM native coin. */
 type WalletBalanceQuery = {
-    /** Solana mainnet: `"solana"` or its CAIP-2 ID. */
-    chain: "solana" | typeof solanaMainnet;
+    /**
+     * A Solana cluster: `"solana"` or {@link solanaMainnet} for mainnet, {@link solanaDevnet} for
+     * devnet.
+     */
+    chain: "solana" | SolanaNetwork;
     /** An SPL or Token-2022 mint address (base58). */
     token?: string;
     /** One of the member's linked Solana wallets; omit to read all of them. */
@@ -527,19 +668,69 @@ declare const walletBalanceSampleSchema: z.ZodObject<{
 type WalletBalanceSample = z.infer<typeof walletBalanceSampleSchema>;
 /** What `wallet.balances()` samples: a `ctx.wallet.balance()` query without an address. */
 type WalletBalanceSourceQuery = WalletBalanceQuery extends infer Query ? Query extends unknown ? Omit<Query, "address"> : never : never;
+
+/**
+ * One finalized, successful Solana transaction of a member's linked wallet that called the
+ * tracker's program, as Relay recorded it for a `wallet.programActivity()` tracker: the record's
+ * `data`. The record's ID is the signature, its author the wallet's CAIP-10 account on the
+ * tracker's cluster, and its `occurredAt` the block time.
+ *
+ * @compat output
+ */
+declare const walletProgramActivitySchema: z.ZodObject<{
+    signature: z.ZodString;
+    slot: z.ZodString;
+    timestamp: z.ZodNumber;
+    signer: z.ZodBoolean;
+    instruction: z.ZodNullable<z.ZodString>;
+    amount: z.ZodNullable<z.ZodString>;
+    delta: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/** One transaction a `wallet.programActivity()` tracker recorded: its records' `data`. */
+type WalletProgramActivity = z.infer<typeof walletProgramActivitySchema>;
+/** What `wallet.programActivity()` records. */
+type WalletProgramActivitySourceQuery = {
+    /**
+     * The cluster: `"solana"` or {@link solanaMainnet} for mainnet (the default), {@link solanaDevnet}
+     * for devnet.
+     */
+    chain?: "solana" | SolanaNetwork;
+    /** The program's address (base58). */
+    program: string;
+    /**
+     * Count only transactions that call this instruction of the program, by the name its IDL
+     * gives it. The program must publish an IDL Relay can read, as for `settings.solanaProgram()`.
+     */
+    instruction?: string;
+    /** Count only transactions that change the wallet's balance of this SPL mint (base58). */
+    mint?: string;
+    /**
+     * With `mint`: count only transactions that move at least this many base units of it in or out of
+     * the wallet, as a decimal integer string.
+     */
+    minAmount?: string;
+    /**
+     * `"wallet"` (the default) counts only transactions the wallet signed. `"any"` also counts ones
+     * someone else signed that name the wallet, such as a transfer into it.
+     */
+    signer?: "wallet" | "any";
+};
 /**
  * An NFT standard `ctx.wallet.nfts()` reads: an ERC-721 or ERC-1155 contract on an EVM chain, or a
- * Metaplex verified collection on Solana mainnet.
+ * Metaplex collection on Solana mainnet or devnet: a Core collection or a Token Metadata verified
+ * collection.
  */
 type NftStandard = "erc721" | "erc1155" | "metaplex";
 /**
  * An NFT collection as a CAIP-19 asset type. On an EVM chain: the chain, the contract's standard
  * and its address, such as `"eip155:1/erc721:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"`; an
  * ERC-1155 collection names one token ID after the contract: `"eip155:8453/erc1155:0x…/1"`. On
- * Solana mainnet: the Metaplex collection NFT's mint, `"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/nft:<mint>"`,
- * which stands for every NFT whose metadata names that collection as verified.
+ * Solana: the cluster and the address of a Metaplex Core collection or of a Token Metadata
+ * collection NFT's mint, such as `"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/nft:<address>"` on
+ * mainnet or `"solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1/nft:<address>"` on devnet, which stands for
+ * every Core asset in that collection and every NFT whose metadata names it as verified.
  */
-type NftCollection = `${EvmChainId}/erc721:0x${string}` | `${EvmChainId}/erc1155:0x${string}/${string}` | `${typeof solanaMainnet}/nft:${string}`;
+type NftCollection = `${EvmChainId}/erc721:0x${string}` | `${EvmChainId}/erc1155:0x${string}/${string}` | `${SolanaNetwork}/nft:${string}`;
 /** The parts of an NFT collection ({@link parseNftCollection}). */
 type NftCollectionParts = {
     chain: EvmChainId;
@@ -547,15 +738,15 @@ type NftCollectionParts = {
     contract: `0x${string}`;
     tokenId: string | null;
 } | {
-    chain: typeof solanaMainnet;
+    chain: SolanaNetwork;
     standard: "metaplex";
-    /** The Metaplex collection NFT's mint (base58). */
+    /** The Core collection's address or the collection NFT's mint (base58). */
     mint: string;
 };
 /**
  * The parts of an NFT collection, or null when `value` is not one: an ERC-721 collection has no
- * token ID, an ERC-1155 one has a token ID that fits in 256 bits, and a Solana collection names a
- * base58 mint. Syntax only: the chains, contracts and mints Relay reads are checked when the
+ * token ID, an ERC-1155 one has a token ID that fits in 256 bits, and a Solana collection names
+ * mainnet or devnet and a base58 mint. Syntax only: the chains, contracts and mints Relay reads are checked when the
  * collection is set.
  */
 declare function parseNftCollection(value: string): NftCollectionParts | null;
@@ -592,6 +783,22 @@ declare const walletNftsSchema: z.ZodObject<{
     observedAt: z.ZodNumber;
 }, z.core.$strict>;
 type WalletNfts = z.infer<typeof walletNftsSchema>;
+
+/**
+ * One wallet's holding as Relay sampled it for a `wallet.nfts()` tracker, the record's `data`. The
+ * record's ID and author are the wallet's CAIP-10 account on the collection's chain, and its
+ * `occurredAt` is when Relay sampled it.
+ *
+ * @compat output
+ */
+declare const walletNftSampleSchema: z.ZodObject<{
+    count: z.ZodString;
+    block: z.ZodString;
+}, z.core.$strip>;
+/** One wallet's sampled NFT holding, the `data` of a `wallet.nfts()` tracker's record. */
+type WalletNftSample = z.infer<typeof walletNftSampleSchema>;
+/** What `wallet.nfts()` samples: a `ctx.wallet.nfts()` query without an address. */
+type WalletNftSourceQuery = Omit<WalletNftsQuery, "address">;
 /** The ABI types a contract call's single return value may have. */
 type ContractCallReturnType = `uint${number}` | `int${number}` | "bool" | "address";
 /** A view or pure function's signature, parsed ({@link parseContractFunction}). */
@@ -816,7 +1023,7 @@ declare const walletEventsSchema: z.ZodObject<{
 }, z.core.$strict>;
 type WalletEvents = z.infer<typeof walletEventsSchema>;
 /**
- * A Solana program address on mainnet, as `settings.solanaProgram()` holds it: base58, 32 bytes,
+ * A Solana program address on mainnet or devnet, as `settings.solanaProgram()` holds it: base58, 32 bytes,
  * such as Jupiter's `"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"`.
  */
 type SolanaProgram = string;
@@ -827,7 +1034,7 @@ type SolanaProgram = string;
  */
 declare function isSolanaProgram(value: string): value is SolanaProgram;
 /**
- * A Solana program's Anchor IDL, legacy or 0.30+, as JSON. Relay checks its instructions when it is
+ * A Solana program's IDL as JSON: Anchor (legacy or 0.30+), Codama or Shank. Relay checks its instructions when it is
  * pasted or fetched.
  */
 declare const anchorIdlSchema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
@@ -837,9 +1044,9 @@ type KnownSolanaIdlSource = "chain" | "pasted";
 /** A known IDL source, or one a newer Relay sends. */
 type SolanaIdlSource = KnownSolanaIdlSource | (string & {});
 /**
- * The Anchor IDL a `settings.solanaProgram()` setting decodes instructions with: fetched from the
- * program's on-chain IDL account when the setting was saved (`"chain"`), or pasted by an operator
- * for a program without one (`"pasted"`).
+ * The IDL a `settings.solanaProgram()` setting decodes instructions with: fetched from the
+ * program's on-chain IDL when the setting was saved (`"chain"`), or pasted by an operator, which
+ * takes precedence over the on-chain one (`"pasted"`).
  */
 declare const solanaProgramIdlSchema: z.ZodObject<{
     program: z.ZodString;
@@ -859,6 +1066,11 @@ declare const maxWalletTransactionLookback: number;
 type WalletTransactionsQuery = {
     /** The program, from a `settings.solanaProgram()` setting: never from member input. */
     program: SolanaProgram;
+    /**
+     * The cluster to read: `"solana"` or {@link solanaMainnet} for mainnet (the default),
+     * {@link solanaDevnet} for devnet.
+     */
+    chain?: "solana" | SolanaNetwork;
     /**
      * The earliest block time read, in epoch milliseconds. At most 30 days before the evaluation
      * ({@link maxWalletTransactionLookback}); an earlier time throws `author-error`.
@@ -919,8 +1131,155 @@ declare const walletTransactionsSchema: z.ZodObject<{
 type WalletTransactions = z.infer<typeof walletTransactionsSchema>;
 /** One transaction `ctx.wallet.transactions()` returns. */
 type WalletTransaction = WalletTransactions["transactions"][number];
-/** One program instruction of a transaction, decoded with the program's Anchor IDL. */
+/** One program instruction of a transaction, decoded with the program's IDL. */
 type WalletInstruction = NonNullable<WalletTransaction["instructions"]>[number];
+/**
+ * Transactions to read as a testing-kit `facts.wallet.transactions` answer
+ * (`management.solana.transactionFixture()`).
+ */
+declare const solanaTransactionFixtureInputSchema: z.ZodObject<{
+    chain: z.ZodDefault<z.ZodEnum<{
+        "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+        "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+    }>>;
+    program: z.ZodString;
+    signatures: z.ZodArray<z.ZodString>;
+    wallet: z.ZodOptional<z.ZodString>;
+    idl: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+}, z.core.$strict>;
+/** What `management.solana.transactionFixture()` reads. */
+type SolanaTransactionFixtureInput = z.input<typeof solanaTransactionFixtureInputSchema>;
+/** The integer types a program-account seed can have, written little-endian as Rust's `to_le_bytes()`. */
+type SolanaSeedInteger = "u8" | "u16" | "u32" | "u64" | "u128" | "i8" | "i16" | "i32" | "i64" | "i128";
+/**
+ * One seed of a program-derived address: `{ wallet: true }` for each linked wallet's address, a
+ * string for its UTF-8 bytes, `{ pubkey }` for an address's 32 bytes, or an integer as
+ * `{ u64: value }` (any {@link SolanaSeedInteger}), its value a safe integer number or a decimal
+ * string. Seeds other than the wallet come from code or settings, never from member input.
+ */
+type SolanaSeed = {
+    wallet: true;
+} | string | {
+    pubkey: string;
+} | {
+    [K in SolanaSeedInteger]: {
+        [P in K]: number | string;
+    };
+}[SolanaSeedInteger];
+/** A program-account seed as the sandbox sends it. Syntax only: Relay checks lengths and ranges. */
+declare const solanaSeedSchema: z.ZodType<SolanaSeed>;
+/** The most seeds a program-derived address takes besides its bump, as Solana allows. */
+declare const maxSolanaSeeds = 15;
+/** What `ctx.wallet.programAccount()` reads. */
+type WalletProgramAccountQuery = {
+    /** The program, from a `settings.solanaProgram()` setting whose IDL Relay stored. */
+    program: SolanaProgram;
+    /** The account type, as the program's IDL names it in `accounts`, such as `"UserStake"`. */
+    account: string;
+    /**
+     * The seeds the program derives each member's account from, in order, such as
+     * `["stake", { wallet: true }]`. `{ wallet: true }` must appear at least once.
+     */
+    seeds: SolanaSeed[];
+    /**
+     * The cluster to read: `"solana"` or {@link solanaMainnet} for mainnet (the default),
+     * {@link solanaDevnet} for devnet.
+     */
+    chain?: "solana" | SolanaNetwork;
+    /** One of the member's linked Solana wallets; omit to read all of them. */
+    address?: string;
+};
+/** @compat open */
+type KnownProgramAccountPointKind = "slot";
+/** What a program-account read's `at` counts: a known kind, or one a newer Relay sends. */
+type ProgramAccountPointKind = KnownProgramAccountPointKind | (string & {});
+/**
+ * One account type of a Solana program, read at the address each of the member's pinned linked
+ * Solana wallets derives, and decoded with the program's IDL.
+ */
+declare const walletProgramAccountSchema: z.ZodObject<{
+    program: z.ZodString;
+    chain: z.ZodString;
+    account: z.ZodString;
+    wallets: z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        pda: z.ZodString;
+        fields: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    }, z.core.$strip>>;
+    at: z.ZodObject<{
+        kind: z.ZodType<ProgramAccountPointKind>;
+        number: z.ZodString;
+    }, z.core.$strip>;
+    observedAt: z.ZodNumber;
+}, z.core.$strip>;
+/** What `ctx.wallet.programAccount()` returns: each linked wallet's account, decoded. */
+type WalletProgramAccount = z.infer<typeof walletProgramAccountSchema>;
+/** What `ctx.wallet.stake()` reads. */
+type WalletStakeQuery = {
+    /**
+     * The cluster to read: `"solana"` or {@link solanaMainnet} for mainnet (the default),
+     * {@link solanaDevnet} for devnet.
+     */
+    chain?: "solana" | SolanaNetwork;
+    /** A validator's vote account (base58); omit to count every validator. */
+    voteAccount?: string;
+    /** One of the member's linked Solana wallets; omit to read all of them. */
+    address?: string;
+};
+/** @compat open */
+type KnownStakePointKind = "slot";
+/** What a stake read's `at` counts: a known kind, or one a newer Relay sends. */
+type StakePointKind = KnownStakePointKind | (string & {});
+/**
+ * The SOL the member's pinned linked Solana wallets delegate through stake accounts they control,
+ * as staker or withdrawer, at one epoch. Amounts are lamports.
+ */
+declare const walletStakeSchema: z.ZodObject<{
+    chain: z.ZodString;
+    voteAccount: z.ZodNullable<z.ZodString>;
+    epoch: z.ZodNumber;
+    total: z.ZodString;
+    activating: z.ZodString;
+    deactivating: z.ZodString;
+    wallets: z.ZodArray<z.ZodObject<{
+        amount: z.ZodString;
+        activating: z.ZodString;
+        deactivating: z.ZodString;
+        address: z.ZodString;
+    }, z.core.$strip>>;
+    voteAccounts: z.ZodArray<z.ZodObject<{
+        amount: z.ZodString;
+        activating: z.ZodString;
+        deactivating: z.ZodString;
+        voteAccount: z.ZodString;
+    }, z.core.$strip>>;
+    at: z.ZodObject<{
+        kind: z.ZodType<StakePointKind>;
+        number: z.ZodString;
+    }, z.core.$strip>;
+    observedAt: z.ZodNumber;
+}, z.core.$strip>;
+/** What `ctx.wallet.stake()` returns: the SOL the member's linked wallets delegate. */
+type WalletStake = z.infer<typeof walletStakeSchema>;
+
+/**
+ * One wallet's stake as Relay sampled it for a `wallet.stake()` tracker, the record's `data`, in
+ * lamports, counted as `ctx.wallet.stake({ address })` counts that wallet's. The record's ID and
+ * author are the wallet's CAIP-10 account on the tracker's cluster, and its `occurredAt` is when
+ * Relay sampled it.
+ *
+ * @compat output
+ */
+declare const walletStakeSampleSchema: z.ZodObject<{
+    amount: z.ZodString;
+    activating: z.ZodString;
+    deactivating: z.ZodString;
+    block: z.ZodString;
+}, z.core.$strip>;
+/** One wallet's sampled stake, the `data` of a `wallet.stake()` tracker's record. */
+type WalletStakeSample = z.infer<typeof walletStakeSampleSchema>;
+/** What `wallet.stake()` samples: a `ctx.wallet.stake()` query without an address. */
+type WalletStakeSourceQuery = Omit<WalletStakeQuery, "address">;
 /**
  * Reads the wallets the member has linked to this project. They are pinned once per attempt, at
  * its first wallet read: later links and unlinks do not change the attempt. Every method resolves
@@ -941,8 +1300,9 @@ interface WalletReader {
     /**
      * How many NFTs of one collection the member's linked wallets of its family hold: an ERC-721
      * contract's `balanceOf(owner)`, one ERC-1155 token ID's `balanceOf(owner, id)`, or on Solana the
-     * NFTs whose Metaplex metadata names the collection as verified, summed and per wallet.
-     * Compressed NFTs and Metaplex Core assets on Solana are not counted. Null when the member has no linked wallet of that family. A malformed collection, a
+     * Metaplex Core assets in the collection or the NFTs whose Metaplex metadata names it as
+     * verified, plus the compressed NFTs (Bubblegum) verified into it, summed and per wallet. Null when the
+     * member has no linked wallet of that family. A malformed collection, a
      * chain Relay does not read and an `address` the member never linked throw `CapabilityError`
      * with code `"author-error"`. Relay supplies it to every evaluation; it is optional only so that
      * test doubles written before it keep compiling.
@@ -997,6 +1357,31 @@ interface WalletReader {
      * evaluation; it is optional only so that test doubles written before it keep compiling.
      */
     transactions?(query: WalletTransactionsQuery): Promise<WalletTransactions | null>;
+    /**
+     * One account type of a program, per linked Solana wallet: derives the program-derived
+     * address from `seeds` with `{ wallet: true }` as each wallet's address, reads every account at
+     * one slot, and decodes its fields with the program's IDL. A wallet whose account does
+     * not exist reads `fields: null`. Use it for state a program keeps per user, such as a stake
+     * account. Null when the member has no linked Solana wallet. A malformed program, a program
+     * whose setting has no IDL, an account type the IDL does not name, seeds that do not fit
+     * (no `{ wallet: true }`, a seed over 32 bytes, an integer out of range), a program that is not
+     * executable on the cluster, an account owned by another program or holding another account
+     * type, and an `address` the member never linked throw `CapabilityError` with code
+     * `"author-error"`. Relay supplies it to every evaluation; it is optional only so that test
+     * doubles written before it keep compiling.
+     */
+    programAccount?(query: WalletProgramAccountQuery): Promise<WalletProgramAccount | null>;
+    /**
+     * The SOL the member's linked Solana wallets delegate through native stake accounts, at one
+     * epoch: every Stake program account where a wallet is the staker or the withdrawer, counted
+     * once. `total` is active stake; stake activating or deactivating this epoch is reported apart,
+     * so a quest can count it or not. Summed, per wallet and per vote account, or only to
+     * `voteAccount`, in lamports. Null when the member has no linked Solana wallet. A malformed vote
+     * account and an `address` the member never linked throw `CapabilityError` with code
+     * `"author-error"`. Relay supplies it to every evaluation; it is optional only so that test
+     * doubles written before it keep compiling.
+     */
+    stake?(query: WalletStakeQuery): Promise<WalletStake | null>;
 }
 
-export { type WalletTransactions as $, type AvatarProvider as A, type ContractFunction as B, type CosmosChain as C, type CosmosDenom as D, type EvmChainId as E, type NftCollectionParts as F, type NftStandard as G, type WalletBalance as H, type WalletBalanceChange as I, type WalletBalanceSample as J, type WalletCall as K, type LinkedWallet as L, type WalletCallArgument as M, type NftCollection as N, type OwnProfile as O, type ProfileAvatar as P, type WalletCallQuery as Q, type WalletDelegations as R, type SolanaIdlSource as S, type WalletDelegationsQuery as T, type WalletEventCondition as U, type WalletEventValue as V, type WalletAddressInput as W, type WalletEvents as X, type WalletEventsQuery as Y, type WalletNfts as Z, type WalletNftsQuery as _, type CosmosNetwork as a, walletDelegationsSchema as a$, type WalletTransactionsQuery as a0, cosmosDenomSchema as a1, cosmosNetworkSchema as a2, isContractCall as a3, isContractEvent as a4, isEvmChainId as a5, isNftCollection as a6, isSolanaProgram as a7, maxWalletEventLogs as a8, maxWalletEventLookback as a9, cosmosChain as aA, displayNameSchema as aB, evmAddressSchema as aC, evmChainIdSchema as aD, linkedWalletSchema as aE, managedProfileSchema as aF, ownProfileSchema as aG, profileAvatarSchema as aH, profileCompletionPageSchema as aI, profileCompletionQuerySchema as aJ, profileCompletionSchema as aK, profileDefaultProviderSchema as aL, profileDefaultsSchema as aM, profileModerationSchema as aN, profileReferralSchema as aO, profileSettingsInputSchema as aP, profileSettingsSchema as aQ, profileSummarySchema as aR, profileVisibilitySchema as aS, solanaAddressSchema as aT, solanaMainnet as aU, solanaProgramIdlSchema as aV, walletAddressInput as aW, walletBalanceSampleSchema as aX, walletBalanceSchema as aY, walletCallSchema as aZ, walletChainSchema as a_, maxWalletTransactionLookback as aa, maxWalletTransactions as ab, parseContractCall as ac, parseContractEvent as ad, parseContractFunction as ae, parseNftCollection as af, profileUpdateSchema as ag, walletAddressInputSchema as ah, walletSignatureSchema as ai, AVATAR_UPLOAD_LIMIT as aj, type AnchorIdl as ak, type KnownSolanaIdlSource as al, type ManagedProfile as am, type ProfileDefaultProvider as an, type ProfileDefaults as ao, type ProfileModeration as ap, type ProfileSettings as aq, type ProfileSettingsInput as ar, type SolanaProgramIdl as as, WALLETS_PER_CHAIN as at, anchorIdlSchema as au, avatarProviderSchema as av, avatarSeedSchema as aw, avatarUploadTypes as ax, caip10 as ay, cosmosAddressSchema as az, type ProfileCompletion as b, walletEventsSchema as b0, walletMessageChallengeSchema as b1, walletNftsSchema as b2, walletSignInFamilies as b3, walletSignInNetwork as b4, walletSignInNetworkSchema as b5, walletSignInNetworksSchema as b6, walletTransactionsSchema as b7, walletUnlinkInputSchema as b8, type ProfileCompletionPage as c, type ProfileCompletionQuery as d, type ProfileReferral as e, type ProfileSummary as f, type ProfileUpdate as g, type ProfileVisibility as h, type WalletChain as i, type WalletMessageChallenge as j, type WalletSignInNetwork as k, type WalletSignature as l, type WalletSigner as m, type WalletUnlinkInput as n, type WalletBalanceQuery as o, type ContractCall as p, type ContractEvent as q, type SolanaProgram as r, type WalletBalanceSourceQuery as s, type WalletTransaction as t, type WalletInstruction as u, type WalletReader as v, type ContractCallParts as w, type ContractCallReturnType as x, type ContractEventInput as y, type ContractEventParts as z };
+export { type WalletBalanceSample as $, type AvatarProvider as A, type WalletProgramActivitySourceQuery as B, type CosmosChain as C, type WalletNftSourceQuery as D, type WalletStakeSourceQuery as E, type WalletTransaction as F, type WalletInstruction as G, type WalletReader as H, type ContractCallParts as I, type ContractCallReturnType as J, type ContractEventInput as K, type LinkedWallet as L, type ContractEventParts as M, type NftCollection as N, type OwnProfile as O, type ProfileAvatar as P, type ContractFunction as Q, type CosmosDenom as R, type SolanaNetwork as S, type EvmChainId as T, type NftCollectionParts as U, type NftStandard as V, type WalletAddressInput as W, type SolanaSeed as X, type SolanaSeedInteger as Y, type WalletBalance as Z, type WalletBalanceChange as _, type CosmosNetwork as a, avatarUploadTypes as a$, type WalletCall as a0, type WalletCallArgument as a1, type WalletCallQuery as a2, type WalletDelegations as a3, type WalletDelegationsQuery as a4, type WalletEventCondition as a5, type WalletEventValue as a6, type WalletEvents as a7, type WalletEventsQuery as a8, type WalletNftSample as a9, walletAddressInputSchema as aA, walletSignatureSchema as aB, walletTransactionProofSchema as aC, evmWalletOn as aD, type ProgramAccountPointKind as aE, type StakePointKind as aF, AVATAR_UPLOAD_LIMIT as aG, type AnchorIdl as aH, type KnownProfileDefaultSource as aI, type KnownProfileNameSource as aJ, type KnownProgramAccountPointKind as aK, type KnownSolanaIdlSource as aL, type KnownStakePointKind as aM, type KnownWalletProofKind as aN, type ManagedProfile as aO, type ProfileDefaultProvider as aP, type ProfileDefaultSource as aQ, type ProfileDefaults as aR, type ProfileModeration as aS, type ProfileSettings as aT, type ProfileSettingsInput as aU, type SolanaProgramIdl as aV, type SolanaTransactionFixtureInput as aW, WALLETS_PER_CHAIN as aX, anchorIdlSchema as aY, avatarProviderSchema as aZ, avatarSeedSchema as a_, type WalletNfts as aa, type WalletNftsQuery as ab, type WalletProgramAccount as ac, type WalletProgramAccountQuery as ad, type WalletProgramActivity as ae, type WalletStake as af, type WalletStakeQuery as ag, type WalletStakeSample as ah, type WalletTransactions as ai, type WalletTransactionsQuery as aj, cosmosDenomSchema as ak, cosmosNetworkSchema as al, isContractCall as am, isContractEvent as an, isEvmChainId as ao, isNftCollection as ap, isSolanaProgram as aq, maxWalletEventLogs as ar, maxWalletEventLookback as as, maxWalletTransactionLookback as at, maxWalletTransactions as au, parseContractCall as av, parseContractEvent as aw, parseContractFunction as ax, parseNftCollection as ay, profileUpdateSchema as az, type ProfileCompletion as b, caip10 as b0, cosmosAddressSchema as b1, cosmosChain as b2, displayNameSchema as b3, evmAddressSchema as b4, evmChainIdSchema as b5, isSolanaNetwork as b6, knownProfileDefaultSources as b7, linkedWalletSchema as b8, managedProfileSchema as b9, walletChainSchema as bA, walletDelegationsSchema as bB, walletEventsSchema as bC, walletMessageChallengeSchema as bD, walletNftsSchema as bE, walletProgramAccountSchema as bF, walletProgramActivitySchema as bG, walletSignInFamilies as bH, walletSignInNetwork as bI, walletSignInNetworkSchema as bJ, walletSignInNetworksSchema as bK, walletStakeSchema as bL, walletTransactionChallengeSchema as bM, walletTransactionsSchema as bN, walletUnlinkInputSchema as bO, maxSolanaSeeds as ba, ownProfileSchema as bb, profileAvatarSchema as bc, profileCompletionPageSchema as bd, profileCompletionQuerySchema as be, profileCompletionSchema as bf, profileDefaultProviderSchema as bg, profileDefaultSourcesSchema as bh, profileDefaultsSchema as bi, profileModerationSchema as bj, profileNameSourceSchema as bk, profileReferralSchema as bl, profileSettingsInputSchema as bm, profileSettingsSchema as bn, profileSummarySchema as bo, profileVisibilitySchema as bp, solanaAddressSchema as bq, solanaMemoProgram as br, solanaProgramIdlSchema as bs, solanaSeedSchema as bt, solanaSignatureSchema as bu, solanaTransactionFixtureInputSchema as bv, walletAddressInput as bw, walletBalanceSampleSchema as bx, walletBalanceSchema as by, walletCallSchema as bz, type ProfileCompletionPage as c, type ProfileCompletionQuery as d, type ProfileNameSource as e, type ProfileReferral as f, type ProfileSummary as g, type ProfileUpdate as h, type ProfileVisibility as i, type WalletChain as j, type WalletMessageChallenge as k, type WalletProofKind as l, type WalletSignInNetwork as m, type WalletSignature as n, type WalletSigner as o, type WalletTransactionChallenge as p, type WalletTransactionProof as q, type WalletUnlinkInput as r, solanaDevnet as s, solanaMainnet as t, type SolanaIdlSource as u, type WalletBalanceQuery as v, type ContractCall as w, type ContractEvent as x, type SolanaProgram as y, type WalletBalanceSourceQuery as z };