@alchemy/common 0.0.0-alpha.21 → 0.0.0-alpha.22

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023 Alchemy Insights, Inc.
+Copyright (c) 2026 Alchemy Insights, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -0,0 +1,36 @@
+# @alchemy/common
+
+Shared foundation for the Alchemy Smart Wallets SDK. Provides the core interfaces and utilities used by all other `@alchemy/*` packages.
+
+## Installation
+
+```bash
+npm install @alchemy/common viem
+```
+
+## Key Exports
+
+- **`alchemyTransport`** - viem-compatible HTTP transport for Alchemy APIs (supports API key, JWT, or direct URL auth)
+- **Chain registry** - `getAlchemyRpcUrl`, `isChainSupported`, `getSupportedChainIds`
+- **Custom chain definitions** (via `@alchemy/common/chains`) - chains not yet in viem
+- **`AlchemyRestClient`** - typed REST client for non-JSON-RPC Alchemy APIs
+- **Error classes** - `BaseError`, `ChainNotFoundError`, `AccountNotFoundError`, `ConnectionConfigError`, etc.
+- **Logging** - `createLogger`, `setGlobalLoggerConfig`, `LogLevel`
+- **Utilities** - `bigIntMultiply`, `bigIntMax`, `lowerAddress`, `assertNever`
+
+## Usage
+
+```ts
+import { alchemyTransport } from "@alchemy/common";
+import { sepolia } from "viem/chains";
+import { createPublicClient } from "viem";
+
+const client = createPublicClient({
+  chain: sepolia,
+  transport: alchemyTransport({ apiKey: "YOUR_API_KEY" }),
+});
+```
+
+## License
+
+MIT

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.0.0-alpha.20";
+export declare const VERSION = "0.0.0-alpha.21";

package/dist/esm/version.js

@@ -1,4 +1,4 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "0.0.0-alpha.20";
+export const VERSION = "0.0.0-alpha.21";
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"0.0.0-alpha.20\";\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"0.0.0-alpha.21\";\n"]}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.0.0-alpha.20";
+export declare const VERSION = "0.0.0-alpha.21";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alchemy/common",
-  "version": "0.0.0-alpha.21",
+  "version": "0.0.0-alpha.22",
   "description": "A collection of interfaces and utilities to be used by other Alchemy packages",
   "author": "Alchemy",
   "license": "MIT",
@@ -61,5 +61,5 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "b253d0ee34fcb723a72d594d56b484188ac6867b"
+  "gitHead": "10e989504f15718c4c6b66e6856e509dfb3e6cfe"
 }

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "0.0.0-alpha.21";
+export const VERSION = "0.0.0-alpha.22";