| name | starknet-network-facts |
| description | Starknet network-level constraints and protocol facts that impact contract safety and agent reasoning. |
| license | Apache-2.0 |
| metadata | {"author":"starknet-agentic","version":"0.1.1","org":"keep-starknet-strange","source":"starknet-agentic"} |
| keywords | ["starknet","network","fees","tx-version","sequencer","inclusion"] |
| allowed-tools | ["Bash","Read","Write","Glob","Grep","Task"] |
| user-invocable | true |
Starknet Network Facts
When to Use
- Reasoning about chain behavior assumptions in contract logic.
- Validating time, fee, and transaction-version dependencies.
When NOT to Use
- Contract implementation details unrelated to chain behavior.
Quick Start
- Identify assumptions in code about tx versions, fee tokens, and timing.
- Verify assumptions against current network behavior before release.
- Add tests for boundary behavior tied to block timing or tx metadata.
Core Focus
- transaction version expectations
- fee token and bounds assumptions
- block-time-sensitive logic
- sequencer and inclusion model implications
Workflow
References
starknet.js Example
import { RpcProvider } from "starknet";
const provider = new RpcProvider({ nodeUrl: process.env.STARKNET_RPC! });
const latest = await provider.getBlock("latest");
console.log({
blockNumber: latest.block_number,
l1GasPrice: latest.l1_gas_price,
l2GasPrice: latest.l2_gas_price,
});
Error Codes and Recovery
| Code | Meaning | Recovery |
|---|
SNF-001 | RPC/network fact unavailable | Retry with a fallback RPC and compare outputs before acting. |
SNF-002 | Conflicting tx-version assumption | Re-check references and update guards/tests for current tx version behavior. |
SNF-003 | Fee-token assumption mismatch | Add explicit fee-token checks and fee-bound regression tests. |