@solana-name-service/sns-sdk-kit 1.0.0 → 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 +335 -322
- 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
package/README.md
CHANGED
|
@@ -1,322 +1,335 @@
|
|
|
1
|
-
<p align="center">
|
|
2
|
-
<img width="200" src="https://www.sns.id/assets/logo/brand.svg" alt="SNS logo" />
|
|
3
|
-
</p>
|
|
4
|
-
|
|
5
|
-
# SNS JS Kit SDK
|
|
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
|
|
87
|
-
|
|
|
88
|
-
|
|
|
89
|
-
|
|
|
90
|
-
|
|
|
91
|
-
|
|
|
92
|
-
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img width="200" src="https://www.sns.id/assets/logo/brand.svg" alt="SNS logo" />
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
# SNS JS Kit SDK
|
|
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
|
+
| Domain resolution with `resolve` and `safeResolve` | Full suffixed name, for example `mydomain.sns` or `mydomain.sol` | `.sns` and `.sol` domains |
|
|
89
|
+
| Top-level writes such as registration, transfer, and burn | Canonical lowercase `mydomain.sns` | Top-level domains only; subdomains are not accepted |
|
|
90
|
+
| Record reads and writes | Canonical lowercase `mydomain.sns` or `sub.mydomain.sns` | Top-level domain or one-level subdomain |
|
|
91
|
+
| Subdomain creation and transfer | Canonical lowercase `sub.mydomain.sns` | One-level subdomain |
|
|
92
|
+
| Derivation and raw name-account helpers | TLD-trimmed or raw input, for example `mydomain` or `sub.mydomain` | Follow each low-level helper's account-format contract |
|
|
93
|
+
|
|
94
|
+
## API Reference
|
|
95
|
+
|
|
96
|
+
### Resolution
|
|
97
|
+
|
|
98
|
+
- **`resolve`** — resolves a full `.sns` domain through SNS-IP 5 or a full `.sol` domain through its canonical SRS record.
|
|
99
|
+
|
|
100
|
+
```ts
|
|
101
|
+
resolve({ rpc, domain, options? }): Promise<Address>
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
- **`safeResolve`** — follows `resolve`, and for `.sol` input always requires the SRS and corresponding SNS targets to match; otherwise, it throws `SnsSolResolutionMismatchError`.
|
|
105
|
+
|
|
106
|
+
```ts
|
|
107
|
+
safeResolve({ rpc, domain, options? }): Promise<Address>
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### Record Reads And Validation
|
|
111
|
+
|
|
112
|
+
- **`getDomainRecord`** — retrieves and verifies one V2 record.
|
|
113
|
+
|
|
114
|
+
```ts
|
|
115
|
+
getDomainRecord({ rpc, domain, record, options? }): Promise<RecordResult>
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
- **`getDomainRecords`** — returns one entry per requested record; a missing account is `undefined` at its corresponding index.
|
|
119
|
+
|
|
120
|
+
```ts
|
|
121
|
+
getDomainRecords({ rpc, domain, records, options? }): Promise<(RecordResult | undefined)[]>
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
The following standalone helpers do not come from `RecordResult`:
|
|
125
|
+
|
|
126
|
+
- **`getRecordV1Address`** / **`getRecordV2Address`** — derive account addresses from a TLD-trimmed domain without fetching them.
|
|
127
|
+
|
|
128
|
+
```ts
|
|
129
|
+
getRecordV1Address({ domain, record }): Promise<Address>
|
|
130
|
+
getRecordV2Address({ domain, record }): Promise<Address>
|
|
131
|
+
```
|
|
132
|
+
|
|
133
|
+
- **`serializeRecordContent`** / **`deserializeRecordContent`** — encode content for storage, or decode stored content.
|
|
134
|
+
|
|
135
|
+
```ts
|
|
136
|
+
serializeRecordContent({ content, record }): ReadonlyUint8Array
|
|
137
|
+
deserializeRecordContent({ content, record }): string
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
- **`verifyRecordStaleness`** — independently fetches and checks a V2 record's staleness validation.
|
|
141
|
+
|
|
142
|
+
```ts
|
|
143
|
+
verifyRecordStaleness({ rpc, domain, record }): Promise<boolean>
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
- **`verifyRecordRightOfAssociation`** — independently fetches and checks a V2 record's right-of-association validation.
|
|
147
|
+
|
|
148
|
+
```ts
|
|
149
|
+
verifyRecordRightOfAssociation(rpc, domain: string, record: Record, verifier?: ReadonlyUint8Array): Promise<boolean>
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
### Record Writes
|
|
153
|
+
|
|
154
|
+
Each function below returns one `Instruction`:
|
|
155
|
+
|
|
156
|
+
- **`createRecord`**
|
|
157
|
+
|
|
158
|
+
```ts
|
|
159
|
+
createRecord({ domain, record, content, owner, payer }): Promise<Instruction>
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
- **`updateRecord`**
|
|
163
|
+
|
|
164
|
+
```ts
|
|
165
|
+
updateRecord({ domain, record, content, owner, payer }): Promise<Instruction>
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
- **`deleteRecord`**
|
|
169
|
+
|
|
170
|
+
```ts
|
|
171
|
+
deleteRecord({ domain, record, owner, payer }): Promise<Instruction>
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
- **`setRecordStalenessVerifier`**
|
|
175
|
+
|
|
176
|
+
```ts
|
|
177
|
+
setRecordStalenessVerifier({ domain, record, owner, payer, verifier }): Promise<Instruction>
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
- **`setRecordRoaVerifier`**
|
|
181
|
+
|
|
182
|
+
```ts
|
|
183
|
+
setRecordRoaVerifier({ domain, record, owner, payer, verifier }): Promise<Instruction>
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
- **`validateRecordRoa`**
|
|
187
|
+
|
|
188
|
+
```ts
|
|
189
|
+
validateRecordRoa({ domain, record, owner, payer, verifier }): Promise<Instruction>
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
- **`validateRecordRoaEthereum`**
|
|
193
|
+
|
|
194
|
+
```ts
|
|
195
|
+
validateRecordRoaEthereum({ domain, record, owner, payer, signature, expectedPubkey }): Promise<Instruction>
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
### Registration And Lifecycle
|
|
199
|
+
|
|
200
|
+
Registration is limited to a lowercase top-level `.sns` name. Return shapes differ by operation:
|
|
201
|
+
|
|
202
|
+
- **`registerDomain`** — returns the registration instructions. It uses a supported payment mint/feed and only incorporates a referrer when it is supported by the SDK.
|
|
203
|
+
|
|
204
|
+
```ts
|
|
205
|
+
registerDomain({ domain, space, buyer, buyerTokenAccount, mint?, referrer? }): Promise<Instruction[]>
|
|
206
|
+
```
|
|
207
|
+
|
|
208
|
+
- **`registerDomainWithNft`** — returns one NFT-based registration instruction.
|
|
209
|
+
|
|
210
|
+
```ts
|
|
211
|
+
registerDomainWithNft({ domain, space, buyer, nftSource, nftMint }): Promise<Instruction>
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
- **`transferDomain`** — retrieves the current owner and returns one transfer instruction.
|
|
215
|
+
|
|
216
|
+
```ts
|
|
217
|
+
transferDomain({ rpc, domain, newOwner }): Promise<Instruction>
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
- **`burnDomain`** — returns one burn instruction; `refundAddress` receives reclaimed lamports.
|
|
221
|
+
|
|
222
|
+
```ts
|
|
223
|
+
burnDomain({ domain, owner, refundAddress }): Promise<Instruction>
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
- **`setPrimaryDomain`** — returns one instruction for an already derived domain account. `domainAddress` is an already derived domain account, not a domain string.
|
|
227
|
+
|
|
228
|
+
```ts
|
|
229
|
+
setPrimaryDomain({ rpc, domainAddress, owner }): Promise<Instruction>
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
### Subdomains
|
|
233
|
+
|
|
234
|
+
- **`getSubdomains`** — lists subdomains and owners under a top-level parent. Entries without reverse data are omitted.
|
|
235
|
+
|
|
236
|
+
```ts
|
|
237
|
+
getSubdomains({ rpc, domain }): Promise<{ subdomain: string; owner: Address }[]>
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
- **`createSubdomain`** — returns the name-account creation instruction(s). `subdomain` must be a lowercase one-level `.sns` subdomain.
|
|
241
|
+
|
|
242
|
+
```ts
|
|
243
|
+
createSubdomain({ rpc, subdomain, owner, space?, feePayer? }): Promise<Instruction[]>
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
- **`transferSubdomain`** — returns one transfer instruction. When `currentOwner` is omitted, the function retrieves the current owner; set `isParentOwnerSigner` when the parent owner authorizes the transfer.
|
|
247
|
+
|
|
248
|
+
```ts
|
|
249
|
+
transferSubdomain({ rpc, subdomain, newOwner, isParentOwnerSigner?, currentOwner? }): Promise<Instruction>
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
### Ownership And Reverse Lookup
|
|
253
|
+
|
|
254
|
+
- **`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.
|
|
255
|
+
|
|
256
|
+
```ts
|
|
257
|
+
getDomainOwner({ rpc, domain }): Promise<Address>
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
- **`getAllSnsDomains`** — lists top-level SNS registry accounts and their registry owners.
|
|
261
|
+
|
|
262
|
+
```ts
|
|
263
|
+
getAllSnsDomains({ rpc }): Promise<{ domainAddress: Address; owner: Address }[]>
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
- **`getAllSolDomains`** — lists all top-level SRS records, including expired records. The returned `owner` is the raw SRS owner field and may be a wallet address or Token-2022 mint.
|
|
267
|
+
|
|
268
|
+
```ts
|
|
269
|
+
getAllSolDomains({ rpc }): Promise<{ domainAddress: Address; owner: Address }[]>
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
- **`getPrimaryDomain`** — returns a primary-domain account, its TLD-less name, and whether the wallet is no longer its effective owner.
|
|
273
|
+
|
|
274
|
+
```ts
|
|
275
|
+
getPrimaryDomain({ rpc, walletAddress }): Promise<{ domainAddress: Address; domainName: string; stale: boolean }>
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
- **`getPrimaryDomainsBatch`** — returns valid, non-stale, TLD-less primary names positionally aligned with `walletAddresses`.
|
|
279
|
+
|
|
280
|
+
```ts
|
|
281
|
+
getPrimaryDomainsBatch({ rpc, walletAddresses }): Promise<(string | undefined)[]>
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
- **`getSnsDomainsForAddress`** — returns directly registry-owned top-level domains only. Tokenized domains and subdomains are excluded, and entries without reverse records are omitted.
|
|
285
|
+
|
|
286
|
+
```ts
|
|
287
|
+
getSnsDomainsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address }[]>
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
- **`getSnsNftsForAddress`** — returns tokenized SNS domains with reverse data.
|
|
291
|
+
|
|
292
|
+
```ts
|
|
293
|
+
getSnsNftsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address; mint: Address }[]>
|
|
294
|
+
```
|
|
295
|
+
|
|
296
|
+
- **`getSolDomainsForAddress`** — returns non-expired, directly wallet-owned `.sol` records. Tokenized records are excluded and returned names are TLD-trimmed.
|
|
297
|
+
|
|
298
|
+
```ts
|
|
299
|
+
getSolDomainsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address }[]>
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
- **`getSolNftsForAddress`** — returns non-expired Token-2022 tokenized `.sol` records held by an address. Results include the TLD-trimmed name, SRS record address, and mint.
|
|
303
|
+
|
|
304
|
+
```ts
|
|
305
|
+
getSolNftsForAddress({ rpc, address }): Promise<{ domain: string; domainAddress: Address; mint: Address }[]>
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
- **`reverseLookup`** — returns one TLD-less reverse name for a domain address.
|
|
309
|
+
|
|
310
|
+
```ts
|
|
311
|
+
reverseLookup({ rpc, domainAddress, parentAddress? }): Promise<string>
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
- **`reverseLookupBatch`** — returns TLD-less names in input order; missing reverse records are `undefined`.
|
|
315
|
+
|
|
316
|
+
```ts
|
|
317
|
+
reverseLookupBatch({ rpc, domainAddresses }): Promise<(string | undefined)[]>
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
### Advanced APIs
|
|
321
|
+
|
|
322
|
+
For account-level integrations, the root export also includes derivation and raw name-registry helpers such as `getSnsDomainAddress`, `getSolDomainAddress`, `getReverseAddress`, `getReverseAddressFromDomainAddress`, `checkAddressOnCurve`, `deserializeReverse`, `getPythFeedAddress`, `getTld`, `createNameRegistry`, `updateNameRegistry`, `deleteNameRegistry`, and `createReverse`.
|
|
323
|
+
|
|
324
|
+
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.
|
|
325
|
+
|
|
326
|
+
## Documentation And Migration
|
|
327
|
+
|
|
328
|
+
- [Developer documentation](https://dev.sns.id/)
|
|
329
|
+
- [Migration notes and changelog](./CHANGELOG.md)
|
|
330
|
+
- [SDK monorepo overview](../README.md)
|
|
331
|
+
- [SNS guide](https://guide.sns.id/)
|
|
332
|
+
|
|
333
|
+
## License
|
|
334
|
+
|
|
335
|
+
Released under the [MIT License](../LICENSE).
|