@solana-name-service/sns-sdk-kit 1.1.0-beta.0 → 1.1.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -25,7 +25,7 @@ const i64Decoder = kit.getI64Decoder();
25
25
  * @param params Tokenized-domain retrieval parameters
26
26
  * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs
27
27
  * @param params.address Address holding the tokenized `.sol` domains
28
- * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, and mint addresses.
28
+ * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, mint addresses, and token account addresses.
29
29
  *
30
30
  * @example
31
31
  * ```ts
@@ -55,10 +55,10 @@ const getSolNftsForAddress = async ({ rpc, address, }) => {
55
55
  dataSlice: { offset: 0, length: TOKEN_ACCOUNT_DATA_LENGTH },
56
56
  })
57
57
  .send();
58
- const candidates = tokenAccounts.flatMap(({ account }) => {
58
+ const candidates = tokenAccounts.flatMap(({ pubkey, account }) => {
59
59
  try {
60
60
  const data = codecs.base64Codec.encode(account.data[0]);
61
- return [{ mint: unpackAccount.unpackAccount(data).mint }];
61
+ return [{ mint: unpackAccount.unpackAccount(data).mint, tokenAccount: pubkey }];
62
62
  }
63
63
  catch {
64
64
  return [];
@@ -70,7 +70,7 @@ const getSolNftsForAddress = async ({ rpc, address, }) => {
70
70
  seeds: [codecs.utf8Codec.encode("group"), codecs.addressCodec.encode(addresses.SOL_SRS_CLASS)],
71
71
  });
72
72
  const metadataSerializer = metadata.getMetadataSerializer();
73
- const solNftCandidates = (await Promise.all(candidates.map(async ({ mint }, index) => {
73
+ const solNftCandidates = (await Promise.all(candidates.map(async ({ mint, tokenAccount }, index) => {
74
74
  const mintAccount = mintAccounts[index];
75
75
  if (!mintAccount.exists) {
76
76
  return [];
@@ -106,7 +106,7 @@ const getSolNftsForAddress = async ({ rpc, address, }) => {
106
106
  ],
107
107
  });
108
108
  return canonicalMint === mint
109
- ? [{ domain: metadata.name, domainAddress, mint }]
109
+ ? [{ domain: metadata.name, domainAddress, mint, tokenAccount }]
110
110
  : [];
111
111
  }
112
112
  catch {
@@ -1 +1 @@
1
- {"version":3,"file":"getSolNftsForAddress.cjs","sources":["../../../src/address/getSolNftsForAddress.ts"],"sourcesContent":["import {\r\n Address,\r\n Base58EncodedBytes,\r\n GetMultipleAccountsApi,\r\n GetProgramAccountsApi,\r\n Rpc,\r\n getI64Decoder,\r\n getProgramDerivedAddress,\r\n} from \"@solana/kit\";\r\n\r\nimport { addressCodec, base58Codec, base64Codec, utf8Codec } from \"../codecs\";\r\nimport {\r\n SOL_SRS_CLASS,\r\n SRS_PROGRAM_ADDRESS,\r\n TOKEN_2022_PROGRAM_ADDRESS,\r\n} from \"../constants/addresses\";\r\nimport {\r\n SRS_ADDRESS_LENGTH,\r\n SRS_OWNER_TYPE_TOKEN,\r\n SRS_RECORD_CLASS_OFFSET,\r\n SRS_RECORD_DISCRIMINATOR,\r\n SRS_RECORD_DISCRIMINATOR_OFFSET,\r\n SRS_RECORD_EXPIRY_OFFSET,\r\n SRS_RECORD_HEADER_LENGTH,\r\n SRS_RECORD_OWNER_OFFSET,\r\n SRS_RECORD_OWNER_TYPE_OFFSET,\r\n} from \"../constants/srs\";\r\nimport { getSolDomainAddress } from \"../domain/getSolDomainAddress\";\r\nimport { getMetadataSerializer } from \"../srs/metadata\";\r\nimport { fetchEncodedAccountsBatched } from \"../utils/fetchEncodedAccountsBatched\";\r\nimport {\r\n getTokenGroupMember,\r\n getTokenMetadataExtension,\r\n unpackAccount,\r\n unpackMint,\r\n} from \"../utils/token2022\";\r\n\r\n/**\r\n * Parameters for retrieving tokenized SRS `.sol` domains.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSolNftsForAddressParams = { rpc, address };\r\n * ```\r\n */\r\nexport interface GetSolNftsForAddressParams {\r\n /** RPC client implementing program-account and multiple-account lookup APIs. */\r\n rpc: Rpc<GetProgramAccountsApi & GetMultipleAccountsApi>;\r\n /** Wallet address holding the tokenized domains. */\r\n address: Address;\r\n}\r\n\r\n/**\r\n * A tokenized `.sol` domain and its associated NFT mint.\r\n *\r\n * @example\r\n * ```ts\r\n * const domain: GetSolNftsForAddressResult = {\r\n * domain: \"example\",\r\n * domainAddress,\r\n * mint,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSolNftsForAddressResult {\r\n /** TLD-trimmed `.sol` domain name. */\r\n domain: string;\r\n /** SRS record address. */\r\n domainAddress: Address;\r\n /** Token-2022 mint address. */\r\n mint: Address;\r\n}\r\n\r\nconst TOKEN_AMOUNT_ONE = base58Codec.decode(\r\n Uint8Array.of(1, 0, 0, 0, 0, 0, 0, 0)\r\n) as string as Base58EncodedBytes;\r\nconst TOKEN_ACCOUNT_DATA_LENGTH = 166;\r\nconst i64Decoder = getI64Decoder();\r\n\r\ntype TokenAccountCandidate = { mint: Address };\r\ntype SolNftCandidate = GetSolNftsForAddressResult;\r\n\r\n/**\r\n * Retrieves non-expired tokenized `.sol` domains held by an address.\r\n *\r\n * Malformed or nonmatching candidates are skipped, while RPC failures\r\n * propagate to the caller.\r\n *\r\n * @param params Tokenized-domain retrieval parameters\r\n * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs\r\n * @param params.address Address holding the tokenized `.sol` domains\r\n * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, and mint addresses.\r\n *\r\n * @example\r\n * ```ts\r\n * const domains = await getSolNftsForAddress({ rpc, address });\r\n * ```\r\n */\r\nexport const getSolNftsForAddress = async ({\r\n rpc,\r\n address,\r\n}: GetSolNftsForAddressParams): Promise<GetSolNftsForAddressResult[]> => {\r\n const tokenAccounts = await rpc\r\n .getProgramAccounts(TOKEN_2022_PROGRAM_ADDRESS, {\r\n encoding: \"base64\",\r\n filters: [\r\n {\r\n memcmp: {\r\n offset: 32n,\r\n bytes: address as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n {\r\n memcmp: {\r\n offset: 64n,\r\n bytes: TOKEN_AMOUNT_ONE,\r\n encoding: \"base58\",\r\n },\r\n },\r\n ],\r\n dataSlice: { offset: 0, length: TOKEN_ACCOUNT_DATA_LENGTH },\r\n })\r\n .send();\r\n\r\n const candidates: TokenAccountCandidate[] = tokenAccounts.flatMap(\r\n ({ account }) => {\r\n try {\r\n const data = base64Codec.encode(account.data[0]);\r\n return [{ mint: unpackAccount(data).mint }];\r\n } catch {\r\n return [];\r\n }\r\n }\r\n );\r\n\r\n const mintAccounts = await fetchEncodedAccountsBatched(\r\n rpc,\r\n candidates.map(({ mint }) => mint)\r\n );\r\n const [solGroup] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [utf8Codec.encode(\"group\"), addressCodec.encode(SOL_SRS_CLASS)],\r\n });\r\n const metadataSerializer = getMetadataSerializer();\r\n\r\n const solNftCandidates: SolNftCandidate[] = (\r\n await Promise.all(\r\n candidates.map(async ({ mint }, index) => {\r\n const mintAccount = mintAccounts[index];\r\n if (!mintAccount.exists) {\r\n return [];\r\n }\r\n\r\n try {\r\n if (mintAccount.programAddress !== TOKEN_2022_PROGRAM_ADDRESS) {\r\n return [];\r\n }\r\n\r\n const mintData = mintAccount.data;\r\n const mintState = unpackMint(mintData);\r\n if (\r\n !mintState.isInitialized ||\r\n mintState.decimals !== 0 ||\r\n mintState.supply !== 1n\r\n ) {\r\n return [];\r\n }\r\n\r\n const member = getTokenGroupMember(mintData);\r\n if (!member || member.mint !== mint || member.group !== solGroup) {\r\n return [];\r\n }\r\n\r\n const metadataExtension = getTokenMetadataExtension(mintData);\r\n if (!metadataExtension) {\r\n return [];\r\n }\r\n const [metadata] = metadataSerializer.deserialize(\r\n metadataExtension.subarray(64)\r\n );\r\n const { domainAddress } = await getSolDomainAddress({\r\n domain: metadata.name,\r\n });\r\n const [canonicalMint] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [\r\n utf8Codec.encode(\"mint\"),\r\n addressCodec.encode(domainAddress),\r\n ],\r\n });\r\n\r\n return canonicalMint === mint\r\n ? [{ domain: metadata.name, domainAddress, mint }]\r\n : [];\r\n } catch {\r\n return [];\r\n }\r\n })\r\n )\r\n ).flat();\r\n\r\n const recordAccounts = await fetchEncodedAccountsBatched(\r\n rpc,\r\n solNftCandidates.map(({ domainAddress }) => domainAddress)\r\n );\r\n const now = BigInt(Math.floor(Date.now() / 1_000));\r\n\r\n return solNftCandidates.filter((candidate, index) => {\r\n const recordAccount = recordAccounts[index];\r\n if (!recordAccount?.exists) {\r\n return false;\r\n }\r\n\r\n try {\r\n const { data } = recordAccount;\r\n // Confirm this is a valid SRS token-owned record for the candidate mint.\r\n if (\r\n recordAccount.programAddress !== SRS_PROGRAM_ADDRESS ||\r\n data.length < SRS_RECORD_HEADER_LENGTH ||\r\n data[SRS_RECORD_DISCRIMINATOR_OFFSET] !== SRS_RECORD_DISCRIMINATOR ||\r\n data[SRS_RECORD_OWNER_TYPE_OFFSET] !== SRS_OWNER_TYPE_TOKEN ||\r\n addressCodec.decode(\r\n data.slice(\r\n SRS_RECORD_CLASS_OFFSET,\r\n SRS_RECORD_CLASS_OFFSET + SRS_ADDRESS_LENGTH\r\n )\r\n ) !== SOL_SRS_CLASS ||\r\n addressCodec.decode(\r\n data.slice(\r\n SRS_RECORD_OWNER_OFFSET,\r\n SRS_RECORD_OWNER_OFFSET + SRS_ADDRESS_LENGTH\r\n )\r\n ) !== candidate.mint\r\n ) {\r\n return false;\r\n }\r\n\r\n const expiry = i64Decoder.decode(\r\n data.slice(SRS_RECORD_EXPIRY_OFFSET, SRS_RECORD_EXPIRY_OFFSET + 8)\r\n );\r\n return expiry === 0n || expiry > now;\r\n } catch {\r\n return false;\r\n }\r\n });\r\n};\r\n"],"names":["base58Codec","getI64Decoder","TOKEN_2022_PROGRAM_ADDRESS","base64Codec","unpackAccount","fetchEncodedAccountsBatched","getProgramDerivedAddress","SRS_PROGRAM_ADDRESS","utf8Codec","addressCodec","SOL_SRS_CLASS","getMetadataSerializer","unpackMint","getTokenGroupMember","getTokenMetadataExtension","getSolDomainAddress","SRS_RECORD_HEADER_LENGTH","SRS_RECORD_DISCRIMINATOR_OFFSET","SRS_RECORD_DISCRIMINATOR","SRS_RECORD_OWNER_TYPE_OFFSET","SRS_OWNER_TYPE_TOKEN","SRS_RECORD_CLASS_OFFSET","SRS_ADDRESS_LENGTH","SRS_RECORD_OWNER_OFFSET","SRS_RECORD_EXPIRY_OFFSET"],"mappings":"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"}
1
+ {"version":3,"file":"getSolNftsForAddress.cjs","sources":["../../../src/address/getSolNftsForAddress.ts"],"sourcesContent":["import {\r\n Address,\r\n Base58EncodedBytes,\r\n GetMultipleAccountsApi,\r\n GetProgramAccountsApi,\r\n Rpc,\r\n getI64Decoder,\r\n getProgramDerivedAddress,\r\n} from \"@solana/kit\";\r\n\r\nimport { addressCodec, base58Codec, base64Codec, utf8Codec } from \"../codecs\";\r\nimport {\r\n SOL_SRS_CLASS,\r\n SRS_PROGRAM_ADDRESS,\r\n TOKEN_2022_PROGRAM_ADDRESS,\r\n} from \"../constants/addresses\";\r\nimport {\r\n SRS_ADDRESS_LENGTH,\r\n SRS_OWNER_TYPE_TOKEN,\r\n SRS_RECORD_CLASS_OFFSET,\r\n SRS_RECORD_DISCRIMINATOR,\r\n SRS_RECORD_DISCRIMINATOR_OFFSET,\r\n SRS_RECORD_EXPIRY_OFFSET,\r\n SRS_RECORD_HEADER_LENGTH,\r\n SRS_RECORD_OWNER_OFFSET,\r\n SRS_RECORD_OWNER_TYPE_OFFSET,\r\n} from \"../constants/srs\";\r\nimport { getSolDomainAddress } from \"../domain/getSolDomainAddress\";\r\nimport { getMetadataSerializer } from \"../srs/metadata\";\r\nimport { fetchEncodedAccountsBatched } from \"../utils/fetchEncodedAccountsBatched\";\r\nimport {\r\n getTokenGroupMember,\r\n getTokenMetadataExtension,\r\n unpackAccount,\r\n unpackMint,\r\n} from \"../utils/token2022\";\r\n\r\n/**\r\n * Parameters for retrieving tokenized SRS `.sol` domains.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSolNftsForAddressParams = { rpc, address };\r\n * ```\r\n */\r\nexport interface GetSolNftsForAddressParams {\r\n /** RPC client implementing program-account and multiple-account lookup APIs. */\r\n rpc: Rpc<GetProgramAccountsApi & GetMultipleAccountsApi>;\r\n /** Wallet address holding the tokenized domains. */\r\n address: Address;\r\n}\r\n\r\n/**\r\n * A tokenized `.sol` domain and its associated NFT mint/token account.\r\n *\r\n * @example\r\n * ```ts\r\n * const domain: GetSolNftsForAddressResult = {\r\n * domain: \"example\",\r\n * domainAddress,\r\n * mint,\r\n * tokenAccount,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSolNftsForAddressResult {\r\n /** TLD-trimmed `.sol` domain name. */\r\n domain: string;\r\n /** SRS record address. */\r\n domainAddress: Address;\r\n /** Token-2022 mint address. */\r\n mint: Address;\r\n /** Token-2022 token account address. */\r\n tokenAccount: Address;\r\n}\r\n\r\nconst TOKEN_AMOUNT_ONE = base58Codec.decode(\r\n Uint8Array.of(1, 0, 0, 0, 0, 0, 0, 0)\r\n) as string as Base58EncodedBytes;\r\nconst TOKEN_ACCOUNT_DATA_LENGTH = 166;\r\nconst i64Decoder = getI64Decoder();\r\n\r\ntype TokenAccountCandidate = { mint: Address; tokenAccount: Address };\r\ntype SolNftCandidate = GetSolNftsForAddressResult;\r\n\r\n/**\r\n * Retrieves non-expired tokenized `.sol` domains held by an address.\r\n *\r\n * Malformed or nonmatching candidates are skipped, while RPC failures\r\n * propagate to the caller.\r\n *\r\n * @param params Tokenized-domain retrieval parameters\r\n * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs\r\n * @param params.address Address holding the tokenized `.sol` domains\r\n * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, mint addresses, and token account addresses.\r\n *\r\n * @example\r\n * ```ts\r\n * const domains = await getSolNftsForAddress({ rpc, address });\r\n * ```\r\n */\r\nexport const getSolNftsForAddress = async ({\r\n rpc,\r\n address,\r\n}: GetSolNftsForAddressParams): Promise<GetSolNftsForAddressResult[]> => {\r\n const tokenAccounts = await rpc\r\n .getProgramAccounts(TOKEN_2022_PROGRAM_ADDRESS, {\r\n encoding: \"base64\",\r\n filters: [\r\n {\r\n memcmp: {\r\n offset: 32n,\r\n bytes: address as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n {\r\n memcmp: {\r\n offset: 64n,\r\n bytes: TOKEN_AMOUNT_ONE,\r\n encoding: \"base58\",\r\n },\r\n },\r\n ],\r\n dataSlice: { offset: 0, length: TOKEN_ACCOUNT_DATA_LENGTH },\r\n })\r\n .send();\r\n\r\n const candidates: TokenAccountCandidate[] = tokenAccounts.flatMap(\r\n ({ pubkey, account }) => {\r\n try {\r\n const data = base64Codec.encode(account.data[0]);\r\n return [{ mint: unpackAccount(data).mint, tokenAccount: pubkey }];\r\n } catch {\r\n return [];\r\n }\r\n }\r\n );\r\n\r\n const mintAccounts = await fetchEncodedAccountsBatched(\r\n rpc,\r\n candidates.map(({ mint }) => mint)\r\n );\r\n const [solGroup] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [utf8Codec.encode(\"group\"), addressCodec.encode(SOL_SRS_CLASS)],\r\n });\r\n const metadataSerializer = getMetadataSerializer();\r\n\r\n const solNftCandidates: SolNftCandidate[] = (\r\n await Promise.all(\r\n candidates.map(async ({ mint, tokenAccount }, index) => {\r\n const mintAccount = mintAccounts[index];\r\n if (!mintAccount.exists) {\r\n return [];\r\n }\r\n\r\n try {\r\n if (mintAccount.programAddress !== TOKEN_2022_PROGRAM_ADDRESS) {\r\n return [];\r\n }\r\n\r\n const mintData = mintAccount.data;\r\n const mintState = unpackMint(mintData);\r\n if (\r\n !mintState.isInitialized ||\r\n mintState.decimals !== 0 ||\r\n mintState.supply !== 1n\r\n ) {\r\n return [];\r\n }\r\n\r\n const member = getTokenGroupMember(mintData);\r\n if (!member || member.mint !== mint || member.group !== solGroup) {\r\n return [];\r\n }\r\n\r\n const metadataExtension = getTokenMetadataExtension(mintData);\r\n if (!metadataExtension) {\r\n return [];\r\n }\r\n const [metadata] = metadataSerializer.deserialize(\r\n metadataExtension.subarray(64)\r\n );\r\n const { domainAddress } = await getSolDomainAddress({\r\n domain: metadata.name,\r\n });\r\n const [canonicalMint] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [\r\n utf8Codec.encode(\"mint\"),\r\n addressCodec.encode(domainAddress),\r\n ],\r\n });\r\n\r\n return canonicalMint === mint\r\n ? [{ domain: metadata.name, domainAddress, mint, tokenAccount }]\r\n : [];\r\n } catch {\r\n return [];\r\n }\r\n })\r\n )\r\n ).flat();\r\n\r\n const recordAccounts = await fetchEncodedAccountsBatched(\r\n rpc,\r\n solNftCandidates.map(({ domainAddress }) => domainAddress)\r\n );\r\n const now = BigInt(Math.floor(Date.now() / 1_000));\r\n\r\n return solNftCandidates.filter((candidate, index) => {\r\n const recordAccount = recordAccounts[index];\r\n if (!recordAccount?.exists) {\r\n return false;\r\n }\r\n\r\n try {\r\n const { data } = recordAccount;\r\n // Confirm this is a valid SRS token-owned record for the candidate mint.\r\n if (\r\n recordAccount.programAddress !== SRS_PROGRAM_ADDRESS ||\r\n data.length < SRS_RECORD_HEADER_LENGTH ||\r\n data[SRS_RECORD_DISCRIMINATOR_OFFSET] !== SRS_RECORD_DISCRIMINATOR ||\r\n data[SRS_RECORD_OWNER_TYPE_OFFSET] !== SRS_OWNER_TYPE_TOKEN ||\r\n addressCodec.decode(\r\n data.slice(\r\n SRS_RECORD_CLASS_OFFSET,\r\n SRS_RECORD_CLASS_OFFSET + SRS_ADDRESS_LENGTH\r\n )\r\n ) !== SOL_SRS_CLASS ||\r\n addressCodec.decode(\r\n data.slice(\r\n SRS_RECORD_OWNER_OFFSET,\r\n SRS_RECORD_OWNER_OFFSET + SRS_ADDRESS_LENGTH\r\n )\r\n ) !== candidate.mint\r\n ) {\r\n return false;\r\n }\r\n\r\n const expiry = i64Decoder.decode(\r\n data.slice(SRS_RECORD_EXPIRY_OFFSET, SRS_RECORD_EXPIRY_OFFSET + 8)\r\n );\r\n return expiry === 0n || expiry > now;\r\n } catch {\r\n return false;\r\n }\r\n });\r\n};\r\n"],"names":["base58Codec","getI64Decoder","TOKEN_2022_PROGRAM_ADDRESS","base64Codec","unpackAccount","fetchEncodedAccountsBatched","getProgramDerivedAddress","SRS_PROGRAM_ADDRESS","utf8Codec","addressCodec","SOL_SRS_CLASS","getMetadataSerializer","unpackMint","getTokenGroupMember","getTokenMetadataExtension","getSolDomainAddress","SRS_RECORD_HEADER_LENGTH","SRS_RECORD_DISCRIMINATOR_OFFSET","SRS_RECORD_DISCRIMINATOR","SRS_RECORD_OWNER_TYPE_OFFSET","SRS_OWNER_TYPE_TOKEN","SRS_RECORD_CLASS_OFFSET","SRS_ADDRESS_LENGTH","SRS_RECORD_OWNER_OFFSET","SRS_RECORD_EXPIRY_OFFSET"],"mappings":"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"}
@@ -57,14 +57,22 @@ const resolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
57
57
  const safeResolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
58
58
  if (domain.endsWith(tld.SOL_TLD)) {
59
59
  const trimmedSolDomain = domain.slice(0, -tld.SOL_TLD.length);
60
- const [srsTarget, snsTarget] = await Promise.all([
60
+ const [solResult, snsResult] = await Promise.allSettled([
61
61
  resolveSol.resolveSol({ rpc, domain: trimmedSolDomain, options }),
62
62
  resolveSns.resolveSns({ rpc, domain: trimmedSolDomain, options }),
63
63
  ]);
64
- if (srsTarget !== snsTarget) {
65
- throw new errors.SnsSolResolutionMismatchError(`SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`);
64
+ if (solResult.status === "rejected") {
65
+ throw solResult.reason;
66
66
  }
67
- return srsTarget;
67
+ if (snsResult.status === "rejected") {
68
+ throw snsResult.reason;
69
+ }
70
+ const solTarget = solResult.value;
71
+ const snsTarget = snsResult.value;
72
+ if (solTarget !== snsTarget) {
73
+ throw new errors.SnsSolResolutionMismatchError(`SRS resolved ${domain} to ${solTarget}, but SNS resolved it to ${snsTarget}`);
74
+ }
75
+ return solTarget;
68
76
  }
69
77
  return resolve({ rpc, domain, options });
70
78
  };
@@ -1 +1 @@
1
- {"version":3,"file":"resolve.cjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\r\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\r\nimport { resolveSns } from \"./resolveSns\";\r\nimport { resolveSol } from \"./resolveSol\";\r\nimport { ResolveParams } from \"./resolveTypes\";\r\n\r\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain to its target address.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The resolved target address.\r\n *\r\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and corresponding SNS targets match.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await resolve({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const resolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n\r\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n const [trimmedDomain, tld] = parseSupportedTld(domain);\r\n if (tld === SNS_TLD) {\r\n return resolveSns({ rpc, domain: trimmedDomain, options });\r\n }\r\n\r\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\r\n};\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\r\n *\r\n * For `.sol` input, both the SRS domain and its corresponding `.sns` domain\r\n * must resolve to the same target; otherwise, {@link Errors.SnsSolResolutionMismatchError} is thrown.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\r\n * @throws\r\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\r\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\r\n * ```\r\n */\r\nexport const safeResolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n const [srsTarget, snsTarget] = await Promise.all([\r\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\r\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\r\n ]);\r\n\r\n if (srsTarget !== snsTarget) {\r\n throw new SnsSolResolutionMismatchError(\r\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\r\n );\r\n }\r\n\r\n return srsTarget;\r\n }\r\n\r\n return resolve({ rpc, domain, options });\r\n};\r\n"],"names":["SOL_TLD","resolveSol","tld","parseSupportedTld","SNS_TLD","resolveSns","UnsupportedTldError","SnsSolResolutionMismatchError"],"mappings":";;;;;;;;;AAUA;;;;;;;;;;;;;;;AAeG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAACA,WAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAACA,WAAO,CAAC,MAAM,CAAC;AAEzD,QAAA,OAAOC,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC/D;IAEA,MAAM,CAAC,aAAa,EAAEC,KAAG,CAAC,GAAGC,qBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAID,KAAG,KAAKE,WAAO,EAAE;AACnB,QAAA,OAAOC,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;IAC5D;AAEA,IAAA,MAAM,IAAIC,0BAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAACN,WAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAACA,WAAO,CAAC,MAAM,CAAC;QACzD,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/CC,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;YACtDI,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AACvD,SAAA,CAAC;AAEF,QAAA,IAAI,SAAS,KAAK,SAAS,EAAE;YAC3B,MAAM,IAAIE,oCAA6B,CACrC,CAAA,aAAA,EAAgB,MAAM,CAAA,IAAA,EAAO,SAAS,CAAA,yBAAA,EAA4B,SAAS,CAAA,CAAE,CAC9E;QACH;AAEA,QAAA,OAAO,SAAS;IAClB;IAEA,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;;"}
1
+ {"version":3,"file":"resolve.cjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\r\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\r\nimport { resolveSns } from \"./resolveSns\";\r\nimport { resolveSol } from \"./resolveSol\";\r\nimport { ResolveParams } from \"./resolveTypes\";\r\n\r\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain to its target address.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The resolved target address.\r\n *\r\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and corresponding SNS targets match.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await resolve({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const resolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n\r\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n const [trimmedDomain, tld] = parseSupportedTld(domain);\r\n if (tld === SNS_TLD) {\r\n return resolveSns({ rpc, domain: trimmedDomain, options });\r\n }\r\n\r\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\r\n};\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\r\n *\r\n * For `.sol` input, both the SRS domain and its corresponding `.sns` domain\r\n * must resolve to the same target; otherwise, {@link Errors.SnsSolResolutionMismatchError} is thrown.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\r\n * @throws\r\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\r\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\r\n * ```\r\n */\r\nexport const safeResolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n const [solResult, snsResult] = await Promise.allSettled([\r\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\r\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\r\n ]);\r\n\r\n if (solResult.status === \"rejected\") {\r\n throw solResult.reason;\r\n }\r\n\r\n if (snsResult.status === \"rejected\") {\r\n throw snsResult.reason;\r\n }\r\n\r\n const solTarget = solResult.value;\r\n const snsTarget = snsResult.value;\r\n\r\n if (solTarget !== snsTarget) {\r\n throw new SnsSolResolutionMismatchError(\r\n `SRS resolved ${domain} to ${solTarget}, but SNS resolved it to ${snsTarget}`\r\n );\r\n }\r\n\r\n return solTarget;\r\n }\r\n\r\n return resolve({ rpc, domain, options });\r\n};\r\n"],"names":["SOL_TLD","resolveSol","tld","parseSupportedTld","SNS_TLD","resolveSns","UnsupportedTldError","SnsSolResolutionMismatchError"],"mappings":";;;;;;;;;AAUA;;;;;;;;;;;;;;;AAeG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAACA,WAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAACA,WAAO,CAAC,MAAM,CAAC;AAEzD,QAAA,OAAOC,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC/D;IAEA,MAAM,CAAC,aAAa,EAAEC,KAAG,CAAC,GAAGC,qBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAID,KAAG,KAAKE,WAAO,EAAE;AACnB,QAAA,OAAOC,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;IAC5D;AAEA,IAAA,MAAM,IAAIC,0BAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAACN,WAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAACA,WAAO,CAAC,MAAM,CAAC;QACzD,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACtDC,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;YACtDI,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AACvD,SAAA,CAAC;AAEF,QAAA,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE;YACnC,MAAM,SAAS,CAAC,MAAM;QACxB;AAEA,QAAA,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE;YACnC,MAAM,SAAS,CAAC,MAAM;QACxB;AAEA,QAAA,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK;AACjC,QAAA,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK;AAEjC,QAAA,IAAI,SAAS,KAAK,SAAS,EAAE;YAC3B,MAAM,IAAIE,oCAA6B,CACrC,CAAA,aAAA,EAAgB,MAAM,CAAA,IAAA,EAAO,SAAS,CAAA,yBAAA,EAA4B,SAAS,CAAA,CAAE,CAC9E;QACH;AAEA,QAAA,OAAO,SAAS;IAClB;IAEA,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;;"}
@@ -21,7 +21,7 @@ const i64Decoder = getI64Decoder();
21
21
  * @param params Tokenized-domain retrieval parameters
22
22
  * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs
23
23
  * @param params.address Address holding the tokenized `.sol` domains
24
- * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, and mint addresses.
24
+ * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, mint addresses, and token account addresses.
25
25
  *
26
26
  * @example
27
27
  * ```ts
@@ -51,10 +51,10 @@ const getSolNftsForAddress = async ({ rpc, address, }) => {
51
51
  dataSlice: { offset: 0, length: TOKEN_ACCOUNT_DATA_LENGTH },
52
52
  })
53
53
  .send();
54
- const candidates = tokenAccounts.flatMap(({ account }) => {
54
+ const candidates = tokenAccounts.flatMap(({ pubkey, account }) => {
55
55
  try {
56
56
  const data = base64Codec.encode(account.data[0]);
57
- return [{ mint: unpackAccount(data).mint }];
57
+ return [{ mint: unpackAccount(data).mint, tokenAccount: pubkey }];
58
58
  }
59
59
  catch {
60
60
  return [];
@@ -66,7 +66,7 @@ const getSolNftsForAddress = async ({ rpc, address, }) => {
66
66
  seeds: [utf8Codec.encode("group"), addressCodec.encode(SOL_SRS_CLASS)],
67
67
  });
68
68
  const metadataSerializer = getMetadataSerializer();
69
- const solNftCandidates = (await Promise.all(candidates.map(async ({ mint }, index) => {
69
+ const solNftCandidates = (await Promise.all(candidates.map(async ({ mint, tokenAccount }, index) => {
70
70
  const mintAccount = mintAccounts[index];
71
71
  if (!mintAccount.exists) {
72
72
  return [];
@@ -102,7 +102,7 @@ const getSolNftsForAddress = async ({ rpc, address, }) => {
102
102
  ],
103
103
  });
104
104
  return canonicalMint === mint
105
- ? [{ domain: metadata.name, domainAddress, mint }]
105
+ ? [{ domain: metadata.name, domainAddress, mint, tokenAccount }]
106
106
  : [];
107
107
  }
108
108
  catch {
@@ -1 +1 @@
1
- {"version":3,"file":"getSolNftsForAddress.mjs","sources":["../../../src/address/getSolNftsForAddress.ts"],"sourcesContent":["import {\r\n Address,\r\n Base58EncodedBytes,\r\n GetMultipleAccountsApi,\r\n GetProgramAccountsApi,\r\n Rpc,\r\n getI64Decoder,\r\n getProgramDerivedAddress,\r\n} from \"@solana/kit\";\r\n\r\nimport { addressCodec, base58Codec, base64Codec, utf8Codec } from \"../codecs\";\r\nimport {\r\n SOL_SRS_CLASS,\r\n SRS_PROGRAM_ADDRESS,\r\n TOKEN_2022_PROGRAM_ADDRESS,\r\n} from \"../constants/addresses\";\r\nimport {\r\n SRS_ADDRESS_LENGTH,\r\n SRS_OWNER_TYPE_TOKEN,\r\n SRS_RECORD_CLASS_OFFSET,\r\n SRS_RECORD_DISCRIMINATOR,\r\n SRS_RECORD_DISCRIMINATOR_OFFSET,\r\n SRS_RECORD_EXPIRY_OFFSET,\r\n SRS_RECORD_HEADER_LENGTH,\r\n SRS_RECORD_OWNER_OFFSET,\r\n SRS_RECORD_OWNER_TYPE_OFFSET,\r\n} from \"../constants/srs\";\r\nimport { getSolDomainAddress } from \"../domain/getSolDomainAddress\";\r\nimport { getMetadataSerializer } from \"../srs/metadata\";\r\nimport { fetchEncodedAccountsBatched } from \"../utils/fetchEncodedAccountsBatched\";\r\nimport {\r\n getTokenGroupMember,\r\n getTokenMetadataExtension,\r\n unpackAccount,\r\n unpackMint,\r\n} from \"../utils/token2022\";\r\n\r\n/**\r\n * Parameters for retrieving tokenized SRS `.sol` domains.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSolNftsForAddressParams = { rpc, address };\r\n * ```\r\n */\r\nexport interface GetSolNftsForAddressParams {\r\n /** RPC client implementing program-account and multiple-account lookup APIs. */\r\n rpc: Rpc<GetProgramAccountsApi & GetMultipleAccountsApi>;\r\n /** Wallet address holding the tokenized domains. */\r\n address: Address;\r\n}\r\n\r\n/**\r\n * A tokenized `.sol` domain and its associated NFT mint.\r\n *\r\n * @example\r\n * ```ts\r\n * const domain: GetSolNftsForAddressResult = {\r\n * domain: \"example\",\r\n * domainAddress,\r\n * mint,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSolNftsForAddressResult {\r\n /** TLD-trimmed `.sol` domain name. */\r\n domain: string;\r\n /** SRS record address. */\r\n domainAddress: Address;\r\n /** Token-2022 mint address. */\r\n mint: Address;\r\n}\r\n\r\nconst TOKEN_AMOUNT_ONE = base58Codec.decode(\r\n Uint8Array.of(1, 0, 0, 0, 0, 0, 0, 0)\r\n) as string as Base58EncodedBytes;\r\nconst TOKEN_ACCOUNT_DATA_LENGTH = 166;\r\nconst i64Decoder = getI64Decoder();\r\n\r\ntype TokenAccountCandidate = { mint: Address };\r\ntype SolNftCandidate = GetSolNftsForAddressResult;\r\n\r\n/**\r\n * Retrieves non-expired tokenized `.sol` domains held by an address.\r\n *\r\n * Malformed or nonmatching candidates are skipped, while RPC failures\r\n * propagate to the caller.\r\n *\r\n * @param params Tokenized-domain retrieval parameters\r\n * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs\r\n * @param params.address Address holding the tokenized `.sol` domains\r\n * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, and mint addresses.\r\n *\r\n * @example\r\n * ```ts\r\n * const domains = await getSolNftsForAddress({ rpc, address });\r\n * ```\r\n */\r\nexport const getSolNftsForAddress = async ({\r\n rpc,\r\n address,\r\n}: GetSolNftsForAddressParams): Promise<GetSolNftsForAddressResult[]> => {\r\n const tokenAccounts = await rpc\r\n .getProgramAccounts(TOKEN_2022_PROGRAM_ADDRESS, {\r\n encoding: \"base64\",\r\n filters: [\r\n {\r\n memcmp: {\r\n offset: 32n,\r\n bytes: address as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n {\r\n memcmp: {\r\n offset: 64n,\r\n bytes: TOKEN_AMOUNT_ONE,\r\n encoding: \"base58\",\r\n },\r\n },\r\n ],\r\n dataSlice: { offset: 0, length: TOKEN_ACCOUNT_DATA_LENGTH },\r\n })\r\n .send();\r\n\r\n const candidates: TokenAccountCandidate[] = tokenAccounts.flatMap(\r\n ({ account }) => {\r\n try {\r\n const data = base64Codec.encode(account.data[0]);\r\n return [{ mint: unpackAccount(data).mint }];\r\n } catch {\r\n return [];\r\n }\r\n }\r\n );\r\n\r\n const mintAccounts = await fetchEncodedAccountsBatched(\r\n rpc,\r\n candidates.map(({ mint }) => mint)\r\n );\r\n const [solGroup] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [utf8Codec.encode(\"group\"), addressCodec.encode(SOL_SRS_CLASS)],\r\n });\r\n const metadataSerializer = getMetadataSerializer();\r\n\r\n const solNftCandidates: SolNftCandidate[] = (\r\n await Promise.all(\r\n candidates.map(async ({ mint }, index) => {\r\n const mintAccount = mintAccounts[index];\r\n if (!mintAccount.exists) {\r\n return [];\r\n }\r\n\r\n try {\r\n if (mintAccount.programAddress !== TOKEN_2022_PROGRAM_ADDRESS) {\r\n return [];\r\n }\r\n\r\n const mintData = mintAccount.data;\r\n const mintState = unpackMint(mintData);\r\n if (\r\n !mintState.isInitialized ||\r\n mintState.decimals !== 0 ||\r\n mintState.supply !== 1n\r\n ) {\r\n return [];\r\n }\r\n\r\n const member = getTokenGroupMember(mintData);\r\n if (!member || member.mint !== mint || member.group !== solGroup) {\r\n return [];\r\n }\r\n\r\n const metadataExtension = getTokenMetadataExtension(mintData);\r\n if (!metadataExtension) {\r\n return [];\r\n }\r\n const [metadata] = metadataSerializer.deserialize(\r\n metadataExtension.subarray(64)\r\n );\r\n const { domainAddress } = await getSolDomainAddress({\r\n domain: metadata.name,\r\n });\r\n const [canonicalMint] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [\r\n utf8Codec.encode(\"mint\"),\r\n addressCodec.encode(domainAddress),\r\n ],\r\n });\r\n\r\n return canonicalMint === mint\r\n ? [{ domain: metadata.name, domainAddress, mint }]\r\n : [];\r\n } catch {\r\n return [];\r\n }\r\n })\r\n )\r\n ).flat();\r\n\r\n const recordAccounts = await fetchEncodedAccountsBatched(\r\n rpc,\r\n solNftCandidates.map(({ domainAddress }) => domainAddress)\r\n );\r\n const now = BigInt(Math.floor(Date.now() / 1_000));\r\n\r\n return solNftCandidates.filter((candidate, index) => {\r\n const recordAccount = recordAccounts[index];\r\n if (!recordAccount?.exists) {\r\n return false;\r\n }\r\n\r\n try {\r\n const { data } = recordAccount;\r\n // Confirm this is a valid SRS token-owned record for the candidate mint.\r\n if (\r\n recordAccount.programAddress !== SRS_PROGRAM_ADDRESS ||\r\n data.length < SRS_RECORD_HEADER_LENGTH ||\r\n data[SRS_RECORD_DISCRIMINATOR_OFFSET] !== SRS_RECORD_DISCRIMINATOR ||\r\n data[SRS_RECORD_OWNER_TYPE_OFFSET] !== SRS_OWNER_TYPE_TOKEN ||\r\n addressCodec.decode(\r\n data.slice(\r\n SRS_RECORD_CLASS_OFFSET,\r\n SRS_RECORD_CLASS_OFFSET + SRS_ADDRESS_LENGTH\r\n )\r\n ) !== SOL_SRS_CLASS ||\r\n addressCodec.decode(\r\n data.slice(\r\n SRS_RECORD_OWNER_OFFSET,\r\n SRS_RECORD_OWNER_OFFSET + SRS_ADDRESS_LENGTH\r\n )\r\n ) !== candidate.mint\r\n ) {\r\n return false;\r\n }\r\n\r\n const expiry = i64Decoder.decode(\r\n data.slice(SRS_RECORD_EXPIRY_OFFSET, SRS_RECORD_EXPIRY_OFFSET + 8)\r\n );\r\n return expiry === 0n || expiry > now;\r\n } catch {\r\n return false;\r\n }\r\n });\r\n};\r\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"getSolNftsForAddress.mjs","sources":["../../../src/address/getSolNftsForAddress.ts"],"sourcesContent":["import {\r\n Address,\r\n Base58EncodedBytes,\r\n GetMultipleAccountsApi,\r\n GetProgramAccountsApi,\r\n Rpc,\r\n getI64Decoder,\r\n getProgramDerivedAddress,\r\n} from \"@solana/kit\";\r\n\r\nimport { addressCodec, base58Codec, base64Codec, utf8Codec } from \"../codecs\";\r\nimport {\r\n SOL_SRS_CLASS,\r\n SRS_PROGRAM_ADDRESS,\r\n TOKEN_2022_PROGRAM_ADDRESS,\r\n} from \"../constants/addresses\";\r\nimport {\r\n SRS_ADDRESS_LENGTH,\r\n SRS_OWNER_TYPE_TOKEN,\r\n SRS_RECORD_CLASS_OFFSET,\r\n SRS_RECORD_DISCRIMINATOR,\r\n SRS_RECORD_DISCRIMINATOR_OFFSET,\r\n SRS_RECORD_EXPIRY_OFFSET,\r\n SRS_RECORD_HEADER_LENGTH,\r\n SRS_RECORD_OWNER_OFFSET,\r\n SRS_RECORD_OWNER_TYPE_OFFSET,\r\n} from \"../constants/srs\";\r\nimport { getSolDomainAddress } from \"../domain/getSolDomainAddress\";\r\nimport { getMetadataSerializer } from \"../srs/metadata\";\r\nimport { fetchEncodedAccountsBatched } from \"../utils/fetchEncodedAccountsBatched\";\r\nimport {\r\n getTokenGroupMember,\r\n getTokenMetadataExtension,\r\n unpackAccount,\r\n unpackMint,\r\n} from \"../utils/token2022\";\r\n\r\n/**\r\n * Parameters for retrieving tokenized SRS `.sol` domains.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSolNftsForAddressParams = { rpc, address };\r\n * ```\r\n */\r\nexport interface GetSolNftsForAddressParams {\r\n /** RPC client implementing program-account and multiple-account lookup APIs. */\r\n rpc: Rpc<GetProgramAccountsApi & GetMultipleAccountsApi>;\r\n /** Wallet address holding the tokenized domains. */\r\n address: Address;\r\n}\r\n\r\n/**\r\n * A tokenized `.sol` domain and its associated NFT mint/token account.\r\n *\r\n * @example\r\n * ```ts\r\n * const domain: GetSolNftsForAddressResult = {\r\n * domain: \"example\",\r\n * domainAddress,\r\n * mint,\r\n * tokenAccount,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSolNftsForAddressResult {\r\n /** TLD-trimmed `.sol` domain name. */\r\n domain: string;\r\n /** SRS record address. */\r\n domainAddress: Address;\r\n /** Token-2022 mint address. */\r\n mint: Address;\r\n /** Token-2022 token account address. */\r\n tokenAccount: Address;\r\n}\r\n\r\nconst TOKEN_AMOUNT_ONE = base58Codec.decode(\r\n Uint8Array.of(1, 0, 0, 0, 0, 0, 0, 0)\r\n) as string as Base58EncodedBytes;\r\nconst TOKEN_ACCOUNT_DATA_LENGTH = 166;\r\nconst i64Decoder = getI64Decoder();\r\n\r\ntype TokenAccountCandidate = { mint: Address; tokenAccount: Address };\r\ntype SolNftCandidate = GetSolNftsForAddressResult;\r\n\r\n/**\r\n * Retrieves non-expired tokenized `.sol` domains held by an address.\r\n *\r\n * Malformed or nonmatching candidates are skipped, while RPC failures\r\n * propagate to the caller.\r\n *\r\n * @param params Tokenized-domain retrieval parameters\r\n * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs\r\n * @param params.address Address holding the tokenized `.sol` domains\r\n * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, mint addresses, and token account addresses.\r\n *\r\n * @example\r\n * ```ts\r\n * const domains = await getSolNftsForAddress({ rpc, address });\r\n * ```\r\n */\r\nexport const getSolNftsForAddress = async ({\r\n rpc,\r\n address,\r\n}: GetSolNftsForAddressParams): Promise<GetSolNftsForAddressResult[]> => {\r\n const tokenAccounts = await rpc\r\n .getProgramAccounts(TOKEN_2022_PROGRAM_ADDRESS, {\r\n encoding: \"base64\",\r\n filters: [\r\n {\r\n memcmp: {\r\n offset: 32n,\r\n bytes: address as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n {\r\n memcmp: {\r\n offset: 64n,\r\n bytes: TOKEN_AMOUNT_ONE,\r\n encoding: \"base58\",\r\n },\r\n },\r\n ],\r\n dataSlice: { offset: 0, length: TOKEN_ACCOUNT_DATA_LENGTH },\r\n })\r\n .send();\r\n\r\n const candidates: TokenAccountCandidate[] = tokenAccounts.flatMap(\r\n ({ pubkey, account }) => {\r\n try {\r\n const data = base64Codec.encode(account.data[0]);\r\n return [{ mint: unpackAccount(data).mint, tokenAccount: pubkey }];\r\n } catch {\r\n return [];\r\n }\r\n }\r\n );\r\n\r\n const mintAccounts = await fetchEncodedAccountsBatched(\r\n rpc,\r\n candidates.map(({ mint }) => mint)\r\n );\r\n const [solGroup] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [utf8Codec.encode(\"group\"), addressCodec.encode(SOL_SRS_CLASS)],\r\n });\r\n const metadataSerializer = getMetadataSerializer();\r\n\r\n const solNftCandidates: SolNftCandidate[] = (\r\n await Promise.all(\r\n candidates.map(async ({ mint, tokenAccount }, index) => {\r\n const mintAccount = mintAccounts[index];\r\n if (!mintAccount.exists) {\r\n return [];\r\n }\r\n\r\n try {\r\n if (mintAccount.programAddress !== TOKEN_2022_PROGRAM_ADDRESS) {\r\n return [];\r\n }\r\n\r\n const mintData = mintAccount.data;\r\n const mintState = unpackMint(mintData);\r\n if (\r\n !mintState.isInitialized ||\r\n mintState.decimals !== 0 ||\r\n mintState.supply !== 1n\r\n ) {\r\n return [];\r\n }\r\n\r\n const member = getTokenGroupMember(mintData);\r\n if (!member || member.mint !== mint || member.group !== solGroup) {\r\n return [];\r\n }\r\n\r\n const metadataExtension = getTokenMetadataExtension(mintData);\r\n if (!metadataExtension) {\r\n return [];\r\n }\r\n const [metadata] = metadataSerializer.deserialize(\r\n metadataExtension.subarray(64)\r\n );\r\n const { domainAddress } = await getSolDomainAddress({\r\n domain: metadata.name,\r\n });\r\n const [canonicalMint] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [\r\n utf8Codec.encode(\"mint\"),\r\n addressCodec.encode(domainAddress),\r\n ],\r\n });\r\n\r\n return canonicalMint === mint\r\n ? [{ domain: metadata.name, domainAddress, mint, tokenAccount }]\r\n : [];\r\n } catch {\r\n return [];\r\n }\r\n })\r\n )\r\n ).flat();\r\n\r\n const recordAccounts = await fetchEncodedAccountsBatched(\r\n rpc,\r\n solNftCandidates.map(({ domainAddress }) => domainAddress)\r\n );\r\n const now = BigInt(Math.floor(Date.now() / 1_000));\r\n\r\n return solNftCandidates.filter((candidate, index) => {\r\n const recordAccount = recordAccounts[index];\r\n if (!recordAccount?.exists) {\r\n return false;\r\n }\r\n\r\n try {\r\n const { data } = recordAccount;\r\n // Confirm this is a valid SRS token-owned record for the candidate mint.\r\n if (\r\n recordAccount.programAddress !== SRS_PROGRAM_ADDRESS ||\r\n data.length < SRS_RECORD_HEADER_LENGTH ||\r\n data[SRS_RECORD_DISCRIMINATOR_OFFSET] !== SRS_RECORD_DISCRIMINATOR ||\r\n data[SRS_RECORD_OWNER_TYPE_OFFSET] !== SRS_OWNER_TYPE_TOKEN ||\r\n addressCodec.decode(\r\n data.slice(\r\n SRS_RECORD_CLASS_OFFSET,\r\n SRS_RECORD_CLASS_OFFSET + SRS_ADDRESS_LENGTH\r\n )\r\n ) !== SOL_SRS_CLASS ||\r\n addressCodec.decode(\r\n data.slice(\r\n SRS_RECORD_OWNER_OFFSET,\r\n SRS_RECORD_OWNER_OFFSET + SRS_ADDRESS_LENGTH\r\n )\r\n ) !== candidate.mint\r\n ) {\r\n return false;\r\n }\r\n\r\n const expiry = i64Decoder.decode(\r\n data.slice(SRS_RECORD_EXPIRY_OFFSET, SRS_RECORD_EXPIRY_OFFSET + 8)\r\n );\r\n return expiry === 0n || expiry > now;\r\n } catch {\r\n return false;\r\n }\r\n });\r\n};\r\n"],"names":[],"mappings":"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"}
@@ -53,14 +53,22 @@ const resolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
53
53
  const safeResolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
54
54
  if (domain.endsWith(SOL_TLD)) {
55
55
  const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);
56
- const [srsTarget, snsTarget] = await Promise.all([
56
+ const [solResult, snsResult] = await Promise.allSettled([
57
57
  resolveSol({ rpc, domain: trimmedSolDomain, options }),
58
58
  resolveSns({ rpc, domain: trimmedSolDomain, options }),
59
59
  ]);
60
- if (srsTarget !== snsTarget) {
61
- throw new SnsSolResolutionMismatchError(`SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`);
60
+ if (solResult.status === "rejected") {
61
+ throw solResult.reason;
62
62
  }
63
- return srsTarget;
63
+ if (snsResult.status === "rejected") {
64
+ throw snsResult.reason;
65
+ }
66
+ const solTarget = solResult.value;
67
+ const snsTarget = snsResult.value;
68
+ if (solTarget !== snsTarget) {
69
+ throw new SnsSolResolutionMismatchError(`SRS resolved ${domain} to ${solTarget}, but SNS resolved it to ${snsTarget}`);
70
+ }
71
+ return solTarget;
64
72
  }
65
73
  return resolve({ rpc, domain, options });
66
74
  };
@@ -1 +1 @@
1
- {"version":3,"file":"resolve.mjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\r\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\r\nimport { resolveSns } from \"./resolveSns\";\r\nimport { resolveSol } from \"./resolveSol\";\r\nimport { ResolveParams } from \"./resolveTypes\";\r\n\r\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain to its target address.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The resolved target address.\r\n *\r\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and corresponding SNS targets match.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await resolve({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const resolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n\r\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n const [trimmedDomain, tld] = parseSupportedTld(domain);\r\n if (tld === SNS_TLD) {\r\n return resolveSns({ rpc, domain: trimmedDomain, options });\r\n }\r\n\r\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\r\n};\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\r\n *\r\n * For `.sol` input, both the SRS domain and its corresponding `.sns` domain\r\n * must resolve to the same target; otherwise, {@link Errors.SnsSolResolutionMismatchError} is thrown.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\r\n * @throws\r\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\r\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\r\n * ```\r\n */\r\nexport const safeResolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n const [srsTarget, snsTarget] = await Promise.all([\r\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\r\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\r\n ]);\r\n\r\n if (srsTarget !== snsTarget) {\r\n throw new SnsSolResolutionMismatchError(\r\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\r\n );\r\n }\r\n\r\n return srsTarget;\r\n }\r\n\r\n return resolve({ rpc, domain, options });\r\n};\r\n"],"names":[],"mappings":";;;;;AAUA;;;;;;;;;;;;;;;AAeG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;AAEzD,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC/D;IAEA,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAI,GAAG,KAAK,OAAO,EAAE;AACnB,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;IAC5D;AAEA,IAAA,MAAM,IAAI,mBAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACzD,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/C,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;YACtD,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AACvD,SAAA,CAAC;AAEF,QAAA,IAAI,SAAS,KAAK,SAAS,EAAE;YAC3B,MAAM,IAAI,6BAA6B,CACrC,CAAA,aAAA,EAAgB,MAAM,CAAA,IAAA,EAAO,SAAS,CAAA,yBAAA,EAA4B,SAAS,CAAA,CAAE,CAC9E;QACH;AAEA,QAAA,OAAO,SAAS;IAClB;IAEA,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;"}
1
+ {"version":3,"file":"resolve.mjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\r\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\r\nimport { resolveSns } from \"./resolveSns\";\r\nimport { resolveSol } from \"./resolveSol\";\r\nimport { ResolveParams } from \"./resolveTypes\";\r\n\r\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain to its target address.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The resolved target address.\r\n *\r\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and corresponding SNS targets match.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await resolve({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const resolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n\r\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n const [trimmedDomain, tld] = parseSupportedTld(domain);\r\n if (tld === SNS_TLD) {\r\n return resolveSns({ rpc, domain: trimmedDomain, options });\r\n }\r\n\r\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\r\n};\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\r\n *\r\n * For `.sol` input, both the SRS domain and its corresponding `.sns` domain\r\n * must resolve to the same target; otherwise, {@link Errors.SnsSolResolutionMismatchError} is thrown.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\r\n * @throws\r\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\r\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\r\n * ```\r\n */\r\nexport const safeResolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n const [solResult, snsResult] = await Promise.allSettled([\r\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\r\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\r\n ]);\r\n\r\n if (solResult.status === \"rejected\") {\r\n throw solResult.reason;\r\n }\r\n\r\n if (snsResult.status === \"rejected\") {\r\n throw snsResult.reason;\r\n }\r\n\r\n const solTarget = solResult.value;\r\n const snsTarget = snsResult.value;\r\n\r\n if (solTarget !== snsTarget) {\r\n throw new SnsSolResolutionMismatchError(\r\n `SRS resolved ${domain} to ${solTarget}, but SNS resolved it to ${snsTarget}`\r\n );\r\n }\r\n\r\n return solTarget;\r\n }\r\n\r\n return resolve({ rpc, domain, options });\r\n};\r\n"],"names":[],"mappings":";;;;;AAUA;;;;;;;;;;;;;;;AAeG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;AAEzD,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC/D;IAEA,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAI,GAAG,KAAK,OAAO,EAAE;AACnB,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;IAC5D;AAEA,IAAA,MAAM,IAAI,mBAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACzD,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC;YACtD,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;YACtD,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AACvD,SAAA,CAAC;AAEF,QAAA,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE;YACnC,MAAM,SAAS,CAAC,MAAM;QACxB;AAEA,QAAA,IAAI,SAAS,CAAC,MAAM,KAAK,UAAU,EAAE;YACnC,MAAM,SAAS,CAAC,MAAM;QACxB;AAEA,QAAA,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK;AACjC,QAAA,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK;AAEjC,QAAA,IAAI,SAAS,KAAK,SAAS,EAAE;YAC3B,MAAM,IAAI,6BAA6B,CACrC,CAAA,aAAA,EAAgB,MAAM,CAAA,IAAA,EAAO,SAAS,CAAA,yBAAA,EAA4B,SAAS,CAAA,CAAE,CAC9E;QACH;AAEA,QAAA,OAAO,SAAS;IAClB;IAEA,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;"}
@@ -168,7 +168,7 @@ interface GetSolNftsForAddressParams {
168
168
  address: Address;
169
169
  }
170
170
  /**
171
- * A tokenized `.sol` domain and its associated NFT mint.
171
+ * A tokenized `.sol` domain and its associated NFT mint/token account.
172
172
  *
173
173
  * @example
174
174
  * ```ts
@@ -176,6 +176,7 @@ interface GetSolNftsForAddressParams {
176
176
  * domain: "example",
177
177
  * domainAddress,
178
178
  * mint,
179
+ * tokenAccount,
179
180
  * };
180
181
  * ```
181
182
  */
@@ -186,6 +187,8 @@ interface GetSolNftsForAddressResult {
186
187
  domainAddress: Address;
187
188
  /** Token-2022 mint address. */
188
189
  mint: Address;
190
+ /** Token-2022 token account address. */
191
+ tokenAccount: Address;
189
192
  }
190
193
  /**
191
194
  * Retrieves non-expired tokenized `.sol` domains held by an address.
@@ -196,7 +199,7 @@ interface GetSolNftsForAddressResult {
196
199
  * @param params Tokenized-domain retrieval parameters
197
200
  * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs
198
201
  * @param params.address Address holding the tokenized `.sol` domains
199
- * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, and mint addresses.
202
+ * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, mint addresses, and token account addresses.
200
203
  *
201
204
  * @example
202
205
  * ```ts
@@ -172,7 +172,7 @@ interface GetSolNftsForAddressParams {
172
172
  address: Address;
173
173
  }
174
174
  /**
175
- * A tokenized `.sol` domain and its associated NFT mint.
175
+ * A tokenized `.sol` domain and its associated NFT mint/token account.
176
176
  *
177
177
  * @example
178
178
  * ```ts
@@ -180,6 +180,7 @@ interface GetSolNftsForAddressParams {
180
180
  * domain: "example",
181
181
  * domainAddress,
182
182
  * mint,
183
+ * tokenAccount,
183
184
  * };
184
185
  * ```
185
186
  */
@@ -190,6 +191,8 @@ interface GetSolNftsForAddressResult {
190
191
  domainAddress: Address;
191
192
  /** Token-2022 mint address. */
192
193
  mint: Address;
194
+ /** Token-2022 token account address. */
195
+ tokenAccount: Address;
193
196
  }
194
197
  /**
195
198
  * Retrieves non-expired tokenized `.sol` domains held by an address.
@@ -200,7 +203,7 @@ interface GetSolNftsForAddressResult {
200
203
  * @param params Tokenized-domain retrieval parameters
201
204
  * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs
202
205
  * @param params.address Address holding the tokenized `.sol` domains
203
- * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, and mint addresses.
206
+ * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, mint addresses, and token account addresses.
204
207
  *
205
208
  * @example
206
209
  * ```ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@solana-name-service/sns-sdk-kit",
3
- "version": "1.1.0-beta.0",
3
+ "version": "1.1.0-beta.2",
4
4
  "license": "MIT",
5
5
  "files": [
6
6
  "dist"