@foundry-rs/cast 1.4.4 → 1.5.0-nightly.20251116.cd86772

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

@@ -28,7 +28,22 @@ if (!platformPackage) {
   process.exit(1)
 }
 
-NodeChildProcess.spawn(selectBinaryPath(), process.argv.slice(2), { stdio: 'inherit' })
+const child = NodeChildProcess.spawn(
+  selectBinaryPath(),
+  process.argv.slice(2),
+  { stdio: 'inherit' }
+)
+
+/**
+ * @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.
@@ -117,3 +132,21 @@ function selectBinaryPath() {
 
   return NodePath.join(__dirname, '..', 'dist', binaryName)
 }
+
+/**
+ * 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 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",
+  "version": "1.5.0-nightly.20251116.cd86772",
   "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",
-    "@foundry-rs/cast-darwin-amd64": "1.4.4",
-    "@foundry-rs/cast-linux-arm64": "1.4.4",
-    "@foundry-rs/cast-linux-amd64": "1.4.4",
-    "@foundry-rs/cast-win32-amd64": "1.4.4"
+    "@foundry-rs/cast-darwin-arm64": "1.5.0-nightly.20251116.cd86772",
+    "@foundry-rs/cast-darwin-amd64": "1.5.0-nightly.20251116.cd86772",
+    "@foundry-rs/cast-linux-arm64": "1.5.0-nightly.20251116.cd86772",
+    "@foundry-rs/cast-linux-amd64": "1.5.0-nightly.20251116.cd86772",
+    "@foundry-rs/cast-win32-amd64": "1.5.0-nightly.20251116.cd86772"
   },
   "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",