ens-budget 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Namepass LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,237 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# ens-budget
+
+**Renew ENS names by budget.**
+
+Give it a label and a stablecoin amount. It returns the longest renewal that amount buys under ENS v2 pricing, checked against ENS's own quote, and can send the renewal for you.
+
+[![npm](https://img.shields.io/npm/v/ens-budget?style=flat-square&color=0080BC)](https://www.npmjs.com/package/ens-budget)
+[![CI](https://img.shields.io/github/actions/workflow/status/wildcardlabs/ens-budget/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/wildcardlabs/ens-budget/actions/workflows/ci.yml)
+[![min+gzip](https://img.shields.io/bundlephobia/minzip/ens-budget?style=flat-square&label=min%2Bgzip)](https://bundlephobia.com/package/ens-budget)
+[![types](https://img.shields.io/npm/types/ens-budget?style=flat-square)](https://www.npmjs.com/package/ens-budget)
+[![viem](https://img.shields.io/npm/dependency-version/ens-budget/peer/viem?style=flat-square)](https://viem.sh)
+[![license](https://img.shields.io/npm/l/ens-budget?style=flat-square)](./LICENSE)
+
+[Install](#install) · [Quick start](#quick-start) · [How it works](#how-it-works) · [Recipes](#recipes) · [API](#api) · [Networks](#networks)
+
+</div>
+
+---
+
+## Features
+
+- **Exact.** Prices match ENS's `getRenewPrice` to the smallest token unit, including multi-year discounts.
+- **Optimal.** Returns the longest affordable term even where a longer term is cheaper.
+- **Complete.** Picks the right renewer, handles the token approval, and sends the renewal.
+- **Composable.** Returns plain calls for EIP-5792 batching, smart accounts and relayers.
+- **Small.** About 3 kB min+gzip. viem is the only dependency, as a peer.
+
+## Install
+
+```sh
+npm install ens-budget viem
+```
+
+## Quick start
+
+```ts
+import { createPublicClient, http } from 'viem'
+import { mainnet } from 'viem/chains'
+import { addresses, quoteRenewal } from 'ens-budget'
+
+const client = createPublicClient({ chain: mainnet, transport: http() })
+
+const quote = await quoteRenewal(client, {
+  label: 'namepass',            // namepass.eth
+  budget: 25_000000n,           // $25 in USDC (6 decimals)
+  token: addresses[1].usdc,
+})
+
+quote.duration  // 143345079n seconds, about 4 years 6 months
+quote.amount    // 25000000n, the exact cost
+quote.tier      // { duration: 94608000n, discountBps: 3125 }      3-year rate, 31.25% off
+quote.nextTier  // { duration: 189216000n, extraAmount: 2000071n, … }  6 years for $2.00 more
+```
+
+To renew, pass a wallet client:
+
+```ts
+import { renewWithBudget } from 'ens-budget'
+
+const { hash, quote } = await renewWithBudget(walletClient, {
+  label: 'namepass',
+  budget: 25_000000n,
+  token: addresses[1].usdc,
+})
+```
+
+## How it works
+
+ENS v2 prices renewals in USD per second, by label length, and discounts the whole term once it passes 2, 3 or 6 years. Because the discount applies to every second of the term, price is not monotonic in duration:
+
+| `namepass.eth` | Price |
+| --- | --- |
+| 1 year | $8.00 |
+| 5 years | $27.50 |
+| 6 years | **$27.00** |
+
+Dividing a budget by an annual rate gets this wrong. `quoteRenewal` instead:
+
+1. Asks both ENS renewers `isRenewable(label)` and uses the one that says yes.
+2. Reads the live rates, discount tiers and token exchange rate from the renewer's price oracle.
+3. Solves for the longest duration whose exact price fits the budget, trying discount tiers from best to worst.
+4. Confirms with `getRenewPrice` that ENS charges exactly the solved amount, and more than the budget for one second longer.
+
+### Approvals
+
+Renewals are paid in an ERC-20 token, so the renewer needs an allowance. `renewWithBudget` checks the current allowance and, only if it is short, approves **exactly** `quote.amount` and waits for confirmation before renewing. It never approves an unlimited amount or the full budget, so a price change between quote and send makes the renewal revert instead of overspending.
+
+## Recipes
+
+<details>
+<summary><b>Batch approve and renew into one prompt (EIP-5792)</b></summary>
+
+```ts
+import { prepareRenewal, quoteRenewal } from 'ens-budget'
+
+const quote = await quoteRenewal(client, { label, budget, token })
+const calls = await prepareRenewal(client, quote, { account: wallet.account.address })
+// [approve, renew], or [renew] when the allowance already covers it
+
+await wallet.sendCalls({ calls })
+```
+
+The same `{ to, data }` calls work with Safe transactions, bundlers and relayers.
+
+</details>
+
+<details>
+<summary><b>Run on a server</b></summary>
+
+```ts
+import { createWalletClient, http, nonceManager, publicActions } from 'viem'
+import { privateKeyToAccount } from 'viem/accounts'
+
+const account = privateKeyToAccount(process.env.PRIVATE_KEY, { nonceManager })
+const wallet = createWalletClient({ account, chain: mainnet, transport: http(RPC_URL) }).extend(publicActions)
+
+await renewWithBudget(wallet, { label, budget, token })
+```
+
+Exact approvals mean one `approve` transaction per renewal. For frequent renewals, set a standing allowance on the renewer yourself; `prepareRenewal` skips the approval whenever the allowance covers the price.
+
+</details>
+
+<details>
+<summary><b>Price locally for live UIs</b></summary>
+
+Read pricing once, then solve without network calls, for example on every slider move:
+
+```ts
+import { getPricing, priceOf, solve } from 'ens-budget'
+
+const pricing = await getPricing(client, { token })
+
+solve(pricing, { label: 'namepass', budget: 25_000000n })   // { duration, amount, tier, nextTier }
+priceOf(pricing, { label: 'namepass', duration: 31536000n }) // 8000021n
+```
+
+</details>
+
+<details>
+<summary><b>Normalize user input</b></summary>
+
+Labels are used exactly as given, as in ensjs, so non-normalized legacy names stay renewable. Normalize anything a user types:
+
+```ts
+import { normalize } from 'viem/ens'
+
+const label = normalize(input).replace(/\.eth$/, '')
+```
+
+Length is counted in Unicode code points of the label you pass, as ENS counts it. `❤️❤️❤️` with variation selectors is 6 code points and priced as a 5+ character name; `❤❤❤` is 3.
+
+</details>
+
+## API
+
+### Network
+
+| Function | Returns |
+| --- | --- |
+| `quoteRenewal(client, { label, budget, token, renewers? })` | `Quote`: the longest renewal for the budget, confirmed with ENS. |
+| `renewWithBudget(walletClient, { label, budget, token, referrer?, renewers? })` | `{ hash, quote }` after approving if needed and renewing. |
+| `prepareRenewal(client, quote, { account, referrer? })` | `Call[]`: `[approve?, renew]` as `{ to, data }`. |
+| `getPricing(client, { token, renewer?, renewers? })` | `Pricing`: oracle rates, discount tiers and token ratio. |
+| `getRenewer(client, { label, renewers? })` | The renewer address for a label, or `null`. |
+
+### Pure
+
+| Function | Returns |
+| --- | --- |
+| `solve(pricing, { label, budget })` | `{ duration, amount, tier, nextTier }` |
+| `priceOf(pricing, { label, duration })` | Exact cost in token units. |
+
+All amounts are `bigint` in the token's smallest unit. All durations are `bigint` seconds.
+
+<details>
+<summary><b>Types</b></summary>
+
+```ts
+type Quote = {
+  label: string
+  renewer: Address        // ETHRegistrar or ETHRenewerV1
+  token: Address
+  oracle: Address
+  budget: bigint
+  duration: bigint
+  amount: bigint          // <= budget
+  tier: Tier | null       // null at full price
+  nextTier: NextTier | null
+}
+
+type Tier = { duration: bigint; discountBps: number }
+
+type NextTier = Tier & {
+  amount: bigint          // cost of nextTier.duration
+  extraAmount: bigint     // amount - budget
+  extraDuration: bigint   // extra time gained by paying amount
+}
+```
+
+</details>
+
+### Errors
+
+All errors extend `EnsBudgetError`.
+
+| Error | Thrown when |
+| --- | --- |
+| `InvalidLabelError` | The label is empty, over 255 bytes, or a length ENS does not sell. |
+| `NotRenewableError` | Neither renewer will renew the label (unregistered or past grace). |
+| `UnsupportedTokenError` | The price oracle does not accept the token. |
+| `UnsupportedChainError` | No built-in addresses for the chain and no `renewers` given. |
+| `BudgetTooLowError` | The budget buys less than the minimum renewal. |
+| `QuoteMismatchError` | The local price disagrees with ENS's quote. The renewal is not sent. |
+
+## Networks
+
+| Network | ETHRegistrar (v2 names) | ETHRenewerV1 (unmigrated v1 names) | Tokens |
+| --- | --- | --- | --- |
+| Mainnet | `0xD6D8369e55c94Ae8AFA714E6cF7AB5bE54D5CC81` | `0x56c447F308F463A01121C41E72b0E7e7557fCb68` | USDC, DAI |
+| Sepolia | `0xf633e7FC17e2bbE0D0965D18ec1821dcB754a3d3` | `0xf2ece44980778966b8a0FccB3A9E339440f6e045` | USDC, DAI |
+
+Token addresses are exported as `addresses[chainId].usdc` and `.dai`. For forks or other deployments, pass `renewers: { ethRegistrar, ethRenewerV1 }`. The price oracle is always read from the renewer, never hardcoded.
+
+## Development
+
+```sh
+npm test            # unit tests, including a brute-force optimality check
+npm run test:live   # read-only checks against mainnet (MAINNET_RPC_URL optional)
+npm run test:fork   # real renewals on an anvil mainnet fork; requires Foundry
+```
+
+## License
+
+[MIT](./LICENSE) © Namepass LLC

package/dist/abi.d.ts

@@ -0,0 +1,158 @@
+/**
+ * ABI fragments, inlined so the package carries only what it calls.
+ *
+ * `ETHRegistrar` (v2 names) and `ETHRenewerV1` (unmigrated v1 names) both
+ * implement `IETHRenewer`, so one fragment drives either.
+ */
+export declare const renewerAbi: readonly [{
+    readonly type: "function";
+    readonly name: "renew";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "rd";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "label";
+            readonly type: "string";
+        }, {
+            readonly name: "duration";
+            readonly type: "uint64";
+        }, {
+            readonly name: "referrer";
+            readonly type: "bytes32";
+        }];
+    }, {
+        readonly name: "paymentToken";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "isRenewable";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "label";
+        readonly type: "string";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getRenewPrice";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "label";
+        readonly type: "string";
+    }, {
+        readonly name: "duration";
+        readonly type: "uint64";
+    }, {
+        readonly name: "paymentToken";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "rentPriceOracle";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "MIN_RENEW_DURATION";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint64";
+    }];
+}];
+export declare const oracleAbi: readonly [{
+    readonly type: "function";
+    readonly name: "DISCOUNT_DENOMINATOR";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint128";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getBaseRates";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256[]";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getDiscountPoints";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "tuple[]";
+        readonly components: readonly [{
+            readonly name: "duration";
+            readonly type: "uint64";
+        }, {
+            readonly name: "numer";
+            readonly type: "uint128";
+        }];
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "getPaymentTokenRatio";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "paymentToken";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "numer";
+        readonly type: "uint128";
+    }, {
+        readonly name: "denom";
+        readonly type: "uint128";
+    }];
+}];
+export declare const erc20Abi: readonly [{
+    readonly type: "function";
+    readonly name: "allowance";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "owner";
+        readonly type: "address";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "uint256";
+    }];
+}, {
+    readonly type: "function";
+    readonly name: "approve";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}];

package/dist/abi.js

@@ -0,0 +1,123 @@
+/**
+ * ABI fragments, inlined so the package carries only what it calls.
+ *
+ * `ETHRegistrar` (v2 names) and `ETHRenewerV1` (unmigrated v1 names) both
+ * implement `IETHRenewer`, so one fragment drives either.
+ */
+export const renewerAbi = [
+    {
+        type: 'function',
+        name: 'renew',
+        stateMutability: 'nonpayable',
+        inputs: [
+            {
+                name: 'rd',
+                type: 'tuple',
+                components: [
+                    { name: 'label', type: 'string' },
+                    { name: 'duration', type: 'uint64' },
+                    { name: 'referrer', type: 'bytes32' },
+                ],
+            },
+            { name: 'paymentToken', type: 'address' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'isRenewable',
+        stateMutability: 'view',
+        inputs: [{ name: 'label', type: 'string' }],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+    {
+        type: 'function',
+        name: 'getRenewPrice',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'label', type: 'string' },
+            { name: 'duration', type: 'uint64' },
+            { name: 'paymentToken', type: 'address' },
+        ],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+    {
+        type: 'function',
+        name: 'rentPriceOracle',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'address' }],
+    },
+    {
+        type: 'function',
+        name: 'MIN_RENEW_DURATION',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint64' }],
+    },
+];
+export const oracleAbi = [
+    {
+        type: 'function',
+        name: 'DISCOUNT_DENOMINATOR',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint128' }],
+    },
+    {
+        type: 'function',
+        name: 'getBaseRates',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [{ name: '', type: 'uint256[]' }],
+    },
+    {
+        type: 'function',
+        name: 'getDiscountPoints',
+        stateMutability: 'view',
+        inputs: [],
+        outputs: [
+            {
+                name: '',
+                type: 'tuple[]',
+                components: [
+                    { name: 'duration', type: 'uint64' },
+                    { name: 'numer', type: 'uint128' },
+                ],
+            },
+        ],
+    },
+    {
+        type: 'function',
+        name: 'getPaymentTokenRatio',
+        stateMutability: 'view',
+        inputs: [{ name: 'paymentToken', type: 'address' }],
+        outputs: [
+            { name: 'numer', type: 'uint128' },
+            { name: 'denom', type: 'uint128' },
+        ],
+    },
+];
+export const erc20Abi = [
+    {
+        type: 'function',
+        name: 'allowance',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'owner', type: 'address' },
+            { name: 'spender', type: 'address' },
+        ],
+        outputs: [{ name: '', type: 'uint256' }],
+    },
+    {
+        type: 'function',
+        name: 'approve',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'spender', type: 'address' },
+            { name: 'amount', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+];
+//# sourceMappingURL=abi.js.map

package/dist/abi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abi.js","sourceRoot":"","sources":["../src/abi.ts"],"names":[],"mappings":"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"}

package/dist/addresses.d.ts

@@ -0,0 +1,30 @@
+import type { Address } from 'viem';
+export type Renewers = {
+    /** v2 `ETHRegistrar`: renews names registered on, or migrated to, v2. */
+    ethRegistrar: Address;
+    /** `ETHRenewerV1`: renews unmigrated legacy (v1) names. */
+    ethRenewerV1: Address;
+};
+/**
+ * Deployed ENS v2 renewers and the stablecoins ENS prices, per chain.
+ *
+ * Sourced from `@ensdomains/ensjs` and checked on-chain: both renewers expose
+ * `renew((string,uint64,bytes32),address)` and neither is an upgradeable
+ * proxy. The rent price oracle is *not* listed here; renewers can point at a
+ * new one, so it is read from `rentPriceOracle()` every time.
+ */
+export declare const addresses: {
+    readonly 1: {
+        readonly ethRegistrar: "0xD6D8369e55c94Ae8AFA714E6cF7AB5bE54D5CC81";
+        readonly ethRenewerV1: "0x56c447F308F463A01121C41E72b0E7e7557fCb68";
+        readonly usdc: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
+        readonly dai: "0x6B175474E89094C44Da98b954EedeAC495271d0F";
+    };
+    readonly 11155111: {
+        readonly ethRegistrar: "0xf633e7FC17e2bbE0D0965D18ec1821dcB754a3d3";
+        readonly ethRenewerV1: "0xf2ece44980778966b8a0FccB3A9E339440f6e045";
+        readonly usdc: "0x240b0316Df57887DBBE58b586508b19e633a14aa";
+        readonly dai: "0xF6faC8A58a0BE13b9197f27C41B73162Fe32572b";
+    };
+};
+export declare function renewersFor(chainId: number | undefined, override?: Renewers): Renewers;

package/dist/addresses.js

@@ -0,0 +1,32 @@
+import { UnsupportedChainError } from './errors.js';
+/**
+ * Deployed ENS v2 renewers and the stablecoins ENS prices, per chain.
+ *
+ * Sourced from `@ensdomains/ensjs` and checked on-chain: both renewers expose
+ * `renew((string,uint64,bytes32),address)` and neither is an upgradeable
+ * proxy. The rent price oracle is *not* listed here; renewers can point at a
+ * new one, so it is read from `rentPriceOracle()` every time.
+ */
+export const addresses = {
+    1: {
+        ethRegistrar: '0xD6D8369e55c94Ae8AFA714E6cF7AB5bE54D5CC81',
+        ethRenewerV1: '0x56c447F308F463A01121C41E72b0E7e7557fCb68',
+        usdc: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+        dai: '0x6B175474E89094C44Da98b954EedeAC495271d0F',
+    },
+    11155111: {
+        ethRegistrar: '0xf633e7FC17e2bbE0D0965D18ec1821dcB754a3d3',
+        ethRenewerV1: '0xf2ece44980778966b8a0FccB3A9E339440f6e045',
+        usdc: '0x240b0316Df57887DBBE58b586508b19e633a14aa',
+        dai: '0xF6faC8A58a0BE13b9197f27C41B73162Fe32572b',
+    },
+};
+export function renewersFor(chainId, override) {
+    if (override)
+        return override;
+    const known = chainId === undefined ? undefined : addresses[chainId];
+    if (!known)
+        throw new UnsupportedChainError(chainId);
+    return known;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../src/addresses.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AASnD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,CAAC,EAAE;QACD,YAAY,EAAE,4CAA4C;QAC1D,YAAY,EAAE,4CAA4C;QAC1D,IAAI,EAAE,4CAA4C;QAClD,GAAG,EAAE,4CAA4C;KAClD;IACD,QAAQ,EAAE;QACR,YAAY,EAAE,4CAA4C;QAC1D,YAAY,EAAE,4CAA4C;QAC1D,IAAI,EAAE,4CAA4C;QAClD,GAAG,EAAE,4CAA4C;KAClD;CAC4E,CAAA;AAE/E,MAAM,UAAU,WAAW,CAAC,OAA2B,EAAE,QAAmB;IAC1E,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,MAAM,KAAK,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAiC,CAAC,CAAA;IAC9F,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAA;IACpD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,43 @@
+import type { Address } from 'viem';
+export declare class EnsBudgetError extends Error {
+    name: string;
+}
+/** Empty, over 255 bytes, or a length ENS doesn't sell (e.g. 1–2 characters). */
+export declare class InvalidLabelError extends EnsBudgetError {
+    readonly label: string;
+    name: string;
+    constructor(label: string, reason: string);
+}
+/** Neither renewer will renew the label right now (unregistered, or past grace). */
+export declare class NotRenewableError extends EnsBudgetError {
+    readonly label: string;
+    name: string;
+    constructor(label: string);
+}
+/** The rent price oracle has no exchange rate for this token. */
+export declare class UnsupportedTokenError extends EnsBudgetError {
+    readonly token: Address;
+    name: string;
+    constructor(token: Address);
+}
+/** No built-in renewer addresses for this chain; pass `renewers`. */
+export declare class UnsupportedChainError extends EnsBudgetError {
+    readonly chainId: number | undefined;
+    name: string;
+    constructor(chainId: number | undefined);
+}
+/** The budget buys less than the renewer's minimum duration. */
+export declare class BudgetTooLowError extends EnsBudgetError {
+    readonly budget: bigint;
+    readonly duration: bigint;
+    readonly minDuration: bigint;
+    name: string;
+    constructor(budget: bigint, duration: bigint, minDuration: bigint);
+}
+/** The local solve disagrees with ENS's own `getRenewPrice`. Should never happen. */
+export declare class QuoteMismatchError extends EnsBudgetError {
+    readonly expected: bigint;
+    readonly actual: bigint;
+    name: string;
+    constructor(expected: bigint, actual: bigint);
+}