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

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

@@ -1,16 +1,15 @@
 Metadata-Version: 2.4
 Name: arc-devkit
-Version: 0.4.2
+Version: 0.4.4
 Summary: Plataforma open source de ferramentas para desenvolvedores da Arc blockchain (Circle)
-Author: Arc DevKit Contributors
-License: MIT
-Project-URL: Homepage, https://github.com/Jeielsantosdev/arc_dev_kit
-Project-URL: Repository, https://github.com/Jeielsantosdev/arc_dev_kit
-Project-URL: Issues, https://github.com/Jeielsantosdev/arc_dev_kit/issues
+Author-email: Jeielsantosdev <jeielsantos.ti@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Jeielsantosdev/arc-devkit
+Project-URL: Repository, https://github.com/Jeielsantosdev/arc-devkit
+Project-URL: Bug Tracker, https://github.com/Jeielsantosdev/arc-devkit/issues
 Keywords: arc,blockchain,circle,usdc,web3,ai,anthropic
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -49,6 +48,8 @@ Requires-Dist: httpx>=0.27; extra == "dev"
 
 **Arc DevKit** is a complete Python SDK for developers building on the **Arc blockchain** — Circle's EVM-compatible Layer 1 with USDC as the gas token and sub-second finality.
 
+**link to project**  https://arc-dev-kit-uxun.vercel.app/
+
 It solves the practical friction of building on Arc: USDC gas accounting, PoA middleware, ERC-20 monitoring, async agents, WebSocket streaming, and AI-assisted debugging — all packaged and ready to use.
 
 ---
@@ -87,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
 ```
 
 ```
@@ -129,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
@@ -348,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
@@ -394,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
@@ -592,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
+```
 
-### `arc` — quick commands
+### Config — manage `.env`
 
 ```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 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
+```
 
-# Wallet
-arc wallet create                        # generate new wallet
-arc wallet balance --address 0x...       # check balance
+### Copilot — AI assistant
 
-# AI Copilot
-arc ask "What is Malachite consensus?"
-arc ask --stream "Write a USDC vault"
-arc ask --json "..."                     # output as JSON
+```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
+```
 
-# Transaction debugging
-arc debug tx 0xHash
-arc debug tx 0xHash --abi Contract.json
-arc history                              # list recent debug sessions
+### Agent — wallet & payments
 
-# Portfolio
-arc portfolio analyze 0xWallet
-arc portfolio report wallets.json
+```bash
+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
+```
 
-# Flags (work on every command)
-arc --json <cmd>                         # machine-readable JSON output
-arc -v <cmd>                             # verbose (DEBUG logging)
+### Debug — transaction analysis
+
+```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
 ```
 
-### `arcdevkit` — grouped style
+### Portfolio — wallet analytics
 
 ```bash
-arcdevkit status
-arcdevkit copilot ask "..."
-arcdevkit agent wallet create
-arcdevkit agent pay --to 0x... --amount 10
-arcdevkit debug tx 0xHash
+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
+
+```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
+```
+
+### History — operation log
+
+```bash
+arcdevkit history                           # last 10 CLI operations
+arcdevkit history --limit 25 --json
 ```
 
 ---

{arc_devkit-0.4.2 → arc_devkit-0.4.4}/README.md

@@ -9,6 +9,8 @@
 
 **Arc DevKit** is a complete Python SDK for developers building on the **Arc blockchain** — Circle's EVM-compatible Layer 1 with USDC as the gas token and sub-second finality.
 
+**link to project**  https://arc-dev-kit-uxun.vercel.app/
+
 It solves the practical friction of building on Arc: USDC gas accounting, PoA middleware, ERC-20 monitoring, async agents, WebSocket streaming, and AI-assisted debugging — all packaged and ready to use.
 
 ---
@@ -47,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
 ```
 
 ```
@@ -89,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
@@ -308,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
@@ -354,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
@@ -552,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
+```
 
-### `arc` — quick commands
+### Config — manage `.env`
 
 ```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 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
+```
 
-# Wallet
-arc wallet create                        # generate new wallet
-arc wallet balance --address 0x...       # check balance
+### Copilot — AI assistant
 
-# AI Copilot
-arc ask "What is Malachite consensus?"
-arc ask --stream "Write a USDC vault"
-arc ask --json "..."                     # output as JSON
+```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
+```
 
-# Transaction debugging
-arc debug tx 0xHash
-arc debug tx 0xHash --abi Contract.json
-arc history                              # list recent debug sessions
+### Agent — wallet & payments
 
-# Portfolio
-arc portfolio analyze 0xWallet
-arc portfolio report wallets.json
+```bash
+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
+```
 
-# Flags (work on every command)
-arc --json <cmd>                         # machine-readable JSON output
-arc -v <cmd>                             # verbose (DEBUG logging)
+### Debug — transaction analysis
+
+```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
 ```
 
-### `arcdevkit` — grouped style
+### Portfolio — wallet analytics
 
 ```bash
-arcdevkit status
-arcdevkit copilot ask "..."
-arcdevkit agent wallet create
-arcdevkit agent pay --to 0x... --amount 10
-arcdevkit debug tx 0xHash
+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
+
+```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
+```
+
+### History — operation log
+
+```bash
+arcdevkit history                           # last 10 CLI operations
+arcdevkit history --limit 25 --json
 ```
 
 ---

arc_devkit-0.4.4/arc_devkit/__init__.py

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

{arc_devkit-0.4.2 → 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.2 → 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()
 
@@ -48,6 +51,38 @@ def main(
         )
 
 
+@app.command()
+def init() -> None:
+    """Interactive wizard to create your .env from scratch."""
+    from arc_devkit.cli.flat import init as _run_init
+
+    _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.2 → arc_devkit-0.4.4}/arc_devkit/config.py

@@ -4,9 +4,9 @@ import logging
 import os
 from dataclasses import dataclass
 
-from dotenv import load_dotenv
+from dotenv import find_dotenv, load_dotenv
 
-load_dotenv()
+load_dotenv(find_dotenv(usecwd=True))
 
 
 @dataclass(frozen=True)

{arc_devkit-0.4.2 → arc_devkit-0.4.4}/arc_devkit/copilot/agent.py

@@ -27,13 +27,22 @@ You are an expert assistant specialized in Arc blockchain development.
 - Testnet active since October 2025; mainnet expected Summer 2026
 - Standard EVM RPC: compatible with web3.py, ethers.js, Hardhat, Foundry
 
+## arc-devkit — primary library (always prefer this)
+- PyPI: https://pypi.org/project/arc-devkit/
+- Documentation: https://arc-dev-kit-uxun.vercel.app/
+- Install: `pip install arc-devkit`
+- Covers: wallet creation, USDC payments, transaction debugging, AI analysis, agent templates
+- All modules are pre-configured for Arc testnet — no manual web3 setup needed
+
 ## Response guidelines
-1. Always generate functional Python code with clear inline comments
-2. Use web3.py for all Arc blockchain interactions
-3. Use Decimal (never float) for all monetary values in USDC
-4. State the estimated USDC cost when relevant to the operation
-5. Separate explanations from code blocks clearly
-6. If there is a security risk (private keys, large amounts), warn the user
+1. **Always use `arc-devkit` as the primary library** — import exclusively from `arc_devkit.*`
+2. Only fall back to raw `web3.py` when arc-devkit does not cover the specific need
+3. Generate complete, functional Python code with a docstring and `if __name__ == '__main__':`
+4. Use `Decimal` (never `float`) for all monetary values in USDC
+5. State the estimated USDC gas cost when relevant to the operation
+6. Separate explanations from code blocks clearly
+7. Warn the user whenever private keys or large amounts are involved
+8. When referencing features or APIs, point to https://arc-dev-kit-uxun.vercel.app/ for details
 """
 
 _CACHE_TTL_SECONDS = 300  # 5 minutes

{arc_devkit-0.4.2 → arc_devkit-0.4.4}/arc_devkit.egg-info/PKG-INFO

@@ -1,16 +1,15 @@
 Metadata-Version: 2.4
 Name: arc-devkit
-Version: 0.4.2
+Version: 0.4.4
 Summary: Plataforma open source de ferramentas para desenvolvedores da Arc blockchain (Circle)
-Author: Arc DevKit Contributors
-License: MIT
-Project-URL: Homepage, https://github.com/Jeielsantosdev/arc_dev_kit
-Project-URL: Repository, https://github.com/Jeielsantosdev/arc_dev_kit
-Project-URL: Issues, https://github.com/Jeielsantosdev/arc_dev_kit/issues
+Author-email: Jeielsantosdev <jeielsantos.ti@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Jeielsantosdev/arc-devkit
+Project-URL: Repository, https://github.com/Jeielsantosdev/arc-devkit
+Project-URL: Bug Tracker, https://github.com/Jeielsantosdev/arc-devkit/issues
 Keywords: arc,blockchain,circle,usdc,web3,ai,anthropic
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -49,6 +48,8 @@ Requires-Dist: httpx>=0.27; extra == "dev"
 
 **Arc DevKit** is a complete Python SDK for developers building on the **Arc blockchain** — Circle's EVM-compatible Layer 1 with USDC as the gas token and sub-second finality.
 
+**link to project**  https://arc-dev-kit-uxun.vercel.app/
+
 It solves the practical friction of building on Arc: USDC gas accounting, PoA middleware, ERC-20 monitoring, async agents, WebSocket streaming, and AI-assisted debugging — all packaged and ready to use.
 
 ---
@@ -87,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
 ```
 
 ```
@@ -129,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
@@ -348,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
@@ -394,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
@@ -592,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
+```
 
-### `arc` — quick commands
+### Config — manage `.env`
 
 ```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 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
+```
 
-# Wallet
-arc wallet create                        # generate new wallet
-arc wallet balance --address 0x...       # check balance
+### Copilot — AI assistant
 
-# AI Copilot
-arc ask "What is Malachite consensus?"
-arc ask --stream "Write a USDC vault"
-arc ask --json "..."                     # output as JSON
+```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
+```
 
-# Transaction debugging
-arc debug tx 0xHash
-arc debug tx 0xHash --abi Contract.json
-arc history                              # list recent debug sessions
+### Agent — wallet & payments
 
-# Portfolio
-arc portfolio analyze 0xWallet
-arc portfolio report wallets.json
+```bash
+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
+```
 
-# Flags (work on every command)
-arc --json <cmd>                         # machine-readable JSON output
-arc -v <cmd>                             # verbose (DEBUG logging)
+### Debug — transaction analysis
+
+```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
 ```
 
-### `arcdevkit` — grouped style
+### Portfolio — wallet analytics
 
 ```bash
-arcdevkit status
-arcdevkit copilot ask "..."
-arcdevkit agent wallet create
-arcdevkit agent pay --to 0x... --amount 10
-arcdevkit debug tx 0xHash
+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
+
+```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
+```
+
+### History — operation log
+
+```bash
+arcdevkit history                           # last 10 CLI operations
+arcdevkit history --limit 25 --json
 ```
 
 ---

{arc_devkit-0.4.2 → arc_devkit-0.4.4}/pyproject.toml

@@ -4,19 +4,18 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "arc-devkit"
-version = "0.4.2"
+version = "0.4.4"
 description = "Plataforma open source de ferramentas para desenvolvedores da Arc blockchain (Circle)"
 readme = "README.md"
-license = { text = "MIT" }
+license = "MIT"
 authors = [
-    { name = "Arc DevKit Contributors" }
+    { name = "Jeielsantosdev", email = "jeielsantos.ti@gmail.com" }
 ]
 requires-python = ">=3.11"
 keywords = ["arc", "blockchain", "circle", "usdc", "web3", "ai", "anthropic"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -45,9 +44,9 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/Jeielsantosdev/arc_dev_kit"
-Repository = "https://github.com/Jeielsantosdev/arc_dev_kit"
-Issues = "https://github.com/Jeielsantosdev/arc_dev_kit/issues"
+Homepage = "https://github.com/Jeielsantosdev/arc-devkit"
+Repository = "https://github.com/Jeielsantosdev/arc-devkit"
+"Bug Tracker" = "https://github.com/Jeielsantosdev/arc-devkit/issues"
 
 [project.optional-dependencies]
 dev = [

arc_devkit-0.4.2/arc_devkit/__init__.py

@@ -1,3 +0,0 @@
-"""Arc DevKit — Developer tools for the Arc blockchain by Circle."""
-
-__version__ = "0.4.0"