@solana-name-service/sns-sdk-kit 0.10.1 → 1.0.1

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 +296 -64
  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
package/README.md CHANGED
@@ -1,90 +1,322 @@
1
1
  <p align="center">
2
- <img width="250" src="https://v2.sns.id/assets/logo/brand.svg"/>
2
+ <img width="200" src="https://www.sns.id/assets/logo/brand.svg" alt="SNS logo" />
3
3
  </p>
4
4
 
5
- # SNS JS-KIT SDK
5
+ # SNS JS Kit SDK
6
6
 
7
- ![npm version](https://img.shields.io/npm/v/@solana-name-service/sns-sdk-kit)
8
- ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white)
9
- ![License](https://img.shields.io/github/license/bonfida/sns-sdk)
7
+ [![npm](https://img.shields.io/npm/v/@solana-name-service/sns-sdk-kit)](https://www.npmjs.com/package/@solana-name-service/sns-sdk-kit)
8
+ [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE)
10
9
 
11
- The JS-KIT SDK is a JavaScript toolkit for managing .sol domains and records. Built on `@solana/kit` (formerly `@solana/web3.js` 2.x), it simplifies development and ensures secure and efficient functionality.
10
+ TypeScript SDK for resolving Solana Name Service (SNS) domains, reading records and ownership, and constructing SNS instructions with [`@solana/kit`](https://www.npmjs.com/package/@solana/kit). It is the SDK for `@solana/kit`, not the `@solana/web3.js` 1.x SDK. It provides no React provider, wallet adapter, or global SDK client: pass your typed RPC client and compose transactions with your wallet or signer.
12
11
 
13
- **Note: This SDK is currently in beta and subject to changes. Features, APIs, and functionality may evolve as development progresses.**
14
-
15
- ## Table of Contents
16
-
17
- - [Features](#features)
18
- - [Installation](#installation)
19
- - [Example Usage](#example-usage)
20
- - [Documentation](#documentation)
21
- - [License](#license)
22
-
23
- ## Features
24
-
25
- - Domain resolution and primary domain lookup
26
- - Domain/Subdomain Management
27
- - Record Handling
12
+ > **Migrating from v0?** This release is not fully backward compatible. Review the [changelog](./CHANGELOG.md) for breaking changes and migration notes.
28
13
 
29
14
  ## Installation
30
15
 
31
16
  ```bash
32
- npm install @solana-name-service/sns-sdk-kit@beta @solana/kit
17
+ npm install @solana-name-service/sns-sdk-kit @solana/kit
33
18
  ```
34
19
 
35
- ```
36
- yarn add @solana-name-service/sns-sdk-kit@beta @solana/kit
37
- ```
20
+ Requirements:
21
+
22
+ - Node.js `>=24.0.0`.
23
+ - `@solana/kit ^6.9.0` as a peer dependency.
24
+ - An RPC client with the APIs required by the operation.
38
25
 
39
- ## Example Usage
26
+ Read APIs fetch and decode account data. Write builders return `Instruction`, `Promise<Instruction>`, or `Promise<Instruction[]>`. Build a transaction around the returned instruction(s), set its fee payer and recent blockhash, collect the signatures required by its account metas, and submit that transaction through your RPC client.
27
+
28
+ ## Quick Start
29
+
30
+ Create a typed `@solana/kit` RPC client and pass it explicitly to each operation:
40
31
 
41
32
  ```typescript
42
33
  import {
43
- Record,
44
- getDomainRecord,
45
- getPrimaryDomain,
46
- resolveDomain,
47
- } from "@solana-name-service/sns-sdk-kit";
48
- import {
49
- Address,
50
34
  createDefaultRpcTransport,
51
35
  createSolanaRpcFromTransport,
52
36
  } from "@solana/kit";
53
37
 
54
- (async () => {
55
- // Initialize rpc interface
56
- const transport = createDefaultRpcTransport({
57
- url: YOUR_RPC_URL,
58
- });
59
- const rpc = createSolanaRpcFromTransport(transport);
60
-
61
- // Resolve .sol domain
62
- const resolved = await resolveDomain({ rpc, domain: "sns.sol" });
63
-
64
- // Get domain records
65
- const records = await getDomainRecord({
66
- rpc,
67
- domain: "sns.sol",
68
- record: Record.Url,
69
- options: {
70
- deserialize: true,
71
- },
72
- });
73
-
74
- // Get primary domain for address
75
- const primaryDomain = await getPrimaryDomain({
76
- rpc,
77
- walletAddress: "36Dn3RWhB8x4c83W6ebQ2C2eH9sh5bQX2nMdkP2cWaA4" as Address,
78
- });
79
-
80
- console.log({ resolved, records, primaryDomain });
81
- })();
38
+ const transport = createDefaultRpcTransport({
39
+ url: "https://your-rpc-endpoint.example",
40
+ });
41
+ const rpc = createSolanaRpcFromTransport(transport);
42
+ ```
43
+
44
+ ### Resolve A Domain
45
+
46
+ ```typescript
47
+ import { resolve } from "@solana-name-service/sns-sdk-kit";
48
+
49
+ const owner = await resolve({
50
+ rpc,
51
+ domain: "wallet-guide-9.sns",
52
+ options: { allowPda: false },
53
+ }); // Or use `safeResolve`.
54
+
55
+ console.log(owner);
56
+ ```
57
+
58
+ ### Get A Primary Domain
59
+
60
+ ```typescript
61
+ import { getPrimaryDomain } from "@solana-name-service/sns-sdk-kit";
62
+ import type { Address } from "@solana/kit";
63
+
64
+ const walletAddress = "36Dn3RWhB8x4c83W6ebQ2C2eH9sh5bQX2nMdkP2cWaA4" as Address;
65
+ const primaryDomain = await getPrimaryDomain({ rpc, walletAddress });
66
+
67
+ console.log(primaryDomain.domainName, primaryDomain.stale);
68
+ ```
69
+
70
+ ### List Domains For An Address
71
+
72
+ ```typescript
73
+ import { getSnsDomainsForAddress } from "@solana-name-service/sns-sdk-kit";
74
+ import type { Address } from "@solana/kit";
75
+
76
+ const address = "36Dn3RWhB8x4c83W6ebQ2C2eH9sh5bQX2nMdkP2cWaA4" as Address;
77
+ const domains = await getSnsDomainsForAddress({ rpc, address });
78
+
79
+ console.log(domains);
82
80
  ```
83
81
 
84
- ## Documentation
82
+ ## Domain Inputs And Resolution
83
+
84
+ Use the form required by each API rather than normalizing names yourself:
85
+
86
+ | API family | Required input | Scope |
87
+ | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
88
+ | High-level reads such as `resolve`, `safeResolve`, `getDomainOwner`, `getDomainRecord`, and `getDomainRecords` | Full suffixed name, for example `mydomain.sns` | `.sns`; legacy `.sol` reads have the transition rule below |
89
+ | Subdomain reads such as `getSubdomains` | Full suffixed top-level name, for example `mydomain.sns` | `.sns` |
90
+ | Top-level writes such as registration, transfer, and burn | Canonical lowercase `mydomain.sns` | Exactly one label before `.sns` |
91
+ | Record writes | Canonical lowercase `mydomain.sns` or `sub.mydomain.sns` | Top-level domain or one-level subdomain |
92
+ | Subdomain creation and transfer | Canonical lowercase `sub.mydomain.sns` | Exactly one subdomain level |
93
+ | SNS derivation and record-address helpers | TLD-trimmed name, for example `mydomain` or `sub.mydomain` | Pass to `getSnsDomainAddress`; it derives domain, subdomain, and record addresses |
94
+ | SRS derivation | TLD-trimmed `.sol` label, for example `mydomain` | Pass to `getSrsDomainAddress` only when an SRS address is specifically needed |
95
+ | Raw registry helpers | Raw labels and explicit parent/class addresses | Use the advanced name-registry helpers when the higher-level `.sns` conventions do not apply |
96
+
97
+ High-level `.sol` reads use the legacy SNS-backed path only before finalized slot `452,825,395`. At and after that slot, `.sol` is rejected. `.sol` writes are not supported.
98
+
99
+ ## API Reference
100
+
101
+ ### Resolution
102
+
103
+ - **`resolve`** — resolves a full `.sns` domain, or a legacy `.sol` domain while the transition path remains available, to its effective owner.
104
+
105
+ ```ts
106
+ resolve({ rpc, domain, options? }): Promise<Address>
107
+ ```
108
+
109
+ - **`safeResolve`** — follows the same routing as `resolve`, except that when SRS-backed `.sol` resolution is enabled, it requires the `.sol` domain and its corresponding `.sns` domain to resolve to the same target; otherwise, it throws `SnsSolResolutionMismatchError`.
110
+
111
+ ```ts
112
+ safeResolve({ rpc, domain, options? }): Promise<Address>
113
+ ```
114
+
115
+ ### Record Reads And Validation
116
+
117
+ - **`getDomainRecord`** — retrieves and verifies one V2 record.
118
+
119
+ ```ts
120
+ getDomainRecord({ rpc, domain, record, options? }): Promise<RecordResult>
121
+ ```
122
+
123
+ - **`getDomainRecords`** — returns one entry per requested record; a missing account is `undefined` at its corresponding index.
124
+
125
+ ```ts
126
+ getDomainRecords({ rpc, domain, records, options? }): Promise<(RecordResult | undefined)[]>
127
+ ```
128
+
129
+ The following standalone helpers do not come from `RecordResult`:
130
+
131
+ - **`getRecordV1Address`** / **`getRecordV2Address`** — derive account addresses from a TLD-trimmed domain without fetching them.
132
+
133
+ ```ts
134
+ getRecordV1Address({ domain, record }): Promise<Address>
135
+ getRecordV2Address({ domain, record }): Promise<Address>
136
+ ```
137
+
138
+ - **`serializeRecordContent`** / **`deserializeRecordContent`** — encode content for storage, or decode stored content.
139
+
140
+ ```ts
141
+ serializeRecordContent({ content, record }): ReadonlyUint8Array
142
+ deserializeRecordContent({ content, record }): string
143
+ ```
144
+
145
+ - **`verifyRecordStaleness`** — independently fetches and checks a V2 record's staleness validation.
146
+
147
+ ```ts
148
+ verifyRecordStaleness({ rpc, domain, record }): Promise<boolean>
149
+ ```
150
+
151
+ - **`verifyRecordRightOfAssociation`** — independently fetches and checks a V2 record's right-of-association validation.
152
+
153
+ ```ts
154
+ verifyRecordRightOfAssociation(rpc, domain: string, record: Record, verifier?: ReadonlyUint8Array): Promise<boolean>
155
+ ```
156
+
157
+ ### Record Writes
158
+
159
+ Each function below returns one `Instruction`:
160
+
161
+ - **`createRecord`**
162
+
163
+ ```ts
164
+ createRecord({ domain, record, content, owner, payer }): Promise<Instruction>
165
+ ```
166
+
167
+ - **`updateRecord`**
168
+
169
+ ```ts
170
+ updateRecord({ domain, record, content, owner, payer }): Promise<Instruction>
171
+ ```
172
+
173
+ - **`deleteRecord`**
174
+
175
+ ```ts
176
+ deleteRecord({ domain, record, owner, payer }): Promise<Instruction>
177
+ ```
178
+
179
+ - **`setRecordStalenessVerifier`**
180
+
181
+ ```ts
182
+ setRecordStalenessVerifier({ domain, record, owner, payer, verifier }): Promise<Instruction>
183
+ ```
184
+
185
+ - **`setRecordRoaVerifier`**
186
+
187
+ ```ts
188
+ setRecordRoaVerifier({ domain, record, owner, payer, verifier }): Promise<Instruction>
189
+ ```
190
+
191
+ - **`validateRecordRoa`**
192
+
193
+ ```ts
194
+ validateRecordRoa({ domain, record, owner, payer, verifier }): Promise<Instruction>
195
+ ```
196
+
197
+ - **`validateRecordRoaEthereum`**
198
+
199
+ ```ts
200
+ validateRecordRoaEthereum({ domain, record, owner, payer, signature, expectedPubkey }): Promise<Instruction>
201
+ ```
202
+
203
+ ### Registration And Lifecycle
204
+
205
+ Registration is limited to a lowercase top-level `.sns` name. Return shapes differ by operation:
206
+
207
+ - **`registerDomain`** — returns the registration instructions. It uses a supported payment mint/feed and only incorporates a referrer when it is supported by the SDK.
208
+
209
+ ```ts
210
+ registerDomain({ domain, space, buyer, buyerTokenAccount, mint?, referrer? }): Promise<Instruction[]>
211
+ ```
212
+
213
+ - **`registerDomainWithNft`** — returns one NFT-based registration instruction.
214
+
215
+ ```ts
216
+ registerDomainWithNft({ domain, space, buyer, nftSource, nftMint }): Promise<Instruction>
217
+ ```
218
+
219
+ - **`transferDomain`** — retrieves the current owner and returns one transfer instruction.
220
+
221
+ ```ts
222
+ transferDomain({ rpc, domain, newOwner }): Promise<Instruction>
223
+ ```
224
+
225
+ - **`burnDomain`** — returns one burn instruction; `refundAddress` receives reclaimed lamports.
226
+
227
+ ```ts
228
+ burnDomain({ domain, owner, refundAddress }): Promise<Instruction>
229
+ ```
230
+
231
+ - **`setPrimaryDomain`** — returns one instruction for an already derived domain account. `domainAddress` is an already derived domain account, not a domain string.
232
+
233
+ ```ts
234
+ setPrimaryDomain({ rpc, domainAddress, owner }): Promise<Instruction>
235
+ ```
236
+
237
+ ### Subdomains
238
+
239
+ - **`getSubdomains`** — lists subdomains and owners under a top-level parent. Entries without reverse data are omitted.
240
+
241
+ ```ts
242
+ getSubdomains({ rpc, domain }): Promise<{ subdomain: string; owner: Address }[]>
243
+ ```
244
+
245
+ - **`createSubdomain`** — returns the name-account creation instruction(s). `subdomain` must be a lowercase one-level `.sns` subdomain.
246
+
247
+ ```ts
248
+ createSubdomain({ rpc, subdomain, owner, space?, feePayer? }): Promise<Instruction[]>
249
+ ```
250
+
251
+ - **`transferSubdomain`** — returns one transfer instruction. When `currentOwner` is omitted, the function retrieves the current owner; set `isParentOwnerSigner` when the parent owner authorizes the transfer.
252
+
253
+ ```ts
254
+ transferSubdomain({ rpc, subdomain, newOwner, isParentOwnerSigner?, currentOwner? }): Promise<Instruction>
255
+ ```
256
+
257
+ ### Ownership And Reverse Lookup
258
+
259
+ - **`getDomainOwner`** — returns the domain's owner: the tokenized-domain NFT owner when present, otherwise the registry owner. It does not apply `SOL`-record precedence or PDA policy, so the result is not necessarily the domain's SNS-IP-5 resolution target; use `resolve` when that target is required.
260
+
261
+ ```ts
262
+ getDomainOwner({ rpc, domain }): Promise<Address>
263
+ ```
264
+
265
+ - **`getAllSnsDomains`** — lists top-level SNS registry accounts and their registry owners.
266
+
267
+ ```ts
268
+ getAllSnsDomains({ rpc }): Promise<{ domainAddress: Address; owner: Address }[]>
269
+ ```
270
+
271
+ - **`getPrimaryDomain`** — returns a primary-domain account, its TLD-less name, and whether the wallet is no longer its effective owner.
272
+
273
+ ```ts
274
+ getPrimaryDomain({ rpc, walletAddress }): Promise<{ domainAddress: Address; domainName: string; stale: boolean }>
275
+ ```
276
+
277
+ - **`getPrimaryDomainsBatch`** — returns valid, non-stale, TLD-less primary names positionally aligned with `walletAddresses`.
278
+
279
+ ```ts
280
+ getPrimaryDomainsBatch({ rpc, walletAddresses }): Promise<(string | undefined)[]>
281
+ ```
282
+
283
+ - **`getSnsDomainsForAddress`** — returns directly registry-owned top-level domains only. Tokenized domains and subdomains are excluded, and entries without reverse records are omitted.
284
+
285
+ ```ts
286
+ getSnsDomainsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address }[]>
287
+ ```
288
+
289
+ - **`getSnsNftsForAddress`** — returns tokenized SNS domains with reverse data.
290
+
291
+ ```ts
292
+ getSnsNftsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address; mint: Address }[]>
293
+ ```
294
+
295
+ - **`reverseLookup`** — returns one TLD-less reverse name for a domain address.
296
+
297
+ ```ts
298
+ reverseLookup({ rpc, domainAddress, parentAddress? }): Promise<string>
299
+ ```
300
+
301
+ - **`reverseLookupBatch`** — returns TLD-less names in input order; missing reverse records are `undefined`.
302
+
303
+ ```ts
304
+ reverseLookupBatch({ rpc, domainAddresses }): Promise<(string | undefined)[]>
305
+ ```
306
+
307
+ ### Advanced APIs
308
+
309
+ For account-level integrations, the root export also includes derivation and raw name-registry helpers such as `getSnsDomainAddress`, `getSrsDomainAddress`, `getReverseAddress`, `getReverseAddressFromDomainAddress`, `checkAddressOnCurve`, `deserializeReverse`, `getPythFeedAddress`, `getTld`, `createNameRegistry`, `updateNameRegistry`, `deleteNameRegistry`, and `createReverse`.
310
+
311
+ NFT helpers and state classes include `getSnsNftMint`, `getSnsNftOwner`, `RegistryState`, `RecordState`, `NftState`, and `PrimaryDomainState`. Low-level instruction classes are also exported; use the `@solana-name-service/sns-sdk-kit/instructions` export for custom transaction composition rather than treating those constructors as an onboarding API.
312
+
313
+ ## Documentation And Migration
85
314
 
86
- The documentation for the JS-KIT SDK is currently a work-in-progress. Stay tuned for updates!
315
+ - [Developer documentation](https://dev.sns.id/)
316
+ - [Migration notes and changelog](./CHANGELOG.md)
317
+ - [SDK monorepo overview](../README.md)
318
+ - [SNS guide](https://guide.sns.id/)
87
319
 
88
320
  ## License
89
321
 
90
- This project is licensed under the MIT License. See the LICENSE file for more details.
322
+ Released under the [MIT License](../LICENSE).
@@ -1,2 +1,55 @@
1
- "use strict";var e=require("../constants/addresses.cjs"),r=require("../nft/getNftOwner.cjs"),a=require("../states/primaryDomain.cjs"),s=require("../states/registry.cjs"),t=require("../utils/reverseLookup.cjs");exports.getPrimaryDomain=async({rpc:i,walletAddress:n})=>{const o=await a.PrimaryDomainState.getAddress(e.NAME_OFFERS_ADDRESS,n),m=await a.PrimaryDomainState.retrieve(i,o),[c,d]=await Promise.all([s.RegistryState.retrieve(i,m.nameAccount),r.getNftOwner({rpc:i,domainAddress:m.nameAccount})]),u=d||c.owner,A=c.parentName!==e.ROOT_DOMAIN_ADDRESS,p=[t.reverseLookup({rpc:i,domainAddress:m.nameAccount,parentAddress:A?c.parentName:void 0})];A&&p.push(t.reverseLookup({rpc:i,domainAddress:c.parentName}));const D=(await Promise.all(p)).join(".");return{domainAddress:m.nameAccount,domainName:D,stale:n!==u}};
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
4
+
5
+ const addresses = require('../constants/addresses.cjs');
6
+ const getSnsNftOwner = require('../nft/getSnsNftOwner.cjs');
7
+ const primaryDomain = require('../states/primaryDomain.cjs');
8
+ const registry = require('../states/registry.cjs');
9
+ const reverseLookup = require('../utils/reverseLookup.cjs');
10
+
11
+ /**
12
+ * Retrieves the primary SNS domain associated with a wallet address.
13
+ *
14
+ * Returned domain names omit the TLD suffix; subdomain primary names can
15
+ * include parent labels such as `sub.parent`.
16
+ *
17
+ * @param params Primary domain retrieval parameters
18
+ * @param params.rpc RPC client implementing account and token-largest-account APIs
19
+ * @param params.walletAddress Wallet address whose primary domain is retrieved
20
+ * @returns Primary domain address, domain name, and stale status.
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * const primary = await getPrimaryDomain({ rpc, walletAddress });
25
+ * ```
26
+ */
27
+ const getPrimaryDomain = async ({ rpc, walletAddress, }) => {
28
+ const primaryAddress = await primaryDomain.PrimaryDomainState.getAddress(addresses.NAME_OFFERS_ADDRESS, walletAddress);
29
+ const primary = await primaryDomain.PrimaryDomainState.retrieve(rpc, primaryAddress);
30
+ const [registry$1, nftOwner] = await Promise.all([
31
+ registry.RegistryState.retrieve(rpc, primary.nameAccount),
32
+ getSnsNftOwner.getSnsNftOwner({ rpc, domainAddress: primary.nameAccount }),
33
+ ]);
34
+ const domainOwner = nftOwner || registry$1.owner;
35
+ const isSub = registry$1.parentName !== addresses.SNS_ROOT_DOMAIN_ACCOUNT;
36
+ const lookups = [
37
+ reverseLookup.reverseLookup({
38
+ rpc,
39
+ domainAddress: primary.nameAccount,
40
+ parentAddress: isSub ? registry$1.parentName : undefined,
41
+ }),
42
+ ];
43
+ if (isSub) {
44
+ lookups.push(reverseLookup.reverseLookup({ rpc, domainAddress: registry$1.parentName }));
45
+ }
46
+ const domainName = (await Promise.all(lookups)).join(".");
47
+ return {
48
+ domainAddress: primary.nameAccount,
49
+ domainName,
50
+ stale: walletAddress !== domainOwner,
51
+ };
52
+ };
53
+
54
+ exports.getPrimaryDomain = getPrimaryDomain;
2
55
  //# sourceMappingURL=getPrimaryDomain.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"getPrimaryDomain.cjs","sources":["../../../src/address/getPrimaryDomain.ts"],"sourcesContent":["import {\r\n Address,\r\n GetAccountInfoApi,\r\n GetTokenLargestAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport {\r\n NAME_OFFERS_ADDRESS,\r\n ROOT_DOMAIN_ADDRESS,\r\n} from \"../constants/addresses\";\r\nimport { getNftOwner } from \"../nft/getNftOwner\";\r\nimport { PrimaryDomainState } from \"../states/primaryDomain\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { reverseLookup } from \"../utils/reverseLookup\";\r\n\r\ninterface GetPrimaryDomainParams {\r\n rpc: Rpc<GetAccountInfoApi & GetTokenLargestAccountsApi>;\r\n walletAddress: Address;\r\n}\r\n\r\n/**\r\n * Fetches the primary domain associated with a given wallet address.\r\n *\r\n * @param params - An object containing the following properties:\r\n * - `rpc`: An RPC interface implementing GetAccountInfoApi and GetTokenLargestAccountsApi.\r\n * - `walletAddress`: The wallet address for which the primary domain is retrieved.\r\n * @returns A promise resolving to an object containing:\r\n * - `domainAddress`: The address of the primary domain.\r\n * - `domainName`: The primary domain name (without .sol suffix).\r\n * - `stale`: false if primary domain was set by the current domain owner, true otherwise.\r\n */\r\nexport const getPrimaryDomain = async ({\r\n rpc,\r\n walletAddress,\r\n}: GetPrimaryDomainParams): Promise<{\r\n domainAddress: Address;\r\n domainName: string;\r\n stale: boolean;\r\n}> => {\r\n const primaryAddress = await PrimaryDomainState.getAddress(\r\n NAME_OFFERS_ADDRESS,\r\n walletAddress\r\n );\r\n const primary = await PrimaryDomainState.retrieve(rpc, primaryAddress);\r\n const [registry, nftOwner] = await Promise.all([\r\n RegistryState.retrieve(rpc, primary.nameAccount),\r\n getNftOwner({ rpc, domainAddress: primary.nameAccount }),\r\n ]);\r\n const domainOwner = nftOwner || registry.owner;\r\n const isSub = registry.parentName !== ROOT_DOMAIN_ADDRESS;\r\n\r\n const lookups = [\r\n reverseLookup({\r\n rpc,\r\n domainAddress: primary.nameAccount,\r\n parentAddress: isSub ? registry.parentName : undefined,\r\n }),\r\n ];\r\n\r\n if (isSub) {\r\n lookups.push(reverseLookup({ rpc, domainAddress: registry.parentName }));\r\n }\r\n\r\n const domainName = (await Promise.all(lookups)).join(\".\");\r\n\r\n return {\r\n domainAddress: primary.nameAccount,\r\n domainName,\r\n stale: walletAddress !== domainOwner,\r\n };\r\n};\r\n"],"names":["async","rpc","walletAddress","primaryAddress","PrimaryDomainState","getAddress","NAME_OFFERS_ADDRESS","primary","retrieve","registry","nftOwner","Promise","all","RegistryState","nameAccount","getNftOwner","domainAddress","domainOwner","owner","isSub","parentName","ROOT_DOMAIN_ADDRESS","lookups","reverseLookup","parentAddress","undefined","push","domainName","join","stale"],"mappings":"2OAgCgCA,OAC9BC,MACAC,oBAMA,MAAMC,QAAuBC,EAAAA,mBAAmBC,WAC9CC,EAAAA,oBACAJ,GAEIK,QAAgBH,EAAAA,mBAAmBI,SAASP,EAAKE,IAChDM,EAAUC,SAAkBC,QAAQC,IAAI,CAC7CC,EAAAA,cAAcL,SAASP,EAAKM,EAAQO,aACpCC,EAAAA,YAAY,CAAEd,MAAKe,cAAeT,EAAQO,gBAEtCG,EAAcP,GAAYD,EAASS,MACnCC,EAAQV,EAASW,aAAeC,EAAmBA,oBAEnDC,EAAU,CACdC,gBAAc,CACZtB,MACAe,cAAeT,EAAQO,YACvBU,cAAeL,EAAQV,EAASW,gBAAaK,KAI7CN,GACFG,EAAQI,KAAKH,EAAAA,cAAc,CAAEtB,MAAKe,cAAeP,EAASW,cAG5D,MAAMO,SAAoBhB,QAAQC,IAAIU,IAAUM,KAAK,KAErD,MAAO,CACLZ,cAAeT,EAAQO,YACvBa,aACAE,MAAO3B,IAAkBe,EAC1B"}
1
+ {"version":3,"file":"getPrimaryDomain.cjs","sources":["../../../src/address/getPrimaryDomain.ts"],"sourcesContent":["import {\r\n Address,\r\n GetAccountInfoApi,\r\n GetTokenLargestAccountsApi,\r\n Rpc,\r\n} from \"@solana/kit\";\r\n\r\nimport {\r\n NAME_OFFERS_ADDRESS,\r\n SNS_ROOT_DOMAIN_ACCOUNT,\r\n} from \"../constants/addresses\";\r\nimport { getSnsNftOwner } from \"../nft/getSnsNftOwner\";\r\nimport { PrimaryDomainState } from \"../states/primaryDomain\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { reverseLookup } from \"../utils/reverseLookup\";\r\n\r\n/**\r\n * Parameters for retrieving a wallet's primary domain.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetPrimaryDomainParams = { rpc, walletAddress };\r\n * ```\r\n */\r\nexport interface GetPrimaryDomainParams {\r\n /** RPC client. */\r\n rpc: Rpc<GetAccountInfoApi & GetTokenLargestAccountsApi>;\r\n /** Wallet address. */\r\n walletAddress: Address;\r\n}\r\n\r\n/**\r\n * A wallet's primary domain.\r\n *\r\n * @example\r\n * ```ts\r\n * const primary: GetPrimaryDomainResult = {\r\n * domainAddress,\r\n * domainName: \"example\",\r\n * stale: false,\r\n * };\r\n * ```\r\n */\r\nexport interface GetPrimaryDomainResult {\r\n /** Primary domain account address. */\r\n domainAddress: Address;\r\n /** TLD-less primary domain name. */\r\n domainName: string;\r\n /** Whether the wallet is no longer the domain's effective owner. */\r\n stale: boolean;\r\n}\r\n\r\n/**\r\n * Retrieves the primary SNS domain associated with a wallet address.\r\n *\r\n * Returned domain names omit the TLD suffix; subdomain primary names can\r\n * include parent labels such as `sub.parent`.\r\n *\r\n * @param params Primary domain retrieval parameters\r\n * @param params.rpc RPC client implementing account and token-largest-account APIs\r\n * @param params.walletAddress Wallet address whose primary domain is retrieved\r\n * @returns Primary domain address, domain name, and stale status.\r\n *\r\n * @example\r\n * ```ts\r\n * const primary = await getPrimaryDomain({ rpc, walletAddress });\r\n * ```\r\n */\r\nexport const getPrimaryDomain = async ({\r\n rpc,\r\n walletAddress,\r\n}: GetPrimaryDomainParams): Promise<GetPrimaryDomainResult> => {\r\n const primaryAddress = await PrimaryDomainState.getAddress(\r\n NAME_OFFERS_ADDRESS,\r\n walletAddress\r\n );\r\n const primary = await PrimaryDomainState.retrieve(rpc, primaryAddress);\r\n const [registry, nftOwner] = await Promise.all([\r\n RegistryState.retrieve(rpc, primary.nameAccount),\r\n getSnsNftOwner({ rpc, domainAddress: primary.nameAccount }),\r\n ]);\r\n const domainOwner = nftOwner || registry.owner;\r\n const isSub = registry.parentName !== SNS_ROOT_DOMAIN_ACCOUNT;\r\n\r\n const lookups = [\r\n reverseLookup({\r\n rpc,\r\n domainAddress: primary.nameAccount,\r\n parentAddress: isSub ? registry.parentName : undefined,\r\n }),\r\n ];\r\n\r\n if (isSub) {\r\n lookups.push(reverseLookup({ rpc, domainAddress: registry.parentName }));\r\n }\r\n\r\n const domainName = (await Promise.all(lookups)).join(\".\");\r\n\r\n return {\r\n domainAddress: primary.nameAccount,\r\n domainName,\r\n stale: walletAddress !== domainOwner,\r\n };\r\n};\r\n"],"names":["PrimaryDomainState","NAME_OFFERS_ADDRESS","registry","RegistryState","getSnsNftOwner","SNS_ROOT_DOMAIN_ACCOUNT","reverseLookup"],"mappings":";;;;;;;;;;AAoDA;;;;;;;;;;;;;;;AAeG;AACI,MAAM,gBAAgB,GAAG,OAAO,EACrC,GAAG,EACH,aAAa,GACU,KAAqC;IAC5D,MAAM,cAAc,GAAG,MAAMA,gCAAkB,CAAC,UAAU,CACxDC,6BAAmB,EACnB,aAAa,CACd;IACD,MAAM,OAAO,GAAG,MAAMD,gCAAkB,CAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IACtE,MAAM,CAACE,UAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7CC,sBAAa,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC;QAChDC,6BAAc,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;AAC5D,KAAA,CAAC;AACF,IAAA,MAAM,WAAW,GAAG,QAAQ,IAAIF,UAAQ,CAAC,KAAK;AAC9C,IAAA,MAAM,KAAK,GAAGA,UAAQ,CAAC,UAAU,KAAKG,iCAAuB;AAE7D,IAAA,MAAM,OAAO,GAAG;AACd,QAAAC,2BAAa,CAAC;YACZ,GAAG;YACH,aAAa,EAAE,OAAO,CAAC,WAAW;YAClC,aAAa,EAAE,KAAK,GAAGJ,UAAQ,CAAC,UAAU,GAAG,SAAS;SACvD,CAAC;KACH;IAED,IAAI,KAAK,EAAE;AACT,QAAA,OAAO,CAAC,IAAI,CAACI,2BAAa,CAAC,EAAE,GAAG,EAAE,aAAa,EAAEJ,UAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;;AAG1E,IAAA,MAAM,UAAU,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC;IAEzD,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,WAAW;QAClC,UAAU;QACV,KAAK,EAAE,aAAa,KAAK,WAAW;KACrC;AACH;;;;"}
@@ -1,2 +1,109 @@
1
- "use strict";var e=require("../node_modules/@solana-program/token/dist/src/index.cjs"),s=require("@solana/kit"),r=require("../codecs.cjs"),t=require("../constants/addresses.cjs"),a=require("../nft/getNftMint.cjs"),i=require("../states/primaryDomain.cjs"),d=require("../states/registry.cjs"),n=require("../utils/deserializers/deserializeReverse.cjs"),o=require("../utils/getReverseAddressFromDomainAddress.cjs");exports.getPrimaryDomainsBatch=async({rpc:c,walletAddresses:m})=>{const l=new Array(m.length).fill(void 0),A=await Promise.all(m.map((e=>i.PrimaryDomainState.getAddress(t.NAME_OFFERS_ADDRESS,e))));let u=(await i.PrimaryDomainState.retrieveBatch(c,A)).reduce(((e,s,r)=>(s&&e.push({index:r,domainAddress:s.nameAccount}),e)),[]);const D=await d.RegistryState.retrieveBatch(c,u.map((e=>e.domainAddress)));u=u.map(((e,s)=>({...e,registry:D[s]}))).filter((({registry:e})=>!!e));const R=[],g=[],h=[];for(const{index:s,domainAddress:r,registry:i}of u){const d=i.parentName!==t.ROOT_DOMAIN_ADDRESS;g.push(d?o.getReverseAddressFromDomainAddress({domainAddress:i.parentName}):t.DEFAULT_ADDRESS),R.push(o.getReverseAddressFromDomainAddress({domainAddress:r,parentAddress:d?i.parentName:void 0})),h.push(a.getNftMint({domainAddress:r}).then((r=>e.findAssociatedTokenPda({mint:r,owner:m[s],tokenProgram:t.TOKEN_PROGRAM_ADDRESS}))).then((([e])=>e)))}const[p,f,S]=await Promise.all([Promise.all(R).then((e=>s.fetchEncodedAccounts(c,e))),Promise.all(g).then((e=>s.fetchEncodedAccounts(c,e))),Promise.all(h).then((e=>s.fetchEncodedAccounts(c,e)))]);for(const[e,{index:s,registry:a}]of u.entries()){let i="";const d=p[e],o=f[e],c=S[e];if(d.exists){if(o.exists&&o.programAddress===t.NAME_PROGRAM_ADDRESS){i=`.${n.deserializeReverse({data:o.data.slice(96)})}`}a.owner!==m[s]?c.exists&&1===Number(r.tokenCodec.decode(c.data).amount)&&(l[s]=n.deserializeReverse({data:d?.data.slice(96)})+i):l[s]=n.deserializeReverse({data:d.data.slice(96),trimFirstNullByte:!0})+i}}return l};
1
+ 'use strict';
2
+
3
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
4
+
5
+ const token = require('@solana-program/token');
6
+ const kit = require('@solana/kit');
7
+ const codecs = require('../codecs.cjs');
8
+ const addresses = require('../constants/addresses.cjs');
9
+ const getSnsNftMint = require('../nft/getSnsNftMint.cjs');
10
+ const primaryDomain = require('../states/primaryDomain.cjs');
11
+ const registry = require('../states/registry.cjs');
12
+ const deserializeReverse = require('../utils/deserializers/deserializeReverse.cjs');
13
+ const getReverseAddressFromDomainAddress = require('../utils/getReverseAddressFromDomainAddress.cjs');
14
+
15
+ /**
16
+ * Retrieves primary SNS domain names for multiple wallet addresses.
17
+ *
18
+ * Returned values are index-aligned with `walletAddresses`. Domain names omit
19
+ * the TLD suffix; subdomain primary names can include parent labels such as
20
+ * `sub.parent`.
21
+ *
22
+ * @param params Primary domain retrieval parameters
23
+ * @param params.rpc RPC client implementing multiple-account and token-largest-account APIs
24
+ * @param params.walletAddresses Wallet addresses whose primary domains are retrieved
25
+ * @returns Primary domain names, or `undefined` when no valid non-stale primary domain is found.
26
+ *
27
+ * @example
28
+ * ```ts
29
+ * const domains = await getPrimaryDomainsBatch({ rpc, walletAddresses });
30
+ * ```
31
+ */
32
+ const getPrimaryDomainsBatch = async ({ rpc, walletAddresses, }) => {
33
+ const result = new Array(walletAddresses.length).fill(undefined);
34
+ const addresses$1 = await Promise.all(walletAddresses.map((address) => primaryDomain.PrimaryDomainState.getAddress(addresses.NAME_OFFERS_ADDRESS, address)));
35
+ const primaries = await primaryDomain.PrimaryDomainState.retrieveBatch(rpc, addresses$1);
36
+ let validPrimaries = primaries.reduce((acc, curr, idx) => {
37
+ if (curr) {
38
+ acc.push({ index: idx, domainAddress: curr.nameAccount });
39
+ }
40
+ return acc;
41
+ }, []);
42
+ const registries = await registry.RegistryState.retrieveBatch(rpc, validPrimaries.map((item) => item.domainAddress));
43
+ validPrimaries = validPrimaries
44
+ .map((primary, idx) => ({ ...primary, registry: registries[idx] }))
45
+ .filter(({ registry }) => !!registry);
46
+ const revAddressesPromises = [];
47
+ const parentRevAddressesPromises = [];
48
+ const atasPromises = [];
49
+ for (const { index, domainAddress, registry } of validPrimaries) {
50
+ const isSub = registry.parentName !== addresses.SNS_ROOT_DOMAIN_ACCOUNT;
51
+ parentRevAddressesPromises.push(isSub
52
+ ? getReverseAddressFromDomainAddress.getReverseAddressFromDomainAddress({
53
+ domainAddress: registry.parentName,
54
+ })
55
+ : addresses.DEFAULT_ADDRESS);
56
+ revAddressesPromises.push(getReverseAddressFromDomainAddress.getReverseAddressFromDomainAddress({
57
+ domainAddress,
58
+ parentAddress: isSub ? registry.parentName : undefined,
59
+ }));
60
+ atasPromises.push(getSnsNftMint.getSnsNftMint({ domainAddress })
61
+ .then((mint) => token.findAssociatedTokenPda({
62
+ mint,
63
+ owner: walletAddresses[index],
64
+ tokenProgram: addresses.TOKEN_PROGRAM_ADDRESS,
65
+ }))
66
+ .then(([pda]) => pda));
67
+ }
68
+ const [revs, parentRevs, tokenAccs] = await Promise.all([
69
+ Promise.all(revAddressesPromises).then((addresses) => kit.fetchEncodedAccounts(rpc, addresses)),
70
+ Promise.all(parentRevAddressesPromises).then((addresses) => kit.fetchEncodedAccounts(rpc, addresses)),
71
+ Promise.all(atasPromises).then((addresses) => kit.fetchEncodedAccounts(rpc, addresses)),
72
+ ]);
73
+ for (const [i, { index, registry }] of validPrimaries.entries()) {
74
+ let parentRev = "";
75
+ const rev = revs[i];
76
+ const parentRevAccount = parentRevs[i];
77
+ const tokenAcc = tokenAccs[i];
78
+ if (!rev.exists) {
79
+ continue;
80
+ }
81
+ if (parentRevAccount.exists &&
82
+ parentRevAccount.programAddress === addresses.NAME_PROGRAM_ADDRESS) {
83
+ const des = deserializeReverse.deserializeReverse({
84
+ data: parentRevAccount.data.slice(96),
85
+ });
86
+ parentRev = `.${des}`;
87
+ }
88
+ if (registry.owner === walletAddresses[index]) {
89
+ result[index] =
90
+ deserializeReverse.deserializeReverse({
91
+ data: rev.data.slice(96),
92
+ trimFirstNullByte: true,
93
+ }) + parentRev;
94
+ continue;
95
+ }
96
+ // Tokenized
97
+ if (tokenAcc.exists &&
98
+ Number(codecs.tokenCodec.decode(tokenAcc.data).amount) === 1) {
99
+ result[index] =
100
+ deserializeReverse.deserializeReverse({ data: rev?.data.slice(96) }) + parentRev;
101
+ continue;
102
+ }
103
+ // Stale otherwise
104
+ }
105
+ return result;
106
+ };
107
+
108
+ exports.getPrimaryDomainsBatch = getPrimaryDomainsBatch;
2
109
  //# sourceMappingURL=getPrimaryDomainsBatch.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"getPrimaryDomainsBatch.cjs","sources":["../../../src/address/getPrimaryDomainsBatch.ts"],"sourcesContent":["import { findAssociatedTokenPda } from \"@solana-program/token\";\r\nimport {\r\n Address,\r\n GetMultipleAccountsApi,\r\n GetTokenLargestAccountsApi,\r\n Rpc,\r\n fetchEncodedAccounts,\r\n} from \"@solana/kit\";\r\n\r\nimport { tokenCodec } from \"../codecs\";\r\nimport {\r\n DEFAULT_ADDRESS,\r\n NAME_OFFERS_ADDRESS,\r\n NAME_PROGRAM_ADDRESS,\r\n ROOT_DOMAIN_ADDRESS,\r\n TOKEN_PROGRAM_ADDRESS,\r\n} from \"../constants/addresses\";\r\nimport { getNftMint } from \"../nft/getNftMint\";\r\nimport { PrimaryDomainState } from \"../states/primaryDomain\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { deserializeReverse } from \"../utils/deserializers/deserializeReverse\";\r\nimport { getReverseAddressFromDomainAddress } from \"../utils/getReverseAddressFromDomainAddress\";\r\n\r\ninterface GetPrimaryDomainsBatchParams {\r\n rpc: Rpc<GetMultipleAccountsApi & GetTokenLargestAccountsApi>;\r\n walletAddresses: Address[];\r\n}\r\n\r\ninterface ValidPrimary {\r\n index: number;\r\n domainAddress: Address;\r\n registry?: RegistryState;\r\n}\r\n\r\n/**\r\n * Batch retrieves the primary domains associated with a list of wallet addresses.\r\n *\r\n * @param params - An object containing the following properties:\r\n * - `rpc`: An RPC interface implementing GetMultipleAccountsApi and GetTokenLargestAccountsApi.\r\n * - `walletAddresses`: An array of wallet addresses for which primary domains are to be fetched.\r\n * @returns A promise resolving to an array of strings or undefined values, where each string represents\r\n * the primary domain name if available and non-stale.\r\n */\r\nexport const getPrimaryDomainsBatch = async ({\r\n rpc,\r\n walletAddresses,\r\n}: GetPrimaryDomainsBatchParams): Promise<(string | undefined)[]> => {\r\n const result: (string | undefined)[] = new Array(walletAddresses.length).fill(\r\n undefined\r\n );\r\n const addresses = await Promise.all(\r\n walletAddresses.map((address) =>\r\n PrimaryDomainState.getAddress(NAME_OFFERS_ADDRESS, address)\r\n )\r\n );\r\n const primaries = await PrimaryDomainState.retrieveBatch(rpc, addresses);\r\n\r\n let validPrimaries = primaries.reduce<ValidPrimary[]>((acc, curr, idx) => {\r\n if (curr) {\r\n acc.push({ index: idx, domainAddress: curr.nameAccount });\r\n }\r\n return acc;\r\n }, []);\r\n\r\n const registries = await RegistryState.retrieveBatch(\r\n rpc,\r\n validPrimaries.map((item) => item.domainAddress)\r\n );\r\n\r\n validPrimaries = validPrimaries\r\n .map((primary, idx) => ({ ...primary, registry: registries[idx] }))\r\n .filter(({ registry }) => !!registry);\r\n\r\n const revAddressesPromises: Promise<Address>[] = [];\r\n const parentRevAddressesPromises: (Promise<Address> | Address)[] = [];\r\n const atasPromises: Promise<Address>[] = [];\r\n\r\n for (const { index, domainAddress, registry } of validPrimaries) {\r\n const isSub = registry!.parentName !== ROOT_DOMAIN_ADDRESS;\r\n\r\n parentRevAddressesPromises.push(\r\n isSub\r\n ? getReverseAddressFromDomainAddress({\r\n domainAddress: registry!.parentName,\r\n })\r\n : DEFAULT_ADDRESS\r\n );\r\n revAddressesPromises.push(\r\n getReverseAddressFromDomainAddress({\r\n domainAddress,\r\n parentAddress: isSub ? registry!.parentName : undefined,\r\n })\r\n );\r\n atasPromises.push(\r\n getNftMint({ domainAddress })\r\n .then((mint) =>\r\n findAssociatedTokenPda({\r\n mint,\r\n owner: walletAddresses[index],\r\n tokenProgram: TOKEN_PROGRAM_ADDRESS,\r\n })\r\n )\r\n .then(([pda]) => pda)\r\n );\r\n }\r\n\r\n const [revs, parentRevs, tokenAccs] = await Promise.all([\r\n Promise.all(revAddressesPromises).then((addresses) =>\r\n fetchEncodedAccounts(rpc, addresses)\r\n ),\r\n Promise.all(parentRevAddressesPromises).then((addresses) =>\r\n fetchEncodedAccounts(rpc, addresses)\r\n ),\r\n Promise.all(atasPromises).then((addresses) =>\r\n fetchEncodedAccounts(rpc, addresses)\r\n ),\r\n ]);\r\n\r\n for (const [i, { index, registry }] of validPrimaries.entries()) {\r\n let parentRev = \"\";\r\n const rev = revs[i];\r\n const parentRevAccount = parentRevs[i];\r\n const tokenAcc = tokenAccs[i];\r\n\r\n if (!rev.exists) {\r\n continue;\r\n }\r\n\r\n if (\r\n parentRevAccount.exists &&\r\n parentRevAccount.programAddress === NAME_PROGRAM_ADDRESS\r\n ) {\r\n const des = deserializeReverse({ data: parentRevAccount.data.slice(96) });\r\n parentRev = `.${des}`;\r\n }\r\n\r\n if (registry!.owner === walletAddresses[index]) {\r\n result[index] =\r\n deserializeReverse({\r\n data: rev.data.slice(96),\r\n trimFirstNullByte: true,\r\n }) + parentRev;\r\n continue;\r\n }\r\n\r\n // Tokenized\r\n if (\r\n tokenAcc.exists &&\r\n Number(tokenCodec.decode(tokenAcc.data).amount) === 1\r\n ) {\r\n result[index] =\r\n deserializeReverse({ data: rev?.data.slice(96) }) + parentRev;\r\n continue;\r\n }\r\n\r\n // Stale otherwise\r\n }\r\n\r\n return result;\r\n};\r\n"],"names":["async","rpc","walletAddresses","result","Array","length","fill","undefined","addresses","Promise","all","map","address","PrimaryDomainState","getAddress","NAME_OFFERS_ADDRESS","validPrimaries","retrieveBatch","reduce","acc","curr","idx","push","index","domainAddress","nameAccount","registries","RegistryState","item","primary","registry","filter","revAddressesPromises","parentRevAddressesPromises","atasPromises","isSub","parentName","ROOT_DOMAIN_ADDRESS","getReverseAddressFromDomainAddress","DEFAULT_ADDRESS","parentAddress","getNftMint","then","mint","findAssociatedTokenPda","owner","tokenProgram","TOKEN_PROGRAM_ADDRESS","pda","revs","parentRevs","tokenAccs","fetchEncodedAccounts","i","entries","parentRev","rev","parentRevAccount","tokenAcc","exists","programAddress","NAME_PROGRAM_ADDRESS","deserializeReverse","data","slice","Number","tokenCodec","decode","amount","trimFirstNullByte"],"mappings":"0bA2CsCA,OACpCC,MACAC,sBAEA,MAAMC,EAAiC,IAAIC,MAAMF,EAAgBG,QAAQC,UACvEC,GAEIC,QAAkBC,QAAQC,IAC9BR,EAAgBS,KAAKC,GACnBC,EAAkBA,mBAACC,WAAWC,sBAAqBH,MAKvD,IAAII,SAFoBH,EAAAA,mBAAmBI,cAAchB,EAAKO,IAE/BU,QAAuB,CAACC,EAAKC,EAAMC,KAC5DD,GACFD,EAAIG,KAAK,CAAEC,MAAOF,EAAKG,cAAeJ,EAAKK,cAEtCN,IACN,IAEH,MAAMO,QAAmBC,gBAAcV,cACrChB,EACAe,EAAeL,KAAKiB,GAASA,EAAKJ,iBAGpCR,EAAiBA,EACdL,KAAI,CAACkB,EAASR,SAAcQ,EAASC,SAAUJ,EAAWL,OAC1DU,QAAO,EAAGD,gBAAiBA,IAE9B,MAAME,EAA2C,GAC3CC,EAA6D,GAC7DC,EAAmC,GAEzC,IAAK,MAAMX,MAAEA,EAAKC,cAAEA,EAAaM,SAAEA,KAAcd,EAAgB,CAC/D,MAAMmB,EAAQL,EAAUM,aAAeC,EAAmBA,oBAE1DJ,EAA2BX,KACzBa,EACIG,qCAAmC,CACjCd,cAAeM,EAAUM,aAE3BG,mBAENP,EAAqBV,KACnBgB,qCAAmC,CACjCd,gBACAgB,cAAeL,EAAQL,EAAUM,gBAAa7B,KAGlD2B,EAAaZ,KACXmB,aAAW,CAAEjB,kBACVkB,MAAMC,GACLC,yBAAuB,CACrBD,OACAE,MAAO3C,EAAgBqB,GACvBuB,aAAcC,EAAqBA,0BAGtCL,MAAK,EAAEM,KAASA,KAIvB,MAAOC,EAAMC,EAAYC,SAAmB1C,QAAQC,IAAI,CACtDD,QAAQC,IAAIsB,GAAsBU,MAAMlC,GACtC4C,EAAoBA,qBAACnD,EAAKO,KAE5BC,QAAQC,IAAIuB,GAA4BS,MAAMlC,GAC5C4C,EAAoBA,qBAACnD,EAAKO,KAE5BC,QAAQC,IAAIwB,GAAcQ,MAAMlC,GAC9B4C,EAAoBA,qBAACnD,EAAKO,OAI9B,IAAK,MAAO6C,GAAG9B,MAAEA,EAAKO,SAAEA,MAAed,EAAesC,UAAW,CAC/D,IAAIC,EAAY,GAChB,MAAMC,EAAMP,EAAKI,GACXI,EAAmBP,EAAWG,GAC9BK,EAAWP,EAAUE,GAE3B,GAAKG,EAAIG,OAAT,CAIA,GACEF,EAAiBE,QACjBF,EAAiBG,iBAAmBC,uBACpC,CAEAN,EAAY,IADAO,EAAkBA,mBAAC,CAAEC,KAAMN,EAAiBM,KAAKC,MAAM,QAIjElC,EAAUe,QAAU3C,EAAgBqB,GAWtCmC,EAASC,QAC2C,IAApDM,OAAOC,EAAUA,WAACC,OAAOT,EAASK,MAAMK,UAExCjE,EAAOoB,GACLuC,qBAAmB,CAAEC,KAAMP,GAAKO,KAAKC,MAAM,MAAST,GAdtDpD,EAAOoB,GACLuC,qBAAmB,CACjBC,KAAMP,EAAIO,KAAKC,MAAM,IACrBK,mBAAmB,IAChBd,GAiBX,OAAOpD,CAAM"}
1
+ {"version":3,"file":"getPrimaryDomainsBatch.cjs","sources":["../../../src/address/getPrimaryDomainsBatch.ts"],"sourcesContent":["import { findAssociatedTokenPda } from \"@solana-program/token\";\r\nimport {\r\n Address,\r\n GetMultipleAccountsApi,\r\n GetTokenLargestAccountsApi,\r\n Rpc,\r\n fetchEncodedAccounts,\r\n} from \"@solana/kit\";\r\n\r\nimport { tokenCodec } from \"../codecs\";\r\nimport {\r\n DEFAULT_ADDRESS,\r\n NAME_OFFERS_ADDRESS,\r\n NAME_PROGRAM_ADDRESS,\r\n SNS_ROOT_DOMAIN_ACCOUNT,\r\n TOKEN_PROGRAM_ADDRESS,\r\n} from \"../constants/addresses\";\r\nimport { getSnsNftMint } from \"../nft/getSnsNftMint\";\r\nimport { PrimaryDomainState } from \"../states/primaryDomain\";\r\nimport { RegistryState } from \"../states/registry\";\r\nimport { deserializeReverse } from \"../utils/deserializers/deserializeReverse\";\r\nimport { getReverseAddressFromDomainAddress } from \"../utils/getReverseAddressFromDomainAddress\";\r\n\r\n/**\r\n * Parameters for retrieving primary domains for multiple wallets.\r\n *\r\n * @example\r\n * ```ts\r\n * const params: GetPrimaryDomainsBatchParams = { rpc, walletAddresses };\r\n * ```\r\n */\r\nexport interface GetPrimaryDomainsBatchParams {\r\n /** RPC client. */\r\n rpc: Rpc<GetMultipleAccountsApi & GetTokenLargestAccountsApi>;\r\n /** Wallet addresses. */\r\n walletAddresses: Address[];\r\n}\r\n\r\ninterface ValidPrimary {\r\n index: number;\r\n domainAddress: Address;\r\n registry?: RegistryState;\r\n}\r\n\r\n/**\r\n * Retrieves primary SNS domain names for multiple wallet addresses.\r\n *\r\n * Returned values are index-aligned with `walletAddresses`. Domain names omit\r\n * the TLD suffix; subdomain primary names can include parent labels such as\r\n * `sub.parent`.\r\n *\r\n * @param params Primary domain retrieval parameters\r\n * @param params.rpc RPC client implementing multiple-account and token-largest-account APIs\r\n * @param params.walletAddresses Wallet addresses whose primary domains are retrieved\r\n * @returns Primary domain names, or `undefined` when no valid non-stale primary domain is found.\r\n *\r\n * @example\r\n * ```ts\r\n * const domains = await getPrimaryDomainsBatch({ rpc, walletAddresses });\r\n * ```\r\n */\r\nexport const getPrimaryDomainsBatch = async ({\r\n rpc,\r\n walletAddresses,\r\n}: GetPrimaryDomainsBatchParams): Promise<(string | undefined)[]> => {\r\n const result: (string | undefined)[] = new Array(walletAddresses.length).fill(\r\n undefined\r\n );\r\n const addresses = await Promise.all(\r\n walletAddresses.map((address) =>\r\n PrimaryDomainState.getAddress(NAME_OFFERS_ADDRESS, address)\r\n )\r\n );\r\n const primaries = await PrimaryDomainState.retrieveBatch(rpc, addresses);\r\n\r\n let validPrimaries = primaries.reduce<ValidPrimary[]>((acc, curr, idx) => {\r\n if (curr) {\r\n acc.push({ index: idx, domainAddress: curr.nameAccount });\r\n }\r\n return acc;\r\n }, []);\r\n\r\n const registries = await RegistryState.retrieveBatch(\r\n rpc,\r\n validPrimaries.map((item) => item.domainAddress)\r\n );\r\n\r\n validPrimaries = validPrimaries\r\n .map((primary, idx) => ({ ...primary, registry: registries[idx] }))\r\n .filter(({ registry }) => !!registry);\r\n\r\n const revAddressesPromises: Promise<Address>[] = [];\r\n const parentRevAddressesPromises: (Promise<Address> | Address)[] = [];\r\n const atasPromises: Promise<Address>[] = [];\r\n\r\n for (const { index, domainAddress, registry } of validPrimaries) {\r\n const isSub = registry!.parentName !== SNS_ROOT_DOMAIN_ACCOUNT;\r\n\r\n parentRevAddressesPromises.push(\r\n isSub\r\n ? getReverseAddressFromDomainAddress({\r\n domainAddress: registry!.parentName,\r\n })\r\n : DEFAULT_ADDRESS\r\n );\r\n revAddressesPromises.push(\r\n getReverseAddressFromDomainAddress({\r\n domainAddress,\r\n parentAddress: isSub ? registry!.parentName : undefined,\r\n })\r\n );\r\n atasPromises.push(\r\n getSnsNftMint({ domainAddress })\r\n .then((mint) =>\r\n findAssociatedTokenPda({\r\n mint,\r\n owner: walletAddresses[index],\r\n tokenProgram: TOKEN_PROGRAM_ADDRESS,\r\n })\r\n )\r\n .then(([pda]) => pda)\r\n );\r\n }\r\n\r\n const [revs, parentRevs, tokenAccs] = await Promise.all([\r\n Promise.all(revAddressesPromises).then((addresses) =>\r\n fetchEncodedAccounts(rpc, addresses)\r\n ),\r\n Promise.all(parentRevAddressesPromises).then((addresses) =>\r\n fetchEncodedAccounts(rpc, addresses)\r\n ),\r\n Promise.all(atasPromises).then((addresses) =>\r\n fetchEncodedAccounts(rpc, addresses)\r\n ),\r\n ]);\r\n\r\n for (const [i, { index, registry }] of validPrimaries.entries()) {\r\n let parentRev = \"\";\r\n const rev = revs[i];\r\n const parentRevAccount = parentRevs[i];\r\n const tokenAcc = tokenAccs[i];\r\n\r\n if (!rev.exists) {\r\n continue;\r\n }\r\n\r\n if (\r\n parentRevAccount.exists &&\r\n parentRevAccount.programAddress === NAME_PROGRAM_ADDRESS\r\n ) {\r\n const des = deserializeReverse({\r\n data: parentRevAccount.data.slice(96),\r\n });\r\n parentRev = `.${des}`;\r\n }\r\n\r\n if (registry!.owner === walletAddresses[index]) {\r\n result[index] =\r\n deserializeReverse({\r\n data: rev.data.slice(96),\r\n trimFirstNullByte: true,\r\n }) + parentRev;\r\n continue;\r\n }\r\n\r\n // Tokenized\r\n if (\r\n tokenAcc.exists &&\r\n Number(tokenCodec.decode(tokenAcc.data).amount) === 1\r\n ) {\r\n result[index] =\r\n deserializeReverse({ data: rev?.data.slice(96) }) + parentRev;\r\n continue;\r\n }\r\n\r\n // Stale otherwise\r\n }\r\n\r\n return result;\r\n};\r\n"],"names":["addresses","PrimaryDomainState","NAME_OFFERS_ADDRESS","RegistryState","SNS_ROOT_DOMAIN_ACCOUNT","getReverseAddressFromDomainAddress","DEFAULT_ADDRESS","getSnsNftMint","findAssociatedTokenPda","TOKEN_PROGRAM_ADDRESS","fetchEncodedAccounts","NAME_PROGRAM_ADDRESS","deserializeReverse","tokenCodec"],"mappings":";;;;;;;;;;;;;;AA4CA;;;;;;;;;;;;;;;;AAgBG;AACI,MAAM,sBAAsB,GAAG,OAAO,EAC3C,GAAG,EACH,eAAe,GACc,KAAqC;AAClE,IAAA,MAAM,MAAM,GAA2B,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,CAC3E,SAAS,CACV;IACD,MAAMA,WAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,eAAe,CAAC,GAAG,CAAC,CAAC,OAAO,KAC1BC,gCAAkB,CAAC,UAAU,CAACC,6BAAmB,EAAE,OAAO,CAAC,CAC5D,CACF;IACD,MAAM,SAAS,GAAG,MAAMD,gCAAkB,CAAC,aAAa,CAAC,GAAG,EAAED,WAAS,CAAC;AAExE,IAAA,IAAI,cAAc,GAAG,SAAS,CAAC,MAAM,CAAiB,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,KAAI;QACvE,IAAI,IAAI,EAAE;AACR,YAAA,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;;AAE3D,QAAA,OAAO,GAAG;KACX,EAAE,EAAE,CAAC;IAEN,MAAM,UAAU,GAAG,MAAMG,sBAAa,CAAC,aAAa,CAClD,GAAG,EACH,cAAc,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,aAAa,CAAC,CACjD;AAED,IAAA,cAAc,GAAG;SACd,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;AACjE,SAAA,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC;IAEvC,MAAM,oBAAoB,GAAuB,EAAE;IACnD,MAAM,0BAA0B,GAAmC,EAAE;IACrE,MAAM,YAAY,GAAuB,EAAE;IAE3C,KAAK,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,cAAc,EAAE;AAC/D,QAAA,MAAM,KAAK,GAAG,QAAS,CAAC,UAAU,KAAKC,iCAAuB;QAE9D,0BAA0B,CAAC,IAAI,CAC7B;cACIC,qEAAkC,CAAC;gBACjC,aAAa,EAAE,QAAS,CAAC,UAAU;aACpC;cACDC,yBAAe,CACpB;AACD,QAAA,oBAAoB,CAAC,IAAI,CACvBD,qEAAkC,CAAC;YACjC,aAAa;YACb,aAAa,EAAE,KAAK,GAAG,QAAS,CAAC,UAAU,GAAG,SAAS;AACxD,SAAA,CAAC,CACH;QACD,YAAY,CAAC,IAAI,CACfE,2BAAa,CAAC,EAAE,aAAa,EAAE;AAC5B,aAAA,IAAI,CAAC,CAAC,IAAI,KACTC,4BAAsB,CAAC;YACrB,IAAI;AACJ,YAAA,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;AAC7B,YAAA,YAAY,EAAEC,+BAAqB;AACpC,SAAA,CAAC;aAEH,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CACxB;;AAGH,IAAA,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;AACtD,QAAA,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,KAC/CC,wBAAoB,CAAC,GAAG,EAAE,SAAS,CAAC,CACrC;AACD,QAAA,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,KACrDA,wBAAoB,CAAC,GAAG,EAAE,SAAS,CAAC,CACrC;AACD,QAAA,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,KACvCA,wBAAoB,CAAC,GAAG,EAAE,SAAS,CAAC,CACrC;AACF,KAAA,CAAC;AAEF,IAAA,KAAK,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,IAAI,cAAc,CAAC,OAAO,EAAE,EAAE;QAC/D,IAAI,SAAS,GAAG,EAAE;AAClB,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC;AACnB,QAAA,MAAM,gBAAgB,GAAG,UAAU,CAAC,CAAC,CAAC;AACtC,QAAA,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;AAE7B,QAAA,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE;YACf;;QAGF,IACE,gBAAgB,CAAC,MAAM;AACvB,YAAA,gBAAgB,CAAC,cAAc,KAAKC,8BAAoB,EACxD;YACA,MAAM,GAAG,GAAGC,qCAAkB,CAAC;gBAC7B,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACtC,aAAA,CAAC;AACF,YAAA,SAAS,GAAG,CAAA,CAAA,EAAI,GAAG,CAAA,CAAE;;QAGvB,IAAI,QAAS,CAAC,KAAK,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE;YAC9C,MAAM,CAAC,KAAK,CAAC;AACX,gBAAAA,qCAAkB,CAAC;oBACjB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;AACxB,oBAAA,iBAAiB,EAAE,IAAI;iBACxB,CAAC,GAAG,SAAS;YAChB;;;QAIF,IACE,QAAQ,CAAC,MAAM;AACf,YAAA,MAAM,CAACC,iBAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACrD;YACA,MAAM,CAAC,KAAK,CAAC;AACX,gBAAAD,qCAAkB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS;YAC/D;;;;AAMJ,IAAA,OAAO,MAAM;AACf;;;;"}