refactor: update suffix

Author: solidsnakedev

docs/content/docs/devnet/configuration.mdx

@@ -117,7 +117,7 @@ This pattern enables testing multi-party protocols, delegation scenarios, and wa
 
 After creating a genesis configuration, calculate the resulting UTxOs to verify addresses and amounts.
 
-**Important**: Genesis UTxOs do NOT appear in Kupo's index because Kupo reads chain events starting from block 1, while genesis UTxOs exist in block 0 (the genesis block itself). You must use `calculateUtxosFromConfigOrThrow` to derive these UTxOs and provide them to your transaction builder via the `availableUtxos` parameter. After spending a genesis UTxO, the resulting outputs will be indexed normally by Kupo.
+**Important**: Genesis UTxOs do NOT appear in Kupo's index because Kupo reads chain events starting from block 1, while genesis UTxOs exist in block 0 (the genesis block itself). You must use `calculateUtxosFromConfig` to derive these UTxOs and provide them to your transaction builder via the `availableUtxos` parameter. After spending a genesis UTxO, the resulting outputs will be indexed normally by Kupo.
 
 ```typescript twoslash
 import { Config, Genesis } from "@evolution-sdk/devnet";
@@ -131,7 +131,7 @@ const genesisConfig = {
 } satisfies Config.ShelleyGenesis;
 
 // Calculate UTxOs before starting the cluster
-const genesisUtxos = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig);
+const genesisUtxos = await Genesis.calculateUtxosFromConfig(genesisConfig);
 
 console.log("Genesis UTxOs:", genesisUtxos.length);
 genesisUtxos.forEach(utxo => {
@@ -383,7 +383,7 @@ console.log("- Custom protocol parameters");
 console.log("- Kupo and Ogmios enabled");
 
 // Calculate and verify genesis UTxOs
-const utxos = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig);
+const utxos = await Genesis.calculateUtxosFromConfig(genesisConfig);
 console.log(`\nGenesis UTxOs: ${utxos.length}`);
 utxos.forEach((utxo, i) => {
   console.log(`  Address ${i + 1}: ${utxo.assets.lovelace} lovelace`);

docs/content/docs/devnet/integration.mdx

@@ -93,7 +93,7 @@ async function completeWorkflow() {
   });
 
   // Step 6: Calculate genesis UTxOs
-  const genesisUtxos = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig);
+  const genesisUtxos = await Genesis.calculateUtxosFromConfig(genesisConfig);
 
   console.log("Genesis UTxOs:", genesisUtxos.length);
   console.log("Initial balance:", genesisUtxos[0]?.assets.lovelace, "lovelace");
@@ -155,9 +155,9 @@ The genesis UTxO calculation provides the initial funds for transaction building
 
 Three key integration points connect devnet to the Evolution SDK:
 
-**Genesis to UTxO**: The `calculateUtxosFromConfigOrThrow` function converts genesis configuration into queryable UTxO objects. These UTxOs can be used as transaction inputs immediately after cluster start.
+**Genesis to UTxO**: The `calculateUtxosFromConfig` function converts genesis configuration into queryable UTxO objects. These UTxOs can be used as transaction inputs immediately after cluster start.
 
-**Critical: Genesis UTxOs and Kupo**: Genesis UTxOs do NOT appear in Kupo's index. Kupo reads chain events starting from the first block, but genesis UTxOs are created in the genesis block itself (block 0), which has no transaction events. You MUST use `calculateUtxosFromConfigOrThrow` to derive genesis UTxOs and explicitly inject them into your transaction builder using the `availableUtxos` parameter. Once you spend a genesis UTxO in a transaction, the resulting outputs WILL be indexed by Kupo and can be queried normally.
+**Critical: Genesis UTxOs and Kupo**: Genesis UTxOs do NOT appear in Kupo's index. Kupo reads chain events starting from the first block, but genesis UTxOs are created in the genesis block itself (block 0), which has no transaction events. You MUST use `calculateUtxosFromConfig` to derive genesis UTxOs and explicitly inject them into your transaction builder using the `availableUtxos` parameter. Once you spend a genesis UTxO in a transaction, the resulting outputs WILL be indexed by Kupo and can be queried normally.
 
 **Provider Configuration**: The client's provider configuration points to the devnet's Kupo and Ogmios services. This enables all blockchain queries (UTxOs, protocol parameters, tip) to target the local network.
 
@@ -269,7 +269,7 @@ describe("Transaction Tests", () => {
       wallet: { type: "seed", mnemonic, accountIndex: 0 }
     });
 
-    genesisUtxos = await Genesis.calculateUtxosFromConfigOrThrow(
+    genesisUtxos = await Genesis.calculateUtxosFromConfig(
       genesisConfig
     );
   }, 180_000); // Extended timeout for cluster startup
@@ -405,7 +405,7 @@ const client2 = createClient({
 });
 
   // Wallet 1 sends to Wallet 2
-  const utxos1 = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig);
+  const utxos1 = await Genesis.calculateUtxosFromConfig(genesisConfig);
   const wallet1Address = await wallet1.address();
   const wallet1Utxo = utxos1.find(u => u.address === wallet1Address)!;
 
@@ -488,7 +488,7 @@ Run this script to start a persistent devnet for manual testing, dApp developmen
 
 **"Cannot connect to provider"**: Ensure sufficient wait time after `Cluster.start()`. Kupo and Ogmios need 6-8 seconds to initialize completely. Increase wait time for slower systems.
 
-**"UTxO not found"**: Remember that genesis UTxOs are NOT indexed by Kupo. Always use `calculateUtxosFromConfigOrThrow` and provide them via `availableUtxos` parameter when building your first transaction. After spending genesis UTxOs, subsequent outputs will be indexed normally.
+**"UTxO not found"**: Remember that genesis UTxOs are NOT indexed by Kupo. Always use `calculateUtxosFromConfig` and provide them via `availableUtxos` parameter when building your first transaction. After spending genesis UTxOs, subsequent outputs will be indexed normally.
 
 **"Transaction submission failed"**: Verify network magic matches between genesis configuration and client. Mismatched magic causes address validation failures.
 

docs/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./out/dev/types/routes.d.ts";
+import "./.next/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

packages/evolution-devnet/src/Genesis.ts

@@ -50,15 +50,15 @@ export interface Cluster {
  *   // ... other genesis config
  * }
  *
- * const utxos = await Devnet.Genesis.calculateUtxosFromConfigOrThrow(
+ * const utxos = await Devnet.Genesis.calculateUtxosFromConfig(
  *   genesisConfig
  * )
  * ```
  *
  * @since 2.0.0
  * @category genesis
  */
-export const calculateUtxosFromConfig = (
+export const calculateUtxosFromConfigEffect = (
   genesisConfig: Config.ShelleyGenesis
 ): Effect.Effect<ReadonlyArray<UTxO.UTxO>, GenesisError> =>
   Effect.gen(function* () {
@@ -104,8 +104,8 @@ export const calculateUtxosFromConfig = (
  * @since 2.0.0
  * @category genesis
  */
-export const calculateUtxosFromConfigOrThrow = (genesisConfig: Config.ShelleyGenesis) =>
-  Effect.runPromise(calculateUtxosFromConfig(genesisConfig))
+export const calculateUtxosFromConfig = (genesisConfig: Config.ShelleyGenesis) =>
+  Effect.runPromise(calculateUtxosFromConfigEffect(genesisConfig))
 
 /**
  * Query genesis UTxOs from the running node using cardano-cli.
@@ -114,7 +114,7 @@ export const calculateUtxosFromConfigOrThrow = (genesisConfig: Config.ShelleyGen
  * @since 2.0.0
  * @category genesis
  */
-export const queryUtxos = (cluster: Cluster): Effect.Effect<ReadonlyArray<UTxO.UTxO>, GenesisError> =>
+export const queryUtxosEffect = (cluster: Cluster): Effect.Effect<ReadonlyArray<UTxO.UTxO>, GenesisError> =>
   Effect.gen(function* () {
     // Need to import Container functions dynamically to avoid circular dependency
     const ContainerModule = yield* Effect.promise(() => import("./Container.js"))
@@ -169,4 +169,4 @@ export const queryUtxos = (cluster: Cluster): Effect.Effect<ReadonlyArray<UTxO.U
  * @since 2.0.0
  * @category genesis
  */
-export const queryUtxosOrThrow = (cluster: Cluster) => Effect.runPromise(queryUtxos(cluster))
+export const queryUtxos = (cluster: Cluster) => Effect.runPromise(queryUtxosEffect(cluster))

packages/evolution-devnet/test/Client.Devnet.test.ts

@@ -72,7 +72,7 @@ describe("Client with Devnet", () => {
   }, 60_000)
 
   it("should calculate genesis UTxOs from config", { timeout: 10_000 }, async () => {
-    const calculatedUtxos = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig)
+    const calculatedUtxos = await Genesis.calculateUtxosFromConfig(genesisConfig)
 
     expect(calculatedUtxos).toBeDefined()
     expect(calculatedUtxos.length).toBe(1)

packages/evolution-devnet/test/Devnet.Genesis.test.ts

@@ -44,7 +44,7 @@ describe("Devnet.Genesis", () => {
   }, 60_000)
 
   it("should calculate genesis UTxOs from config", { timeout: 10_000 }, async () => {
-    const utxos = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig)
+    const utxos = await Genesis.calculateUtxosFromConfig(genesisConfig)
 
     expect(utxos).toBeDefined()
     expect(utxos.length).toBe(1)
@@ -60,7 +60,7 @@ describe("Devnet.Genesis", () => {
   it("should query genesis UTxOs from node", { timeout: 30_000 }, async () => {
     if (!devnetCluster) throw new Error("Devnet not initialized")
 
-    const utxos = await Genesis.queryUtxosOrThrow(devnetCluster)
+    const utxos = await Genesis.queryUtxos(devnetCluster)
 
     expect(utxos).toBeDefined()
     expect(utxos.length).toBe(1)
@@ -76,8 +76,8 @@ describe("Devnet.Genesis", () => {
   it("should match: calculated === queried", { timeout: 30_000 }, async () => {
     if (!devnetCluster) throw new Error("Devnet not initialized")
 
-    const calculated = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig)
-    const queried = await Genesis.queryUtxosOrThrow(devnetCluster)
+    const calculated = await Genesis.calculateUtxosFromConfig(genesisConfig)
+    const queried = await Genesis.queryUtxos(devnetCluster)
 
     expect(calculated.length).toBe(queried.length)
 
@@ -90,9 +90,9 @@ describe("Devnet.Genesis", () => {
   })
 
   it("should be deterministic", { timeout: 10_000 }, async () => {
-    const result1 = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig)
-    const result2 = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig)
-    const result3 = await Genesis.calculateUtxosFromConfigOrThrow(genesisConfig)
+    const result1 = await Genesis.calculateUtxosFromConfig(genesisConfig)
+    const result2 = await Genesis.calculateUtxosFromConfig(genesisConfig)
+    const result3 = await Genesis.calculateUtxosFromConfig(genesisConfig)
 
     expect(result1).toEqual(result2)
     expect(result2).toEqual(result3)
@@ -108,7 +108,7 @@ describe("Devnet.Genesis", () => {
       }
     }
 
-    const utxos = await Genesis.calculateUtxosFromConfigOrThrow(multiConfig)
+    const utxos = await Genesis.calculateUtxosFromConfig(multiConfig)
 
     expect(utxos.length).toBe(3)