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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,322 +1,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
- [![npm](https://img.shields.io/npm/v/@solana-name-service/sns-sdk-kit)](https://www.npmjs.com/package/@solana-name-service/sns-sdk-kit)
8
- [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE)
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
+ <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
+ [![npm](https://img.shields.io/npm/v/@solana-name-service/sns-sdk-kit)](https://www.npmjs.com/package/@solana-name-service/sns-sdk-kit)
8
+ [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE)
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 +1 @@
1
- {"version":3,"file":"resolve.cjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\n\nimport { SOL_SRS_RESOLUTION_ENABLED } from \"../config\";\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\nimport { resolveSns } from \"./resolveSns\";\nimport { resolveSol } from \"./resolveSol\";\nimport { ResolveParams } from \"./resolveTypes\";\n\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\n\n/**\n * Resolves a `.sns` or `.sol` domain to its target address.\n *\n * @param params Resolution parameters\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\n * @returns The resolved target address.\n *\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and\n * corresponding SNS targets match when SRS-backed resolution is enabled.\n *\n * @example\n * ```ts\n * const address = await resolve({ rpc, domain: \"example.sns\" });\n * ```\n */\nexport const resolve = async ({\n rpc,\n domain,\n options = { allowPda: false },\n}: ResolveParams): Promise<Address> => {\n if (domain.endsWith(SOL_TLD)) {\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\n\n if (SOL_SRS_RESOLUTION_ENABLED) {\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\n }\n\n await assertTldSupported({ rpc, domain });\n return resolveSns({ rpc, domain: trimmedSolDomain, options });\n }\n\n const [trimmedDomain, tld] = parseSupportedTld(domain);\n if (tld === SNS_TLD) {\n return resolveSns({ rpc, domain: trimmedDomain, options });\n }\n\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\n};\n\n/**\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\n *\n * When SRS-backed `.sol` resolution is enabled, both the `.sol` domain and its\n * corresponding `.sns` domain must resolve to the same target; otherwise,\n * {@link Errors.SnsSolResolutionMismatchError} is thrown.\n *\n * @param params Resolution parameters\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\n * @throws\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\n * @example\n * ```ts\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\n * ```\n */\nexport const safeResolve = async ({\n rpc,\n domain,\n options = { allowPda: false },\n}: ResolveParams): Promise<Address> => {\n if (domain.endsWith(SOL_TLD) && SOL_SRS_RESOLUTION_ENABLED) {\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\n const [srsTarget, snsTarget] = await Promise.all([\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\n ]);\n\n if (srsTarget !== snsTarget) {\n throw new SnsSolResolutionMismatchError(\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\n );\n }\n\n return srsTarget;\n }\n\n return resolve({ rpc, domain, options });\n};\n"],"names":["SOL_TLD","assertTldSupported","resolveSns","tld","parseSupportedTld","SNS_TLD","UnsupportedTldError","SOL_SRS_RESOLUTION_ENABLED"],"mappings":";;;;;;;;;;AAYA;;;;;;;;;;;;;;;;AAgBG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAACA,WAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAACA,WAAO,CAAC,MAAM,CAAC;QAMzD,MAAMC,qCAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzC,QAAA,OAAOC,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;;IAG/D,MAAM,CAAC,aAAa,EAAEC,KAAG,CAAC,GAAGC,qBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAID,KAAG,KAAKE,WAAO,EAAE;AACnB,QAAA,OAAOH,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;;AAG5D,IAAA,MAAM,IAAII,0BAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;IACpC,IAAI,MAAM,CAAC,QAAQ,CAACN,WAAO,CAAC,IAAIO,iCAA0B,EAAE;IAgB5D,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;;;;"}
1
+ {"version":3,"file":"resolve.cjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport { SOL_SRS_RESOLUTION_ENABLED } from \"../config\";\r\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\r\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\r\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\r\nimport { resolveSns } from \"./resolveSns\";\r\nimport { resolveSol } from \"./resolveSol\";\r\nimport { ResolveParams } from \"./resolveTypes\";\r\n\r\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain to its target address.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The resolved target address.\r\n *\r\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and\r\n * corresponding SNS targets match when SRS-backed resolution is enabled.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await resolve({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const resolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n\r\n if (SOL_SRS_RESOLUTION_ENABLED) {\r\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n await assertTldSupported({ rpc, domain });\r\n return resolveSns({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n const [trimmedDomain, tld] = parseSupportedTld(domain);\r\n if (tld === SNS_TLD) {\r\n return resolveSns({ rpc, domain: trimmedDomain, options });\r\n }\r\n\r\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\r\n};\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\r\n *\r\n * When SRS-backed `.sol` resolution is enabled, both the `.sol` domain and its\r\n * corresponding `.sns` domain must resolve to the same target; otherwise,\r\n * {@link Errors.SnsSolResolutionMismatchError} is thrown.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\r\n * @throws\r\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\r\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\r\n * @example\r\n * ```ts\r\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\r\n * ```\r\n */\r\nexport const safeResolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD) && SOL_SRS_RESOLUTION_ENABLED) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n const [srsTarget, snsTarget] = await Promise.all([\r\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\r\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\r\n ]);\r\n\r\n if (srsTarget !== snsTarget) {\r\n throw new SnsSolResolutionMismatchError(\r\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\r\n );\r\n }\r\n\r\n return srsTarget;\r\n }\r\n\r\n return resolve({ rpc, domain, options });\r\n};\r\n"],"names":["SOL_TLD","assertTldSupported","resolveSns","tld","parseSupportedTld","SNS_TLD","UnsupportedTldError","SOL_SRS_RESOLUTION_ENABLED"],"mappings":";;;;;;;;;;AAYA;;;;;;;;;;;;;;;;AAgBG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAACA,WAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAACA,WAAO,CAAC,MAAM,CAAC;QAMzD,MAAMC,qCAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzC,QAAA,OAAOC,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;;IAG/D,MAAM,CAAC,aAAa,EAAEC,KAAG,CAAC,GAAGC,qBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAID,KAAG,KAAKE,WAAO,EAAE;AACnB,QAAA,OAAOH,qBAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;;AAG5D,IAAA,MAAM,IAAII,0BAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;IACpC,IAAI,MAAM,CAAC,QAAQ,CAACN,WAAO,CAAC,IAAIO,iCAA0B,EAAE;IAgB5D,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;;;;"}
@@ -1 +1 @@
1
- {"version":3,"file":"errors.cjs","sources":["../../src/errors.ts"],"sourcesContent":["/**\n * Error classes and stable error categories emitted by SDK operations.\n * @module Errors\n */\n/** Stable error codes emitted by SNS SDK operations. */\nexport enum ErrorType {\n InvalidSubdomain = \"InvalidSubdomain\",\n PrimaryDomainNotFound = \"PrimaryDomainNotFound\",\n NoRecordData = \"NoRecordData\",\n InvalidRecordData = \"InvalidRecordData\",\n InvalidEvmAddress = \"InvalidEvmAddress\",\n InvalidInjectiveAddress = \"InvalidInjectiveAddress\",\n InvalidARecord = \"InvalidARecord\",\n InvalidAAAARecord = \"InvalidAAAARecord\",\n InvalidRecordInput = \"InvalidRecordInput\",\n AccountDoesNotExist = \"AccountDoesNotExist\",\n NoAccountData = \"NoAccountData\",\n InvalidInput = \"InvalidInput\",\n InvalidDomain = \"InvalidDomain\",\n MissingVerifier = \"MissingVerifier\",\n PythFeedNotFound = \"PythFeedNotFound\",\n InvalidRoa = \"InvalidRoa\",\n InvalidParent = \"InvalidParent\",\n NftAccountNotFound = \"NftRecordNotFound\",\n PdaOwnerNotAllowed = \"PdaOwnerNotAllowed\",\n DomainDoesNotExist = \"DomainDoesNotExist\",\n RecordMalformed = \"RecordMalformed\",\n CouldNotFindNftOwner = \"CouldNotFindNftOwner\",\n InvalidValidation = \"InvalidValidation\",\n InvalidSerializedData = \"InvalidSerializedData\",\n UnsupportedTld = \"UnsupportedTld\",\n DomainExpired = \"DomainExpired\",\n CouldNotFindSrsOwner = \"CouldNotFindSrsOwner\",\n SnsSolResolutionMismatch = \"SnsSolResolutionMismatch\",\n}\n\n/** Base error thrown by SNS SDK operations. Inspect `type` for a stable error code. */\nexport class SNSError extends Error {\n type: ErrorType;\n\n constructor(type: ErrorType, message?: string) {\n super(message);\n this.name = \"SNSError\";\n this.type = type;\n\n if ((Error as any).captureStackTrace) {\n (Error as any).captureStackTrace(this, SNSError);\n }\n }\n}\n\n/** Thrown when a subdomain name is malformed or unsupported. */\nexport class InvalidSubdomainError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidSubdomain, message);\n }\n}\n\n/** Thrown when an address has no configured primary domain. */\nexport class PrimaryDomainNotFoundError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.PrimaryDomainNotFound, message);\n }\n}\n\n/** Thrown when a requested record account has no readable data. */\nexport class NoRecordDataError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.NoRecordData, message);\n }\n}\n\n/** Thrown when record content fails format validation. */\nexport class InvalidRecordDataError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidRecordData, message);\n }\n}\n\n/** Thrown when an EVM address is invalid for a record operation. */\nexport class InvalidEvmAddressError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidEvmAddress, message);\n }\n}\n\n/** Thrown when an Injective address is invalid for a record operation. */\nexport class InvalidInjectiveAddressError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidInjectiveAddress, message);\n }\n}\n\n/** Thrown when an IPv4 record value is invalid. */\nexport class InvalidARecordError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidARecord, message);\n }\n}\n\n/** Thrown when an IPv6 record value is invalid. */\nexport class InvalidAAAARecordError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidAAAARecord, message);\n }\n}\n\n/** Thrown when record creation or update input is incomplete or invalid. */\nexport class InvalidRecordInputError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidRecordInput, message);\n }\n}\n\n/** Thrown when a required on-chain account does not exist. */\nexport class AccountDoesNotExistError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.AccountDoesNotExist, message);\n }\n}\n\n/** Thrown when an existing account has no readable data. */\nexport class NoAccountDataError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.NoAccountData, message);\n }\n}\n\n/** Thrown when a general SDK input contract is not met. */\nexport class InvalidInputError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidInput, message);\n }\n}\n\n/** Thrown when a domain name is malformed or invalid. */\nexport class InvalidDomainError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidDomain, message);\n }\n}\n\n/** Thrown when required record verification data is missing. */\nexport class MissingVerifierError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.MissingVerifier, message);\n }\n}\n\n/** Thrown when no Pyth price feed is configured for a mint. */\nexport class PythFeedNotFoundError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.PythFeedNotFound, message);\n }\n}\n\n/** Thrown when a Right of Association proof is invalid. */\nexport class InvalidRoaError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidRoa, message);\n }\n}\n\n/** Thrown when a required parent domain account cannot be resolved. */\nexport class InvalidParentError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidParent, message);\n }\n}\n\n/** Thrown when an expected SNS NFT account cannot be found. */\nexport class NftAccountNotFoundError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.NftAccountNotFound, message);\n }\n}\n\n/** Thrown when a program-derived address is not an allowed owner. */\nexport class PdaOwnerNotAllowedError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.PdaOwnerNotAllowed, message);\n }\n}\n\n/** Thrown when a requested SNS domain account does not exist. */\nexport class DomainDoesNotExistError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.DomainDoesNotExist, message);\n }\n}\n\n/** Thrown when serialized record data cannot be decoded safely. */\nexport class RecordMalformedError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.RecordMalformed, message);\n }\n}\n\n/** Thrown when the owner of an SNS NFT cannot be determined. */\nexport class CouldNotFindNftOwnerError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.CouldNotFindNftOwner, message);\n }\n}\n\n/** Thrown when an unsupported record validation mode is encountered. */\nexport class InvalidValidationError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidValidation, message);\n }\n}\n\n/** Thrown when serialized account or record data is inconsistent. */\nexport class InvalidSerializedDataError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidSerializedData, message);\n }\n}\n\n/** Thrown when a domain does not use a supported top-level domain. */\nexport class UnsupportedTldError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.UnsupportedTld, message);\n }\n}\n\n/** Thrown when a Solana Registration Service domain has expired. */\nexport class DomainExpiredError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.DomainExpired, message);\n }\n}\n\n/** Thrown when a Solana Registration Service domain owner cannot be resolved. */\nexport class CouldNotFindSrsOwnerError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.CouldNotFindSrsOwner, message);\n }\n}\n\n/** Thrown when .sns and .sol resolve the same domain to different addresses. */\nexport class SnsSolResolutionMismatchError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.SnsSolResolutionMismatch, message);\n }\n}\n"],"names":["ErrorType"],"mappings":"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"}
1
+ {"version":3,"file":"errors.cjs","sources":["../../src/errors.ts"],"sourcesContent":["/**\r\n * Error classes and stable error categories emitted by SDK operations.\r\n * @module Errors\r\n */\r\n/** Stable error codes emitted by SNS SDK operations. */\r\nexport enum ErrorType {\r\n InvalidSubdomain = \"InvalidSubdomain\",\r\n PrimaryDomainNotFound = \"PrimaryDomainNotFound\",\r\n NoRecordData = \"NoRecordData\",\r\n InvalidRecordData = \"InvalidRecordData\",\r\n InvalidEvmAddress = \"InvalidEvmAddress\",\r\n InvalidInjectiveAddress = \"InvalidInjectiveAddress\",\r\n InvalidARecord = \"InvalidARecord\",\r\n InvalidAAAARecord = \"InvalidAAAARecord\",\r\n InvalidRecordInput = \"InvalidRecordInput\",\r\n AccountDoesNotExist = \"AccountDoesNotExist\",\r\n NoAccountData = \"NoAccountData\",\r\n InvalidInput = \"InvalidInput\",\r\n InvalidDomain = \"InvalidDomain\",\r\n MissingVerifier = \"MissingVerifier\",\r\n PythFeedNotFound = \"PythFeedNotFound\",\r\n InvalidRoa = \"InvalidRoa\",\r\n InvalidParent = \"InvalidParent\",\r\n NftAccountNotFound = \"NftRecordNotFound\",\r\n PdaOwnerNotAllowed = \"PdaOwnerNotAllowed\",\r\n DomainDoesNotExist = \"DomainDoesNotExist\",\r\n RecordMalformed = \"RecordMalformed\",\r\n CouldNotFindNftOwner = \"CouldNotFindNftOwner\",\r\n InvalidValidation = \"InvalidValidation\",\r\n InvalidSerializedData = \"InvalidSerializedData\",\r\n UnsupportedTld = \"UnsupportedTld\",\r\n DomainExpired = \"DomainExpired\",\r\n CouldNotFindSrsOwner = \"CouldNotFindSrsOwner\",\r\n SnsSolResolutionMismatch = \"SnsSolResolutionMismatch\",\r\n}\r\n\r\n/** Base error thrown by SNS SDK operations. Inspect `type` for a stable error code. */\r\nexport class SNSError extends Error {\r\n type: ErrorType;\r\n\r\n constructor(type: ErrorType, message?: string) {\r\n super(message);\r\n this.name = \"SNSError\";\r\n this.type = type;\r\n\r\n if ((Error as any).captureStackTrace) {\r\n (Error as any).captureStackTrace(this, SNSError);\r\n }\r\n }\r\n}\r\n\r\n/** Thrown when a subdomain name is malformed or unsupported. */\r\nexport class InvalidSubdomainError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidSubdomain, message);\r\n }\r\n}\r\n\r\n/** Thrown when an address has no configured primary domain. */\r\nexport class PrimaryDomainNotFoundError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.PrimaryDomainNotFound, message);\r\n }\r\n}\r\n\r\n/** Thrown when a requested record account has no readable data. */\r\nexport class NoRecordDataError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.NoRecordData, message);\r\n }\r\n}\r\n\r\n/** Thrown when record content fails format validation. */\r\nexport class InvalidRecordDataError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidRecordData, message);\r\n }\r\n}\r\n\r\n/** Thrown when an EVM address is invalid for a record operation. */\r\nexport class InvalidEvmAddressError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidEvmAddress, message);\r\n }\r\n}\r\n\r\n/** Thrown when an Injective address is invalid for a record operation. */\r\nexport class InvalidInjectiveAddressError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidInjectiveAddress, message);\r\n }\r\n}\r\n\r\n/** Thrown when an IPv4 record value is invalid. */\r\nexport class InvalidARecordError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidARecord, message);\r\n }\r\n}\r\n\r\n/** Thrown when an IPv6 record value is invalid. */\r\nexport class InvalidAAAARecordError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidAAAARecord, message);\r\n }\r\n}\r\n\r\n/** Thrown when record creation or update input is incomplete or invalid. */\r\nexport class InvalidRecordInputError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidRecordInput, message);\r\n }\r\n}\r\n\r\n/** Thrown when a required on-chain account does not exist. */\r\nexport class AccountDoesNotExistError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.AccountDoesNotExist, message);\r\n }\r\n}\r\n\r\n/** Thrown when an existing account has no readable data. */\r\nexport class NoAccountDataError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.NoAccountData, message);\r\n }\r\n}\r\n\r\n/** Thrown when a general SDK input contract is not met. */\r\nexport class InvalidInputError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidInput, message);\r\n }\r\n}\r\n\r\n/** Thrown when a domain name is malformed or invalid. */\r\nexport class InvalidDomainError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidDomain, message);\r\n }\r\n}\r\n\r\n/** Thrown when required record verification data is missing. */\r\nexport class MissingVerifierError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.MissingVerifier, message);\r\n }\r\n}\r\n\r\n/** Thrown when no Pyth price feed is configured for a mint. */\r\nexport class PythFeedNotFoundError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.PythFeedNotFound, message);\r\n }\r\n}\r\n\r\n/** Thrown when a Right of Association proof is invalid. */\r\nexport class InvalidRoaError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidRoa, message);\r\n }\r\n}\r\n\r\n/** Thrown when a required parent domain account cannot be resolved. */\r\nexport class InvalidParentError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidParent, message);\r\n }\r\n}\r\n\r\n/** Thrown when an expected SNS NFT account cannot be found. */\r\nexport class NftAccountNotFoundError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.NftAccountNotFound, message);\r\n }\r\n}\r\n\r\n/** Thrown when a program-derived address is not an allowed owner. */\r\nexport class PdaOwnerNotAllowedError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.PdaOwnerNotAllowed, message);\r\n }\r\n}\r\n\r\n/** Thrown when a requested SNS domain account does not exist. */\r\nexport class DomainDoesNotExistError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.DomainDoesNotExist, message);\r\n }\r\n}\r\n\r\n/** Thrown when serialized record data cannot be decoded safely. */\r\nexport class RecordMalformedError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.RecordMalformed, message);\r\n }\r\n}\r\n\r\n/** Thrown when the owner of an SNS NFT cannot be determined. */\r\nexport class CouldNotFindNftOwnerError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.CouldNotFindNftOwner, message);\r\n }\r\n}\r\n\r\n/** Thrown when an unsupported record validation mode is encountered. */\r\nexport class InvalidValidationError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidValidation, message);\r\n }\r\n}\r\n\r\n/** Thrown when serialized account or record data is inconsistent. */\r\nexport class InvalidSerializedDataError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidSerializedData, message);\r\n }\r\n}\r\n\r\n/** Thrown when a domain does not use a supported top-level domain. */\r\nexport class UnsupportedTldError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.UnsupportedTld, message);\r\n }\r\n}\r\n\r\n/** Thrown when a Solana Registration Service domain has expired. */\r\nexport class DomainExpiredError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.DomainExpired, message);\r\n }\r\n}\r\n\r\n/** Thrown when a Solana Registration Service domain owner cannot be resolved. */\r\nexport class CouldNotFindSrsOwnerError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.CouldNotFindSrsOwner, message);\r\n }\r\n}\r\n\r\n/** Thrown when .sns and .sol resolve the same domain to different addresses. */\r\nexport class SnsSolResolutionMismatchError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.SnsSolResolutionMismatch, message);\r\n }\r\n}\r\n"],"names":["ErrorType"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"resolve.mjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\n\nimport { SOL_SRS_RESOLUTION_ENABLED } from \"../config\";\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\nimport { resolveSns } from \"./resolveSns\";\nimport { resolveSol } from \"./resolveSol\";\nimport { ResolveParams } from \"./resolveTypes\";\n\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\n\n/**\n * Resolves a `.sns` or `.sol` domain to its target address.\n *\n * @param params Resolution parameters\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\n * @returns The resolved target address.\n *\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and\n * corresponding SNS targets match when SRS-backed resolution is enabled.\n *\n * @example\n * ```ts\n * const address = await resolve({ rpc, domain: \"example.sns\" });\n * ```\n */\nexport const resolve = async ({\n rpc,\n domain,\n options = { allowPda: false },\n}: ResolveParams): Promise<Address> => {\n if (domain.endsWith(SOL_TLD)) {\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\n\n if (SOL_SRS_RESOLUTION_ENABLED) {\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\n }\n\n await assertTldSupported({ rpc, domain });\n return resolveSns({ rpc, domain: trimmedSolDomain, options });\n }\n\n const [trimmedDomain, tld] = parseSupportedTld(domain);\n if (tld === SNS_TLD) {\n return resolveSns({ rpc, domain: trimmedDomain, options });\n }\n\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\n};\n\n/**\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\n *\n * When SRS-backed `.sol` resolution is enabled, both the `.sol` domain and its\n * corresponding `.sns` domain must resolve to the same target; otherwise,\n * {@link Errors.SnsSolResolutionMismatchError} is thrown.\n *\n * @param params Resolution parameters\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\n * @throws\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\n * @example\n * ```ts\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\n * ```\n */\nexport const safeResolve = async ({\n rpc,\n domain,\n options = { allowPda: false },\n}: ResolveParams): Promise<Address> => {\n if (domain.endsWith(SOL_TLD) && SOL_SRS_RESOLUTION_ENABLED) {\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\n const [srsTarget, snsTarget] = await Promise.all([\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\n ]);\n\n if (srsTarget !== snsTarget) {\n throw new SnsSolResolutionMismatchError(\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\n );\n }\n\n return srsTarget;\n }\n\n return resolve({ rpc, domain, options });\n};\n"],"names":[],"mappings":";;;;;;AAYA;;;;;;;;;;;;;;;;AAgBG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAMzD,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzC,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;;IAG/D,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAI,GAAG,KAAK,OAAO,EAAE;AACnB,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;;AAG5D,IAAA,MAAM,IAAI,mBAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;IACpC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,0BAA0B,EAAE;IAgB5D,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;;;"}
1
+ {"version":3,"file":"resolve.mjs","sources":["../../../src/domain/resolve.ts"],"sourcesContent":["import { Address } from \"@solana/kit\";\r\n\r\nimport { SOL_SRS_RESOLUTION_ENABLED } from \"../config\";\r\nimport { SnsSolResolutionMismatchError, UnsupportedTldError } from \"../errors\";\r\nimport { assertTldSupported } from \"../utils/assertTldSupported\";\r\nimport { SNS_TLD, SOL_TLD, parseSupportedTld } from \"../utils/tld\";\r\nimport { resolveSns } from \"./resolveSns\";\r\nimport { resolveSol } from \"./resolveSol\";\r\nimport { ResolveParams } from \"./resolveTypes\";\r\n\r\nexport type { ResolveOptions, ResolveParams } from \"./resolveTypes\";\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain to its target address.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The resolved target address.\r\n *\r\n * @see {@link safeResolve} for `.sol` resolution that verifies the SRS and\r\n * corresponding SNS targets match when SRS-backed resolution is enabled.\r\n *\r\n * @example\r\n * ```ts\r\n * const address = await resolve({ rpc, domain: \"example.sns\" });\r\n * ```\r\n */\r\nexport const resolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD)) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n\r\n if (SOL_SRS_RESOLUTION_ENABLED) {\r\n return resolveSol({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n await assertTldSupported({ rpc, domain });\r\n return resolveSns({ rpc, domain: trimmedSolDomain, options });\r\n }\r\n\r\n const [trimmedDomain, tld] = parseSupportedTld(domain);\r\n if (tld === SNS_TLD) {\r\n return resolveSns({ rpc, domain: trimmedDomain, options });\r\n }\r\n\r\n throw new UnsupportedTldError(`Domain \"${domain}\" has an unsupported TLD`);\r\n};\r\n\r\n/**\r\n * Resolves a `.sns` or `.sol` domain using the same routing as {@link resolve}.\r\n *\r\n * When SRS-backed `.sol` resolution is enabled, both the `.sol` domain and its\r\n * corresponding `.sns` domain must resolve to the same target; otherwise,\r\n * {@link Errors.SnsSolResolutionMismatchError} is thrown.\r\n *\r\n * @param params Resolution parameters\r\n * @param params.rpc RPC client implementing account, multiple-account, token-largest-account, and slot APIs\r\n * @param params.domain Full domain name including a `.sns` or `.sol` suffix\r\n * @param params.options Optional PDA owner resolution options. Defaults to `{ allowPda: false }`\r\n * @returns The matching SRS and SNS target when compared; otherwise the target returned by {@link resolve}\r\n * @throws\r\n * - {@link Errors.SnsSolResolutionMismatchError} when SRS and SNS resolve a `.sol` domain to different addresses.\r\n * - Any resolution error propagated by {@link resolve}, `resolveSol`, or `resolveSns`.\r\n * @example\r\n * ```ts\r\n * const address = await safeResolve({ rpc, domain: \"example.sol\" });\r\n * ```\r\n */\r\nexport const safeResolve = async ({\r\n rpc,\r\n domain,\r\n options = { allowPda: false },\r\n}: ResolveParams): Promise<Address> => {\r\n if (domain.endsWith(SOL_TLD) && SOL_SRS_RESOLUTION_ENABLED) {\r\n const trimmedSolDomain = domain.slice(0, -SOL_TLD.length);\r\n const [srsTarget, snsTarget] = await Promise.all([\r\n resolveSol({ rpc, domain: trimmedSolDomain, options }),\r\n resolveSns({ rpc, domain: trimmedSolDomain, options }),\r\n ]);\r\n\r\n if (srsTarget !== snsTarget) {\r\n throw new SnsSolResolutionMismatchError(\r\n `SRS resolved ${domain} to ${srsTarget}, but SNS resolved it to ${snsTarget}`\r\n );\r\n }\r\n\r\n return srsTarget;\r\n }\r\n\r\n return resolve({ rpc, domain, options });\r\n};\r\n"],"names":[],"mappings":";;;;;;AAYA;;;;;;;;;;;;;;;;AAgBG;MACU,OAAO,GAAG,OAAO,EAC5B,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;AACpC,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;AAC5B,QAAA,MAAM,gBAAgB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;QAMzD,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACzC,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC;;IAG/D,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,iBAAiB,CAAC,MAAM,CAAC;AACtD,IAAA,IAAI,GAAG,KAAK,OAAO,EAAE;AACnB,QAAA,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;;AAG5D,IAAA,MAAM,IAAI,mBAAmB,CAAC,WAAW,MAAM,CAAA,wBAAA,CAA0B,CAAC;AAC5E;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,GAAG,OAAO,EAChC,GAAG,EACH,MAAM,EACN,OAAO,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GACf,KAAsB;IACpC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,0BAA0B,EAAE;IAgB5D,OAAO,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C;;;;"}
@@ -1 +1 @@
1
- {"version":3,"file":"errors.mjs","sources":["../../src/errors.ts"],"sourcesContent":["/**\n * Error classes and stable error categories emitted by SDK operations.\n * @module Errors\n */\n/** Stable error codes emitted by SNS SDK operations. */\nexport enum ErrorType {\n InvalidSubdomain = \"InvalidSubdomain\",\n PrimaryDomainNotFound = \"PrimaryDomainNotFound\",\n NoRecordData = \"NoRecordData\",\n InvalidRecordData = \"InvalidRecordData\",\n InvalidEvmAddress = \"InvalidEvmAddress\",\n InvalidInjectiveAddress = \"InvalidInjectiveAddress\",\n InvalidARecord = \"InvalidARecord\",\n InvalidAAAARecord = \"InvalidAAAARecord\",\n InvalidRecordInput = \"InvalidRecordInput\",\n AccountDoesNotExist = \"AccountDoesNotExist\",\n NoAccountData = \"NoAccountData\",\n InvalidInput = \"InvalidInput\",\n InvalidDomain = \"InvalidDomain\",\n MissingVerifier = \"MissingVerifier\",\n PythFeedNotFound = \"PythFeedNotFound\",\n InvalidRoa = \"InvalidRoa\",\n InvalidParent = \"InvalidParent\",\n NftAccountNotFound = \"NftRecordNotFound\",\n PdaOwnerNotAllowed = \"PdaOwnerNotAllowed\",\n DomainDoesNotExist = \"DomainDoesNotExist\",\n RecordMalformed = \"RecordMalformed\",\n CouldNotFindNftOwner = \"CouldNotFindNftOwner\",\n InvalidValidation = \"InvalidValidation\",\n InvalidSerializedData = \"InvalidSerializedData\",\n UnsupportedTld = \"UnsupportedTld\",\n DomainExpired = \"DomainExpired\",\n CouldNotFindSrsOwner = \"CouldNotFindSrsOwner\",\n SnsSolResolutionMismatch = \"SnsSolResolutionMismatch\",\n}\n\n/** Base error thrown by SNS SDK operations. Inspect `type` for a stable error code. */\nexport class SNSError extends Error {\n type: ErrorType;\n\n constructor(type: ErrorType, message?: string) {\n super(message);\n this.name = \"SNSError\";\n this.type = type;\n\n if ((Error as any).captureStackTrace) {\n (Error as any).captureStackTrace(this, SNSError);\n }\n }\n}\n\n/** Thrown when a subdomain name is malformed or unsupported. */\nexport class InvalidSubdomainError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidSubdomain, message);\n }\n}\n\n/** Thrown when an address has no configured primary domain. */\nexport class PrimaryDomainNotFoundError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.PrimaryDomainNotFound, message);\n }\n}\n\n/** Thrown when a requested record account has no readable data. */\nexport class NoRecordDataError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.NoRecordData, message);\n }\n}\n\n/** Thrown when record content fails format validation. */\nexport class InvalidRecordDataError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidRecordData, message);\n }\n}\n\n/** Thrown when an EVM address is invalid for a record operation. */\nexport class InvalidEvmAddressError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidEvmAddress, message);\n }\n}\n\n/** Thrown when an Injective address is invalid for a record operation. */\nexport class InvalidInjectiveAddressError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidInjectiveAddress, message);\n }\n}\n\n/** Thrown when an IPv4 record value is invalid. */\nexport class InvalidARecordError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidARecord, message);\n }\n}\n\n/** Thrown when an IPv6 record value is invalid. */\nexport class InvalidAAAARecordError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidAAAARecord, message);\n }\n}\n\n/** Thrown when record creation or update input is incomplete or invalid. */\nexport class InvalidRecordInputError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidRecordInput, message);\n }\n}\n\n/** Thrown when a required on-chain account does not exist. */\nexport class AccountDoesNotExistError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.AccountDoesNotExist, message);\n }\n}\n\n/** Thrown when an existing account has no readable data. */\nexport class NoAccountDataError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.NoAccountData, message);\n }\n}\n\n/** Thrown when a general SDK input contract is not met. */\nexport class InvalidInputError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidInput, message);\n }\n}\n\n/** Thrown when a domain name is malformed or invalid. */\nexport class InvalidDomainError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidDomain, message);\n }\n}\n\n/** Thrown when required record verification data is missing. */\nexport class MissingVerifierError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.MissingVerifier, message);\n }\n}\n\n/** Thrown when no Pyth price feed is configured for a mint. */\nexport class PythFeedNotFoundError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.PythFeedNotFound, message);\n }\n}\n\n/** Thrown when a Right of Association proof is invalid. */\nexport class InvalidRoaError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidRoa, message);\n }\n}\n\n/** Thrown when a required parent domain account cannot be resolved. */\nexport class InvalidParentError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidParent, message);\n }\n}\n\n/** Thrown when an expected SNS NFT account cannot be found. */\nexport class NftAccountNotFoundError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.NftAccountNotFound, message);\n }\n}\n\n/** Thrown when a program-derived address is not an allowed owner. */\nexport class PdaOwnerNotAllowedError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.PdaOwnerNotAllowed, message);\n }\n}\n\n/** Thrown when a requested SNS domain account does not exist. */\nexport class DomainDoesNotExistError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.DomainDoesNotExist, message);\n }\n}\n\n/** Thrown when serialized record data cannot be decoded safely. */\nexport class RecordMalformedError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.RecordMalformed, message);\n }\n}\n\n/** Thrown when the owner of an SNS NFT cannot be determined. */\nexport class CouldNotFindNftOwnerError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.CouldNotFindNftOwner, message);\n }\n}\n\n/** Thrown when an unsupported record validation mode is encountered. */\nexport class InvalidValidationError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidValidation, message);\n }\n}\n\n/** Thrown when serialized account or record data is inconsistent. */\nexport class InvalidSerializedDataError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.InvalidSerializedData, message);\n }\n}\n\n/** Thrown when a domain does not use a supported top-level domain. */\nexport class UnsupportedTldError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.UnsupportedTld, message);\n }\n}\n\n/** Thrown when a Solana Registration Service domain has expired. */\nexport class DomainExpiredError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.DomainExpired, message);\n }\n}\n\n/** Thrown when a Solana Registration Service domain owner cannot be resolved. */\nexport class CouldNotFindSrsOwnerError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.CouldNotFindSrsOwner, message);\n }\n}\n\n/** Thrown when .sns and .sol resolve the same domain to different addresses. */\nexport class SnsSolResolutionMismatchError extends SNSError {\n constructor(message?: string) {\n super(ErrorType.SnsSolResolutionMismatch, message);\n }\n}\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"errors.mjs","sources":["../../src/errors.ts"],"sourcesContent":["/**\r\n * Error classes and stable error categories emitted by SDK operations.\r\n * @module Errors\r\n */\r\n/** Stable error codes emitted by SNS SDK operations. */\r\nexport enum ErrorType {\r\n InvalidSubdomain = \"InvalidSubdomain\",\r\n PrimaryDomainNotFound = \"PrimaryDomainNotFound\",\r\n NoRecordData = \"NoRecordData\",\r\n InvalidRecordData = \"InvalidRecordData\",\r\n InvalidEvmAddress = \"InvalidEvmAddress\",\r\n InvalidInjectiveAddress = \"InvalidInjectiveAddress\",\r\n InvalidARecord = \"InvalidARecord\",\r\n InvalidAAAARecord = \"InvalidAAAARecord\",\r\n InvalidRecordInput = \"InvalidRecordInput\",\r\n AccountDoesNotExist = \"AccountDoesNotExist\",\r\n NoAccountData = \"NoAccountData\",\r\n InvalidInput = \"InvalidInput\",\r\n InvalidDomain = \"InvalidDomain\",\r\n MissingVerifier = \"MissingVerifier\",\r\n PythFeedNotFound = \"PythFeedNotFound\",\r\n InvalidRoa = \"InvalidRoa\",\r\n InvalidParent = \"InvalidParent\",\r\n NftAccountNotFound = \"NftRecordNotFound\",\r\n PdaOwnerNotAllowed = \"PdaOwnerNotAllowed\",\r\n DomainDoesNotExist = \"DomainDoesNotExist\",\r\n RecordMalformed = \"RecordMalformed\",\r\n CouldNotFindNftOwner = \"CouldNotFindNftOwner\",\r\n InvalidValidation = \"InvalidValidation\",\r\n InvalidSerializedData = \"InvalidSerializedData\",\r\n UnsupportedTld = \"UnsupportedTld\",\r\n DomainExpired = \"DomainExpired\",\r\n CouldNotFindSrsOwner = \"CouldNotFindSrsOwner\",\r\n SnsSolResolutionMismatch = \"SnsSolResolutionMismatch\",\r\n}\r\n\r\n/** Base error thrown by SNS SDK operations. Inspect `type` for a stable error code. */\r\nexport class SNSError extends Error {\r\n type: ErrorType;\r\n\r\n constructor(type: ErrorType, message?: string) {\r\n super(message);\r\n this.name = \"SNSError\";\r\n this.type = type;\r\n\r\n if ((Error as any).captureStackTrace) {\r\n (Error as any).captureStackTrace(this, SNSError);\r\n }\r\n }\r\n}\r\n\r\n/** Thrown when a subdomain name is malformed or unsupported. */\r\nexport class InvalidSubdomainError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidSubdomain, message);\r\n }\r\n}\r\n\r\n/** Thrown when an address has no configured primary domain. */\r\nexport class PrimaryDomainNotFoundError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.PrimaryDomainNotFound, message);\r\n }\r\n}\r\n\r\n/** Thrown when a requested record account has no readable data. */\r\nexport class NoRecordDataError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.NoRecordData, message);\r\n }\r\n}\r\n\r\n/** Thrown when record content fails format validation. */\r\nexport class InvalidRecordDataError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidRecordData, message);\r\n }\r\n}\r\n\r\n/** Thrown when an EVM address is invalid for a record operation. */\r\nexport class InvalidEvmAddressError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidEvmAddress, message);\r\n }\r\n}\r\n\r\n/** Thrown when an Injective address is invalid for a record operation. */\r\nexport class InvalidInjectiveAddressError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidInjectiveAddress, message);\r\n }\r\n}\r\n\r\n/** Thrown when an IPv4 record value is invalid. */\r\nexport class InvalidARecordError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidARecord, message);\r\n }\r\n}\r\n\r\n/** Thrown when an IPv6 record value is invalid. */\r\nexport class InvalidAAAARecordError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidAAAARecord, message);\r\n }\r\n}\r\n\r\n/** Thrown when record creation or update input is incomplete or invalid. */\r\nexport class InvalidRecordInputError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidRecordInput, message);\r\n }\r\n}\r\n\r\n/** Thrown when a required on-chain account does not exist. */\r\nexport class AccountDoesNotExistError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.AccountDoesNotExist, message);\r\n }\r\n}\r\n\r\n/** Thrown when an existing account has no readable data. */\r\nexport class NoAccountDataError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.NoAccountData, message);\r\n }\r\n}\r\n\r\n/** Thrown when a general SDK input contract is not met. */\r\nexport class InvalidInputError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidInput, message);\r\n }\r\n}\r\n\r\n/** Thrown when a domain name is malformed or invalid. */\r\nexport class InvalidDomainError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidDomain, message);\r\n }\r\n}\r\n\r\n/** Thrown when required record verification data is missing. */\r\nexport class MissingVerifierError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.MissingVerifier, message);\r\n }\r\n}\r\n\r\n/** Thrown when no Pyth price feed is configured for a mint. */\r\nexport class PythFeedNotFoundError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.PythFeedNotFound, message);\r\n }\r\n}\r\n\r\n/** Thrown when a Right of Association proof is invalid. */\r\nexport class InvalidRoaError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidRoa, message);\r\n }\r\n}\r\n\r\n/** Thrown when a required parent domain account cannot be resolved. */\r\nexport class InvalidParentError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidParent, message);\r\n }\r\n}\r\n\r\n/** Thrown when an expected SNS NFT account cannot be found. */\r\nexport class NftAccountNotFoundError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.NftAccountNotFound, message);\r\n }\r\n}\r\n\r\n/** Thrown when a program-derived address is not an allowed owner. */\r\nexport class PdaOwnerNotAllowedError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.PdaOwnerNotAllowed, message);\r\n }\r\n}\r\n\r\n/** Thrown when a requested SNS domain account does not exist. */\r\nexport class DomainDoesNotExistError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.DomainDoesNotExist, message);\r\n }\r\n}\r\n\r\n/** Thrown when serialized record data cannot be decoded safely. */\r\nexport class RecordMalformedError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.RecordMalformed, message);\r\n }\r\n}\r\n\r\n/** Thrown when the owner of an SNS NFT cannot be determined. */\r\nexport class CouldNotFindNftOwnerError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.CouldNotFindNftOwner, message);\r\n }\r\n}\r\n\r\n/** Thrown when an unsupported record validation mode is encountered. */\r\nexport class InvalidValidationError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidValidation, message);\r\n }\r\n}\r\n\r\n/** Thrown when serialized account or record data is inconsistent. */\r\nexport class InvalidSerializedDataError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.InvalidSerializedData, message);\r\n }\r\n}\r\n\r\n/** Thrown when a domain does not use a supported top-level domain. */\r\nexport class UnsupportedTldError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.UnsupportedTld, message);\r\n }\r\n}\r\n\r\n/** Thrown when a Solana Registration Service domain has expired. */\r\nexport class DomainExpiredError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.DomainExpired, message);\r\n }\r\n}\r\n\r\n/** Thrown when a Solana Registration Service domain owner cannot be resolved. */\r\nexport class CouldNotFindSrsOwnerError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.CouldNotFindSrsOwner, message);\r\n }\r\n}\r\n\r\n/** Thrown when .sns and .sol resolve the same domain to different addresses. */\r\nexport class SnsSolResolutionMismatchError extends SNSError {\r\n constructor(message?: string) {\r\n super(ErrorType.SnsSolResolutionMismatch, message);\r\n }\r\n}\r\n"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@solana-name-service/sns-sdk-kit",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "license": "MIT",
5
5
  "files": [
6
6
  "dist"