@solana-name-service/sns-sdk-kit 1.0.1 → 1.1.0-beta.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -15
- package/dist/cjs/address/getPrimaryDomain.cjs.map +1 -1
- package/dist/cjs/address/getPrimaryDomainsBatch.cjs.map +1 -1
- package/dist/cjs/address/getSnsDomainsForAddress.cjs.map +1 -1
- package/dist/cjs/address/getSnsNftsForAddress.cjs.map +1 -1
- package/dist/cjs/address/getSolDomainsForAddress.cjs +86 -0
- package/dist/cjs/address/getSolDomainsForAddress.cjs.map +1 -0
- package/dist/cjs/address/getSolNftsForAddress.cjs +144 -0
- package/dist/cjs/address/getSolNftsForAddress.cjs.map +1 -0
- package/dist/cjs/address/index.cjs +4 -0
- package/dist/cjs/address/index.cjs.map +1 -1
- package/dist/cjs/bindings/burnDomain.cjs.map +1 -1
- package/dist/cjs/bindings/createNameRegistry.cjs.map +1 -1
- package/dist/cjs/bindings/createRecord.cjs.map +1 -1
- package/dist/cjs/bindings/createReverse.cjs.map +1 -1
- package/dist/cjs/bindings/createSubdomain.cjs.map +1 -1
- package/dist/cjs/bindings/deleteNameRegistry.cjs.map +1 -1
- package/dist/cjs/bindings/deleteRecord.cjs.map +1 -1
- package/dist/cjs/bindings/recordValidation.cjs.map +1 -1
- package/dist/cjs/bindings/registerDomain.cjs.map +1 -1
- package/dist/cjs/bindings/registerDomainWithNft.cjs.map +1 -1
- package/dist/cjs/bindings/setPrimaryDomain.cjs.map +1 -1
- package/dist/cjs/bindings/setRecordRoaVerifier.cjs.map +1 -1
- package/dist/cjs/bindings/setRecordStalenessVerifier.cjs.map +1 -1
- package/dist/cjs/bindings/transferDomain.cjs.map +1 -1
- package/dist/cjs/bindings/transferSubdomain.cjs.map +1 -1
- package/dist/cjs/bindings/updateNameRegistry.cjs.map +1 -1
- package/dist/cjs/bindings/updateRecord.cjs.map +1 -1
- package/dist/cjs/bindings/validateRecordRoa.cjs.map +1 -1
- package/dist/cjs/bindings/validateRecordRoaEthereum.cjs.map +1 -1
- package/dist/cjs/codecs.cjs.map +1 -1
- package/dist/cjs/constants/addresses.cjs +26 -16
- package/dist/cjs/constants/addresses.cjs.map +1 -1
- package/dist/cjs/constants/index.cjs +18 -0
- package/dist/cjs/constants/index.cjs.map +1 -1
- package/dist/cjs/constants/pythFeeds.cjs.map +1 -1
- package/dist/cjs/constants/records.cjs.map +1 -1
- package/dist/cjs/constants/srs.cjs +48 -0
- package/dist/cjs/constants/srs.cjs.map +1 -0
- package/dist/cjs/domain/getAllSnsDomains.cjs.map +1 -1
- package/dist/cjs/domain/getAllSolDomains.cjs +58 -0
- package/dist/cjs/domain/getAllSolDomains.cjs.map +1 -0
- package/dist/cjs/domain/getDomainOwner.cjs +3 -3
- package/dist/cjs/domain/getDomainOwner.cjs.map +1 -1
- package/dist/cjs/domain/getDomainRecord.cjs +3 -3
- package/dist/cjs/domain/getDomainRecord.cjs.map +1 -1
- package/dist/cjs/domain/getDomainRecords.cjs +3 -3
- package/dist/cjs/domain/getDomainRecords.cjs.map +1 -1
- package/dist/cjs/domain/getSnsDomainAddress.cjs.map +1 -1
- package/dist/cjs/domain/getSnsDomainOwner.cjs +1 -2
- package/dist/cjs/domain/getSnsDomainOwner.cjs.map +1 -1
- package/dist/cjs/domain/getSolDomainAddress.cjs +36 -0
- package/dist/cjs/domain/getSolDomainAddress.cjs.map +1 -0
- package/dist/cjs/domain/getSrsDomainAddress.cjs +4 -17
- package/dist/cjs/domain/getSrsDomainAddress.cjs.map +1 -1
- package/dist/cjs/domain/getSubdomains.cjs +3 -3
- package/dist/cjs/domain/getSubdomains.cjs.map +1 -1
- package/dist/cjs/domain/index.cjs +4 -0
- package/dist/cjs/domain/index.cjs.map +1 -1
- package/dist/cjs/domain/resolve.cjs +19 -12
- package/dist/cjs/domain/resolve.cjs.map +1 -1
- package/dist/cjs/domain/resolveSns.cjs.map +1 -1
- package/dist/cjs/domain/resolveSol.cjs +129 -0
- package/dist/cjs/domain/resolveSol.cjs.map +1 -0
- package/dist/cjs/errors.cjs.map +1 -1
- package/dist/cjs/index.cjs +141 -115
- package/dist/cjs/index.cjs.map +1 -1
- package/dist/cjs/instructions/allocateAndPostRecordInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/burnDomainInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/createAtaIdempotentInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/createNameRegistryInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/createReverseInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/createSplitV2Instruction.cjs.map +1 -1
- package/dist/cjs/instructions/createWithNftInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/deleteNameRegistryInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/deleteRecordInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/reallocInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/registerPrimaryInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/setRecordRoaVerifierInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/transferInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/updateNameRegistryInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/updateRecordInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/validateEthereumSignatureInstruction.cjs.map +1 -1
- package/dist/cjs/instructions/validateSolanaSignatureInstruction.cjs.map +1 -1
- package/dist/cjs/nft/getSnsNftMint.cjs.map +1 -1
- package/dist/cjs/nft/getSnsNftOwner.cjs.map +1 -1
- package/dist/cjs/record/getRecordV1Address.cjs.map +1 -1
- package/dist/cjs/record/getRecordV2Address.cjs.map +1 -1
- package/dist/cjs/record/verifyRecordRightOfAssociation.cjs +3 -3
- package/dist/cjs/record/verifyRecordRightOfAssociation.cjs.map +1 -1
- package/dist/cjs/record/verifyRecordStaleness.cjs +3 -3
- package/dist/cjs/record/verifyRecordStaleness.cjs.map +1 -1
- package/dist/cjs/srs/additional-metadata.cjs +20 -0
- package/dist/cjs/srs/additional-metadata.cjs.map +1 -0
- package/dist/cjs/srs/metadata.cjs +27 -0
- package/dist/cjs/srs/metadata.cjs.map +1 -0
- package/dist/cjs/states/nft.cjs.map +1 -1
- package/dist/cjs/states/primaryDomain.cjs.map +1 -1
- package/dist/cjs/states/record.cjs.map +1 -1
- package/dist/cjs/states/registry.cjs.map +1 -1
- package/dist/cjs/types/record.cjs.map +1 -1
- package/dist/cjs/types/validation.cjs.map +1 -1
- package/dist/cjs/utils/check.cjs.map +1 -1
- package/dist/cjs/utils/checkAddressOnCurve/ed25519.cjs.map +1 -1
- package/dist/cjs/utils/checkAddressOnCurve/index.cjs.map +1 -1
- package/dist/cjs/utils/deriveAddress.cjs.map +1 -1
- package/dist/cjs/utils/deserializers/deserializeRecordContent.cjs.map +1 -1
- package/dist/cjs/utils/deserializers/deserializeReverse.cjs.map +1 -1
- package/dist/cjs/utils/fetchEncodedAccountsBatched.cjs +29 -0
- package/dist/cjs/utils/fetchEncodedAccountsBatched.cjs.map +1 -0
- package/dist/cjs/utils/getPythFeedAddress.cjs.map +1 -1
- package/dist/cjs/utils/getReverseAddress.cjs.map +1 -1
- package/dist/cjs/utils/getReverseAddressFromDomainAddress.cjs.map +1 -1
- package/dist/cjs/utils/parseSnsDomain.cjs +1 -2
- package/dist/cjs/utils/parseSnsDomain.cjs.map +1 -1
- package/dist/cjs/utils/reverseLookup.cjs.map +1 -1
- package/dist/cjs/utils/reverseLookupBatch.cjs.map +1 -1
- package/dist/cjs/utils/serializers/serializeRecordContent.cjs.map +1 -1
- package/dist/cjs/utils/tld.cjs +1 -1
- package/dist/cjs/utils/tld.cjs.map +1 -1
- package/dist/cjs/utils/token2022/assertValidAccountData.cjs +37 -0
- package/dist/cjs/utils/token2022/assertValidAccountData.cjs.map +1 -0
- package/dist/cjs/utils/token2022/extensions.cjs +91 -0
- package/dist/cjs/utils/token2022/extensions.cjs.map +1 -0
- package/dist/cjs/utils/token2022/unpackAccount.cjs +29 -0
- package/dist/cjs/utils/token2022/unpackAccount.cjs.map +1 -0
- package/dist/cjs/utils/token2022/unpackMint.cjs +27 -0
- package/dist/cjs/utils/token2022/unpackMint.cjs.map +1 -0
- package/dist/cjs/utils/uint8Array/uint8ArrayFromHex.cjs.map +1 -1
- package/dist/cjs/utils/uint8Array/uint8ArrayToHex.cjs.map +1 -1
- package/dist/cjs/utils/uint8Array/uint8ArraysEqual.cjs.map +1 -1
- package/dist/esm/address/getPrimaryDomain.mjs.map +1 -1
- package/dist/esm/address/getPrimaryDomainsBatch.mjs.map +1 -1
- package/dist/esm/address/getSnsDomainsForAddress.mjs.map +1 -1
- package/dist/esm/address/getSnsNftsForAddress.mjs.map +1 -1
- package/dist/esm/address/getSolDomainsForAddress.mjs +82 -0
- package/dist/esm/address/getSolDomainsForAddress.mjs.map +1 -0
- package/dist/esm/address/getSolNftsForAddress.mjs +140 -0
- package/dist/esm/address/getSolNftsForAddress.mjs.map +1 -0
- package/dist/esm/address/index.mjs +2 -0
- package/dist/esm/address/index.mjs.map +1 -1
- package/dist/esm/bindings/burnDomain.mjs.map +1 -1
- package/dist/esm/bindings/createNameRegistry.mjs.map +1 -1
- package/dist/esm/bindings/createRecord.mjs.map +1 -1
- package/dist/esm/bindings/createReverse.mjs.map +1 -1
- package/dist/esm/bindings/createSubdomain.mjs.map +1 -1
- package/dist/esm/bindings/deleteNameRegistry.mjs.map +1 -1
- package/dist/esm/bindings/deleteRecord.mjs.map +1 -1
- package/dist/esm/bindings/recordValidation.mjs.map +1 -1
- package/dist/esm/bindings/registerDomain.mjs.map +1 -1
- package/dist/esm/bindings/registerDomainWithNft.mjs.map +1 -1
- package/dist/esm/bindings/setPrimaryDomain.mjs.map +1 -1
- package/dist/esm/bindings/setRecordRoaVerifier.mjs.map +1 -1
- package/dist/esm/bindings/setRecordStalenessVerifier.mjs.map +1 -1
- package/dist/esm/bindings/transferDomain.mjs.map +1 -1
- package/dist/esm/bindings/transferSubdomain.mjs.map +1 -1
- package/dist/esm/bindings/updateNameRegistry.mjs.map +1 -1
- package/dist/esm/bindings/updateRecord.mjs.map +1 -1
- package/dist/esm/bindings/validateRecordRoa.mjs.map +1 -1
- package/dist/esm/bindings/validateRecordRoaEthereum.mjs.map +1 -1
- package/dist/esm/codecs.mjs.map +1 -1
- package/dist/esm/constants/addresses.mjs +24 -17
- package/dist/esm/constants/addresses.mjs.map +1 -1
- package/dist/esm/constants/index.mjs +2 -1
- package/dist/esm/constants/index.mjs.map +1 -1
- package/dist/esm/constants/pythFeeds.mjs.map +1 -1
- package/dist/esm/constants/records.mjs.map +1 -1
- package/dist/esm/constants/srs.mjs +31 -0
- package/dist/esm/constants/srs.mjs.map +1 -0
- package/dist/esm/domain/getAllSnsDomains.mjs.map +1 -1
- package/dist/esm/domain/getAllSolDomains.mjs +54 -0
- package/dist/esm/domain/getAllSolDomains.mjs.map +1 -0
- package/dist/esm/domain/getDomainOwner.mjs +3 -3
- package/dist/esm/domain/getDomainOwner.mjs.map +1 -1
- package/dist/esm/domain/getDomainRecord.mjs +3 -3
- package/dist/esm/domain/getDomainRecord.mjs.map +1 -1
- package/dist/esm/domain/getDomainRecords.mjs +3 -3
- package/dist/esm/domain/getDomainRecords.mjs.map +1 -1
- package/dist/esm/domain/getSnsDomainAddress.mjs.map +1 -1
- package/dist/esm/domain/getSnsDomainOwner.mjs +1 -2
- package/dist/esm/domain/getSnsDomainOwner.mjs.map +1 -1
- package/dist/esm/domain/getSolDomainAddress.mjs +32 -0
- package/dist/esm/domain/getSolDomainAddress.mjs.map +1 -0
- package/dist/esm/domain/getSrsDomainAddress.mjs +4 -17
- package/dist/esm/domain/getSrsDomainAddress.mjs.map +1 -1
- package/dist/esm/domain/getSubdomains.mjs +3 -3
- package/dist/esm/domain/getSubdomains.mjs.map +1 -1
- package/dist/esm/domain/index.mjs +2 -0
- package/dist/esm/domain/index.mjs.map +1 -1
- package/dist/esm/domain/resolve.mjs +20 -13
- package/dist/esm/domain/resolve.mjs.map +1 -1
- package/dist/esm/domain/resolveSns.mjs.map +1 -1
- package/dist/esm/domain/resolveSol.mjs +125 -0
- package/dist/esm/domain/resolveSol.mjs.map +1 -0
- package/dist/esm/errors.mjs.map +1 -1
- package/dist/esm/index.mjs +51 -46
- package/dist/esm/index.mjs.map +1 -1
- package/dist/esm/instructions/allocateAndPostRecordInstruction.mjs.map +1 -1
- package/dist/esm/instructions/burnDomainInstruction.mjs.map +1 -1
- package/dist/esm/instructions/createAtaIdempotentInstruction.mjs.map +1 -1
- package/dist/esm/instructions/createNameRegistryInstruction.mjs.map +1 -1
- package/dist/esm/instructions/createReverseInstruction.mjs.map +1 -1
- package/dist/esm/instructions/createSplitV2Instruction.mjs.map +1 -1
- package/dist/esm/instructions/createWithNftInstruction.mjs.map +1 -1
- package/dist/esm/instructions/deleteNameRegistryInstruction.mjs.map +1 -1
- package/dist/esm/instructions/deleteRecordInstruction.mjs.map +1 -1
- package/dist/esm/instructions/reallocInstruction.mjs.map +1 -1
- package/dist/esm/instructions/registerPrimaryInstruction.mjs.map +1 -1
- package/dist/esm/instructions/setRecordRoaVerifierInstruction.mjs.map +1 -1
- package/dist/esm/instructions/transferInstruction.mjs.map +1 -1
- package/dist/esm/instructions/updateNameRegistryInstruction.mjs.map +1 -1
- package/dist/esm/instructions/updateRecordInstruction.mjs.map +1 -1
- package/dist/esm/instructions/validateEthereumSignatureInstruction.mjs.map +1 -1
- package/dist/esm/instructions/validateSolanaSignatureInstruction.mjs.map +1 -1
- package/dist/esm/nft/getSnsNftMint.mjs +1 -1
- package/dist/esm/nft/getSnsNftMint.mjs.map +1 -1
- package/dist/esm/nft/getSnsNftOwner.mjs.map +1 -1
- package/dist/esm/record/getRecordV1Address.mjs.map +1 -1
- package/dist/esm/record/getRecordV2Address.mjs.map +1 -1
- package/dist/esm/record/verifyRecordRightOfAssociation.mjs +3 -3
- package/dist/esm/record/verifyRecordRightOfAssociation.mjs.map +1 -1
- package/dist/esm/record/verifyRecordStaleness.mjs +3 -3
- package/dist/esm/record/verifyRecordStaleness.mjs.map +1 -1
- package/dist/esm/srs/additional-metadata.mjs +16 -0
- package/dist/esm/srs/additional-metadata.mjs.map +1 -0
- package/dist/esm/srs/metadata.mjs +23 -0
- package/dist/esm/srs/metadata.mjs.map +1 -0
- package/dist/esm/states/nft.mjs.map +1 -1
- package/dist/esm/states/primaryDomain.mjs.map +1 -1
- package/dist/esm/states/record.mjs +1 -1
- package/dist/esm/states/record.mjs.map +1 -1
- package/dist/esm/states/registry.mjs.map +1 -1
- package/dist/esm/types/record.mjs.map +1 -1
- package/dist/esm/types/validation.mjs.map +1 -1
- package/dist/esm/utils/check.mjs.map +1 -1
- package/dist/esm/utils/checkAddressOnCurve/ed25519.mjs.map +1 -1
- package/dist/esm/utils/checkAddressOnCurve/index.mjs.map +1 -1
- package/dist/esm/utils/deriveAddress.mjs.map +1 -1
- package/dist/esm/utils/deserializers/deserializeRecordContent.mjs.map +1 -1
- package/dist/esm/utils/deserializers/deserializeReverse.mjs.map +1 -1
- package/dist/esm/utils/fetchEncodedAccountsBatched.mjs +25 -0
- package/dist/esm/utils/fetchEncodedAccountsBatched.mjs.map +1 -0
- package/dist/esm/utils/getPythFeedAddress.mjs.map +1 -1
- package/dist/esm/utils/getReverseAddress.mjs.map +1 -1
- package/dist/esm/utils/getReverseAddressFromDomainAddress.mjs.map +1 -1
- package/dist/esm/utils/parseSnsDomain.mjs +1 -2
- package/dist/esm/utils/parseSnsDomain.mjs.map +1 -1
- package/dist/esm/utils/reverseLookup.mjs.map +1 -1
- package/dist/esm/utils/reverseLookupBatch.mjs.map +1 -1
- package/dist/esm/utils/serializers/serializeRecordContent.mjs.map +1 -1
- package/dist/esm/utils/tld.mjs +1 -1
- package/dist/esm/utils/tld.mjs.map +1 -1
- package/dist/esm/utils/token2022/assertValidAccountData.mjs +33 -0
- package/dist/esm/utils/token2022/assertValidAccountData.mjs.map +1 -0
- package/dist/esm/utils/token2022/extensions.mjs +85 -0
- package/dist/esm/utils/token2022/extensions.mjs.map +1 -0
- package/dist/esm/utils/token2022/unpackAccount.mjs +25 -0
- package/dist/esm/utils/token2022/unpackAccount.mjs.map +1 -0
- package/dist/esm/utils/token2022/unpackMint.mjs +23 -0
- package/dist/esm/utils/token2022/unpackMint.mjs.map +1 -0
- package/dist/esm/utils/uint8Array/uint8ArrayFromHex.mjs.map +1 -1
- package/dist/esm/utils/uint8Array/uint8ArrayToHex.mjs.map +1 -1
- package/dist/esm/utils/uint8Array/uint8ArraysEqual.mjs.map +1 -1
- package/dist/types/address/index.d.ts +103 -2
- package/dist/types/constants/index.d.ts +53 -17
- package/dist/types/domain/index.d.ts +94 -32
- package/dist/types/index.d.ts +253 -54
- package/dist/types/record/index.d.ts +6 -6
- package/dist/types/utils/index.d.ts +1 -1
- package/package.json +2 -1
- package/dist/cjs/config.cjs +0 -18
- package/dist/cjs/config.cjs.map +0 -1
- package/dist/cjs/utils/assertTldSupported.cjs +0 -28
- package/dist/cjs/utils/assertTldSupported.cjs.map +0 -1
- package/dist/esm/config.mjs +0 -11
- package/dist/esm/config.mjs.map +0 -1
- package/dist/esm/utils/assertTldSupported.mjs +0 -24
- package/dist/esm/utils/assertTldSupported.mjs.map +0 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Rpc, GetProgramAccountsApi, Address, GetAccountInfoApi, GetTokenLargestAccountsApi,
|
|
1
|
+
import { Rpc, GetProgramAccountsApi, Address, GetAccountInfoApi, GetTokenLargestAccountsApi, GetMultipleAccountsApi, ReadonlyUint8Array } from '@solana/kit';
|
|
2
2
|
import * as _solana_addresses from '@solana/addresses';
|
|
3
3
|
import { Schema } from 'borsh';
|
|
4
4
|
|
|
@@ -42,6 +42,50 @@ interface GetAllSnsDomainsResult {
|
|
|
42
42
|
*/
|
|
43
43
|
declare const getAllSnsDomains: ({ rpc, }: GetAllSnsDomainsParams) => Promise<GetAllSnsDomainsResult[]>;
|
|
44
44
|
|
|
45
|
+
/**
|
|
46
|
+
* Parameters for retrieving all SRS `.sol` domains.
|
|
47
|
+
*
|
|
48
|
+
* @example
|
|
49
|
+
* ```ts
|
|
50
|
+
* const params: GetAllSolDomainsParams = { rpc };
|
|
51
|
+
* ```
|
|
52
|
+
*/
|
|
53
|
+
interface GetAllSolDomainsParams {
|
|
54
|
+
/** RPC client. */
|
|
55
|
+
rpc: Rpc<GetProgramAccountsApi>;
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* A top-level SRS `.sol` domain record.
|
|
59
|
+
*
|
|
60
|
+
* @example
|
|
61
|
+
* ```ts
|
|
62
|
+
* const domain: GetAllSolDomainsResult = { domainAddress, owner };
|
|
63
|
+
* ```
|
|
64
|
+
*/
|
|
65
|
+
interface GetAllSolDomainsResult {
|
|
66
|
+
/** SRS record address. */
|
|
67
|
+
domainAddress: Address;
|
|
68
|
+
/** Raw SRS owner, either a wallet address or Token-2022 mint. */
|
|
69
|
+
owner: Address;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Retrieves all registered top-level `.sol` SRS records, including expired
|
|
73
|
+
* records.
|
|
74
|
+
*
|
|
75
|
+
* The returned owner is the raw SRS owner field. It is a wallet address for a
|
|
76
|
+
* directly owned record and a Token-2022 mint for a tokenized record.
|
|
77
|
+
*
|
|
78
|
+
* @param params Domain retrieval parameters
|
|
79
|
+
* @param params.rpc RPC client implementing program account lookup
|
|
80
|
+
* @returns All top-level SRS records with their addresses and raw owners, including expired records.
|
|
81
|
+
*
|
|
82
|
+
* @example
|
|
83
|
+
* ```ts
|
|
84
|
+
* const domains = await getAllSolDomains({ rpc });
|
|
85
|
+
* ```
|
|
86
|
+
*/
|
|
87
|
+
declare const getAllSolDomains: ({ rpc, }: GetAllSolDomainsParams) => Promise<GetAllSolDomainsResult[]>;
|
|
88
|
+
|
|
45
89
|
/**
|
|
46
90
|
* Supported SNS record identifiers.
|
|
47
91
|
*/
|
|
@@ -132,26 +176,26 @@ interface GetSnsDomainAddressResult {
|
|
|
132
176
|
declare const getSnsDomainAddress: ({ domain, record, }: GetSnsDomainAddressParams) => Promise<GetSnsDomainAddressResult>;
|
|
133
177
|
|
|
134
178
|
/**
|
|
135
|
-
* Parameters for deriving an SRS domain address.
|
|
179
|
+
* Parameters for deriving an SRS `.sol` domain address.
|
|
136
180
|
*
|
|
137
181
|
* @example
|
|
138
182
|
* ```ts
|
|
139
|
-
* const params:
|
|
183
|
+
* const params: GetSolDomainAddressParams = { domain: "example" };
|
|
140
184
|
* ```
|
|
141
185
|
*/
|
|
142
|
-
interface
|
|
143
|
-
/** TLD-
|
|
186
|
+
interface GetSolDomainAddressParams {
|
|
187
|
+
/** TLD-trimmed `.sol` domain name. */
|
|
144
188
|
domain: string;
|
|
145
189
|
}
|
|
146
190
|
/**
|
|
147
|
-
* A derived SRS domain address.
|
|
191
|
+
* A derived SRS `.sol` domain address and canonical name hash.
|
|
148
192
|
*
|
|
149
193
|
* @example
|
|
150
194
|
* ```ts
|
|
151
|
-
* const derived:
|
|
195
|
+
* const derived: GetSolDomainAddressResult = { domainAddress, hashed };
|
|
152
196
|
* ```
|
|
153
197
|
*/
|
|
154
|
-
interface
|
|
198
|
+
interface GetSolDomainAddressResult {
|
|
155
199
|
/** Derived SRS record address. */
|
|
156
200
|
domainAddress: Address;
|
|
157
201
|
/** SHA-256 hash of the canonical name. */
|
|
@@ -161,7 +205,26 @@ interface GetSrsDomainAddressResult {
|
|
|
161
205
|
* Derives the canonical SRS record address for a TLD-trimmed `.sol` name.
|
|
162
206
|
*
|
|
163
207
|
* @param params Derivation parameters
|
|
164
|
-
* @param params.domain TLD-trimmed `.sol` name
|
|
208
|
+
* @param params.domain TLD-trimmed `.sol` domain name
|
|
209
|
+
* @returns The SRS record address and canonical name hash.
|
|
210
|
+
*
|
|
211
|
+
* @example
|
|
212
|
+
* ```ts
|
|
213
|
+
* const derived = await getSolDomainAddress({ domain: "example" });
|
|
214
|
+
* ```
|
|
215
|
+
*/
|
|
216
|
+
declare const getSolDomainAddress: ({ domain, }: GetSolDomainAddressParams) => Promise<GetSolDomainAddressResult>;
|
|
217
|
+
|
|
218
|
+
/** @deprecated Use `GetSolDomainAddressParams` instead. */
|
|
219
|
+
type GetSrsDomainAddressParams = GetSolDomainAddressParams;
|
|
220
|
+
/** @deprecated Use `GetSolDomainAddressResult` instead. */
|
|
221
|
+
type GetSrsDomainAddressResult = GetSolDomainAddressResult;
|
|
222
|
+
/**
|
|
223
|
+
* Derives the canonical SRS record address for a TLD-trimmed `.sol` name.
|
|
224
|
+
*
|
|
225
|
+
* @deprecated Use {@link getSolDomainAddress} instead.
|
|
226
|
+
* @param params Derivation parameters
|
|
227
|
+
* @param params.domain TLD-trimmed `.sol` domain name
|
|
165
228
|
* @returns The SRS record address and canonical name hash.
|
|
166
229
|
*
|
|
167
230
|
* @example
|
|
@@ -169,7 +232,7 @@ interface GetSrsDomainAddressResult {
|
|
|
169
232
|
* const derived = await getSrsDomainAddress({ domain: "example" });
|
|
170
233
|
* ```
|
|
171
234
|
*/
|
|
172
|
-
declare const getSrsDomainAddress: ({ domain, }:
|
|
235
|
+
declare const getSrsDomainAddress: ({ domain, }: GetSolDomainAddressParams) => Promise<GetSolDomainAddressResult>;
|
|
173
236
|
|
|
174
237
|
/**
|
|
175
238
|
* Parameters for retrieving a domain owner.
|
|
@@ -181,8 +244,8 @@ declare const getSrsDomainAddress: ({ domain, }: GetSrsDomainAddressParams) => P
|
|
|
181
244
|
*/
|
|
182
245
|
interface GetDomainOwnerParams {
|
|
183
246
|
/** RPC client. */
|
|
184
|
-
rpc: Rpc<GetAccountInfoApi & GetTokenLargestAccountsApi
|
|
185
|
-
/** Full domain name. */
|
|
247
|
+
rpc: Rpc<GetAccountInfoApi & GetTokenLargestAccountsApi>;
|
|
248
|
+
/** Full `.sns` domain name. */
|
|
186
249
|
domain: string;
|
|
187
250
|
}
|
|
188
251
|
/**
|
|
@@ -191,7 +254,7 @@ interface GetDomainOwnerParams {
|
|
|
191
254
|
*
|
|
192
255
|
* @param params Domain owner retrieval parameters
|
|
193
256
|
* @param params.rpc RPC client implementing account and token-largest-account APIs
|
|
194
|
-
* @param params.domain Full
|
|
257
|
+
* @param params.domain Full `.sns` domain name
|
|
195
258
|
* @returns The domain owner address.
|
|
196
259
|
*
|
|
197
260
|
* @example
|
|
@@ -274,8 +337,8 @@ interface GetDomainRecordOptions {
|
|
|
274
337
|
*/
|
|
275
338
|
interface GetDomainRecordParams {
|
|
276
339
|
/** RPC client. */
|
|
277
|
-
rpc: Rpc<GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi
|
|
278
|
-
/** Full domain name. */
|
|
340
|
+
rpc: Rpc<GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi>;
|
|
341
|
+
/** Full `.sns` domain name. */
|
|
279
342
|
domain: string;
|
|
280
343
|
/** Record type to retrieve. */
|
|
281
344
|
record: Record;
|
|
@@ -323,7 +386,7 @@ interface GetDomainRecordResult {
|
|
|
323
386
|
*
|
|
324
387
|
* @param params Record retrieval parameters
|
|
325
388
|
* @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs
|
|
326
|
-
* @param params.domain Full
|
|
389
|
+
* @param params.domain Full `.sns` domain name
|
|
327
390
|
* @param params.record Record type to retrieve
|
|
328
391
|
* @param params.options Optional record processing options
|
|
329
392
|
* @returns The V2 record state, its verification result, and optional decoded content
|
|
@@ -370,8 +433,8 @@ interface GetDomainRecordsParams<T extends Record[], U extends {
|
|
|
370
433
|
[K in keyof T]: ReadonlyUint8Array | undefined;
|
|
371
434
|
}> {
|
|
372
435
|
/** RPC client. */
|
|
373
|
-
rpc: Rpc<GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi
|
|
374
|
-
/** Full domain name. */
|
|
436
|
+
rpc: Rpc<GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi>;
|
|
437
|
+
/** Full `.sns` domain name. */
|
|
375
438
|
domain: string;
|
|
376
439
|
/** Record types to retrieve. */
|
|
377
440
|
records: [...T];
|
|
@@ -419,7 +482,7 @@ interface GetDomainRecordsResult {
|
|
|
419
482
|
*
|
|
420
483
|
* @param params Record retrieval parameters
|
|
421
484
|
* @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs
|
|
422
|
-
* @param params.domain Full
|
|
485
|
+
* @param params.domain Full `.sns` domain name
|
|
423
486
|
* @param params.records Record types to retrieve
|
|
424
487
|
* @param params.options Optional record processing options
|
|
425
488
|
* @returns Results aligned with `records`; missing V2 record accounts produce `undefined`
|
|
@@ -446,8 +509,8 @@ declare function getDomainRecords<T extends Record[], U extends {
|
|
|
446
509
|
*/
|
|
447
510
|
interface GetSubdomainsParams {
|
|
448
511
|
/** RPC client. */
|
|
449
|
-
rpc: Rpc<GetProgramAccountsApi
|
|
450
|
-
/** Full
|
|
512
|
+
rpc: Rpc<GetProgramAccountsApi>;
|
|
513
|
+
/** Full `.sns` parent domain name. */
|
|
451
514
|
domain: string;
|
|
452
515
|
}
|
|
453
516
|
/**
|
|
@@ -475,7 +538,7 @@ interface GetSubdomainsResult {
|
|
|
475
538
|
*
|
|
476
539
|
* @param params Subdomain retrieval parameters
|
|
477
540
|
* @param params.rpc RPC client implementing program account lookup
|
|
478
|
-
* @param params.domain Full
|
|
541
|
+
* @param params.domain Full `.sns` parent domain name
|
|
479
542
|
* @returns Subdomain names and owner addresses.
|
|
480
543
|
*
|
|
481
544
|
* @example
|
|
@@ -497,7 +560,7 @@ type ResolveOptions = {
|
|
|
497
560
|
programIds: Address[];
|
|
498
561
|
};
|
|
499
562
|
/** RPC client type for domain resolution. */
|
|
500
|
-
type ResolveRpc = Rpc<GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi
|
|
563
|
+
type ResolveRpc = Rpc<GetAccountInfoApi & GetMultipleAccountsApi & GetTokenLargestAccountsApi>;
|
|
501
564
|
/**
|
|
502
565
|
* Parameters for resolving a domain.
|
|
503
566
|
*
|
|
@@ -519,13 +582,12 @@ interface ResolveParams {
|
|
|
519
582
|
* Resolves a `.sns` or `.sol` domain to its target address.
|
|
520
583
|
*
|
|
521
584
|
* @param params Resolution parameters
|
|
522
|
-
* @param params.rpc RPC client implementing account, multiple-account, token-largest-account
|
|
585
|
+
* @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs
|
|
523
586
|
* @param params.domain Full domain name including a `.sns` or `.sol` suffix
|
|
524
587
|
* @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`
|
|
525
588
|
* @returns The resolved target address.
|
|
526
589
|
*
|
|
527
|
-
* @see {@link safeResolve} for `.sol` resolution that verifies the SRS and
|
|
528
|
-
* corresponding SNS targets match when SRS-backed resolution is enabled.
|
|
590
|
+
* @see {@link safeResolve} for `.sol` resolution that verifies the SRS and corresponding SNS targets match.
|
|
529
591
|
*
|
|
530
592
|
* @example
|
|
531
593
|
* ```ts
|
|
@@ -536,18 +598,18 @@ declare const resolve: ({ rpc, domain, options, }: ResolveParams) => Promise<Add
|
|
|
536
598
|
/**
|
|
537
599
|
* Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.
|
|
538
600
|
*
|
|
539
|
-
*
|
|
540
|
-
*
|
|
541
|
-
* {@link Errors.SnsSolResolutionMismatchError} is thrown.
|
|
601
|
+
* For `.sol` input, both the SRS domain and its corresponding `.sns` domain
|
|
602
|
+
* must resolve to the same target; otherwise, {@link Errors.SnsSolResolutionMismatchError} is thrown.
|
|
542
603
|
*
|
|
543
604
|
* @param params Resolution parameters
|
|
544
|
-
* @param params.rpc RPC client implementing account, multiple-account, token-largest-account
|
|
605
|
+
* @param params.rpc RPC client implementing account, multiple-account, and token-largest-account APIs
|
|
545
606
|
* @param params.domain Full domain name including a `.sns` or `.sol` suffix
|
|
546
607
|
* @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`
|
|
547
608
|
* @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}
|
|
548
609
|
* @throws
|
|
549
610
|
* - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.
|
|
550
611
|
* - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.
|
|
612
|
+
*
|
|
551
613
|
* @example
|
|
552
614
|
* ```ts
|
|
553
615
|
* const address = await safeResolve({ rpc, domain: "example.sol" });
|
|
@@ -555,5 +617,5 @@ declare const resolve: ({ rpc, domain, options, }: ResolveParams) => Promise<Add
|
|
|
555
617
|
*/
|
|
556
618
|
declare const safeResolve: ({ rpc, domain, options, }: ResolveParams) => Promise<Address>;
|
|
557
619
|
|
|
558
|
-
export { getAllSnsDomains, getDomainOwner, getDomainRecord, getDomainRecords, getSnsDomainAddress, getSrsDomainAddress, getSubdomains, resolve, safeResolve };
|
|
559
|
-
export type { GetAllSnsDomainsParams, GetAllSnsDomainsResult, GetDomainOwnerParams, GetDomainRecordOptions, GetDomainRecordParams, GetDomainRecordResult, GetDomainRecordVerification, GetDomainRecordsOptions, GetDomainRecordsParams, GetDomainRecordsResult, GetDomainRecordsVerification, GetSnsDomainAddressParams, GetSnsDomainAddressResult, GetSrsDomainAddressParams, GetSrsDomainAddressResult, GetSubdomainsParams, GetSubdomainsResult, ResolveOptions, ResolveParams };
|
|
620
|
+
export { getAllSnsDomains, getAllSolDomains, getDomainOwner, getDomainRecord, getDomainRecords, getSnsDomainAddress, getSolDomainAddress, getSrsDomainAddress, getSubdomains, resolve, safeResolve };
|
|
621
|
+
export type { GetAllSnsDomainsParams, GetAllSnsDomainsResult, GetAllSolDomainsParams, GetAllSolDomainsResult, GetDomainOwnerParams, GetDomainRecordOptions, GetDomainRecordParams, GetDomainRecordResult, GetDomainRecordVerification, GetDomainRecordsOptions, GetDomainRecordsParams, GetDomainRecordsResult, GetDomainRecordsVerification, GetSnsDomainAddressParams, GetSnsDomainAddressResult, GetSolDomainAddressParams, GetSolDomainAddressResult, GetSrsDomainAddressParams, GetSrsDomainAddressResult, GetSubdomainsParams, GetSubdomainsResult, ResolveOptions, ResolveParams };
|