Kerem/config

.changeset/calm-ligers-brush.md

@@ -0,0 +1,5 @@
+---
+"@whatsgood/nexus": patch
+---
+
+improved logging and error reporting

.changeset/hip-swans-sin.md

@@ -0,0 +1,5 @@
+---
+"@whatsgood/nexus": minor
+---
+
+created a new unified and reusable registry class, along with builders

.changeset/ninety-rockets-live.md

@@ -0,0 +1,5 @@
+---
+"@whatsgood/nexus": minor
+---
+
+streamlined env vars for provider keys

.changeset/silent-seahorses-join.md

@@ -0,0 +1,5 @@
+---
+"@whatsgood/nexus": minor
+---
+
+simplified provider configuration via string arrays

examples/cloudflare-worker/src/index.ts

@@ -7,21 +7,8 @@ import { NexusServer } from "@whatsgood/nexus";
 type Env = Record<string, string>;
 
 const server = NexusServer.create<Env>({
-  providers: {
-    // alchemy: {
-    //   disabled: true,
-    // },
-    base: {
-      disabled: true,
-    },
-    infura: {
-      disabled: true,
-    },
-    ankr: {
-      disabled: true,
-    },
-  },
-  env: (env) => env,
+  env: (ctx) => ctx,
+  providers: ["alchemy"],
 });
 
 export default { fetch: server.fetch };

examples/nodejs-standalone-server/package.json

@@ -14,6 +14,7 @@
     "@whatsgood/nexus": "workspace:*"
   },
   "devDependencies": {
+    "@types/node": "^20.10.0",
     "typescript": "5.2.2"
   }
 }

examples/nodejs-standalone-server/src/index.ts

@@ -1,7 +1,9 @@
 import { NexusServer } from "@whatsgood/nexus";
 import { createServer } from "node:http";
 
-const server = NexusServer.create();
+const server = NexusServer.create({
+  providers: ["base"],
+});
 
 createServer(server).listen(4005, () => {
   console.log(`🚀 Server ready at http://localhost:4005`);

packages/nexus/src/chain/chain.ts

@@ -1,42 +1,73 @@
+import type { Registry } from "@src/registry";
+
+export class Network {
+  private readonly chains = new Map<string, Chain>();
+
+  private constructor(public readonly name: string) {}
+
+  public addChain(chain: Chain) {
+    if (this.chains.has(chain.name)) {
+      throw new Error(`Chain ${chain.name} already exists`);
+    }
+
+    this.chains.set(chain.name, chain);
+  }
+
+  public getChain(name: string): Chain | undefined {
+    return this.chains.get(name);
+  }
+
+  public static init(
+    registry: Registry,
+    name: string,
+    aliases?: string[]
+  ): Network {
+    const existingNetwork = registry.getNetwork(name);
+    const network = existingNetwork || new Network(name);
+
+    registry.registerNetwork(network, aliases);
+
+    return network;
+  }
+}
+
 export interface ChainStatus {
   chainId: number;
   chainName: string;
   networkName: string;
-  isDeprecated: boolean;
-}
-
-export interface Network {
-  name: string;
-  aliases: string[];
-  chains: Partial<Record<string, Chain>>;
+  // TODO: add isDeprecated
+  // isDeprecated: boolean;
 }
 
 export class Chain {
-  public readonly name: string;
-  public readonly chainId: number;
-  public readonly network: Network;
-  public readonly isDeprecated: boolean;
-
-  constructor(params: {
-    name: string;
-    chainId: number;
-    network: Network;
-    isDeprecated?: boolean;
-  }) {
-    const { name, chainId, network, isDeprecated } = params;
-
-    this.name = name;
-    this.chainId = chainId;
-    this.network = network;
-    this.isDeprecated = isDeprecated || false;
-  }
+  private constructor(
+    public readonly chainId: number,
+    public readonly network: Network,
+    public readonly name: string
+  ) {}
 
   public get status(): ChainStatus {
     return {
       chainName: this.name,
       chainId: this.chainId,
       networkName: this.network.name,
-      isDeprecated: this.isDeprecated,
+      // isDeprecated: this.isDeprecated,
     };
   }
+
+  public static init(
+    registry: Registry,
+    params: {
+      chainId: number;
+      network: Network;
+      name: string;
+    }
+  ): Chain {
+    const chain = new Chain(params.chainId, params.network, params.name);
+
+    params.network.addChain(chain);
+    registry.registerChain(chain);
+
+    return chain;
+  }
 }

packages/nexus/src/chain/index.ts

@@ -0,0 +1 @@
+export * from "./chain";