@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.
- package/README.md +322 -90
- package/dist/cjs/address/getPrimaryDomain.cjs +54 -1
- package/dist/cjs/address/getPrimaryDomain.cjs.map +1 -1
- package/dist/cjs/address/getPrimaryDomainsBatch.cjs +108 -1
- package/dist/cjs/address/getPrimaryDomainsBatch.cjs.map +1 -1
- package/dist/cjs/address/getSnsDomainsForAddress.cjs +65 -0
- package/dist/cjs/address/getSnsDomainsForAddress.cjs.map +1 -0
- package/dist/cjs/address/getSnsNftsForAddress.cjs +94 -0
- package/dist/cjs/address/getSnsNftsForAddress.cjs.map +1 -0
- package/dist/cjs/address/index.cjs +15 -1
- package/dist/cjs/address/index.cjs.map +1 -1
- package/dist/cjs/bindings/burnDomain.cjs +46 -1
- package/dist/cjs/bindings/burnDomain.cjs.map +1 -1
- package/dist/cjs/bindings/createNameRegistry.cjs +54 -1
- package/dist/cjs/bindings/createNameRegistry.cjs.map +1 -1
- package/dist/cjs/bindings/createRecord.cjs +57 -1
- package/dist/cjs/bindings/createRecord.cjs.map +1 -1
- package/dist/cjs/bindings/createReverse.cjs +36 -1
- package/dist/cjs/bindings/createReverse.cjs.map +1 -1
- package/dist/cjs/bindings/createSubdomain.cjs +69 -1
- package/dist/cjs/bindings/createSubdomain.cjs.map +1 -1
- package/dist/cjs/bindings/deleteNameRegistry.cjs +37 -1
- package/dist/cjs/bindings/deleteNameRegistry.cjs.map +1 -1
- package/dist/cjs/bindings/deleteRecord.cjs +49 -1
- package/dist/cjs/bindings/deleteRecord.cjs.map +1 -1
- package/dist/cjs/bindings/index.cjs +43 -1
- package/dist/cjs/bindings/index.cjs.map +1 -1
- package/dist/cjs/bindings/recordValidation.cjs +60 -0
- package/dist/cjs/bindings/recordValidation.cjs.map +1 -0
- package/dist/cjs/bindings/registerDomain.cjs +86 -1
- package/dist/cjs/bindings/registerDomain.cjs.map +1 -1
- package/dist/cjs/bindings/registerDomainWithNft.cjs +67 -0
- package/dist/cjs/bindings/registerDomainWithNft.cjs.map +1 -0
- package/dist/cjs/bindings/setPrimaryDomain.cjs +39 -1
- package/dist/cjs/bindings/setPrimaryDomain.cjs.map +1 -1
- package/dist/cjs/bindings/setRecordRoaVerifier.cjs +44 -0
- package/dist/cjs/bindings/setRecordRoaVerifier.cjs.map +1 -0
- package/dist/cjs/bindings/setRecordStalenessVerifier.cjs +32 -0
- package/dist/cjs/bindings/setRecordStalenessVerifier.cjs.map +1 -0
- package/dist/cjs/bindings/transferDomain.cjs +33 -1
- package/dist/cjs/bindings/transferDomain.cjs.map +1 -1
- package/dist/cjs/bindings/transferSubdomain.cjs +48 -1
- package/dist/cjs/bindings/transferSubdomain.cjs.map +1 -1
- package/dist/cjs/bindings/updateNameRegistry.cjs +45 -1
- package/dist/cjs/bindings/updateNameRegistry.cjs.map +1 -1
- package/dist/cjs/bindings/updateRecord.cjs +57 -1
- package/dist/cjs/bindings/updateRecord.cjs.map +1 -1
- package/dist/cjs/bindings/validateRecordRoa.cjs +32 -0
- package/dist/cjs/bindings/validateRecordRoa.cjs.map +1 -0
- package/dist/cjs/bindings/validateRecordRoaEthereum.cjs +49 -0
- package/dist/cjs/bindings/validateRecordRoaEthereum.cjs.map +1 -0
- package/dist/cjs/codecs.cjs +27 -1
- package/dist/cjs/codecs.cjs.map +1 -1
- package/dist/cjs/config.cjs +18 -0
- package/dist/cjs/config.cjs.map +1 -0
- package/dist/cjs/constants/addresses.cjs +124 -1
- package/dist/cjs/constants/addresses.cjs.map +1 -1
- package/dist/cjs/constants/index.cjs +40 -1
- package/dist/cjs/constants/index.cjs.map +1 -1
- package/dist/cjs/constants/pythFeeds.cjs +91 -1
- package/dist/cjs/constants/pythFeeds.cjs.map +1 -1
- package/dist/cjs/constants/records.cjs +71 -1
- package/dist/cjs/constants/records.cjs.map +1 -1
- package/dist/cjs/domain/getAllSnsDomains.cjs +43 -0
- package/dist/cjs/domain/getAllSnsDomains.cjs.map +1 -0
- package/dist/cjs/domain/getDomainOwner.cjs +27 -1
- package/dist/cjs/domain/getDomainOwner.cjs.map +1 -1
- package/dist/cjs/domain/getDomainRecord.cjs +54 -1
- package/dist/cjs/domain/getDomainRecord.cjs.map +1 -1
- package/dist/cjs/domain/getDomainRecords.cjs +64 -1
- package/dist/cjs/domain/getDomainRecords.cjs.map +1 -1
- package/dist/cjs/domain/getSnsDomainAddress.cjs +52 -0
- package/dist/cjs/domain/getSnsDomainAddress.cjs.map +1 -0
- package/dist/cjs/domain/getSnsDomainOwner.cjs +31 -0
- package/dist/cjs/domain/getSnsDomainOwner.cjs.map +1 -0
- package/dist/cjs/domain/getSrsDomainAddress.cjs +36 -0
- package/dist/cjs/domain/getSrsDomainAddress.cjs.map +1 -0
- package/dist/cjs/domain/getSubdomains.cjs +95 -1
- package/dist/cjs/domain/getSubdomains.cjs.map +1 -1
- package/dist/cjs/domain/index.cjs +24 -1
- package/dist/cjs/domain/index.cjs.map +1 -1
- package/dist/cjs/domain/resolve.cjs +67 -0
- package/dist/cjs/domain/resolve.cjs.map +1 -0
- package/dist/cjs/domain/resolveSns.cjs +113 -0
- package/dist/cjs/domain/resolveSns.cjs.map +1 -0
- package/dist/cjs/errors.cjs +250 -1
- package/dist/cjs/errors.cjs.map +1 -1
- package/dist/cjs/index.cjs +245 -1
- package/dist/cjs/index.cjs.map +1 -1
- package/dist/cjs/instructions/allocateAndPostRecordInstruction.cjs +71 -1
- package/dist/cjs/instructions/allocateAndPostRecordInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/burnDomainInstruction.cjs +71 -1
- package/dist/cjs/instructions/burnDomainInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/createAtaIdempotentInstruction.cjs +71 -0
- package/dist/cjs/instructions/createAtaIdempotentInstruction.cjs.map +1 -0
- package/dist/cjs/instructions/createNameRegistryInstruction.cjs +94 -1
- package/dist/cjs/instructions/createNameRegistryInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/createReverseInstruction.cjs +79 -1
- package/dist/cjs/instructions/createReverseInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/createSplitV2Instruction.cjs +113 -1
- package/dist/cjs/instructions/createSplitV2Instruction.cjs.map +1 -1
- package/dist/cjs/instructions/createWithNftInstruction.cjs +107 -1
- package/dist/cjs/instructions/createWithNftInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/deleteNameRegistryInstruction.cjs +47 -1
- package/dist/cjs/instructions/deleteNameRegistryInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/deleteRecordInstruction.cjs +63 -1
- package/dist/cjs/instructions/deleteRecordInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/index.cjs +41 -1
- package/dist/cjs/instructions/index.cjs.map +1 -1
- package/dist/cjs/instructions/reallocInstruction.cjs +55 -1
- package/dist/cjs/instructions/reallocInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/registerPrimaryInstruction.cjs +58 -0
- package/dist/cjs/instructions/registerPrimaryInstruction.cjs.map +1 -0
- package/dist/cjs/instructions/setRecordRoaVerifierInstruction.cjs +69 -0
- package/dist/cjs/instructions/setRecordRoaVerifierInstruction.cjs.map +1 -0
- package/dist/cjs/instructions/transferInstruction.cjs +67 -1
- package/dist/cjs/instructions/transferInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/updateNameRegistryInstruction.cjs +51 -1
- package/dist/cjs/instructions/updateNameRegistryInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/updateRecordInstruction.cjs +71 -1
- package/dist/cjs/instructions/updateRecordInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/validateEthereumSignatureInstruction.cjs +76 -0
- package/dist/cjs/instructions/validateEthereumSignatureInstruction.cjs.map +1 -0
- package/dist/cjs/instructions/validateSolanaSignatureInstruction.cjs +72 -0
- package/dist/cjs/instructions/validateSolanaSignatureInstruction.cjs.map +1 -0
- package/dist/cjs/nft/getSnsNftMint.cjs +31 -0
- package/dist/cjs/nft/getSnsNftMint.cjs.map +1 -0
- package/dist/cjs/nft/getSnsNftOwner.cjs +48 -0
- package/dist/cjs/nft/getSnsNftOwner.cjs.map +1 -0
- package/dist/cjs/nft/index.cjs +11 -1
- package/dist/cjs/nft/index.cjs.map +1 -1
- package/dist/cjs/record/getRecordV1Address.cjs +31 -1
- package/dist/cjs/record/getRecordV1Address.cjs.map +1 -1
- package/dist/cjs/record/getRecordV2Address.cjs +27 -1
- package/dist/cjs/record/getRecordV2Address.cjs.map +1 -1
- package/dist/cjs/record/index.cjs +18 -1
- package/dist/cjs/record/index.cjs.map +1 -1
- package/dist/cjs/record/verifyRecordRightOfAssociation.cjs +95 -1
- package/dist/cjs/record/verifyRecordRightOfAssociation.cjs.map +1 -1
- package/dist/cjs/record/verifyRecordStaleness.cjs +55 -1
- package/dist/cjs/record/verifyRecordStaleness.cjs.map +1 -1
- package/dist/cjs/states/index.cjs +22 -1
- package/dist/cjs/states/index.cjs.map +1 -1
- package/dist/cjs/states/nft.cjs +109 -1
- package/dist/cjs/states/nft.cjs.map +1 -1
- package/dist/cjs/states/primaryDomain.cjs +65 -1
- package/dist/cjs/states/primaryDomain.cjs.map +1 -1
- package/dist/cjs/states/record.cjs +120 -1
- package/dist/cjs/states/record.cjs.map +1 -1
- package/dist/cjs/states/registry.cjs +68 -1
- package/dist/cjs/states/registry.cjs.map +1 -1
- package/dist/cjs/types/index.cjs +22 -1
- package/dist/cjs/types/index.cjs.map +1 -1
- package/dist/cjs/types/record.cjs +56 -1
- package/dist/cjs/types/record.cjs.map +1 -1
- package/dist/cjs/types/validation.cjs +12 -1
- package/dist/cjs/types/validation.cjs.map +1 -1
- package/dist/cjs/utils/assertTldSupported.cjs +28 -0
- package/dist/cjs/utils/assertTldSupported.cjs.map +1 -0
- package/dist/cjs/utils/check.cjs +20 -1
- package/dist/cjs/utils/check.cjs.map +1 -1
- package/dist/cjs/utils/checkAddressOnCurve/ed25519.cjs +81 -3
- package/dist/cjs/utils/checkAddressOnCurve/ed25519.cjs.map +1 -1
- package/dist/cjs/utils/checkAddressOnCurve/index.cjs +42 -1
- package/dist/cjs/utils/checkAddressOnCurve/index.cjs.map +1 -1
- package/dist/cjs/utils/deriveAddress.cjs +57 -1
- package/dist/cjs/utils/deriveAddress.cjs.map +1 -1
- package/dist/cjs/utils/deserializers/deserializeRecordContent.cjs +64 -1
- package/dist/cjs/utils/deserializers/deserializeRecordContent.cjs.map +1 -1
- package/dist/cjs/utils/deserializers/deserializeReverse.cjs +17 -1
- package/dist/cjs/utils/deserializers/deserializeReverse.cjs.map +1 -1
- package/dist/cjs/utils/getPythFeedAddress.cjs +32 -1
- package/dist/cjs/utils/getPythFeedAddress.cjs.map +1 -1
- package/dist/cjs/utils/getReverseAddress.cjs +29 -1
- package/dist/cjs/utils/getReverseAddress.cjs.map +1 -1
- package/dist/cjs/utils/getReverseAddressFromDomainAddress.cjs +25 -1
- package/dist/cjs/utils/getReverseAddressFromDomainAddress.cjs.map +1 -1
- package/dist/cjs/utils/index.cjs +32 -1
- package/dist/cjs/utils/index.cjs.map +1 -1
- package/dist/cjs/utils/parseSnsDomain.cjs +66 -0
- package/dist/cjs/utils/parseSnsDomain.cjs.map +1 -0
- package/dist/cjs/utils/reverseLookup.cjs +40 -1
- package/dist/cjs/utils/reverseLookup.cjs.map +1 -1
- package/dist/cjs/utils/reverseLookupBatch.cjs +30 -1
- package/dist/cjs/utils/reverseLookupBatch.cjs.map +1 -1
- package/dist/cjs/utils/serializers/serializeRecordContent.cjs +90 -1
- package/dist/cjs/utils/serializers/serializeRecordContent.cjs.map +1 -1
- package/dist/cjs/utils/tld.cjs +67 -0
- package/dist/cjs/utils/tld.cjs.map +1 -0
- package/dist/cjs/utils/uint8Array/uint8ArrayFromHex.cjs +20 -1
- package/dist/cjs/utils/uint8Array/uint8ArrayFromHex.cjs.map +1 -1
- package/dist/cjs/utils/uint8Array/uint8ArrayToHex.cjs +16 -1
- package/dist/cjs/utils/uint8Array/uint8ArrayToHex.cjs.map +1 -1
- package/dist/cjs/utils/uint8Array/uint8ArraysEqual.cjs +20 -1
- package/dist/cjs/utils/uint8Array/uint8ArraysEqual.cjs.map +1 -1
- package/dist/esm/address/getPrimaryDomain.mjs +50 -1
- package/dist/esm/address/getPrimaryDomain.mjs.map +1 -1
- package/dist/esm/address/getPrimaryDomainsBatch.mjs +104 -1
- package/dist/esm/address/getPrimaryDomainsBatch.mjs.map +1 -1
- package/dist/esm/address/getSnsDomainsForAddress.mjs +61 -0
- package/dist/esm/address/getSnsDomainsForAddress.mjs.map +1 -0
- package/dist/esm/address/getSnsNftsForAddress.mjs +90 -0
- package/dist/esm/address/getSnsNftsForAddress.mjs.map +1 -0
- package/dist/esm/address/index.mjs +4 -1
- package/dist/esm/address/index.mjs.map +1 -1
- package/dist/esm/bindings/burnDomain.mjs +42 -1
- package/dist/esm/bindings/burnDomain.mjs.map +1 -1
- package/dist/esm/bindings/createNameRegistry.mjs +50 -1
- package/dist/esm/bindings/createNameRegistry.mjs.map +1 -1
- package/dist/esm/bindings/createRecord.mjs +53 -1
- package/dist/esm/bindings/createRecord.mjs.map +1 -1
- package/dist/esm/bindings/createReverse.mjs +32 -1
- package/dist/esm/bindings/createReverse.mjs.map +1 -1
- package/dist/esm/bindings/createSubdomain.mjs +65 -1
- package/dist/esm/bindings/createSubdomain.mjs.map +1 -1
- package/dist/esm/bindings/deleteNameRegistry.mjs +33 -1
- package/dist/esm/bindings/deleteNameRegistry.mjs.map +1 -1
- package/dist/esm/bindings/deleteRecord.mjs +45 -1
- package/dist/esm/bindings/deleteRecord.mjs.map +1 -1
- package/dist/esm/bindings/index.mjs +18 -1
- package/dist/esm/bindings/index.mjs.map +1 -1
- package/dist/esm/bindings/recordValidation.mjs +55 -0
- package/dist/esm/bindings/recordValidation.mjs.map +1 -0
- package/dist/esm/bindings/registerDomain.mjs +82 -1
- package/dist/esm/bindings/registerDomain.mjs.map +1 -1
- package/dist/esm/bindings/registerDomainWithNft.mjs +63 -0
- package/dist/esm/bindings/registerDomainWithNft.mjs.map +1 -0
- package/dist/esm/bindings/setPrimaryDomain.mjs +35 -1
- package/dist/esm/bindings/setPrimaryDomain.mjs.map +1 -1
- package/dist/esm/bindings/setRecordRoaVerifier.mjs +40 -0
- package/dist/esm/bindings/setRecordRoaVerifier.mjs.map +1 -0
- package/dist/esm/bindings/setRecordStalenessVerifier.mjs +28 -0
- package/dist/esm/bindings/setRecordStalenessVerifier.mjs.map +1 -0
- package/dist/esm/bindings/transferDomain.mjs +29 -1
- package/dist/esm/bindings/transferDomain.mjs.map +1 -1
- package/dist/esm/bindings/transferSubdomain.mjs +44 -1
- package/dist/esm/bindings/transferSubdomain.mjs.map +1 -1
- package/dist/esm/bindings/updateNameRegistry.mjs +41 -1
- package/dist/esm/bindings/updateNameRegistry.mjs.map +1 -1
- package/dist/esm/bindings/updateRecord.mjs +53 -1
- package/dist/esm/bindings/updateRecord.mjs.map +1 -1
- package/dist/esm/bindings/validateRecordRoa.mjs +28 -0
- package/dist/esm/bindings/validateRecordRoa.mjs.map +1 -0
- package/dist/esm/bindings/validateRecordRoaEthereum.mjs +45 -0
- package/dist/esm/bindings/validateRecordRoaEthereum.mjs.map +1 -0
- package/dist/esm/codecs.mjs +19 -1
- package/dist/esm/codecs.mjs.map +1 -1
- package/dist/esm/config.mjs +11 -0
- package/dist/esm/config.mjs.map +1 -0
- package/dist/esm/constants/addresses.mjs +98 -1
- package/dist/esm/constants/addresses.mjs.map +1 -1
- package/dist/esm/constants/index.mjs +3 -1
- package/dist/esm/constants/index.mjs.map +1 -1
- package/dist/esm/constants/pythFeeds.mjs +86 -1
- package/dist/esm/constants/pythFeeds.mjs.map +1 -1
- package/dist/esm/constants/records.mjs +63 -1
- package/dist/esm/constants/records.mjs.map +1 -1
- package/dist/esm/domain/getAllSnsDomains.mjs +39 -0
- package/dist/esm/domain/getAllSnsDomains.mjs.map +1 -0
- package/dist/esm/domain/getDomainOwner.mjs +23 -1
- package/dist/esm/domain/getDomainOwner.mjs.map +1 -1
- package/dist/esm/domain/getDomainRecord.mjs +50 -1
- package/dist/esm/domain/getDomainRecord.mjs.map +1 -1
- package/dist/esm/domain/getDomainRecords.mjs +60 -1
- package/dist/esm/domain/getDomainRecords.mjs.map +1 -1
- package/dist/esm/domain/getSnsDomainAddress.mjs +48 -0
- package/dist/esm/domain/getSnsDomainAddress.mjs.map +1 -0
- package/dist/esm/domain/getSnsDomainOwner.mjs +27 -0
- package/dist/esm/domain/getSnsDomainOwner.mjs.map +1 -0
- package/dist/esm/domain/getSrsDomainAddress.mjs +32 -0
- package/dist/esm/domain/getSrsDomainAddress.mjs.map +1 -0
- package/dist/esm/domain/getSubdomains.mjs +91 -1
- package/dist/esm/domain/getSubdomains.mjs.map +1 -1
- package/dist/esm/domain/index.mjs +8 -1
- package/dist/esm/domain/index.mjs.map +1 -1
- package/dist/esm/domain/resolve.mjs +62 -0
- package/dist/esm/domain/resolve.mjs.map +1 -0
- package/dist/esm/domain/resolveSns.mjs +109 -0
- package/dist/esm/domain/resolveSns.mjs.map +1 -0
- package/dist/esm/errors.mjs +218 -1
- package/dist/esm/errors.mjs.map +1 -1
- package/dist/esm/index.mjs +74 -1
- package/dist/esm/index.mjs.map +1 -1
- package/dist/esm/instructions/allocateAndPostRecordInstruction.mjs +67 -1
- package/dist/esm/instructions/allocateAndPostRecordInstruction.mjs.map +1 -1
- package/dist/esm/instructions/burnDomainInstruction.mjs +67 -1
- package/dist/esm/instructions/burnDomainInstruction.mjs.map +1 -1
- package/dist/esm/instructions/createAtaIdempotentInstruction.mjs +67 -0
- package/dist/esm/instructions/createAtaIdempotentInstruction.mjs.map +1 -0
- package/dist/esm/instructions/createNameRegistryInstruction.mjs +90 -1
- package/dist/esm/instructions/createNameRegistryInstruction.mjs.map +1 -1
- package/dist/esm/instructions/createReverseInstruction.mjs +75 -1
- package/dist/esm/instructions/createReverseInstruction.mjs.map +1 -1
- package/dist/esm/instructions/createSplitV2Instruction.mjs +109 -1
- package/dist/esm/instructions/createSplitV2Instruction.mjs.map +1 -1
- package/dist/esm/instructions/createWithNftInstruction.mjs +103 -1
- package/dist/esm/instructions/createWithNftInstruction.mjs.map +1 -1
- package/dist/esm/instructions/deleteNameRegistryInstruction.mjs +43 -1
- package/dist/esm/instructions/deleteNameRegistryInstruction.mjs.map +1 -1
- package/dist/esm/instructions/deleteRecordInstruction.mjs +59 -1
- package/dist/esm/instructions/deleteRecordInstruction.mjs.map +1 -1
- package/dist/esm/instructions/index.mjs +17 -1
- package/dist/esm/instructions/index.mjs.map +1 -1
- package/dist/esm/instructions/reallocInstruction.mjs +51 -1
- package/dist/esm/instructions/reallocInstruction.mjs.map +1 -1
- package/dist/esm/instructions/registerPrimaryInstruction.mjs +54 -0
- package/dist/esm/instructions/registerPrimaryInstruction.mjs.map +1 -0
- package/dist/esm/instructions/setRecordRoaVerifierInstruction.mjs +65 -0
- package/dist/esm/instructions/setRecordRoaVerifierInstruction.mjs.map +1 -0
- package/dist/esm/instructions/transferInstruction.mjs +63 -1
- package/dist/esm/instructions/transferInstruction.mjs.map +1 -1
- package/dist/esm/instructions/updateNameRegistryInstruction.mjs +47 -1
- package/dist/esm/instructions/updateNameRegistryInstruction.mjs.map +1 -1
- package/dist/esm/instructions/updateRecordInstruction.mjs +67 -1
- package/dist/esm/instructions/updateRecordInstruction.mjs.map +1 -1
- package/dist/esm/instructions/validateEthereumSignatureInstruction.mjs +72 -0
- package/dist/esm/instructions/validateEthereumSignatureInstruction.mjs.map +1 -0
- package/dist/esm/instructions/validateSolanaSignatureInstruction.mjs +68 -0
- package/dist/esm/instructions/validateSolanaSignatureInstruction.mjs.map +1 -0
- package/dist/esm/nft/getSnsNftMint.mjs +27 -0
- package/dist/esm/nft/getSnsNftMint.mjs.map +1 -0
- package/dist/esm/nft/getSnsNftOwner.mjs +44 -0
- package/dist/esm/nft/getSnsNftOwner.mjs.map +1 -0
- package/dist/esm/nft/index.mjs +2 -1
- package/dist/esm/nft/index.mjs.map +1 -1
- package/dist/esm/record/getRecordV1Address.mjs +27 -1
- package/dist/esm/record/getRecordV1Address.mjs.map +1 -1
- package/dist/esm/record/getRecordV2Address.mjs +23 -1
- package/dist/esm/record/getRecordV2Address.mjs.map +1 -1
- package/dist/esm/record/index.mjs +4 -1
- package/dist/esm/record/index.mjs.map +1 -1
- package/dist/esm/record/verifyRecordRightOfAssociation.mjs +89 -1
- package/dist/esm/record/verifyRecordRightOfAssociation.mjs.map +1 -1
- package/dist/esm/record/verifyRecordStaleness.mjs +50 -1
- package/dist/esm/record/verifyRecordStaleness.mjs.map +1 -1
- package/dist/esm/states/index.mjs +4 -1
- package/dist/esm/states/index.mjs.map +1 -1
- package/dist/esm/states/nft.mjs +105 -1
- package/dist/esm/states/nft.mjs.map +1 -1
- package/dist/esm/states/primaryDomain.mjs +61 -1
- package/dist/esm/states/primaryDomain.mjs.map +1 -1
- package/dist/esm/states/record.mjs +113 -1
- package/dist/esm/states/record.mjs.map +1 -1
- package/dist/esm/states/registry.mjs +64 -1
- package/dist/esm/states/registry.mjs.map +1 -1
- package/dist/esm/types/index.mjs +2 -1
- package/dist/esm/types/index.mjs.map +1 -1
- package/dist/esm/types/record.mjs +52 -1
- package/dist/esm/types/record.mjs.map +1 -1
- package/dist/esm/types/validation.mjs +10 -1
- package/dist/esm/types/validation.mjs.map +1 -1
- package/dist/esm/utils/assertTldSupported.mjs +24 -0
- package/dist/esm/utils/assertTldSupported.mjs.map +1 -0
- package/dist/esm/utils/check.mjs +16 -1
- package/dist/esm/utils/check.mjs.map +1 -1
- package/dist/esm/utils/checkAddressOnCurve/ed25519.mjs +76 -2
- package/dist/esm/utils/checkAddressOnCurve/ed25519.mjs.map +1 -1
- package/dist/esm/utils/checkAddressOnCurve/index.mjs +38 -1
- package/dist/esm/utils/checkAddressOnCurve/index.mjs.map +1 -1
- package/dist/esm/utils/deriveAddress.mjs +51 -1
- package/dist/esm/utils/deriveAddress.mjs.map +1 -1
- package/dist/esm/utils/deserializers/deserializeRecordContent.mjs +60 -1
- package/dist/esm/utils/deserializers/deserializeRecordContent.mjs.map +1 -1
- package/dist/esm/utils/deserializers/deserializeReverse.mjs +13 -1
- package/dist/esm/utils/deserializers/deserializeReverse.mjs.map +1 -1
- package/dist/esm/utils/getPythFeedAddress.mjs +28 -1
- package/dist/esm/utils/getPythFeedAddress.mjs.map +1 -1
- package/dist/esm/utils/getReverseAddress.mjs +25 -1
- package/dist/esm/utils/getReverseAddress.mjs.map +1 -1
- package/dist/esm/utils/getReverseAddressFromDomainAddress.mjs +21 -1
- package/dist/esm/utils/getReverseAddressFromDomainAddress.mjs.map +1 -1
- package/dist/esm/utils/index.mjs +10 -1
- package/dist/esm/utils/index.mjs.map +1 -1
- package/dist/esm/utils/parseSnsDomain.mjs +60 -0
- package/dist/esm/utils/parseSnsDomain.mjs.map +1 -0
- package/dist/esm/utils/reverseLookup.mjs +36 -1
- package/dist/esm/utils/reverseLookup.mjs.map +1 -1
- package/dist/esm/utils/reverseLookupBatch.mjs +26 -1
- package/dist/esm/utils/reverseLookupBatch.mjs.map +1 -1
- package/dist/esm/utils/serializers/serializeRecordContent.mjs +86 -1
- package/dist/esm/utils/serializers/serializeRecordContent.mjs.map +1 -1
- package/dist/esm/utils/tld.mjs +58 -0
- package/dist/esm/utils/tld.mjs.map +1 -0
- package/dist/esm/utils/uint8Array/uint8ArrayFromHex.mjs +16 -1
- package/dist/esm/utils/uint8Array/uint8ArrayFromHex.mjs.map +1 -1
- package/dist/esm/utils/uint8Array/uint8ArrayToHex.mjs +12 -1
- package/dist/esm/utils/uint8Array/uint8ArrayToHex.mjs.map +1 -1
- package/dist/esm/utils/uint8Array/uint8ArraysEqual.mjs +16 -1
- package/dist/esm/utils/uint8Array/uint8ArraysEqual.mjs.map +1 -1
- package/dist/types/address/index.d.ts +193 -4
- package/dist/types/bindings/index.d.ts +821 -17
- package/dist/types/codecs.d.ts +16 -5
- package/dist/types/constants/index.d.ts +141 -3
- package/dist/types/domain/index.d.ts +559 -7
- package/dist/types/errors.d.ts +73 -85
- package/dist/types/index.d.ts +3038 -74
- package/dist/types/instructions/index.d.ts +523 -19
- package/dist/types/nft/index.d.ts +59 -2
- package/dist/types/record/index.d.ts +254 -4
- package/dist/types/states/index.d.ts +235 -4
- package/dist/types/types/index.d.ts +50 -2
- package/dist/types/utils/index.d.ts +346 -10
- package/package.json +47 -41
- package/dist/cjs/_virtual/ipaddr.cjs +0 -2
- package/dist/cjs/_virtual/ipaddr.cjs.map +0 -1
- package/dist/cjs/_virtual/ipaddr2.cjs +0 -2
- package/dist/cjs/_virtual/ipaddr2.cjs.map +0 -1
- package/dist/cjs/address/getDomainsForAddress.cjs +0 -2
- package/dist/cjs/address/getDomainsForAddress.cjs.map +0 -1
- package/dist/cjs/address/getNftsForAddress.cjs +0 -2
- package/dist/cjs/address/getNftsForAddress.cjs.map +0 -1
- package/dist/cjs/bindings/registerWithNft.cjs +0 -2
- package/dist/cjs/bindings/registerWithNft.cjs.map +0 -1
- package/dist/cjs/bindings/validateRoa.cjs +0 -2
- package/dist/cjs/bindings/validateRoa.cjs.map +0 -1
- package/dist/cjs/bindings/validateRoaEthereum.cjs +0 -2
- package/dist/cjs/bindings/validateRoaEthereum.cjs.map +0 -1
- package/dist/cjs/bindings/writeRoa.cjs +0 -2
- package/dist/cjs/bindings/writeRoa.cjs.map +0 -1
- package/dist/cjs/domain/getAllDomains.cjs +0 -2
- package/dist/cjs/domain/getAllDomains.cjs.map +0 -1
- package/dist/cjs/domain/getDomainAddress.cjs +0 -2
- package/dist/cjs/domain/getDomainAddress.cjs.map +0 -1
- package/dist/cjs/domain/resolveDomain.cjs +0 -2
- package/dist/cjs/domain/resolveDomain.cjs.map +0 -1
- package/dist/cjs/instructions/createAtaInstruction.cjs +0 -2
- package/dist/cjs/instructions/createAtaInstruction.cjs.map +0 -1
- package/dist/cjs/instructions/createInstructionV3.cjs +0 -2
- package/dist/cjs/instructions/createInstructionV3.cjs.map +0 -1
- package/dist/cjs/instructions/createV2Instruction.cjs +0 -2
- package/dist/cjs/instructions/createV2Instruction.cjs.map +0 -1
- package/dist/cjs/instructions/registerFavoriteInstruction.cjs +0 -2
- package/dist/cjs/instructions/registerFavoriteInstruction.cjs.map +0 -1
- package/dist/cjs/instructions/validateRoaEthereumInstruction.cjs +0 -2
- package/dist/cjs/instructions/validateRoaEthereumInstruction.cjs.map +0 -1
- package/dist/cjs/instructions/validateRoaInstruction.cjs +0 -2
- package/dist/cjs/instructions/validateRoaInstruction.cjs.map +0 -1
- package/dist/cjs/instructions/writeRoaInstruction.cjs +0 -2
- package/dist/cjs/instructions/writeRoaInstruction.cjs.map +0 -1
- package/dist/cjs/nft/getNftMint.cjs +0 -2
- package/dist/cjs/nft/getNftMint.cjs.map +0 -1
- package/dist/cjs/nft/getNftOwner.cjs +0 -2
- package/dist/cjs/nft/getNftOwner.cjs.map +0 -1
- package/dist/cjs/node_modules/@scure/base/lib/esm/index.cjs +0 -3
- package/dist/cjs/node_modules/@scure/base/lib/esm/index.cjs.map +0 -1
- package/dist/cjs/node_modules/@solana-program/token/dist/src/index.cjs +0 -2
- package/dist/cjs/node_modules/@solana-program/token/dist/src/index.cjs.map +0 -1
- package/dist/cjs/node_modules/borsh/lib/esm/buffer.cjs +0 -2
- package/dist/cjs/node_modules/borsh/lib/esm/buffer.cjs.map +0 -1
- package/dist/cjs/node_modules/borsh/lib/esm/deserialize.cjs +0 -2
- package/dist/cjs/node_modules/borsh/lib/esm/deserialize.cjs.map +0 -1
- package/dist/cjs/node_modules/borsh/lib/esm/index.cjs +0 -2
- package/dist/cjs/node_modules/borsh/lib/esm/index.cjs.map +0 -1
- package/dist/cjs/node_modules/borsh/lib/esm/serialize.cjs +0 -2
- package/dist/cjs/node_modules/borsh/lib/esm/serialize.cjs.map +0 -1
- package/dist/cjs/node_modules/borsh/lib/esm/types.cjs +0 -2
- package/dist/cjs/node_modules/borsh/lib/esm/types.cjs.map +0 -1
- package/dist/cjs/node_modules/borsh/lib/esm/utils.cjs +0 -2
- package/dist/cjs/node_modules/borsh/lib/esm/utils.cjs.map +0 -1
- package/dist/cjs/node_modules/ipaddr.js/lib/ipaddr.cjs +0 -2
- package/dist/cjs/node_modules/ipaddr.js/lib/ipaddr.cjs.map +0 -1
- package/dist/cjs/node_modules/punycode/punycode.es6.cjs +0 -2
- package/dist/cjs/node_modules/punycode/punycode.es6.cjs.map +0 -1
- package/dist/esm/_virtual/ipaddr.mjs +0 -2
- package/dist/esm/_virtual/ipaddr.mjs.map +0 -1
- package/dist/esm/_virtual/ipaddr2.mjs +0 -2
- package/dist/esm/_virtual/ipaddr2.mjs.map +0 -1
- package/dist/esm/address/getDomainsForAddress.mjs +0 -2
- package/dist/esm/address/getDomainsForAddress.mjs.map +0 -1
- package/dist/esm/address/getNftsForAddress.mjs +0 -2
- package/dist/esm/address/getNftsForAddress.mjs.map +0 -1
- package/dist/esm/bindings/registerWithNft.mjs +0 -2
- package/dist/esm/bindings/registerWithNft.mjs.map +0 -1
- package/dist/esm/bindings/validateRoa.mjs +0 -2
- package/dist/esm/bindings/validateRoa.mjs.map +0 -1
- package/dist/esm/bindings/validateRoaEthereum.mjs +0 -2
- package/dist/esm/bindings/validateRoaEthereum.mjs.map +0 -1
- package/dist/esm/bindings/writeRoa.mjs +0 -2
- package/dist/esm/bindings/writeRoa.mjs.map +0 -1
- package/dist/esm/domain/getAllDomains.mjs +0 -2
- package/dist/esm/domain/getAllDomains.mjs.map +0 -1
- package/dist/esm/domain/getDomainAddress.mjs +0 -2
- package/dist/esm/domain/getDomainAddress.mjs.map +0 -1
- package/dist/esm/domain/resolveDomain.mjs +0 -2
- package/dist/esm/domain/resolveDomain.mjs.map +0 -1
- package/dist/esm/instructions/createAtaInstruction.mjs +0 -2
- package/dist/esm/instructions/createAtaInstruction.mjs.map +0 -1
- package/dist/esm/instructions/createInstructionV3.mjs +0 -2
- package/dist/esm/instructions/createInstructionV3.mjs.map +0 -1
- package/dist/esm/instructions/createV2Instruction.mjs +0 -2
- package/dist/esm/instructions/createV2Instruction.mjs.map +0 -1
- package/dist/esm/instructions/registerFavoriteInstruction.mjs +0 -2
- package/dist/esm/instructions/registerFavoriteInstruction.mjs.map +0 -1
- package/dist/esm/instructions/validateRoaEthereumInstruction.mjs +0 -2
- package/dist/esm/instructions/validateRoaEthereumInstruction.mjs.map +0 -1
- package/dist/esm/instructions/validateRoaInstruction.mjs +0 -2
- package/dist/esm/instructions/validateRoaInstruction.mjs.map +0 -1
- package/dist/esm/instructions/writeRoaInstruction.mjs +0 -2
- package/dist/esm/instructions/writeRoaInstruction.mjs.map +0 -1
- package/dist/esm/nft/getNftMint.mjs +0 -2
- package/dist/esm/nft/getNftMint.mjs.map +0 -1
- package/dist/esm/nft/getNftOwner.mjs +0 -2
- package/dist/esm/nft/getNftOwner.mjs.map +0 -1
- package/dist/esm/node_modules/@scure/base/lib/esm/index.mjs +0 -3
- package/dist/esm/node_modules/@scure/base/lib/esm/index.mjs.map +0 -1
- package/dist/esm/node_modules/@solana-program/token/dist/src/index.mjs +0 -2
- package/dist/esm/node_modules/@solana-program/token/dist/src/index.mjs.map +0 -1
- package/dist/esm/node_modules/borsh/lib/esm/buffer.mjs +0 -2
- package/dist/esm/node_modules/borsh/lib/esm/buffer.mjs.map +0 -1
- package/dist/esm/node_modules/borsh/lib/esm/deserialize.mjs +0 -2
- package/dist/esm/node_modules/borsh/lib/esm/deserialize.mjs.map +0 -1
- package/dist/esm/node_modules/borsh/lib/esm/index.mjs +0 -2
- package/dist/esm/node_modules/borsh/lib/esm/index.mjs.map +0 -1
- package/dist/esm/node_modules/borsh/lib/esm/serialize.mjs +0 -2
- package/dist/esm/node_modules/borsh/lib/esm/serialize.mjs.map +0 -1
- package/dist/esm/node_modules/borsh/lib/esm/types.mjs +0 -2
- package/dist/esm/node_modules/borsh/lib/esm/types.mjs.map +0 -1
- package/dist/esm/node_modules/borsh/lib/esm/utils.mjs +0 -2
- package/dist/esm/node_modules/borsh/lib/esm/utils.mjs.map +0 -1
- package/dist/esm/node_modules/ipaddr.js/lib/ipaddr.mjs +0 -2
- package/dist/esm/node_modules/ipaddr.js/lib/ipaddr.mjs.map +0 -1
- package/dist/esm/node_modules/punycode/punycode.es6.mjs +0 -2
- package/dist/esm/node_modules/punycode/punycode.es6.mjs.map +0 -1
- package/dist/types/address/getDomainsForAddress.d.ts +0 -19
- package/dist/types/address/getNftsForAddress.d.ts +0 -20
- package/dist/types/address/getPrimaryDomain.d.ts +0 -22
- package/dist/types/address/getPrimaryDomainsBatch.d.ts +0 -16
- package/dist/types/bindings/burnDomain.d.ts +0 -17
- package/dist/types/bindings/createNameRegistry.d.ts +0 -28
- package/dist/types/bindings/createRecord.d.ts +0 -23
- package/dist/types/bindings/createReverse.d.ts +0 -21
- package/dist/types/bindings/createSubdomain.d.ts +0 -23
- package/dist/types/bindings/deleteNameRegistry.d.ts +0 -21
- package/dist/types/bindings/deleteRecord.d.ts +0 -20
- package/dist/types/bindings/registerDomain.d.ts +0 -25
- package/dist/types/bindings/registerWithNft.d.ts +0 -21
- package/dist/types/bindings/setPrimaryDomain.d.ts +0 -16
- package/dist/types/bindings/transferDomain.d.ts +0 -23
- package/dist/types/bindings/transferSubdomain.d.ts +0 -25
- package/dist/types/bindings/updateNameRegistry.d.ts +0 -22
- package/dist/types/bindings/updateRecord.d.ts +0 -22
- package/dist/types/bindings/validateRoa.d.ts +0 -24
- package/dist/types/bindings/validateRoaEthereum.d.ts +0 -24
- package/dist/types/bindings/writeRoa.d.ts +0 -22
- package/dist/types/constants/addresses.d.ts +0 -53
- package/dist/types/constants/pythFeeds.d.ts +0 -3
- package/dist/types/constants/records.d.ts +0 -23
- package/dist/types/domain/getAllDomains.d.ts +0 -16
- package/dist/types/domain/getDomainAddress.d.ts +0 -30
- package/dist/types/domain/getDomainOwner.d.ts +0 -16
- package/dist/types/domain/getDomainRecord.d.ts +0 -35
- package/dist/types/domain/getDomainRecords.d.ts +0 -39
- package/dist/types/domain/getSubdomains.d.ts +0 -19
- package/dist/types/domain/resolveDomain.d.ts +0 -26
- package/dist/types/instructions/allocateAndPostRecordInstruction.d.ts +0 -23
- package/dist/types/instructions/burnDomainInstruction.d.ts +0 -12
- package/dist/types/instructions/createAtaInstruction.d.ts +0 -2
- package/dist/types/instructions/createInstructionV3.d.ts +0 -24
- package/dist/types/instructions/createNameRegistryInstruction.d.ts +0 -26
- package/dist/types/instructions/createReverseInstruction.d.ts +0 -16
- package/dist/types/instructions/createSplitV2Instruction.d.ts +0 -24
- package/dist/types/instructions/createV2Instruction.d.ts +0 -19
- package/dist/types/instructions/createWithNftInstruction.d.ts +0 -19
- package/dist/types/instructions/deleteNameRegistryInstruction.d.ts +0 -12
- package/dist/types/instructions/deleteRecordInstruction.d.ts +0 -12
- package/dist/types/instructions/reallocInstruction.d.ts +0 -16
- package/dist/types/instructions/registerFavoriteInstruction.d.ts +0 -12
- package/dist/types/instructions/transferInstruction.d.ts +0 -21
- package/dist/types/instructions/updateNameRegistryInstruction.d.ts +0 -23
- package/dist/types/instructions/updateRecordInstruction.d.ts +0 -23
- package/dist/types/instructions/validateRoaEthereumInstruction.d.ts +0 -30
- package/dist/types/instructions/validateRoaInstruction.d.ts +0 -16
- package/dist/types/instructions/writeRoaInstruction.d.ts +0 -20
- package/dist/types/nft/getNftMint.d.ts +0 -13
- package/dist/types/nft/getNftOwner.d.ts +0 -15
- package/dist/types/record/getRecordV1Address.d.ts +0 -15
- package/dist/types/record/getRecordV2Address.d.ts +0 -16
- package/dist/types/record/verifyRecordRightOfAssociation.d.ts +0 -40
- package/dist/types/record/verifyRecordStaleness.d.ts +0 -31
- package/dist/types/states/nft.d.ts +0 -50
- package/dist/types/states/primaryDomain.d.ts +0 -25
- package/dist/types/states/record.d.ts +0 -30
- package/dist/types/states/registry.d.ts +0 -39
- package/dist/types/types/record.d.ts +0 -38
- package/dist/types/types/validation.d.ts +0 -6
- package/dist/types/utils/check.d.ts +0 -10
- package/dist/types/utils/checkAddressOnCurve/ed25519.d.ts +0 -1
- package/dist/types/utils/checkAddressOnCurve/index.d.ts +0 -2
- package/dist/types/utils/deriveAddress.d.ts +0 -28
- package/dist/types/utils/deserializers/deserializeRecordContent.d.ts +0 -17
- package/dist/types/utils/deserializers/deserializeReverse.d.ts +0 -16
- package/dist/types/utils/getPythFeedAddress.d.ts +0 -14
- package/dist/types/utils/getReverseAddress.d.ts +0 -1
- package/dist/types/utils/getReverseAddressFromDomainAddress.d.ts +0 -15
- package/dist/types/utils/reverseLookup.d.ts +0 -18
- package/dist/types/utils/reverseLookupBatch.d.ts +0 -16
- package/dist/types/utils/serializers/serializeRecordContent.d.ts +0 -16
- package/dist/types/utils/uint8Array/uint8ArrayFromHex.d.ts +0 -6
- package/dist/types/utils/uint8Array/uint8ArrayToHex.d.ts +0 -7
- package/dist/types/utils/uint8Array/uint8ArraysConcat.d.ts +0 -8
- package/dist/types/utils/uint8Array/uint8ArraysEqual.d.ts +0 -9
package/README.md
CHANGED
|
@@ -1,90 +1,322 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img width="
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
# SNS JS
|
|
6
|
-
|
|
7
|
-
](https://www.npmjs.com/package/@solana-name-service/sns-sdk-kit)
|
|
8
|
+
[](../LICENSE)
|
|
9
|
+
|
|
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.
|
|
11
|
+
|
|
12
|
+
> **Migrating from v0?** This release is not fully backward compatible. Review the [changelog](./CHANGELOG.md) for breaking changes and migration notes.
|
|
13
|
+
|
|
14
|
+
## Installation
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
npm install @solana-name-service/sns-sdk-kit @solana/kit
|
|
18
|
+
```
|
|
19
|
+
|
|
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.
|
|
25
|
+
|
|
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:
|
|
31
|
+
|
|
32
|
+
```typescript
|
|
33
|
+
import {
|
|
34
|
+
createDefaultRpcTransport,
|
|
35
|
+
createSolanaRpcFromTransport,
|
|
36
|
+
} from "@solana/kit";
|
|
37
|
+
|
|
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);
|
|
80
|
+
```
|
|
81
|
+
|
|
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
|
|
314
|
+
|
|
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/)
|
|
319
|
+
|
|
320
|
+
## License
|
|
321
|
+
|
|
322
|
+
Released under the [MIT License](../LICENSE).
|
|
@@ -1,2 +1,55 @@
|
|
|
1
|
-
|
|
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
|
|
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
|
-
|
|
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
|