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

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.
package/README.md CHANGED
@@ -287,10 +287,10 @@ Registration is limited to a lowercase top-level `.sns` name. Return shapes diff
287
287
  getSnsDomainsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address }[]>
288
288
  ```
289
289
 
290
- - **`getSnsNftsForAddress`** — returns tokenized SNS domains with reverse data.
290
+ - **`getSnsNftsForAddress`** — returns tokenized SNS domains with reverse data and the token account holding each NFT.
291
291
 
292
292
  ```ts
293
- getSnsNftsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address; mint: Address }[]>
293
+ getSnsNftsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address; mint: Address; tokenAccount: Address }[]>
294
294
  ```
295
295
 
296
296
  - **`getSolDomainsForAddress`** — returns non-expired, directly wallet-owned `.sol` records. Tokenized records are excluded and returned names are TLD-trimmed.
@@ -299,10 +299,10 @@ Registration is limited to a lowercase top-level `.sns` name. Return shapes diff
299
299
  getSolDomainsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address }[]>
300
300
  ```
301
301
 
302
- - **`getSolNftsForAddress`** — returns non-expired Token-2022 tokenized `.sol` records held by an address. Results include the TLD-trimmed name, SRS record address, and mint.
302
+ - **`getSolNftsForAddress`** — returns non-expired Token-2022 tokenized `.sol` records held by an address. Results include the TLD-trimmed name, SRS record address, mint, and token account.
303
303
 
304
304
  ```ts
305
- getSolNftsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address; mint: Address }[]>
305
+ getSolNftsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address; mint: Address; tokenAccount: Address }[]>
306
306
  ```
307
307
 
308
308
  - **`reverseLookup`** — returns one TLD-less reverse name for a domain address.
@@ -16,7 +16,7 @@ const reverseLookupBatch = require('../utils/reverseLookupBatch.cjs');
16
16
  * @param params NFT state retrieval parameters
17
17
  * @param params.rpc RPC client implementing program account lookup
18
18
  * @param params.address Address whose tokenized domain NFT states are retrieved
19
- * @returns Successfully decoded NFT states.
19
+ * @returns Successfully decoded NFT states paired with their token accounts.
20
20
  */
21
21
  const getNftStatesForAddress = async ({ rpc, address, }) => {
22
22
  try {
@@ -42,11 +42,13 @@ const getNftStatesForAddress = async ({ rpc, address, }) => {
42
42
  ],
43
43
  })
44
44
  .send();
45
- const nftStates = await Promise.all(results.map(({ account }) => {
45
+ const nftStates = await Promise.all(results.map(({ pubkey, account }) => {
46
46
  const { mint } = codecs.tokenCodec.decode(codecs.base64Codec.encode(account.data[0]));
47
- return nft.NftState.retrieveFromMint(rpc, mint).catch(() => undefined);
47
+ return nft.NftState.retrieveFromMint(rpc, mint)
48
+ .then((state) => ({ state, tokenAccount: pubkey }))
49
+ .catch(() => undefined);
48
50
  }));
49
- return nftStates.filter((state) => state !== undefined);
51
+ return nftStates.filter((entry) => entry !== undefined);
50
52
  }
51
53
  catch (error) {
52
54
  console.error("Error retrieving NFT records:", error);
@@ -65,7 +67,8 @@ const getNftStatesForAddress = async ({ rpc, address, }) => {
65
67
  * @param params Tokenized domain retrieval parameters
66
68
  * @param params.rpc RPC client implementing multiple-account and program account APIs
67
69
  * @param params.address Address whose SNS domain NFTs are retrieved
68
- * @returns Tokenized domain records with names without a TLD suffix, domain addresses, and mints.
70
+ * @returns Tokenized domain records with TLD-trimmed names, domain addresses,
71
+ * mints, and holding token accounts.
69
72
  *
70
73
  * @example
71
74
  * ```ts
@@ -74,19 +77,23 @@ const getNftStatesForAddress = async ({ rpc, address, }) => {
74
77
  */
75
78
  const getSnsNftsForAddress = async ({ rpc, address, }) => {
76
79
  const nftStates = await getNftStatesForAddress({ rpc, address });
77
- const nftNameAccounts = nftStates.map((state) => state.nameAccount);
80
+ const nftNameAccounts = nftStates.map(({ state }) => state.nameAccount);
78
81
  const domains = await reverseLookupBatch.reverseLookupBatch({
79
82
  rpc,
80
83
  domainAddresses: nftNameAccounts,
81
84
  });
82
85
  return domains
83
- .map((domain, idx) => domain
84
- ? {
86
+ .map((domain, index) => {
87
+ if (!domain)
88
+ return undefined;
89
+ const { state, tokenAccount } = nftStates[index];
90
+ return {
85
91
  domain,
86
- domainAddress: nftStates[idx].nameAccount,
87
- mint: nftStates[idx].nftMint,
88
- }
89
- : undefined)
92
+ domainAddress: state.nameAccount,
93
+ mint: state.nftMint,
94
+ tokenAccount,
95
+ };
96
+ })
90
97
  .filter((e) => e !== undefined);
91
98
  };
92
99
 
@@ -1 +1 @@
1
- {"version":3,"file":"getSnsNftsForAddress.cjs","sources":["../../../src/address/getSnsNftsForAddress.ts"],"sourcesContent":["import {\r\n Address,\r\n Base58EncodedBytes,\r\n GetMultipleAccountsApi,\r\n GetProgramAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { base64Codec, tokenCodec } from \"../codecs\";\r\nimport { TOKEN_PROGRAM_ADDRESS } from \"../constants/addresses\";\r\nimport { NftState } from \"../states/nft\";\r\nimport { reverseLookupBatch } from \"../utils/reverseLookupBatch\";\r\n\r\n/**\r\n * Parameters for retrieving SNS domain NFTs owned by an address.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSnsNftsForAddressParams = { rpc, address };\r\n * ```\r\n */\r\nexport interface GetSnsNftsForAddressParams {\r\n /** RPC client. */\r\n rpc: Rpc<GetMultipleAccountsApi & GetProgramAccountsApi>;\r\n /** Owner address. */\r\n address: Address;\r\n}\r\n\r\n/**\r\n * An SNS domain NFT owned by an address.\r\n *\r\n * @example\r\n * ```ts\r\n * const domain: GetSnsNftsForAddressResult = {\r\n * domain: \"example\",\r\n * domainAddress,\r\n * mint,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSnsNftsForAddressResult {\r\n /** TLD-less domain name. */\r\n domain: string;\r\n /** Domain account address. */\r\n domainAddress: Address;\r\n /** NFT mint address. */\r\n mint: Address;\r\n}\r\n\r\n/**\r\n * Retrieves tokenized SNS domain NFT states for an address.\r\n *\r\n * Failed NFT state lookups are skipped. If token account retrieval fails, an\r\n * empty array is returned.\r\n *\r\n * @param params NFT state retrieval parameters\r\n * @param params.rpc RPC client implementing program account lookup\r\n * @param params.address Address whose tokenized domain NFT states are retrieved\r\n * @returns Successfully decoded NFT states.\r\n */\r\nconst getNftStatesForAddress = async ({\r\n rpc,\r\n address,\r\n}: {\r\n rpc: Rpc<GetProgramAccountsApi>;\r\n address: Address;\r\n}): Promise<NftState[]> => {\r\n try {\r\n const results = await rpc\r\n .getProgramAccounts(TOKEN_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: \"2\" as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n { dataSize: 165n },\r\n ],\r\n })\r\n .send();\r\n\r\n const nftStates = await Promise.all(\r\n results.map(({ account }) => {\r\n const { mint } = tokenCodec.decode(base64Codec.encode(account.data[0]));\r\n return NftState.retrieveFromMint(rpc, mint).catch(() => undefined);\r\n })\r\n );\r\n\r\n return nftStates.filter((state) => state !== undefined);\r\n } catch (error) {\r\n console.error(\"Error retrieving NFT records:\", error);\r\n return [];\r\n }\r\n};\r\n\r\n/**\r\n * Retrieves the SNS domain NFTs owned by a given address.\r\n *\r\n * Returned `domain` values do not include a `.sns` or `.sol` suffix.\r\n * If NFT records cannot be retrieved or decoded, this function returns an empty\r\n * array instead of throwing.\r\n *\r\n * Entries without reverse lookup results are omitted.\r\n *\r\n * @param params Tokenized domain retrieval parameters\r\n * @param params.rpc RPC client implementing multiple-account and program account APIs\r\n * @param params.address Address whose SNS domain NFTs are retrieved\r\n * @returns Tokenized domain records with names without a TLD suffix, domain addresses, and mints.\r\n *\r\n * @example\r\n * ```ts\r\n * const domains = await getSnsNftsForAddress({ rpc, address });\r\n * ```\r\n */\r\nexport const getSnsNftsForAddress = async ({\r\n rpc,\r\n address,\r\n}: GetSnsNftsForAddressParams): Promise<GetSnsNftsForAddressResult[]> => {\r\n const nftStates = await getNftStatesForAddress({ rpc, address });\r\n const nftNameAccounts = nftStates.map((state) => state.nameAccount);\r\n const domains = await reverseLookupBatch({\r\n rpc,\r\n domainAddresses: nftNameAccounts,\r\n });\r\n\r\n return domains\r\n .map((domain, idx) =>\r\n domain\r\n ? {\r\n domain,\r\n domainAddress: nftStates[idx].nameAccount,\r\n mint: nftStates[idx].nftMint,\r\n }\r\n : undefined\r\n )\r\n .filter((e) => e !== undefined);\r\n};\r\n"],"names":["TOKEN_PROGRAM_ADDRESS","tokenCodec","base64Codec","NftState","reverseLookupBatch"],"mappings":";;;;;;;;;AAiDA;;;;;;;;;;AAUG;AACH,MAAM,sBAAsB,GAAG,OAAO,EACpC,GAAG,EACH,OAAO,GAIR,KAAyB;AACxB,IAAA,IAAI;QACF,MAAM,OAAO,GAAG,MAAM;aACnB,kBAAkB,CAACA,+BAAqB,EAAE;AACzC,YAAA,QAAQ,EAAE,QAAQ;AAClB,YAAA,OAAO,EAAE;AACP,gBAAA;AACE,oBAAA,MAAM,EAAE;AACN,wBAAA,MAAM,EAAE,GAAG;AACX,wBAAA,KAAK,EAAE,OAAuC;AAC9C,wBAAA,QAAQ,EAAE,QAAQ;AACnB,qBAAA;AACF,iBAAA;AACD,gBAAA;AACE,oBAAA,MAAM,EAAE;AACN,wBAAA,MAAM,EAAE,GAAG;AACX,wBAAA,KAAK,EAAE,GAAyB;AAChC,wBAAA,QAAQ,EAAE,QAAQ;AACnB,qBAAA;AACF,iBAAA;gBACD,EAAE,QAAQ,EAAE,IAAI,EAAE;AACnB,aAAA;SACF;AACA,aAAA,IAAI,EAAE;AAET,QAAA,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAI;YAC1B,MAAM,EAAE,IAAI,EAAE,GAAGC,iBAAU,CAAC,MAAM,CAACC,kBAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,YAAA,OAAOC,YAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC;QACpE,CAAC,CAAC,CACH;AAED,QAAA,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,KAAK,SAAS,CAAC;IACzD;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC;AACrD,QAAA,OAAO,EAAE;IACX;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;AAkBG;AACI,MAAM,oBAAoB,GAAG,OAAO,EACzC,GAAG,EACH,OAAO,GACoB,KAA2C;IACtE,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAChE,IAAA,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,WAAW,CAAC;AACnE,IAAA,MAAM,OAAO,GAAG,MAAMC,qCAAkB,CAAC;QACvC,GAAG;AACH,QAAA,eAAe,EAAE,eAAe;AACjC,KAAA,CAAC;AAEF,IAAA,OAAO;SACJ,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,KACf;AACE,UAAE;YACE,MAAM;AACN,YAAA,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,WAAW;AACzC,YAAA,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO;AAC7B;UACD,SAAS;SAEd,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AACnC;;"}
1
+ {"version":3,"file":"getSnsNftsForAddress.cjs","sources":["../../../src/address/getSnsNftsForAddress.ts"],"sourcesContent":["import {\n Address,\n Base58EncodedBytes,\n GetMultipleAccountsApi,\n GetProgramAccountsApi,\n Rpc,\n} from \"@solana/kit\";\n\nimport { base64Codec, tokenCodec } from \"../codecs\";\nimport { TOKEN_PROGRAM_ADDRESS } from \"../constants/addresses\";\nimport { NftState } from \"../states/nft\";\nimport { reverseLookupBatch } from \"../utils/reverseLookupBatch\";\n\n/**\n * Parameters for retrieving SNS domain NFTs owned by an address.\n *\n * @example\n * ```ts\n * const params: GetSnsNftsForAddressParams = { rpc, address };\n * ```\n */\nexport interface GetSnsNftsForAddressParams {\n /** RPC client. */\n rpc: Rpc<GetMultipleAccountsApi & GetProgramAccountsApi>;\n /** Owner address. */\n address: Address;\n}\n\n/**\n * An SNS domain NFT owned by an address.\n *\n * @example\n * ```ts\n * const domain: GetSnsNftsForAddressResult = {\n * domain: \"example\",\n * domainAddress,\n * mint,\n * tokenAccount,\n * };\n * ```\n */\nexport interface GetSnsNftsForAddressResult {\n /** TLD-less domain name. */\n domain: string;\n /** Domain account address. */\n domainAddress: Address;\n /** NFT mint address. */\n mint: Address;\n /** SPL Token account that holds the NFT. */\n tokenAccount: Address;\n}\n\n/**\n * Retrieves tokenized SNS domain NFT states for an address.\n *\n * Failed NFT state lookups are skipped. If token account retrieval fails, an\n * empty array is returned.\n *\n * @param params NFT state retrieval parameters\n * @param params.rpc RPC client implementing program account lookup\n * @param params.address Address whose tokenized domain NFT states are retrieved\n * @returns Successfully decoded NFT states paired with their token accounts.\n */\nconst getNftStatesForAddress = async ({\n rpc,\n address,\n}: {\n rpc: Rpc<GetProgramAccountsApi>;\n address: Address;\n}): Promise<{ state: NftState; tokenAccount: Address }[]> => {\n try {\n const results = await rpc\n .getProgramAccounts(TOKEN_PROGRAM_ADDRESS, {\n encoding: \"base64\",\n filters: [\n {\n memcmp: {\n offset: 32n,\n bytes: address as string as Base58EncodedBytes,\n encoding: \"base58\",\n },\n },\n {\n memcmp: {\n offset: 64n,\n bytes: \"2\" as Base58EncodedBytes,\n encoding: \"base58\",\n },\n },\n { dataSize: 165n },\n ],\n })\n .send();\n\n const nftStates = await Promise.all(\n results.map(({ pubkey, account }) => {\n const { mint } = tokenCodec.decode(base64Codec.encode(account.data[0]));\n return NftState.retrieveFromMint(rpc, mint)\n .then((state) => ({ state, tokenAccount: pubkey }))\n .catch(() => undefined);\n })\n );\n\n return nftStates.filter((entry) => entry !== undefined);\n } catch (error) {\n console.error(\"Error retrieving NFT records:\", error);\n return [];\n }\n};\n\n/**\n * Retrieves the SNS domain NFTs owned by a given address.\n *\n * Returned `domain` values do not include a `.sns` or `.sol` suffix.\n * If NFT records cannot be retrieved or decoded, this function returns an empty\n * array instead of throwing.\n *\n * Entries without reverse lookup results are omitted.\n *\n * @param params Tokenized domain retrieval parameters\n * @param params.rpc RPC client implementing multiple-account and program account APIs\n * @param params.address Address whose SNS domain NFTs are retrieved\n * @returns Tokenized domain records with TLD-trimmed names, domain addresses,\n * mints, and holding token accounts.\n *\n * @example\n * ```ts\n * const domains = await getSnsNftsForAddress({ rpc, address });\n * ```\n */\nexport const getSnsNftsForAddress = async ({\n rpc,\n address,\n}: GetSnsNftsForAddressParams): Promise<GetSnsNftsForAddressResult[]> => {\n const nftStates = await getNftStatesForAddress({ rpc, address });\n const nftNameAccounts = nftStates.map(({ state }) => state.nameAccount);\n const domains = await reverseLookupBatch({\n rpc,\n domainAddresses: nftNameAccounts,\n });\n\n return domains\n .map((domain, index) => {\n if (!domain) return undefined;\n\n const { state, tokenAccount } = nftStates[index];\n return {\n domain,\n domainAddress: state.nameAccount,\n mint: state.nftMint,\n tokenAccount,\n };\n })\n .filter((e) => e !== undefined);\n};\n"],"names":["TOKEN_PROGRAM_ADDRESS","tokenCodec","base64Codec","NftState","reverseLookupBatch"],"mappings":";;;;;;;;;AAoDA;;;;;;;;;;AAUG;AACH,MAAM,sBAAsB,GAAG,OAAO,EACpC,GAAG,EACH,OAAO,GAIR,KAA2D;AAC1D,IAAA,IAAI;QACF,MAAM,OAAO,GAAG,MAAM;aACnB,kBAAkB,CAACA,+BAAqB,EAAE;AACzC,YAAA,QAAQ,EAAE,QAAQ;AAClB,YAAA,OAAO,EAAE;AACP,gBAAA;AACE,oBAAA,MAAM,EAAE;AACN,wBAAA,MAAM,EAAE,GAAG;AACX,wBAAA,KAAK,EAAE,OAAuC;AAC9C,wBAAA,QAAQ,EAAE,QAAQ;AACnB,qBAAA;AACF,iBAAA;AACD,gBAAA;AACE,oBAAA,MAAM,EAAE;AACN,wBAAA,MAAM,EAAE,GAAG;AACX,wBAAA,KAAK,EAAE,GAAyB;AAChC,wBAAA,QAAQ,EAAE,QAAQ;AACnB,qBAAA;AACF,iBAAA;gBACD,EAAE,QAAQ,EAAE,IAAI,EAAE;AACnB,aAAA;SACF;AACA,aAAA,IAAI,EAAE;AAET,QAAA,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAI;YAClC,MAAM,EAAE,IAAI,EAAE,GAAGC,iBAAU,CAAC,MAAM,CAACC,kBAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,YAAA,OAAOC,YAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI;AACvC,iBAAA,IAAI,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AACjD,iBAAA,KAAK,CAAC,MAAM,SAAS,CAAC;QAC3B,CAAC,CAAC,CACH;AAED,QAAA,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,KAAK,SAAS,CAAC;IACzD;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC;AACrD,QAAA,OAAO,EAAE;IACX;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;AAmBG;AACI,MAAM,oBAAoB,GAAG,OAAO,EACzC,GAAG,EACH,OAAO,GACoB,KAA2C;IACtE,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAChE,IAAA,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,CAAC,WAAW,CAAC;AACvE,IAAA,MAAM,OAAO,GAAG,MAAMC,qCAAkB,CAAC;QACvC,GAAG;AACH,QAAA,eAAe,EAAE,eAAe;AACjC,KAAA,CAAC;AAEF,IAAA,OAAO;AACJ,SAAA,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,KAAI;AACrB,QAAA,IAAI,CAAC,MAAM;AAAE,YAAA,OAAO,SAAS;QAE7B,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC;QAChD,OAAO;YACL,MAAM;YACN,aAAa,EAAE,KAAK,CAAC,WAAW;YAChC,IAAI,EAAE,KAAK,CAAC,OAAO;YACnB,YAAY;SACb;AACH,IAAA,CAAC;SACA,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AACnC;;"}
@@ -12,7 +12,7 @@ import { reverseLookupBatch } from '../utils/reverseLookupBatch.mjs';
12
12
  * @param params NFT state retrieval parameters
13
13
  * @param params.rpc RPC client implementing program account lookup
14
14
  * @param params.address Address whose tokenized domain NFT states are retrieved
15
- * @returns Successfully decoded NFT states.
15
+ * @returns Successfully decoded NFT states paired with their token accounts.
16
16
  */
17
17
  const getNftStatesForAddress = async ({ rpc, address, }) => {
18
18
  try {
@@ -38,11 +38,13 @@ const getNftStatesForAddress = async ({ rpc, address, }) => {
38
38
  ],
39
39
  })
40
40
  .send();
41
- const nftStates = await Promise.all(results.map(({ account }) => {
41
+ const nftStates = await Promise.all(results.map(({ pubkey, account }) => {
42
42
  const { mint } = tokenCodec.decode(base64Codec.encode(account.data[0]));
43
- return NftState.retrieveFromMint(rpc, mint).catch(() => undefined);
43
+ return NftState.retrieveFromMint(rpc, mint)
44
+ .then((state) => ({ state, tokenAccount: pubkey }))
45
+ .catch(() => undefined);
44
46
  }));
45
- return nftStates.filter((state) => state !== undefined);
47
+ return nftStates.filter((entry) => entry !== undefined);
46
48
  }
47
49
  catch (error) {
48
50
  console.error("Error retrieving NFT records:", error);
@@ -61,7 +63,8 @@ const getNftStatesForAddress = async ({ rpc, address, }) => {
61
63
  * @param params Tokenized domain retrieval parameters
62
64
  * @param params.rpc RPC client implementing multiple-account and program account APIs
63
65
  * @param params.address Address whose SNS domain NFTs are retrieved
64
- * @returns Tokenized domain records with names without a TLD suffix, domain addresses, and mints.
66
+ * @returns Tokenized domain records with TLD-trimmed names, domain addresses,
67
+ * mints, and holding token accounts.
65
68
  *
66
69
  * @example
67
70
  * ```ts
@@ -70,19 +73,23 @@ const getNftStatesForAddress = async ({ rpc, address, }) => {
70
73
  */
71
74
  const getSnsNftsForAddress = async ({ rpc, address, }) => {
72
75
  const nftStates = await getNftStatesForAddress({ rpc, address });
73
- const nftNameAccounts = nftStates.map((state) => state.nameAccount);
76
+ const nftNameAccounts = nftStates.map(({ state }) => state.nameAccount);
74
77
  const domains = await reverseLookupBatch({
75
78
  rpc,
76
79
  domainAddresses: nftNameAccounts,
77
80
  });
78
81
  return domains
79
- .map((domain, idx) => domain
80
- ? {
82
+ .map((domain, index) => {
83
+ if (!domain)
84
+ return undefined;
85
+ const { state, tokenAccount } = nftStates[index];
86
+ return {
81
87
  domain,
82
- domainAddress: nftStates[idx].nameAccount,
83
- mint: nftStates[idx].nftMint,
84
- }
85
- : undefined)
88
+ domainAddress: state.nameAccount,
89
+ mint: state.nftMint,
90
+ tokenAccount,
91
+ };
92
+ })
86
93
  .filter((e) => e !== undefined);
87
94
  };
88
95
 
@@ -1 +1 @@
1
- {"version":3,"file":"getSnsNftsForAddress.mjs","sources":["../../../src/address/getSnsNftsForAddress.ts"],"sourcesContent":["import {\r\n Address,\r\n Base58EncodedBytes,\r\n GetMultipleAccountsApi,\r\n GetProgramAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { base64Codec, tokenCodec } from \"../codecs\";\r\nimport { TOKEN_PROGRAM_ADDRESS } from \"../constants/addresses\";\r\nimport { NftState } from \"../states/nft\";\r\nimport { reverseLookupBatch } from \"../utils/reverseLookupBatch\";\r\n\r\n/**\r\n * Parameters for retrieving SNS domain NFTs owned by an address.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSnsNftsForAddressParams = { rpc, address };\r\n * ```\r\n */\r\nexport interface GetSnsNftsForAddressParams {\r\n /** RPC client. */\r\n rpc: Rpc<GetMultipleAccountsApi & GetProgramAccountsApi>;\r\n /** Owner address. */\r\n address: Address;\r\n}\r\n\r\n/**\r\n * An SNS domain NFT owned by an address.\r\n *\r\n * @example\r\n * ```ts\r\n * const domain: GetSnsNftsForAddressResult = {\r\n * domain: \"example\",\r\n * domainAddress,\r\n * mint,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSnsNftsForAddressResult {\r\n /** TLD-less domain name. */\r\n domain: string;\r\n /** Domain account address. */\r\n domainAddress: Address;\r\n /** NFT mint address. */\r\n mint: Address;\r\n}\r\n\r\n/**\r\n * Retrieves tokenized SNS domain NFT states for an address.\r\n *\r\n * Failed NFT state lookups are skipped. If token account retrieval fails, an\r\n * empty array is returned.\r\n *\r\n * @param params NFT state retrieval parameters\r\n * @param params.rpc RPC client implementing program account lookup\r\n * @param params.address Address whose tokenized domain NFT states are retrieved\r\n * @returns Successfully decoded NFT states.\r\n */\r\nconst getNftStatesForAddress = async ({\r\n rpc,\r\n address,\r\n}: {\r\n rpc: Rpc<GetProgramAccountsApi>;\r\n address: Address;\r\n}): Promise<NftState[]> => {\r\n try {\r\n const results = await rpc\r\n .getProgramAccounts(TOKEN_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: \"2\" as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n { dataSize: 165n },\r\n ],\r\n })\r\n .send();\r\n\r\n const nftStates = await Promise.all(\r\n results.map(({ account }) => {\r\n const { mint } = tokenCodec.decode(base64Codec.encode(account.data[0]));\r\n return NftState.retrieveFromMint(rpc, mint).catch(() => undefined);\r\n })\r\n );\r\n\r\n return nftStates.filter((state) => state !== undefined);\r\n } catch (error) {\r\n console.error(\"Error retrieving NFT records:\", error);\r\n return [];\r\n }\r\n};\r\n\r\n/**\r\n * Retrieves the SNS domain NFTs owned by a given address.\r\n *\r\n * Returned `domain` values do not include a `.sns` or `.sol` suffix.\r\n * If NFT records cannot be retrieved or decoded, this function returns an empty\r\n * array instead of throwing.\r\n *\r\n * Entries without reverse lookup results are omitted.\r\n *\r\n * @param params Tokenized domain retrieval parameters\r\n * @param params.rpc RPC client implementing multiple-account and program account APIs\r\n * @param params.address Address whose SNS domain NFTs are retrieved\r\n * @returns Tokenized domain records with names without a TLD suffix, domain addresses, and mints.\r\n *\r\n * @example\r\n * ```ts\r\n * const domains = await getSnsNftsForAddress({ rpc, address });\r\n * ```\r\n */\r\nexport const getSnsNftsForAddress = async ({\r\n rpc,\r\n address,\r\n}: GetSnsNftsForAddressParams): Promise<GetSnsNftsForAddressResult[]> => {\r\n const nftStates = await getNftStatesForAddress({ rpc, address });\r\n const nftNameAccounts = nftStates.map((state) => state.nameAccount);\r\n const domains = await reverseLookupBatch({\r\n rpc,\r\n domainAddresses: nftNameAccounts,\r\n });\r\n\r\n return domains\r\n .map((domain, idx) =>\r\n domain\r\n ? {\r\n domain,\r\n domainAddress: nftStates[idx].nameAccount,\r\n mint: nftStates[idx].nftMint,\r\n }\r\n : undefined\r\n )\r\n .filter((e) => e !== undefined);\r\n};\r\n"],"names":[],"mappings":";;;;;AAiDA;;;;;;;;;;AAUG;AACH,MAAM,sBAAsB,GAAG,OAAO,EACpC,GAAG,EACH,OAAO,GAIR,KAAyB;AACxB,IAAA,IAAI;QACF,MAAM,OAAO,GAAG,MAAM;aACnB,kBAAkB,CAAC,qBAAqB,EAAE;AACzC,YAAA,QAAQ,EAAE,QAAQ;AAClB,YAAA,OAAO,EAAE;AACP,gBAAA;AACE,oBAAA,MAAM,EAAE;AACN,wBAAA,MAAM,EAAE,GAAG;AACX,wBAAA,KAAK,EAAE,OAAuC;AAC9C,wBAAA,QAAQ,EAAE,QAAQ;AACnB,qBAAA;AACF,iBAAA;AACD,gBAAA;AACE,oBAAA,MAAM,EAAE;AACN,wBAAA,MAAM,EAAE,GAAG;AACX,wBAAA,KAAK,EAAE,GAAyB;AAChC,wBAAA,QAAQ,EAAE,QAAQ;AACnB,qBAAA;AACF,iBAAA;gBACD,EAAE,QAAQ,EAAE,IAAI,EAAE;AACnB,aAAA;SACF;AACA,aAAA,IAAI,EAAE;AAET,QAAA,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAI;YAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,YAAA,OAAO,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC;QACpE,CAAC,CAAC,CACH;AAED,QAAA,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,KAAK,SAAS,CAAC;IACzD;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC;AACrD,QAAA,OAAO,EAAE;IACX;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;AAkBG;AACI,MAAM,oBAAoB,GAAG,OAAO,EACzC,GAAG,EACH,OAAO,GACoB,KAA2C;IACtE,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAChE,IAAA,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,WAAW,CAAC;AACnE,IAAA,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC;QACvC,GAAG;AACH,QAAA,eAAe,EAAE,eAAe;AACjC,KAAA,CAAC;AAEF,IAAA,OAAO;SACJ,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,KACf;AACE,UAAE;YACE,MAAM;AACN,YAAA,aAAa,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,WAAW;AACzC,YAAA,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO;AAC7B;UACD,SAAS;SAEd,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AACnC;;"}
1
+ {"version":3,"file":"getSnsNftsForAddress.mjs","sources":["../../../src/address/getSnsNftsForAddress.ts"],"sourcesContent":["import {\n Address,\n Base58EncodedBytes,\n GetMultipleAccountsApi,\n GetProgramAccountsApi,\n Rpc,\n} from \"@solana/kit\";\n\nimport { base64Codec, tokenCodec } from \"../codecs\";\nimport { TOKEN_PROGRAM_ADDRESS } from \"../constants/addresses\";\nimport { NftState } from \"../states/nft\";\nimport { reverseLookupBatch } from \"../utils/reverseLookupBatch\";\n\n/**\n * Parameters for retrieving SNS domain NFTs owned by an address.\n *\n * @example\n * ```ts\n * const params: GetSnsNftsForAddressParams = { rpc, address };\n * ```\n */\nexport interface GetSnsNftsForAddressParams {\n /** RPC client. */\n rpc: Rpc<GetMultipleAccountsApi & GetProgramAccountsApi>;\n /** Owner address. */\n address: Address;\n}\n\n/**\n * An SNS domain NFT owned by an address.\n *\n * @example\n * ```ts\n * const domain: GetSnsNftsForAddressResult = {\n * domain: \"example\",\n * domainAddress,\n * mint,\n * tokenAccount,\n * };\n * ```\n */\nexport interface GetSnsNftsForAddressResult {\n /** TLD-less domain name. */\n domain: string;\n /** Domain account address. */\n domainAddress: Address;\n /** NFT mint address. */\n mint: Address;\n /** SPL Token account that holds the NFT. */\n tokenAccount: Address;\n}\n\n/**\n * Retrieves tokenized SNS domain NFT states for an address.\n *\n * Failed NFT state lookups are skipped. If token account retrieval fails, an\n * empty array is returned.\n *\n * @param params NFT state retrieval parameters\n * @param params.rpc RPC client implementing program account lookup\n * @param params.address Address whose tokenized domain NFT states are retrieved\n * @returns Successfully decoded NFT states paired with their token accounts.\n */\nconst getNftStatesForAddress = async ({\n rpc,\n address,\n}: {\n rpc: Rpc<GetProgramAccountsApi>;\n address: Address;\n}): Promise<{ state: NftState; tokenAccount: Address }[]> => {\n try {\n const results = await rpc\n .getProgramAccounts(TOKEN_PROGRAM_ADDRESS, {\n encoding: \"base64\",\n filters: [\n {\n memcmp: {\n offset: 32n,\n bytes: address as string as Base58EncodedBytes,\n encoding: \"base58\",\n },\n },\n {\n memcmp: {\n offset: 64n,\n bytes: \"2\" as Base58EncodedBytes,\n encoding: \"base58\",\n },\n },\n { dataSize: 165n },\n ],\n })\n .send();\n\n const nftStates = await Promise.all(\n results.map(({ pubkey, account }) => {\n const { mint } = tokenCodec.decode(base64Codec.encode(account.data[0]));\n return NftState.retrieveFromMint(rpc, mint)\n .then((state) => ({ state, tokenAccount: pubkey }))\n .catch(() => undefined);\n })\n );\n\n return nftStates.filter((entry) => entry !== undefined);\n } catch (error) {\n console.error(\"Error retrieving NFT records:\", error);\n return [];\n }\n};\n\n/**\n * Retrieves the SNS domain NFTs owned by a given address.\n *\n * Returned `domain` values do not include a `.sns` or `.sol` suffix.\n * If NFT records cannot be retrieved or decoded, this function returns an empty\n * array instead of throwing.\n *\n * Entries without reverse lookup results are omitted.\n *\n * @param params Tokenized domain retrieval parameters\n * @param params.rpc RPC client implementing multiple-account and program account APIs\n * @param params.address Address whose SNS domain NFTs are retrieved\n * @returns Tokenized domain records with TLD-trimmed names, domain addresses,\n * mints, and holding token accounts.\n *\n * @example\n * ```ts\n * const domains = await getSnsNftsForAddress({ rpc, address });\n * ```\n */\nexport const getSnsNftsForAddress = async ({\n rpc,\n address,\n}: GetSnsNftsForAddressParams): Promise<GetSnsNftsForAddressResult[]> => {\n const nftStates = await getNftStatesForAddress({ rpc, address });\n const nftNameAccounts = nftStates.map(({ state }) => state.nameAccount);\n const domains = await reverseLookupBatch({\n rpc,\n domainAddresses: nftNameAccounts,\n });\n\n return domains\n .map((domain, index) => {\n if (!domain) return undefined;\n\n const { state, tokenAccount } = nftStates[index];\n return {\n domain,\n domainAddress: state.nameAccount,\n mint: state.nftMint,\n tokenAccount,\n };\n })\n .filter((e) => e !== undefined);\n};\n"],"names":[],"mappings":";;;;;AAoDA;;;;;;;;;;AAUG;AACH,MAAM,sBAAsB,GAAG,OAAO,EACpC,GAAG,EACH,OAAO,GAIR,KAA2D;AAC1D,IAAA,IAAI;QACF,MAAM,OAAO,GAAG,MAAM;aACnB,kBAAkB,CAAC,qBAAqB,EAAE;AACzC,YAAA,QAAQ,EAAE,QAAQ;AAClB,YAAA,OAAO,EAAE;AACP,gBAAA;AACE,oBAAA,MAAM,EAAE;AACN,wBAAA,MAAM,EAAE,GAAG;AACX,wBAAA,KAAK,EAAE,OAAuC;AAC9C,wBAAA,QAAQ,EAAE,QAAQ;AACnB,qBAAA;AACF,iBAAA;AACD,gBAAA;AACE,oBAAA,MAAM,EAAE;AACN,wBAAA,MAAM,EAAE,GAAG;AACX,wBAAA,KAAK,EAAE,GAAyB;AAChC,wBAAA,QAAQ,EAAE,QAAQ;AACnB,qBAAA;AACF,iBAAA;gBACD,EAAE,QAAQ,EAAE,IAAI,EAAE;AACnB,aAAA;SACF;AACA,aAAA,IAAI,EAAE;AAET,QAAA,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAI;YAClC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,YAAA,OAAO,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI;AACvC,iBAAA,IAAI,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC;AACjD,iBAAA,KAAK,CAAC,MAAM,SAAS,CAAC;QAC3B,CAAC,CAAC,CACH;AAED,QAAA,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,KAAK,KAAK,SAAS,CAAC;IACzD;IAAE,OAAO,KAAK,EAAE;AACd,QAAA,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC;AACrD,QAAA,OAAO,EAAE;IACX;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;AAmBG;AACI,MAAM,oBAAoB,GAAG,OAAO,EACzC,GAAG,EACH,OAAO,GACoB,KAA2C;IACtE,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAChE,IAAA,MAAM,eAAe,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,CAAC,WAAW,CAAC;AACvE,IAAA,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC;QACvC,GAAG;AACH,QAAA,eAAe,EAAE,eAAe;AACjC,KAAA,CAAC;AAEF,IAAA,OAAO;AACJ,SAAA,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,KAAI;AACrB,QAAA,IAAI,CAAC,MAAM;AAAE,YAAA,OAAO,SAAS;QAE7B,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC;QAChD,OAAO;YACL,MAAM;YACN,aAAa,EAAE,KAAK,CAAC,WAAW;YAChC,IAAI,EAAE,KAAK,CAAC,OAAO;YACnB,YAAY;SACb;AACH,IAAA,CAAC;SACA,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC;AACnC;;"}
@@ -72,6 +72,7 @@ interface GetSnsNftsForAddressParams {
72
72
  * domain: "example",
73
73
  * domainAddress,
74
74
  * mint,
75
+ * tokenAccount,
75
76
  * };
76
77
  * ```
77
78
  */
@@ -82,6 +83,8 @@ interface GetSnsNftsForAddressResult {
82
83
  domainAddress: Address;
83
84
  /** NFT mint address. */
84
85
  mint: Address;
86
+ /** SPL Token account that holds the NFT. */
87
+ tokenAccount: Address;
85
88
  }
86
89
  /**
87
90
  * Retrieves the SNS domain NFTs owned by a given address.
@@ -95,7 +98,8 @@ interface GetSnsNftsForAddressResult {
95
98
  * @param params Tokenized domain retrieval parameters
96
99
  * @param params.rpc RPC client implementing multiple-account and program account APIs
97
100
  * @param params.address Address whose SNS domain NFTs are retrieved
98
- * @returns Tokenized domain records with names without a TLD suffix, domain addresses, and mints.
101
+ * @returns Tokenized domain records with TLD-trimmed names, domain addresses,
102
+ * mints, and holding token accounts.
99
103
  *
100
104
  * @example
101
105
  * ```ts
@@ -76,6 +76,7 @@ interface GetSnsNftsForAddressParams {
76
76
  * domain: "example",
77
77
  * domainAddress,
78
78
  * mint,
79
+ * tokenAccount,
79
80
  * };
80
81
  * ```
81
82
  */
@@ -86,6 +87,8 @@ interface GetSnsNftsForAddressResult {
86
87
  domainAddress: Address;
87
88
  /** NFT mint address. */
88
89
  mint: Address;
90
+ /** SPL Token account that holds the NFT. */
91
+ tokenAccount: Address;
89
92
  }
90
93
  /**
91
94
  * Retrieves the SNS domain NFTs owned by a given address.
@@ -99,7 +102,8 @@ interface GetSnsNftsForAddressResult {
99
102
  * @param params Tokenized domain retrieval parameters
100
103
  * @param params.rpc RPC client implementing multiple-account and program account APIs
101
104
  * @param params.address Address whose SNS domain NFTs are retrieved
102
- * @returns Tokenized domain records with names without a TLD suffix, domain addresses, and mints.
105
+ * @returns Tokenized domain records with TLD-trimmed names, domain addresses,
106
+ * mints, and holding token accounts.
103
107
  *
104
108
  * @example
105
109
  * ```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.2",
3
+ "version": "1.1.0-beta.3",
4
4
  "license": "MIT",
5
5
  "files": [
6
6
  "dist"