arc-canteen 0.1.12__tar.gz

arc_canteen-0.1.12/.github/workflows/publish.yml

@@ -0,0 +1,19 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v6
+      - name: Build sdist and wheel
+        run: uv build
+      - name: Publish to PyPI (trusted publishing)
+        run: uv publish --trusted-publishing always

arc_canteen-0.1.12/.gitignore

@@ -0,0 +1,25 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+
+# Tooling
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+
+# Editors
+.vscode/
+.idea/
+*.swp
+
+# Secrets — never push these
+*_PAT
+*.pat
+.env
+.env.*

arc_canteen-0.1.12/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Canteen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

arc_canteen-0.1.12/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: arc-canteen
+Version: 0.1.12
+Summary: Arc Canteen CLI — track your project's progress and submit to Arc.
+Project-URL: Homepage, https://thecanteenapp.com
+Project-URL: Repository, https://github.com/the-canteen-dev/ARC-cli
+Project-URL: Documentation, https://docs.arc.io/arc-chain
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# arc-canteen CLI
+
+The CLI for you to build your next great project on Arc!
+
+More about Arc here: https://docs.arc.io/arc-chain
+
+- Use `arc-canteen context | claude` in order to pipe App Kits, Arc Sample Apps and Arc / Circle docs into your build. More here: https://github.com/the-canteen-dev/context-arc
+- Use our testnet RPC once you log in: https://arc-node.thecanteenapp.com/
+- Make yourself known as an Arc + Canteen builder to the Circle + Canteen teams! This CLI enables Canteen, Arc and Circle to provide you prizes, support and (maybe even) investment as you keep on building!
+
+Make sure you rotate your key regularly if you're having trouble logging in: `arc-canteen rotate-rpc-key`
+
+## Installation
+
+```bash
+uv tool install git+https://github.com/the-canteen-dev/ARC-cli.git
+```
+
+This places the binary at `~/.local/bin/arc-canteen`.
+
+## Upgrade
+
+```bash
+uv tool install --reinstall git+https://github.com/the-canteen-dev/ARC-cli.git
+```
+
+## Commands
+
+### Top-level
+
+| Command | Description |
+|---|---|
+| `arc-canteen` | Show your dashboard (default when no subcommand given) |
+| `arc-canteen login` | Authenticate with GitHub and set up your profile |
+| `arc-canteen logout` | Clear your local credentials |
+| `arc-canteen status` | Show your dashboard |
+| `arc-canteen push` | Push any queued local events to the server |
+| `arc-canteen ls [traction\|product\|all]` | List all updates |
+| `arc-canteen history [traction\|product\|all]` | Alias for `ls` |
+| `arc-canteen profile-edit` | Shortcut for `arc-canteen profile edit` |
+| `arc-canteen update-traction` | Shortcut for `arc-canteen update traction` |
+| `arc-canteen update-product` | Shortcut for `arc-canteen update product` |
+| `arc-canteen submit-puzzle` | Submit your answer to the current puzzle |
+| `arc-canteen rpc <method> [params]` | JSON-RPC call to the configured Arc chain |
+| `arc-canteen rpc-url [--export]` | Print the JSON-RPC URL with your token embedded |
+| `arc-canteen rotate-rpc-key` | Mint a fresh token, update `config.yaml` + `$RPC`, invalidate the old one |
+| `arc-canteen shell-init` | Print rc snippet that auto-loads `$RPC` in every shell |
+| `arc-canteen context` | Dump agent context (AGENTS.md + paths to docs and samples) |
+| `arc-canteen context sync` | Clone/pull developer docs + samples from context-arc |
+
+### `arc-canteen profile`
+
+| Command | Description |
+|---|---|
+| `arc-canteen profile` | View your profile |
+| `arc-canteen profile edit` | Edit your Discord handle, Telegram, and Luma email |
+
+### `arc-canteen update`
+
+| Command | Description |
+|---|---|
+| `arc-canteen update` | Show recent updates |
+| `arc-canteen update traction` | Submit a traction update |
+| `arc-canteen update product` | Submit a product update |
+
+### Agent context
+
+`arc-canteen context sync` clones [the-canteen-dev/context-arc](https://github.com/the-canteen-dev/context-arc) into `~/.arc-canteen/context/`. That repo bundles developer docs for Arc + Circle plus 5 sample codebases (as submodules). Subsequent `sync` invocations `git pull --recurse-submodules`.
+
+`arc-canteen context` prints `AGENTS.md` plus a flat path manifest — pipe-friendly:
+
+```bash
+arc-canteen context | claude          # or aider / cody / cursor
+arc-canteen context --paths           # just the paths, no entry-point content
+arc-canteen context --full            # also inline every .md / .yaml
+```
+
+### JSON-RPC
+
+Use `arc-canteen rpc <method> [params_json]` to make authenticated
+JSON-RPC calls against the chain configured in `~/.arc-canteen/settings.yaml`.
+
+```bash
+arc-canteen rpc eth_blockNumber                          # → 0x27a766a
+arc-canteen rpc eth_chainId                              # → 0x4cef52
+arc-canteen rpc eth_getBalance '["0xabc...", "latest"]'  # → 0x1bc16d674...
+arc-canteen rpc eth_call '[{"to":"0xabc","data":"0x70a08231"}, "latest"]'
+arc-canteen rpc eth_sendRawTransaction '["0xf86c..."]'
+arc-canteen rpc eth_blockNumber --raw                    # full envelope
+```
+
+The proxy enforces a method allowlist; calls to disallowed methods
+return `method '<x>' not allowed by the proxy`.
+
+### Auto-load $RPC
+
+`arc-canteen login` writes `export RPC='<url>'` to `~/.arc-canteen/env`. To make every new shell pick it up, install one line:
+
+```bash
+arc-canteen shell-init >> ~/.bashrc      # or ~/.zshrc
+```
+
+After that, `$RPC` is set in every shell with no per-session step.
+
+### Rotating your key
+
+```bash
+arc-canteen rotate-rpc-key
+```
+
+Mints a fresh token (re-auth via your stored GitHub credential — no browser
+step), rewrites `~/.arc-canteen/config.yaml` and `~/.arc-canteen/env`, and
+invalidates the old token server-side. Update anything that hard-coded the
+old URL (a project `.env`, a CI secret) with the new one.
+
+Tokens are good for 90 days; the dashboard nudges you as that approaches.
+`arc-canteen logout` also invalidates the token server-side.
+
+## Local state
+
+- `~/.arc-canteen/config.yaml` — auth (token + when it was issued) + profile + cached updates
+- `~/.arc-canteen/settings.yaml` — chain + event_name
+- `~/.arc-canteen/queue.yaml` — append-only event queue (synced to server)
+- `~/.arc-canteen/env` — `export RPC='…'`; sourced by your shell rc
+
+## Server
+
+The CLI talks to `https://arc-cli-server.thecanteenapp.com`. The server is intentionally idempotent — re-sending an event that already landed is harmless, so the local queue can be replayed at any time.

arc_canteen-0.1.12/README.md

@@ -0,0 +1,128 @@
+# arc-canteen CLI
+
+The CLI for you to build your next great project on Arc!
+
+More about Arc here: https://docs.arc.io/arc-chain
+
+- Use `arc-canteen context | claude` in order to pipe App Kits, Arc Sample Apps and Arc / Circle docs into your build. More here: https://github.com/the-canteen-dev/context-arc
+- Use our testnet RPC once you log in: https://arc-node.thecanteenapp.com/
+- Make yourself known as an Arc + Canteen builder to the Circle + Canteen teams! This CLI enables Canteen, Arc and Circle to provide you prizes, support and (maybe even) investment as you keep on building!
+
+Make sure you rotate your key regularly if you're having trouble logging in: `arc-canteen rotate-rpc-key`
+
+## Installation
+
+```bash
+uv tool install git+https://github.com/the-canteen-dev/ARC-cli.git
+```
+
+This places the binary at `~/.local/bin/arc-canteen`.
+
+## Upgrade
+
+```bash
+uv tool install --reinstall git+https://github.com/the-canteen-dev/ARC-cli.git
+```
+
+## Commands
+
+### Top-level
+
+| Command | Description |
+|---|---|
+| `arc-canteen` | Show your dashboard (default when no subcommand given) |
+| `arc-canteen login` | Authenticate with GitHub and set up your profile |
+| `arc-canteen logout` | Clear your local credentials |
+| `arc-canteen status` | Show your dashboard |
+| `arc-canteen push` | Push any queued local events to the server |
+| `arc-canteen ls [traction\|product\|all]` | List all updates |
+| `arc-canteen history [traction\|product\|all]` | Alias for `ls` |
+| `arc-canteen profile-edit` | Shortcut for `arc-canteen profile edit` |
+| `arc-canteen update-traction` | Shortcut for `arc-canteen update traction` |
+| `arc-canteen update-product` | Shortcut for `arc-canteen update product` |
+| `arc-canteen submit-puzzle` | Submit your answer to the current puzzle |
+| `arc-canteen rpc <method> [params]` | JSON-RPC call to the configured Arc chain |
+| `arc-canteen rpc-url [--export]` | Print the JSON-RPC URL with your token embedded |
+| `arc-canteen rotate-rpc-key` | Mint a fresh token, update `config.yaml` + `$RPC`, invalidate the old one |
+| `arc-canteen shell-init` | Print rc snippet that auto-loads `$RPC` in every shell |
+| `arc-canteen context` | Dump agent context (AGENTS.md + paths to docs and samples) |
+| `arc-canteen context sync` | Clone/pull developer docs + samples from context-arc |
+
+### `arc-canteen profile`
+
+| Command | Description |
+|---|---|
+| `arc-canteen profile` | View your profile |
+| `arc-canteen profile edit` | Edit your Discord handle, Telegram, and Luma email |
+
+### `arc-canteen update`
+
+| Command | Description |
+|---|---|
+| `arc-canteen update` | Show recent updates |
+| `arc-canteen update traction` | Submit a traction update |
+| `arc-canteen update product` | Submit a product update |
+
+### Agent context
+
+`arc-canteen context sync` clones [the-canteen-dev/context-arc](https://github.com/the-canteen-dev/context-arc) into `~/.arc-canteen/context/`. That repo bundles developer docs for Arc + Circle plus 5 sample codebases (as submodules). Subsequent `sync` invocations `git pull --recurse-submodules`.
+
+`arc-canteen context` prints `AGENTS.md` plus a flat path manifest — pipe-friendly:
+
+```bash
+arc-canteen context | claude          # or aider / cody / cursor
+arc-canteen context --paths           # just the paths, no entry-point content
+arc-canteen context --full            # also inline every .md / .yaml
+```
+
+### JSON-RPC
+
+Use `arc-canteen rpc <method> [params_json]` to make authenticated
+JSON-RPC calls against the chain configured in `~/.arc-canteen/settings.yaml`.
+
+```bash
+arc-canteen rpc eth_blockNumber                          # → 0x27a766a
+arc-canteen rpc eth_chainId                              # → 0x4cef52
+arc-canteen rpc eth_getBalance '["0xabc...", "latest"]'  # → 0x1bc16d674...
+arc-canteen rpc eth_call '[{"to":"0xabc","data":"0x70a08231"}, "latest"]'
+arc-canteen rpc eth_sendRawTransaction '["0xf86c..."]'
+arc-canteen rpc eth_blockNumber --raw                    # full envelope
+```
+
+The proxy enforces a method allowlist; calls to disallowed methods
+return `method '<x>' not allowed by the proxy`.
+
+### Auto-load $RPC
+
+`arc-canteen login` writes `export RPC='<url>'` to `~/.arc-canteen/env`. To make every new shell pick it up, install one line:
+
+```bash
+arc-canteen shell-init >> ~/.bashrc      # or ~/.zshrc
+```
+
+After that, `$RPC` is set in every shell with no per-session step.
+
+### Rotating your key
+
+```bash
+arc-canteen rotate-rpc-key
+```
+
+Mints a fresh token (re-auth via your stored GitHub credential — no browser
+step), rewrites `~/.arc-canteen/config.yaml` and `~/.arc-canteen/env`, and
+invalidates the old token server-side. Update anything that hard-coded the
+old URL (a project `.env`, a CI secret) with the new one.
+
+Tokens are good for 90 days; the dashboard nudges you as that approaches.
+`arc-canteen logout` also invalidates the token server-side.
+
+## Local state
+
+- `~/.arc-canteen/config.yaml` — auth (token + when it was issued) + profile + cached updates
+- `~/.arc-canteen/settings.yaml` — chain + event_name
+- `~/.arc-canteen/queue.yaml` — append-only event queue (synced to server)
+- `~/.arc-canteen/env` — `export RPC='…'`; sourced by your shell rc
+
+## Server
+
+The CLI talks to `https://arc-cli-server.thecanteenapp.com`. The server is intentionally idempotent — re-sending an event that already landed is harmless, so the local queue can be replayed at any time.

arc_canteen-0.1.12/arc_canteen/auth.py

@@ -0,0 +1,92 @@
+"""GitHub Device Flow OAuth for arc-canteen CLI."""
+
+import httpx
+import time
+from rich.console import Console
+
+console = Console()
+
+GITHUB_CLIENT_ID = "Ov23liTpDFXKEw56hVH1"
+
+
+def device_flow_login() -> dict:
+    """Run GitHub Device Flow. Returns token response dict with 'access_token'."""
+    try:
+        resp = httpx.post(
+            "https://github.com/login/device/code",
+            data={"client_id": GITHUB_CLIENT_ID, "scope": ""},
+            headers={"Accept": "application/json"},
+            timeout=10,
+        )
+        resp.raise_for_status()
+    except httpx.RequestError as e:
+        raise RuntimeError(f"Network error contacting GitHub: {e}")
+
+    data = resp.json()
+    if "error" in data:
+        raise RuntimeError(f"GitHub error: {data.get('error_description', data['error'])}")
+
+    device_code = data["device_code"]
+    user_code = data["user_code"]
+    verification_uri = data["verification_uri"]
+    interval = data.get("interval", 5)
+    expires_in = data.get("expires_in", 900)
+
+    console.print(f"\n  [bold]1.[/bold] Open  → [cyan]{verification_uri}[/cyan]")
+    console.print(f"  [bold]2.[/bold] Enter → [bold yellow]{user_code}[/bold yellow]\n")
+
+    try:
+        import webbrowser
+        webbrowser.open(verification_uri)
+    except Exception:
+        pass
+
+    deadline = time.time() + expires_in
+    with console.status("[dim]Waiting for authorization...[/dim]"):
+        while time.time() < deadline:
+            time.sleep(interval)
+            try:
+                poll = httpx.post(
+                    "https://github.com/login/oauth/access_token",
+                    data={
+                        "client_id": GITHUB_CLIENT_ID,
+                        "device_code": device_code,
+                        "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
+                    },
+                    headers={"Accept": "application/json"},
+                    timeout=10,
+                )
+                result = poll.json()
+            except httpx.RequestError:
+                continue
+
+            if "access_token" in result:
+                return result
+
+            err = result.get("error", "")
+            if err == "authorization_pending":
+                continue
+            elif err == "slow_down":
+                interval += 5
+            elif err == "expired_token":
+                raise RuntimeError("Code expired. Run `arc-canteen login` again.")
+            elif err == "access_denied":
+                raise RuntimeError("Authorization denied.")
+            else:
+                raise RuntimeError(f"Unexpected response: {result}")
+
+    raise RuntimeError("Authorization timed out.")
+
+
+def get_github_user(token: str) -> dict:
+    resp = httpx.get(
+        "https://api.github.com/user",
+        headers={
+            "Authorization": f"Bearer {token}",
+            "Accept": "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28",
+        },
+        timeout=10,
+    )
+    resp.raise_for_status()
+    return resp.json()