ChainShield

Use when writing or reviewing Rust code in this repo. Covers the Cargo workspace layout, error handling, async patterns, serde wire shapes that must match the TypeScript scaffold byte-for-byte, and testing conventions specific to ChainShield.

Use when authoring or reviewing the onchain layer of ChainShield. Covers PolicyAnchor, optional EmergencyVault, custom-error patterns, OpenZeppelin imports, Foundry test conventions, and the Galileo testnet deploy flow. Solidity surface is intentionally small.

Use when starting Phase 2 work to add the 0G, KeeperHub, or Gensyn AXL adapter modules. Provides the verbatim entry points, environment variables, and the trait seam to plug into without disturbing the Phase 1 engine. Backend is Rust; sponsor calls go through traits with one impl per provider.

Use when reasoning about ERC-20 token approvals, transfers, or any code path that touches tokens on behalf of users. Catalogs the attack patterns that ChainShield is designed to prevent and the engine rules that defend against each.

Use when designing a new ChainShield Policy for a wallet, treasury, or protocol multisig. Walks through risk profile, rule selection, default values, and remediation hookup so the resulting policy enforces real protection without blocking routine ops.

Use when you encounter an EVM 4-byte function selector (0x followed by 8 hex chars at the start of calldata) and need to identify which function it represents, or when authoring a forbiddenSelectors policy rule. Provides a curated table of common selectors and a decoding workflow for unknown ones.