Configuration

GasKillerSDK holds its configuration in an ERC-7201 namespace, so it never collides with your contract's own storage. Two values are required; the rest have working defaults.

All three setters are internal. The SDK deliberately ships no access control, you decide who may call them and when, by exposing them or not.

The two required addresses

schnorrRegistry is the SchnorrStakeRegistry holding the operator set's aggregate key and stake weights. It is the contract your target trusts to verify that a quorum of operators signed the state update, and it must be the one the router is signing for. avsAddress is the AVS service manager; it records which deployment the target belongs to and does not participate in signature verification.

For the public testnet (Sepolia, chain 11155111):

Read from GET /avs-metadata on the router itself, so this table follows the deployment rather than being maintained by hand. Cached for up to an hour.

Read them yourself the same way, in a script or a deploy pipeline:

curl -s https://testnet.gaskiller.xyz/avs-metadata | jq .contracts

The two values a target's constructor takes, resolved at the moment you deploy rather than copied from a page:

CONTRACTS=$(curl -s https://testnet.gaskiller.xyz/avs-metadata | jq .contracts)
AVS_ADDRESS=$(jq -r .avsAddress <<<"$CONTRACTS")
SCHNORR_REGISTRY_ADDRESS=$(jq -r .schnorrStakeRegistry <<<"$CONTRACTS")

The full response shape is in the API reference.

Verify your own wiring

Once your target is deployed, confirm it agrees with the published set:

# Must equal schnorrStakeRegistry in the table above.
cast call "$TARGET" "schnorrRegistry()(address)" --rpc-url "$RPC_URL"

# Non-zero: the registry actually holds an operator set.
cast call "$SCHNORR_REGISTRY_ADDRESS" "totalWeight()(uint256)" --rpc-url "$RPC_URL"

If your target points at a different registry, its address is stale. Its tasks fail with InvalidQuorumSignature (0x68477238), because the aggregate key it checks against is not the one the operators signed with, or with NotRegistered (0xbfc6c337) when a non-signer the router lists is unknown to it. See the error table.

Stay reconfigurable

Because the setters are internal, a contract that only calls them in its constructor can never be rewired, whether an address changed or you simply got one wrong.

Expose a guarded setter:

import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol";
import {GasKillerSDK} from "gas-killer-sdk/GasKillerSDK.sol";

contract Counter is GasKillerSDK, Ownable {
    constructor(address avs, address schnorrRegistry)
        Ownable(msg.sender)
    {
        _setAvsAddress(avs);
        _setSchnorrRegistry(schnorrRegistry);
    }

    /// Lets the deployment follow an operator-set migration without redeploying.
    function setGasKillerConfig(address avs, address schnorrRegistry) external onlyOwner {
        _setAvsAddress(avs);
        _setSchnorrRegistry(schnorrRegistry);
    }
}

blockStaleMeasure

The maximum age, in blocks, of the referenceBlockNumber a payload may carry. verifyAndUpdate requires:

referenceBlockNumber < block.number
referenceBlockNumber + blockStaleMeasure >= block.number

Unset means 300 blocks, roughly an hour on Sepolia. Below that floor a payload expires before a client can reasonably submit it; well above it, a payload stays applicable long after the state it was computed against.

Lowering it tightens the window in which a signed transition can land. Raising it widens the period during which an operator-set change can invalidate an already-assembled signature. The registry schedules operator changes behind a notice window (600 blocks on the public testnet) sized to exceed this value plus a signing round, so raising it past that window loses the guarantee that a payload settles under the operator set that signed it. 300 is a sensible default; change it only with a reason.

constructor(address avs, address schnorrRegistry) {
    _setAvsAddress(avs);
    _setSchnorrRegistry(schnorrRegistry);
    _setBlockStaleMeasure(150);
}

Reading configuration back

All public, all view: