Billing: Contract + Emit Values by DylanTinianov · Pull Request #2428 · smartcontractkit/chainlink-common

DylanTinianov · 2026-09-29T17:35:50Z

Groundwork for capability-centric workflow billing smartcontract-it.atlassian.net/browse/CRE-6917. No behaviour change for existing producers.

What

ResourceManager.EmitUsageValue(ctx, identity, eventID, *big.Int, fields): METER_ACTION_USAGE from an arbitrary-precision value, so chain-write capabilities can report gas fees in wei/lamports without int64 truncation. Same event-id contract and fail-open semantics as EmitUsage.
resourcemanager/workflow_usage.go: the producer side of the billing contract, shared by the engine (compute) and the chain-write plugins (gas):
- record type cre:workflow; resource types cre:workflow:compute (ms) and cre:workflow:gas:<chain_selector> (WorkflowGasResourceType)
- Utilization.ResourceId = "<workflow_id>:<execution_id>" (WorkflowUsageResourceID, rejects : in either part)
- emitting service names chain-write / workflow-engine; Identity.ResourcePool cre:workflow:gas / cre:workflow:compute with ResourcePoolId = fully qualified resource type (WithWorkflowUsagePool)
Matches the consumer in billing-platform-service (#963, ConstructCapabilityUsageEventID: cre:workflow:<wf>:<exec>:<EventId>).

Usage records are gated by the existing MeterRecordsEnabled; no separate flag.

…L_CAPABILITY_USAGE_ENABLED Groundwork for capability-centric workflow billing (CRE-6778): - ResourceManager.EmitUsageValue emits a METER_ACTION_USAGE record from a *big.Int so chain-write capabilities can report gas fees in wei without truncation. - resourcemanager/workflow_usage.go pins the producer side of the billing contract: record type cre:workflow, resource types cre:workflow:compute and cre:workflow:gas:<chain_selector>, ResourceId "<workflow_id>:<execution_id>", emitting service names and resource pool. Matches the consumer in billing-platform-service (ConstructCapabilityUsageEventID). - loop.EnvConfig.CapabilityUsageEnabled (CL_CAPABILITY_USAGE_ENABLED) carries the new [Metering].CapabilityUsageEnabled node setting to LOOP capability plugins, independent of MeterRecordsEnabled. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

github-actions · 2026-09-29T17:37:10Z

✅ API Diff Results - `github.com/smartcontractkit/chainlink-common`

✅ Compatible Changes (11)

`pkg/resourcemanager` (10)

EmittingServiceChainWrite — ➕ Added
EmittingServiceWorkflowEngine — ➕ Added
ResourceTypeWorkflowCompute — ➕ Added
ResourceTypeWorkflowGasPrefix — ➕ Added
WithWorkflowUsagePool — ➕ Added
WorkflowComputeResourcePool — ➕ Added
WorkflowGasResourcePool — ➕ Added
WorkflowGasResourceType — ➕ Added
WorkflowRecordType — ➕ Added
WorkflowUsageResourceID — ➕ Added

`pkg/resourcemanager.(*ResourceManager)` (1)

EmitUsageValue — ➕ Added

📄 View full apidiff report

Copilot

Copilot review overview

🟡 Changes recommended

Capability usage remains blocked by MeterRecordsEnabled, contradicting the new setting’s documented independence.

Review effort: Balanced
Findings: 1

Open (1)

Capability usage records incorrectly gated by MeterRecordsEnabled · New

What changed in this PR

Adds workflow capability billing primitives and propagates capability usage configuration to LOOP plugins.

Changes:

Adds arbitrary-precision usage emission.
Defines workflow compute/gas billing identifiers.
Adds CL_CAPABILITY_USAGE_ENABLED configuration transport.

File	Description
`pkg/resourcemanager/workflow_usage.go`	Defines workflow billing identifiers and helpers.
`pkg/resourcemanager/workflow_usage_test.go`	Tests workflow billing helpers.
`pkg/resourcemanager/resourcemanager.go`	Adds arbitrary-precision usage emission.
`pkg/resourcemanager/resourcemanager_test.go`	Tests large and nil usage values.
`pkg/loop/config.go`	Adds capability usage configuration.
`pkg/loop/config_test.go`	Tests configuration parsing and propagation.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

…y by CapabilityUsageEnabled Review follow-up. ResourceManager drops every emit when its own MeterRecordsEnabled is false, so a usage manager built from MeteringConfig would be silently gated by the durable-metering flag. CapabilityUsageConfig returns a Config for a dedicated usage ResourceManager: records enabled iff CapabilityUsageEnabled, snapshots off, same emitter and deployment identity. Producers run that manager next to the durable one, so the two settings never share a gate. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Copilot

Copilot review overview

🟢 Approval recommended

The billing primitives, independent configuration gate, and associated boundary cases are consistently implemented and tested.

Review effort: Balanced
Findings: None

Resolved since last review (1)

Capability usage records incorrectly gated by MeterRecordsEnabled

…d contract Identity.ResourcePool / ResourcePoolID follow the Billing <-> Decentralized stack contract: pool "cre:workflow:gas" with pool id "cre:workflow:gas:<chain_selector>" for gas, "cre:workflow:compute" for both on compute. WithWorkflowUsagePool derives them from the resource type so producers cannot drift. Replaces the single "workflow_usage" pool. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

patrickhuie19 · 2026-10-06T16:55:52Z

+// WorkflowGasResourceType returns the gas resource type for a chain selector,
+// e.g. "cre:workflow:gas:421614".
+func WorkflowGasResourceType(chainSelector uint64) string {
+	return ResourceTypeWorkflowGasPrefix + strconv.FormatUint(chainSelector, 10)


cc @seanwangsmartcontract - calling for viz, but this matches our expectations in https://docs.google.com/document/d/1EQSjpfxNHsBWFikfdVoaIh_KtaPKJQlqaKS8SnpQqfM/edit?tab=t.jlozzrlh0lnu#heading=h.6mpcocqx8ink

Matches that section: ResourcePool is cre:workflow:gas / cre:workflow:compute, ResourcePoolId is the fully qualified resource type, ResourceId is <wf>:<exec>.

…abled Per review, capability usage records (compute, gas) do not need their own gate. The existing MeterRecordsEnabled / MeterSnapshotsEnabled knobs already control emission per node and are sufficient for local-cre tuning, so producers reuse EnvConfig.MeteringConfig for the usage ResourceManager. Removes CL_CAPABILITY_USAGE_ENABLED, EnvConfig.CapabilityUsageEnabled and EnvConfig.CapabilityUsageConfig with their tests. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

patrickhuie19 · 2026-10-06T17:23:37Z

+// EmitUsageValue is EmitUsage for quantities that do not fit an int64, such as a
+// transaction fee in wei. A nil value emits "0". Same event_id contract and
+// fail-open semantics as EmitUsage.
+func (rm *ResourceManager) EmitUsageValue(ctx context.Context, identity ResourceIdentity, eventID string, value *big.Int, fields UtilizationFields) {


one note is that I'm not sure how the *big.Int will go across the wire in the message payload. it will need to be serialized to string, we should double check that the emitRecord call will handle this properly. we use a cloudEvent packaging, which I believe wraps OTEL

…alue

bolekk · 2026-10-06T17:51:18Z

+// WorkflowUsageResourceID returns the Utilization.ResourceId for a workflow
+// execution: "<workflow_id>:<execution_id>". Neither component may be empty or
+// contain ':', since the consumer splits on the first ':'.
+func WorkflowUsageResourceID(workflowID, executionID string) (string, error) {


nit: is this shared with any other components? maybe deserves its own file or even a "utils" package?

DylanTinianov changed the title ~~resourcemanager: EmitUsageValue, workflow usage contract, CL_CAPABILITY_USAGE_ENABLED (CRE-6778)~~ Billing: Emit resource manager values Sep 29, 2026

DylanTinianov requested a balanced review from Copilot September 29, 2026 18:40

Copilot started reviewing on behalf of DylanTinianov September 29, 2026 18:41 View session

Copilot AI reviewed Sep 29, 2026

View reviewed changes

Comment thread pkg/loop/config.go Outdated

DylanTinianov marked this pull request as ready for review October 5, 2026 18:35

DylanTinianov requested a review from a team as a code owner October 5, 2026 18:35

product-security-plaid-production Bot requested a review from bolekk October 5, 2026 18:35

DylanTinianov requested review from patrickhuie19 and a balanced review from Copilot October 5, 2026 18:41

DylanTinianov self-assigned this Oct 5, 2026

Copilot started reviewing on behalf of DylanTinianov October 5, 2026 18:42 View session

Copilot AI reviewed Oct 5, 2026

View reviewed changes

DylanTinianov changed the title ~~Billing: Emit resource manager values~~ Billing: Contract + Emit Values Oct 6, 2026

loop: trim CapabilityUsageEnabled and CapabilityUsageConfig comments

eed474e

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

patrickhuie19 reviewed Oct 6, 2026

View reviewed changes

Comment thread pkg/loop/config.go Outdated

patrickhuie19 reviewed Oct 6, 2026

View reviewed changes

Comment thread pkg/resourcemanager/resourcemanager.go

patrickhuie19 reviewed Oct 6, 2026

View reviewed changes

DylanTinianov requested a review from patrickhuie19 October 6, 2026 17:19

patrickhuie19 reviewed Oct 6, 2026

View reviewed changes

patrickhuie19 approved these changes Oct 6, 2026

View reviewed changes

Merge remote-tracking branch 'origin/main' into CRE-6781-emit-usage-v…

4267c91

…alue

bolekk approved these changes Oct 6, 2026

View reviewed changes

DylanTinianov added this pull request to the merge queue Oct 6, 2026

DylanTinianov mentioned this pull request Oct 6, 2026

workflows/v2: emit cre:workflow:compute usage MeterRecord per execution (CRE-6779) smartcontractkit/chainlink#23858

Draft

Merged via the queue into main with commit 2959452 Oct 6, 2026
37 checks passed

DylanTinianov deleted the CRE-6781-emit-usage-value branch October 6, 2026 18:00

DylanTinianov mentioned this pull request Oct 7, 2026

Billing: Emit gas MeterRecords for EVM + Solana chain writes smartcontractkit/capabilities#804

Open

Navigation Menu

Repository navigation

Billing: Contract + Emit Values - #2428

Billing: Contract + Emit Values#2428
DylanTinianov merged 6 commits into
mainfrom
CRE-6781-emit-usage-value

DylanTinianov commented Sep 29, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Sep 29, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

patrickhuie19 Oct 6, 2026 •

edited

Loading

Uh oh!

DylanTinianov Oct 6, 2026

Uh oh!

patrickhuie19 Oct 6, 2026 •

edited

Loading

Uh oh!

bolekk Oct 6, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

DylanTinianov commented Sep 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What

Uh oh!

github-actions Bot commented Sep 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ API Diff Results - github.com/smartcontractkit/chainlink-common

✅ Compatible Changes (11)

pkg/resourcemanager (10)

pkg/resourcemanager.(*ResourceManager) (1)

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟡 Changes recommended

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Copilot review overview

🟢 Approval recommended

Uh oh!

Uh oh!

Uh oh!

patrickhuie19 Oct 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

DylanTinianov Oct 6, 2026

Choose a reason for hiding this comment

Uh oh!

patrickhuie19 Oct 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

bolekk Oct 6, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

DylanTinianov commented Sep 29, 2026 •

edited

Loading

github-actions Bot commented Sep 29, 2026 •

edited

Loading

✅ API Diff Results - `github.com/smartcontractkit/chainlink-common`

`pkg/resourcemanager` (10)

`pkg/resourcemanager.(*ResourceManager)` (1)

patrickhuie19 Oct 6, 2026 •

edited

Loading

patrickhuie19 Oct 6, 2026 •

edited

Loading