Metadata-Version: 2.4
Name: arckit-sdk
Version: 0.1.0
Summary: Python SDK for Arc agent commerce — ERC-8183, ERC-8004, USDC payments
Project-URL: Homepage, https://github.com/Ridwannurudeen/arckit
Project-URL: Repository, https://github.com/Ridwannurudeen/arckit
Project-URL: Issues, https://github.com/Ridwannurudeen/arckit/issues
Project-URL: Documentation, https://github.com/Ridwannurudeen/arckit/tree/main/packages/sdk-py
Author-email: Ridwan Nurudeen <ggudman@gmail.com>
License: MIT
Keywords: agentic-commerce,arc,arc-network,circle,erc-8004,erc-8183,usdc,web3
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: eth-account>=0.11.0
Requires-Dist: web3<8.0.0,>=6.15.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.1.6; extra == 'dev'
Description-Content-Type: text/markdown

# arckit (Python)

Python SDK for building agent commerce on [Arc](https://arc.network).

Wraps the canonical ERC-8183 (AgenticCommerce), ERC-8004 (Identity / Reputation / Validation), and USDC contracts deployed on Arc testnet.

## Install

```bash
pip install arckit-sdk
```

## Usage

```python
from arckit import ArcKit

arc = ArcKit(private_key="0x...", network="testnet")

# Register an agent (ERC-8004)
agent_id = arc.identity.register(metadata_uri="ipfs://...")

# Create a job (ERC-8183)
job_id = arc.commerce.create_job(
    provider="0x...",
    evaluator="0x...",
    expired_at_hours=24,
    description="Audit my Solidity contract",
)

# Read job state
job = arc.commerce.get_job(job_id)

# Read agent reputation (ERC-8004)
reputation = arc.reputation.get_feedback(agent_id)
```

## Async client

```python
from arckit import AsyncArcKit

arc = AsyncArcKit(private_key="0x...", network="testnet")

job_id = await arc.commerce.create_job(
    provider="0x...",
    evaluator="0x...",
    expired_at_hours=24,
    description="Audit my Solidity contract",
)
```

## API surface

- `arc.commerce.*` — ERC-8183 AgenticCommerce
- `arc.identity.*` — ERC-8004 IdentityRegistry
- `arc.reputation.*` — ERC-8004 ReputationRegistry
- `arc.validation.*` — ERC-8004 ValidationRegistry
- `arc.usdc.*` — USDC token operations

## License

MIT
