{"id":46541253,"url":"https://github.com/keep-starknet-strange/starknet-agentic","last_synced_at":"2026-05-01T07:00:45.084Z","repository":{"id":335688267,"uuid":"1146702680","full_name":"keep-starknet-strange/starknet-agentic","owner":"keep-starknet-strange","description":"Smart contracts, tools, and skills for AI agents that transact on Starknet","archived":false,"fork":false,"pushed_at":"2026-04-30T08:02:57.000Z","size":4174,"stargazers_count":79,"open_issues_count":30,"forks_count":24,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-30T09:21:31.293Z","etag":null,"topics":["agentic-framework","chatgpt","claude","claude-code","codex","moltbook","openclaw","starknet"],"latest_commit_sha":null,"homepage":"https://starknet-agentic.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/keep-starknet-strange.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-31T14:41:31.000Z","updated_at":"2026-04-30T08:01:48.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/keep-starknet-strange/starknet-agentic","commit_stats":null,"previous_names":["keep-starknet-strange/starknet-agentic"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/keep-starknet-strange/starknet-agentic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep-starknet-strange%2Fstarknet-agentic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep-starknet-strange%2Fstarknet-agentic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep-starknet-strange%2Fstarknet-agentic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep-starknet-strange%2Fstarknet-agentic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/keep-starknet-strange","download_url":"https://codeload.github.com/keep-starknet-strange/starknet-agentic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/keep-starknet-strange%2Fstarknet-agentic/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32485481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-framework","chatgpt","claude","claude-code","codex","moltbook","openclaw","starknet"],"created_at":"2026-03-07T01:09:00.510Z","updated_at":"2026-05-01T07:00:45.074Z","avatar_url":"https://github.com/keep-starknet-strange.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Starknet Agentic\n\n```text\n┌──────────────────────────────────────────────────────────────┐\n│ starknet-agentic                                            │\n│ contracts • runtimes • skills for policy-enforced agents    │\n└──────────────────────────────────────────────────────────────┘\n```\n\n[![CI](https://github.com/keep-starknet-strange/starknet-agentic/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/keep-starknet-strange/starknet-agentic/actions/workflows/ci.yml)\n[![CodeQL](https://github.com/keep-starknet-strange/starknet-agentic/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/keep-starknet-strange/starknet-agentic/actions/workflows/codeql.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\nInfrastructure for the Starknet agent economy: contracts, runtimes, and skills to run self-custodial AI agents with on-chain identity, policy-enforced execution, and composable tool access.\n\n## Why This Exists\n\nMost agent stacks treat wallets as add-ons. `starknet-agentic` treats wallets, identity, and execution policy as first-class system boundaries.\n\nThis repo gives you:\n\n- account-level control rails (session keys, spending policy, revoke paths)\n- ERC-8004 identity, reputation, and validation registries on Starknet\n- MCP and A2A integration packages for agent runtimes\n- reusable skills and end-to-end examples\n\n## Fastest Path\n\nIf you just want Starknet agent capabilities now:\n\n```bash\nnpx @starknetfoundation/create-starknet-agent@latest\n```\n\nSanity check (npm availability):\n\n```bash\nnpm view @starknetfoundation/create-starknet-agent version\n```\n\nThe scaffolder detects your environment (OpenClaw/MoltBook, Claude Code, Cursor, or standalone) and wires Starknet integration automatically.\n\n## Install \u0026 Use\n\nUse the path that matches your runtime:\n\n```bash\n# Full project scaffold\nnpx @starknetfoundation/create-starknet-agent@latest\n```\n\n```bash\n# Codex (built-in installer, cairo-auditor)\nCODEX_HOME=\"${CODEX_HOME:-$HOME/.codex}\"\npython3 \"$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py\" \\\n  --repo keep-starknet-strange/starknet-agentic \\\n  --path skills/cairo-auditor \\\n  --ref main\n# Restart Codex, then run /skills and invoke cairo-auditor\n```\n\n```bash\n# Codex (frozen install)\n# Replace \u003ccommit-sha\u003e with the exact immutable revision you want to pin.\nCODEX_HOME=\"${CODEX_HOME:-$HOME/.codex}\"\npython3 \"$CODEX_HOME/skills/.system/skill-installer/scripts/install-skill-from-github.py\" \\\n  --repo keep-starknet-strange/starknet-agentic \\\n  --path skills/cairo-auditor \\\n  --ref \u003ccommit-sha\u003e\n```\n\n```bash\n# Claude Code marketplace\n/plugin marketplace add keep-starknet-strange/starknet-agentic\n/plugin install starknet-agentic-skills@starknet-agentic-skills --scope user\n/reload-plugins\n/plugin menu\n/starknet-agentic-skills:cairo-auditor\n```\n\n```bash\n# Individual skill install via Agent Skills CLI\nnpx skills add keep-starknet-strange/starknet-agentic/skills/cairo-auditor\n```\n\nFor deterministic install/usage guidance, see:\n\n- [skills/QUICKSTART_2MIN.md](./skills/QUICKSTART_2MIN.md)\n- [skills/TROUBLESHOOTING.md](./skills/TROUBLESHOOTING.md)\n- [docs/CLAUDE_MARKETPLACE_SUBMISSION.md](./docs/CLAUDE_MARKETPLACE_SUBMISSION.md)\n\nFor the full skill catalog and Cairo migration notes, see [skills/README.md](./skills/README.md) and [docs/CAIRO_SKILLS_MIGRATION.md](./docs/CAIRO_SKILLS_MIGRATION.md).\n\n## Flagship Skills\n\n| Skill | Best for | Fast path |\n|---|---|---|\n| [`cairo-auditor`](./skills/cairo-auditor/) | Pre-merge Cairo security review with deterministic preflight and false-positive gating | [30-second quickstart](./skills/QUICKSTART_2MIN.md) |\n| [`starknet-wallet`](./skills/starknet-wallet/) | Wallet ops, transfers, session keys, paymaster flows | [Skill docs](./skills/starknet-wallet/) |\n| [`starknet-defi`](./skills/starknet-defi/) | Swaps, DCA, staking, lending, AVNU routing | [Skill docs](./skills/starknet-defi/) |\n| [`starknet-identity`](./skills/starknet-identity/) | ERC-8004 registration, reputation, validation | [Skill docs](./skills/starknet-identity/) |\n\n## System Requirements\n\n- CLI users (`npx @starknetfoundation/create-starknet-agent@latest`): Node.js `\u003e=18.0.0`\n- Contributors from source (this monorepo):\n  - Node.js `\u003e=20.9.0`\n  - `pnpm` `\u003e=10.28.2` (workspace package manager)\n  - Scarb `\u003e=2.14.0` + Starknet Foundry (`snforge`) `\u003e=0.54.1` (for Cairo builds/tests)\n\n## Choose Your Path\n\n| Goal | Start here |\n|---|---|\n| Add Starknet tools to an existing agent | [`packages/create-starknet-agent`](./packages/create-starknet-agent/) |\n| Run local no-backend onboarding demo | [`examples/onboard-agent`](./examples/onboard-agent/) |\n| Run autonomous loop with MCP tools | [`examples/full-stack-swarm`](./examples/full-stack-swarm/) |\n| Integrate on-chain identity/reputation | [`contracts/erc8004-cairo`](./contracts/erc8004-cairo/) |\n| Build production signer boundary | [`packages/starknet-mcp-server`](./packages/starknet-mcp-server/) + external signer (proxy mode) |\n\n## Architecture\n\n```mermaid\nflowchart TB\n  A[\"Agent Runtime\u003cbr/\u003e(OpenClaw, Claude Code, custom app)\"] --\u003e B[\"MCP / A2A Layer\u003cbr/\u003estarknet-mcp-server, starknet-a2a, skills\"]\n  B --\u003e C[\"Signer Boundary\u003cbr/\u003edirect (dev) or proxy (prod)\"]\n  C --\u003e D[\"Starknet Contracts\"]\n  D --\u003e D1[\"Agent-account stack\u003cbr/\u003eowner controls + spending policy enforcement\"]\n  D --\u003e D2[\"ERC-8004 Registries\u003cbr/\u003eIdentity, Reputation, Validation\"]\n  D --\u003e D3[\"Session-account primitives\u003cbr/\u003esession-key account modules\"]\n```\n\n## No-Backend Trust Model (Recommended Launch Profile)\n\nDefault launch profile is self-custodial and no-backend:\n\n- users run agent runtime locally or on their own infra\n- transaction policy is enforced on-chain by account contracts\n- no central signer or shared custody by this project\n\nFor production environments, use MCP proxy signer mode rather than raw in-process private keys.\n\n## Core Components\n\n### Contracts\n\n| Component | Path | What it does |\n|---|---|---|\n| Agent account contracts | [`contracts/agent-account`](./contracts/agent-account/) | Session keys, policy enforcement, ownership controls |\n| ERC-8004 Cairo registries | [`contracts/erc8004-cairo`](./contracts/erc8004-cairo/) | Identity, reputation, validation primitives |\n| Session-account primitives | [`contracts/session-account`](./contracts/session-account/) | Session-key account modules for policy-centric execution |\n| Huginn registry | [`contracts/huginn-registry`](./contracts/huginn-registry/) | Additional registry primitives used by ecosystem demos |\n\n### Packages\n\n| Package | Path | Purpose |\n|---|---|---|\n| `create-starknet-agent` | [`packages/create-starknet-agent`](./packages/create-starknet-agent/) | Scaffolds/installs Starknet agent integration |\n| `@starknetfoundation/starknet-agentic-mcp-server` | [`packages/starknet-mcp-server`](./packages/starknet-mcp-server/) | Starknet operations over MCP |\n| `@starknetfoundation/starknet-agentic-a2a` | [`packages/starknet-a2a`](./packages/starknet-a2a/) | A2A protocol adapter |\n| `@starknetfoundation/starknet-agentic-agent-passport` | [`packages/starknet-agent-passport`](./packages/starknet-agent-passport/) | ERC-8004 capability metadata helpers |\n| `@starknetfoundation/starknet-agentic-prediction-arb-scanner` | [`packages/prediction-arb-scanner`](./packages/prediction-arb-scanner/) | Signals-only prediction market arb scanner output model |\n| `@starknetfoundation/starknet-agentic-onboarding-utils` | [`packages/starknet-onboarding-utils`](./packages/starknet-onboarding-utils/) | Shared onboarding helpers |\n\n### Skills\n\nSkill packs live in [`skills/`](./skills/). Browse full catalog and install flows in [`skills/README.md`](./skills/README.md).\nCairo migration notes and legacy mapping live in [`docs/CAIRO_SKILLS_MIGRATION.md`](./docs/CAIRO_SKILLS_MIGRATION.md).\n\nInstall one skill:\n\n```bash\nnpx skills add keep-starknet-strange/starknet-agentic/skills/starknet-wallet\n```\n\n## Standards and Interop\n\n| Standard | Purpose | Implementation |\n|---|---|---|\n| [MCP](https://modelcontextprotocol.io/) | Agent tool interface | `packages/starknet-mcp-server` |\n| [A2A](https://a2a-protocol.org/) | Agent-to-agent messaging/workflows | `packages/starknet-a2a` |\n| [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) | Agent identity/reputation/validation | `contracts/erc8004-cairo` |\n\nParity and Starknet-specific behavior for ERC-8004 is documented in [`docs/ERC8004-PARITY.md`](./docs/ERC8004-PARITY.md).\n\n## Quickstart From Source (Contributors)\n\n### 1) Install\n\n```bash\npnpm install\n```\n\n### 2) Build and test JS/TS workspace (packages, examples, website)\n\n```bash\n# full workspace\npnpm build\npnpm test\n\n# packages only (faster path when you do not need example/website checks)\npnpm -r --filter \"./packages/*\" build\npnpm -r --filter \"./packages/*\" test\n```\n\n### 3) Run Cairo checks\n\n```bash\nfailed=0\nfor dir in contracts/erc8004-cairo contracts/huginn-registry contracts/agent-account contracts/session-account; do\n  if ! (cd \"$dir\" \u0026\u0026 scarb build \u0026\u0026 snforge test); then\n    echo \"Cairo checks failed in $dir\"\n    failed=1\n    break\n  fi\ndone\n[ \"$failed\" -eq 0 ]\n```\n\n### 4) Run a minimal E2E demo\n\nBefore running, configure the required environment in:\n[`examples/hello-agent/README.md`](./examples/hello-agent/README.md)\n\n```bash\n# from repo root (after configuring examples/hello-agent/.env)\npnpm demo:hello-agent\n```\n\n## Example Gallery\n\n| Example | What it proves |\n|---|---|\n| [`examples/hello-agent`](./examples/hello-agent/) | Minimal RPC + state read + transaction path |\n| [`examples/onboard-agent`](./examples/onboard-agent/) | Deploy agent account + register identity + receipt artifacts |\n| [`examples/defi-agent`](./examples/defi-agent/) | Autonomous DeFi strategy agent (triangular arb + risk controls) |\n| [`examples/carry-agent`](./examples/carry-agent/) | Deterministic carry monitor (Extended funding + net-edge decision artifact) |\n| [`examples/full-stack-swarm`](./examples/full-stack-swarm/) | Autonomous multi-agent run with MCP + signer boundary + ERC-8004 |\n| [`examples/secure-defi-demo`](./examples/secure-defi-demo/) | Base reputation envelope + Starknet guardrails + Vesu flow artifact |\n| [`examples/crosschain-demo`](./examples/crosschain-demo/) | Cross-chain registration flow (Base Sepolia + Starknet Sepolia) |\n| [`examples/erc8004-validation-demo`](./examples/erc8004-validation-demo/) | Validation request/response + summary extraction |\n| [`examples/starkzap-onboard-transfer`](./examples/starkzap-onboard-transfer/) | End-to-end Starkzap onboarding and STRK transfer flow (Sepolia) |\n| [`examples/controller-calls`](./examples/controller-calls/) | Non-custodial unsigned-call flow with external signer execution |\n\n## Security and Release Integrity\n\n- read security policy: [`SECURITY.md`](./SECURITY.md)\n- hardened signer setup: use proxy signer mode in [`packages/starknet-mcp-server`](./packages/starknet-mcp-server/)\n- GitHub Actions quality gates: [`ci.yml`](./.github/workflows/ci.yml), [`codeql.yml`](./.github/workflows/codeql.yml), [`dependency-review.yml`](./.github/workflows/dependency-review.yml)\n- publish pipeline uses provenance + attestations: [`publish.yml`](./.github/workflows/publish.yml)\n\nRelease artifact verification (recommended):\n\n```bash\ngh attestation verify \u003cartifact-file\u003e --repo keep-starknet-strange/starknet-agentic\n```\n\n## Community and Help\n\n- [GitHub Issues](https://github.com/keep-starknet-strange/starknet-agentic/issues) for bugs and docs fixes\n- [Starknet Discord](https://discord.gg/starknet) for ecosystem support\n- [Starknet on X](https://x.com/Starknet) for release updates\n\n## Repository Layout\n\n```text\nstarknet-agentic/\n├── .agents/          # Codex discovery entrypoints (symlinks to skills/*)\n├── contracts/        # Cairo contracts (account, ERC-8004, session-account)\n├── packages/         # MCP/A2A/CLI and supporting libraries\n├── skills/           # Agent skill packs\n├── examples/         # End-to-end demos and reference flows\n├── docs/             # Specs, roadmap, troubleshooting, launch material\n└── website/          # Documentation website\n```\n\n## Documentation\n\n- getting started: [`docs/GETTING_STARTED.md`](./docs/GETTING_STARTED.md)\n- roadmap: [`docs/ROADMAP.md`](./docs/ROADMAP.md)\n- specification: [`docs/SPECIFICATION.md`](./docs/SPECIFICATION.md)\n- troubleshooting: [`docs/TROUBLESHOOTING.md`](./docs/TROUBLESHOOTING.md)\n- good first tasks: [`docs/GOOD_FIRST_ISSUES.md`](./docs/GOOD_FIRST_ISSUES.md)\n\n## Contributing\n\nSee [`CONTRIBUTING.md`](./CONTRIBUTING.md).\n\n## License\n\nMIT ([`LICENSE`](./LICENSE))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeep-starknet-strange%2Fstarknet-agentic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkeep-starknet-strange%2Fstarknet-agentic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeep-starknet-strange%2Fstarknet-agentic/lists"}