arc-devkit 0.4.2__py3-none-any.whl → 0.4.4__py3-none-any.whl

arc_devkit/__init__.py

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

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/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/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/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.dist-info → arc_devkit-0.4.4.dist-info}/METADATA

@@ -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.dist-info → arc_devkit-0.4.4.dist-info}/RECORD

@@ -1,5 +1,5 @@
-arc_devkit/__init__.py,sha256=XFDX5mvLfHCS9HcvxdkFg2dvgGWeisCPYSSdlScKXwE,94
-arc_devkit/config.py,sha256=btRtZOmGtUqGmybaCkSM2iTeySKOI9qTYrK045_WDvU,1880
+arc_devkit/__init__.py,sha256=rvVSkUUgL3KnmAPdswMK54rSRnD-pN_p7RMR9Y2yfZU,249
+arc_devkit/config.py,sha256=7KX5xCRYSOPj6o_XWqefhhFJmFXNNHbJ1EEdX1cCf0g,1917
 arc_devkit/agents/__init__.py,sha256=Yo3yOyJXxh7ctPP0XP-Gdl-ptGWDqPGY6My5PVVb2lw,442
 arc_devkit/agents/async_base.py,sha256=286rbRXpBuoAKl14kgeGKIPIRk-k5hcFMI8uclbDDSk,913
 arc_devkit/agents/async_monitor.py,sha256=xkNx6OEbqo3io0W54OPVB8zOpVGpII9-hiptvBX3DBw,11562
@@ -16,15 +16,15 @@ arc_devkit/api/routes/copilot.py,sha256=1jfqE2sMdVwwof4mcLjQHAwvVva47msDtki3WXmO
 arc_devkit/api/routes/debugger.py,sha256=PP88p9POnzvEzu7O8M7DCIaC8CKWgauDgXaRzLdoC9A,2768
 arc_devkit/cli/__init__.py,sha256=HxXvqwve8YcVgcPMtyh1Eh_pEP7OhNG1xV1s4XWyIsQ,67
 arc_devkit/cli/flat.py,sha256=xM7KMsnxyUtg7v4rVmrkbWp3r5NwrL-jDzOVYIY4SrY,39409
-arc_devkit/cli/main.py,sha256=-_KkL6tMLne6mYyb2LMP4ahIzzy4g4FkTA1Pc8En2z0,2467
+arc_devkit/cli/main.py,sha256=HWBQFzxh9CO2Dl-m0pdDkr3LEif4E6NMn7cl51NTIcE,3902
 arc_devkit/cli/commands/__init__.py,sha256=9mV6f6CarhEi8Q0qIiw-JB2TU4UqVqTuvEX9ICyQ13o,34
 arc_devkit/cli/commands/agent.py,sha256=j3pUEPasps4aQgjL6kuWtWE7N9PqtuGlKAE5aAKIGUY,6113
 arc_devkit/cli/commands/copilot.py,sha256=kDv_-7tqSJJ1sYSVYMhqAHOYQPUb9QuCUDHlHM4SrNs,1804
-arc_devkit/cli/commands/debug.py,sha256=PpOxQx8fB1oouwgaEDW6dxER3puBtI7Vj4O_B1hN7vk,3398
+arc_devkit/cli/commands/debug.py,sha256=RD-b7fCho1VhFcGfoPhBIZITaoKneF4MF6Ppg4qkcWQ,4137
 arc_devkit/contracts/__init__.py,sha256=svjHzot5EcNlHdgaVpYNMgyVJDfGEldZUXXZHDOY5xQ,251
 arc_devkit/contracts/loader.py,sha256=528hp2dVPZNOdVYuUiiYlF9GOK4uKbmfKEC99ChgIYQ,4423
 arc_devkit/copilot/__init__.py,sha256=ux9txnF1N7tSNaLVuGuk-7Uqkfe1LSnPwzHcFi5-HRc,151
-arc_devkit/copilot/agent.py,sha256=ooUFz3HoTQMFEmRzHSRjxOMIbn_jY5QbKJUTi6WqK-M,7757
+arc_devkit/copilot/agent.py,sha256=qcDvpSDAXalvlphqIWfojA8jZCUSP2jD9RP_8DNZkGc,8376
 arc_devkit/core/__init__.py,sha256=sxwWfKv3SrvmAYoqqsKGC1lRZsnzSV21zzt-rZCyGSA,64
 arc_devkit/core/connection.py,sha256=aoIrlIUW7oZuy9q-rCS_GsCn6xTiMjSQFYAnWZwU3Pc,1309
 arc_devkit/core/gas.py,sha256=sxdbAfYqTeCGOk_jvjOS-1j7jAFFEBzwwefRB1XBOsY,1956
@@ -37,8 +37,8 @@ arc_devkit/events/__init__.py,sha256=t_t5v1Qfrno-YsE7xWC864RJ61Y4VU5aWhJ5BN0YdLE
 arc_devkit/events/listener.py,sha256=XjIKbh69KC0up3zlf9hgGnEu-X4qQZuoWbDxA3CJ-F0,7066
 arc_devkit/usdc/__init__.py,sha256=xpvdqiMPC3o7x3bHCBwTy3K-ogQWfVjS99jzG4fQQO0,145
 arc_devkit/usdc/token.py,sha256=U-eUh4as8It4R96YsxrSslxHO6ACBNWUqwvxc2GagGs,7609
-arc_devkit-0.4.2.dist-info/METADATA,sha256=0FNSWej50Drbq-o6zNPBgj71sW4LmWch1nlghWvTXqI,23457
-arc_devkit-0.4.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-arc_devkit-0.4.2.dist-info/entry_points.txt,sha256=iriL0KhiF80Y8dlMbHlc3RS2rzWCQctxnSm0Jp_JxjQ,84
-arc_devkit-0.4.2.dist-info/top_level.txt,sha256=_8As_e0w6FWAQptRM9vVTpBaTQmGKjajyiscnqRps-8,11
-arc_devkit-0.4.2.dist-info/RECORD,,
+arc_devkit-0.4.4.dist-info/METADATA,sha256=VbZBMPFGxYC7nBi2HOP-bi2O3mmcX1kmwznl8rWtAuM,24729
+arc_devkit-0.4.4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+arc_devkit-0.4.4.dist-info/entry_points.txt,sha256=iriL0KhiF80Y8dlMbHlc3RS2rzWCQctxnSm0Jp_JxjQ,84
+arc_devkit-0.4.4.dist-info/top_level.txt,sha256=_8As_e0w6FWAQptRM9vVTpBaTQmGKjajyiscnqRps-8,11
+arc_devkit-0.4.4.dist-info/RECORD,,