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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arc-devkit
-Version: 0.4.3
+Version: 0.4.4
 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.4}/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.4}/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.4}/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.4}/arc_devkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: arc-devkit
-Version: 0.4.3
+Version: 0.4.4
 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.4}/pyproject.toml

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