{"id":43834214,"url":"https://github.com/intent-solutions-io/irsb-solver","last_synced_at":"2026-02-09T04:12:27.732Z","repository":{"id":336591777,"uuid":"1150294053","full_name":"intent-solutions-io/irsb-solver","owner":"intent-solutions-io","description":"Reference off-chain solver/executor for the IRSB accountability protocol. Deterministic evidence + receipts for intent-based workflows.","archived":false,"fork":false,"pushed_at":"2026-02-06T02:01:14.000Z","size":207,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-06T11:36:46.573Z","etag":null,"topics":["accountability","auditability","blockchain","ethereum","evm","intent-based","protocol","receipts","verifiable-computation","web3"],"latest_commit_sha":null,"homepage":null,"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/intent-solutions-io.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":null,"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-02-05T05:28:06.000Z","updated_at":"2026-02-06T02:01:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/intent-solutions-io/irsb-solver","commit_stats":null,"previous_names":["intent-solutions-io/irsb-solver"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/intent-solutions-io/irsb-solver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intent-solutions-io%2Firsb-solver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intent-solutions-io%2Firsb-solver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intent-solutions-io%2Firsb-solver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intent-solutions-io%2Firsb-solver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/intent-solutions-io","download_url":"https://codeload.github.com/intent-solutions-io/irsb-solver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/intent-solutions-io%2Firsb-solver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29256186,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-09T04:11:57.159Z","status":"ssl_error","status_checked_at":"2026-02-09T04:11:56.117Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["accountability","auditability","blockchain","ethereum","evm","intent-based","protocol","receipts","verifiable-computation","web3"],"created_at":"2026-02-06T04:00:23.179Z","updated_at":"2026-02-09T04:12:27.716Z","avatar_url":"https://github.com/intent-solutions-io.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IRSB Solver\n\nReference solver/executor service for the IRSB protocol.\n\n## What is IRSB Solver?\n\nIRSB Solver is the actor implementation that:\n- Consumes intents from the IRSB protocol\n- Runs allowed workflows off-chain\n- Produces evidence of execution\n- Submits receipts for settlement\n\n## Determinism Pledge\n\nThis solver is designed for **reproducible, auditable execution**:\n\n- **Deterministic IDs**: All identifiers (`runId`, `receiptId`) are computed from canonical inputs, not random UUIDs\n- **Canonical Hashing**: JSON is sorted by keys, no floats in hashed content, no wall-clock timestamps in artifacts\n- **Reproducible Evidence**: Given the same intent and inputs, the solver produces identical evidence hashes\n- **Idempotent Retries**: Re-running the same intent produces the same receipt (no duplicate work)\n\nThis enables:\n- Third-party verification of execution correctness\n- Watchtower correlation of receipts to intents\n- Dispute resolution based on reproducible evidence\n\n## What This Repo Does NOT Do\n\n**Out of Scope:**\n\n| Not Here | Where It Belongs |\n|----------|------------------|\n| On-chain contracts | [irsb-protocol](https://github.com/intent-solutions-io/irsb-protocol) |\n| Monitoring/alerting | [irsb-watchtower](https://github.com/intent-solutions-io/irsb-watchtower) |\n| LLM/AI agent orchestration | Not part of IRSB (ERC-8004 discovery shapes only) |\n| Multi-solver coordination | Future scope |\n| Chain-native execution | Solvers execute off-chain, post receipts on-chain |\n\n## Related Repositories\n\n| Repo | Purpose |\n|------|---------|\n| [irsb-protocol](https://github.com/intent-solutions-io/irsb-protocol) | On-chain contracts, schemas, settlement primitives |\n| [irsb-watchtower](https://github.com/intent-solutions-io/irsb-watchtower) | Indexing, monitoring, alerts, dashboards |\n| **irsb-solver** (this repo) | Reference solver/executor service |\n\n## Current Status\n\n**Phase 8: Production Hardening** - E2E demo, replay determinism, security documentation.\n\n## Quickstart Demo\n\nRun the complete solver demo in one command:\n\n```bash\npnpm install\npnpm demo\n```\n\nThis will:\n1. Validate configuration\n2. Run a sample intent fixture\n3. Generate evidence bundle with artifacts\n4. Verify evidence integrity\n\n## Replay Determinism\n\nVerify that the solver produces identical results across runs:\n\n```bash\npnpm replay\n```\n\nThis script:\n1. Runs the same fixture twice in isolated directories\n2. Compares run IDs, artifact hashes, and manifest hashes\n3. Verifies deterministic execution (excluding timestamps)\n\nSee [Determinism Pledge](#determinism-pledge) for design principles.\n\n## ERC-8004 Discovery\n\nThe solver exposes a standard agent card for service discovery:\n\n```bash\n# Start the server\npnpm start\n\n# Fetch agent card\ncurl http://localhost:3000/.well-known/agent-card.json\n```\n\nThe agent card declares:\n- Service identity (`irsb-solver@0.1.0`)\n- Capabilities (`intent-execution`, `evidence-generation`, `receipt-submission`)\n- Endpoints (health, metrics, execute=N/A for non-interactive service)\n\nNote: This solver borrows only the discovery/registration shapes from ERC-8004. It is **not** an LLM chat agent.\n\n## Security\n\nSee the [Threat Model](./000-docs/030-DR-THMD-threat-model-v0.md) for:\n- Asset classification\n- Trust boundaries\n- Threat analysis and mitigations\n- Current security posture\n\nSee the [Security Hardening Checklist](./000-docs/031-DR-CHKL-security-hardening-checklist.md) for production deployment requirements.\n\n## Local Development\n\n```bash\n# Install dependencies\npnpm install\n\n# Run development server\npnpm dev\n\n# Run tests\npnpm test\n\n# Run linter\npnpm lint\n\n# Build for production\npnpm build\n```\n\n## Requirements\n\n- Node.js 20+\n- pnpm 9+\n\n## License\n\nMIT License - See [LICENSE](./LICENSE) for details.\n\n### Licensing Scope\n\nThis license applies to:\n- All source code in this repository\n- Documentation in `000-docs/`\n- Configuration files and examples\n\nThis license does NOT cover:\n- The IRSB protocol specification (separate ERC proposal)\n- On-chain contracts (see [irsb-protocol](https://github.com/intent-solutions-io/irsb-protocol))\n- Third-party dependencies (see their respective licenses)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintent-solutions-io%2Firsb-solver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fintent-solutions-io%2Firsb-solver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fintent-solutions-io%2Firsb-solver/lists"}