@foundry-rs/cast 1.4.4-nightly.20251104.804ad9f → 1.4.4-nightly.20251111.25196fa

package/README.md

@@ -1,5 +1,53 @@
-# Cast
+# [Cast](https://getfoundry.sh/cast)
 
 Cast is a Swiss Army knife for interacting with Ethereum applications from the command line.
 You can make smart contract calls, send transactions, or retrieve any type of chain data - all from your command-line!
 The cast binary can be used both within and outside of a Foundry project.
+
+## Usage
+
+### One-off commands
+
+Example
+
+```sh
+npx --yes @foundry-rs/cast@nightly block-number
+```
+
+More generally
+
+```sh
+npx --yes @foundry-rs/cast@<version|nightly> <command> [args...]
+```
+
+### Install then use
+
+locally to your project
+
+```sh
+npm add @foundry-rs/cast@nightly
+npx cast <command> [args...]
+```
+
+globally
+
+```sh
+npm add --global @foundry-rs/cast@nightly
+cast <command> [args...]
+```
+
+---
+
+Also works with `deno`, `bun`, and `pnpm`:
+
+```sh
+deno run --quiet --allow-all npm:@foundry-rs/cast@nightly <command> [args...]
+```
+
+```sh
+bun x @foundry-rs/cast@nightly <command> [args...]
+```
+
+```sh
+pnpm dlx --silent @foundry-rs/cast@nightly <command> [args...]
+```

package/bin.mjs

@@ -29,13 +29,21 @@ if (!platformPackage) {
 }
 
 const child = NodeChildProcess.spawn(
-    selectBinaryPath(),
-    process.argv.slice(2),
-    { stdio: 'inherit' }
+  selectBinaryPath(),
+  process.argv.slice(2),
+  { stdio: 'inherit' }
 )
 
-process.on('SIGINT', killChild)
-process.on('SIGTERM', killChild)
+/**
+ * @type {Record<'SIGINT' | 'SIGTERM', () => void>}
+ */
+const signalHandlers = {
+  SIGINT: () => forwardSignal('SIGINT'),
+  SIGTERM: () => forwardSignal('SIGTERM')
+}
+
+for (const [signal, handler] of Object.entries(signalHandlers))
+  process.on(signal, handler)
 
 /**
  * Determines which tool wrapper is executing.
@@ -126,8 +134,19 @@ function selectBinaryPath() {
 }
 
 /**
- * Kills the child process.
+ * Forwards a received signal to the child process, then re-emits it locally to
+ * preserve Node.js default exit semantics.
+ * @param {'SIGINT' | 'SIGTERM'} signal
  */
-function killChild() {
-    child.kill()
+function forwardSignal(signal) {
+  try {
+    if (!child.killed)
+      child.kill(signal)
+  } catch (error) {
+    if (!error || (typeof error === 'object' && 'code' in error && error.code !== 'ESRCH'))
+      throw error
+  }
+
+  process.off(signal, signalHandlers[signal])
+  process.kill(process.pid, signal)
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foundry-rs/cast",
-  "version": "1.4.4-nightly.20251104.804ad9f",
+  "version": "1.4.4-nightly.20251111.25196fa",
   "type": "module",
   "homepage": "https://getfoundry.sh/cast",
   "description": "Swiss Army knife for interacting with Ethereum applications from the command line",
@@ -16,17 +16,25 @@
     "postinstall": "TARGET_TOOL=cast node ./postinstall.mjs"
   },
   "optionalDependencies": {
-    "@foundry-rs/cast-darwin-arm64": "1.4.4-nightly.20251104.804ad9f",
-    "@foundry-rs/cast-darwin-amd64": "1.4.4-nightly.20251104.804ad9f",
-    "@foundry-rs/cast-linux-arm64": "1.4.4-nightly.20251104.804ad9f",
-    "@foundry-rs/cast-linux-amd64": "1.4.4-nightly.20251104.804ad9f",
-    "@foundry-rs/cast-win32-amd64": "1.4.4-nightly.20251104.804ad9f"
+    "@foundry-rs/cast-darwin-arm64": "1.4.4-nightly.20251111.25196fa",
+    "@foundry-rs/cast-darwin-amd64": "1.4.4-nightly.20251111.25196fa",
+    "@foundry-rs/cast-linux-arm64": "1.4.4-nightly.20251111.25196fa",
+    "@foundry-rs/cast-linux-amd64": "1.4.4-nightly.20251111.25196fa",
+    "@foundry-rs/cast-win32-amd64": "1.4.4-nightly.20251111.25196fa"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true,
     "registry": "https://registry.npmjs.org"
   },
+  "keywords": [
+    "foundry",
+    "testing",
+    "ethereum",
+    "solidity",
+    "blockchain",
+    "smart-contracts"
+  ],
   "license": "MIT OR Apache-2.0",
   "repository": {
     "directory": "npm",