@solana-name-service/sns-sdk-kit 0.10.0 → 1.0.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 (601) hide show
  1. package/README.md +322 -90
  2. package/dist/cjs/address/getPrimaryDomain.cjs +54 -1
  3. package/dist/cjs/address/getPrimaryDomain.cjs.map +1 -1
  4. package/dist/cjs/address/getPrimaryDomainsBatch.cjs +108 -1
  5. package/dist/cjs/address/getPrimaryDomainsBatch.cjs.map +1 -1
  6. package/dist/cjs/address/getSnsDomainsForAddress.cjs +65 -0
  7. package/dist/cjs/address/getSnsDomainsForAddress.cjs.map +1 -0
  8. package/dist/cjs/address/getSnsNftsForAddress.cjs +94 -0
  9. package/dist/cjs/address/getSnsNftsForAddress.cjs.map +1 -0
  10. package/dist/cjs/address/index.cjs +15 -1
  11. package/dist/cjs/address/index.cjs.map +1 -1
  12. package/dist/cjs/bindings/burnDomain.cjs +46 -1
  13. package/dist/cjs/bindings/burnDomain.cjs.map +1 -1
  14. package/dist/cjs/bindings/createNameRegistry.cjs +54 -1
  15. package/dist/cjs/bindings/createNameRegistry.cjs.map +1 -1
  16. package/dist/cjs/bindings/createRecord.cjs +57 -1
  17. package/dist/cjs/bindings/createRecord.cjs.map +1 -1
  18. package/dist/cjs/bindings/createReverse.cjs +36 -1
  19. package/dist/cjs/bindings/createReverse.cjs.map +1 -1
  20. package/dist/cjs/bindings/createSubdomain.cjs +69 -1
  21. package/dist/cjs/bindings/createSubdomain.cjs.map +1 -1
  22. package/dist/cjs/bindings/deleteNameRegistry.cjs +37 -1
  23. package/dist/cjs/bindings/deleteNameRegistry.cjs.map +1 -1
  24. package/dist/cjs/bindings/deleteRecord.cjs +49 -1
  25. package/dist/cjs/bindings/deleteRecord.cjs.map +1 -1
  26. package/dist/cjs/bindings/index.cjs +43 -1
  27. package/dist/cjs/bindings/index.cjs.map +1 -1
  28. package/dist/cjs/bindings/recordValidation.cjs +60 -0
  29. package/dist/cjs/bindings/recordValidation.cjs.map +1 -0
  30. package/dist/cjs/bindings/registerDomain.cjs +86 -1
  31. package/dist/cjs/bindings/registerDomain.cjs.map +1 -1
  32. package/dist/cjs/bindings/registerDomainWithNft.cjs +67 -0
  33. package/dist/cjs/bindings/registerDomainWithNft.cjs.map +1 -0
  34. package/dist/cjs/bindings/setPrimaryDomain.cjs +39 -1
  35. package/dist/cjs/bindings/setPrimaryDomain.cjs.map +1 -1
  36. package/dist/cjs/bindings/setRecordRoaVerifier.cjs +44 -0
  37. package/dist/cjs/bindings/setRecordRoaVerifier.cjs.map +1 -0
  38. package/dist/cjs/bindings/setRecordStalenessVerifier.cjs +32 -0
  39. package/dist/cjs/bindings/setRecordStalenessVerifier.cjs.map +1 -0
  40. package/dist/cjs/bindings/transferDomain.cjs +33 -1
  41. package/dist/cjs/bindings/transferDomain.cjs.map +1 -1
  42. package/dist/cjs/bindings/transferSubdomain.cjs +48 -1
  43. package/dist/cjs/bindings/transferSubdomain.cjs.map +1 -1
  44. package/dist/cjs/bindings/updateNameRegistry.cjs +45 -1
  45. package/dist/cjs/bindings/updateNameRegistry.cjs.map +1 -1
  46. package/dist/cjs/bindings/updateRecord.cjs +57 -1
  47. package/dist/cjs/bindings/updateRecord.cjs.map +1 -1
  48. package/dist/cjs/bindings/validateRecordRoa.cjs +32 -0
  49. package/dist/cjs/bindings/validateRecordRoa.cjs.map +1 -0
  50. package/dist/cjs/bindings/validateRecordRoaEthereum.cjs +49 -0
  51. package/dist/cjs/bindings/validateRecordRoaEthereum.cjs.map +1 -0
  52. package/dist/cjs/codecs.cjs +27 -1
  53. package/dist/cjs/codecs.cjs.map +1 -1
  54. package/dist/cjs/config.cjs +18 -0
  55. package/dist/cjs/config.cjs.map +1 -0
  56. package/dist/cjs/constants/addresses.cjs +124 -1
  57. package/dist/cjs/constants/addresses.cjs.map +1 -1
  58. package/dist/cjs/constants/index.cjs +40 -1
  59. package/dist/cjs/constants/index.cjs.map +1 -1
  60. package/dist/cjs/constants/pythFeeds.cjs +91 -1
  61. package/dist/cjs/constants/pythFeeds.cjs.map +1 -1
  62. package/dist/cjs/constants/records.cjs +71 -1
  63. package/dist/cjs/constants/records.cjs.map +1 -1
  64. package/dist/cjs/domain/getAllSnsDomains.cjs +43 -0
  65. package/dist/cjs/domain/getAllSnsDomains.cjs.map +1 -0
  66. package/dist/cjs/domain/getDomainOwner.cjs +27 -1
  67. package/dist/cjs/domain/getDomainOwner.cjs.map +1 -1
  68. package/dist/cjs/domain/getDomainRecord.cjs +54 -1
  69. package/dist/cjs/domain/getDomainRecord.cjs.map +1 -1
  70. package/dist/cjs/domain/getDomainRecords.cjs +64 -1
  71. package/dist/cjs/domain/getDomainRecords.cjs.map +1 -1
  72. package/dist/cjs/domain/getSnsDomainAddress.cjs +52 -0
  73. package/dist/cjs/domain/getSnsDomainAddress.cjs.map +1 -0
  74. package/dist/cjs/domain/getSnsDomainOwner.cjs +31 -0
  75. package/dist/cjs/domain/getSnsDomainOwner.cjs.map +1 -0
  76. package/dist/cjs/domain/getSrsDomainAddress.cjs +36 -0
  77. package/dist/cjs/domain/getSrsDomainAddress.cjs.map +1 -0
  78. package/dist/cjs/domain/getSubdomains.cjs +95 -1
  79. package/dist/cjs/domain/getSubdomains.cjs.map +1 -1
  80. package/dist/cjs/domain/index.cjs +24 -1
  81. package/dist/cjs/domain/index.cjs.map +1 -1
  82. package/dist/cjs/domain/resolve.cjs +67 -0
  83. package/dist/cjs/domain/resolve.cjs.map +1 -0
  84. package/dist/cjs/domain/resolveSns.cjs +113 -0
  85. package/dist/cjs/domain/resolveSns.cjs.map +1 -0
  86. package/dist/cjs/errors.cjs +250 -1
  87. package/dist/cjs/errors.cjs.map +1 -1
  88. package/dist/cjs/index.cjs +245 -1
  89. package/dist/cjs/index.cjs.map +1 -1
  90. package/dist/cjs/instructions/allocateAndPostRecordInstruction.cjs +71 -1
  91. package/dist/cjs/instructions/allocateAndPostRecordInstruction.cjs.map +1 -1
  92. package/dist/cjs/instructions/burnDomainInstruction.cjs +71 -1
  93. package/dist/cjs/instructions/burnDomainInstruction.cjs.map +1 -1
  94. package/dist/cjs/instructions/createAtaIdempotentInstruction.cjs +71 -0
  95. package/dist/cjs/instructions/createAtaIdempotentInstruction.cjs.map +1 -0
  96. package/dist/cjs/instructions/createNameRegistryInstruction.cjs +94 -1
  97. package/dist/cjs/instructions/createNameRegistryInstruction.cjs.map +1 -1
  98. package/dist/cjs/instructions/createReverseInstruction.cjs +79 -1
  99. package/dist/cjs/instructions/createReverseInstruction.cjs.map +1 -1
  100. package/dist/cjs/instructions/createSplitV2Instruction.cjs +113 -1
  101. package/dist/cjs/instructions/createSplitV2Instruction.cjs.map +1 -1
  102. package/dist/cjs/instructions/createWithNftInstruction.cjs +107 -1
  103. package/dist/cjs/instructions/createWithNftInstruction.cjs.map +1 -1
  104. package/dist/cjs/instructions/deleteNameRegistryInstruction.cjs +47 -1
  105. package/dist/cjs/instructions/deleteNameRegistryInstruction.cjs.map +1 -1
  106. package/dist/cjs/instructions/deleteRecordInstruction.cjs +63 -1
  107. package/dist/cjs/instructions/deleteRecordInstruction.cjs.map +1 -1
  108. package/dist/cjs/instructions/index.cjs +41 -1
  109. package/dist/cjs/instructions/index.cjs.map +1 -1
  110. package/dist/cjs/instructions/reallocInstruction.cjs +55 -1
  111. package/dist/cjs/instructions/reallocInstruction.cjs.map +1 -1
  112. package/dist/cjs/instructions/registerPrimaryInstruction.cjs +58 -0
  113. package/dist/cjs/instructions/registerPrimaryInstruction.cjs.map +1 -0
  114. package/dist/cjs/instructions/setRecordRoaVerifierInstruction.cjs +69 -0
  115. package/dist/cjs/instructions/setRecordRoaVerifierInstruction.cjs.map +1 -0
  116. package/dist/cjs/instructions/transferInstruction.cjs +67 -1
  117. package/dist/cjs/instructions/transferInstruction.cjs.map +1 -1
  118. package/dist/cjs/instructions/updateNameRegistryInstruction.cjs +51 -1
  119. package/dist/cjs/instructions/updateNameRegistryInstruction.cjs.map +1 -1
  120. package/dist/cjs/instructions/updateRecordInstruction.cjs +71 -1
  121. package/dist/cjs/instructions/updateRecordInstruction.cjs.map +1 -1
  122. package/dist/cjs/instructions/validateEthereumSignatureInstruction.cjs +76 -0
  123. package/dist/cjs/instructions/validateEthereumSignatureInstruction.cjs.map +1 -0
  124. package/dist/cjs/instructions/validateSolanaSignatureInstruction.cjs +72 -0
  125. package/dist/cjs/instructions/validateSolanaSignatureInstruction.cjs.map +1 -0
  126. package/dist/cjs/nft/getSnsNftMint.cjs +31 -0
  127. package/dist/cjs/nft/getSnsNftMint.cjs.map +1 -0
  128. package/dist/cjs/nft/getSnsNftOwner.cjs +48 -0
  129. package/dist/cjs/nft/getSnsNftOwner.cjs.map +1 -0
  130. package/dist/cjs/nft/index.cjs +11 -1
  131. package/dist/cjs/nft/index.cjs.map +1 -1
  132. package/dist/cjs/record/getRecordV1Address.cjs +31 -1
  133. package/dist/cjs/record/getRecordV1Address.cjs.map +1 -1
  134. package/dist/cjs/record/getRecordV2Address.cjs +27 -1
  135. package/dist/cjs/record/getRecordV2Address.cjs.map +1 -1
  136. package/dist/cjs/record/index.cjs +18 -1
  137. package/dist/cjs/record/index.cjs.map +1 -1
  138. package/dist/cjs/record/verifyRecordRightOfAssociation.cjs +95 -1
  139. package/dist/cjs/record/verifyRecordRightOfAssociation.cjs.map +1 -1
  140. package/dist/cjs/record/verifyRecordStaleness.cjs +55 -1
  141. package/dist/cjs/record/verifyRecordStaleness.cjs.map +1 -1
  142. package/dist/cjs/states/index.cjs +22 -1
  143. package/dist/cjs/states/index.cjs.map +1 -1
  144. package/dist/cjs/states/nft.cjs +109 -1
  145. package/dist/cjs/states/nft.cjs.map +1 -1
  146. package/dist/cjs/states/primaryDomain.cjs +65 -1
  147. package/dist/cjs/states/primaryDomain.cjs.map +1 -1
  148. package/dist/cjs/states/record.cjs +120 -1
  149. package/dist/cjs/states/record.cjs.map +1 -1
  150. package/dist/cjs/states/registry.cjs +68 -1
  151. package/dist/cjs/states/registry.cjs.map +1 -1
  152. package/dist/cjs/types/index.cjs +22 -1
  153. package/dist/cjs/types/index.cjs.map +1 -1
  154. package/dist/cjs/types/record.cjs +56 -1
  155. package/dist/cjs/types/record.cjs.map +1 -1
  156. package/dist/cjs/types/validation.cjs +12 -1
  157. package/dist/cjs/types/validation.cjs.map +1 -1
  158. package/dist/cjs/utils/assertTldSupported.cjs +28 -0
  159. package/dist/cjs/utils/assertTldSupported.cjs.map +1 -0
  160. package/dist/cjs/utils/check.cjs +20 -1
  161. package/dist/cjs/utils/check.cjs.map +1 -1
  162. package/dist/cjs/utils/checkAddressOnCurve/ed25519.cjs +81 -3
  163. package/dist/cjs/utils/checkAddressOnCurve/ed25519.cjs.map +1 -1
  164. package/dist/cjs/utils/checkAddressOnCurve/index.cjs +42 -1
  165. package/dist/cjs/utils/checkAddressOnCurve/index.cjs.map +1 -1
  166. package/dist/cjs/utils/deriveAddress.cjs +57 -1
  167. package/dist/cjs/utils/deriveAddress.cjs.map +1 -1
  168. package/dist/cjs/utils/deserializers/deserializeRecordContent.cjs +64 -1
  169. package/dist/cjs/utils/deserializers/deserializeRecordContent.cjs.map +1 -1
  170. package/dist/cjs/utils/deserializers/deserializeReverse.cjs +17 -1
  171. package/dist/cjs/utils/deserializers/deserializeReverse.cjs.map +1 -1
  172. package/dist/cjs/utils/getPythFeedAddress.cjs +32 -1
  173. package/dist/cjs/utils/getPythFeedAddress.cjs.map +1 -1
  174. package/dist/cjs/utils/getReverseAddress.cjs +29 -1
  175. package/dist/cjs/utils/getReverseAddress.cjs.map +1 -1
  176. package/dist/cjs/utils/getReverseAddressFromDomainAddress.cjs +25 -1
  177. package/dist/cjs/utils/getReverseAddressFromDomainAddress.cjs.map +1 -1
  178. package/dist/cjs/utils/index.cjs +32 -1
  179. package/dist/cjs/utils/index.cjs.map +1 -1
  180. package/dist/cjs/utils/parseSnsDomain.cjs +66 -0
  181. package/dist/cjs/utils/parseSnsDomain.cjs.map +1 -0
  182. package/dist/cjs/utils/reverseLookup.cjs +40 -1
  183. package/dist/cjs/utils/reverseLookup.cjs.map +1 -1
  184. package/dist/cjs/utils/reverseLookupBatch.cjs +30 -1
  185. package/dist/cjs/utils/reverseLookupBatch.cjs.map +1 -1
  186. package/dist/cjs/utils/serializers/serializeRecordContent.cjs +90 -1
  187. package/dist/cjs/utils/serializers/serializeRecordContent.cjs.map +1 -1
  188. package/dist/cjs/utils/tld.cjs +67 -0
  189. package/dist/cjs/utils/tld.cjs.map +1 -0
  190. package/dist/cjs/utils/uint8Array/uint8ArrayFromHex.cjs +20 -1
  191. package/dist/cjs/utils/uint8Array/uint8ArrayFromHex.cjs.map +1 -1
  192. package/dist/cjs/utils/uint8Array/uint8ArrayToHex.cjs +16 -1
  193. package/dist/cjs/utils/uint8Array/uint8ArrayToHex.cjs.map +1 -1
  194. package/dist/cjs/utils/uint8Array/uint8ArraysEqual.cjs +20 -1
  195. package/dist/cjs/utils/uint8Array/uint8ArraysEqual.cjs.map +1 -1
  196. package/dist/esm/address/getPrimaryDomain.mjs +50 -1
  197. package/dist/esm/address/getPrimaryDomain.mjs.map +1 -1
  198. package/dist/esm/address/getPrimaryDomainsBatch.mjs +104 -1
  199. package/dist/esm/address/getPrimaryDomainsBatch.mjs.map +1 -1
  200. package/dist/esm/address/getSnsDomainsForAddress.mjs +61 -0
  201. package/dist/esm/address/getSnsDomainsForAddress.mjs.map +1 -0
  202. package/dist/esm/address/getSnsNftsForAddress.mjs +90 -0
  203. package/dist/esm/address/getSnsNftsForAddress.mjs.map +1 -0
  204. package/dist/esm/address/index.mjs +4 -1
  205. package/dist/esm/address/index.mjs.map +1 -1
  206. package/dist/esm/bindings/burnDomain.mjs +42 -1
  207. package/dist/esm/bindings/burnDomain.mjs.map +1 -1
  208. package/dist/esm/bindings/createNameRegistry.mjs +50 -1
  209. package/dist/esm/bindings/createNameRegistry.mjs.map +1 -1
  210. package/dist/esm/bindings/createRecord.mjs +53 -1
  211. package/dist/esm/bindings/createRecord.mjs.map +1 -1
  212. package/dist/esm/bindings/createReverse.mjs +32 -1
  213. package/dist/esm/bindings/createReverse.mjs.map +1 -1
  214. package/dist/esm/bindings/createSubdomain.mjs +65 -1
  215. package/dist/esm/bindings/createSubdomain.mjs.map +1 -1
  216. package/dist/esm/bindings/deleteNameRegistry.mjs +33 -1
  217. package/dist/esm/bindings/deleteNameRegistry.mjs.map +1 -1
  218. package/dist/esm/bindings/deleteRecord.mjs +45 -1
  219. package/dist/esm/bindings/deleteRecord.mjs.map +1 -1
  220. package/dist/esm/bindings/index.mjs +18 -1
  221. package/dist/esm/bindings/index.mjs.map +1 -1
  222. package/dist/esm/bindings/recordValidation.mjs +55 -0
  223. package/dist/esm/bindings/recordValidation.mjs.map +1 -0
  224. package/dist/esm/bindings/registerDomain.mjs +82 -1
  225. package/dist/esm/bindings/registerDomain.mjs.map +1 -1
  226. package/dist/esm/bindings/registerDomainWithNft.mjs +63 -0
  227. package/dist/esm/bindings/registerDomainWithNft.mjs.map +1 -0
  228. package/dist/esm/bindings/setPrimaryDomain.mjs +35 -1
  229. package/dist/esm/bindings/setPrimaryDomain.mjs.map +1 -1
  230. package/dist/esm/bindings/setRecordRoaVerifier.mjs +40 -0
  231. package/dist/esm/bindings/setRecordRoaVerifier.mjs.map +1 -0
  232. package/dist/esm/bindings/setRecordStalenessVerifier.mjs +28 -0
  233. package/dist/esm/bindings/setRecordStalenessVerifier.mjs.map +1 -0
  234. package/dist/esm/bindings/transferDomain.mjs +29 -1
  235. package/dist/esm/bindings/transferDomain.mjs.map +1 -1
  236. package/dist/esm/bindings/transferSubdomain.mjs +44 -1
  237. package/dist/esm/bindings/transferSubdomain.mjs.map +1 -1
  238. package/dist/esm/bindings/updateNameRegistry.mjs +41 -1
  239. package/dist/esm/bindings/updateNameRegistry.mjs.map +1 -1
  240. package/dist/esm/bindings/updateRecord.mjs +53 -1
  241. package/dist/esm/bindings/updateRecord.mjs.map +1 -1
  242. package/dist/esm/bindings/validateRecordRoa.mjs +28 -0
  243. package/dist/esm/bindings/validateRecordRoa.mjs.map +1 -0
  244. package/dist/esm/bindings/validateRecordRoaEthereum.mjs +45 -0
  245. package/dist/esm/bindings/validateRecordRoaEthereum.mjs.map +1 -0
  246. package/dist/esm/codecs.mjs +19 -1
  247. package/dist/esm/codecs.mjs.map +1 -1
  248. package/dist/esm/config.mjs +11 -0
  249. package/dist/esm/config.mjs.map +1 -0
  250. package/dist/esm/constants/addresses.mjs +98 -1
  251. package/dist/esm/constants/addresses.mjs.map +1 -1
  252. package/dist/esm/constants/index.mjs +3 -1
  253. package/dist/esm/constants/index.mjs.map +1 -1
  254. package/dist/esm/constants/pythFeeds.mjs +86 -1
  255. package/dist/esm/constants/pythFeeds.mjs.map +1 -1
  256. package/dist/esm/constants/records.mjs +63 -1
  257. package/dist/esm/constants/records.mjs.map +1 -1
  258. package/dist/esm/domain/getAllSnsDomains.mjs +39 -0
  259. package/dist/esm/domain/getAllSnsDomains.mjs.map +1 -0
  260. package/dist/esm/domain/getDomainOwner.mjs +23 -1
  261. package/dist/esm/domain/getDomainOwner.mjs.map +1 -1
  262. package/dist/esm/domain/getDomainRecord.mjs +50 -1
  263. package/dist/esm/domain/getDomainRecord.mjs.map +1 -1
  264. package/dist/esm/domain/getDomainRecords.mjs +60 -1
  265. package/dist/esm/domain/getDomainRecords.mjs.map +1 -1
  266. package/dist/esm/domain/getSnsDomainAddress.mjs +48 -0
  267. package/dist/esm/domain/getSnsDomainAddress.mjs.map +1 -0
  268. package/dist/esm/domain/getSnsDomainOwner.mjs +27 -0
  269. package/dist/esm/domain/getSnsDomainOwner.mjs.map +1 -0
  270. package/dist/esm/domain/getSrsDomainAddress.mjs +32 -0
  271. package/dist/esm/domain/getSrsDomainAddress.mjs.map +1 -0
  272. package/dist/esm/domain/getSubdomains.mjs +91 -1
  273. package/dist/esm/domain/getSubdomains.mjs.map +1 -1
  274. package/dist/esm/domain/index.mjs +8 -1
  275. package/dist/esm/domain/index.mjs.map +1 -1
  276. package/dist/esm/domain/resolve.mjs +62 -0
  277. package/dist/esm/domain/resolve.mjs.map +1 -0
  278. package/dist/esm/domain/resolveSns.mjs +109 -0
  279. package/dist/esm/domain/resolveSns.mjs.map +1 -0
  280. package/dist/esm/errors.mjs +218 -1
  281. package/dist/esm/errors.mjs.map +1 -1
  282. package/dist/esm/index.mjs +74 -1
  283. package/dist/esm/index.mjs.map +1 -1
  284. package/dist/esm/instructions/allocateAndPostRecordInstruction.mjs +67 -1
  285. package/dist/esm/instructions/allocateAndPostRecordInstruction.mjs.map +1 -1
  286. package/dist/esm/instructions/burnDomainInstruction.mjs +67 -1
  287. package/dist/esm/instructions/burnDomainInstruction.mjs.map +1 -1
  288. package/dist/esm/instructions/createAtaIdempotentInstruction.mjs +67 -0
  289. package/dist/esm/instructions/createAtaIdempotentInstruction.mjs.map +1 -0
  290. package/dist/esm/instructions/createNameRegistryInstruction.mjs +90 -1
  291. package/dist/esm/instructions/createNameRegistryInstruction.mjs.map +1 -1
  292. package/dist/esm/instructions/createReverseInstruction.mjs +75 -1
  293. package/dist/esm/instructions/createReverseInstruction.mjs.map +1 -1
  294. package/dist/esm/instructions/createSplitV2Instruction.mjs +109 -1
  295. package/dist/esm/instructions/createSplitV2Instruction.mjs.map +1 -1
  296. package/dist/esm/instructions/createWithNftInstruction.mjs +103 -1
  297. package/dist/esm/instructions/createWithNftInstruction.mjs.map +1 -1
  298. package/dist/esm/instructions/deleteNameRegistryInstruction.mjs +43 -1
  299. package/dist/esm/instructions/deleteNameRegistryInstruction.mjs.map +1 -1
  300. package/dist/esm/instructions/deleteRecordInstruction.mjs +59 -1
  301. package/dist/esm/instructions/deleteRecordInstruction.mjs.map +1 -1
  302. package/dist/esm/instructions/index.mjs +17 -1
  303. package/dist/esm/instructions/index.mjs.map +1 -1
  304. package/dist/esm/instructions/reallocInstruction.mjs +51 -1
  305. package/dist/esm/instructions/reallocInstruction.mjs.map +1 -1
  306. package/dist/esm/instructions/registerPrimaryInstruction.mjs +54 -0
  307. package/dist/esm/instructions/registerPrimaryInstruction.mjs.map +1 -0
  308. package/dist/esm/instructions/setRecordRoaVerifierInstruction.mjs +65 -0
  309. package/dist/esm/instructions/setRecordRoaVerifierInstruction.mjs.map +1 -0
  310. package/dist/esm/instructions/transferInstruction.mjs +63 -1
  311. package/dist/esm/instructions/transferInstruction.mjs.map +1 -1
  312. package/dist/esm/instructions/updateNameRegistryInstruction.mjs +47 -1
  313. package/dist/esm/instructions/updateNameRegistryInstruction.mjs.map +1 -1
  314. package/dist/esm/instructions/updateRecordInstruction.mjs +67 -1
  315. package/dist/esm/instructions/updateRecordInstruction.mjs.map +1 -1
  316. package/dist/esm/instructions/validateEthereumSignatureInstruction.mjs +72 -0
  317. package/dist/esm/instructions/validateEthereumSignatureInstruction.mjs.map +1 -0
  318. package/dist/esm/instructions/validateSolanaSignatureInstruction.mjs +68 -0
  319. package/dist/esm/instructions/validateSolanaSignatureInstruction.mjs.map +1 -0
  320. package/dist/esm/nft/getSnsNftMint.mjs +27 -0
  321. package/dist/esm/nft/getSnsNftMint.mjs.map +1 -0
  322. package/dist/esm/nft/getSnsNftOwner.mjs +44 -0
  323. package/dist/esm/nft/getSnsNftOwner.mjs.map +1 -0
  324. package/dist/esm/nft/index.mjs +2 -1
  325. package/dist/esm/nft/index.mjs.map +1 -1
  326. package/dist/esm/record/getRecordV1Address.mjs +27 -1
  327. package/dist/esm/record/getRecordV1Address.mjs.map +1 -1
  328. package/dist/esm/record/getRecordV2Address.mjs +23 -1
  329. package/dist/esm/record/getRecordV2Address.mjs.map +1 -1
  330. package/dist/esm/record/index.mjs +4 -1
  331. package/dist/esm/record/index.mjs.map +1 -1
  332. package/dist/esm/record/verifyRecordRightOfAssociation.mjs +89 -1
  333. package/dist/esm/record/verifyRecordRightOfAssociation.mjs.map +1 -1
  334. package/dist/esm/record/verifyRecordStaleness.mjs +50 -1
  335. package/dist/esm/record/verifyRecordStaleness.mjs.map +1 -1
  336. package/dist/esm/states/index.mjs +4 -1
  337. package/dist/esm/states/index.mjs.map +1 -1
  338. package/dist/esm/states/nft.mjs +105 -1
  339. package/dist/esm/states/nft.mjs.map +1 -1
  340. package/dist/esm/states/primaryDomain.mjs +61 -1
  341. package/dist/esm/states/primaryDomain.mjs.map +1 -1
  342. package/dist/esm/states/record.mjs +113 -1
  343. package/dist/esm/states/record.mjs.map +1 -1
  344. package/dist/esm/states/registry.mjs +64 -1
  345. package/dist/esm/states/registry.mjs.map +1 -1
  346. package/dist/esm/types/index.mjs +2 -1
  347. package/dist/esm/types/index.mjs.map +1 -1
  348. package/dist/esm/types/record.mjs +52 -1
  349. package/dist/esm/types/record.mjs.map +1 -1
  350. package/dist/esm/types/validation.mjs +10 -1
  351. package/dist/esm/types/validation.mjs.map +1 -1
  352. package/dist/esm/utils/assertTldSupported.mjs +24 -0
  353. package/dist/esm/utils/assertTldSupported.mjs.map +1 -0
  354. package/dist/esm/utils/check.mjs +16 -1
  355. package/dist/esm/utils/check.mjs.map +1 -1
  356. package/dist/esm/utils/checkAddressOnCurve/ed25519.mjs +76 -2
  357. package/dist/esm/utils/checkAddressOnCurve/ed25519.mjs.map +1 -1
  358. package/dist/esm/utils/checkAddressOnCurve/index.mjs +38 -1
  359. package/dist/esm/utils/checkAddressOnCurve/index.mjs.map +1 -1
  360. package/dist/esm/utils/deriveAddress.mjs +51 -1
  361. package/dist/esm/utils/deriveAddress.mjs.map +1 -1
  362. package/dist/esm/utils/deserializers/deserializeRecordContent.mjs +60 -1
  363. package/dist/esm/utils/deserializers/deserializeRecordContent.mjs.map +1 -1
  364. package/dist/esm/utils/deserializers/deserializeReverse.mjs +13 -1
  365. package/dist/esm/utils/deserializers/deserializeReverse.mjs.map +1 -1
  366. package/dist/esm/utils/getPythFeedAddress.mjs +28 -1
  367. package/dist/esm/utils/getPythFeedAddress.mjs.map +1 -1
  368. package/dist/esm/utils/getReverseAddress.mjs +25 -1
  369. package/dist/esm/utils/getReverseAddress.mjs.map +1 -1
  370. package/dist/esm/utils/getReverseAddressFromDomainAddress.mjs +21 -1
  371. package/dist/esm/utils/getReverseAddressFromDomainAddress.mjs.map +1 -1
  372. package/dist/esm/utils/index.mjs +10 -1
  373. package/dist/esm/utils/index.mjs.map +1 -1
  374. package/dist/esm/utils/parseSnsDomain.mjs +60 -0
  375. package/dist/esm/utils/parseSnsDomain.mjs.map +1 -0
  376. package/dist/esm/utils/reverseLookup.mjs +36 -1
  377. package/dist/esm/utils/reverseLookup.mjs.map +1 -1
  378. package/dist/esm/utils/reverseLookupBatch.mjs +26 -1
  379. package/dist/esm/utils/reverseLookupBatch.mjs.map +1 -1
  380. package/dist/esm/utils/serializers/serializeRecordContent.mjs +86 -1
  381. package/dist/esm/utils/serializers/serializeRecordContent.mjs.map +1 -1
  382. package/dist/esm/utils/tld.mjs +58 -0
  383. package/dist/esm/utils/tld.mjs.map +1 -0
  384. package/dist/esm/utils/uint8Array/uint8ArrayFromHex.mjs +16 -1
  385. package/dist/esm/utils/uint8Array/uint8ArrayFromHex.mjs.map +1 -1
  386. package/dist/esm/utils/uint8Array/uint8ArrayToHex.mjs +12 -1
  387. package/dist/esm/utils/uint8Array/uint8ArrayToHex.mjs.map +1 -1
  388. package/dist/esm/utils/uint8Array/uint8ArraysEqual.mjs +16 -1
  389. package/dist/esm/utils/uint8Array/uint8ArraysEqual.mjs.map +1 -1
  390. package/dist/types/address/index.d.ts +193 -4
  391. package/dist/types/bindings/index.d.ts +821 -17
  392. package/dist/types/codecs.d.ts +16 -5
  393. package/dist/types/constants/index.d.ts +141 -3
  394. package/dist/types/domain/index.d.ts +559 -7
  395. package/dist/types/errors.d.ts +73 -85
  396. package/dist/types/index.d.ts +3038 -74
  397. package/dist/types/instructions/index.d.ts +523 -19
  398. package/dist/types/nft/index.d.ts +59 -2
  399. package/dist/types/record/index.d.ts +254 -4
  400. package/dist/types/states/index.d.ts +235 -4
  401. package/dist/types/types/index.d.ts +50 -2
  402. package/dist/types/utils/index.d.ts +346 -10
  403. package/package.json +47 -41
  404. package/dist/cjs/_virtual/ipaddr.cjs +0 -2
  405. package/dist/cjs/_virtual/ipaddr.cjs.map +0 -1
  406. package/dist/cjs/_virtual/ipaddr2.cjs +0 -2
  407. package/dist/cjs/_virtual/ipaddr2.cjs.map +0 -1
  408. package/dist/cjs/address/getDomainsForAddress.cjs +0 -2
  409. package/dist/cjs/address/getDomainsForAddress.cjs.map +0 -1
  410. package/dist/cjs/address/getNftsForAddress.cjs +0 -2
  411. package/dist/cjs/address/getNftsForAddress.cjs.map +0 -1
  412. package/dist/cjs/bindings/registerWithNft.cjs +0 -2
  413. package/dist/cjs/bindings/registerWithNft.cjs.map +0 -1
  414. package/dist/cjs/bindings/validateRoa.cjs +0 -2
  415. package/dist/cjs/bindings/validateRoa.cjs.map +0 -1
  416. package/dist/cjs/bindings/validateRoaEthereum.cjs +0 -2
  417. package/dist/cjs/bindings/validateRoaEthereum.cjs.map +0 -1
  418. package/dist/cjs/bindings/writeRoa.cjs +0 -2
  419. package/dist/cjs/bindings/writeRoa.cjs.map +0 -1
  420. package/dist/cjs/domain/getAllDomains.cjs +0 -2
  421. package/dist/cjs/domain/getAllDomains.cjs.map +0 -1
  422. package/dist/cjs/domain/getDomainAddress.cjs +0 -2
  423. package/dist/cjs/domain/getDomainAddress.cjs.map +0 -1
  424. package/dist/cjs/domain/resolveDomain.cjs +0 -2
  425. package/dist/cjs/domain/resolveDomain.cjs.map +0 -1
  426. package/dist/cjs/instructions/createAtaInstruction.cjs +0 -2
  427. package/dist/cjs/instructions/createAtaInstruction.cjs.map +0 -1
  428. package/dist/cjs/instructions/createInstructionV3.cjs +0 -2
  429. package/dist/cjs/instructions/createInstructionV3.cjs.map +0 -1
  430. package/dist/cjs/instructions/createV2Instruction.cjs +0 -2
  431. package/dist/cjs/instructions/createV2Instruction.cjs.map +0 -1
  432. package/dist/cjs/instructions/registerFavoriteInstruction.cjs +0 -2
  433. package/dist/cjs/instructions/registerFavoriteInstruction.cjs.map +0 -1
  434. package/dist/cjs/instructions/validateRoaEthereumInstruction.cjs +0 -2
  435. package/dist/cjs/instructions/validateRoaEthereumInstruction.cjs.map +0 -1
  436. package/dist/cjs/instructions/validateRoaInstruction.cjs +0 -2
  437. package/dist/cjs/instructions/validateRoaInstruction.cjs.map +0 -1
  438. package/dist/cjs/instructions/writeRoaInstruction.cjs +0 -2
  439. package/dist/cjs/instructions/writeRoaInstruction.cjs.map +0 -1
  440. package/dist/cjs/nft/getNftMint.cjs +0 -2
  441. package/dist/cjs/nft/getNftMint.cjs.map +0 -1
  442. package/dist/cjs/nft/getNftOwner.cjs +0 -2
  443. package/dist/cjs/nft/getNftOwner.cjs.map +0 -1
  444. package/dist/cjs/node_modules/@scure/base/lib/esm/index.cjs +0 -3
  445. package/dist/cjs/node_modules/@scure/base/lib/esm/index.cjs.map +0 -1
  446. package/dist/cjs/node_modules/@solana-program/token/dist/src/index.cjs +0 -2
  447. package/dist/cjs/node_modules/@solana-program/token/dist/src/index.cjs.map +0 -1
  448. package/dist/cjs/node_modules/borsh/lib/esm/buffer.cjs +0 -2
  449. package/dist/cjs/node_modules/borsh/lib/esm/buffer.cjs.map +0 -1
  450. package/dist/cjs/node_modules/borsh/lib/esm/deserialize.cjs +0 -2
  451. package/dist/cjs/node_modules/borsh/lib/esm/deserialize.cjs.map +0 -1
  452. package/dist/cjs/node_modules/borsh/lib/esm/index.cjs +0 -2
  453. package/dist/cjs/node_modules/borsh/lib/esm/index.cjs.map +0 -1
  454. package/dist/cjs/node_modules/borsh/lib/esm/serialize.cjs +0 -2
  455. package/dist/cjs/node_modules/borsh/lib/esm/serialize.cjs.map +0 -1
  456. package/dist/cjs/node_modules/borsh/lib/esm/types.cjs +0 -2
  457. package/dist/cjs/node_modules/borsh/lib/esm/types.cjs.map +0 -1
  458. package/dist/cjs/node_modules/borsh/lib/esm/utils.cjs +0 -2
  459. package/dist/cjs/node_modules/borsh/lib/esm/utils.cjs.map +0 -1
  460. package/dist/cjs/node_modules/ipaddr.js/lib/ipaddr.cjs +0 -2
  461. package/dist/cjs/node_modules/ipaddr.js/lib/ipaddr.cjs.map +0 -1
  462. package/dist/cjs/node_modules/punycode/punycode.es6.cjs +0 -2
  463. package/dist/cjs/node_modules/punycode/punycode.es6.cjs.map +0 -1
  464. package/dist/esm/_virtual/ipaddr.mjs +0 -2
  465. package/dist/esm/_virtual/ipaddr.mjs.map +0 -1
  466. package/dist/esm/_virtual/ipaddr2.mjs +0 -2
  467. package/dist/esm/_virtual/ipaddr2.mjs.map +0 -1
  468. package/dist/esm/address/getDomainsForAddress.mjs +0 -2
  469. package/dist/esm/address/getDomainsForAddress.mjs.map +0 -1
  470. package/dist/esm/address/getNftsForAddress.mjs +0 -2
  471. package/dist/esm/address/getNftsForAddress.mjs.map +0 -1
  472. package/dist/esm/bindings/registerWithNft.mjs +0 -2
  473. package/dist/esm/bindings/registerWithNft.mjs.map +0 -1
  474. package/dist/esm/bindings/validateRoa.mjs +0 -2
  475. package/dist/esm/bindings/validateRoa.mjs.map +0 -1
  476. package/dist/esm/bindings/validateRoaEthereum.mjs +0 -2
  477. package/dist/esm/bindings/validateRoaEthereum.mjs.map +0 -1
  478. package/dist/esm/bindings/writeRoa.mjs +0 -2
  479. package/dist/esm/bindings/writeRoa.mjs.map +0 -1
  480. package/dist/esm/domain/getAllDomains.mjs +0 -2
  481. package/dist/esm/domain/getAllDomains.mjs.map +0 -1
  482. package/dist/esm/domain/getDomainAddress.mjs +0 -2
  483. package/dist/esm/domain/getDomainAddress.mjs.map +0 -1
  484. package/dist/esm/domain/resolveDomain.mjs +0 -2
  485. package/dist/esm/domain/resolveDomain.mjs.map +0 -1
  486. package/dist/esm/instructions/createAtaInstruction.mjs +0 -2
  487. package/dist/esm/instructions/createAtaInstruction.mjs.map +0 -1
  488. package/dist/esm/instructions/createInstructionV3.mjs +0 -2
  489. package/dist/esm/instructions/createInstructionV3.mjs.map +0 -1
  490. package/dist/esm/instructions/createV2Instruction.mjs +0 -2
  491. package/dist/esm/instructions/createV2Instruction.mjs.map +0 -1
  492. package/dist/esm/instructions/registerFavoriteInstruction.mjs +0 -2
  493. package/dist/esm/instructions/registerFavoriteInstruction.mjs.map +0 -1
  494. package/dist/esm/instructions/validateRoaEthereumInstruction.mjs +0 -2
  495. package/dist/esm/instructions/validateRoaEthereumInstruction.mjs.map +0 -1
  496. package/dist/esm/instructions/validateRoaInstruction.mjs +0 -2
  497. package/dist/esm/instructions/validateRoaInstruction.mjs.map +0 -1
  498. package/dist/esm/instructions/writeRoaInstruction.mjs +0 -2
  499. package/dist/esm/instructions/writeRoaInstruction.mjs.map +0 -1
  500. package/dist/esm/nft/getNftMint.mjs +0 -2
  501. package/dist/esm/nft/getNftMint.mjs.map +0 -1
  502. package/dist/esm/nft/getNftOwner.mjs +0 -2
  503. package/dist/esm/nft/getNftOwner.mjs.map +0 -1
  504. package/dist/esm/node_modules/@scure/base/lib/esm/index.mjs +0 -3
  505. package/dist/esm/node_modules/@scure/base/lib/esm/index.mjs.map +0 -1
  506. package/dist/esm/node_modules/@solana-program/token/dist/src/index.mjs +0 -2
  507. package/dist/esm/node_modules/@solana-program/token/dist/src/index.mjs.map +0 -1
  508. package/dist/esm/node_modules/borsh/lib/esm/buffer.mjs +0 -2
  509. package/dist/esm/node_modules/borsh/lib/esm/buffer.mjs.map +0 -1
  510. package/dist/esm/node_modules/borsh/lib/esm/deserialize.mjs +0 -2
  511. package/dist/esm/node_modules/borsh/lib/esm/deserialize.mjs.map +0 -1
  512. package/dist/esm/node_modules/borsh/lib/esm/index.mjs +0 -2
  513. package/dist/esm/node_modules/borsh/lib/esm/index.mjs.map +0 -1
  514. package/dist/esm/node_modules/borsh/lib/esm/serialize.mjs +0 -2
  515. package/dist/esm/node_modules/borsh/lib/esm/serialize.mjs.map +0 -1
  516. package/dist/esm/node_modules/borsh/lib/esm/types.mjs +0 -2
  517. package/dist/esm/node_modules/borsh/lib/esm/types.mjs.map +0 -1
  518. package/dist/esm/node_modules/borsh/lib/esm/utils.mjs +0 -2
  519. package/dist/esm/node_modules/borsh/lib/esm/utils.mjs.map +0 -1
  520. package/dist/esm/node_modules/ipaddr.js/lib/ipaddr.mjs +0 -2
  521. package/dist/esm/node_modules/ipaddr.js/lib/ipaddr.mjs.map +0 -1
  522. package/dist/esm/node_modules/punycode/punycode.es6.mjs +0 -2
  523. package/dist/esm/node_modules/punycode/punycode.es6.mjs.map +0 -1
  524. package/dist/types/address/getDomainsForAddress.d.ts +0 -19
  525. package/dist/types/address/getNftsForAddress.d.ts +0 -20
  526. package/dist/types/address/getPrimaryDomain.d.ts +0 -22
  527. package/dist/types/address/getPrimaryDomainsBatch.d.ts +0 -16
  528. package/dist/types/bindings/burnDomain.d.ts +0 -17
  529. package/dist/types/bindings/createNameRegistry.d.ts +0 -28
  530. package/dist/types/bindings/createRecord.d.ts +0 -23
  531. package/dist/types/bindings/createReverse.d.ts +0 -21
  532. package/dist/types/bindings/createSubdomain.d.ts +0 -23
  533. package/dist/types/bindings/deleteNameRegistry.d.ts +0 -21
  534. package/dist/types/bindings/deleteRecord.d.ts +0 -20
  535. package/dist/types/bindings/registerDomain.d.ts +0 -25
  536. package/dist/types/bindings/registerWithNft.d.ts +0 -21
  537. package/dist/types/bindings/setPrimaryDomain.d.ts +0 -16
  538. package/dist/types/bindings/transferDomain.d.ts +0 -23
  539. package/dist/types/bindings/transferSubdomain.d.ts +0 -25
  540. package/dist/types/bindings/updateNameRegistry.d.ts +0 -22
  541. package/dist/types/bindings/updateRecord.d.ts +0 -22
  542. package/dist/types/bindings/validateRoa.d.ts +0 -24
  543. package/dist/types/bindings/validateRoaEthereum.d.ts +0 -24
  544. package/dist/types/bindings/writeRoa.d.ts +0 -22
  545. package/dist/types/constants/addresses.d.ts +0 -53
  546. package/dist/types/constants/pythFeeds.d.ts +0 -3
  547. package/dist/types/constants/records.d.ts +0 -23
  548. package/dist/types/domain/getAllDomains.d.ts +0 -16
  549. package/dist/types/domain/getDomainAddress.d.ts +0 -30
  550. package/dist/types/domain/getDomainOwner.d.ts +0 -16
  551. package/dist/types/domain/getDomainRecord.d.ts +0 -35
  552. package/dist/types/domain/getDomainRecords.d.ts +0 -39
  553. package/dist/types/domain/getSubdomains.d.ts +0 -19
  554. package/dist/types/domain/resolveDomain.d.ts +0 -26
  555. package/dist/types/instructions/allocateAndPostRecordInstruction.d.ts +0 -23
  556. package/dist/types/instructions/burnDomainInstruction.d.ts +0 -12
  557. package/dist/types/instructions/createAtaInstruction.d.ts +0 -2
  558. package/dist/types/instructions/createInstructionV3.d.ts +0 -24
  559. package/dist/types/instructions/createNameRegistryInstruction.d.ts +0 -26
  560. package/dist/types/instructions/createReverseInstruction.d.ts +0 -16
  561. package/dist/types/instructions/createSplitV2Instruction.d.ts +0 -24
  562. package/dist/types/instructions/createV2Instruction.d.ts +0 -19
  563. package/dist/types/instructions/createWithNftInstruction.d.ts +0 -19
  564. package/dist/types/instructions/deleteNameRegistryInstruction.d.ts +0 -12
  565. package/dist/types/instructions/deleteRecordInstruction.d.ts +0 -12
  566. package/dist/types/instructions/reallocInstruction.d.ts +0 -16
  567. package/dist/types/instructions/registerFavoriteInstruction.d.ts +0 -12
  568. package/dist/types/instructions/transferInstruction.d.ts +0 -21
  569. package/dist/types/instructions/updateNameRegistryInstruction.d.ts +0 -23
  570. package/dist/types/instructions/updateRecordInstruction.d.ts +0 -23
  571. package/dist/types/instructions/validateRoaEthereumInstruction.d.ts +0 -30
  572. package/dist/types/instructions/validateRoaInstruction.d.ts +0 -16
  573. package/dist/types/instructions/writeRoaInstruction.d.ts +0 -20
  574. package/dist/types/nft/getNftMint.d.ts +0 -13
  575. package/dist/types/nft/getNftOwner.d.ts +0 -15
  576. package/dist/types/record/getRecordV1Address.d.ts +0 -15
  577. package/dist/types/record/getRecordV2Address.d.ts +0 -16
  578. package/dist/types/record/verifyRecordRightOfAssociation.d.ts +0 -40
  579. package/dist/types/record/verifyRecordStaleness.d.ts +0 -31
  580. package/dist/types/states/nft.d.ts +0 -50
  581. package/dist/types/states/primaryDomain.d.ts +0 -25
  582. package/dist/types/states/record.d.ts +0 -30
  583. package/dist/types/states/registry.d.ts +0 -39
  584. package/dist/types/types/record.d.ts +0 -38
  585. package/dist/types/types/validation.d.ts +0 -6
  586. package/dist/types/utils/check.d.ts +0 -10
  587. package/dist/types/utils/checkAddressOnCurve/ed25519.d.ts +0 -1
  588. package/dist/types/utils/checkAddressOnCurve/index.d.ts +0 -2
  589. package/dist/types/utils/deriveAddress.d.ts +0 -28
  590. package/dist/types/utils/deserializers/deserializeRecordContent.d.ts +0 -17
  591. package/dist/types/utils/deserializers/deserializeReverse.d.ts +0 -16
  592. package/dist/types/utils/getPythFeedAddress.d.ts +0 -14
  593. package/dist/types/utils/getReverseAddress.d.ts +0 -1
  594. package/dist/types/utils/getReverseAddressFromDomainAddress.d.ts +0 -15
  595. package/dist/types/utils/reverseLookup.d.ts +0 -18
  596. package/dist/types/utils/reverseLookupBatch.d.ts +0 -16
  597. package/dist/types/utils/serializers/serializeRecordContent.d.ts +0 -16
  598. package/dist/types/utils/uint8Array/uint8ArrayFromHex.d.ts +0 -6
  599. package/dist/types/utils/uint8Array/uint8ArrayToHex.d.ts +0 -7
  600. package/dist/types/utils/uint8Array/uint8ArraysConcat.d.ts +0 -8
  601. package/dist/types/utils/uint8Array/uint8ArraysEqual.d.ts +0 -9
@@ -1,2 +1,24 @@
1
- import{getNftOwner as r}from"../nft/getNftOwner.mjs";import{RegistryState as t}from"../states/registry.mjs";import{getDomainAddress as o}from"./getDomainAddress.mjs";const s=async({rpc:s,domain:e})=>{const{domainAddress:m}=await o({domain:e}),[i,a]=await Promise.all([t.retrieve(s,m),r({rpc:s,domainAddress:m})]);return a||i.owner};export{s as getDomainOwner};
1
+ import { assertTldSupported } from '../utils/assertTldSupported.mjs';
2
+ import { _getSnsDomainOwner } from './getSnsDomainOwner.mjs';
3
+
4
+ /**
5
+ * Retrieves the owner of the specified domain. If the domain is tokenized,
6
+ * the NFT's owner is returned; otherwise, the registry owner is returned.
7
+ *
8
+ * @param params Domain owner retrieval parameters
9
+ * @param params.rpc RPC client implementing account and token-largest-account APIs
10
+ * @param params.domain Full domain name including a `.sns` or `.sol` suffix
11
+ * @returns The domain owner address.
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * const owner = await getDomainOwner({ rpc, domain: "example.sns" });
16
+ * ```
17
+ */
18
+ const getDomainOwner = async ({ rpc, domain }) => {
19
+ const [trimmedDomain] = await assertTldSupported({ rpc, domain });
20
+ return _getSnsDomainOwner({ rpc, domain: trimmedDomain });
21
+ };
22
+
23
+ export { getDomainOwner };
2
24
  //# sourceMappingURL=getDomainOwner.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"getDomainOwner.mjs","sources":["../../../src/domain/getDomainOwner.ts"],"sourcesContent":["import {\r\n GetAccountInfoApi,\r\n GetTokenLargestAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { getNftOwner } from \"../nft/getNftOwner\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { getDomainAddress } from \"./getDomainAddress\";\r\n\r\ninterface GetDomainOwnerParams {\r\n rpc: Rpc<GetAccountInfoApi & GetTokenLargestAccountsApi>;\r\n domain: string;\r\n}\r\n\r\n/**\r\n * Retrieves the owner of the specified domain. If the domain is tokenized,\r\n * the NFT's owner is returned; otherwise, the registry owner is returned.\r\n *\r\n * @param params - An object containing the following properties:\r\n * - `rpc`: An RPC interface implementing GetAccountInfoApi and GetTokenLargestAccountsApi.\r\n * - `domain`: The domain whose owner is to be retrieved.\r\n * @returns A promise that resolves to the owner of the domain.\r\n */\r\nexport const getDomainOwner = async ({ rpc, domain }: GetDomainOwnerParams) => {\r\n const { domainAddress } = await getDomainAddress({ domain });\r\n const [registry, nftOwner] = await Promise.all([\r\n RegistryState.retrieve(rpc, domainAddress),\r\n getNftOwner({ rpc, domainAddress }),\r\n ]);\r\n return nftOwner || registry.owner;\r\n};\r\n"],"names":["getDomainOwner","async","rpc","domain","domainAddress","getDomainAddress","registry","nftOwner","Promise","all","RegistryState","retrieve","getNftOwner","owner"],"mappings":"sKAwBO,MAAMA,EAAiBC,OAASC,MAAKC,aAC1C,MAAMC,cAAEA,SAAwBC,EAAiB,CAAEF,YAC5CG,EAAUC,SAAkBC,QAAQC,IAAI,CAC7CC,EAAcC,SAAST,EAAKE,GAC5BQ,EAAY,CAAEV,MAAKE,oBAErB,OAAOG,GAAYD,EAASO,KAAK"}
1
+ {"version":3,"file":"getDomainOwner.mjs","sources":["../../../src/domain/getDomainOwner.ts"],"sourcesContent":["import {\r\n GetAccountInfoApi,\r\n GetSlotApi,\r\n GetTokenLargestAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\r\nimport { _getSnsDomainOwner } from \"./getSnsDomainOwner\";\r\n\r\n/**\r\n * Parameters for retrieving a domain owner.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetDomainOwnerParams = { rpc, domain: \"example.sns\" };\r\n * ```\r\n */\r\nexport interface GetDomainOwnerParams {\r\n /** RPC client. */\r\n rpc: Rpc<GetAccountInfoApi & GetTokenLargestAccountsApi & GetSlotApi>;\r\n /** Full domain name. */\r\n domain: string;\r\n}\r\n\r\n/**\r\n * Retrieves the owner of the specified domain. If the domain is tokenized,\r\n * the NFT's owner is returned; otherwise, the registry owner is returned.\r\n *\r\n * @param params Domain owner retrieval parameters\r\n * @param params.rpc RPC client implementing account and token-largest-account APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @returns The domain owner address.\r\n *\r\n * @example\r\n * ```ts\r\n * const owner = await getDomainOwner({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const getDomainOwner = async ({ rpc, domain }: GetDomainOwnerParams) => {\r\n const [trimmedDomain] = await assertTldSupported({ rpc, domain });\r\n return _getSnsDomainOwner({ rpc, domain: trimmedDomain });\r\n};\r\n"],"names":[],"mappings":";;;AAyBA;;;;;;;;;;;;;AAaG;AACI,MAAM,cAAc,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAwB,KAAI;AAC5E,IAAA,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACjE,OAAO,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAC3D;;;;"}
@@ -1,2 +1,51 @@
1
- import{getRecordV2Address as e}from"../record/getRecordV2Address.mjs";import{_getDefaultVerifier as r,_verifyRoaSync as o}from"../record/verifyRecordRightOfAssociation.mjs";import{_verifyStalenessSync as t}from"../record/verifyRecordStaleness.mjs";import{RecordState as i}from"../states/record.mjs";import{deserializeRecordContent as s}from"../utils/deserializers/deserializeRecordContent.mjs";import{getDomainOwner as d}from"./getDomainOwner.mjs";async function n({rpc:n,domain:m,record:c,options:a={}}){const[f,p]=await Promise.all([d({rpc:n,domain:m}),e({domain:m,record:c}).then((e=>i.retrieve(n,e)))]),l=a.verifier||r({record:c,state:p});return{record:c,retrievedRecord:p,verified:{staleness:t({domainOwner:f,state:p}),...l&&{rightOfAssociation:o({record:c,state:p,verifier:l})}},...a.deserialize&&{deserializedContent:s({content:p.getContent(),record:c})}}}export{n as getDomainRecord};
1
+ import { getRecordV2Address } from '../record/getRecordV2Address.mjs';
2
+ import { _getDefaultVerifier, _verifyRoaSync } from '../record/verifyRecordRightOfAssociation.mjs';
3
+ import { _verifyStalenessSync } from '../record/verifyRecordStaleness.mjs';
4
+ import { RecordState } from '../states/record.mjs';
5
+ import { assertTldSupported } from '../utils/assertTldSupported.mjs';
6
+ import { deserializeRecordContent } from '../utils/deserializers/deserializeRecordContent.mjs';
7
+ import { _getSnsDomainOwner } from './getSnsDomainOwner.mjs';
8
+
9
+ /**
10
+ * Retrieves a V2 record under a domain, verifies it, and optionally decodes its content.
11
+ *
12
+ * @param params Record retrieval parameters
13
+ * @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs
14
+ * @param params.domain Full domain name including a `.sns` or `.sol` suffix
15
+ * @param params.record Record type to retrieve
16
+ * @param params.options Optional record processing options
17
+ * @returns The V2 record state, its verification result, and optional decoded content
18
+ *
19
+ * @example
20
+ * ```ts
21
+ * const result = await getDomainRecord({ rpc, domain: "example.sns", record: Record.Url });
22
+ * ```
23
+ */
24
+ async function getDomainRecord({ rpc, domain, record, options = {}, }) {
25
+ const [trimmedDomain] = await assertTldSupported({ rpc, domain });
26
+ const [domainOwner, state] = await Promise.all([
27
+ _getSnsDomainOwner({ rpc, domain: trimmedDomain }),
28
+ getRecordV2Address({ domain: trimmedDomain, record }).then((address) => RecordState.retrieve(rpc, address)),
29
+ ]);
30
+ const verifier = options.verifier || _getDefaultVerifier({ record, state });
31
+ const verified = {
32
+ staleness: _verifyStalenessSync({ domainOwner, state }),
33
+ ...(verifier && {
34
+ roa: _verifyRoaSync({ record, state, verifier }),
35
+ }),
36
+ };
37
+ return {
38
+ record,
39
+ retrievedRecord: state,
40
+ verified,
41
+ ...(options.deserialize && {
42
+ deserializedContent: deserializeRecordContent({
43
+ content: state.getContent(),
44
+ record,
45
+ }),
46
+ }),
47
+ };
48
+ }
49
+
50
+ export { getDomainRecord };
2
51
  //# sourceMappingURL=getDomainRecord.mjs.map
@@ -1 +1 @@
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 { getDomainOwner } from \"./getDomainOwner\";\r\n\r\ninterface GetDomainRecordParams {\r\n rpc: Rpc<\r\n GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi\r\n >;\r\n domain: string;\r\n record: Record;\r\n options?: {\r\n deserialize?: boolean;\r\n verifier?: ReadonlyUint8Array;\r\n };\r\n}\r\n\r\ninterface Result {\r\n record: Record;\r\n retrievedRecord: RecordState;\r\n verified: {\r\n staleness: boolean;\r\n roa?: boolean;\r\n };\r\n deserializedContent?: string;\r\n}\r\n\r\n/**\r\n * Retrieves a specific record under a domain, verifies its state, and optionally deserializes its content.\r\n *\r\n * @param params - An object containing the following properties:\r\n * - `rpc`: An RPC interface implementing GetAccountInfoApi, GetMultipleAccountsApi, and GetTokenLargestAccountsApi.\r\n * - `domain`: The domain whose record is to be retrieved.\r\n * - `record`: The type of record to retrieve.\r\n * - `options`: (Optional) Additional options for processing:\r\n * - `deserialize`: Whether to deserialize the record content.\r\n * - `verifier`: A custom verifier for the record.\r\n * @returns A promise that resolves to the retrieved record, its verification status, and optionally its deserialized content.\r\n */\r\nexport async function getDomainRecord({\r\n rpc,\r\n domain,\r\n record,\r\n options = {},\r\n}: GetDomainRecordParams): Promise<Result> {\r\n const [domainOwner, state] = await Promise.all([\r\n getDomainOwner({ rpc, domain }),\r\n getRecordV2Address({ domain, 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 rightOfAssociation: _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":["async","getDomainRecord","rpc","domain","record","options","domainOwner","state","Promise","all","getDomainOwner","getRecordV2Address","then","address","RecordState","retrieve","verifier","_getDefaultVerifier","retrievedRecord","verified","staleness","_verifyStalenessSync","rightOfAssociation","_verifyRoaSync","deserialize","deserializedContent","deserializeRecordContent","content","getContent"],"mappings":"gcAqDOA,eAAeC,GAAgBC,IACpCA,EAAGC,OACHA,EAAMC,OACNA,EAAMC,QACNA,EAAU,CAAA,IAEV,MAAOC,EAAaC,SAAeC,QAAQC,IAAI,CAC7CC,EAAe,CAAER,MAAKC,WACtBQ,EAAmB,CAAER,SAAQC,WAAUQ,MAAMC,GAC3CC,EAAYC,SAASb,EAAKW,OAIxBG,EAAWX,EAAQW,UAAYC,EAAoB,CAAEb,SAAQG,UAQnE,MAAO,CACLH,SACAc,gBAAiBX,EACjBY,SAVe,CACfC,UAAWC,EAAqB,CAAEf,cAAaC,aAC3CS,GAAY,CACdM,mBAAoBC,EAAe,CAAEnB,SAAQG,QAAOS,kBAQlDX,EAAQmB,aAAe,CACzBC,oBAAqBC,EAAyB,CAC5CC,QAASpB,EAAMqB,aACfxB,YAIR"}
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,2 +1,61 @@
1
- import{MissingVerifierError as e}from"../errors.mjs";import{getRecordV2Address as r}from"../record/getRecordV2Address.mjs";import{_getDefaultVerifier as o,_verifyRoaSync as t}from"../record/verifyRecordRightOfAssociation.mjs";import{_verifyStalenessSync as i}from"../record/verifyRecordStaleness.mjs";import{RecordState as s}from"../states/record.mjs";import{deserializeRecordContent as n}from"../utils/deserializers/deserializeRecordContent.mjs";import{getDomainOwner as m}from"./getDomainOwner.mjs";async function d({rpc:d,domain:a,records:c,options:f={}}){const l=f.verifiers;if(l&&l.length!==c.length)throw new e("The number of verifiers must be the same as the number of records");const[p,h]=await Promise.all([m({rpc:d,domain:a}),Promise.all(c.map((e=>r({domain:a,record:e})))).then((e=>s.retrieveBatch(d,e)))]);return h.map(((e,r)=>{if(!e)return;const s=c[r],m=f.verifiers?.[r]||o({record:s,state:e});return{record:s,retrievedRecord:e,verified:{staleness:i({domainOwner:p,state:e}),...m&&{rightOfAssociation:t({record:s,state:e,verifier:m})}},...f.deserialize&&{deserializedContent:n({content:e.getContent(),record:s})}}}))}export{d as getDomainRecords};
1
+ import { MissingVerifierError } from '../errors.mjs';
2
+ import { getRecordV2Address } from '../record/getRecordV2Address.mjs';
3
+ import { _getDefaultVerifier, _verifyRoaSync } from '../record/verifyRecordRightOfAssociation.mjs';
4
+ import { _verifyStalenessSync } from '../record/verifyRecordStaleness.mjs';
5
+ import { RecordState } from '../states/record.mjs';
6
+ import { assertTldSupported } from '../utils/assertTldSupported.mjs';
7
+ import { deserializeRecordContent } from '../utils/deserializers/deserializeRecordContent.mjs';
8
+ import { _getSnsDomainOwner } from './getSnsDomainOwner.mjs';
9
+
10
+ /**
11
+ * Retrieves V2 records under a domain, verifies them, and optionally decodes their content.
12
+ *
13
+ * @param params Record retrieval parameters
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
16
+ * @param params.records Record types to retrieve
17
+ * @param params.options Optional record processing options
18
+ * @returns Results aligned with `records`; missing V2 record accounts produce `undefined`
19
+ *
20
+ * @example
21
+ * ```ts
22
+ * const results = await getDomainRecords({ rpc, domain: "example.sns", records: [Record.Url] });
23
+ * ```
24
+ */
25
+ async function getDomainRecords({ rpc, domain, records, options = {}, }) {
26
+ const verifiers = options.verifiers;
27
+ if (verifiers && verifiers.length !== records.length) {
28
+ throw new MissingVerifierError("The number of verifiers must be the same as the number of records");
29
+ }
30
+ const [trimmedDomain] = await assertTldSupported({ rpc, domain });
31
+ const [domainOwner, states] = await Promise.all([
32
+ _getSnsDomainOwner({ rpc, domain: trimmedDomain }),
33
+ Promise.all(records.map((record) => getRecordV2Address({ domain: trimmedDomain, record }))).then((addresses) => RecordState.retrieveBatch(rpc, addresses)),
34
+ ]);
35
+ return states.map((state, idx) => {
36
+ if (!state)
37
+ return undefined;
38
+ const record = records[idx];
39
+ const verifier = options.verifiers?.[idx] || _getDefaultVerifier({ record, state });
40
+ const verified = {
41
+ staleness: _verifyStalenessSync({ domainOwner, state }),
42
+ ...(verifier && {
43
+ roa: _verifyRoaSync({ record, state, verifier }),
44
+ }),
45
+ };
46
+ return {
47
+ record,
48
+ retrievedRecord: state,
49
+ verified,
50
+ ...(options.deserialize && {
51
+ deserializedContent: deserializeRecordContent({
52
+ content: state.getContent(),
53
+ record,
54
+ }),
55
+ }),
56
+ };
57
+ });
58
+ }
59
+
60
+ export { getDomainRecords };
2
61
  //# sourceMappingURL=getDomainRecords.mjs.map
@@ -1 +1 @@
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 { getDomainOwner } from \"./getDomainOwner\";\r\n\r\ninterface GetDomainRecordsParams<\r\n T extends Record[],\r\n U extends { [K in keyof T]: ReadonlyUint8Array | undefined },\r\n> {\r\n rpc: Rpc<\r\n GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi\r\n >;\r\n domain: string;\r\n records: [...T];\r\n options?: {\r\n deserialize?: boolean;\r\n verifiers?: [...U];\r\n };\r\n}\r\n\r\ninterface Result {\r\n record: Record;\r\n retrievedRecord: RecordState;\r\n verified: {\r\n staleness: boolean;\r\n roa?: boolean;\r\n };\r\n deserializedContent?: string;\r\n}\r\n\r\n/**\r\n * Retrieves multiple records under a domain, verifies their state, and optionally deserializes their content.\r\n *\r\n * @param params - An object containing the following properties:\r\n * - `rpc`: An RPC interface implementing GetAccountInfoApi, GetMultipleAccountsApi, and GetTokenLargestAccountsApi.\r\n * - `domain`: The domain whose records are to be retrieved.\r\n * - `records`: An array of record types to retrieve.\r\n * - `options`: (Optional) Additional options for processing:\r\n * - `deserialize`: Whether to deserialize the record content.\r\n * - `verifiers`: An array of custom verifiers for the records.\r\n * @returns A promise that resolves to an array of results for the retrieved records, including their verification status and optionally their deserialized content.\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<(Result | undefined)[]> {\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 [domainOwner, states] = await Promise.all([\r\n getDomainOwner({ rpc, domain }),\r\n Promise.all(\r\n records.map((record) => getRecordV2Address({ domain, record }))\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 rightOfAssociation: _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":["async","getDomainRecords","rpc","domain","records","options","verifiers","length","MissingVerifierError","domainOwner","states","Promise","all","getDomainOwner","map","record","getRecordV2Address","then","addresses","RecordState","retrieveBatch","state","idx","verifier","_getDefaultVerifier","retrievedRecord","verified","staleness","_verifyStalenessSync","rightOfAssociation","_verifyRoaSync","deserialize","deserializedContent","deserializeRecordContent","content","getContent"],"mappings":"qfAyDOA,eAAeC,GAGpBC,IACAA,EAAGC,OACHA,EAAMC,QACNA,EAAOC,QACPA,EAAU,CAAA,IAEV,MAAMC,EAAYD,EAAQC,UAC1B,GAAIA,GAAaA,EAAUC,SAAWH,EAAQG,OAC5C,MAAM,IAAIC,EACR,qEAIJ,MAAOC,EAAaC,SAAgBC,QAAQC,IAAI,CAC9CC,EAAe,CAAEX,MAAKC,WACtBQ,QAAQC,IACNR,EAAQU,KAAKC,GAAWC,EAAmB,CAAEb,SAAQY,cACrDE,MAAMC,GAAcC,EAAYC,cAAclB,EAAKgB,OAGvD,OAAOR,EAAOI,KAAI,CAACO,EAAOC,KACxB,IAAKD,EAAO,OAEZ,MAAMN,EAASX,EAAQkB,GACjBC,EACJlB,EAAQC,YAAYgB,IAAQE,EAAoB,CAAET,SAAQM,UAQ5D,MAAO,CACLN,SACAU,gBAAiBJ,EACjBK,SAVe,CACfC,UAAWC,EAAqB,CAAEnB,cAAaY,aAC3CE,GAAY,CACdM,mBAAoBC,EAAe,CAAEf,SAAQM,QAAOE,kBAQlDlB,EAAQ0B,aAAe,CACzBC,oBAAqBC,EAAyB,CAC5CC,QAASb,EAAMc,aACfpB,YAGL,GAEL"}
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;;;;"}
@@ -0,0 +1,48 @@
1
+ import { CENTRAL_STATE_DOMAIN_RECORDS, SNS_ROOT_DOMAIN_ACCOUNT } from '../constants/addresses.mjs';
2
+ import { InvalidInputError } from '../errors.mjs';
3
+ import { RecordVersion } from '../types/record.mjs';
4
+ import { _deriveAddress } from '../utils/deriveAddress.mjs';
5
+
6
+ /**
7
+ * Derives the address of a domain, subdomain, or record account.
8
+ *
9
+ * @param params Derivation parameters
10
+ * @param params.domain TLD-trimmed SNS domain name
11
+ * @param params.record Optional record account version for record derivation
12
+ * @returns Derived account address and metadata describing top-level, subdomain, or sub-record derivation.
13
+ *
14
+ * @example
15
+ * ```ts
16
+ * const derived = await getSnsDomainAddress({ domain: "example" });
17
+ * ```
18
+ */
19
+ const getSnsDomainAddress = async ({ domain, record, }) => {
20
+ const recordClass = record === RecordVersion.V2 ? CENTRAL_STATE_DOMAIN_RECORDS : undefined;
21
+ const recordPrefix = {
22
+ [RecordVersion.V2]: "\x02",
23
+ [RecordVersion.V1]: "\x01",
24
+ }[record] || "\x00";
25
+ const splitted = domain.split(".");
26
+ if (splitted.length === 2) {
27
+ const parentAddress = await _deriveAddress(splitted[1], SNS_ROOT_DOMAIN_ACCOUNT);
28
+ const domainAddress = await _deriveAddress(recordPrefix + splitted[0], parentAddress, recordClass);
29
+ return { domainAddress, parentAddress, isSub: true };
30
+ }
31
+ else if (splitted.length === 3 && !!record) {
32
+ // Parent domain
33
+ const parentAddress = await _deriveAddress(splitted[2], SNS_ROOT_DOMAIN_ACCOUNT);
34
+ // Sub domain
35
+ const subAddress = await _deriveAddress("\0" + splitted[1], parentAddress);
36
+ // Sub record
37
+ const domainAddress = await _deriveAddress(recordPrefix + splitted[0], subAddress, recordClass);
38
+ return { domainAddress, parentAddress, isSub: true, isSubRecord: true };
39
+ }
40
+ else if (splitted.length >= 3) {
41
+ throw new InvalidInputError("The domain is malformed");
42
+ }
43
+ const domainAddress = await _deriveAddress(domain, SNS_ROOT_DOMAIN_ACCOUNT);
44
+ return { domainAddress, isSub: false };
45
+ };
46
+
47
+ export { getSnsDomainAddress };
48
+ //# sourceMappingURL=getSnsDomainAddress.mjs.map
@@ -0,0 +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;;;;"}
@@ -0,0 +1,27 @@
1
+ import { getSnsNftOwner } from '../nft/getSnsNftOwner.mjs';
2
+ import { RegistryState } from '../states/registry.mjs';
3
+ import { getSnsDomainAddress } from './getSnsDomainAddress.mjs';
4
+
5
+ /**
6
+ * Resolves the owner of a TLD-trimmed SNS domain without applying public
7
+ * TLD-support or legacy `.sol` cutoff policy.
8
+ *
9
+ * This internal helper is intended for public read methods that have already
10
+ * validated and trimmed the full domain name.
11
+ *
12
+ * @param params Owner retrieval parameters
13
+ * @param params.rpc RPC client implementing account and token-largest-account APIs
14
+ * @param params.domain TLD-trimmed SNS domain name
15
+ * @returns The tokenized domain owner when present, otherwise the registry owner
16
+ */
17
+ const _getSnsDomainOwner = async ({ rpc, domain, }) => {
18
+ const { domainAddress } = await getSnsDomainAddress({ domain });
19
+ const [registry, nftOwner] = await Promise.all([
20
+ RegistryState.retrieve(rpc, domainAddress),
21
+ getSnsNftOwner({ rpc, domainAddress }),
22
+ ]);
23
+ return nftOwner || registry.owner;
24
+ };
25
+
26
+ export { _getSnsDomainOwner };
27
+ //# sourceMappingURL=getSnsDomainOwner.mjs.map
@@ -0,0 +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;;;;"}
@@ -0,0 +1,32 @@
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';
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` name
11
+ * @returns The SRS record address and canonical name hash.
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * const derived = await getSrsDomainAddress({ domain: "example" });
16
+ * ```
17
+ */
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
+ };
30
+
31
+ export { getSrsDomainAddress };
32
+ //# sourceMappingURL=getSrsDomainAddress.mjs.map
@@ -0,0 +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,2 +1,92 @@
1
- import{base64Codec as e,addressCodec as s}from"../codecs.mjs";import{NAME_PROGRAM_ADDRESS as t,REVERSE_LOOKUP_CLASS as o}from"../constants/addresses.mjs";import{deserializeReverse as r}from"../utils/deserializers/deserializeReverse.mjs";import{getReverseAddressFromDomainAddress as n}from"../utils/getReverseAddressFromDomainAddress.mjs";import{getDomainAddress as a}from"./getDomainAddress.mjs";const d=async({rpc:d,domain:i})=>{const{domainAddress:m,isSub:c}=await a({domain:i});if(c)return[];const f=d.getProgramAccounts(t,{encoding:"base64",filters:[{memcmp:{offset:0n,bytes:m,encoding:"base58"}},{memcmp:{offset:64n,bytes:o,encoding:"base58"}}]}).send(),l=d.getProgramAccounts(t,{encoding:"base64",filters:[{memcmp:{offset:0n,bytes:m,encoding:"base58"}}],dataSlice:{offset:32,length:32}}).send(),[p,u]=await Promise.all([f,l]),g=new Map(p.map((s=>[s.pubkey,r({data:e.encode(s.account.data[0]).slice(96),trimFirstNullByte:!0})])));return(await Promise.all(u.map((t=>n({domainAddress:t.pubkey,parentAddress:m}).then((o=>{const r=g.get(o);return r?{subdomain:r,owner:s.decode(e.encode(t.account.data[0]))}:void 0})))))).filter((e=>void 0!==e))};export{d as getSubdomains};
1
+ import { base64Codec, addressCodec } from '../codecs.mjs';
2
+ import { NAME_PROGRAM_ADDRESS, REVERSE_LOOKUP_CLASS } from '../constants/addresses.mjs';
3
+ import { assertTldSupported } from '../utils/assertTldSupported.mjs';
4
+ import { deserializeReverse } from '../utils/deserializers/deserializeReverse.mjs';
5
+ import { getReverseAddressFromDomainAddress } from '../utils/getReverseAddressFromDomainAddress.mjs';
6
+ import { getSnsDomainAddress } from './getSnsDomainAddress.mjs';
7
+
8
+ /**
9
+ * Retrieves subdomains under a parent domain, including their owners.
10
+ *
11
+ * Entries without reverse lookup data are omitted. Passing a subdomain returns
12
+ * an empty array.
13
+ *
14
+ * @param params Subdomain retrieval parameters
15
+ * @param params.rpc RPC client implementing program account lookup
16
+ * @param params.domain Full parent domain name including a `.sns` or `.sol` suffix
17
+ * @returns Subdomain names and owner addresses.
18
+ *
19
+ * @example
20
+ * ```ts
21
+ * const subdomains = await getSubdomains({ rpc, domain: "example.sns" });
22
+ * ```
23
+ */
24
+ const getSubdomains = async ({ rpc, domain, }) => {
25
+ const [trimmedDomain] = await assertTldSupported({ rpc, domain });
26
+ const { domainAddress, isSub } = await getSnsDomainAddress({
27
+ domain: trimmedDomain,
28
+ });
29
+ if (isSub)
30
+ return [];
31
+ const getReversesAsync = rpc
32
+ .getProgramAccounts(NAME_PROGRAM_ADDRESS, {
33
+ encoding: "base64",
34
+ filters: [
35
+ {
36
+ memcmp: {
37
+ offset: 0n,
38
+ bytes: domainAddress,
39
+ encoding: "base58",
40
+ },
41
+ },
42
+ {
43
+ memcmp: {
44
+ offset: 64n,
45
+ bytes: REVERSE_LOOKUP_CLASS,
46
+ encoding: "base58",
47
+ },
48
+ },
49
+ ],
50
+ })
51
+ .send();
52
+ const getSubsAsync = rpc
53
+ .getProgramAccounts(NAME_PROGRAM_ADDRESS, {
54
+ encoding: "base64",
55
+ filters: [
56
+ {
57
+ memcmp: {
58
+ offset: 0n,
59
+ bytes: domainAddress,
60
+ encoding: "base58",
61
+ },
62
+ },
63
+ ],
64
+ dataSlice: { offset: 32, length: 32 },
65
+ })
66
+ .send();
67
+ const [reverses, subs] = await Promise.all([getReversesAsync, getSubsAsync]);
68
+ const map = new Map(reverses.map((e) => [
69
+ e.pubkey,
70
+ deserializeReverse({
71
+ data: base64Codec.encode(e.account.data[0]).slice(96),
72
+ trimFirstNullByte: true,
73
+ }),
74
+ ]));
75
+ const result = await Promise.all(subs.map((sub) => getReverseAddressFromDomainAddress({
76
+ domainAddress: sub.pubkey,
77
+ parentAddress: domainAddress,
78
+ }).then((revKey) => {
79
+ const subdomain = map.get(revKey);
80
+ return subdomain
81
+ ? {
82
+ subdomain,
83
+ owner: addressCodec.decode(base64Codec.encode(sub.account.data[0])),
84
+ }
85
+ : undefined;
86
+ })));
87
+ const filteredResult = result.filter((sub) => sub !== undefined);
88
+ return filteredResult;
89
+ };
90
+
91
+ export { getSubdomains };
2
92
  //# sourceMappingURL=getSubdomains.mjs.map
@@ -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 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 { getDomainAddress } from \"./getDomainAddress\";\r\n\r\ninterface GetSubdomainsParams {\r\n rpc: Rpc<GetProgramAccountsApi>;\r\n domain: string;\r\n}\r\n\r\ninterface Result {\r\n subdomain: string;\r\n owner: Address;\r\n}\r\n\r\n/**\r\n * Retrieves all subdomains under the specified domain, including their owners.\r\n *\r\n * @param params - An object containing the following properties:\r\n * - `rpc`: An RPC interface implementing GetProgramAccountsApi.\r\n * - `domain`: The domain whose subdomains are to be retrieved.\r\n * @returns A promise that resolves to an array of subdomain objects, each containing the subdomain name and owner address.\r\n */\r\nexport const getSubdomains = async ({\r\n rpc,\r\n domain,\r\n}: GetSubdomainsParams): Promise<Result[]> => {\r\n const { domainAddress, isSub } = await getDomainAddress({ domain });\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":["getSubdomains","async","rpc","domain","domainAddress","isSub","getDomainAddress","getReversesAsync","getProgramAccounts","NAME_PROGRAM_ADDRESS","encoding","filters","memcmp","offset","bytes","REVERSE_LOOKUP_CLASS","send","getSubsAsync","dataSlice","length","reverses","subs","Promise","all","map","Map","e","pubkey","deserializeReverse","data","base64Codec","encode","account","slice","trimFirstNullByte","sub","getReverseAddressFromDomainAddress","parentAddress","then","revKey","subdomain","get","owner","addressCodec","decode","undefined","filter"],"mappings":"4YAkCO,MAAMA,EAAgBC,OAC3BC,MACAC,aAEA,MAAMC,cAAEA,EAAaC,MAAEA,SAAgBC,EAAiB,CAAEH,WAE1D,GAAIE,EAAO,MAAO,GAElB,MAAME,EAAmBL,EACtBM,mBAAmBC,EAAsB,CACxCC,SAAU,SACVC,QAAS,CACP,CACEC,OAAQ,CACNC,OAAQ,GACRC,MAAOV,EACPM,SAAU,WAGd,CACEE,OAAQ,CACNC,OAAQ,IACRC,MAAOC,EACPL,SAAU,cAKjBM,OAEGC,EAAef,EAClBM,mBAAmBC,EAAsB,CACxCC,SAAU,SACVC,QAAS,CACP,CACEC,OAAQ,CACNC,OAAQ,GACRC,MAAOV,EACPM,SAAU,YAIhBQ,UAAW,CAAEL,OAAQ,GAAIM,OAAQ,MAElCH,QAEII,EAAUC,SAAcC,QAAQC,IAAI,CAAChB,EAAkBU,IAExDO,EAAM,IAAIC,IACdL,EAASI,KAAKE,GAAM,CAClBA,EAAEC,OACFC,EAAmB,CACjBC,KAAMC,EAAYC,OAAOL,EAAEM,QAAQH,KAAK,IAAII,MAAM,IAClDC,mBAAmB,QA0BzB,aArBqBZ,QAAQC,IAC3BF,EAAKG,KAAKW,GACRC,EAAmC,CACjChC,cAAe+B,EAAIR,OACnBU,cAAejC,IACdkC,MAAMC,IACP,MAAMC,EAAYhB,EAAIiB,IAAIF,GAC1B,OAAOC,EACH,CACEA,YACAE,MAAOC,EAAaC,OAClBd,EAAYC,OAAOI,EAAIH,QAAQH,KAAK,WAGxCgB,CAAS,QAKWC,QAAQX,QAAgBU,IAARV,GAEzB"}
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,2 +1,9 @@
1
- export{getAllDomains}from"./getAllDomains.mjs";export{getDomainAddress}from"./getDomainAddress.mjs";export{getDomainOwner}from"./getDomainOwner.mjs";export{getDomainRecord}from"./getDomainRecord.mjs";export{getDomainRecords}from"./getDomainRecords.mjs";export{getSubdomains}from"./getSubdomains.mjs";export{resolveDomain}from"./resolveDomain.mjs";
1
+ export { getAllSnsDomains } from './getAllSnsDomains.mjs';
2
+ export { getSnsDomainAddress } from './getSnsDomainAddress.mjs';
3
+ export { getSrsDomainAddress } from './getSrsDomainAddress.mjs';
4
+ export { getDomainOwner } from './getDomainOwner.mjs';
5
+ export { getDomainRecord } from './getDomainRecord.mjs';
6
+ export { getDomainRecords } from './getDomainRecords.mjs';
7
+ export { getSubdomains } from './getSubdomains.mjs';
8
+ export { resolve, safeResolve } from './resolve.mjs';
2
9
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}
1
+ {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;"}
@@ -0,0 +1,62 @@
1
+ import { SOL_SRS_RESOLUTION_ENABLED } from '../config.mjs';
2
+ import { UnsupportedTldError } from '../errors.mjs';
3
+ import { assertTldSupported } from '../utils/assertTldSupported.mjs';
4
+ import { SOL_TLD, parseSupportedTld, SNS_TLD } from '../utils/tld.mjs';
5
+ import { resolveSns } from './resolveSns.mjs';
6
+
7
+ /**
8
+ * Resolves a `.sns` or `.sol` domain to its target address.
9
+ *
10
+ * @param params Resolution parameters
11
+ * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs
12
+ * @param params.domain Full domain name including a `.sns` or `.sol` suffix
13
+ * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`
14
+ * @returns The resolved target address.
15
+ *
16
+ * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and
17
+ * corresponding SNS targets match when SRS-backed resolution is enabled.
18
+ *
19
+ * @example
20
+ * ```ts
21
+ * const address = await resolve({ rpc, domain: "example.sns" });
22
+ * ```
23
+ */
24
+ const resolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
25
+ if (domain.endsWith(SOL_TLD)) {
26
+ const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);
27
+ await assertTldSupported({ rpc, domain });
28
+ return resolveSns({ rpc, domain: trimmedSolDomain, options });
29
+ }
30
+ const [trimmedDomain, tld] = parseSupportedTld(domain);
31
+ if (tld === SNS_TLD) {
32
+ return resolveSns({ rpc, domain: trimmedDomain, options });
33
+ }
34
+ throw new UnsupportedTldError(`Domain "${domain}" has an unsupported TLD`);
35
+ };
36
+ /**
37
+ * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.
38
+ *
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.
42
+ *
43
+ * @param params Resolution parameters
44
+ * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs
45
+ * @param params.domain Full domain name including a `.sns` or `.sol` suffix
46
+ * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`
47
+ * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}
48
+ * @throws
49
+ * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.
50
+ * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.
51
+ * @example
52
+ * ```ts
53
+ * const address = await safeResolve({ rpc, domain: "example.sol" });
54
+ * ```
55
+ */
56
+ const safeResolve = async ({ rpc, domain, options = { allowPda: false }, }) => {
57
+ if (domain.endsWith(SOL_TLD) && SOL_SRS_RESOLUTION_ENABLED) ;
58
+ return resolve({ rpc, domain, options });
59
+ };
60
+
61
+ export { resolve, safeResolve };
62
+ //# sourceMappingURL=resolve.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolve.mjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\n\nimport { SOL_SRS_RESOLUTION_ENABLED } from \"../config\";\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\nimport { resolveSns } from \"./resolveSns\";\nimport { resolveSol } from \"./resolveSol\";\nimport { ResolveParams } from \"./resolveTypes\";\n\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\n\n/**\n * Resolves a `.sns` or `.sol` domain to its target address.\n *\n * @param params Resolution parameters\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\n * @returns The resolved target address.\n *\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and\n * corresponding SNS targets match when SRS-backed resolution is enabled.\n *\n * @example\n * ```ts\n * const address = await resolve({ rpc, domain: \"example.sns\" });\n * ```\n */\nexport const resolve = async ({\n rpc,\n domain,\n options = { allowPda: false },\n}: ResolveParams): Promise<Address> => {\n if (domain.endsWith(SOL_TLD)) {\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\n\n if (SOL_SRS_RESOLUTION_ENABLED) {\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\n }\n\n await assertTldSupported({ rpc, domain });\n return resolveSns({ rpc, domain: trimmedSolDomain, options });\n }\n\n const [trimmedDomain, tld] = parseSupportedTld(domain);\n if (tld === SNS_TLD) {\n return resolveSns({ rpc, domain: trimmedDomain, options });\n }\n\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\n};\n\n/**\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\n *\n * When SRS-backed `.sol` resolution is enabled, both the `.sol` domain and its\n * corresponding `.sns` domain must resolve to the same target; otherwise,\n * {@link Errors.SnsSolResolutionMismatchError} is thrown.\n *\n * @param params Resolution parameters\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\n * @throws\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\n * @example\n * ```ts\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\n * ```\n */\nexport const safeResolve = async ({\n rpc,\n domain,\n options = { allowPda: false },\n}: ResolveParams): Promise<Address> => {\n if (domain.endsWith(SOL_TLD) && SOL_SRS_RESOLUTION_ENABLED) {\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\n const [srsTarget, snsTarget] = await Promise.all([\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\n ]);\n\n if (srsTarget !== snsTarget) {\n throw new SnsSolResolutionMismatchError(\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\n );\n }\n\n return srsTarget;\n }\n\n return resolve({ rpc, domain, options });\n};\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;;;;"}