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

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.
Files changed (278) hide show
  1. package/README.md +28 -15
  2. package/dist/cjs/address/getPrimaryDomain.cjs.map +1 -1
  3. package/dist/cjs/address/getPrimaryDomainsBatch.cjs.map +1 -1
  4. package/dist/cjs/address/getSnsDomainsForAddress.cjs.map +1 -1
  5. package/dist/cjs/address/getSnsNftsForAddress.cjs.map +1 -1
  6. package/dist/cjs/address/getSolDomainsForAddress.cjs +86 -0
  7. package/dist/cjs/address/getSolDomainsForAddress.cjs.map +1 -0
  8. package/dist/cjs/address/getSolNftsForAddress.cjs +144 -0
  9. package/dist/cjs/address/getSolNftsForAddress.cjs.map +1 -0
  10. package/dist/cjs/address/index.cjs +4 -0
  11. package/dist/cjs/address/index.cjs.map +1 -1
  12. package/dist/cjs/bindings/burnDomain.cjs.map +1 -1
  13. package/dist/cjs/bindings/createNameRegistry.cjs.map +1 -1
  14. package/dist/cjs/bindings/createRecord.cjs.map +1 -1
  15. package/dist/cjs/bindings/createReverse.cjs.map +1 -1
  16. package/dist/cjs/bindings/createSubdomain.cjs.map +1 -1
  17. package/dist/cjs/bindings/deleteNameRegistry.cjs.map +1 -1
  18. package/dist/cjs/bindings/deleteRecord.cjs.map +1 -1
  19. package/dist/cjs/bindings/recordValidation.cjs.map +1 -1
  20. package/dist/cjs/bindings/registerDomain.cjs.map +1 -1
  21. package/dist/cjs/bindings/registerDomainWithNft.cjs.map +1 -1
  22. package/dist/cjs/bindings/setPrimaryDomain.cjs.map +1 -1
  23. package/dist/cjs/bindings/setRecordRoaVerifier.cjs.map +1 -1
  24. package/dist/cjs/bindings/setRecordStalenessVerifier.cjs.map +1 -1
  25. package/dist/cjs/bindings/transferDomain.cjs.map +1 -1
  26. package/dist/cjs/bindings/transferSubdomain.cjs.map +1 -1
  27. package/dist/cjs/bindings/updateNameRegistry.cjs.map +1 -1
  28. package/dist/cjs/bindings/updateRecord.cjs.map +1 -1
  29. package/dist/cjs/bindings/validateRecordRoa.cjs.map +1 -1
  30. package/dist/cjs/bindings/validateRecordRoaEthereum.cjs.map +1 -1
  31. package/dist/cjs/codecs.cjs.map +1 -1
  32. package/dist/cjs/constants/addresses.cjs +26 -16
  33. package/dist/cjs/constants/addresses.cjs.map +1 -1
  34. package/dist/cjs/constants/index.cjs +18 -0
  35. package/dist/cjs/constants/index.cjs.map +1 -1
  36. package/dist/cjs/constants/pythFeeds.cjs.map +1 -1
  37. package/dist/cjs/constants/records.cjs.map +1 -1
  38. package/dist/cjs/constants/srs.cjs +48 -0
  39. package/dist/cjs/constants/srs.cjs.map +1 -0
  40. package/dist/cjs/domain/getAllSnsDomains.cjs.map +1 -1
  41. package/dist/cjs/domain/getAllSolDomains.cjs +58 -0
  42. package/dist/cjs/domain/getAllSolDomains.cjs.map +1 -0
  43. package/dist/cjs/domain/getDomainOwner.cjs +3 -3
  44. package/dist/cjs/domain/getDomainOwner.cjs.map +1 -1
  45. package/dist/cjs/domain/getDomainRecord.cjs +3 -3
  46. package/dist/cjs/domain/getDomainRecord.cjs.map +1 -1
  47. package/dist/cjs/domain/getDomainRecords.cjs +3 -3
  48. package/dist/cjs/domain/getDomainRecords.cjs.map +1 -1
  49. package/dist/cjs/domain/getSnsDomainAddress.cjs.map +1 -1
  50. package/dist/cjs/domain/getSnsDomainOwner.cjs +1 -2
  51. package/dist/cjs/domain/getSnsDomainOwner.cjs.map +1 -1
  52. package/dist/cjs/domain/getSolDomainAddress.cjs +36 -0
  53. package/dist/cjs/domain/getSolDomainAddress.cjs.map +1 -0
  54. package/dist/cjs/domain/getSrsDomainAddress.cjs +4 -17
  55. package/dist/cjs/domain/getSrsDomainAddress.cjs.map +1 -1
  56. package/dist/cjs/domain/getSubdomains.cjs +3 -3
  57. package/dist/cjs/domain/getSubdomains.cjs.map +1 -1
  58. package/dist/cjs/domain/index.cjs +4 -0
  59. package/dist/cjs/domain/index.cjs.map +1 -1
  60. package/dist/cjs/domain/resolve.cjs +19 -12
  61. package/dist/cjs/domain/resolve.cjs.map +1 -1
  62. package/dist/cjs/domain/resolveSns.cjs.map +1 -1
  63. package/dist/cjs/domain/resolveSol.cjs +129 -0
  64. package/dist/cjs/domain/resolveSol.cjs.map +1 -0
  65. package/dist/cjs/errors.cjs.map +1 -1
  66. package/dist/cjs/index.cjs +141 -115
  67. package/dist/cjs/index.cjs.map +1 -1
  68. package/dist/cjs/instructions/allocateAndPostRecordInstruction.cjs.map +1 -1
  69. package/dist/cjs/instructions/burnDomainInstruction.cjs.map +1 -1
  70. package/dist/cjs/instructions/createAtaIdempotentInstruction.cjs.map +1 -1
  71. package/dist/cjs/instructions/createNameRegistryInstruction.cjs.map +1 -1
  72. package/dist/cjs/instructions/createReverseInstruction.cjs.map +1 -1
  73. package/dist/cjs/instructions/createSplitV2Instruction.cjs.map +1 -1
  74. package/dist/cjs/instructions/createWithNftInstruction.cjs.map +1 -1
  75. package/dist/cjs/instructions/deleteNameRegistryInstruction.cjs.map +1 -1
  76. package/dist/cjs/instructions/deleteRecordInstruction.cjs.map +1 -1
  77. package/dist/cjs/instructions/reallocInstruction.cjs.map +1 -1
  78. package/dist/cjs/instructions/registerPrimaryInstruction.cjs.map +1 -1
  79. package/dist/cjs/instructions/setRecordRoaVerifierInstruction.cjs.map +1 -1
  80. package/dist/cjs/instructions/transferInstruction.cjs.map +1 -1
  81. package/dist/cjs/instructions/updateNameRegistryInstruction.cjs.map +1 -1
  82. package/dist/cjs/instructions/updateRecordInstruction.cjs.map +1 -1
  83. package/dist/cjs/instructions/validateEthereumSignatureInstruction.cjs.map +1 -1
  84. package/dist/cjs/instructions/validateSolanaSignatureInstruction.cjs.map +1 -1
  85. package/dist/cjs/nft/getSnsNftMint.cjs.map +1 -1
  86. package/dist/cjs/nft/getSnsNftOwner.cjs.map +1 -1
  87. package/dist/cjs/record/getRecordV1Address.cjs.map +1 -1
  88. package/dist/cjs/record/getRecordV2Address.cjs.map +1 -1
  89. package/dist/cjs/record/verifyRecordRightOfAssociation.cjs +3 -3
  90. package/dist/cjs/record/verifyRecordRightOfAssociation.cjs.map +1 -1
  91. package/dist/cjs/record/verifyRecordStaleness.cjs +3 -3
  92. package/dist/cjs/record/verifyRecordStaleness.cjs.map +1 -1
  93. package/dist/cjs/srs/additional-metadata.cjs +20 -0
  94. package/dist/cjs/srs/additional-metadata.cjs.map +1 -0
  95. package/dist/cjs/srs/metadata.cjs +27 -0
  96. package/dist/cjs/srs/metadata.cjs.map +1 -0
  97. package/dist/cjs/states/nft.cjs.map +1 -1
  98. package/dist/cjs/states/primaryDomain.cjs.map +1 -1
  99. package/dist/cjs/states/record.cjs.map +1 -1
  100. package/dist/cjs/states/registry.cjs.map +1 -1
  101. package/dist/cjs/types/record.cjs.map +1 -1
  102. package/dist/cjs/types/validation.cjs.map +1 -1
  103. package/dist/cjs/utils/check.cjs.map +1 -1
  104. package/dist/cjs/utils/checkAddressOnCurve/ed25519.cjs.map +1 -1
  105. package/dist/cjs/utils/checkAddressOnCurve/index.cjs.map +1 -1
  106. package/dist/cjs/utils/deriveAddress.cjs.map +1 -1
  107. package/dist/cjs/utils/deserializers/deserializeRecordContent.cjs.map +1 -1
  108. package/dist/cjs/utils/deserializers/deserializeReverse.cjs.map +1 -1
  109. package/dist/cjs/utils/fetchEncodedAccountsBatched.cjs +29 -0
  110. package/dist/cjs/utils/fetchEncodedAccountsBatched.cjs.map +1 -0
  111. package/dist/cjs/utils/getPythFeedAddress.cjs.map +1 -1
  112. package/dist/cjs/utils/getReverseAddress.cjs.map +1 -1
  113. package/dist/cjs/utils/getReverseAddressFromDomainAddress.cjs.map +1 -1
  114. package/dist/cjs/utils/parseSnsDomain.cjs +1 -2
  115. package/dist/cjs/utils/parseSnsDomain.cjs.map +1 -1
  116. package/dist/cjs/utils/reverseLookup.cjs.map +1 -1
  117. package/dist/cjs/utils/reverseLookupBatch.cjs.map +1 -1
  118. package/dist/cjs/utils/serializers/serializeRecordContent.cjs.map +1 -1
  119. package/dist/cjs/utils/tld.cjs +1 -1
  120. package/dist/cjs/utils/tld.cjs.map +1 -1
  121. package/dist/cjs/utils/token2022/assertValidAccountData.cjs +37 -0
  122. package/dist/cjs/utils/token2022/assertValidAccountData.cjs.map +1 -0
  123. package/dist/cjs/utils/token2022/extensions.cjs +91 -0
  124. package/dist/cjs/utils/token2022/extensions.cjs.map +1 -0
  125. package/dist/cjs/utils/token2022/unpackAccount.cjs +29 -0
  126. package/dist/cjs/utils/token2022/unpackAccount.cjs.map +1 -0
  127. package/dist/cjs/utils/token2022/unpackMint.cjs +27 -0
  128. package/dist/cjs/utils/token2022/unpackMint.cjs.map +1 -0
  129. package/dist/cjs/utils/uint8Array/uint8ArrayFromHex.cjs.map +1 -1
  130. package/dist/cjs/utils/uint8Array/uint8ArrayToHex.cjs.map +1 -1
  131. package/dist/cjs/utils/uint8Array/uint8ArraysEqual.cjs.map +1 -1
  132. package/dist/esm/address/getPrimaryDomain.mjs.map +1 -1
  133. package/dist/esm/address/getPrimaryDomainsBatch.mjs.map +1 -1
  134. package/dist/esm/address/getSnsDomainsForAddress.mjs.map +1 -1
  135. package/dist/esm/address/getSnsNftsForAddress.mjs.map +1 -1
  136. package/dist/esm/address/getSolDomainsForAddress.mjs +82 -0
  137. package/dist/esm/address/getSolDomainsForAddress.mjs.map +1 -0
  138. package/dist/esm/address/getSolNftsForAddress.mjs +140 -0
  139. package/dist/esm/address/getSolNftsForAddress.mjs.map +1 -0
  140. package/dist/esm/address/index.mjs +2 -0
  141. package/dist/esm/address/index.mjs.map +1 -1
  142. package/dist/esm/bindings/burnDomain.mjs.map +1 -1
  143. package/dist/esm/bindings/createNameRegistry.mjs.map +1 -1
  144. package/dist/esm/bindings/createRecord.mjs.map +1 -1
  145. package/dist/esm/bindings/createReverse.mjs.map +1 -1
  146. package/dist/esm/bindings/createSubdomain.mjs.map +1 -1
  147. package/dist/esm/bindings/deleteNameRegistry.mjs.map +1 -1
  148. package/dist/esm/bindings/deleteRecord.mjs.map +1 -1
  149. package/dist/esm/bindings/recordValidation.mjs.map +1 -1
  150. package/dist/esm/bindings/registerDomain.mjs.map +1 -1
  151. package/dist/esm/bindings/registerDomainWithNft.mjs.map +1 -1
  152. package/dist/esm/bindings/setPrimaryDomain.mjs.map +1 -1
  153. package/dist/esm/bindings/setRecordRoaVerifier.mjs.map +1 -1
  154. package/dist/esm/bindings/setRecordStalenessVerifier.mjs.map +1 -1
  155. package/dist/esm/bindings/transferDomain.mjs.map +1 -1
  156. package/dist/esm/bindings/transferSubdomain.mjs.map +1 -1
  157. package/dist/esm/bindings/updateNameRegistry.mjs.map +1 -1
  158. package/dist/esm/bindings/updateRecord.mjs.map +1 -1
  159. package/dist/esm/bindings/validateRecordRoa.mjs.map +1 -1
  160. package/dist/esm/bindings/validateRecordRoaEthereum.mjs.map +1 -1
  161. package/dist/esm/codecs.mjs.map +1 -1
  162. package/dist/esm/constants/addresses.mjs +24 -17
  163. package/dist/esm/constants/addresses.mjs.map +1 -1
  164. package/dist/esm/constants/index.mjs +2 -1
  165. package/dist/esm/constants/index.mjs.map +1 -1
  166. package/dist/esm/constants/pythFeeds.mjs.map +1 -1
  167. package/dist/esm/constants/records.mjs.map +1 -1
  168. package/dist/esm/constants/srs.mjs +31 -0
  169. package/dist/esm/constants/srs.mjs.map +1 -0
  170. package/dist/esm/domain/getAllSnsDomains.mjs.map +1 -1
  171. package/dist/esm/domain/getAllSolDomains.mjs +54 -0
  172. package/dist/esm/domain/getAllSolDomains.mjs.map +1 -0
  173. package/dist/esm/domain/getDomainOwner.mjs +3 -3
  174. package/dist/esm/domain/getDomainOwner.mjs.map +1 -1
  175. package/dist/esm/domain/getDomainRecord.mjs +3 -3
  176. package/dist/esm/domain/getDomainRecord.mjs.map +1 -1
  177. package/dist/esm/domain/getDomainRecords.mjs +3 -3
  178. package/dist/esm/domain/getDomainRecords.mjs.map +1 -1
  179. package/dist/esm/domain/getSnsDomainAddress.mjs.map +1 -1
  180. package/dist/esm/domain/getSnsDomainOwner.mjs +1 -2
  181. package/dist/esm/domain/getSnsDomainOwner.mjs.map +1 -1
  182. package/dist/esm/domain/getSolDomainAddress.mjs +32 -0
  183. package/dist/esm/domain/getSolDomainAddress.mjs.map +1 -0
  184. package/dist/esm/domain/getSrsDomainAddress.mjs +4 -17
  185. package/dist/esm/domain/getSrsDomainAddress.mjs.map +1 -1
  186. package/dist/esm/domain/getSubdomains.mjs +3 -3
  187. package/dist/esm/domain/getSubdomains.mjs.map +1 -1
  188. package/dist/esm/domain/index.mjs +2 -0
  189. package/dist/esm/domain/index.mjs.map +1 -1
  190. package/dist/esm/domain/resolve.mjs +20 -13
  191. package/dist/esm/domain/resolve.mjs.map +1 -1
  192. package/dist/esm/domain/resolveSns.mjs.map +1 -1
  193. package/dist/esm/domain/resolveSol.mjs +125 -0
  194. package/dist/esm/domain/resolveSol.mjs.map +1 -0
  195. package/dist/esm/errors.mjs.map +1 -1
  196. package/dist/esm/index.mjs +51 -46
  197. package/dist/esm/index.mjs.map +1 -1
  198. package/dist/esm/instructions/allocateAndPostRecordInstruction.mjs.map +1 -1
  199. package/dist/esm/instructions/burnDomainInstruction.mjs.map +1 -1
  200. package/dist/esm/instructions/createAtaIdempotentInstruction.mjs.map +1 -1
  201. package/dist/esm/instructions/createNameRegistryInstruction.mjs.map +1 -1
  202. package/dist/esm/instructions/createReverseInstruction.mjs.map +1 -1
  203. package/dist/esm/instructions/createSplitV2Instruction.mjs.map +1 -1
  204. package/dist/esm/instructions/createWithNftInstruction.mjs.map +1 -1
  205. package/dist/esm/instructions/deleteNameRegistryInstruction.mjs.map +1 -1
  206. package/dist/esm/instructions/deleteRecordInstruction.mjs.map +1 -1
  207. package/dist/esm/instructions/reallocInstruction.mjs.map +1 -1
  208. package/dist/esm/instructions/registerPrimaryInstruction.mjs.map +1 -1
  209. package/dist/esm/instructions/setRecordRoaVerifierInstruction.mjs.map +1 -1
  210. package/dist/esm/instructions/transferInstruction.mjs.map +1 -1
  211. package/dist/esm/instructions/updateNameRegistryInstruction.mjs.map +1 -1
  212. package/dist/esm/instructions/updateRecordInstruction.mjs.map +1 -1
  213. package/dist/esm/instructions/validateEthereumSignatureInstruction.mjs.map +1 -1
  214. package/dist/esm/instructions/validateSolanaSignatureInstruction.mjs.map +1 -1
  215. package/dist/esm/nft/getSnsNftMint.mjs +1 -1
  216. package/dist/esm/nft/getSnsNftMint.mjs.map +1 -1
  217. package/dist/esm/nft/getSnsNftOwner.mjs.map +1 -1
  218. package/dist/esm/record/getRecordV1Address.mjs.map +1 -1
  219. package/dist/esm/record/getRecordV2Address.mjs.map +1 -1
  220. package/dist/esm/record/verifyRecordRightOfAssociation.mjs +3 -3
  221. package/dist/esm/record/verifyRecordRightOfAssociation.mjs.map +1 -1
  222. package/dist/esm/record/verifyRecordStaleness.mjs +3 -3
  223. package/dist/esm/record/verifyRecordStaleness.mjs.map +1 -1
  224. package/dist/esm/srs/additional-metadata.mjs +16 -0
  225. package/dist/esm/srs/additional-metadata.mjs.map +1 -0
  226. package/dist/esm/srs/metadata.mjs +23 -0
  227. package/dist/esm/srs/metadata.mjs.map +1 -0
  228. package/dist/esm/states/nft.mjs.map +1 -1
  229. package/dist/esm/states/primaryDomain.mjs.map +1 -1
  230. package/dist/esm/states/record.mjs +1 -1
  231. package/dist/esm/states/record.mjs.map +1 -1
  232. package/dist/esm/states/registry.mjs.map +1 -1
  233. package/dist/esm/types/record.mjs.map +1 -1
  234. package/dist/esm/types/validation.mjs.map +1 -1
  235. package/dist/esm/utils/check.mjs.map +1 -1
  236. package/dist/esm/utils/checkAddressOnCurve/ed25519.mjs.map +1 -1
  237. package/dist/esm/utils/checkAddressOnCurve/index.mjs.map +1 -1
  238. package/dist/esm/utils/deriveAddress.mjs.map +1 -1
  239. package/dist/esm/utils/deserializers/deserializeRecordContent.mjs.map +1 -1
  240. package/dist/esm/utils/deserializers/deserializeReverse.mjs.map +1 -1
  241. package/dist/esm/utils/fetchEncodedAccountsBatched.mjs +25 -0
  242. package/dist/esm/utils/fetchEncodedAccountsBatched.mjs.map +1 -0
  243. package/dist/esm/utils/getPythFeedAddress.mjs.map +1 -1
  244. package/dist/esm/utils/getReverseAddress.mjs.map +1 -1
  245. package/dist/esm/utils/getReverseAddressFromDomainAddress.mjs.map +1 -1
  246. package/dist/esm/utils/parseSnsDomain.mjs +1 -2
  247. package/dist/esm/utils/parseSnsDomain.mjs.map +1 -1
  248. package/dist/esm/utils/reverseLookup.mjs.map +1 -1
  249. package/dist/esm/utils/reverseLookupBatch.mjs.map +1 -1
  250. package/dist/esm/utils/serializers/serializeRecordContent.mjs.map +1 -1
  251. package/dist/esm/utils/tld.mjs +1 -1
  252. package/dist/esm/utils/tld.mjs.map +1 -1
  253. package/dist/esm/utils/token2022/assertValidAccountData.mjs +33 -0
  254. package/dist/esm/utils/token2022/assertValidAccountData.mjs.map +1 -0
  255. package/dist/esm/utils/token2022/extensions.mjs +85 -0
  256. package/dist/esm/utils/token2022/extensions.mjs.map +1 -0
  257. package/dist/esm/utils/token2022/unpackAccount.mjs +25 -0
  258. package/dist/esm/utils/token2022/unpackAccount.mjs.map +1 -0
  259. package/dist/esm/utils/token2022/unpackMint.mjs +23 -0
  260. package/dist/esm/utils/token2022/unpackMint.mjs.map +1 -0
  261. package/dist/esm/utils/uint8Array/uint8ArrayFromHex.mjs.map +1 -1
  262. package/dist/esm/utils/uint8Array/uint8ArrayToHex.mjs.map +1 -1
  263. package/dist/esm/utils/uint8Array/uint8ArraysEqual.mjs.map +1 -1
  264. package/dist/types/address/index.d.ts +103 -2
  265. package/dist/types/constants/index.d.ts +53 -17
  266. package/dist/types/domain/index.d.ts +94 -32
  267. package/dist/types/index.d.ts +253 -54
  268. package/dist/types/record/index.d.ts +6 -6
  269. package/dist/types/utils/index.d.ts +1 -1
  270. package/package.json +2 -1
  271. package/dist/cjs/config.cjs +0 -18
  272. package/dist/cjs/config.cjs.map +0 -1
  273. package/dist/cjs/utils/assertTldSupported.cjs +0 -28
  274. package/dist/cjs/utils/assertTldSupported.cjs.map +0 -1
  275. package/dist/esm/config.mjs +0 -11
  276. package/dist/esm/config.mjs.map +0 -1
  277. package/dist/esm/utils/assertTldSupported.mjs +0 -24
  278. package/dist/esm/utils/assertTldSupported.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"getDomainRecord.mjs","sources":["../../../src/domain/getDomainRecord.ts"],"sourcesContent":["import {\r\n GetAccountInfoApi,\r\n GetMultipleAccountsApi,\r\n GetSlotApi,\r\n GetTokenLargestAccountsApi,\r\n ReadonlyUint8Array,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { getRecordV2Address } from \"../record/getRecordV2Address\";\r\nimport {\r\n _getDefaultVerifier,\r\n _verifyRoaSync,\r\n} from \"../record/verifyRecordRightOfAssociation\";\r\nimport { _verifyStalenessSync } from \"../record/verifyRecordStaleness\";\r\nimport { RecordState } from \"../states/record\";\r\nimport { Record } from \"../types/record\";\r\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\r\nimport { deserializeRecordContent } from \"../utils/deserializers/deserializeRecordContent\";\r\nimport { _getSnsDomainOwner } from \"./getSnsDomainOwner\";\r\n\r\n/**\r\n * Options for retrieving a domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const options: GetDomainRecordOptions = { deserialize: true };\r\n * ```\r\n */\r\nexport interface GetDomainRecordOptions {\r\n /** Whether to decode record content. */\r\n deserialize?: boolean;\r\n /** Custom Right of Association verifier. */\r\n verifier?: ReadonlyUint8Array;\r\n}\r\n\r\n/**\r\n * Parameters for retrieving a domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetDomainRecordParams = {\r\n * rpc,\r\n * domain: \"example.sns\",\r\n * record: Record.Url,\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordParams {\r\n /** RPC client. */\r\n rpc: Rpc<\r\n GetAccountInfoApi &\r\n GetMultipleAccountsApi &\r\n GetTokenLargestAccountsApi &\r\n GetSlotApi\r\n >;\r\n /** Full domain name. */\r\n domain: string;\r\n /** Record type to retrieve. */\r\n record: Record;\r\n /** Record retrieval options. */\r\n options?: GetDomainRecordOptions;\r\n}\r\n\r\n/**\r\n * Verification status for a domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const verified: GetDomainRecordVerification = { staleness: true };\r\n * ```\r\n */\r\nexport interface GetDomainRecordVerification {\r\n /** Whether the record is current. */\r\n staleness: boolean;\r\n /** Right of Association verification result. */\r\n roa?: boolean;\r\n}\r\n\r\n/**\r\n * A retrieved domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const result: GetDomainRecordResult = {\r\n * record: Record.Url,\r\n * retrievedRecord,\r\n * verified: { staleness: true },\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordResult {\r\n /** Record type. */\r\n record: Record;\r\n /** Retrieved record state. */\r\n retrievedRecord: RecordState;\r\n /** Verification status. */\r\n verified: GetDomainRecordVerification;\r\n /** Decoded record content. */\r\n deserializedContent?: string;\r\n}\r\n\r\n/**\r\n * Retrieves a V2 record under a domain, verifies it, and optionally decodes its content.\r\n *\r\n * @param params Record retrieval parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.record Record type to retrieve\r\n * @param params.options Optional record processing options\r\n * @returns The V2 record state, its verification result, and optional decoded content\r\n *\r\n * @example\r\n * ```ts\r\n * const result = await getDomainRecord({ rpc, domain: \"example.sns\", record: Record.Url });\r\n * ```\r\n */\r\nexport async function getDomainRecord({\r\n rpc,\r\n domain,\r\n record,\r\n options = {},\r\n}: GetDomainRecordParams): Promise<GetDomainRecordResult> {\r\n const [trimmedDomain] = await assertTldSupported({ rpc, domain });\r\n const [domainOwner, state] = await Promise.all([\r\n _getSnsDomainOwner({ rpc, domain: trimmedDomain }),\r\n getRecordV2Address({ domain: trimmedDomain, record }).then((address) =>\r\n RecordState.retrieve(rpc, address)\r\n ),\r\n ]);\r\n\r\n const verifier = options.verifier || _getDefaultVerifier({ record, state });\r\n const verified = {\r\n staleness: _verifyStalenessSync({ domainOwner, state }),\r\n ...(verifier && {\r\n roa: _verifyRoaSync({ record, state, verifier }),\r\n }),\r\n };\r\n\r\n return {\r\n record,\r\n retrievedRecord: state,\r\n verified,\r\n ...(options.deserialize && {\r\n deserializedContent: deserializeRecordContent({\r\n content: state.getContent(),\r\n record,\r\n }),\r\n }),\r\n };\r\n}\r\n"],"names":[],"mappings":";;;;;;;;AAsGA;;;;;;;;;;;;;;AAcG;AACI,eAAe,eAAe,CAAC,EACpC,GAAG,EACH,MAAM,EACN,MAAM,EACN,OAAO,GAAG,EAAE,GACU,EAAA;AACtB,IAAA,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACjE,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAClD,kBAAkB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,KACjE,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CACnC;AACF,KAAA,CAAC;AAEF,IAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3E,IAAA,MAAM,QAAQ,GAAG;QACf,SAAS,EAAE,oBAAoB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QACvD,IAAI,QAAQ,IAAI;YACd,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SACjD,CAAC;KACH;IAED,OAAO;QACL,MAAM;AACN,QAAA,eAAe,EAAE,KAAK;QACtB,QAAQ;AACR,QAAA,IAAI,OAAO,CAAC,WAAW,IAAI;YACzB,mBAAmB,EAAE,wBAAwB,CAAC;AAC5C,gBAAA,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE;gBAC3B,MAAM;aACP,CAAC;SACH,CAAC;KACH;AACH;;;;"}
1
+ {"version":3,"file":"getDomainRecord.mjs","sources":["../../../src/domain/getDomainRecord.ts"],"sourcesContent":["import {\r\n GetAccountInfoApi,\r\n GetMultipleAccountsApi,\r\n GetTokenLargestAccountsApi,\r\n ReadonlyUint8Array,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { getRecordV2Address } from \"../record/getRecordV2Address\";\r\nimport {\r\n _getDefaultVerifier,\r\n _verifyRoaSync,\r\n} from \"../record/verifyRecordRightOfAssociation\";\r\nimport { _verifyStalenessSync } from \"../record/verifyRecordStaleness\";\r\nimport { RecordState } from \"../states/record\";\r\nimport { Record } from \"../types/record\";\r\nimport { deserializeRecordContent } from \"../utils/deserializers/deserializeRecordContent\";\r\nimport { _parseSnsDomain } from \"../utils/parseSnsDomain\";\r\nimport { _getSnsDomainOwner } from \"./getSnsDomainOwner\";\r\n\r\n/**\r\n * Options for retrieving a domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const options: GetDomainRecordOptions = { deserialize: true };\r\n * ```\r\n */\r\nexport interface GetDomainRecordOptions {\r\n /** Whether to decode record content. */\r\n deserialize?: boolean;\r\n /** Custom Right of Association verifier. */\r\n verifier?: ReadonlyUint8Array;\r\n}\r\n\r\n/**\r\n * Parameters for retrieving a domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetDomainRecordParams = {\r\n * rpc,\r\n * domain: \"example.sns\",\r\n * record: Record.Url,\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordParams {\r\n /** RPC client. */\r\n rpc: Rpc<\r\n GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi\r\n >;\r\n /** Full `.sns` domain name. */\r\n domain: string;\r\n /** Record type to retrieve. */\r\n record: Record;\r\n /** Record retrieval options. */\r\n options?: GetDomainRecordOptions;\r\n}\r\n\r\n/**\r\n * Verification status for a domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const verified: GetDomainRecordVerification = { staleness: true };\r\n * ```\r\n */\r\nexport interface GetDomainRecordVerification {\r\n /** Whether the record is current. */\r\n staleness: boolean;\r\n /** Right of Association verification result. */\r\n roa?: boolean;\r\n}\r\n\r\n/**\r\n * A retrieved domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const result: GetDomainRecordResult = {\r\n * record: Record.Url,\r\n * retrievedRecord,\r\n * verified: { staleness: true },\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordResult {\r\n /** Record type. */\r\n record: Record;\r\n /** Retrieved record state. */\r\n retrievedRecord: RecordState;\r\n /** Verification status. */\r\n verified: GetDomainRecordVerification;\r\n /** Decoded record content. */\r\n deserializedContent?: string;\r\n}\r\n\r\n/**\r\n * Retrieves a V2 record under a domain, verifies it, and optionally decodes its content.\r\n *\r\n * @param params Record retrieval parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full `.sns` domain name\r\n * @param params.record Record type to retrieve\r\n * @param params.options Optional record processing options\r\n * @returns The V2 record state, its verification result, and optional decoded content\r\n *\r\n * @example\r\n * ```ts\r\n * const result = await getDomainRecord({ rpc, domain: \"example.sns\", record: Record.Url });\r\n * ```\r\n */\r\nexport async function getDomainRecord({\r\n rpc,\r\n domain,\r\n record,\r\n options = {},\r\n}: GetDomainRecordParams): Promise<GetDomainRecordResult> {\r\n const trimmedDomain = _parseSnsDomain(domain);\r\n const [domainOwner, state] = await Promise.all([\r\n _getSnsDomainOwner({ rpc, domain: trimmedDomain }),\r\n getRecordV2Address({ domain: trimmedDomain, record }).then((address) =>\r\n RecordState.retrieve(rpc, address)\r\n ),\r\n ]);\r\n\r\n const verifier = options.verifier || _getDefaultVerifier({ record, state });\r\n const verified = {\r\n staleness: _verifyStalenessSync({ domainOwner, state }),\r\n ...(verifier && {\r\n roa: _verifyRoaSync({ record, state, verifier }),\r\n }),\r\n };\r\n\r\n return {\r\n record,\r\n retrievedRecord: state,\r\n verified,\r\n ...(options.deserialize && {\r\n deserializedContent: deserializeRecordContent({\r\n content: state.getContent(),\r\n record,\r\n }),\r\n }),\r\n };\r\n}\r\n"],"names":[],"mappings":";;;;;;;;AAkGA;;;;;;;;;;;;;;AAcG;AACI,eAAe,eAAe,CAAC,EACpC,GAAG,EACH,MAAM,EACN,MAAM,EACN,OAAO,GAAG,EAAE,GACU,EAAA;AACtB,IAAA,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC;IAC7C,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7C,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAClD,kBAAkB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,KACjE,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CACnC;AACF,KAAA,CAAC;AAEF,IAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3E,IAAA,MAAM,QAAQ,GAAG;QACf,SAAS,EAAE,oBAAoB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QACvD,IAAI,QAAQ,IAAI;YACd,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;SACjD,CAAC;KACH;IAED,OAAO;QACL,MAAM;AACN,QAAA,eAAe,EAAE,KAAK;QACtB,QAAQ;AACR,QAAA,IAAI,OAAO,CAAC,WAAW,IAAI;YACzB,mBAAmB,EAAE,wBAAwB,CAAC;AAC5C,gBAAA,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE;gBAC3B,MAAM;aACP,CAAC;SACH,CAAC;KACH;AACH;;"}
@@ -3,8 +3,8 @@ import { getRecordV2Address } from '../record/getRecordV2Address.mjs';
3
3
  import { _getDefaultVerifier, _verifyRoaSync } from '../record/verifyRecordRightOfAssociation.mjs';
4
4
  import { _verifyStalenessSync } from '../record/verifyRecordStaleness.mjs';
5
5
  import { RecordState } from '../states/record.mjs';
6
- import { assertTldSupported } from '../utils/assertTldSupported.mjs';
7
6
  import { deserializeRecordContent } from '../utils/deserializers/deserializeRecordContent.mjs';
7
+ import { _parseSnsDomain } from '../utils/parseSnsDomain.mjs';
8
8
  import { _getSnsDomainOwner } from './getSnsDomainOwner.mjs';
9
9
 
10
10
  /**
@@ -12,7 +12,7 @@ import { _getSnsDomainOwner } from './getSnsDomainOwner.mjs';
12
12
  *
13
13
  * @param params Record retrieval parameters
14
14
  * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs
15
- * @param params.domain Full domain name including a `.sns` or `.sol` suffix
15
+ * @param params.domain Full `.sns` domain name
16
16
  * @param params.records Record types to retrieve
17
17
  * @param params.options Optional record processing options
18
18
  * @returns Results aligned with `records`; missing V2 record accounts produce `undefined`
@@ -27,7 +27,7 @@ async function getDomainRecords({ rpc, domain, records, options = {}, }) {
27
27
  if (verifiers && verifiers.length !== records.length) {
28
28
  throw new MissingVerifierError("The number of verifiers must be the same as the number of records");
29
29
  }
30
- const [trimmedDomain] = await assertTldSupported({ rpc, domain });
30
+ const trimmedDomain = _parseSnsDomain(domain);
31
31
  const [domainOwner, states] = await Promise.all([
32
32
  _getSnsDomainOwner({ rpc, domain: trimmedDomain }),
33
33
  Promise.all(records.map((record) => getRecordV2Address({ domain: trimmedDomain, record }))).then((addresses) => RecordState.retrieveBatch(rpc, addresses)),
@@ -1 +1 @@
1
- {"version":3,"file":"getDomainRecords.mjs","sources":["../../../src/domain/getDomainRecords.ts"],"sourcesContent":["import {\r\n GetAccountInfoApi,\r\n GetMultipleAccountsApi,\r\n GetSlotApi,\r\n GetTokenLargestAccountsApi,\r\n ReadonlyUint8Array,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { MissingVerifierError } from \"../errors\";\r\nimport { getRecordV2Address } from \"../record/getRecordV2Address\";\r\nimport {\r\n _getDefaultVerifier,\r\n _verifyRoaSync,\r\n} from \"../record/verifyRecordRightOfAssociation\";\r\nimport { _verifyStalenessSync } from \"../record/verifyRecordStaleness\";\r\nimport { RecordState } from \"../states/record\";\r\nimport { Record } from \"../types/record\";\r\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\r\nimport { deserializeRecordContent } from \"../utils/deserializers/deserializeRecordContent\";\r\nimport { _getSnsDomainOwner } from \"./getSnsDomainOwner\";\r\n\r\n/**\r\n * Options for retrieving domain records.\r\n *\r\n * @example\r\n * ```ts\r\n * const options: GetDomainRecordsOptions<[Record.Url], [undefined]> = {\r\n * deserialize: true,\r\n * verifiers: [undefined],\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordsOptions<\r\n T extends Record[],\r\n U extends { [K in keyof T]: ReadonlyUint8Array | undefined },\r\n> {\r\n /** Whether to decode record content. */\r\n deserialize?: boolean;\r\n /** Right of Association verifiers by record position. */\r\n verifiers?: [...U];\r\n}\r\n\r\n/**\r\n * Parameters for retrieving domain records.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetDomainRecordsParams<[Record.Url], [undefined]> = {\r\n * rpc,\r\n * domain: \"example.sns\",\r\n * records: [Record.Url],\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordsParams<\r\n T extends Record[],\r\n U extends { [K in keyof T]: ReadonlyUint8Array | undefined },\r\n> {\r\n /** RPC client. */\r\n rpc: Rpc<\r\n GetAccountInfoApi &\r\n GetMultipleAccountsApi &\r\n GetTokenLargestAccountsApi &\r\n GetSlotApi\r\n >;\r\n /** Full domain name. */\r\n domain: string;\r\n /** Record types to retrieve. */\r\n records: [...T];\r\n /** Record retrieval options. */\r\n options?: GetDomainRecordsOptions<T, U>;\r\n}\r\n\r\n/**\r\n * Verification status for a domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const verified: GetDomainRecordsVerification = { staleness: true };\r\n * ```\r\n */\r\nexport interface GetDomainRecordsVerification {\r\n /** Whether the record is current. */\r\n staleness: boolean;\r\n /** Right of Association verification result. */\r\n roa?: boolean;\r\n}\r\n\r\n/**\r\n * A retrieved domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const result: GetDomainRecordsResult = {\r\n * record: Record.Url,\r\n * retrievedRecord,\r\n * verified: { staleness: true },\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordsResult {\r\n /** Record type. */\r\n record: Record;\r\n /** Retrieved record state. */\r\n retrievedRecord: RecordState;\r\n /** Verification status. */\r\n verified: GetDomainRecordsVerification;\r\n /** Decoded record content. */\r\n deserializedContent?: string;\r\n}\r\n\r\n/**\r\n * Retrieves V2 records under a domain, verifies them, and optionally decodes their content.\r\n *\r\n * @param params Record retrieval parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.records Record types to retrieve\r\n * @param params.options Optional record processing options\r\n * @returns Results aligned with `records`; missing V2 record accounts produce `undefined`\r\n *\r\n * @example\r\n * ```ts\r\n * const results = await getDomainRecords({ rpc, domain: \"example.sns\", records: [Record.Url] });\r\n * ```\r\n */\r\nexport async function getDomainRecords<\r\n T extends Record[],\r\n U extends { [K in keyof T]: ReadonlyUint8Array | undefined },\r\n>({\r\n rpc,\r\n domain,\r\n records,\r\n options = {},\r\n}: GetDomainRecordsParams<T, U>): Promise<\r\n (GetDomainRecordsResult | undefined)[]\r\n> {\r\n const verifiers = options.verifiers;\r\n if (verifiers && verifiers.length !== records.length) {\r\n throw new MissingVerifierError(\r\n \"The number of verifiers must be the same as the number of records\"\r\n );\r\n }\r\n\r\n const [trimmedDomain] = await assertTldSupported({ rpc, domain });\r\n\r\n const [domainOwner, states] = await Promise.all([\r\n _getSnsDomainOwner({ rpc, domain: trimmedDomain }),\r\n Promise.all(\r\n records.map((record) =>\r\n getRecordV2Address({ domain: trimmedDomain, record })\r\n )\r\n ).then((addresses) => RecordState.retrieveBatch(rpc, addresses)),\r\n ]);\r\n\r\n return states.map((state, idx) => {\r\n if (!state) return undefined;\r\n\r\n const record = records[idx];\r\n const verifier =\r\n options.verifiers?.[idx] || _getDefaultVerifier({ record, state });\r\n const verified = {\r\n staleness: _verifyStalenessSync({ domainOwner, state }),\r\n ...(verifier && {\r\n roa: _verifyRoaSync({ record, state, verifier }),\r\n }),\r\n };\r\n\r\n return {\r\n record,\r\n retrievedRecord: state,\r\n verified,\r\n ...(options.deserialize && {\r\n deserializedContent: deserializeRecordContent({\r\n content: state.getContent(),\r\n record,\r\n }),\r\n }),\r\n };\r\n });\r\n}\r\n"],"names":[],"mappings":";;;;;;;;;AAgHA;;;;;;;;;;;;;;AAcG;AACI,eAAe,gBAAgB,CAGpC,EACA,GAAG,EACH,MAAM,EACN,OAAO,EACP,OAAO,GAAG,EAAE,GACiB,EAAA;AAG7B,IAAA,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS;IACnC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE;AACpD,QAAA,MAAM,IAAI,oBAAoB,CAC5B,mEAAmE,CACpE;;AAGH,IAAA,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAEjE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9C,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAClD,QAAA,OAAO,CAAC,GAAG,CACT,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CACtD,CACF,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,WAAW,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACjE,KAAA,CAAC;IAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAI;AAC/B,QAAA,IAAI,CAAC,KAAK;AAAE,YAAA,OAAO,SAAS;AAE5B,QAAA,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;AAC3B,QAAA,MAAM,QAAQ,GACZ,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC,IAAI,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACpE,QAAA,MAAM,QAAQ,GAAG;YACf,SAAS,EAAE,oBAAoB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;YACvD,IAAI,QAAQ,IAAI;gBACd,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;aACjD,CAAC;SACH;QAED,OAAO;YACL,MAAM;AACN,YAAA,eAAe,EAAE,KAAK;YACtB,QAAQ;AACR,YAAA,IAAI,OAAO,CAAC,WAAW,IAAI;gBACzB,mBAAmB,EAAE,wBAAwB,CAAC;AAC5C,oBAAA,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE;oBAC3B,MAAM;iBACP,CAAC;aACH,CAAC;SACH;AACH,KAAC,CAAC;AACJ;;;;"}
1
+ {"version":3,"file":"getDomainRecords.mjs","sources":["../../../src/domain/getDomainRecords.ts"],"sourcesContent":["import {\r\n GetAccountInfoApi,\r\n GetMultipleAccountsApi,\r\n GetTokenLargestAccountsApi,\r\n ReadonlyUint8Array,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { MissingVerifierError } from \"../errors\";\r\nimport { getRecordV2Address } from \"../record/getRecordV2Address\";\r\nimport {\r\n _getDefaultVerifier,\r\n _verifyRoaSync,\r\n} from \"../record/verifyRecordRightOfAssociation\";\r\nimport { _verifyStalenessSync } from \"../record/verifyRecordStaleness\";\r\nimport { RecordState } from \"../states/record\";\r\nimport { Record } from \"../types/record\";\r\nimport { deserializeRecordContent } from \"../utils/deserializers/deserializeRecordContent\";\r\nimport { _parseSnsDomain } from \"../utils/parseSnsDomain\";\r\nimport { _getSnsDomainOwner } from \"./getSnsDomainOwner\";\r\n\r\n/**\r\n * Options for retrieving domain records.\r\n *\r\n * @example\r\n * ```ts\r\n * const options: GetDomainRecordsOptions<[Record.Url], [undefined]> = {\r\n * deserialize: true,\r\n * verifiers: [undefined],\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordsOptions<\r\n T extends Record[],\r\n U extends { [K in keyof T]: ReadonlyUint8Array | undefined },\r\n> {\r\n /** Whether to decode record content. */\r\n deserialize?: boolean;\r\n /** Right of Association verifiers by record position. */\r\n verifiers?: [...U];\r\n}\r\n\r\n/**\r\n * Parameters for retrieving domain records.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetDomainRecordsParams<[Record.Url], [undefined]> = {\r\n * rpc,\r\n * domain: \"example.sns\",\r\n * records: [Record.Url],\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordsParams<\r\n T extends Record[],\r\n U extends { [K in keyof T]: ReadonlyUint8Array | undefined },\r\n> {\r\n /** RPC client. */\r\n rpc: Rpc<\r\n GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi\r\n >;\r\n /** Full `.sns` domain name. */\r\n domain: string;\r\n /** Record types to retrieve. */\r\n records: [...T];\r\n /** Record retrieval options. */\r\n options?: GetDomainRecordsOptions<T, U>;\r\n}\r\n\r\n/**\r\n * Verification status for a domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const verified: GetDomainRecordsVerification = { staleness: true };\r\n * ```\r\n */\r\nexport interface GetDomainRecordsVerification {\r\n /** Whether the record is current. */\r\n staleness: boolean;\r\n /** Right of Association verification result. */\r\n roa?: boolean;\r\n}\r\n\r\n/**\r\n * A retrieved domain record.\r\n *\r\n * @example\r\n * ```ts\r\n * const result: GetDomainRecordsResult = {\r\n * record: Record.Url,\r\n * retrievedRecord,\r\n * verified: { staleness: true },\r\n * };\r\n * ```\r\n */\r\nexport interface GetDomainRecordsResult {\r\n /** Record type. */\r\n record: Record;\r\n /** Retrieved record state. */\r\n retrievedRecord: RecordState;\r\n /** Verification status. */\r\n verified: GetDomainRecordsVerification;\r\n /** Decoded record content. */\r\n deserializedContent?: string;\r\n}\r\n\r\n/**\r\n * Retrieves V2 records under a domain, verifies them, and optionally decodes their content.\r\n *\r\n * @param params Record retrieval parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full `.sns` domain name\r\n * @param params.records Record types to retrieve\r\n * @param params.options Optional record processing options\r\n * @returns Results aligned with `records`; missing V2 record accounts produce `undefined`\r\n *\r\n * @example\r\n * ```ts\r\n * const results = await getDomainRecords({ rpc, domain: \"example.sns\", records: [Record.Url] });\r\n * ```\r\n */\r\nexport async function getDomainRecords<\r\n T extends Record[],\r\n U extends { [K in keyof T]: ReadonlyUint8Array | undefined },\r\n>({\r\n rpc,\r\n domain,\r\n records,\r\n options = {},\r\n}: GetDomainRecordsParams<T, U>): Promise<\r\n (GetDomainRecordsResult | undefined)[]\r\n> {\r\n const verifiers = options.verifiers;\r\n if (verifiers && verifiers.length !== records.length) {\r\n throw new MissingVerifierError(\r\n \"The number of verifiers must be the same as the number of records\"\r\n );\r\n }\r\n\r\n const trimmedDomain = _parseSnsDomain(domain);\r\n\r\n const [domainOwner, states] = await Promise.all([\r\n _getSnsDomainOwner({ rpc, domain: trimmedDomain }),\r\n Promise.all(\r\n records.map((record) =>\r\n getRecordV2Address({ domain: trimmedDomain, record })\r\n )\r\n ).then((addresses) => RecordState.retrieveBatch(rpc, addresses)),\r\n ]);\r\n\r\n return states.map((state, idx) => {\r\n if (!state) return undefined;\r\n\r\n const record = records[idx];\r\n const verifier =\r\n options.verifiers?.[idx] || _getDefaultVerifier({ record, state });\r\n const verified = {\r\n staleness: _verifyStalenessSync({ domainOwner, state }),\r\n ...(verifier && {\r\n roa: _verifyRoaSync({ record, state, verifier }),\r\n }),\r\n };\r\n\r\n return {\r\n record,\r\n retrievedRecord: state,\r\n verified,\r\n ...(options.deserialize && {\r\n deserializedContent: deserializeRecordContent({\r\n content: state.getContent(),\r\n record,\r\n }),\r\n }),\r\n };\r\n });\r\n}\r\n"],"names":[],"mappings":";;;;;;;;;AA4GA;;;;;;;;;;;;;;AAcG;AACI,eAAe,gBAAgB,CAGpC,EACA,GAAG,EACH,MAAM,EACN,OAAO,EACP,OAAO,GAAG,EAAE,GACiB,EAAA;AAG7B,IAAA,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS;IACnC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE;AACpD,QAAA,MAAM,IAAI,oBAAoB,CAC5B,mEAAmE,CACpE;IACH;AAEA,IAAA,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC;IAE7C,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9C,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAClD,QAAA,OAAO,CAAC,GAAG,CACT,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CACtD,CACF,CAAC,IAAI,CAAC,CAAC,SAAS,KAAK,WAAW,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACjE,KAAA,CAAC;IAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAI;AAC/B,QAAA,IAAI,CAAC,KAAK;AAAE,YAAA,OAAO,SAAS;AAE5B,QAAA,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;AAC3B,QAAA,MAAM,QAAQ,GACZ,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC,IAAI,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACpE,QAAA,MAAM,QAAQ,GAAG;YACf,SAAS,EAAE,oBAAoB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;YACvD,IAAI,QAAQ,IAAI;gBACd,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;aACjD,CAAC;SACH;QAED,OAAO;YACL,MAAM;AACN,YAAA,eAAe,EAAE,KAAK;YACtB,QAAQ;AACR,YAAA,IAAI,OAAO,CAAC,WAAW,IAAI;gBACzB,mBAAmB,EAAE,wBAAwB,CAAC;AAC5C,oBAAA,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE;oBAC3B,MAAM;iBACP,CAAC;aACH,CAAC;SACH;AACH,IAAA,CAAC,CAAC;AACJ;;"}
@@ -1 +1 @@
1
- {"version":3,"file":"getSnsDomainAddress.mjs","sources":["../../../src/domain/getSnsDomainAddress.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport {\r\n CENTRAL_STATE_DOMAIN_RECORDS,\r\n SNS_ROOT_DOMAIN_ACCOUNT,\r\n} from \"../constants/addresses\";\r\nimport { InvalidInputError } from \"../errors\";\r\nimport { RecordVersion } from \"../types/record\";\r\nimport { _deriveAddress } from \"../utils/deriveAddress\";\r\n\r\n/**\r\n * Parameters for deriving an SNS domain address.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSnsDomainAddressParams = { domain: \"example\" };\r\n * ```\r\n */\r\nexport interface GetSnsDomainAddressParams {\r\n /** TLD-less domain name. */\r\n domain: string;\r\n /** Record version. */\r\n record?: RecordVersion;\r\n}\r\n\r\n/**\r\n * A derived SNS domain address.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived: GetSnsDomainAddressResult = {\r\n * domainAddress,\r\n * isSub: false,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSnsDomainAddressResult {\r\n /** Derived account address. */\r\n domainAddress: Address;\r\n /** Parent domain address for subdomains. */\r\n parentAddress?: Address;\r\n /** Whether the input is a subdomain. */\r\n isSub: boolean;\r\n /** Whether the input is a subdomain record. */\r\n isSubRecord?: boolean;\r\n}\r\n\r\n/**\r\n * Derives the address of a domain, subdomain, or record account.\r\n *\r\n * @param params Derivation parameters\r\n * @param params.domain TLD-trimmed SNS domain name\r\n * @param params.record Optional record account version for record derivation\r\n * @returns Derived account address and metadata describing top-level, subdomain, or sub-record derivation.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived = await getSnsDomainAddress({ domain: \"example\" });\r\n * ```\r\n */\r\nexport const getSnsDomainAddress = async ({\r\n domain,\r\n record,\r\n}: GetSnsDomainAddressParams): Promise<GetSnsDomainAddressResult> => {\r\n const recordClass =\r\n record === RecordVersion.V2 ? CENTRAL_STATE_DOMAIN_RECORDS : undefined;\r\n const recordPrefix =\r\n {\r\n [RecordVersion.V2]: \"\\x02\",\r\n [RecordVersion.V1]: \"\\x01\",\r\n }[record as RecordVersion] || \"\\x00\";\r\n const splitted = domain.split(\".\");\r\n\r\n if (splitted.length === 2) {\r\n const parentAddress = await _deriveAddress(\r\n splitted[1],\r\n SNS_ROOT_DOMAIN_ACCOUNT\r\n );\r\n const domainAddress = await _deriveAddress(\r\n recordPrefix + splitted[0],\r\n parentAddress,\r\n recordClass\r\n );\r\n\r\n return { domainAddress, parentAddress, isSub: true };\r\n } else if (splitted.length === 3 && !!record) {\r\n // Parent domain\r\n const parentAddress = await _deriveAddress(\r\n splitted[2],\r\n SNS_ROOT_DOMAIN_ACCOUNT\r\n );\r\n\r\n // Sub domain\r\n const subAddress = await _deriveAddress(\"\\0\" + splitted[1], parentAddress);\r\n\r\n // Sub record\r\n const domainAddress = await _deriveAddress(\r\n recordPrefix + splitted[0],\r\n subAddress,\r\n recordClass\r\n );\r\n\r\n return { domainAddress, parentAddress, isSub: true, isSubRecord: true };\r\n } else if (splitted.length >= 3) {\r\n throw new InvalidInputError(\"The domain is malformed\");\r\n }\r\n\r\n const domainAddress = await _deriveAddress(domain, SNS_ROOT_DOMAIN_ACCOUNT);\r\n\r\n return { domainAddress, isSub: false };\r\n};\r\n"],"names":[],"mappings":";;;;;AA+CA;;;;;;;;;;;;AAYG;AACI,MAAM,mBAAmB,GAAG,OAAO,EACxC,MAAM,EACN,MAAM,GACoB,KAAwC;AAClE,IAAA,MAAM,WAAW,GACf,MAAM,KAAK,aAAa,CAAC,EAAE,GAAG,4BAA4B,GAAG,SAAS;AACxE,IAAA,MAAM,YAAY,GAChB;AACE,QAAA,CAAC,aAAa,CAAC,EAAE,GAAG,MAAM;AAC1B,QAAA,CAAC,aAAa,CAAC,EAAE,GAAG,MAAM;AAC3B,KAAA,CAAC,MAAuB,CAAC,IAAI,MAAM;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;AAElC,IAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;AACzB,QAAA,MAAM,aAAa,GAAG,MAAM,cAAc,CACxC,QAAQ,CAAC,CAAC,CAAC,EACX,uBAAuB,CACxB;AACD,QAAA,MAAM,aAAa,GAAG,MAAM,cAAc,CACxC,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAC1B,aAAa,EACb,WAAW,CACZ;QAED,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE;;SAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;;AAE5C,QAAA,MAAM,aAAa,GAAG,MAAM,cAAc,CACxC,QAAQ,CAAC,CAAC,CAAC,EACX,uBAAuB,CACxB;;AAGD,QAAA,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC;;AAG1E,QAAA,MAAM,aAAa,GAAG,MAAM,cAAc,CACxC,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAC1B,UAAU,EACV,WAAW,CACZ;AAED,QAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;;AAClE,SAAA,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE;AAC/B,QAAA,MAAM,IAAI,iBAAiB,CAAC,yBAAyB,CAAC;;IAGxD,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,uBAAuB,CAAC;AAE3E,IAAA,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE;AACxC;;;;"}
1
+ {"version":3,"file":"getSnsDomainAddress.mjs","sources":["../../../src/domain/getSnsDomainAddress.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport {\r\n CENTRAL_STATE_DOMAIN_RECORDS,\r\n SNS_ROOT_DOMAIN_ACCOUNT,\r\n} from \"../constants/addresses\";\r\nimport { InvalidInputError } from \"../errors\";\r\nimport { RecordVersion } from \"../types/record\";\r\nimport { _deriveAddress } from \"../utils/deriveAddress\";\r\n\r\n/**\r\n * Parameters for deriving an SNS domain address.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSnsDomainAddressParams = { domain: \"example\" };\r\n * ```\r\n */\r\nexport interface GetSnsDomainAddressParams {\r\n /** TLD-less domain name. */\r\n domain: string;\r\n /** Record version. */\r\n record?: RecordVersion;\r\n}\r\n\r\n/**\r\n * A derived SNS domain address.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived: GetSnsDomainAddressResult = {\r\n * domainAddress,\r\n * isSub: false,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSnsDomainAddressResult {\r\n /** Derived account address. */\r\n domainAddress: Address;\r\n /** Parent domain address for subdomains. */\r\n parentAddress?: Address;\r\n /** Whether the input is a subdomain. */\r\n isSub: boolean;\r\n /** Whether the input is a subdomain record. */\r\n isSubRecord?: boolean;\r\n}\r\n\r\n/**\r\n * Derives the address of a domain, subdomain, or record account.\r\n *\r\n * @param params Derivation parameters\r\n * @param params.domain TLD-trimmed SNS domain name\r\n * @param params.record Optional record account version for record derivation\r\n * @returns Derived account address and metadata describing top-level, subdomain, or sub-record derivation.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived = await getSnsDomainAddress({ domain: \"example\" });\r\n * ```\r\n */\r\nexport const getSnsDomainAddress = async ({\r\n domain,\r\n record,\r\n}: GetSnsDomainAddressParams): Promise<GetSnsDomainAddressResult> => {\r\n const recordClass =\r\n record === RecordVersion.V2 ? CENTRAL_STATE_DOMAIN_RECORDS : undefined;\r\n const recordPrefix =\r\n {\r\n [RecordVersion.V2]: \"\\x02\",\r\n [RecordVersion.V1]: \"\\x01\",\r\n }[record as RecordVersion] || \"\\x00\";\r\n const splitted = domain.split(\".\");\r\n\r\n if (splitted.length === 2) {\r\n const parentAddress = await _deriveAddress(\r\n splitted[1],\r\n SNS_ROOT_DOMAIN_ACCOUNT\r\n );\r\n const domainAddress = await _deriveAddress(\r\n recordPrefix + splitted[0],\r\n parentAddress,\r\n recordClass\r\n );\r\n\r\n return { domainAddress, parentAddress, isSub: true };\r\n } else if (splitted.length === 3 && !!record) {\r\n // Parent domain\r\n const parentAddress = await _deriveAddress(\r\n splitted[2],\r\n SNS_ROOT_DOMAIN_ACCOUNT\r\n );\r\n\r\n // Sub domain\r\n const subAddress = await _deriveAddress(\"\\0\" + splitted[1], parentAddress);\r\n\r\n // Sub record\r\n const domainAddress = await _deriveAddress(\r\n recordPrefix + splitted[0],\r\n subAddress,\r\n recordClass\r\n );\r\n\r\n return { domainAddress, parentAddress, isSub: true, isSubRecord: true };\r\n } else if (splitted.length >= 3) {\r\n throw new InvalidInputError(\"The domain is malformed\");\r\n }\r\n\r\n const domainAddress = await _deriveAddress(domain, SNS_ROOT_DOMAIN_ACCOUNT);\r\n\r\n return { domainAddress, isSub: false };\r\n};\r\n"],"names":[],"mappings":";;;;;AA+CA;;;;;;;;;;;;AAYG;AACI,MAAM,mBAAmB,GAAG,OAAO,EACxC,MAAM,EACN,MAAM,GACoB,KAAwC;AAClE,IAAA,MAAM,WAAW,GACf,MAAM,KAAK,aAAa,CAAC,EAAE,GAAG,4BAA4B,GAAG,SAAS;AACxE,IAAA,MAAM,YAAY,GAChB;AACE,QAAA,CAAC,aAAa,CAAC,EAAE,GAAG,MAAM;AAC1B,QAAA,CAAC,aAAa,CAAC,EAAE,GAAG,MAAM;AAC3B,KAAA,CAAC,MAAuB,CAAC,IAAI,MAAM;IACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;AAElC,IAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;AACzB,QAAA,MAAM,aAAa,GAAG,MAAM,cAAc,CACxC,QAAQ,CAAC,CAAC,CAAC,EACX,uBAAuB,CACxB;AACD,QAAA,MAAM,aAAa,GAAG,MAAM,cAAc,CACxC,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAC1B,aAAa,EACb,WAAW,CACZ;QAED,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE;IACtD;SAAO,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;;AAE5C,QAAA,MAAM,aAAa,GAAG,MAAM,cAAc,CACxC,QAAQ,CAAC,CAAC,CAAC,EACX,uBAAuB,CACxB;;AAGD,QAAA,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC;;AAG1E,QAAA,MAAM,aAAa,GAAG,MAAM,cAAc,CACxC,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,EAC1B,UAAU,EACV,WAAW,CACZ;AAED,QAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;IACzE;AAAO,SAAA,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE;AAC/B,QAAA,MAAM,IAAI,iBAAiB,CAAC,yBAAyB,CAAC;IACxD;IAEA,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,uBAAuB,CAAC;AAE3E,IAAA,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE;AACxC;;"}
@@ -3,8 +3,7 @@ import { RegistryState } from '../states/registry.mjs';
3
3
  import { getSnsDomainAddress } from './getSnsDomainAddress.mjs';
4
4
 
5
5
  /**
6
- * Resolves the owner of a TLD-trimmed SNS domain without applying public
7
- * TLD-support or legacy `.sol` cutoff policy.
6
+ * Resolves the owner of a TLD-trimmed `.sns` domain.
8
7
  *
9
8
  * This internal helper is intended for public read methods that have already
10
9
  * validated and trimmed the full domain name.
@@ -1 +1 @@
1
- {"version":3,"file":"getSnsDomainOwner.mjs","sources":["../../../src/domain/getSnsDomainOwner.ts"],"sourcesContent":["import {\r\n GetAccountInfoApi,\r\n GetTokenLargestAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { getSnsNftOwner } from \"../nft/getSnsNftOwner\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { getSnsDomainAddress } from \"./getSnsDomainAddress\";\r\n\r\ninterface GetSnsDomainOwnerParams {\r\n rpc: Rpc<GetAccountInfoApi & GetTokenLargestAccountsApi>;\r\n domain: string;\r\n}\r\n\r\n/**\r\n * Resolves the owner of a TLD-trimmed SNS domain without applying public\r\n * TLD-support or legacy `.sol` cutoff policy.\r\n *\r\n * This internal helper is intended for public read methods that have already\r\n * validated and trimmed the full domain name.\r\n *\r\n * @param params Owner retrieval parameters\r\n * @param params.rpc RPC client implementing account and token-largest-account APIs\r\n * @param params.domain TLD-trimmed SNS domain name\r\n * @returns The tokenized domain owner when present, otherwise the registry owner\r\n */\r\nexport const _getSnsDomainOwner = async ({\r\n rpc,\r\n domain,\r\n}: GetSnsDomainOwnerParams) => {\r\n const { domainAddress } = await getSnsDomainAddress({ domain });\r\n const [registry, nftOwner] = await Promise.all([\r\n RegistryState.retrieve(rpc, domainAddress),\r\n getSnsNftOwner({ rpc, domainAddress }),\r\n ]);\r\n return nftOwner || registry.owner;\r\n};\r\n"],"names":[],"mappings":";;;;AAeA;;;;;;;;;;;AAWG;AACI,MAAM,kBAAkB,GAAG,OAAO,EACvC,GAAG,EACH,MAAM,GACkB,KAAI;IAC5B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;AAC7C,QAAA,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;AAC1C,QAAA,cAAc,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;AACvC,KAAA,CAAC;AACF,IAAA,OAAO,QAAQ,IAAI,QAAQ,CAAC,KAAK;AACnC;;;;"}
1
+ {"version":3,"file":"getSnsDomainOwner.mjs","sources":["../../../src/domain/getSnsDomainOwner.ts"],"sourcesContent":["import {\r\n GetAccountInfoApi,\r\n GetTokenLargestAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { getSnsNftOwner } from \"../nft/getSnsNftOwner\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { getSnsDomainAddress } from \"./getSnsDomainAddress\";\r\n\r\ninterface GetSnsDomainOwnerParams {\r\n rpc: Rpc<GetAccountInfoApi & GetTokenLargestAccountsApi>;\r\n domain: string;\r\n}\r\n\r\n/**\r\n * Resolves the owner of a TLD-trimmed `.sns` domain.\r\n *\r\n * This internal helper is intended for public read methods that have already\r\n * validated and trimmed the full domain name.\r\n *\r\n * @param params Owner retrieval parameters\r\n * @param params.rpc RPC client implementing account and token-largest-account APIs\r\n * @param params.domain TLD-trimmed SNS domain name\r\n * @returns The tokenized domain owner when present, otherwise the registry owner\r\n */\r\nexport const _getSnsDomainOwner = async ({\r\n rpc,\r\n domain,\r\n}: GetSnsDomainOwnerParams) => {\r\n const { domainAddress } = await getSnsDomainAddress({ domain });\r\n const [registry, nftOwner] = await Promise.all([\r\n RegistryState.retrieve(rpc, domainAddress),\r\n getSnsNftOwner({ rpc, domainAddress }),\r\n ]);\r\n return nftOwner || registry.owner;\r\n};\r\n"],"names":[],"mappings":";;;;AAeA;;;;;;;;;;AAUG;AACI,MAAM,kBAAkB,GAAG,OAAO,EACvC,GAAG,EACH,MAAM,GACkB,KAAI;IAC5B,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/D,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;AAC7C,QAAA,aAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;AAC1C,QAAA,cAAc,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;AACvC,KAAA,CAAC;AACF,IAAA,OAAO,QAAQ,IAAI,QAAQ,CAAC,KAAK;AACnC;;"}
@@ -0,0 +1,32 @@
1
+ import { getProgramDerivedAddress } from '@solana/kit';
2
+ import { utf8Codec, addressCodec } from '../codecs.mjs';
3
+ import { SRS_PROGRAM_ADDRESS, SOL_SRS_CLASS } from '../constants/addresses.mjs';
4
+ import { SRS_HASH_PREFIX } from '../constants/srs.mjs';
5
+
6
+ /**
7
+ * Derives the canonical SRS record address for a TLD-trimmed `.sol` name.
8
+ *
9
+ * @param params Derivation parameters
10
+ * @param params.domain TLD-trimmed `.sol` domain name
11
+ * @returns The SRS record address and canonical name hash.
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * const derived = await getSolDomainAddress({ domain: "example" });
16
+ * ```
17
+ */
18
+ const getSolDomainAddress = async ({ domain, }) => {
19
+ const hashed = new Uint8Array(await crypto.subtle.digest("SHA-256", utf8Codec.encode(SRS_HASH_PREFIX + domain)));
20
+ const [domainAddress] = await getProgramDerivedAddress({
21
+ programAddress: SRS_PROGRAM_ADDRESS,
22
+ seeds: [
23
+ utf8Codec.encode("record"),
24
+ addressCodec.encode(SOL_SRS_CLASS),
25
+ hashed,
26
+ ],
27
+ });
28
+ return { domainAddress, hashed };
29
+ };
30
+
31
+ export { getSolDomainAddress };
32
+ //# sourceMappingURL=getSolDomainAddress.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"getSolDomainAddress.mjs","sources":["../../../src/domain/getSolDomainAddress.ts"],"sourcesContent":["import { Address, getProgramDerivedAddress } from \"@solana/kit\";\r\n\r\nimport { addressCodec, utf8Codec } from \"../codecs\";\r\nimport { SOL_SRS_CLASS, SRS_PROGRAM_ADDRESS } from \"../constants/addresses\";\r\nimport { SRS_HASH_PREFIX } from \"../constants/srs\";\r\n\r\n/**\r\n * Parameters for deriving an SRS `.sol` domain address.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSolDomainAddressParams = { domain: \"example\" };\r\n * ```\r\n */\r\nexport interface GetSolDomainAddressParams {\r\n /** TLD-trimmed `.sol` domain name. */\r\n domain: string;\r\n}\r\n\r\n/**\r\n * A derived SRS `.sol` domain address and canonical name hash.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived: GetSolDomainAddressResult = { domainAddress, hashed };\r\n * ```\r\n */\r\nexport interface GetSolDomainAddressResult {\r\n /** Derived SRS record address. */\r\n domainAddress: Address;\r\n /** SHA-256 hash of the canonical name. */\r\n hashed: Uint8Array;\r\n}\r\n\r\n/**\r\n * Derives the canonical SRS record address for a TLD-trimmed `.sol` name.\r\n *\r\n * @param params Derivation parameters\r\n * @param params.domain TLD-trimmed `.sol` domain name\r\n * @returns The SRS record address and canonical name hash.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived = await getSolDomainAddress({ domain: \"example\" });\r\n * ```\r\n */\r\nexport const getSolDomainAddress = async ({\r\n domain,\r\n}: GetSolDomainAddressParams): Promise<GetSolDomainAddressResult> => {\r\n const hashed = new Uint8Array(\r\n await crypto.subtle.digest(\r\n \"SHA-256\",\r\n utf8Codec.encode(SRS_HASH_PREFIX + domain)\r\n )\r\n );\r\n const [domainAddress] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [\r\n utf8Codec.encode(\"record\"),\r\n addressCodec.encode(SOL_SRS_CLASS),\r\n hashed,\r\n ],\r\n });\r\n\r\n return { domainAddress, hashed };\r\n};\r\n"],"names":[],"mappings":";;;;;AAkCA;;;;;;;;;;;AAWG;AACI,MAAM,mBAAmB,GAAG,OAAO,EACxC,MAAM,GACoB,KAAwC;IAClE,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CACxB,SAAS,EACT,SAAS,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,CAC3C,CACF;AACD,IAAA,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,wBAAwB,CAAC;AACrD,QAAA,cAAc,EAAE,mBAAmB;AACnC,QAAA,KAAK,EAAE;AACL,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAC1B,YAAA,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC;YAClC,MAAM;AACP,SAAA;AACF,KAAA,CAAC;AAEF,IAAA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE;AAClC;;"}
@@ -1,13 +1,11 @@
1
- import { getProgramDerivedAddress } from '@solana/kit';
2
- import { utf8Codec, addressCodec } from '../codecs.mjs';
3
- import { SRS_HASH_PREFIX, SRS_PROGRAM_ADDRESS } from '../config.mjs';
4
- import { SOL_SRS_CLASS } from '../constants/addresses.mjs';
1
+ import { getSolDomainAddress } from './getSolDomainAddress.mjs';
5
2
 
6
3
  /**
7
4
  * Derives the canonical SRS record address for a TLD-trimmed `.sol` name.
8
5
  *
6
+ * @deprecated Use {@link getSolDomainAddress} instead.
9
7
  * @param params Derivation parameters
10
- * @param params.domain TLD-trimmed `.sol` name
8
+ * @param params.domain TLD-trimmed `.sol` domain name
11
9
  * @returns The SRS record address and canonical name hash.
12
10
  *
13
11
  * @example
@@ -15,18 +13,7 @@ import { SOL_SRS_CLASS } from '../constants/addresses.mjs';
15
13
  * const derived = await getSrsDomainAddress({ domain: "example" });
16
14
  * ```
17
15
  */
18
- const getSrsDomainAddress = async ({ domain, }) => {
19
- const hashed = new Uint8Array(await crypto.subtle.digest("SHA-256", utf8Codec.encode(SRS_HASH_PREFIX + domain)));
20
- const [domainAddress] = await getProgramDerivedAddress({
21
- programAddress: SRS_PROGRAM_ADDRESS,
22
- seeds: [
23
- utf8Codec.encode("record"),
24
- addressCodec.encode(SOL_SRS_CLASS),
25
- hashed,
26
- ],
27
- });
28
- return { domainAddress, hashed };
29
- };
16
+ const getSrsDomainAddress = getSolDomainAddress;
30
17
 
31
18
  export { getSrsDomainAddress };
32
19
  //# sourceMappingURL=getSrsDomainAddress.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"getSrsDomainAddress.mjs","sources":["../../../src/domain/getSrsDomainAddress.ts"],"sourcesContent":["import { Address, getProgramDerivedAddress } from \"@solana/kit\";\r\n\r\nimport { addressCodec, utf8Codec } from \"../codecs\";\r\nimport { SRS_HASH_PREFIX, SRS_PROGRAM_ADDRESS } from \"../config\";\r\nimport { SOL_SRS_CLASS } from \"../constants/addresses\";\r\n\r\n/**\r\n * Parameters for deriving an SRS domain address.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSrsDomainAddressParams = { domain: \"example\" };\r\n * ```\r\n */\r\nexport interface GetSrsDomainAddressParams {\r\n /** TLD-less `.sol` domain name. */\r\n domain: string;\r\n}\r\n\r\n/**\r\n * A derived SRS domain address.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived: GetSrsDomainAddressResult = { domainAddress, hashed };\r\n * ```\r\n */\r\nexport interface GetSrsDomainAddressResult {\r\n /** Derived SRS record address. */\r\n domainAddress: Address;\r\n /** SHA-256 hash of the canonical name. */\r\n hashed: Uint8Array;\r\n}\r\n\r\n/**\r\n * Derives the canonical SRS record address for a TLD-trimmed `.sol` name.\r\n *\r\n * @param params Derivation parameters\r\n * @param params.domain TLD-trimmed `.sol` name\r\n * @returns The SRS record address and canonical name hash.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived = await getSrsDomainAddress({ domain: \"example\" });\r\n * ```\r\n */\r\nexport const getSrsDomainAddress = async ({\r\n domain,\r\n}: GetSrsDomainAddressParams): Promise<GetSrsDomainAddressResult> => {\r\n const hashed = new Uint8Array(\r\n await crypto.subtle.digest(\r\n \"SHA-256\",\r\n utf8Codec.encode(SRS_HASH_PREFIX + domain)\r\n )\r\n );\r\n const [domainAddress] = await getProgramDerivedAddress({\r\n programAddress: SRS_PROGRAM_ADDRESS,\r\n seeds: [\r\n utf8Codec.encode(\"record\"),\r\n addressCodec.encode(SOL_SRS_CLASS),\r\n hashed,\r\n ],\r\n });\r\n\r\n return { domainAddress, hashed };\r\n};\r\n"],"names":[],"mappings":";;;;;AAkCA;;;;;;;;;;;AAWG;AACU,MAAA,mBAAmB,GAAG,OAAO,EACxC,MAAM,GACoB,KAAwC;IAClE,MAAM,MAAM,GAAG,IAAI,UAAU,CAC3B,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CACxB,SAAS,EACT,SAAS,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,CAC3C,CACF;AACD,IAAA,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,wBAAwB,CAAC;AACrD,QAAA,cAAc,EAAE,mBAAmB;AACnC,QAAA,KAAK,EAAE;AACL,YAAA,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC;AAC1B,YAAA,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC;YAClC,MAAM;AACP,SAAA;AACF,KAAA,CAAC;AAEF,IAAA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE;AAClC;;;;"}
1
+ {"version":3,"file":"getSrsDomainAddress.mjs","sources":["../../../src/domain/getSrsDomainAddress.ts"],"sourcesContent":["import { getSolDomainAddress } from \"./getSolDomainAddress\";\r\nimport type {\r\n GetSolDomainAddressParams,\r\n GetSolDomainAddressResult,\r\n} from \"./getSolDomainAddress\";\r\n\r\n/** @deprecated Use `GetSolDomainAddressParams` instead. */\r\nexport type GetSrsDomainAddressParams = GetSolDomainAddressParams;\r\n\r\n/** @deprecated Use `GetSolDomainAddressResult` instead. */\r\nexport type GetSrsDomainAddressResult = GetSolDomainAddressResult;\r\n\r\n/**\r\n * Derives the canonical SRS record address for a TLD-trimmed `.sol` name.\r\n *\r\n * @deprecated Use {@link getSolDomainAddress} instead.\r\n * @param params Derivation parameters\r\n * @param params.domain TLD-trimmed `.sol` domain name\r\n * @returns The SRS record address and canonical name hash.\r\n *\r\n * @example\r\n * ```ts\r\n * const derived = await getSrsDomainAddress({ domain: \"example\" });\r\n * ```\r\n */\r\nexport const getSrsDomainAddress = getSolDomainAddress;\r\n"],"names":[],"mappings":";;AAYA;;;;;;;;;;;;AAYG;AACI,MAAM,mBAAmB,GAAG;;"}
@@ -1,8 +1,8 @@
1
1
  import { base64Codec, addressCodec } from '../codecs.mjs';
2
2
  import { NAME_PROGRAM_ADDRESS, REVERSE_LOOKUP_CLASS } from '../constants/addresses.mjs';
3
- import { assertTldSupported } from '../utils/assertTldSupported.mjs';
4
3
  import { deserializeReverse } from '../utils/deserializers/deserializeReverse.mjs';
5
4
  import { getReverseAddressFromDomainAddress } from '../utils/getReverseAddressFromDomainAddress.mjs';
5
+ import { _parseSnsTopLevelDomain } from '../utils/parseSnsDomain.mjs';
6
6
  import { getSnsDomainAddress } from './getSnsDomainAddress.mjs';
7
7
 
8
8
  /**
@@ -13,7 +13,7 @@ import { getSnsDomainAddress } from './getSnsDomainAddress.mjs';
13
13
  *
14
14
  * @param params Subdomain retrieval parameters
15
15
  * @param params.rpc RPC client implementing program account lookup
16
- * @param params.domain Full parent domain name including a `.sns` or `.sol` suffix
16
+ * @param params.domain Full `.sns` parent domain name
17
17
  * @returns Subdomain names and owner addresses.
18
18
  *
19
19
  * @example
@@ -22,7 +22,7 @@ import { getSnsDomainAddress } from './getSnsDomainAddress.mjs';
22
22
  * ```
23
23
  */
24
24
  const getSubdomains = async ({ rpc, domain, }) => {
25
- const [trimmedDomain] = await assertTldSupported({ rpc, domain });
25
+ const trimmedDomain = _parseSnsTopLevelDomain(domain);
26
26
  const { domainAddress, isSub } = await getSnsDomainAddress({
27
27
  domain: trimmedDomain,
28
28
  });
@@ -1 +1 @@
1
- {"version":3,"file":"getSubdomains.mjs","sources":["../../../src/domain/getSubdomains.ts"],"sourcesContent":["import {\r\n Address,\r\n Base58EncodedBytes,\r\n GetProgramAccountsApi,\r\n GetSlotApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { addressCodec, base64Codec } from \"../codecs\";\r\nimport {\r\n NAME_PROGRAM_ADDRESS,\r\n REVERSE_LOOKUP_CLASS,\r\n} from \"../constants/addresses\";\r\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\r\nimport { deserializeReverse } from \"../utils/deserializers/deserializeReverse\";\r\nimport { getReverseAddressFromDomainAddress } from \"../utils/getReverseAddressFromDomainAddress\";\r\nimport { getSnsDomainAddress } from \"./getSnsDomainAddress\";\r\n\r\n/**\r\n * Parameters for retrieving subdomains under a parent domain.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSubdomainsParams = {\r\n * rpc,\r\n * domain: \"example.sns\",\r\n * };\r\n * ```\r\n */\r\nexport interface GetSubdomainsParams {\r\n /** RPC client. */\r\n rpc: Rpc<GetProgramAccountsApi & GetSlotApi>;\r\n /** Full parent domain name, including its `.sns` or `.sol` suffix. */\r\n domain: string;\r\n}\r\n\r\n/**\r\n * A subdomain and the owner recorded in its name registry.\r\n *\r\n * @example\r\n * ```ts\r\n * const subdomain: GetSubdomainsResult = {\r\n * subdomain: \"blog\",\r\n * owner: \"Fxuoy3gFjfJALhwkRcuKjRdechcgffUApeYAfMWck6w8\" as Address,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSubdomainsResult {\r\n /** TLD-less label recorded by the subdomain's reverse lookup account. */\r\n subdomain: string;\r\n /** Owner address stored in the subdomain's name registry account. */\r\n owner: Address;\r\n}\r\n\r\n/**\r\n * Retrieves subdomains under a parent domain, including their owners.\r\n *\r\n * Entries without reverse lookup data are omitted. Passing a subdomain returns\r\n * an empty array.\r\n *\r\n * @param params Subdomain retrieval parameters\r\n * @param params.rpc RPC client implementing program account lookup\r\n * @param params.domain Full parent domain name including a `.sns` or `.sol` suffix\r\n * @returns Subdomain names and owner addresses.\r\n *\r\n * @example\r\n * ```ts\r\n * const subdomains = await getSubdomains({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const getSubdomains = async ({\r\n rpc,\r\n domain,\r\n}: GetSubdomainsParams): Promise<GetSubdomainsResult[]> => {\r\n const [trimmedDomain] = await assertTldSupported({ rpc, domain });\r\n const { domainAddress, isSub } = await getSnsDomainAddress({\r\n domain: trimmedDomain,\r\n });\r\n\r\n if (isSub) return [];\r\n\r\n const getReversesAsync = rpc\r\n .getProgramAccounts(NAME_PROGRAM_ADDRESS, {\r\n encoding: \"base64\",\r\n filters: [\r\n {\r\n memcmp: {\r\n offset: 0n,\r\n bytes: domainAddress as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n {\r\n memcmp: {\r\n offset: 64n,\r\n bytes: REVERSE_LOOKUP_CLASS as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n ],\r\n })\r\n .send();\r\n\r\n const getSubsAsync = rpc\r\n .getProgramAccounts(NAME_PROGRAM_ADDRESS, {\r\n encoding: \"base64\",\r\n filters: [\r\n {\r\n memcmp: {\r\n offset: 0n,\r\n bytes: domainAddress as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n ],\r\n dataSlice: { offset: 32, length: 32 },\r\n })\r\n .send();\r\n\r\n const [reverses, subs] = await Promise.all([getReversesAsync, getSubsAsync]);\r\n\r\n const map = new Map<string, string | undefined>(\r\n reverses.map((e) => [\r\n e.pubkey,\r\n deserializeReverse({\r\n data: base64Codec.encode(e.account.data[0]).slice(96),\r\n trimFirstNullByte: true,\r\n }),\r\n ])\r\n );\r\n\r\n const result = await Promise.all(\r\n subs.map((sub) =>\r\n getReverseAddressFromDomainAddress({\r\n domainAddress: sub.pubkey,\r\n parentAddress: domainAddress,\r\n }).then((revKey) => {\r\n const subdomain = map.get(revKey);\r\n return subdomain\r\n ? {\r\n subdomain,\r\n owner: addressCodec.decode(\r\n base64Codec.encode(sub.account.data[0])\r\n ),\r\n }\r\n : undefined;\r\n })\r\n )\r\n );\r\n\r\n const filteredResult = result.filter((sub) => sub !== undefined);\r\n\r\n return filteredResult;\r\n};\r\n"],"names":[],"mappings":";;;;;;;AAsDA;;;;;;;;;;;;;;;AAeG;AACI,MAAM,aAAa,GAAG,OAAO,EAClC,GAAG,EACH,MAAM,GACc,KAAoC;AACxD,IAAA,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACjE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,MAAM,mBAAmB,CAAC;AACzD,QAAA,MAAM,EAAE,aAAa;AACtB,KAAA,CAAC;AAEF,IAAA,IAAI,KAAK;AAAE,QAAA,OAAO,EAAE;IAEpB,MAAM,gBAAgB,GAAG;SACtB,kBAAkB,CAAC,oBAAoB,EAAE;AACxC,QAAA,QAAQ,EAAE,QAAQ;AAClB,QAAA,OAAO,EAAE;AACP,YAAA;AACE,gBAAA,MAAM,EAAE;AACN,oBAAA,MAAM,EAAE,EAAE;AACV,oBAAA,KAAK,EAAE,aAA6C;AACpD,oBAAA,QAAQ,EAAE,QAAQ;AACnB,iBAAA;AACF,aAAA;AACD,YAAA;AACE,gBAAA,MAAM,EAAE;AACN,oBAAA,MAAM,EAAE,GAAG;AACX,oBAAA,KAAK,EAAE,oBAAoD;AAC3D,oBAAA,QAAQ,EAAE,QAAQ;AACnB,iBAAA;AACF,aAAA;AACF,SAAA;KACF;AACA,SAAA,IAAI,EAAE;IAET,MAAM,YAAY,GAAG;SAClB,kBAAkB,CAAC,oBAAoB,EAAE;AACxC,QAAA,QAAQ,EAAE,QAAQ;AAClB,QAAA,OAAO,EAAE;AACP,YAAA;AACE,gBAAA,MAAM,EAAE;AACN,oBAAA,MAAM,EAAE,EAAE;AACV,oBAAA,KAAK,EAAE,aAA6C;AACpD,oBAAA,QAAQ,EAAE,QAAQ;AACnB,iBAAA;AACF,aAAA;AACF,SAAA;QACD,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;KACtC;AACA,SAAA,IAAI,EAAE;AAET,IAAA,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;AAE5E,IAAA,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK;AAClB,QAAA,CAAC,CAAC,MAAM;AACR,QAAA,kBAAkB,CAAC;AACjB,YAAA,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;AACrD,YAAA,iBAAiB,EAAE,IAAI;SACxB,CAAC;AACH,KAAA,CAAC,CACH;AAED,IAAA,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KACX,kCAAkC,CAAC;QACjC,aAAa,EAAE,GAAG,CAAC,MAAM;AACzB,QAAA,aAAa,EAAE,aAAa;AAC7B,KAAA,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAI;QACjB,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;AACjC,QAAA,OAAO;AACL,cAAE;gBACE,SAAS;AACT,gBAAA,KAAK,EAAE,YAAY,CAAC,MAAM,CACxB,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CACxC;AACF;cACD,SAAS;KACd,CAAC,CACH,CACF;AAED,IAAA,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,GAAG,KAAK,SAAS,CAAC;AAEhE,IAAA,OAAO,cAAc;AACvB;;;;"}
1
+ {"version":3,"file":"getSubdomains.mjs","sources":["../../../src/domain/getSubdomains.ts"],"sourcesContent":["import {\r\n Address,\r\n Base58EncodedBytes,\r\n GetProgramAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { addressCodec, base64Codec } from \"../codecs\";\r\nimport {\r\n NAME_PROGRAM_ADDRESS,\r\n REVERSE_LOOKUP_CLASS,\r\n} from \"../constants/addresses\";\r\nimport { deserializeReverse } from \"../utils/deserializers/deserializeReverse\";\r\nimport { getReverseAddressFromDomainAddress } from \"../utils/getReverseAddressFromDomainAddress\";\r\nimport { _parseSnsTopLevelDomain } from \"../utils/parseSnsDomain\";\r\nimport { getSnsDomainAddress } from \"./getSnsDomainAddress\";\r\n\r\n/**\r\n * Parameters for retrieving subdomains under a parent domain.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetSubdomainsParams = {\r\n * rpc,\r\n * domain: \"example.sns\",\r\n * };\r\n * ```\r\n */\r\nexport interface GetSubdomainsParams {\r\n /** RPC client. */\r\n rpc: Rpc<GetProgramAccountsApi>;\r\n /** Full `.sns` parent domain name. */\r\n domain: string;\r\n}\r\n\r\n/**\r\n * A subdomain and the owner recorded in its name registry.\r\n *\r\n * @example\r\n * ```ts\r\n * const subdomain: GetSubdomainsResult = {\r\n * subdomain: \"blog\",\r\n * owner: \"Fxuoy3gFjfJALhwkRcuKjRdechcgffUApeYAfMWck6w8\" as Address,\r\n * };\r\n * ```\r\n */\r\nexport interface GetSubdomainsResult {\r\n /** TLD-less label recorded by the subdomain's reverse lookup account. */\r\n subdomain: string;\r\n /** Owner address stored in the subdomain's name registry account. */\r\n owner: Address;\r\n}\r\n\r\n/**\r\n * Retrieves subdomains under a parent domain, including their owners.\r\n *\r\n * Entries without reverse lookup data are omitted. Passing a subdomain returns\r\n * an empty array.\r\n *\r\n * @param params Subdomain retrieval parameters\r\n * @param params.rpc RPC client implementing program account lookup\r\n * @param params.domain Full `.sns` parent domain name\r\n * @returns Subdomain names and owner addresses.\r\n *\r\n * @example\r\n * ```ts\r\n * const subdomains = await getSubdomains({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const getSubdomains = async ({\r\n rpc,\r\n domain,\r\n}: GetSubdomainsParams): Promise<GetSubdomainsResult[]> => {\r\n const trimmedDomain = _parseSnsTopLevelDomain(domain);\r\n const { domainAddress, isSub } = await getSnsDomainAddress({\r\n domain: trimmedDomain,\r\n });\r\n\r\n if (isSub) return [];\r\n\r\n const getReversesAsync = rpc\r\n .getProgramAccounts(NAME_PROGRAM_ADDRESS, {\r\n encoding: \"base64\",\r\n filters: [\r\n {\r\n memcmp: {\r\n offset: 0n,\r\n bytes: domainAddress as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n {\r\n memcmp: {\r\n offset: 64n,\r\n bytes: REVERSE_LOOKUP_CLASS as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n ],\r\n })\r\n .send();\r\n\r\n const getSubsAsync = rpc\r\n .getProgramAccounts(NAME_PROGRAM_ADDRESS, {\r\n encoding: \"base64\",\r\n filters: [\r\n {\r\n memcmp: {\r\n offset: 0n,\r\n bytes: domainAddress as string as Base58EncodedBytes,\r\n encoding: \"base58\",\r\n },\r\n },\r\n ],\r\n dataSlice: { offset: 32, length: 32 },\r\n })\r\n .send();\r\n\r\n const [reverses, subs] = await Promise.all([getReversesAsync, getSubsAsync]);\r\n\r\n const map = new Map<string, string | undefined>(\r\n reverses.map((e) => [\r\n e.pubkey,\r\n deserializeReverse({\r\n data: base64Codec.encode(e.account.data[0]).slice(96),\r\n trimFirstNullByte: true,\r\n }),\r\n ])\r\n );\r\n\r\n const result = await Promise.all(\r\n subs.map((sub) =>\r\n getReverseAddressFromDomainAddress({\r\n domainAddress: sub.pubkey,\r\n parentAddress: domainAddress,\r\n }).then((revKey) => {\r\n const subdomain = map.get(revKey);\r\n return subdomain\r\n ? {\r\n subdomain,\r\n owner: addressCodec.decode(\r\n base64Codec.encode(sub.account.data[0])\r\n ),\r\n }\r\n : undefined;\r\n })\r\n )\r\n );\r\n\r\n const filteredResult = result.filter((sub) => sub !== undefined);\r\n\r\n return filteredResult;\r\n};\r\n"],"names":[],"mappings":";;;;;;;AAqDA;;;;;;;;;;;;;;;AAeG;AACI,MAAM,aAAa,GAAG,OAAO,EAClC,GAAG,EACH,MAAM,GACc,KAAoC;AACxD,IAAA,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACrD,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,MAAM,mBAAmB,CAAC;AACzD,QAAA,MAAM,EAAE,aAAa;AACtB,KAAA,CAAC;AAEF,IAAA,IAAI,KAAK;AAAE,QAAA,OAAO,EAAE;IAEpB,MAAM,gBAAgB,GAAG;SACtB,kBAAkB,CAAC,oBAAoB,EAAE;AACxC,QAAA,QAAQ,EAAE,QAAQ;AAClB,QAAA,OAAO,EAAE;AACP,YAAA;AACE,gBAAA,MAAM,EAAE;AACN,oBAAA,MAAM,EAAE,EAAE;AACV,oBAAA,KAAK,EAAE,aAA6C;AACpD,oBAAA,QAAQ,EAAE,QAAQ;AACnB,iBAAA;AACF,aAAA;AACD,YAAA;AACE,gBAAA,MAAM,EAAE;AACN,oBAAA,MAAM,EAAE,GAAG;AACX,oBAAA,KAAK,EAAE,oBAAoD;AAC3D,oBAAA,QAAQ,EAAE,QAAQ;AACnB,iBAAA;AACF,aAAA;AACF,SAAA;KACF;AACA,SAAA,IAAI,EAAE;IAET,MAAM,YAAY,GAAG;SAClB,kBAAkB,CAAC,oBAAoB,EAAE;AACxC,QAAA,QAAQ,EAAE,QAAQ;AAClB,QAAA,OAAO,EAAE;AACP,YAAA;AACE,gBAAA,MAAM,EAAE;AACN,oBAAA,MAAM,EAAE,EAAE;AACV,oBAAA,KAAK,EAAE,aAA6C;AACpD,oBAAA,QAAQ,EAAE,QAAQ;AACnB,iBAAA;AACF,aAAA;AACF,SAAA;QACD,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;KACtC;AACA,SAAA,IAAI,EAAE;AAET,IAAA,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;AAE5E,IAAA,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK;AAClB,QAAA,CAAC,CAAC,MAAM;AACR,QAAA,kBAAkB,CAAC;AACjB,YAAA,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;AACrD,YAAA,iBAAiB,EAAE,IAAI;SACxB,CAAC;AACH,KAAA,CAAC,CACH;AAED,IAAA,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KACX,kCAAkC,CAAC;QACjC,aAAa,EAAE,GAAG,CAAC,MAAM;AACzB,QAAA,aAAa,EAAE,aAAa;AAC7B,KAAA,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAI;QACjB,MAAM,SAAS,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;AACjC,QAAA,OAAO;AACL,cAAE;gBACE,SAAS;AACT,gBAAA,KAAK,EAAE,YAAY,CAAC,MAAM,CACxB,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CACxC;AACF;cACD,SAAS;IACf,CAAC,CAAC,CACH,CACF;AAED,IAAA,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,GAAG,KAAK,SAAS,CAAC;AAEhE,IAAA,OAAO,cAAc;AACvB;;"}
@@ -1,5 +1,7 @@
1
1
  export { getAllSnsDomains } from './getAllSnsDomains.mjs';
2
+ export { getAllSolDomains } from './getAllSolDomains.mjs';
2
3
  export { getSnsDomainAddress } from './getSnsDomainAddress.mjs';
4
+ export { getSolDomainAddress } from './getSolDomainAddress.mjs';
3
5
  export { getSrsDomainAddress } from './getSrsDomainAddress.mjs';
4
6
  export { getDomainOwner } from './getDomainOwner.mjs';
5
7
  export { getDomainRecord } from './getDomainRecord.mjs';
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}
1
+ {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}
@@ -1,20 +1,18 @@
1
- import { SOL_SRS_RESOLUTION_ENABLED } from '../config.mjs';
2
- import { UnsupportedTldError } from '../errors.mjs';
3
- import { assertTldSupported } from '../utils/assertTldSupported.mjs';
1
+ import { UnsupportedTldError, SnsSolResolutionMismatchError } from '../errors.mjs';
4
2
  import { SOL_TLD, parseSupportedTld, SNS_TLD } from '../utils/tld.mjs';
5
3
  import { resolveSns } from './resolveSns.mjs';
4
+ import { resolveSol } from './resolveSol.mjs';
6
5
 
7
6
  /**
8
7
  * Resolves a `.sns` or `.sol` domain to its target address.
9
8
  *
10
9
  * @param params Resolution parameters
11
- * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs
10
+ * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs
12
11
  * @param params.domain Full domain name including a `.sns` or `.sol` suffix
13
12
  * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`
14
13
  * @returns The resolved target address.
15
14
  *
16
- * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and
17
- * corresponding SNS targets match when SRS-backed resolution is enabled.
15
+ * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and corresponding SNS targets match.
18
16
  *
19
17
  * @example
20
18
  * ```ts
@@ -24,8 +22,7 @@ import { resolveSns } from './resolveSns.mjs';
24
22
  const resolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
25
23
  if (domain.endsWith(SOL_TLD)) {
26
24
  const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);
27
- await assertTldSupported({ rpc, domain });
28
- return resolveSns({ rpc, domain: trimmedSolDomain, options });
25
+ return resolveSol({ rpc, domain: trimmedSolDomain, options });
29
26
  }
30
27
  const [trimmedDomain, tld] = parseSupportedTld(domain);
31
28
  if (tld === SNS_TLD) {
@@ -36,25 +33,35 @@ const resolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
36
33
  /**
37
34
  * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.
38
35
  *
39
- * When SRS-backed `.sol` resolution is enabled, both the `.sol` domain and its
40
- * corresponding `.sns` domain must resolve to the same target; otherwise,
41
- * {@link Errors.SnsSolResolutionMismatchError} is thrown.
36
+ * For `.sol` input, both the SRS domain and its corresponding `.sns` domain
37
+ * must resolve to the same target; otherwise, {@link Errors.SnsSolResolutionMismatchError} is thrown.
42
38
  *
43
39
  * @param params Resolution parameters
44
- * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs
40
+ * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs
45
41
  * @param params.domain Full domain name including a `.sns` or `.sol` suffix
46
42
  * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`
47
43
  * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}
48
44
  * @throws
49
45
  * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.
50
46
  * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.
47
+ *
51
48
  * @example
52
49
  * ```ts
53
50
  * const address = await safeResolve({ rpc, domain: "example.sol" });
54
51
  * ```
55
52
  */
56
53
  const safeResolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
57
- if (domain.endsWith(SOL_TLD) && SOL_SRS_RESOLUTION_ENABLED) ;
54
+ if (domain.endsWith(SOL_TLD)) {
55
+ const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);
56
+ const [srsTarget, snsTarget] = await Promise.all([
57
+ resolveSol({ rpc, domain: trimmedSolDomain, options }),
58
+ resolveSns({ rpc, domain: trimmedSolDomain, options }),
59
+ ]);
60
+ if (srsTarget !== snsTarget) {
61
+ throw new SnsSolResolutionMismatchError(`SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`);
62
+ }
63
+ return srsTarget;
64
+ }
58
65
  return resolve({ rpc, domain, options });
59
66
  };
60
67
 
@@ -1 +1 @@
1
- {"version":3,"file":"resolve.mjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport { SOL_SRS_RESOLUTION_ENABLED } from \"../config\";\r\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\r\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\r\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\r\nimport { resolveSns } from \"./resolveSns\";\r\nimport { resolveSol } from \"./resolveSol\";\r\nimport { ResolveParams } from \"./resolveTypes\";\r\n\r\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain to its target address.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The resolved target address.\r\n *\r\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and\r\n * corresponding SNS targets match when SRS-backed resolution is enabled.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await resolve({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const resolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n\r\n if (SOL_SRS_RESOLUTION_ENABLED) {\r\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n await assertTldSupported({ rpc, domain });\r\n return resolveSns({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n const [trimmedDomain, tld] = parseSupportedTld(domain);\r\n if (tld === SNS_TLD) {\r\n return resolveSns({ rpc, domain: trimmedDomain, options });\r\n }\r\n\r\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\r\n};\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\r\n *\r\n * When SRS-backed `.sol` resolution is enabled, both the `.sol` domain and its\r\n * corresponding `.sns` domain must resolve to the same target; otherwise,\r\n * {@link Errors.SnsSolResolutionMismatchError} is thrown.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\r\n * @throws\r\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\r\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\r\n * @example\r\n * ```ts\r\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\r\n * ```\r\n */\r\nexport const safeResolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD) && SOL_SRS_RESOLUTION_ENABLED) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n const [srsTarget, snsTarget] = await Promise.all([\r\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\r\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\r\n ]);\r\n\r\n if (srsTarget !== snsTarget) {\r\n throw new SnsSolResolutionMismatchError(\r\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\r\n );\r\n }\r\n\r\n return srsTarget;\r\n }\r\n\r\n return resolve({ rpc, domain, options });\r\n};\r\n"],"names":[],"mappings":";;;;;;AAYA;;;;;;;;;;;;;;;;AAgBG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAMzD,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzC,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;;IAG/D,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAI,GAAG,KAAK,OAAO,EAAE;AACnB,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;;AAG5D,IAAA,MAAM,IAAI,mBAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;IACpC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,0BAA0B,EAAE;IAgB5D,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;;;"}
1
+ {"version":3,"file":"resolve.mjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\r\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\r\nimport { resolveSns } from \"./resolveSns\";\r\nimport { resolveSol } from \"./resolveSol\";\r\nimport { ResolveParams } from \"./resolveTypes\";\r\n\r\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain to its target address.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The resolved target address.\r\n *\r\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and corresponding SNS targets match.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await resolve({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const resolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n\r\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n const [trimmedDomain, tld] = parseSupportedTld(domain);\r\n if (tld === SNS_TLD) {\r\n return resolveSns({ rpc, domain: trimmedDomain, options });\r\n }\r\n\r\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\r\n};\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\r\n *\r\n * For `.sol` input, both the SRS domain and its corresponding `.sns` domain\r\n * must resolve to the same target; otherwise, {@link Errors.SnsSolResolutionMismatchError} is thrown.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\r\n * @throws\r\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\r\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\r\n * ```\r\n */\r\nexport const safeResolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n const [srsTarget, snsTarget] = await Promise.all([\r\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\r\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\r\n ]);\r\n\r\n if (srsTarget !== snsTarget) {\r\n throw new SnsSolResolutionMismatchError(\r\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\r\n );\r\n }\r\n\r\n return srsTarget;\r\n }\r\n\r\n return resolve({ rpc, domain, options });\r\n};\r\n"],"names":[],"mappings":";;;;;AAUA;;;;;;;;;;;;;;;AAeG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;AAEzD,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC/D;IAEA,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAI,GAAG,KAAK,OAAO,EAAE;AACnB,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;IAC5D;AAEA,IAAA,MAAM,IAAI,mBAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QACzD,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/C,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;YACtD,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;AACvD,SAAA,CAAC;AAEF,QAAA,IAAI,SAAS,KAAK,SAAS,EAAE;YAC3B,MAAM,IAAI,6BAA6B,CACrC,CAAA,aAAA,EAAgB,MAAM,CAAA,IAAA,EAAO,SAAS,CAAA,yBAAA,EAA4B,SAAS,CAAA,CAAE,CAC9E;QACH;AAEA,QAAA,OAAO,SAAS;IAClB;IAEA,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;"}
@@ -1 +1 @@
1
- {"version":3,"file":"resolveSns.mjs","sources":["../../../src/domain/resolveSns.ts"],"sourcesContent":["import {\r\n Address,\r\n fetchEncodedAccount,\r\n fetchEncodedAccounts,\r\n getPublicKeyFromAddress,\r\n} from \"@solana/kit\";\r\n\r\nimport { addressCodec, utf8Codec } from \"../codecs\";\r\nimport {\r\n CouldNotFindNftOwnerError,\r\n DomainDoesNotExistError,\r\n InvalidRoaError,\r\n InvalidValidationError,\r\n PdaOwnerNotAllowedError,\r\n RecordMalformedError,\r\n} from \"../errors\";\r\nimport { getSnsNftOwner } from \"../nft/getSnsNftOwner\";\r\nimport { getRecordV1Address } from \"../record/getRecordV1Address\";\r\nimport { getRecordV2Address } from \"../record/getRecordV2Address\";\r\nimport { NftState, NftTag } from \"../states/nft\";\r\nimport { RecordState } from \"../states/record\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { Record } from \"../types/record\";\r\nimport { Validation } from \"../types/validation\";\r\nimport { checkAddressOnCurve } from \"../utils/checkAddressOnCurve\";\r\nimport { uint8ArrayToHex } from \"../utils/uint8Array/uint8ArrayToHex\";\r\nimport { uint8ArraysEqual } from \"../utils/uint8Array/uint8ArraysEqual\";\r\nimport { getSnsDomainAddress } from \"./getSnsDomainAddress\";\r\nimport { ResolveSnsParams } from \"./resolveTypes\";\r\n\r\nconst verifySolRecordV1Signature = async ({\r\n data,\r\n signature,\r\n address,\r\n}: {\r\n data: Uint8Array;\r\n signature: Uint8Array<ArrayBuffer>;\r\n address: Address;\r\n}) => {\r\n const publicKey = await getPublicKeyFromAddress(address);\r\n const encodedHexString = utf8Codec.encode(uint8ArrayToHex(data));\r\n\r\n return crypto.subtle.verify(\r\n { name: \"Ed25519\" },\r\n publicKey,\r\n signature,\r\n encodedHexString\r\n );\r\n};\r\n\r\n/** Resolves a TLD-trimmed SNS name using SNS-IP 5 behavior. */\r\nexport const resolveSns = async ({\r\n rpc,\r\n domain,\r\n options,\r\n}: ResolveSnsParams): Promise<Address> => {\r\n const { domainAddress } = await getSnsDomainAddress({ domain });\r\n const nftAddress = await NftState.getAddress(domainAddress);\r\n const solRecordV1Address = await getRecordV1Address({\r\n domain,\r\n record: Record.SOL,\r\n });\r\n const solRecordV2Address = await getRecordV2Address({\r\n domain,\r\n record: Record.SOL,\r\n });\r\n const [domainAccount, nftAccount, solRecordV1Account, solRecordV2Account] =\r\n await fetchEncodedAccounts(rpc, [\r\n domainAddress,\r\n nftAddress,\r\n solRecordV1Address,\r\n solRecordV2Address,\r\n ]);\r\n\r\n if (!domainAccount.exists) {\r\n throw new DomainDoesNotExistError(`Domain ${domain} does not exist`);\r\n }\r\n\r\n const registry = RegistryState.deserialize(domainAccount.data);\r\n\r\n if (nftAccount.exists) {\r\n const nftRecord = NftState.deserialize(nftAccount.data);\r\n if (nftRecord.tag === NftTag.ActiveRecord) {\r\n const nftOwner = await getSnsNftOwner({ rpc, domainAddress });\r\n if (!nftOwner) {\r\n throw new CouldNotFindNftOwnerError();\r\n }\r\n return nftOwner;\r\n }\r\n }\r\n\r\n recordV2: if (solRecordV2Account.exists) {\r\n const recordV2 = RecordState.deserialize(solRecordV2Account.data);\r\n const stalenessId = recordV2.getStalenessId();\r\n const roaId = recordV2.getRoAId();\r\n const content = recordV2.getContent();\r\n\r\n if (content.length !== 32) {\r\n throw new RecordMalformedError(\"Record is malformed\");\r\n }\r\n\r\n if (\r\n recordV2.header.rightOfAssociationValidation !== Validation.Solana ||\r\n recordV2.header.stalenessValidation !== Validation.Solana\r\n ) {\r\n throw new InvalidValidationError();\r\n }\r\n\r\n if (registry.owner !== addressCodec.decode(stalenessId)) {\r\n break recordV2;\r\n }\r\n\r\n if (uint8ArraysEqual(roaId, content)) {\r\n return addressCodec.decode(content);\r\n }\r\n\r\n throw new InvalidRoaError(\r\n `The RoA ID should be ${addressCodec.decode(content)} but is ${addressCodec.decode(roaId)} `\r\n );\r\n }\r\n\r\n if (solRecordV1Account.exists) {\r\n const data = new Uint8Array([\r\n ...solRecordV1Account.data.slice(\r\n RegistryState.HEADER_LEN,\r\n RegistryState.HEADER_LEN + 32\r\n ),\r\n ...addressCodec.encode(solRecordV1Address),\r\n ]);\r\n const signature = solRecordV1Account.data.slice(\r\n RegistryState.HEADER_LEN + 32,\r\n RegistryState.HEADER_LEN + 32 + 64\r\n );\r\n const valid = await verifySolRecordV1Signature({\r\n data,\r\n signature,\r\n address: registry.owner,\r\n });\r\n\r\n if (valid) {\r\n return addressCodec.decode(\r\n solRecordV1Account.data.slice(\r\n RegistryState.HEADER_LEN,\r\n RegistryState.HEADER_LEN + 32\r\n )\r\n );\r\n }\r\n }\r\n\r\n if (!checkAddressOnCurve(registry.owner)) {\r\n if (options.allowPda === \"any\") {\r\n return registry.owner;\r\n }\r\n\r\n if (options.allowPda) {\r\n const ownerAccount = await fetchEncodedAccount(rpc, registry.owner);\r\n\r\n if (!ownerAccount.exists) {\r\n throw new PdaOwnerNotAllowedError(\"Invalid domain owner account\");\r\n }\r\n\r\n if (\r\n options.programIds.some(\r\n (programId) => ownerAccount.programAddress === programId\r\n )\r\n ) {\r\n return registry.owner;\r\n }\r\n\r\n throw new PdaOwnerNotAllowedError(\r\n `The program ${ownerAccount.programAddress} is not allowed`\r\n );\r\n }\r\n\r\n throw new PdaOwnerNotAllowedError();\r\n }\r\n\r\n return registry.owner;\r\n};\r\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"resolveSns.mjs","sources":["../../../src/domain/resolveSns.ts"],"sourcesContent":["import {\r\n Address,\r\n fetchEncodedAccount,\r\n fetchEncodedAccounts,\r\n getPublicKeyFromAddress,\r\n} from \"@solana/kit\";\r\n\r\nimport { addressCodec, utf8Codec } from \"../codecs\";\r\nimport {\r\n CouldNotFindNftOwnerError,\r\n DomainDoesNotExistError,\r\n InvalidRoaError,\r\n InvalidValidationError,\r\n PdaOwnerNotAllowedError,\r\n RecordMalformedError,\r\n} from \"../errors\";\r\nimport { getSnsNftOwner } from \"../nft/getSnsNftOwner\";\r\nimport { getRecordV1Address } from \"../record/getRecordV1Address\";\r\nimport { getRecordV2Address } from \"../record/getRecordV2Address\";\r\nimport { NftState, NftTag } from \"../states/nft\";\r\nimport { RecordState } from \"../states/record\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { Record } from \"../types/record\";\r\nimport { Validation } from \"../types/validation\";\r\nimport { checkAddressOnCurve } from \"../utils/checkAddressOnCurve\";\r\nimport { uint8ArrayToHex } from \"../utils/uint8Array/uint8ArrayToHex\";\r\nimport { uint8ArraysEqual } from \"../utils/uint8Array/uint8ArraysEqual\";\r\nimport { getSnsDomainAddress } from \"./getSnsDomainAddress\";\r\nimport { ResolveSnsParams } from \"./resolveTypes\";\r\n\r\nconst verifySolRecordV1Signature = async ({\r\n data,\r\n signature,\r\n address,\r\n}: {\r\n data: Uint8Array;\r\n signature: Uint8Array<ArrayBuffer>;\r\n address: Address;\r\n}) => {\r\n const publicKey = await getPublicKeyFromAddress(address);\r\n const encodedHexString = utf8Codec.encode(uint8ArrayToHex(data));\r\n\r\n return crypto.subtle.verify(\r\n { name: \"Ed25519\" },\r\n publicKey,\r\n signature,\r\n encodedHexString\r\n );\r\n};\r\n\r\n/** Resolves a TLD-trimmed SNS name using SNS-IP 5 behavior. */\r\nexport const resolveSns = async ({\r\n rpc,\r\n domain,\r\n options,\r\n}: ResolveSnsParams): Promise<Address> => {\r\n const { domainAddress } = await getSnsDomainAddress({ domain });\r\n const nftAddress = await NftState.getAddress(domainAddress);\r\n const solRecordV1Address = await getRecordV1Address({\r\n domain,\r\n record: Record.SOL,\r\n });\r\n const solRecordV2Address = await getRecordV2Address({\r\n domain,\r\n record: Record.SOL,\r\n });\r\n const [domainAccount, nftAccount, solRecordV1Account, solRecordV2Account] =\r\n await fetchEncodedAccounts(rpc, [\r\n domainAddress,\r\n nftAddress,\r\n solRecordV1Address,\r\n solRecordV2Address,\r\n ]);\r\n\r\n if (!domainAccount.exists) {\r\n throw new DomainDoesNotExistError(`Domain ${domain} does not exist`);\r\n }\r\n\r\n const registry = RegistryState.deserialize(domainAccount.data);\r\n\r\n if (nftAccount.exists) {\r\n const nftRecord = NftState.deserialize(nftAccount.data);\r\n if (nftRecord.tag === NftTag.ActiveRecord) {\r\n const nftOwner = await getSnsNftOwner({ rpc, domainAddress });\r\n if (!nftOwner) {\r\n throw new CouldNotFindNftOwnerError();\r\n }\r\n return nftOwner;\r\n }\r\n }\r\n\r\n recordV2: if (solRecordV2Account.exists) {\r\n const recordV2 = RecordState.deserialize(solRecordV2Account.data);\r\n const stalenessId = recordV2.getStalenessId();\r\n const roaId = recordV2.getRoAId();\r\n const content = recordV2.getContent();\r\n\r\n if (content.length !== 32) {\r\n throw new RecordMalformedError(\"Record is malformed\");\r\n }\r\n\r\n if (\r\n recordV2.header.rightOfAssociationValidation !== Validation.Solana ||\r\n recordV2.header.stalenessValidation !== Validation.Solana\r\n ) {\r\n throw new InvalidValidationError();\r\n }\r\n\r\n if (registry.owner !== addressCodec.decode(stalenessId)) {\r\n break recordV2;\r\n }\r\n\r\n if (uint8ArraysEqual(roaId, content)) {\r\n return addressCodec.decode(content);\r\n }\r\n\r\n throw new InvalidRoaError(\r\n `The RoA ID should be ${addressCodec.decode(content)} but is ${addressCodec.decode(roaId)} `\r\n );\r\n }\r\n\r\n if (solRecordV1Account.exists) {\r\n const data = new Uint8Array([\r\n ...solRecordV1Account.data.slice(\r\n RegistryState.HEADER_LEN,\r\n RegistryState.HEADER_LEN + 32\r\n ),\r\n ...addressCodec.encode(solRecordV1Address),\r\n ]);\r\n const signature = solRecordV1Account.data.slice(\r\n RegistryState.HEADER_LEN + 32,\r\n RegistryState.HEADER_LEN + 32 + 64\r\n );\r\n const valid = await verifySolRecordV1Signature({\r\n data,\r\n signature,\r\n address: registry.owner,\r\n });\r\n\r\n if (valid) {\r\n return addressCodec.decode(\r\n solRecordV1Account.data.slice(\r\n RegistryState.HEADER_LEN,\r\n RegistryState.HEADER_LEN + 32\r\n )\r\n );\r\n }\r\n }\r\n\r\n if (!checkAddressOnCurve(registry.owner)) {\r\n if (options.allowPda === \"any\") {\r\n return registry.owner;\r\n }\r\n\r\n if (options.allowPda) {\r\n const ownerAccount = await fetchEncodedAccount(rpc, registry.owner);\r\n\r\n if (!ownerAccount.exists) {\r\n throw new PdaOwnerNotAllowedError(\"Invalid domain owner account\");\r\n }\r\n\r\n if (\r\n options.programIds.some(\r\n (programId) => ownerAccount.programAddress === programId\r\n )\r\n ) {\r\n return registry.owner;\r\n }\r\n\r\n throw new PdaOwnerNotAllowedError(\r\n `The program ${ownerAccount.programAddress} is not allowed`\r\n );\r\n }\r\n\r\n throw new PdaOwnerNotAllowedError();\r\n }\r\n\r\n return registry.owner;\r\n};\r\n"],"names":[],"mappings":"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"}
@@ -0,0 +1,125 @@
1
+ import { AccountState } from '@solana-program/token';
2
+ import { fetchEncodedAccount, getI64Decoder, getProgramDerivedAddress } from '@solana/kit';
3
+ import { addressCodec, utf8Codec } from '../codecs.mjs';
4
+ import { SRS_PROGRAM_ADDRESS, SOL_SRS_CLASS, TOKEN_2022_PROGRAM_ADDRESS } from '../constants/addresses.mjs';
5
+ import { SRS_RECORD_HEADER_LENGTH, SRS_RECORD_DISCRIMINATOR_OFFSET, SRS_RECORD_DISCRIMINATOR, SRS_RECORD_CLASS_OFFSET, SRS_ADDRESS_LENGTH, SRS_RECORD_OWNER_TYPE_OFFSET, SRS_OWNER_TYPE_PUBKEY, SRS_OWNER_TYPE_TOKEN, SRS_RECORD_EXPIRY_OFFSET, SRS_EXPIRY_LENGTH, SRS_RECORD_OWNER_OFFSET } from '../constants/srs.mjs';
6
+ import { DomainDoesNotExistError, RecordMalformedError, DomainExpiredError, CouldNotFindSrsOwnerError, PdaOwnerNotAllowedError } from '../errors.mjs';
7
+ import { checkAddressOnCurve } from '../utils/checkAddressOnCurve/index.mjs';
8
+ import { getSolDomainAddress } from './getSolDomainAddress.mjs';
9
+ import { unpackMint } from '../utils/token2022/unpackMint.mjs';
10
+ import { unpackAccount } from '../utils/token2022/unpackAccount.mjs';
11
+
12
+ const i64Decoder = getI64Decoder();
13
+ const resolveSrsPubkeyOwner = async ({ rpc, owner, options, }) => {
14
+ if (checkAddressOnCurve(owner)) {
15
+ return owner;
16
+ }
17
+ if (options.allowPda === "any") {
18
+ return owner;
19
+ }
20
+ if (!options.allowPda) {
21
+ throw new PdaOwnerNotAllowedError();
22
+ }
23
+ const ownerAccount = await fetchEncodedAccount(rpc, owner);
24
+ if (!ownerAccount.exists) {
25
+ throw new PdaOwnerNotAllowedError("Invalid domain owner account");
26
+ }
27
+ if (options.programIds.some((programId) => ownerAccount.programAddress === programId)) {
28
+ return owner;
29
+ }
30
+ throw new PdaOwnerNotAllowedError(`The program ${ownerAccount.programAddress} is not allowed`);
31
+ };
32
+ const resolveSrsTokenOwner = async ({ rpc, record, mint, options, }) => {
33
+ const [canonicalMint] = await getProgramDerivedAddress({
34
+ programAddress: SRS_PROGRAM_ADDRESS,
35
+ seeds: [utf8Codec.encode("mint"), addressCodec.encode(record)],
36
+ });
37
+ if (mint !== canonicalMint) {
38
+ throw new RecordMalformedError("SRS record has a noncanonical token mint");
39
+ }
40
+ const mintAccount = await fetchEncodedAccount(rpc, mint);
41
+ if (!mintAccount.exists ||
42
+ mintAccount.programAddress !== TOKEN_2022_PROGRAM_ADDRESS) {
43
+ throw new CouldNotFindSrsOwnerError("SRS token mint is invalid");
44
+ }
45
+ let mintState;
46
+ try {
47
+ mintState = unpackMint(mintAccount.data);
48
+ }
49
+ catch {
50
+ throw new CouldNotFindSrsOwnerError("SRS token mint is invalid");
51
+ }
52
+ if (!mintState.isInitialized ||
53
+ mintState.decimals !== 0 ||
54
+ mintState.supply !== 1n) {
55
+ throw new CouldNotFindSrsOwnerError("SRS token mint is invalid");
56
+ }
57
+ const largestAccounts = await rpc.getTokenLargestAccounts(mint).send();
58
+ const holders = largestAccounts.value.filter(({ amount }) => amount === "1");
59
+ if (holders.length !== 1) {
60
+ throw new CouldNotFindSrsOwnerError("SRS token mint has no unique current holder");
61
+ }
62
+ const holderAddress = holders[0].address;
63
+ const holderAccount = await fetchEncodedAccount(rpc, holderAddress);
64
+ if (!holderAccount.exists ||
65
+ holderAccount.programAddress !== TOKEN_2022_PROGRAM_ADDRESS) {
66
+ throw new CouldNotFindSrsOwnerError("SRS token holder account is invalid");
67
+ }
68
+ let holderState;
69
+ try {
70
+ holderState = unpackAccount(holderAccount.data);
71
+ }
72
+ catch {
73
+ throw new CouldNotFindSrsOwnerError("SRS token holder account is invalid");
74
+ }
75
+ if (holderState.state === AccountState.Uninitialized ||
76
+ holderState.mint !== mint ||
77
+ holderState.amount !== 1n) {
78
+ throw new CouldNotFindSrsOwnerError("SRS token holder account is invalid");
79
+ }
80
+ return resolveSrsPubkeyOwner({
81
+ rpc,
82
+ owner: holderState.owner,
83
+ options,
84
+ });
85
+ };
86
+ /** Resolves a TLD-trimmed `.sol` name from its canonical SRS record. */
87
+ const resolveSol = async ({ rpc, domain, options, }) => {
88
+ const { domainAddress } = await getSolDomainAddress({ domain });
89
+ const account = await fetchEncodedAccount(rpc, domainAddress);
90
+ if (!account.exists) {
91
+ throw new DomainDoesNotExistError(`Domain ${domain} does not exist`);
92
+ }
93
+ const { data } = account;
94
+ if (account.programAddress !== SRS_PROGRAM_ADDRESS ||
95
+ data.length < SRS_RECORD_HEADER_LENGTH ||
96
+ data[SRS_RECORD_DISCRIMINATOR_OFFSET] !== SRS_RECORD_DISCRIMINATOR) {
97
+ throw new RecordMalformedError("SRS record is malformed");
98
+ }
99
+ if (addressCodec.decode(data.slice(SRS_RECORD_CLASS_OFFSET, SRS_RECORD_CLASS_OFFSET + SRS_ADDRESS_LENGTH)) !== SOL_SRS_CLASS) {
100
+ throw new RecordMalformedError("SRS record has an invalid class");
101
+ }
102
+ const ownerType = data[SRS_RECORD_OWNER_TYPE_OFFSET];
103
+ if (ownerType !== SRS_OWNER_TYPE_PUBKEY &&
104
+ ownerType !== SRS_OWNER_TYPE_TOKEN) {
105
+ throw new RecordMalformedError("SRS record has an invalid owner type");
106
+ }
107
+ const expiry = i64Decoder.decode(data.slice(SRS_RECORD_EXPIRY_OFFSET, SRS_RECORD_EXPIRY_OFFSET + SRS_EXPIRY_LENGTH));
108
+ // Zero is the SRS sentinel for a record that does not expire.
109
+ if (expiry !== 0n && expiry <= BigInt(Math.floor(Date.now() / 1_000))) {
110
+ throw new DomainExpiredError(`Domain ${domain} has expired`);
111
+ }
112
+ const owner = addressCodec.decode(data.slice(SRS_RECORD_OWNER_OFFSET, SRS_RECORD_OWNER_OFFSET + SRS_ADDRESS_LENGTH));
113
+ if (ownerType === SRS_OWNER_TYPE_TOKEN) {
114
+ return resolveSrsTokenOwner({
115
+ rpc,
116
+ record: domainAddress,
117
+ mint: owner,
118
+ options,
119
+ });
120
+ }
121
+ return resolveSrsPubkeyOwner({ rpc, owner, options });
122
+ };
123
+
124
+ export { resolveSol };
125
+ //# sourceMappingURL=resolveSol.mjs.map