genlayer 0.36.1 → 0.37.0

package/README.md

@@ -174,15 +174,15 @@ USAGE:
 OPTIONS (deploy):
    --contract <contractPath>  (Optional) Path to the intelligent contract to deploy
    --rpc <rpcUrl>             RPC URL for the network
-   --args <args...>           Positional arguments for the contract (space-separated, use quotes for multi-word arguments)
+   --args <args...>           Contract arguments (see Argument Types below)
 
 OPTIONS (call):
    --rpc <rpcUrl>             RPC URL for the network
-   --args <args...>           Positional arguments for the method (space-separated, use quotes for multi-word arguments)
+   --args <args...>           Method arguments (see Argument Types below)
 
 OPTIONS (write):
    --rpc <rpcUrl>             RPC URL for the network
-   --args <args...>           Positional arguments for the method (space-separated, use quotes for multi-word arguments)
+   --args <args...>           Method arguments (see Argument Types below)
 
 OPTIONS (schema):
    --rpc <rpcUrl>             RPC URL for the network
@@ -193,9 +193,30 @@ EXAMPLES:
    genlayer deploy --contract ./my_contract.gpy --args "arg1" "arg2" 123
    genlayer call 0x123456789abcdef greet --args "Hello World!"
    genlayer write 0x123456789abcdef updateValue --args 42
+   genlayer write 0x123456789abcdef sendReward --args 0x6857Ed54CbafaA74Fc0357145eC0ee1536ca45A0
+   genlayer write 0x123456789abcdef setScores --args '[1, 2, 3]'
+   genlayer write 0x123456789abcdef setConfig --args '{"timeout": 30, "retries": 5}'
    genlayer schema 0x123456789abcdef
 ```
 
+##### Argument Types
+
+The `--args` option automatically detects and converts values to the correct type:
+
+| Type | Syntax | Example |
+|------|--------|---------|
+| Boolean | `true`, `false` | `--args true false` |
+| Null | `null` | `--args null` |
+| Integer | numeric value | `--args 42 -1` |
+| Hex integer | `0x` prefix | `--args 0x1a` |
+| String | any other value | `--args hello "multi word"` |
+| Address | 40 hex chars with `0x` or `addr#` prefix | `--args 0x6857...a0` or `--args addr#6857...a0` |
+| Bytes | `b#` prefix + hex | `--args b#deadbeef` |
+| Array | JSON array in quotes | `--args '[1, 2, "three"]'` |
+| Dict | JSON object in quotes | `--args '{"key": "value"}'` |
+
+Large numbers that exceed JavaScript's safe integer range are automatically handled as BigInt to preserve precision.
+
 ##### Deploy Behavior
 - If `--contract` is specified, the command will **deploy the given contract**.
 - If `--contract` is omitted, the CLI will **search for scripts inside the `deploy` folder**, sort them, and execute them sequentially.

package/dist/index.js

@@ -20078,7 +20078,7 @@ var require_cli_table3 = __commonJS({
 import { program } from "commander";
 
 // package.json
-var version = "0.36.1";
+var version = "0.37.0";
 var package_default = {
   name: "genlayer",
   version,
@@ -55120,19 +55120,72 @@ var CodeAction = class extends BaseAction {
 };
 
 // src/commands/contracts/index.ts
-function parseArg(value, previous = []) {
-  if (value === "true") return [...previous, true];
-  if (value === "false") return [...previous, false];
-  if (!isNaN(Number(value))) return [...previous, Number(value)];
-  return [...previous, value];
+var ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
+var ADDR_PREFIX_RE = /^addr#([0-9a-fA-F]{40})$/;
+var BYTES_PREFIX_RE = /^b#([0-9a-fA-F]*)$/;
+var HEX_RE = /^0x[0-9a-fA-F]+$/;
+function hexToBytes4(hex) {
+  const bytes = new Uint8Array(hex.length / 2);
+  for (let i2 = 0; i2 < bytes.length; i2++) {
+    bytes[i2] = parseInt(hex.slice(i2 * 2, i2 * 2 + 2), 16);
+  }
+  return bytes;
 }
+function coerceValue(value) {
+  if (value === null) return null;
+  if (typeof value === "boolean") return value;
+  if (typeof value === "number") {
+    if (Number.isSafeInteger(value)) return value;
+    return BigInt(value);
+  }
+  if (Array.isArray(value)) return value.map(coerceValue);
+  if (typeof value === "object" && value !== null) {
+    const result = {};
+    for (const [k, v] of Object.entries(value)) {
+      result[k] = coerceValue(v);
+    }
+    return result;
+  }
+  if (typeof value === "string") return parseScalar(value);
+  return value;
+}
+function parseScalar(value) {
+  if (value === "null") return null;
+  if (value === "true") return true;
+  if (value === "false") return false;
+  const addrMatch = value.match(ADDR_PREFIX_RE);
+  if (addrMatch) return new CalldataAddress(hexToBytes4(addrMatch[1]));
+  if (ADDRESS_RE.test(value)) return new CalldataAddress(hexToBytes4(value.slice(2)));
+  const bytesMatch = value.match(BYTES_PREFIX_RE);
+  if (bytesMatch) return hexToBytes4(bytesMatch[1]);
+  if (HEX_RE.test(value)) return BigInt(value);
+  if (!isNaN(Number(value)) && Number.isSafeInteger(Number(value))) return Number(value);
+  if (!isNaN(Number(value))) return BigInt(value);
+  return value;
+}
+function parseArg(value, previous = []) {
+  try {
+    const parsed = JSON.parse(value);
+    if (typeof parsed === "object" || Array.isArray(parsed)) {
+      return [...previous, coerceValue(parsed)];
+    }
+  } catch {
+  }
+  return [...previous, parseScalar(value)];
+}
+var ARGS_HELP = [
+  "Contract arguments. Supported types:",
+  "  bool: true, false",
+  "  null: null",
+  "  int: 42, -1, 0x1a (large values auto-use BigInt)",
+  '  str: hello, "multi word"',
+  "  address: 0x6857...a0 (40 hex chars) or addr#6857...a0",
+  "  bytes: b#deadbeef",
+  `  array: '[1, 2, "three"]'`,
+  `  dict: '{"key": "value"}'`
+].join("\n");
 function initializeContractsCommands(program2) {
-  program2.command("deploy").description("Deploy intelligent contracts").option("--contract <contractPath>", "Path to the smart contract to deploy").option("--rpc <rpcUrl>", "RPC URL for the network").option(
-    "--args <args...>",
-    "Positional arguments for the contract (space-separated, use quotes for multi-word arguments)",
-    parseArg,
-    []
-  ).action(async (options) => {
+  program2.command("deploy").description("Deploy intelligent contracts").option("--contract <contractPath>", "Path to the smart contract to deploy").option("--rpc <rpcUrl>", "RPC URL for the network").option("--args <args...>", ARGS_HELP, parseArg, []).action(async (options) => {
     const deployer = new DeployAction();
     if (options.contract) {
       await deployer.deploy(options);
@@ -55143,7 +55196,7 @@ function initializeContractsCommands(program2) {
   });
   program2.command("call <contractAddress> <method>").description("Call a contract method without sending a transaction or changing the state").option("--rpc <rpcUrl>", "RPC URL for the network").option(
     "--args <args...>",
-    "Positional arguments for the method (space-separated, use quotes for multi-word arguments)",
+    ARGS_HELP,
     parseArg,
     []
   ).action(async (contractAddress, method, options) => {
@@ -55152,7 +55205,7 @@ function initializeContractsCommands(program2) {
   });
   program2.command("write <contractAddress> <method>").description("Sends a transaction to a contract method that modifies the state").option("--rpc <rpcUrl>", "RPC URL for the network").option(
     "--args <args...>",
-    "Positional arguments for the method (space-separated, use quotes for multi-word arguments)",
+    ARGS_HELP,
     parseArg,
     []
   ).action(async (contractAddress, method, options) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genlayer",
-  "version": "0.36.1",
+  "version": "0.37.0",
   "description": "GenLayer Command Line Tool",
   "main": "src/index.ts",
   "type": "module",