Documentation Index

Fetch the complete documentation index at: https://dispatch.lodestar-dashboard.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Contract Reference

RPCDataService is deployed on Arbitrum One at 0x7101d5c1a5c89c3647f5118da118e56c023ba0b9 as a UUPS upgradeable proxy (ERC1967). The proxy forwards all calls to an implementation contract; upgrades are owner-authorised via upgradeToAndCall(). It inherits Horizon’s DataService + DataServiceFees + DataServicePausableUpgradeable and implements IDataService.

---

​

Functions

​

register(serviceProvider, data)

Registers a new provider.

• data: abi.encode(string endpoint, string geoHash, address paymentsDestination)
• Validates: provision ≥ minimumProvisionTokens, thawing period ≥ minimumThawingPeriod
• Sets paymentsDestination[serviceProvider] (defaults to serviceProvider if zero address)
• Emits ProviderRegistered

​

setPaymentsDestination(destination)

Changes the GRT recipient for collected fees. The new address takes effect on the next collect() call. Callable by a registered provider or their authorised operator at any time.

​

startService(serviceProvider, data)

Activates a provider for a specific chain and tier.

• data: abi.encode(uint64 chainId, uint8 tier, string endpoint)
• Validates: chainId in supportedChains, provider registered, provision meets per-chain minimum
• Emits ServiceStarted

​

stopService(serviceProvider, data)

Deactivates a provider for a (chainId, tier) pair.

​

deregister(serviceProvider, data)

Removes the provider from the registry. Must stop all active services first.

​

collect(serviceProvider, paymentType, data)

Redeems a signed RAV for GRT.

• data: abi.encode(SignedRAV, tokensToCollect)
• Reverts with InvalidPaymentType if paymentType != QueryFee
• Calls GraphTallyCollector.collect() — verifies EIP-712 signature, tracks cumulative value
• Applies a 2% data-service cut on collected fees: 1% is burned (BURN_CUT_PPM), 1% is retained as contract revenue (DATA_SERVICE_CUT_PPM). The remainder routes to paymentsDestination[serviceProvider]
• Locks fees × STAKE_TO_FEES_RATIO via _lockStake() (releases after minThawingPeriod)

​

withdrawFees(to, amount)

Owner-only. Transfers accumulated data-service revenue (the 1% DATA_SERVICE_CUT_PPM portion retained on each collect()) to to.

​

addChain(chainId, minProvisionTokens) / removeChain(chainId)

Owner-only chain allowlist management. minProvisionTokens = 0 uses the protocol default (555 GRT).

​

setMinThawingPeriod(period)

Governance setter. Lower-bounded by MIN_THAWING_PERIOD (14 days).

​

slash(serviceProvider, data)

No-op — reverts with “slashing not supported”. Present to satisfy the IDataService interface.

---

​

Parameters