arc-devkit 0.4.3__tar.gz → 0.4.5__tar.gz

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arc-devkit
-Version: 0.4.3
+Version: 0.4.5
 Summary: Plataforma open source de ferramentas para desenvolvedores da Arc blockchain (Circle)
 Author-email: Jeielsantosdev <jeielsantos.ti@gmail.com>
 License-Expression: MIT
@@ -88,10 +88,10 @@ cp .env.example .env
 #    ARC_PRIVATE_KEY    — optional; needed to send transactions
 
 # 3. Guided interactive setup (creates .env from scratch)
-arc init
+arcdevkit init
 
 # 4. Verify connection
-arc status
+arcdevkit status
 ```
 
 ```
@@ -130,10 +130,10 @@ AI assistant powered by Claude Sonnet, with Arc blockchain context embedded in t
 
 ```bash
 # Ask a question
-arc ask "How do I deploy an ERC-20 contract on Arc testnet?"
+arcdevkit copilot ask "How do I deploy an ERC-20 contract on Arc testnet?"
 
 # Streaming output (token by token)
-arc ask --stream "Write a USDC payment contract in Solidity"
+arcdevkit copilot ask "Write a USDC payment contract in Solidity" --stream
 ```
 
 ### Python
@@ -349,16 +349,16 @@ Fetches transaction data via RPC, decodes the error/result, and uses the Dev Cop
 
 ```bash
 # Analyze a transaction
-arc debug tx 0xYourTxHashHere
+arcdevkit debug tx 0xYourTxHashHere
 
 # Load an ABI to decode input data
-arc debug tx 0xYourTxHash --abi ./MyContract.abi.json
+arcdevkit debug tx 0xYourTxHash --abi ./MyContract.abi.json
 
 # Batch — analyze a file of hashes (one per line)
-arc debug batch hashes.txt
+arcdevkit debug batch hashes.txt
 
-# View recent analysis history
-arc history
+# View recent operation history
+arcdevkit history
 ```
 
 ```python
@@ -395,10 +395,13 @@ Snapshot a wallet's complete state and activity on Arc, with AI commentary.
 
 ```bash
 # Analyze a single wallet
-arc portfolio analyze 0xYourWalletAddress
+arcdevkit portfolio analyze 0xYourWalletAddress
+
+# Show saved balance history
+arcdevkit portfolio history 0xYourWalletAddress
 
 # Generate a consolidated report for multiple wallets
-arc portfolio report wallets.json
+arcdevkit portfolio report wallets.json
 ```
 
 ```python
@@ -593,54 +596,77 @@ The `docker-compose.yml` mounts your `.env` and runs the API on port 8000 with a
 
 ## CLI Reference
 
-Arc DevKit provides two CLI entry points:
+The primary entry point is `arcdevkit`, with commands grouped by domain.
 
-| Command | Entry Point |
-|---|---|
-| `arc` | Flat, friendly commands for day-to-day use |
-| `arcdevkit` | Grouped subcommand style |
+### Setup
+
+```bash
+arcdevkit init                              # interactive .env wizard
+arcdevkit status                            # check testnet connection + block info
+```
+
+### Config — manage `.env`
+
+```bash
+arcdevkit config list                       # show all variables
+arcdevkit config get ANTHROPIC_API_KEY      # read a specific variable
+arcdevkit config set ARC_RPC_URL https://...# write a variable
+```
+
+### Copilot — AI assistant
 
-### `arc` — quick commands
+```bash
+arcdevkit copilot ask "What is Malachite consensus?"
+arcdevkit copilot ask "Write a USDC vault" --stream   # token-by-token streaming
+arcdevkit copilot ask "..." --json                    # output as JSON
+```
+
+### Agent — wallet & payments
 
 ```bash
-# Setup
-arc init                                 # guided .env wizard
-arc status                               # testnet connection + block info
-arc config list                          # show all env vars
-arc config get ANTHROPIC_API_KEY         # read a specific var
-arc config set ARC_RPC_URL https://...   # write a var
+arcdevkit agent create-wallet               # generate new EVM wallet
+arcdevkit agent balance 0xAddress...        # check wallet balance
+arcdevkit agent status                      # network info (block, chain ID, gas)
+arcdevkit agent pay 0xDest... 5.0           # sign-only (safe default)
+arcdevkit agent pay 0xDest... 5.0 --send    # sign and broadcast
+arcdevkit agent pay 0xDest... 5.0 --send --key 0xPrivKey...
+arcdevkit agent monitor 0xWallet...         # watch balance changes
+arcdevkit agent monitor 0xWallet... --interval 5 --max 50
+```
 
-# Wallet
-arc wallet create                        # generate new wallet
-arc wallet balance --address 0x...       # check balance
+### Debug — transaction analysis
 
-# AI Copilot
-arc ask "What is Malachite consensus?"
-arc ask --stream "Write a USDC vault"
-arc ask --json "..."                     # output as JSON
+```bash
+arcdevkit debug tx 0xHash...                # analyze a transaction with AI
+arcdevkit debug tx 0xHash... --json
+arcdevkit debug estimate 0xDest... 10.0     # estimate gas cost
+arcdevkit debug estimate 0xDest... 10.0 --from 0xSender...
+arcdevkit debug batch hashes.txt            # analyze multiple txs from a file
+arcdevkit debug batch hashes.txt --abi MyContract.json
+```
 
-# Transaction debugging
-arc debug tx 0xHash
-arc debug tx 0xHash --abi Contract.json
-arc history                              # list recent debug sessions
+### Portfolio — wallet analytics
 
-# Portfolio
-arc portfolio analyze 0xWallet
-arc portfolio report wallets.json
+```bash
+arcdevkit portfolio analyze 0xWallet...     # balances, txs, AI insights
+arcdevkit portfolio analyze 0xWallet... --no-ai --blocks 500
+arcdevkit portfolio history 0xWallet...     # saved balance snapshots
+arcdevkit portfolio report wallets.json     # consolidated multi-wallet report
+```
+
+### Codegen — script generation
 
-# Flags (work on every command)
-arc --json <cmd>                         # machine-readable JSON output
-arc -v <cmd>                             # verbose (DEBUG logging)
+```bash
+arcdevkit codegen "monitor a wallet and alert when balance drops"
+arcdevkit codegen "deploy an ERC-20 with a mint function" --out ./scripts
+arcdevkit codegen "..." --no-save           # print only, don't save to disk
 ```
 
-### `arcdevkit` — grouped style
+### History — operation log
 
 ```bash
-arcdevkit status
-arcdevkit copilot ask "..."
-arcdevkit agent wallet create
-arcdevkit agent pay --to 0x... --amount 10
-arcdevkit debug tx 0xHash
+arcdevkit history                           # last 10 CLI operations
+arcdevkit history --limit 25 --json
 ```
 
 ---

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/README.md

@@ -49,10 +49,10 @@ cp .env.example .env
 #    ARC_PRIVATE_KEY    — optional; needed to send transactions
 
 # 3. Guided interactive setup (creates .env from scratch)
-arc init
+arcdevkit init
 
 # 4. Verify connection
-arc status
+arcdevkit status
 ```
 
 ```
@@ -91,10 +91,10 @@ AI assistant powered by Claude Sonnet, with Arc blockchain context embedded in t
 
 ```bash
 # Ask a question
-arc ask "How do I deploy an ERC-20 contract on Arc testnet?"
+arcdevkit copilot ask "How do I deploy an ERC-20 contract on Arc testnet?"
 
 # Streaming output (token by token)
-arc ask --stream "Write a USDC payment contract in Solidity"
+arcdevkit copilot ask "Write a USDC payment contract in Solidity" --stream
 ```
 
 ### Python
@@ -310,16 +310,16 @@ Fetches transaction data via RPC, decodes the error/result, and uses the Dev Cop
 
 ```bash
 # Analyze a transaction
-arc debug tx 0xYourTxHashHere
+arcdevkit debug tx 0xYourTxHashHere
 
 # Load an ABI to decode input data
-arc debug tx 0xYourTxHash --abi ./MyContract.abi.json
+arcdevkit debug tx 0xYourTxHash --abi ./MyContract.abi.json
 
 # Batch — analyze a file of hashes (one per line)
-arc debug batch hashes.txt
+arcdevkit debug batch hashes.txt
 
-# View recent analysis history
-arc history
+# View recent operation history
+arcdevkit history
 ```
 
 ```python
@@ -356,10 +356,13 @@ Snapshot a wallet's complete state and activity on Arc, with AI commentary.
 
 ```bash
 # Analyze a single wallet
-arc portfolio analyze 0xYourWalletAddress
+arcdevkit portfolio analyze 0xYourWalletAddress
+
+# Show saved balance history
+arcdevkit portfolio history 0xYourWalletAddress
 
 # Generate a consolidated report for multiple wallets
-arc portfolio report wallets.json
+arcdevkit portfolio report wallets.json
 ```
 
 ```python
@@ -554,54 +557,77 @@ The `docker-compose.yml` mounts your `.env` and runs the API on port 8000 with a
 
 ## CLI Reference
 
-Arc DevKit provides two CLI entry points:
+The primary entry point is `arcdevkit`, with commands grouped by domain.
 
-| Command | Entry Point |
-|---|---|
-| `arc` | Flat, friendly commands for day-to-day use |
-| `arcdevkit` | Grouped subcommand style |
+### Setup
+
+```bash
+arcdevkit init                              # interactive .env wizard
+arcdevkit status                            # check testnet connection + block info
+```
+
+### Config — manage `.env`
+
+```bash
+arcdevkit config list                       # show all variables
+arcdevkit config get ANTHROPIC_API_KEY      # read a specific variable
+arcdevkit config set ARC_RPC_URL https://...# write a variable
+```
+
+### Copilot — AI assistant
 
-### `arc` — quick commands
+```bash
+arcdevkit copilot ask "What is Malachite consensus?"
+arcdevkit copilot ask "Write a USDC vault" --stream   # token-by-token streaming
+arcdevkit copilot ask "..." --json                    # output as JSON
+```
+
+### Agent — wallet & payments
 
 ```bash
-# Setup
-arc init                                 # guided .env wizard
-arc status                               # testnet connection + block info
-arc config list                          # show all env vars
-arc config get ANTHROPIC_API_KEY         # read a specific var
-arc config set ARC_RPC_URL https://...   # write a var
+arcdevkit agent create-wallet               # generate new EVM wallet
+arcdevkit agent balance 0xAddress...        # check wallet balance
+arcdevkit agent status                      # network info (block, chain ID, gas)
+arcdevkit agent pay 0xDest... 5.0           # sign-only (safe default)
+arcdevkit agent pay 0xDest... 5.0 --send    # sign and broadcast
+arcdevkit agent pay 0xDest... 5.0 --send --key 0xPrivKey...
+arcdevkit agent monitor 0xWallet...         # watch balance changes
+arcdevkit agent monitor 0xWallet... --interval 5 --max 50
+```
 
-# Wallet
-arc wallet create                        # generate new wallet
-arc wallet balance --address 0x...       # check balance
+### Debug — transaction analysis
 
-# AI Copilot
-arc ask "What is Malachite consensus?"
-arc ask --stream "Write a USDC vault"
-arc ask --json "..."                     # output as JSON
+```bash
+arcdevkit debug tx 0xHash...                # analyze a transaction with AI
+arcdevkit debug tx 0xHash... --json
+arcdevkit debug estimate 0xDest... 10.0     # estimate gas cost
+arcdevkit debug estimate 0xDest... 10.0 --from 0xSender...
+arcdevkit debug batch hashes.txt            # analyze multiple txs from a file
+arcdevkit debug batch hashes.txt --abi MyContract.json
+```
 
-# Transaction debugging
-arc debug tx 0xHash
-arc debug tx 0xHash --abi Contract.json
-arc history                              # list recent debug sessions
+### Portfolio — wallet analytics
 
-# Portfolio
-arc portfolio analyze 0xWallet
-arc portfolio report wallets.json
+```bash
+arcdevkit portfolio analyze 0xWallet...     # balances, txs, AI insights
+arcdevkit portfolio analyze 0xWallet... --no-ai --blocks 500
+arcdevkit portfolio history 0xWallet...     # saved balance snapshots
+arcdevkit portfolio report wallets.json     # consolidated multi-wallet report
+```
+
+### Codegen — script generation
 
-# Flags (work on every command)
-arc --json <cmd>                         # machine-readable JSON output
-arc -v <cmd>                             # verbose (DEBUG logging)
+```bash
+arcdevkit codegen "monitor a wallet and alert when balance drops"
+arcdevkit codegen "deploy an ERC-20 with a mint function" --out ./scripts
+arcdevkit codegen "..." --no-save           # print only, don't save to disk
 ```
 
-### `arcdevkit` — grouped style
+### History — operation log
 
 ```bash
-arcdevkit status
-arcdevkit copilot ask "..."
-arcdevkit agent wallet create
-arcdevkit agent pay --to 0x... --amount 10
-arcdevkit debug tx 0xHash
+arcdevkit history                           # last 10 CLI operations
+arcdevkit history --limit 25 --json
 ```
 
 ---

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit/__init__.py

@@ -1,6 +1,7 @@
 """Arc DevKit — Developer tools for the Arc blockchain by Circle."""
 
-from importlib.metadata import PackageNotFoundError, version as _version
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _version
 
 try:
     __version__ = _version("arc-devkit")

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit/agents/async_monitor.py

@@ -3,7 +3,7 @@
 import asyncio
 import json
 import logging
-from collections.abc import AsyncIterator, Callable, Coroutine
+from collections.abc import AsyncIterator, Callable
 from pathlib import Path
 from typing import Any, cast
 
@@ -295,7 +295,7 @@ class AsyncMonitorAgent(AsyncBaseAgent):
                     break
                 try:
                     event = await asyncio.wait_for(queue.get(), timeout=1.0)
-                except asyncio.TimeoutError:
+                except TimeoutError:
                     continue  # re-check task.done() on next iteration
                 yield event
                 count += 1

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit/agents/payment_agent.py

@@ -77,7 +77,7 @@ class PaymentAgent(BaseAgent):
 
     def _build_usdc_signed_tx(self, to: str, amount: Decimal) -> tuple:
         """Build and sign a USDC ERC-20 transfer tx; return (signed, gas_limit)."""
-        from arc_devkit.usdc.token import _ERC20_ABI, USDC_MULTIPLIER, USDC_ARC_TESTNET_ADDRESS
+        from arc_devkit.usdc.token import _ERC20_ABI, USDC_ARC_TESTNET_ADDRESS, USDC_MULTIPLIER
 
         usdc_address = Web3.to_checksum_address(USDC_ARC_TESTNET_ADDRESS)
         contract = self._w3.eth.contract(address=usdc_address, abi=_ERC20_ABI)

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit/analytics/portfolio.py

@@ -3,7 +3,7 @@
 import json
 import logging
 from dataclasses import dataclass
-from datetime import datetime, timezone
+from datetime import UTC, datetime
 from decimal import Decimal
 from pathlib import Path
 from typing import Any, Literal
@@ -151,7 +151,7 @@ class PortfolioAnalyzer:
         history_file = store / f"{safe_addr}.jsonl"
 
         record = self.to_dict(snapshot)
-        record["timestamp"] = datetime.now(tz=timezone.utc).isoformat()
+        record["timestamp"] = datetime.now(tz=UTC).isoformat()
 
         with history_file.open("a", encoding="utf-8") as f:
             f.write(json.dumps(record) + "\n")

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit/api/routes/agents.py

@@ -180,7 +180,7 @@ async def monitor_ws(
             try:
                 event = await asyncio.wait_for(queue.get(), timeout=1.0)
                 await websocket.send_json(event)
-            except asyncio.TimeoutError:
+            except TimeoutError:
                 # Send a heartbeat ping to detect dead connections
                 try:
                     await websocket.send_json({"event_type": "ping"})

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit/cli/commands/debug.py

@@ -74,6 +74,27 @@ def tx(
         )
 
 
+@app.command()
+def batch(
+    hashes_file: str = typer.Argument(
+        ..., help="Text file with one tx hash per line (or JSON array)."
+    ),
+    abi_path: str = typer.Option(
+        "", "--abi", "-a", help="Path to ABI JSON file applied to all transactions."
+    ),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON."),
+) -> None:
+    """Analyze multiple transactions from a file (one hash per line or JSON array).
+
+    Examples:
+      arcdevkit debug batch hashes.txt
+      arcdevkit debug batch hashes.txt --abi MyContract.json --json
+    """
+    from arc_devkit.cli.flat import debug_batch as _run_batch
+
+    _run_batch(hashes_file=hashes_file, abi_path=abi_path, json_output=json_output, verbose=False)
+
+
 @app.command()
 def estimate(
     to: str = typer.Argument(..., help="Recipient EVM address."),

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit/cli/main.py

@@ -6,6 +6,7 @@ from rich.panel import Panel
 
 from arc_devkit import __version__
 from arc_devkit.cli.commands import agent, copilot, debug
+from arc_devkit.cli.flat import config_app, portfolio_app
 
 # Main Typer application
 app = typer.Typer(
@@ -20,6 +21,8 @@ app = typer.Typer(
 app.add_typer(copilot.app, name="copilot", help="AI assistant for Arc development.")
 app.add_typer(agent.app, name="agent", help="Wallet and agent management.")
 app.add_typer(debug.app, name="debug", help="Transaction analysis and debugging.")
+app.add_typer(config_app, name="config", help="Manage Arc DevKit settings via .env.")
+app.add_typer(portfolio_app, name="portfolio", help="Wallet portfolio analysis on Arc.")
 
 console = Console()
 
@@ -56,6 +59,30 @@ def init() -> None:
     _run_init()
 
 
+@app.command()
+def history(
+    limit: int = typer.Option(10, "--limit", "-n", help="Number of records to display."),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON."),
+) -> None:
+    """List recent CLI operations saved in ~/.arc_devkit/history.json."""
+    from arc_devkit.cli.flat import history as _run_history
+
+    _run_history(limit=limit, json_output=json_output)
+
+
+@app.command()
+def codegen(
+    topic: str = typer.Argument(..., help="Describe what the script should do."),
+    save: bool = typer.Option(True, "--save/--no-save", help="Save to generated/<timestamp>.py"),
+    output_dir: str = typer.Option(".", "--out", "-o", help="Output directory (default: current)."),
+    verbose: bool = typer.Option(False, "-v", "--verbose", help="Enable debug logs."),
+) -> None:
+    """Generate a Python script for Arc from a natural language description."""
+    from arc_devkit.cli.flat import codegen as _run_codegen
+
+    _run_codegen(topic=topic, save=save, output_dir=output_dir, verbose=verbose)
+
+
 @app.command()
 def status() -> None:
     """Check the connection to Arc testnet and display network information."""

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit/deploy/deployer.py

@@ -1,7 +1,7 @@
 """Contract compilation and deployment for Arc DevKit."""
 
 import logging
-from dataclasses import dataclass, field
+from dataclasses import dataclass
 from decimal import Decimal
 from pathlib import Path
 from typing import Any

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/arc_devkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arc-devkit
-Version: 0.4.3
+Version: 0.4.5
 Summary: Plataforma open source de ferramentas para desenvolvedores da Arc blockchain (Circle)
 Author-email: Jeielsantosdev <jeielsantos.ti@gmail.com>
 License-Expression: MIT
@@ -88,10 +88,10 @@ cp .env.example .env
 #    ARC_PRIVATE_KEY    — optional; needed to send transactions
 
 # 3. Guided interactive setup (creates .env from scratch)
-arc init
+arcdevkit init
 
 # 4. Verify connection
-arc status
+arcdevkit status
 ```
 
 ```
@@ -130,10 +130,10 @@ AI assistant powered by Claude Sonnet, with Arc blockchain context embedded in t
 
 ```bash
 # Ask a question
-arc ask "How do I deploy an ERC-20 contract on Arc testnet?"
+arcdevkit copilot ask "How do I deploy an ERC-20 contract on Arc testnet?"
 
 # Streaming output (token by token)
-arc ask --stream "Write a USDC payment contract in Solidity"
+arcdevkit copilot ask "Write a USDC payment contract in Solidity" --stream
 ```
 
 ### Python
@@ -349,16 +349,16 @@ Fetches transaction data via RPC, decodes the error/result, and uses the Dev Cop
 
 ```bash
 # Analyze a transaction
-arc debug tx 0xYourTxHashHere
+arcdevkit debug tx 0xYourTxHashHere
 
 # Load an ABI to decode input data
-arc debug tx 0xYourTxHash --abi ./MyContract.abi.json
+arcdevkit debug tx 0xYourTxHash --abi ./MyContract.abi.json
 
 # Batch — analyze a file of hashes (one per line)
-arc debug batch hashes.txt
+arcdevkit debug batch hashes.txt
 
-# View recent analysis history
-arc history
+# View recent operation history
+arcdevkit history
 ```
 
 ```python
@@ -395,10 +395,13 @@ Snapshot a wallet's complete state and activity on Arc, with AI commentary.
 
 ```bash
 # Analyze a single wallet
-arc portfolio analyze 0xYourWalletAddress
+arcdevkit portfolio analyze 0xYourWalletAddress
+
+# Show saved balance history
+arcdevkit portfolio history 0xYourWalletAddress
 
 # Generate a consolidated report for multiple wallets
-arc portfolio report wallets.json
+arcdevkit portfolio report wallets.json
 ```
 
 ```python
@@ -593,54 +596,77 @@ The `docker-compose.yml` mounts your `.env` and runs the API on port 8000 with a
 
 ## CLI Reference
 
-Arc DevKit provides two CLI entry points:
+The primary entry point is `arcdevkit`, with commands grouped by domain.
 
-| Command | Entry Point |
-|---|---|
-| `arc` | Flat, friendly commands for day-to-day use |
-| `arcdevkit` | Grouped subcommand style |
+### Setup
+
+```bash
+arcdevkit init                              # interactive .env wizard
+arcdevkit status                            # check testnet connection + block info
+```
+
+### Config — manage `.env`
+
+```bash
+arcdevkit config list                       # show all variables
+arcdevkit config get ANTHROPIC_API_KEY      # read a specific variable
+arcdevkit config set ARC_RPC_URL https://...# write a variable
+```
+
+### Copilot — AI assistant
 
-### `arc` — quick commands
+```bash
+arcdevkit copilot ask "What is Malachite consensus?"
+arcdevkit copilot ask "Write a USDC vault" --stream   # token-by-token streaming
+arcdevkit copilot ask "..." --json                    # output as JSON
+```
+
+### Agent — wallet & payments
 
 ```bash
-# Setup
-arc init                                 # guided .env wizard
-arc status                               # testnet connection + block info
-arc config list                          # show all env vars
-arc config get ANTHROPIC_API_KEY         # read a specific var
-arc config set ARC_RPC_URL https://...   # write a var
+arcdevkit agent create-wallet               # generate new EVM wallet
+arcdevkit agent balance 0xAddress...        # check wallet balance
+arcdevkit agent status                      # network info (block, chain ID, gas)
+arcdevkit agent pay 0xDest... 5.0           # sign-only (safe default)
+arcdevkit agent pay 0xDest... 5.0 --send    # sign and broadcast
+arcdevkit agent pay 0xDest... 5.0 --send --key 0xPrivKey...
+arcdevkit agent monitor 0xWallet...         # watch balance changes
+arcdevkit agent monitor 0xWallet... --interval 5 --max 50
+```
 
-# Wallet
-arc wallet create                        # generate new wallet
-arc wallet balance --address 0x...       # check balance
+### Debug — transaction analysis
 
-# AI Copilot
-arc ask "What is Malachite consensus?"
-arc ask --stream "Write a USDC vault"
-arc ask --json "..."                     # output as JSON
+```bash
+arcdevkit debug tx 0xHash...                # analyze a transaction with AI
+arcdevkit debug tx 0xHash... --json
+arcdevkit debug estimate 0xDest... 10.0     # estimate gas cost
+arcdevkit debug estimate 0xDest... 10.0 --from 0xSender...
+arcdevkit debug batch hashes.txt            # analyze multiple txs from a file
+arcdevkit debug batch hashes.txt --abi MyContract.json
+```
 
-# Transaction debugging
-arc debug tx 0xHash
-arc debug tx 0xHash --abi Contract.json
-arc history                              # list recent debug sessions
+### Portfolio — wallet analytics
 
-# Portfolio
-arc portfolio analyze 0xWallet
-arc portfolio report wallets.json
+```bash
+arcdevkit portfolio analyze 0xWallet...     # balances, txs, AI insights
+arcdevkit portfolio analyze 0xWallet... --no-ai --blocks 500
+arcdevkit portfolio history 0xWallet...     # saved balance snapshots
+arcdevkit portfolio report wallets.json     # consolidated multi-wallet report
+```
+
+### Codegen — script generation
 
-# Flags (work on every command)
-arc --json <cmd>                         # machine-readable JSON output
-arc -v <cmd>                             # verbose (DEBUG logging)
+```bash
+arcdevkit codegen "monitor a wallet and alert when balance drops"
+arcdevkit codegen "deploy an ERC-20 with a mint function" --out ./scripts
+arcdevkit codegen "..." --no-save           # print only, don't save to disk
 ```
 
-### `arcdevkit` — grouped style
+### History — operation log
 
 ```bash
-arcdevkit status
-arcdevkit copilot ask "..."
-arcdevkit agent wallet create
-arcdevkit agent pay --to 0x... --amount 10
-arcdevkit debug tx 0xHash
+arcdevkit history                           # last 10 CLI operations
+arcdevkit history --limit 25 --json
 ```
 
 ---

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "arc-devkit"
-version = "0.4.3"
+version = "0.4.5"
 description = "Plataforma open source de ferramentas para desenvolvedores da Arc blockchain (Circle)"
 readme = "README.md"
 license = "MIT"

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_agents.py

@@ -94,7 +94,6 @@ class TestPaymentAgent:
         assert result == 21_000
 
     def test_wait_for_receipt_returns_receipt(self, mock_web3):
-        import time
 
         receipt = {"status": 1, "gasUsed": 21_000}
         mock_web3.eth.get_transaction_receipt.return_value = receipt

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_analytics.py

@@ -4,9 +4,6 @@ import json
 from decimal import Decimal
 from unittest.mock import MagicMock, patch
 
-import pytest
-
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
@@ -358,7 +355,7 @@ class TestPortfolioCLI:
 
 class TestBalanceHistory:
     def _make_snapshot(self, address="0x" + "a" * 40, tx_count=3):
-        from arc_devkit.analytics.portfolio import ActivityLevel, PortfolioSnapshot
+        from arc_devkit.analytics.portfolio import PortfolioSnapshot
 
         return PortfolioSnapshot(
             address=address,
@@ -390,7 +387,7 @@ class TestBalanceHistory:
         analyzer.save_snapshot(snap, history_dir=tmp_path)
         analyzer.save_snapshot(snap, history_dir=tmp_path)
         path = tmp_path / f"{snap.address.lower()}.jsonl"
-        lines = [l for l in path.read_text().splitlines() if l.strip()]
+        lines = [line for line in path.read_text().splitlines() if line.strip()]
         assert len(lines) == 2
 
     def test_save_snapshot_includes_timestamp(self, tmp_path):

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_async_agents.py

@@ -1,11 +1,9 @@
 """Tests for AsyncBaseAgent, AsyncMonitorAgent, and WebSocket endpoint."""
 
-import asyncio
 from unittest.mock import AsyncMock, MagicMock, patch
 
 import pytest
 
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
@@ -235,9 +233,10 @@ async def test_async_monitor_event_stream_yields():
 
 def test_websocket_monitor_accepts_connection():
     """WebSocket /agents/monitor/{address} must accept and send heartbeat pings."""
-    from arc_devkit.api.main import app
     from fastapi.testclient import TestClient
 
+    from arc_devkit.api.main import app
+
     with patch("arc_devkit.core.connection.get_web3", return_value=_mock_w3()), \
          patch("arc_devkit.agents.async_monitor.AsyncMonitorAgent.execute", new_callable=AsyncMock) as mock_exec:
         mock_exec.return_value = {"status": "done", "iterations": 0}
@@ -345,7 +344,7 @@ async def test_async_monitor_webhook_called(tmp_path, respx_mock=None):
 
 
 def test_copilot_offline_ask_returns_mock(mock_anthropic):
-    from arc_devkit.copilot.agent import DevCopilot, _OFFLINE_RESPONSE
+    from arc_devkit.copilot.agent import _OFFLINE_RESPONSE, DevCopilot
 
     copilot = DevCopilot(offline=True)
     assert copilot.ask("What is Arc?") == _OFFLINE_RESPONSE
@@ -353,7 +352,7 @@ def test_copilot_offline_ask_returns_mock(mock_anthropic):
 
 
 def test_copilot_offline_stream_returns_mock(mock_anthropic):
-    from arc_devkit.copilot.agent import DevCopilot, _OFFLINE_RESPONSE
+    from arc_devkit.copilot.agent import _OFFLINE_RESPONSE, DevCopilot
 
     copilot = DevCopilot(offline=True)
     result = "".join(copilot.ask_stream("What is Arc?"))

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_cli.py

@@ -1,12 +1,9 @@
 """Unit tests for arc_devkit.cli.flat — arc CLI commands."""
 
 import json
-import tempfile
 from decimal import Decimal
-from pathlib import Path
-from unittest.mock import MagicMock, patch
+from unittest.mock import patch
 
-import pytest
 from typer.testing import CliRunner
 
 from arc_devkit.cli.flat import app
@@ -172,7 +169,6 @@ class TestWallet:
 
 class TestConfig:
     def test_config_set_and_get(self, tmp_path, monkeypatch):
-        env_file = tmp_path / ".env"
         monkeypatch.chdir(tmp_path)
 
         # set

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_contracts.py

@@ -3,11 +3,10 @@
 import json
 import tempfile
 from pathlib import Path
-from unittest.mock import MagicMock, patch
+from unittest.mock import MagicMock
 
 import pytest
 
-
 # ---------------------------------------------------------------------------
 # load_abi
 # ---------------------------------------------------------------------------
@@ -79,9 +78,10 @@ class TestCallView:
         assert result == "USDC"
 
     def test_checksum_applied_to_address(self):
-        from arc_devkit.contracts.loader import call_view
         from web3 import Web3
 
+        from arc_devkit.contracts.loader import call_view
+
         w3 = self._w3_with_result(0)
         abi: list = []
         call_view(abi, "0x" + "a" * 40, "balanceOf", w3=w3)

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_debugger.py

@@ -2,12 +2,8 @@
 
 import json
 import tempfile
-from decimal import Decimal
 from unittest.mock import MagicMock, patch
 
-import pytest
-
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
@@ -115,9 +111,10 @@ class TestDecodeRevertBytes:
         assert "42" in result
 
     def test_custom_error_no_args(self):
-        from arc_devkit.debugger.tx_analyzer import decode_revert_bytes
         from web3 import Web3
 
+        from arc_devkit.debugger.tx_analyzer import decode_revert_bytes
+
         abi = [{"type": "error", "name": "Unauthorized", "inputs": []}]
         selector = Web3.keccak(text="Unauthorized()")[:4]
         result = decode_revert_bytes(selector, abi=abi)

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_deploy.py

@@ -1,6 +1,5 @@
 """Unit tests for arc_devkit.deploy.deployer.ContractDeployer."""
 
-from decimal import Decimal
 from unittest.mock import MagicMock, patch
 
 import pytest

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_events.py

@@ -100,7 +100,7 @@ class TestEventListenerPoll:
         log = _make_log(block_number=101)
         w3 = _make_w3(current_block=101, logs=[log])
         el = EventListener(w3=w3, from_block=100)
-        events = el.poll()
+        el.poll()
         w3.eth.get_logs.assert_called_once()
         call_params = w3.eth.get_logs.call_args[0][0]
         assert call_params["fromBlock"] == 100
@@ -182,7 +182,8 @@ class TestEventListenerPoll:
 
         received: list = []
         bad_cb = MagicMock(side_effect=RuntimeError("boom"))
-        good_cb = lambda e: received.append(e)
+        def good_cb(e):
+            received.append(e)
 
         fake_event = {"event": "Transfer", "address": "0x", "args": {}, "block_number": 1, "tx_hash": None, "log_index": 0}
         with patch.object(EventListener, "_decode_log", return_value=fake_event):

{arc_devkit-0.4.3 → arc_devkit-0.4.5}/tests/test_usdc.py

@@ -1,7 +1,7 @@
 """Unit tests for arc_devkit.usdc.token.USDCToken."""
 
 from decimal import Decimal
-from unittest.mock import MagicMock, patch
+from unittest.mock import MagicMock
 
 # Standard Hardhat test private key — valid secp256k1 key safe for tests
 _PRIVKEY = "0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80"
@@ -34,7 +34,7 @@ def _make_contract_w3(balance_atomic: int = 0) -> MagicMock:
 
 class TestUSDCToken:
     def _token(self, w3=None, balance_atomic: int = 0, contract_address: str | None = None):
-        from arc_devkit.usdc.token import USDC_ARC_TESTNET_ADDRESS, USDCToken
+        from arc_devkit.usdc.token import USDCToken
 
         addr = contract_address or "0x" + "c" * 40
         w3 = w3 or _make_contract_w3(balance_atomic)
@@ -128,9 +128,10 @@ class TestUSDCToken:
     # --- contract_address property ---
 
     def test_contract_address_property(self):
-        from arc_devkit.usdc.token import USDCToken
         from web3 import Web3
 
+        from arc_devkit.usdc.token import USDCToken
+
         addr = "0x" + "d" * 40
         token = USDCToken(contract_address=addr, w3=_make_contract_w3())
         assert token.contract_address == Web3.to_checksum_address(addr)