| name | conflux-core |
| description | Core Space RPC guidance for read/write flows, cfx_* method selection, internal contracts, transaction debugging, and safe send defaults. Use when users work with Conflux Core Space JSON-RPC, js-conflux-sdk, cast rpc cfx_*, or Core internal contracts such as SponsorWhitelistControl/Staking/AdminControl. |
conflux-core
Scope
- Core Space RPC only: read, write guidance, estimation, and troubleshooting.
- Apply when users ask about
cfx_* methods, Core addresses (cfx: / cfxtest:), cfx_call, cfx_estimateGasAndCollateral, cfx_sendTransaction, or Core transaction debugging.
- Cover Core internal contracts (
AdminControl, SponsorWhitelistControl, Staking, ConfluxContext, PoSRegister, CrossSpaceCall, ParamsControl) under Core RPC constraints.
- Do not use this skill for eSpace (
eth_*) workflows.
Intake
- Confirm network before execution: mainnet or testnet, and the RPC endpoint.
- Collect minimum context:
- Network (
mainnet/testnet and RPC URL)
- Intent (
read vs write)
- Target (address, tx hash, contract, method)
- If context is incomplete, pause and ask clarifying questions before generating write commands.
Tool Strategy
- Default:
js-conflux-sdk v2+ (conflux.cfx.* API) for most Core Space flows.
- Optional:
cast rpc cfx_* when the user prefers Foundry CLI or needs quick single-call checks.
- Fallback:
curl with raw JSON-RPC payloads for environment-agnostic verification.
- Respect user-specified tool preference when stated.
Safety Defaults
- Always confirm network before any write action. Never send writes to an implied endpoint.
- Preflight
cfx_estimateGasAndCollateral is required before send; do not construct or send transactions until it succeeds.
- If estimation fails, stop and debug root cause before retrying writes.
- Show the write risk template from shared-concepts.md before write operations, then wait for explicit user approval before any send step.
- transactions are irreversible once finalized on mainnet
- real asset loss is possible on parameter mistakes
- user should verify to/from address, value, gas-related fields, and nonce assumptions
- Prefer read-only
cfx_call reproduction before sending when debugging contract interactions.
Reference Files
- core-space.md — Read/write workflows, contract calls, estimation gate, and troubleshooting.
- shared-concepts.md — Core addresses, units, storage collateral, internal contracts (brief), read/write boundaries, and mainnet risk template.
- network-matrix.md — Core mainnet/testnet mapping and official RPC/explorer entry links.
- internal-contracts.md — Internal contract addresses, method indexes, and safe call/send patterns.
Related skills
conflux-docs — official Conflux documentation navigation and source grounding.conflux-scan-rpc — read-only eSpace state inspection (eth_*); use for eSpace, not Core Space.
Check the Conflux skill list to get any mentioned skill if needed.
Official References
