@solana-name-service/sns-sdk-kit 1.1.0-beta.1 → 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;;"}
@@ -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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"}
@@ -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;;"}
@@ -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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"}
@@ -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
@@ -168,7 +172,7 @@ interface GetSolNftsForAddressParams {
168
172
  address: Address;
169
173
  }
170
174
  /**
171
- * A tokenized `.sol` domain and its associated NFT mint.
175
+ * A tokenized `.sol` domain and its associated NFT mint/token account.
172
176
  *
173
177
  * @example
174
178
  * ```ts
@@ -176,6 +180,7 @@ interface GetSolNftsForAddressParams {
176
180
  * domain: "example",
177
181
  * domainAddress,
178
182
  * mint,
183
+ * tokenAccount,
179
184
  * };
180
185
  * ```
181
186
  */
@@ -186,6 +191,8 @@ interface GetSolNftsForAddressResult {
186
191
  domainAddress: Address;
187
192
  /** Token-2022 mint address. */
188
193
  mint: Address;
194
+ /** Token-2022 token account address. */
195
+ tokenAccount: Address;
189
196
  }
190
197
  /**
191
198
  * Retrieves non-expired tokenized `.sol` domains held by an address.
@@ -196,7 +203,7 @@ interface GetSolNftsForAddressResult {
196
203
  * @param params Tokenized-domain retrieval parameters
197
204
  * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs
198
205
  * @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.
206
+ * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, mint addresses, and token account addresses.
200
207
  *
201
208
  * @example
202
209
  * ```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
@@ -172,7 +176,7 @@ interface GetSolNftsForAddressParams {
172
176
  address: Address;
173
177
  }
174
178
  /**
175
- * A tokenized `.sol` domain and its associated NFT mint.
179
+ * A tokenized `.sol` domain and its associated NFT mint/token account.
176
180
  *
177
181
  * @example
178
182
  * ```ts
@@ -180,6 +184,7 @@ interface GetSolNftsForAddressParams {
180
184
  * domain: "example",
181
185
  * domainAddress,
182
186
  * mint,
187
+ * tokenAccount,
183
188
  * };
184
189
  * ```
185
190
  */
@@ -190,6 +195,8 @@ interface GetSolNftsForAddressResult {
190
195
  domainAddress: Address;
191
196
  /** Token-2022 mint address. */
192
197
  mint: Address;
198
+ /** Token-2022 token account address. */
199
+ tokenAccount: Address;
193
200
  }
194
201
  /**
195
202
  * Retrieves non-expired tokenized `.sol` domains held by an address.
@@ -200,7 +207,7 @@ interface GetSolNftsForAddressResult {
200
207
  * @param params Tokenized-domain retrieval parameters
201
208
  * @param params.rpc RPC client implementing program-account and multiple-account lookup APIs
202
209
  * @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.
210
+ * @returns Non-expired tokenized-domain records with TLD-trimmed names, SRS record addresses, mint addresses, and token account addresses.
204
211
  *
205
212
  * @example
206
213
  * ```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.1",
3
+ "version": "1.1.0-beta.3",
4
4
  "license": "MIT",
5
5
  "files": [
6
6
  "dist"